Sistema Servidor Corporativo Alaro
alaro.no-ip.org
Principal
Documentación
Descargas

3.7    Punto de Venta : Recargas Telefónicas

Entre los servicios que ofrece el sistema se encuentra la capacidad de conexión con empresas de venta de tiempo aire para telefonía celular.
Actualmente se manejan protocolos de comunicación con las siguientes empresas :

Multirecargas, distribuidor de :



Tecno TAE, distribuidor de :



Bolsa de tiempo aire Telcel



Bolsa de tiempo aire Multirecargas



Configuración y Alta de Códigos de Recarga Telefónica

El alta de códigos de recarga telefónica se realiza en el sistema de igual forma que el cualquier otro producto siempre y cuando se observen las siguientes restricciones :
Código Debe ser exactamente el código proporcionado por el proveedor ya que es la forma en que este podrá "entendernos" durante la comunicación electrónica.
Descripción Recarga Telcel Forzosamente las descripciones de este tipo de productos deberán iniciar con la palabra "RECARGA" para ser reconocidas por el sistema. El resto de la descripción es libre. Recuerde especialmente en este tipo de productos no utilizar en la descripción el precio en forma numérica a menos que separe por un espacio la cantidad del signo de pesos (ej. RECARGA TELCEL $ 100.00).
Descripción Recarga Multirecargas Forzosamente las descripciones de este tipo de productos deberán iniciar con la palabra "TIEMPO" para ser reconocidas por el sistema. El resto de la descripción es libre. Recuerde especialmente en este tipo de productos no utilizar en la descripción el precio en forma numérica a menos que separe por un espacio la cantidad del signo de pesos (ej. RECARGA MULTIR $ 100.00).
Descripción Bolsa Telcel Forzosamente las descripciones de este tipo de productos deberán iniciar con la palabra "SALDO" para ser reconocidas por el sistema. El resto de la descripción es libre. Recuerde especialmente en este tipo de productos no utilizar en la descripción el precio en forma numérica a menos que separe por un espacio la cantidad del signo de pesos (ej. SALDO TELCEL $ 100.00).
Descripción Bolsa Multirecargas Forzosamente las descripciones de este tipo de productos deberán iniciar con la palabra "SALDO" para ser reconocidas por el sistema. El resto de la descripción es libre. Recuerde especialmente en este tipo de productos no utilizar en la descripción el precio en forma numérica a menos que separe por un espacio la cantidad del signo de pesos (ej. SALDO MULTIR $ 100.00).
Precio Recarga El precio de la recarga NO está implícito en el código ni en la descripción del producto por loque si Ud. asigna un precio (por ejemplo) de 100.00 a un código de 200.00 el producto se venderá a 100.00 .
Precio Bolsa El precio de la bolsa de tiempo aire debe ser cero ya que el importe a abonar será estipulado por el cliente.
Proveedor Recarga Telcel Se reconocen como Recarga Telcel únicamente los productos asignados a los proveedores "TPR001" ó "REC01".
Proveedor Recarga Multirecargas Se reconocen como Recarga Multirecargas únicamente los productos asignados a los proveedores "TPR002", "REC02", "REC03", "REC04", "REC05", "REC06", "REC07", "REC08" ó "REC09".
Proveedor Bolsa Telcel Se reconocen como Bolsa Telcel únicamente los productos asignados al proveedor "BOLTEL".
Proveedor Bolsa Multirecargas Se reconocen como Bolsa Multirecargas únicamente los productos asignados al proveedor "BOLMUL".
Impuestos Seleccionar la tasa establecida para el producto. (Actualmente las recargas causan un IVA del 16%).



Venta de Tiempo Aire

Una vez disponibles (y adecuadamente difundidos a sucursales) los códigos de recarga telefónica y bolsa, el procedimiento en el punto de venta será de la siguiente forma :
  • El cajero deberá teclear la palabra "RECARGA", "TIEMPO" ó "SALDO" (según sea el caso) en la zona de lectura de código de barras.
  • A continuación el sistema mostrará la ventana de consulta estandar con los productos que coincidieron con la búsqueda.
  • Al seleccionar el producto de la lista la ventana cambiará su formato si detecta una descripción que inicia con las palabras "RECARGA", "TIEMPO" ó "SALDO" (según sea el caso).


  • Deberá teclear el número telefónico deseado y confirmarlo posteriormente en los espacios que se indican. Dependiendo de la configuración puede mostrarse el número o un caracter que lo oculte "*" para forzar al cliente a volverlo a dictar y evitar errores.
  • Por requerimiento de Telcel para la certificación del procedimiento, se visualiza el prefijo "044-" en pantalla, aunque la captura será también válida para números foráneos (en cuyo caso el prefijo es 045-).

  • Los siguientes casos serán rechazados por el servidor del proveedor de recargas :
  • Números que contengan una cantidad mayor o menor de diez dígitos.
  • Números que contengan letras (por ejemplo la letra "O" en vez del número "0" cero).
  • Números de una compañía diferente a la del producto seleccionado (por ejemplo intentar recargar un número telcel con un producto iusacell).
  • Números inexistentes, cancelados o dados de baja.
  • Diferencias entre el número y la confirmación.

  • Una vez aceptado, el ticket deberá ser emitido o cancelado, según sea el caso.
  • En el caso de regargas no hay eliminación de partida.
  • No podrán combinarse las recargas de tiempo aire con la venta de ningún otro producto.

    Las recargas de tiempo aire
    no pueden combinarse con otros
    productos en el mismo ticket.    		 bar_k44.gif

  • Unicamente podrá emitirse una recarga por ticket.
  • Una vez emitida la venta el sistema pasa los datos del producto y número telefónico al conector del proveedor. En ese momento la transacción queda fuera del control del sistema Alaro.
  • Si el proveedor autoriza la recarga se guarda la venta y se imprimen el ticket de venta y el ticket de recarga por separado.
  • En cualquier otro caso la respuesta del proveedor se muestra en pantalla (referirse al proveedor correspondiente para dudas y aclaraciones sobre respuestas obtenidas en este punto).
  • En caso de ser necesario el ticket de tiempo aire se encuentra dentro de las opciones del procedimiento de reimpresión de tickets.



    Ventas Inconclusas

    En caso de un "apagón" de la caja que está realizando la venta, el sistema entrará en modo de "venta recuperada" al reiniciarse. Si en la última venta se realizó una recarga telefónica exitosa (enlace y autorización con el proveedor) pero el equipo fué "apagado" antes de emitir el ticket, el sistema lo indicará forzando al cobro de esa venta para poder continuar utilizando esa caja.

    "TICKET RECUPERADO CON RECARGA AUTORIZADA"
    >EL TICKET PENDIENTE RESPALDA UNA RECARGA<
    >>>>>AUTORIZADA Y DEBE SER COBRADO<<<<<<<<     		bar_k44.gif


    Venta de Bolsa de Tiempo Aire

    Para la venta de bolsa de tiempo aire el procedimiento es similar pero aplican las siguientes condiciones :
  • El cajero deberá seleccionar un cliente previamente registrado para que el sistema asigne el número telefónico de la bolsa de forma automática.
  • El número telefónico no se puede modificar.
  • El cajero deberá indicar y confirmar el saldo a abonar.
  • Es posible consultar en pantalla el saldo que el cliente tiene en su bolsa (además, su nuevo saldo aparecerá en la impresión de su comprobante).

    Concentración Corporativa y Conciliación

    Con objeto de conciliar las recargas efectuadas por el sistema y aquellas confirmadas y autorizadas por el proveedor se genera y envía un archivo de conciliación periódicamente.
    En su configuración predefinida estandar opera de la siguiente forma :
  • En forma diaria, a las 10pm el sistema se conecta a todas las sucursales y obtiene la información de recargas. Si el proceso no puede ser llevado a cabo por la carga del servidor, se reintenta hasta conectar. En caso del cambio de día se autoconfigura para reportar las recargas del día anterior.
  • La información se concentra y clasifica por sucursal y se agrupa por razón social (cadena).
  • Se integra el archivo de conciliación de acuerdo a las especificaciones del proveedor de recargas telefónicas.
  • Se envía de forma automática el archivo al proveedor por medio del protocolo FTP con la configuración proporcionada por el proveedor. Los registros con diferencias o que no figuren en ambos controles serán probablemente reportados por su proveedor para aclaraciones.

    Manual (Sección Estructural)

    Ubicación aplicativa Punto de venta
    - Venta de Tiempo Aire
    Ubicación configurativa Corporativo
    - Compras
    -- Productos y Servicios
    Ubicación informativa Corporativo
    - Configuración
    -- Cierres
    --- Archivo
    ---- Parcial :
    Tipos de movimiento caj01
    tae01
    tae02


    Configuración de Punto de Venta

    Para operar adecuadamente el sistema requiere de un conector externo que sirva de traductor con los proveedores de servicios de recarga telefónica.
    Nota : la información de configuración que a continuación se proporciona puede cambiar sin previo aviso ni responsabilidad por parte de Alaro ya que es proporcionada y depende directamente del funcionamiento de los productos del proveedor de servicios de recargas telefónicas
    El conector con el que opera actualmente el sistema es una versión desarrollada en JAVA por lo que es importante verificar que su sistema operativo pueda ejecutar adecuadamente programas con extensión .jar
    Para ejecutar el conector de recargas, Alaro requiere los siguientes archivos (y accesos o permisos para los usuarios que requieran de su uso) :
    Ejecutable de java /publico/jdk1.5.0_15/bin/java ó /publico/java ó path_default
    Archivo de configuración de recargas telcel /publico/telcel/webservice.properties
    Archivo .jar de recargas telcel /publico/telcel/netpayreload.jar
    Archivo de configuración de recargas multirecargas /publico/multirecargas/webservice.properties
    Archivo .jar de recargas multirecargas /publico/multirecargas/netpayreload.jar
    Archivo de configuración bolsa telcel /publico/bolsa_telcel/webservice.properties
    Archivo .jar de bolsa telcel /publico/bolsa_telcel/conector.jar
    Archivo de configuración de bolsa multirecargas /publico/bolsa_multir/webservice.properties
    Archivo .jar de bolsa multirecargas /publico/bolsa_multir/conector.jar

    Ejemplo de /publico/telcel/webservice.properties (todos los datos deberán ser proporcionados por su proveedor de recargas) :

    serviceURL=https://www.tecnotaews.com/ws_pruebas/ServicePX.asmx
    functionsURL=http://www.pagoexpress.com.mx/ServicePX
    timeout=30
    tae_grupo=678
    tae_cadena=1
    tae_tienda=18

    Ejemplo de /publico/multirecargas/webservice.properties (todos los datos deberán ser proporcionados por su proveedor de multirecargas) :

    serviceURL=https://www.pxcorp.com.mx/wincaja/ServicePx.asmx
    functionsURL=http://www.pagoexpress.com.mx/ServicePX
    timeout=30
    tae_grupo=623
    tae_cadena=11
    tae_tienda=8

    Ejemplo de /publico/bolsa_telcel/webservice.properties (todos los datos deberán ser proporcionados por su proveedor de bolsa telcel) :

    serviceURL=https://www.tecnotaews.com/ws_ggaris/ServicePX.asmx
    functionsURL=http://www.pagoexpress.com.mx/ServicePX
    timeout=30
    tae_grupo=7
    tae_cadena=5
    tae_tienda=1
    tae_socket=vtae.webhop.net
    tae_puerto=4500
    tae_llave=Pruebas

    Ejemplo de /publico/multirecargas/webservice.properties (todos los datos deberán ser proporcionados por su proveedor de bolsa multirecargas) :

    serviceURL=https://www.tecnotaews.com/ws_ggaris/ServicePX.asmx
    functionsURL=http://www.pagoexpress.com.mx/ServicePX
    timeout=30
    tae_grupo=7
    tae_cadena=5
    tae_tienda=1
    tae_socket=vtae.webhop.net
    tae_puerto=4500
    tae_llave=Pruebas


    Bitácora del Conector

    El conector de recargas telefónicas escribe información de bitácora en archivos con la ruta /publico/lib/logs/NetpayReloadPOS1.log

    Ejemplo de /publico/lib/logs/NetpayReloadPOS1.log (los datos e interpretación son responsabilidad de su proveedor de recargas) :

    2011/58/27 01:58:31 INFO: responseXML: ...
    2011/58/27 01:58:31 INFO: 794141,0,Transaccion exitosa,para cualquier duda marca sin costo: *611 o al 01800-888-8366,
    2011/54/29 09:54:47 INFO: serviceURL: https://www.tecnotaews.com/ws_prueba/ServicePX.asmx
    2011/54/29 09:54:47 INFO: functionsURL: http://www.pagoexpress.com.mx/ServicePX
    2011/54/29 09:54:47 INFO: timeOut: 30
    2011/54/29 09:54:47 INFO: ARGS(0): Reload
    2011/54/29 09:54:47 INFO: ARGS(1): 514
    2011/54/29 09:54:47 INFO: ARGS(2): 8
    2011/54/29 09:54:47 INFO: ARGS(3): 7
    2011/54/29 09:54:47 INFO: ARGS(4): 2
    2011/54/29 09:54:47 INFO: ARGS(5): 8469434550482
    2011/54/29 09:54:47 INFO: ARGS(6): 5535513226
    2011/54/29 09:54:47 INFO: ARGS(7): 41332
    2011/54/29 09:54:48 INFO: ARGS(8): 0000 ...


    Pruebas del Conector de Recargas


    Dado que el conector de recargas es un programa externo al sistema Alaro puede ser probado en forma independiente para evaluar su funcionamiento.
    De hecho si el conector no opera en forma independiente tampoco funcionará cuando se invoca desde el sistema alaro.
    Para realizar la prueba es necesario :
  • Abrir una terminal o consola del sistema.
  • Cambiarse al directorio de la aplicación (/publico/telcel ó /publico/multirecargas según sea el caso).
  • Tener configurado el webservice.properties con las URL y parámetros de pruebas proporcionados por su proveedor de recargas.
  • Ejecutar el comando del conector :
    root@localhost > java -jar /publico/telcel/netpayreload.jar "Reload" tae_grupo tae_cadena tae_tienda caja sku telefono folio_ticket 0000

    en donde :
    java Ejecutable de java en Linux
    -jar Parámetro para ejecución de archivo
    /publico/telcel/netpayreload.jar Archivo .jar de telcel
    "Reload" Instrucción de "recarga"
    tae_grupo Parametro asignado por el proveedor de recargas (ejemplo 007)
    tae_cadena Parametro asignado por el proveedor de recargas (ejemplo 006)
    tae_tienda Parametro asignado por el proveedor de recargas (ejemplo 021)
    caja Número de caja en donde se efectuó la recarga (ejemplo 012)
    sku Código de barras de la recarga proporcionado por el proveedor (ejemplo "RECARGA 10" = "7500026485")
    telefono Número de 10 dígitos proporcionado por el cliente (ejemplo 5551234567)
    folio_ticket Número de ticket de referencia (ejemplo 12000345)
    0000 Parámetro fijo, se pasa tal cual



    Documentación del Fabricante


    Recargas : Para mayor información puede     descargar aquí el manual del conector del fabricante y también puede descargar el archivo zip con el conector completo.
    Bolsa : Para mayor información puede descargar aquí el manual del conector del fabricante y también puede descargar el archivo zip con el conector completo.
    El sistema realiza la validación de caracteres ilegales en los textos de retorno del proveedor de tiempo aire.


    Manual (Sección Estructural)

    Ubicación aplicativa Punto de venta
    - Venta de Tiempo Aire
    Tipos de movimiento caj01
    Caracteres ilegales que se retiran o sustituyen Signo de pesos
    Apóstrofe
    Pipe


    El sistema realiza la validación de caracteres ilegales en los textos de retorno del proveedor de tiempo aire.


    Manual (Sección Estructural)

    Ubicación aplicativa Punto de venta
    - Venta de Tiempo Aire
    Tipos de movimiento caj01
    Caracteres ilegales que se retiran o sustituyen Signo de pesos
    Apóstrofe
    Pipe


    • Información relativa a la versión 1.6.10217 del Sistema Servidor Corporativo Alaro. El contenido de esta información puede variar con la versión actual del sistema dependiendo de modificaciones, adaptaciones y desarrollos particulares generados para cada cliente.
    Estamos trabajando en estas páginas para proporcionar a Uds. acceso en forma electrónica a nuestros manuales estructurales y de operación. Ponemos a su disposición secciones selectas como demostracción recordándoles que el acceso ilimitado a la documentación completa se adquiere, por contrato, una vez adquiridos y liquidados nuestros productos y servicios a clientes que no presenten adeudos.