Emida MÃ³dulo de Ventas -...

Emida Módulo de Ventas

Documentación Intelisis. Derechos Reservados. Publicado en http://docs.intelisis.info

Emida Módulo de Ventas

Introducción 1

Introducción 41.1

Instalación 51.2

Conguración 2

Requisitos Previos 112.1

Conguración de Terminales a nivel Sucursal 252.2

Conguración de Terminales a nivel Agente 332.3

Conguración de Terminales a nivel Caja 362.4

Funcionalidad3

Flujo Emida 413.1

Recarga Telefónica 463.2

Herramientas4

Herramienta Consulta de Saldo 554.1

Errores Frecuentes5

Errores Frecuentes 585.1

Publicado en http://docs.intelisis.infoEmida Módulo de Ventas - 3

Introducción


Introducción

Se desarrolló la interface con Emida para permitir realizar recargas telefónicas desde el Módulo de Ventas de Intelisis.


Instalación

Se debe instalar la Interface de CLR.

Es necesario correr el instalador SetupInterfaceCLR.exe para poder establecer la comunicación con el WebService de Emida.

1.- Dar doble click en el archivo SetupEmidaCLR.exe


Se mostrará la pantalla de Interface CLR Auto instalador Intelisis ERP - ¡Léeme¡

Funcionalidad Emida CLR e Intelisis Web Service CLR

Instala en Automático.

• Scripts SQL de conguración • DLL´s

1.- Dar click en botón Comprobar.

Al realizar la ejecución, se ingresará la siguiente información, donde:

1.- Servidor. Nombre del Servidor al que se desea conectar.2.- Base de Datos. Nombre de la Base de Datos.


3.- Usuario. Usuario SQL.4.- Contraseña. Contraseña del usuario SQL.5.- Ruta Origen. Ruta Origen que alojará las dll del servicio.6.- Dar click en el botón Ejecutar.

Se mostrará la ventana SQL

1.- "A continuación se ejecutarán los Stored Procedures necesarios para la conguración".2.- Dar click en el botón Aceptar.


1.- Al término de la ejecución mostrará el mensaje "El proceso ha concluido".2.- Dar click en el botón Aceptar.

Se mostrará la ventana de Proceso concluido.

1.- Dar click en el botón Salir.


En la carpeta local indicada en el instalador se deben visualizar los siguientes dll´s.

WebServiceEmidaCLR.dllWebServiceEmidaCLR.pdbWebServiceEmidaCLR.XmlSerializers-dll


Conguración


Requisitos Previos

Conguración de Cuentas de Proveedores

Se debe dar de alta un Proveedor para EMIDA.


En la pestaña regla de negocio:

1.- Se debe colocar la Moneda (por Omisión): para este ejemplo son Pesos.

Conguración de Cuentas de Dinero

Se debe dar de alta las dos cuentas correspondientes a las recargas


Ruta: Cuentas | Cuentas de Dinero | Cuentas de Dinero.

1.- Dar de alta la cuenta de dinero. Para este ejemplo es MICRORE.2.- Tipo: El tipo de cuenta debe ser Banco.



1.- Dar de alta la cuenta de dinero. Para este ejemplo es TERECARGA.2.- Tipo: El tipo de cuenta debe ser Banco.


Se tienen que congurar las Cuentas de Dinero para especicar su Institución Financiera. Para hacerlo ingresar al siguiente menú:

Ruta: Cuentas | Cuentas de Dinero | Cuentas de Dinero.


Conguración de Artículos

Al encender la Interface de Emida, se desplegará una pestaña dentro del catálogo de Artículos.

Se deben dar de Alta los Artículos correspondientes. Estos deben ser de tipo Servicio.

1.- Dar de Alta un Artículo para el servicio Emida, EMIDATELCEL de tipo Servicio.

Nota: Es necesario dar de alta el artículo correspondiente a otras recargas.


1.- Pestaña Emida2.- El Artículo para el servicio EMIDA debe tener activado el check Artículo Tiempo Aire.

• Artículo Tiempo Aire. Con este check se especica que con este Artículo tipo servicio se generarán las Órdenes de Compra hacia el Proveedor Emida.


1.-Pestaña Emida.2.-Activar el check Artículo Recarga Telefónica.

• Artículo Recarga Telefónica. Con este check se especica que este Artículo tipo servicio corresponde a un Artículo de recarga telefónica. Esto permitirá asociar este Artículo de Intelisis con un Producto de Emida.

Ruta: Cuentas | Artículos | Artículos | Pestaña Planeación.

En la pestaña Planeación.

1.- El Proveedor (por omisión) asignado debe ser EMIDA.


Conguración de Agentes

Ruta: Menú Principal | Cuentas | Agentes.

Dentro del catálogo de Agentes se desplegará la pestaña Emida, donde se podrá especicar:

1.- Agente. Número de Identicación para el operador del punto de venta. (Este dato se proporcionará por Emida).


Conguración de Usuario

Por cada usuario de Intelisis, se especicará un Agente asociado. Esto para que todas las ventas nuevas que se realicen, inicien con el campo Agente por omisión.

Para realizar esto, ingresar al siguiente menú:

Ruta: Congurar | Usuarios | Usuarios y posteriormente presionar el botón Conguración

1.- Agente: Seleccionar el Agente correspondiente, para este ejemplo es AGENEMID.


Conguración de Sucursales

Se debe congurar el Almacén por Omisión de la Sucursal para que las Órdenes de Compra que se generen desde la herramienta, contengan la información necesaria.

Ingresar al siguiente menú:

Ruta: Congurar | Sucursales en la pestaña Valores por Omisión.

1.- Se deberá especicar el Almacén por Omisión.


Ruta: Congurar | Generales | Formas de Pago.

1.- Dar click en el botón Nuevo. 2.- Clave: Se debe asignar una clave de identicación, para este ejemplo es


Efectivo. 3.- Deberá tener vacíos los campos Movimiento Ingreso Bancos y Movimiento Egreso Bancos, de lo contrario posteriormente podría causar errores en el ujo.

Conguración de Instituciones Financieras.

Se deben congurar las Instituciones Financieras en la siguiente ruta:

Ruta: Congurar | Otros | Instituciones Financieras.

1.- En la pestaña EMIDA


2.- Se debe seleccionar el Código Emida deseado, es un identicador propio de Emida el cual sirve para registrar los Anticipos. Actualmente se dispone de BANAMEX, BANCOMER y BANORTE.


Conguración de Instituciones Financieras.

Para realizar las ventas se debe generar un Cliente.

Ruta: Cuentas | Cliente | Cliente.

1.- Clave: Colocar una clave para el cliente mostrador.2.- Tipo: Seleccionar tipo Cliente.

Para los precios de los artículos se deben considerar los impuestos y se conguran en el siguiente menú:

Ruta: Congurar | Empresas | Seleccionar Empresas | Edición | Conguración de Módulos | Pestaña Ventas.


Dependiendo el cobro de impuestos se debe habilitar o no el check "Precios con Impuestos Incluido".


Conguración de Terminales a nivel Sucursal

Conguración de Terminal a Nivel Sucursal

Conguración General

Para activar la interface con Emida, dirigirse a la ruta:

Ruta: Menú Principal | Congurar | Empresas | Conguración General.

1.- Activar el check Interfaz Emida.

Con esto se activará la interface y podrá ser congurada.

El el menú:

Ruta: Congurar | Interfaces | Emida.


Se desplegará la pantalla general de Conguración General, donde se deberá congurar lo siguiente:

1.- Nivel de Conguración. Permite especicar el nivel de conguración. Cuenta con las opciones Caja, Agente y Sucursal2.- Versión. Número de Versión de los WebServices de Emida. (Este dato se proporcionará por Emida).3.- Tiempo Espera. Tiempo de espera del WebService de recarga. (Este dato se proporcionará por Emida).4.- Tiempo Búsqueda. Tiempo de espera del WebService para la búsqueda de transacciones.5.- Reintentos. Número de veces que se enviará el método de búsqueda de transacciones para vericar la transacción. (Este dato se proporcionará por Emida).6.- Proveedor. Clave del proveedor de Emida del catálogo de Intelisis para realizar las Órdenes de Compra.7.- Movimiento Orden de Compra. Nombre del movimiento para las Órdenes de Compra.8.- Guardar Histórico de Transacciones. Check para habilitar el Log de Transacciones9.- Ubicación Archivo .csv. Ubicación del archivo .csv para almacenar el Log de Transacciones. Este se enviará a Emida para cualquier aclaración.10.- Conguración URL. Desplegará el catálogo de URL.11.- Actualizar Catálogos. Herramienta para sincronizar los catálogos de Proveedores (Carriers) y Productos (Product) de Emida.


Conguración de URL

Emida maneja dos URL para las transacciones: uno para los productos de Telcel y otro para el resto de las compañías.Dentro de esta ventana se tiene:

1.- Dirección URL del WebService: (Este dato se proporcionará por Emida).

https://ws.microrecargas.com:8449/soap/servlet/rpcrouterhttps://ws.terecargamos.com:8448/soap/servlet/rpcrouter

2.- Cuenta Dinero. Corresponde a una Cuenta de Dinero del catálogo de Intelisis. Se usa para generar los Anticipos a Emida.3.- Conguración de Sucursal. Desplegará la ventana para la conguración de Sucursal.4.- Proveedores. Desplegará el Catálogo de proveedores de Emida.

Conguración a Nivel Sucursal

La Clave corresponde a un identicador asignado por Emida para cada una de las Sucursales. Una misma sucursal tendrá distintas claves por cada URL congurada.

1.- Sucursal. Número de la Sucursal de Intelisis.2.- Clave. Número de Clave. (Este dato se proporcionará por Emida).


1.- Número Terminal. Este dato es proporcionado por EMIDA2.- Último Consecutivo. Se debe colocar el número 0 para comenzar el consecutivo (se muestra el último consecutivo asignado).3.- Dar click en el botón Guardar y Cerrar.

Conguración de Catálogos

1.- Se debe dar click en el botón Actualizar Catálogos.

Cuando se presiona el botón de Actualizar Catálogos, el sistema se conectará con Emida para obtener el listado más reciente de Proveedores y Productos.


Desplegando la lista de los productos, como lo muestra la imagen:

Una vez que se obtuvieron los productos, si se desea nuevamente Actualizar Catálogos, Intelisis responderá con un mensaje especicando que no existen nuevos registros, en caso de encontrar nuevos registros, desplegará una ventana con los registros nuevos.


Conguración de Proveedores

Ruta: Congurar | Interfaces | Emida | Conguración URL | Proveedores.

Cada URL tiene uno o varios proveedores asociados y a su vez los proveedores disponen de varios productos.

Estos datos se insertan automáticamente al Actualizar los Catálogos. Esta ventana es únicamente de Consulta.

Conguración de Productos

Una vez que ya se tienen congurados correctamente los Artículos de Intelisis, se podrá realizar la asociación con los Productos de Emida.

En el siguiente menú:

Ruta: Congurar | Interfaces | Emida | Conguración URL | Proveedores | Productos.

1.- Se debe colocar en el Proveedor de Celular deseado. 2.- Dar click en el botón de Productos.


Una vez seleccionada la URL, ingresar al siguiente menú:

Ruta: Proveedores | Productos (para ligar los productos de Intelisis con los correspondientes de Emida).

1.- Artículo: Por cada producto de Emida, se especicará un artículo tipo servicio que contengan el check Artículo Recarga Telefónica.2.- Se desplegará la ventana de artículos donde se debe seleccionar los artículos previamente congurados. 3.- Comisión: Porcentaje de Comisión que Emida otorga al realizar cada recarga del Producto.


Deben quedar congurados todos los artículos.


Conguración de Terminales a nivel Agente

Con este nivel de Conguración, se asocia cada uno de los Agentes del catálogo de Intelisis a un Número de Terminal. De este modo cada agente contendrá su propio Número de Terminal.




1.- Nivel de Conguración: Permite especicar el nivel de conguración. Se debe seleccionar Agente.2.- Versión. Número de Versión de los WebServices de Emida. (Este dato se proporcionará por Emida).3.- Tiempo Espera. Tiempo de espera del WebService de recarga. (Este dato se proporcionará por Emida).4.- Tiempo Búsqueda. Tiempo de espera del WebService para la búsqueda de transacciones.5.- Reintentos. Número de veces que se enviará el método de búsqueda de transacciones para vericar la transacción. (Este dato se proporcionará por Emida).6.- Proveedor. Clave del proveedor de Emida del catálogo de Intelisis para realizar las Órdenes de Compra.7.- Movimiento Orden de Compra. Nombre del movimiento para las Órdenes de Compra.8.- Guardar Histórico de Transacciones. Check para habilitar el Log de Transacciones.9.- Ubicación Archivo .csv. Ubicación del archivo .csv para almacenar el Log de Transacciones. Este se enviará a Emida para cualquier aclaración.10.- Conguración URL. Desplegará el catálogo de URL.11.- Actualizar Catálogos. Herramienta para sincronizar los catálogos de Proveedores (Carriers) y Productos (Product) de Emida.


Se debe dar de alta un Agente.

1.- Dar click en el botón Terminales.


Se mostrará la Ventana Emida.



2.- Cuenta Dinero: Corresponde a una Cuenta de Dinero del catálogo de Intelisis. Se usa para generar los Anticipos a Emida.3.- Conguración de Sucursal: Desplegará la ventana para la conguración de Sucursal.4.- Proveedores: Desplegará el Catálogo de proveedores de Emida.

En la conguración del usuario.

1.- Seleccionar el Agente dado de alta.


Conguración de Terminales a nivel Caja

Con este nivel de Conguración se asocia cada uno de los Agentes del catálogo de Intelisis a un Número de Terminal. De este modo cada agente contendrá su propio Número de Terminal.




1.- Nivel de Conguración: Permite especicar el nivel de conguración. Se debe seleccionar Caja.2.- Versión. Número de Versión de los WebServices de Emida. (Este dato se proporcionará por Emida).3.- Tiempo Espera. Tiempo de espera del WebService de recarga. (Este dato se proporcionará por Emida).4.- Tiempo Búsqueda. Tiempo de espera del WebService para la búsqueda de transacciones.5.- Reintentos. Número de veces que se enviará el método de búsqueda de transacciones para vericar la transacción. (Este dato se proporcionará por Emida).6.- Proveedor. Clave del proveedor de Emida del catálogo de Intelisis para realizar las Órdenes de Compra.7.- Movimiento Orden de Compra. Nombre del movimiento para las Órdenes de Compra.8.- Guardar Histórico de Transacciones. Check para habilitar el Log de Transacciones.9.- Ubicación Archivo .csv. Ubicación del archivo .csv para almacenar el Log de Transacciones. Este se enviará a Emida para cualquier aclaración.10.- Conguración URL. Desplegará el catálogo de URL.11.- Actualizar Catálogos. Herramienta para sincronizar los catálogos de Proveedores (Carriers) y Productos (Product) de Emida.


Se debe dar de alta una Cuenta.

1.- Dar click en el botón Terminales.


Se mostrará la Ventana Emida.



2.- Número de Terminal: Se coloca el número de terminal (proporcionado por EMIDA).3.- Último Consecutivo: Se muestra el último consecutivo de los movimientos de generados por EMIDA.4.- Dar click en el botón Guardar y Cerrar.


En la conguración del usuario.

1.- Seleccionar la Cuenta Dinero dada de alta: seleccionar CUENTATERM.


Funcionalidad


Flujo Emida

Flujo de Emida

Se han desarrollado movimientos especiales en Ventas, Compras y CxP para cumplir con el ujo requerido por Emida.

El ujo es el siguiente:

1.- Se realiza un Anticipo Emida en CxP.2.- El anticipo se avanza hasta Tesorería y al momento de afectar el cheque o depósito, se activará la interface con Emida para reportar el Anticipo.3.- Se puede revisar el saldo en la cuenta de Emida mediante la herramienta de Consulta de Saldo.4.- Cuando ya se encuentre disponible el saldo, se pueden realizar recargas telefónicas mediante el Módulo de Ventas con el movimiento Nota Emida.5.- Emida emitirá una factura mensual por el total de los consumos realizados menos el porcentaje de comisión por cada Venta.6.- Mediante la Herramienta de Generación de Orden de Compra se puede realizar una Orden de Compra, avanzarla a Entrada de Compra y aplicarla al Anticipo realizado.

Generación del Anticipo

Directamente en el Módulo de CxP, se captura el movimiento Anticipo Emida.


Se debe colocar en la pestaña Emida, en la cual se tendrá que ingresar los siguientes datos:

Proveedor Celular. Como se ha mencionado, Emida dispone de dos URL: una para Telcel y otra para el resto de las compañías. Emida proporciona una cuenta distinta para cada una de las URL, por lo que se tendrá que especicar el Proveedor Celular y en automático se llenará el campo de Cuenta.

1.- Proveedor Celular: Dar click en el botón de selección.2.- Se debe seleccionar el Proveedor Celular correspondiente.

3.- Número Petición. Este campo se llena automáticamente cuando se realice la petición al WebService de Emida. Nos sirve para ligar el Anticipo con el número de transacción de Emida.

Al afectar se mostrará la siguiente ventana:

Información Se Generó automáticamenteMovimiento: Solicitud Cheque 1


Ruta: Financiero | Tesorería.

1.- Abrir el movimiento Solicitud Cheque correspondiente.2.- Dar click en el botón Afectar. 3.- Seleccionar la opción Generar Cheque Electrónico. 4.- Dar click en el botón Aceptar.


Generación del Cheque / Depósito

El Cheque Electrónico se debe Afectar hasta que se muestre en estado Concluido.

Una vez que se muestre en estatus Concluido:

1.- Fecha Emisión. Se envía a Emida como la Fecha con la cual se realizó el Anticipo.2.- Importe. Se envía a Emida como el importe del Anticipo.3.- Referencia. Se envía a Emida como la referencia para rastrear el Anticipo.

En la pestaña Emida.

1.- Número Petición: Este campo se llena al momento de afectar el Cheque


Electrónico.

Del mismo modo que en CxP, en Tesorería se cuenta con una nueva pestaña llamada Emida donde se encuentra dicho campo.Si no existe ningún problema y se ha registrado correctamente el Anticipo en Emida, se actualizará el campo de Número de Petición.


Recarga Telefónica

Generación de Recarga Telefónica

Para poder realizar una recarga telefónica, se debe capturar en el Módulo de Ventas un movimiento Nota Emida.

1.- Movimiento: Seleccionar Nota Emida. 2.- Cliente: Se debe seleccionar un cliente, para este ejemplo es CLIENTEMOS.3.- Agente: Dependiendo la conguración se mostrará por default o no el campo agente. 4.- Almacén: Se debe seleccionar el almacén de cual provienen los artículos. 5.- Artículo: Seleccionar un Artículo de Recarga Telefónica.6.- Cantidad: Siempre debe ser 1. Únicamente se puede realizar una Recarga Telefónica por movimiento.7.- Teléfono: Número Telefónico al cual se recargará el tiempo aire.8.- Conrmar Teléfono. Conrmación del teléfono.9.- Pestaña Emida. Contiene Datos de la transacción de Emida.


1.- Número Teléfono. Número de Teléfono al cual se realizó la recarga telefónica.2.- Emida Número Control. Número de Control de Emida.3.- Proveedor Número Control. Numero de Control del Proveedor.4.- Código de Respuesta. Código de Emida. Si no existe error, especicará 00, de lo contrario un código de error.5.- Mensaje. Mensaje de aprobación o de Error de la transacción de Emida.6.- ID Transacción. ID de Transacción de Emida.7.- Fecha Transacción. Fecha y hora de transacción de Emida.

Ticket de Venta Tiempo Aire

1.- Presentación Preliminar. Genera el Reporte de venta realizado.2.- Información General del reporte. El reporte contará con una descripción


completa sobre la venta realizada, desde el Número Recargado, Número de Control para cualquier aclaración con el Proveedor Celular, Fecha y Hora de recarga, Precio y el Mensaje del Proveedor.

El movimiento quedará en estatus por Procesar.

Generación Orden de Compra

Emida generará mensualmente una Factura por cada URL por el total del saldo consumido menos las comisiones generadas por cada venta.

Intelisis cuenta con una herramienta para calcular esta información y generar una Orden de Compra en estatus por Conrmar.


Ruta: Herramientas | Interfaces | Emida | Generar Orden de Compra


Donde desplegará la siguiente ventana:

1.- Fecha Inicial del periodo a procesar.2.- Fecha Final del periodo a procesar.3.- Generar O.C. Botón para generar las Órdenes de Compra.

Se genera una Orden de Compra, por cada URL, en estatus Por Conrmar.

Dentro de este movimiento, se generará la información Agrupada por Fecha de Recarga y Proveedor. Se tienen los siguientes datos:

1.- Artículo. Artículo tipo servicio congurado como Artículo de Tiempo Aire.2.- Cantidad. Siempre será 1.3.- Fecha Recarga. Fecha en la que se realizó la recarga telefónica.


4.- Proveedor Celular: Se muestra el proveedor de Celular asignado. 5.- Almacén: Se muestra el almacén seleccionado.

Detalle de las Recargas

Se agregó una opción para poder desplegar el detalle de las Recargas Telefónicas dentro del Movimiento de Orden de Compra.

1.- Para poder desplegarlo, es necesario oprimir click derecho sobre el renglón deseado.2.- Seleccionar la opción Emida Detalle Recargas Telefónicas.


Se desplegará la ventana con todos los detalles del movimiento de Ventas de manera informativa.


Log de Transacciones

Si se encuentra habilitada la Conguración de Log de Transacciones, se generará en automático un archivo con todas las transacciones de Recarga, tanto exitosas como no exitosas para cualquier aclaración con Emida.

El formato es CSV (Valores Separados por Comas) y puede ser visualizado directamente desde Excel.

Se genera el archivo Log.csv con los siguientes campos:

1.- FechaRecarga2.- AccountID3.- ProductID4.- Amount5.- InvoiceNo6.- TerminalID7.- ResponseCode8.- Pin9.- ControlNo10.- CarrierControlNo11.- TransactionID

Este archivo guarda el registro de cada movimiento para EMIDA. Aquellos que no son exitosos no guarda los siguientes campos:

• Pin• ControlNo


• CarrierControlNo• TransactionID


Herramientas


Herramienta Consulta de Saldo

Aproximadamente una hora después de realizar el Anticipo a Emida, se verá reejado el saldo disponible para realizar recargas telefónicas.

Se dispone de una herramienta para poder consultar el Saldo.

Se debe ingresar al siguiente menú:

Ruta: Herramientas | Interfaces | Emida | Consulta de Saldo.

Se mostrará una pantalla en blanco donde se debe actualizar el Saldo.

1.- Dar click en el botón Actualizar Saldo: Botón que activa la interface con Emida y actualiza el saldo disponible

Una vez que se actualiza el saldo se mostrará dentro de la ventana los siguientes datos:

1. Filtro a nivel URL: las rutas URL´s conguradas.


2. Clave: Clave del Cliente en Emida.3. Nombre: Nombre del Cliente en Emida.4. Saldo Disponible: Saldo disponible del Cliente en Emida.

Los datos los mostrará para cada URL asignado.


Errores Frecuentes


Errores Frecuentes

ErrorGeneral SQL error.

No se encontró el procedimiento almacenado'spWSEmidaGetCarrierList'

Solución

Es necesario correr el instalador SetupInterfaceCLR.exe

Error 5

Error Genérico de Emida.

10 INVALID SITE-ID

Solución

Este error surge ya que no se tiene congurada la Terminal, es necesario congurar la terminal.


SoluciónEste error se muestra cuando se desea afectar un movimiento Nota Emida.

Solución

Se debe deshabilitar el check en el siguiente menú.

Ruta: Congurar | Empresas | Seleccionar Empresas | Edición | Conguración de Módulos | Pestaña Ventas Mostrador.

Una vez deshabilitado se podrá afectar el movimiento.


Error 5


51 MERCHANT CREDIT REPORT09/24/2013 11:14:37 AMACCOUNT BALANCE: $ 52 .00

Causa

El crédito otorgado por EMIDA consta de 52, si la recarga se quiso realizar por una cantidad mayor enviará este mensaje.

Solución

Ampliar el crédito otorgado.

Error General SQL error.

Error de .NET Framework durante la ejecución de la rutina o agregado denido por el usuario "spWSEmidaPinDistSale":

CausaEste error se presenta cuando el Articulo asignado en la Nota Emida no corresponde a ningún artículo dado de alta por EMIDA.


SoluciónVericar que el artículo se encuentre en la tabla.

Emida MÃ³dulo de Ventas -...

Documents

Transcript of Emida MÃ³dulo de Ventas -...