1Qué es la integración

AvantPOS es el TPV del local. ICG Manager sigue siendo el sistema de la central y el maestro de los datos. La integración hace que AvantPOS trabaje con Manager igual que lo hacía FrontRest: la central mantiene en Manager el catálogo, los precios, los usuarios y la botonera; el local vende con AvantPOS; y todo lo que pasa en el local vuelve a Manager con las cajas, las series y los documentos de ICG.

Lo que se busca es que en la central no cambie nada: los mismos usuarios siguen trabajando en Manager, sin pantallas nuevas ni datos que mantener en dos sitios, y los informes, el stock, la contabilidad y el envío al SII siguen saliendo de Manager.

1. La central manda: lo que se decide en Manager llega al local en pocos minutos, sin reiniciar nada.
2. El local vende: tickets, comandas, cobros, devoluciones, cierres, fichajes, recepciones y mermas se hacen en AvantPOS.
3. Todo vuelve: cada documento del local entra en Manager por ICG DataExchange, la herramienta oficial de importación de ICG, o por procedimientos propios con permisos mínimos.

ConsejoEste manual está pensado para el responsable de IT que administra ICG Manager y SQL Server. Explica qué instala Avant, qué tiene que preparar la central, qué se ve en cada sitio y qué hacer si algo falla.

Qué se gestiona en cada sitio

En AvantPOS, todo lo que viene de la central se ve pero no se edita. Las pantallas del backoffice lo indican con el aviso «El catálogo se gestiona en ICG Manager» y la hora de la última actualización. Lo que es propio del local se sigue configurando en AvantPOS.

2Arquitectura

La integración tiene tres piezas. Ninguna necesita abrir puertos de entrada: el conector y los locales se conectan al relé, y el relé no se conecta a nadie.

El conector, en el servidor de Manager

Es un servicio de Windows de Avant («AvantPOS Conector ICG») que se instala en el servidor de Manager. Cada minuto:

1. lee de la base de datos de gestión lo que ha cambiado en el catálogo, con un login de solo lectura y consultas que no bloquean (lectura sin bloqueos y con tiempo máximo de espera), y publica en el relé la foto del catálogo de cada local;
2. recoge del relé los documentos de los locales, los deja en las tablas intermedias AVANTPOS_* y lanza DataExchange con el grupo de AvantPOS; después completa lo importado con sus procedimientos y confirma al relé lo que ya está en Manager;
3. comprueba cada Z contra lo que hay en Manager y avisa si no cuadra.

El conector nunca escribe directamente en las tablas de ICG: o lo hace DataExchange, o un procedimiento AVANTPOS_* que se ejecuta con un usuario sin login que solo tiene permisos sobre las tablas que necesita.

El relé, en los servidores de Avant

Cada cliente tiene su propio relé, en su propio dominio (<cliente>-rele.avantpos.es), con sus datos separados de los de cualquier otro cliente. Guarda la última versión del catálogo de cada local, la cola de documentos que suben y los correos de aviso. La comunicación es siempre por HTTPS, y cada local y el conector se identifican con su propia clave, que se puede revocar sin afectar a los demás.

AvantPOS, en el local

Cada local tiene su servidor de AvantPOS con su propia base de datos, y los TPV, comanderas y pantallas de cocina trabajan contra él. Cada local recibe solo lo suyo: su botonera, sus tarifas, sus formas de pago y sus almacenes.

Qué pasa si algo se cae

1. Sin internet en el local: AvantPOS sigue vendiendo con la última versión buena del catálogo. Los documentos quedan en la cola del local y suben solos cuando vuelve la conexión, sin reintentos manuales.
2. Sin servidor de Manager, sin conector o sin DataExchange: los locales siguen vendiendo y los documentos esperan en el relé. Cuando la central vuelve, el conector los importa en orden.
3. Sin relé: los locales siguen vendiendo y guardan los documentos; el conector espera. Al volver, el TPV reenvía lo que el relé no tenga y el conector vuelve a publicar el catálogo.

Ningún documento se borra del local hasta que el conector confirma que está en Manager. Un corte, aunque dure un fin de semana, no pierde ni duplica nada.

3Qué instala Avant en Manager

Todo lo que Avant añade a la base de datos de gestión lleva el prefijo AVANTPOS_ (o el nombre avantpos_ en los logins), se instala con scripts revisados que se pueden volver a ejecutar para actualizar y se quita con un script de desinstalación que no toca ningún dato de ICG: los documentos ya importados se quedan.

Qué va por DataExchange y qué por procedimiento

Todos los borrados y actualizaciones sobre tablas de ICG filtran por los documentos de AvantPOS (sus series y números) o por su front, su caja y su Z. Nunca tocan datos de FrontRest ni de otros TPV, aunque compartan local y almacén.

Tablas de ICG que se modifican

Para que el IT sepa exactamente dónde aparecen los datos de AvantPOS:

4Requisitos en el servidor de Manager

El usuario de la tarea de DataExchange

DataExchange no guarda la contraseña de la base de datos por su cuenta: usa la conexión que el usuario de Windows tiene guardada en Manager y en DataExchange. Por eso la tarea programada «AVANTPOS DataExchange» se ejecuta con un usuario concreto, con su contraseña y «se haya iniciado sesión o no».

1. Elija un usuario de Windows que ya use DataExchange (o inicie sesión con él, abra DataExchange y guarde la conexión con Manager una vez).
2. Ese usuario se indica al instalar el conector; la contraseña la guarda Windows en la tarea, no se escribe en ningún fichero.
3. Si cambia la contraseña de ese usuario, hay que volver a ejecutar el instalador para actualizar la tarea.

Conformidad fiscal

Todo lo que sube AvantPOS entra en Manager como documento declarado, y sus facturas simplificadas quedan pendientes de envío al SII, igual que las de FrontRest. Es la central, desde Manager, quien las declara. Por eso la sociedad de cada local tiene que declarar por SII desde Manager (por ejemplo, con ICGSII activo para esa empresa) antes de que el local empiece a vender.

Política de actualizaciones de ICG

El conector lee tablas internas de ICG y DataExchange importa con mappings que dependen de su versión. Una actualización de Manager puede cambiar ese esquema.

1. Avise a Avant antes de actualizar Manager, DataExchange o ICGSII, con la versión de destino.
2. Avant comprueba el conector con esa versión (lo ideal, en la copia de pruebas) antes de que llegue a producción.
3. Mientras tanto no se pierde nada: si después de una actualización algo deja de importarse, los documentos esperan en el relé y los locales siguen vendiendo.

5Cajas, series y almacenes en Manager

AvantPOS no inventa códigos de ICG: usa los que da de alta la central. Para cada local y cada TPV hay que preparar en Manager lo siguiente:

Por qué cada TPV necesita una caja nueva

Las Z de AvantPOS empiezan en 1. En una caja con historia se mezclarían con las Z antiguas de esa caja: el cuadre no cuadraría y la importación rehace el arqueo de la Z que recibe. Por eso cada TPV de AvantPOS tiene su caja de ICG, nueva y solo para él, aunque el almacén sea el del local (el stock tiene que salir del mismo sitio).

ConsejoSi un código de caja ya existe en otro front con arqueos, el conector para la subida de esa caja y avisa: use un código que no se haya usado nunca.

6Puesta en marcha de un local

En la central (una vez por cliente)

1. Avant crea el relé del cliente y comprueba que responde.
2. En la base de datos de gestión, con el visto bueno del IT: los objetos AVANTPOS_* (tablas y procedimientos).
3. Los logins avantpos_lectura y avantpos_escritura. Las contraseñas las genera Avant y las guarda en su almacén de credenciales; no se envían por correo.
4. El grupo de DataExchange «AVANTPOS IMPORTAR TICKETS», apuntando a la carpeta de intercambio. Apunte el número de grupo que asigna Manager: cambia en cada instalación.
5. El conector: se copia el paquete al servidor de Manager y se ejecuta su instalador en PowerShell como administrador, con el grupo, el servidor de ICG, la base de datos de DataExchange y el usuario de la tarea. Instala en C:\AvantPOS\ConectorICG (solo la leen SYSTEM y los administradores, porque contiene contraseñas), crea la tarea «AVANTPOS DataExchange» y registra el servicio, pero no arranca nada.
6. Avant completa la configuración del conector: conexiones, relé, locales (front, tarifa por defecto, formas de pago) y cajas (front, almacén, caja de stock, series y, si hace falta, serie de compras y almacén de mermas). El servicio no arranca mientras quede algún dato sin rellenar o si el grupo, la tarea o la base de datos no coinciden.
7. Prueba de lectura sin publicar nada: el conector cuenta los productos, familias y botones de cada local.
8. Arranque del servicio. Su registro queda en el Visor de eventos › Aplicación, origen «AvantPos.ConectorIcg».

En Manager (por cada local)

1. Front del local, con el cliente de las entregas y la central como proveedor.
2. Caja de ICG y caja de stock de cada TPV; series de tickets, devoluciones e invitaciones; serie de compras de cada caja.
3. Almacén del local con serie de traspasos, y almacén de mermas.
4. Botonera del tipo de terminal del local, tarifas y formas de pago del front.
5. Sociedad del local declarando por SII desde Manager.

En el local (lo hace Avant)

1. AvantPOS instalado con su licencia y el módulo de integración.
2. Backoffice › Configuración › Integraciones › pestaña «Catálogo central»: «Gestionar el catálogo desde ICG Manager», URL del relé, código del local y su clave. Al activarlo se retiran los datos de ejemplo de la instalación (con una copia previa). Cuando baja la primera versión, se ve en «Estado».
3. En cada TPV (Local y cobro › Terminales TPV), «Numeración» (serie y siguiente número) y «Subida a ICG Manager» (caja de ICG y caja de stock).
4. En cada salón (Local y cobro › Salones y mesas), el «Nº de sala en la central».
5. Lo que es del local: PIN de los usuarios, permisos de cada perfil (por ejemplo, el permiso de comprar para recibir entregas y registrar mermas), qué formas de pago cobran con datáfono o CashDro, impresoras y destinos.
6. Correos de aviso del local, en la misma pantalla del catálogo central.

Pruebas antes de abrir

1. El catálogo del TPV coincide con Manager: algunos precios de cada tarifa, la botonera, los usuarios.
2. Un cambio de precio en Manager llega al TPV con «Actualizar ahora».
3. Un ticket cobrado con efectivo, otro con tarjeta y otro con dos formas de pago; una invitación y una devolución.
4. Un arqueo X y un cierre Z: en Manager aparecen los documentos en su caja y su Z, la tesorería y el arqueo, y el conector no avisa de descuadre.
5. Si se usan: una recepción de entrega, una merma, un fichaje y un movimiento de caja.
6. Los documentos de prueba se anulan como cualquier otro documento: con devoluciones desde el TPV, nunca borrándolos en Manager.

7Corte desde el TPV anterior y numeración

La serie que imprime AvantPOS es la que se declara en Manager y en el SII. Se configura en Backoffice › Local y cobro › Terminales TPV › (el TPV) › Numeración: serie y siguiente número de tickets, de devoluciones y, si se quiere, de invitaciones y consumo del personal. La pantalla enseña el último número usado y el siguiente de cada serie.

1. El siguiente número nunca retrocede: si en la serie ya hay números más altos, AvantPOS sigue desde el último.
2. Fije el siguiente número una sola vez, antes del primer cobro. Con VeriFactu los números de una serie no se pueden saltar ni reutilizar.
3. La configuración de la subida a Manager no lleva series: toma las de la numeración.

Local nuevo

La central crea las series del local y la caja de cada TPV; en AvantPOS se ponen esas series con el siguiente número 1 (o el que indique la central).

Local que viene de FrontRest

Para seguir la misma numeración sin pisar nada:

1. Al cierre del último día con FrontRest, cerrar su Z y no volver a cobrar con FrontRest en esas series.
2. En Manager, leer el último número de cada serie (tickets, invitaciones y abonos).
3. En AvantPOS, poner las mismas series con el número siguiente al último de cada una.
4. Comprobar en la pantalla de numeración que el siguiente es el correcto antes del primer cobro.
5. Las cajas de ICG son nuevas aunque las series continúen.

Si aun así llegara a Manager un documento cuya serie y número ya existen, el conector lo aparta con un aviso y no lo sustituye.

8Bajada de maestros

La central sigue trabajando en Manager como siempre. En la imagen, el cambio de precio de un artículo en la tarifa de un local, en la ficha del artículo de Manager.

Qué baja

Cada dato guarda su código de ICG, que es el que se usa después para subir los documentos.

Cuándo baja

1. El conector revisa Manager cada minuto y publica una versión nueva del catálogo del local solo si algo ha cambiado. Detecta los cambios por las versiones de fila de ICG, no por la fecha de modificación.
2. El TPV comprueba si hay versión nueva cada 2 minutos («Comprobar cada (minutos)», de 1 a 60), al arrancar y al pulsar «Actualizar ahora».
3. La versión se aplica entera o no se aplica: nunca queda un catálogo a medias. El resultado dice cuántas altas, cambios y bajas hubo.
4. Los tickets ya abiertos conservan el precio con el que se abrieron.
5. En «Estado» se ven la versión aplicada, la última actualización, el último intento y el último error.

Cómo se ve en el local

Las pantallas del catálogo (productos, familias, tarifas, menús, formas de pago, usuarios, perfiles) muestran el aviso «El catálogo se gestiona en ICG Manager» y no permiten editar. Donde hay algo del local, el aviso lo dice: «Aquí solo se edita lo que es del local: el PIN y el permiso para fichar» en Usuarios, «los permisos de cada perfil» en Perfiles y permisos, «si cada forma de pago cobra con el CashDro» en Formas de pago. En Tarifas, la asignación de cada tarifa a los salones es del local.

Usuarios y perfiles

Los vendedores de Manager bajan con su nombre corto y su perfil (tipo de usuario). Manager solo guarda el nombre del perfil, no lo que permite: lo que puede hacer cada perfil (anular, invitar, devolver, cerrar caja, comprar…) se configura una vez en AvantPOS. El PIN de cada usuario es del local y no baja de Manager.

La botonera

En modo central, la carta del TPV y de la comandera se presenta como la botonera de FrontRest: solo las páginas de ICG del tipo de terminal del local, en su orden y con su color, con productos y menús mezclados en su posición. El orden de los botones no se cambia en el TPV.

9Subida de ventas

Cada ticket llega a Manager como si lo hubiera hecho el TPV de siempre: su serie, su número, su caja, su Z, su vendedor y su forma de pago. En la imagen, un ticket de AvantPOS en la ventana «Facturas de venta» de Manager, con una línea invitada a 0 y el cobro con tarjeta en la tesorería.

Qué sube y dónde queda

Cuándo sube

1. Los tickets cobrados se envían al relé enseguida y, como muy tarde, en el intervalo de subida (15 minutos por defecto).
2. Cada Z sube en cuanto se cierra, con los tickets que le falten delante.
3. El conector recoge lo que haya en el relé cada minuto y lo importa por lotes, uno por caja y Z.

No es tiempo real como ICGRemote: entre el cobro y su aparición en Manager pasan unos minutos.

Cómo queda cada caso

1. Modificadores, como FrontRest: el suplemento va dentro del precio de la línea y cada modificador o variación de texto queda en los modificadores de la línea (ALBVENTAMODIF), con su grupo y su nivel.
2. Invitaciones y consumo del personal: líneas CI a 0 en la serie de invitaciones.
3. Devoluciones: documento propio en la serie de devoluciones, enlazado al ticket devuelto, con líneas DV en negativo y el cobro devuelto en negativo.
4. Varios cobros por ticket (cuenta dividida, pago mixto): una línea de tesorería por cobro, con su forma de pago y la referencia del datáfono cuando la hay.
5. Propina por sobrecobro, si el local trabaja así: la tarjeta se cobra por el ticket más la propina y la propina sale en efectivo como un cobro negativo del mismo ticket. En Manager quedan dos cobros y el total del ticket no cambia.
6. Vales y tarjetas regalo: el cobro en su forma de pago con el número del vale.
7. Descuentos: ICG calcula cada línea como unidades por precio, así que una línea con descuento sube con el precio ya rebajado (en Manager se ve el precio efectivo, no el precio y el porcentaje por separado). El total siempre coincide con lo cobrado.
8. Venta por peso: unidades con decimales (kg), y el consumo por escandallo va por esas unidades.
9. Camarero por línea: cada línea lleva el vendedor que la añadió; la cabecera, el del ticket.
10. Consumo por escandallo y stock por Z: se calculan para la caja de stock de AvantPOS; el stock por Z de otros TPV no se toca.

Controles antes y después de importar

1. Fechas: un documento con fecha de más de 7 días atrás o en el futuro queda «Apartado» en el TPV (suele ser el reloj mal puesto) y no sube hasta que alguien confirme la fecha.
2. Duplicados: lo que ya consta importado se confirma sin volver a subirlo, y una serie y número que ya existen en Manager se apartan con aviso.
3. Lote rechazado: si ICG rechaza un lote por su contenido y no entra nada, el conector lo parte hasta aislar el documento que falla, sigue con los demás y avisa. Si DataExchange se cuelga, no se parte: se reintenta.
4. Un solo conector a la vez: un bloqueo en la base de datos impide que dos conectores importen al mismo tiempo.

Diferencias conocidas con FrontRest

1. Un documento de 0 € (una invitación entera) entra sin línea de tesorería; FrontRest pone una de 0 en efectivo. No cambia el arqueo, la Z ni el SII.
2. Las líneas con descuento muestran el precio efectivo (ver arriba).
3. El número de albarán interno lo asigna ICG con su contador; el número del ticket es el de la factura simplificada, que es el que imprime AvantPOS.

10Cierres Z, arqueos X y caja

El cierre de caja se hace en el TPV: el encargado cuenta el efectivo y declara cada forma de pago. Al generar el cierre, la Z sube con el arqueo por forma de pago: calculado, declarado, fondo, entradas, pagos y descuadre.

Cuadre de cada Z

Cuando la Z y sus tickets están en Manager, el conector compara la Z de AvantPOS con Manager al céntimo: número de documentos y total por forma de pago. Si en Manager faltan tickets y la Z es reciente, espera, porque aún pueden estar subiendo. Si no cuadra, avisa a Avant y a los correos del local, y la Z aparece con problema en el TPV.

Además, cada día (a partir de las 10:00 por defecto) el conector revisa el día de negocio anterior: si una caja tuvo tickets y su Z no ha llegado, avisa. Un día sin tickets no genera aviso.

Quién cierra la Z en Manager

Por defecto, la Z llega a Manager con el declarado y el descuadre, pero abierta: la cierra la central en Manager, como decida (CERRADO, retirado). Opcionalmente, el conector puede dejarla cerrada al cuadrar, con la retirada y el descuadre calculados como FrontRest. Es una decisión de la central que se configura en el conector.

ConsejoSi llega un ticket tarde a una Z ya importada, la importación rehace el arqueo de esa Z con todos sus documentos y vuelve a aplicar el declarado.

El fondo de caja

Arqueos X y movimientos de caja

1. Arqueo X: al imprimirlo, sube como arqueo tipo X, sin líneas.
2. Ingresos y gastos de caja: se registran en el TPV o la comandera con un concepto de la central (conceptos de pago) y suben como pagos de caja. Los movimientos del CashDro llevan solos el concepto de entrada o retirada.

11Entregas de la central, mermas y fichajes

Entregas de la central

La central entrega mercancía al local con un albarán de venta (serie PAAL) a nombre del cliente del local, como hasta ahora. Las entregas pendientes bajan al local con el catálogo.

1. El encargado la abre en la comandera (Más › «Entregas de la central») o en el backoffice (Almacén › Albaranes de compra › «De la central», o Integraciones › Catálogo central). Hace falta el permiso de comprar.
2. «Recibir todo», o corregir las unidades línea a línea y «Recibir estas cantidades» (0 = no ha venido; las negativas son devoluciones a la central).
3. Una entrega que deja de estar pendiente en la central (la recibió otro puesto o la anularon) desaparece sola.
4. La recepción sube con la siguiente subida: en Manager aparece en unos minutos, y en el local la entrega pasa a «En Manager» cuando el conector lo confirma.

En Manager, la recepción crea el albarán de compra del local en la serie de compras de su caja, con la central como proveedor, «Su albarán» = PAAL-<número>, los precios del origen y las unidades recibidas, y deja recibido el albarán de la central. El stock y el coste los calculan los propios mecanismos de ICG, como con FrontRest. En modo central la recepción no mueve el stock del TPV: el stock es el de Manager.

Mermas

1. Desde la comandera (Más › «Mermas») o el backoffice, con permiso de comprar: motivo de la central, artículo del catálogo de compra (lo que el local tiene en existencias en su almacén de Manager, materia prima incluida) y cantidad con decimales en la unidad de la central.
2. Sin coste en pantalla: lo pone Manager con el último coste del almacén.
3. Un local nuevo empieza con el catálogo de compra vacío hasta que su primera entrega crea existencias en su almacén.

En Manager, cada merma es un traspaso del almacén del local al almacén de mermas, con su motivo, valorado al último coste y ya recibido, igual que las mermas de FrontRest (se ve en Almacén › Traspasos y en los informes de mermas).

Fichajes

Los empleados fichan en el TPV con su usuario de la central (su código de vendedor). Cada fichaje sube al registro de empleados de Manager, sustituyendo el día entero de ese empleado. Se consultan con los informes de presencia de Manager. Un usuario dado de alta solo en el local puede fichar, pero su jornada no sube y aparece como error en la pantalla de subida.

Copia del plano (opcional)

Con la casilla «Copiar el plano a la central» (Integraciones › Catálogo central, apagada por defecto), cuando cambian los salones con número de sala, sus mesas o las impresoras, se envía una copia a las tablas de salas, mesas e impresoras del front de AvantPOS. Es solo informativa: en Manager nada la usa salvo para verla. El conector se niega a copiarla si el front tiene terminales de FrontRest, para no pisar su configuración.

Lo que sigue en Manager

Los inventarios se siguen haciendo en Manager.

12DataExchange en detalle

AvantPOS usa un grupo de mappings propio, «AVANTPOS IMPORTAR TICKETS», con dos mappings: AVANTPOS EXPORT TICKETS (pasa el lote de la tabla intermedia a un fichero de texto en la carpeta de intercambio) y AVANTPOS IMPORT TICKETS (importa ese fichero como documentos de venta). Antes de importar se ejecutan sus SQL «AVANTPOS BORRAR …», que borran solo los documentos del lote (por serie y número de AvantPOS) y el arqueo de su caja y Z, para que se rehagan.

1. No tiene programación propia: el conector lanza la tarea programada «AVANTPOS DataExchange» con el grupo de AvantPOS cuando hay un lote preparado, y espera a que termine.
2. La tabla intermedia solo contiene el lote en curso; el conector no prepara otro mientras quede uno sin terminar.
3. Un lote pequeño tarda unos segundos. Si DataExchange pasa de dos minutos, el conector detiene solo el proceso de su grupo (nunca otros DataExchange) y lo reintenta en el siguiente ciclo.
4. Si DataExchange termina con éxito, el conector ejecuta la post-importación. Si falla, el lote queda en error con el mensaje y sin cambios a medias.

Dónde mirar

1. DataExchange › Central de alarmas: cada ejecución del grupo, con «Ejecución correcta» o el error en rojo, y su fichero de registro (export, import y SQL externas).
2. Registro de DataExchange en su carpeta Log (un fichero IMPORTGROUP_<grupo>_<fecha> por ejecución).
3. Visor de eventos › Aplicación, origen «AvantPos.ConectorIcg»: lo que hace el conector en cada ciclo.
4. Tabla AVANTPOS_LOTES: cada lote con su estado (importado o error) y el mensaje del error.

ConsejoCon la tabla intermedia vacía, DataExchange dice «La exportación finalizó con errores» porque no hay nada que exportar. Es normal si alguien lanza el grupo a mano; el conector solo lo lanza con un lote preparado.

13Operativa diaria

En AvantPOS

Al final de Integraciones › Catálogo central está el estado de la subida del TPV:

1. Debajo aparecen los documentos con problema, con su motivo, sus intentos y el botón «Reintentar» (o «Fecha correcta: subir» si están apartados por la fecha).
2. Tras reiniciar el TPV, «Último envío» puede indicar «nunca» hasta el siguiente envío; los contadores son la referencia.
3. Correos de aviso: hasta 10 direcciones del local que reciben los avisos de su subida (Z que falta, Z que no cuadra, documentos que no se pueden subir). Avant también los recibe.

En Manager

1. Ventas: la ventana «Facturas de venta» (o la lista de tickets), filtrando por la caja de AvantPOS y la Z: los documentos del día.
2. La tesorería de cada documento y el arqueo de la Z.
3. DataExchange › Central de alarmas: que las ejecuciones de «AVANTPOS IMPORTAR TICKETS» salgan correctas.
4. Compras › Albaranes de compra y Almacén › Traspasos para las recepciones y las mermas.

En el servidor de Manager

1. Servicio «AvantPOS Conector ICG» en marcha.
2. Espacio en disco y que SQL Server y Manager responden.
3. No borrar ni modificar la tarea «AVANTPOS DataExchange», la carpeta de intercambio ni las tablas AVANTPOS_*.

14Incidencias y qué hacer

ConsejoAnte cualquier duda, no reimporte, no borre documentos en Manager y no relance a mano el grupo de AvantPOS: avise a Avant. Soporte de Avant: 93 694 05 02 · soporte@avant-it.net.

A quién avisar

1. Avant: cualquier aviso del conector, documentos con problema que no se resuelven con «Reintentar», cambios de versión de ICG y altas de locales, cajas o series.
2. El encargado del local: Z que falta, relojes de TPV mal puestos, falta de internet en el local.
3. La central (quien mantiene Manager): artículos, precios, botoneras, formas de pago o usuarios que faltan o están mal.

15Actualizaciones y desinstalación

Actualizar AvantPOS y el conector

Las actualizaciones las hace Avant, siempre en este orden: relé, TPV y, por último, conector. El conector va el último porque es el que empieza a enviar datos nuevos del catálogo, y un TPV antiguo no los sabría vender.

1. El conector se actualiza ejecutando el mismo instalador con el paquete nuevo. Conserva su configuración y vuelve a pedir la contraseña del usuario de la tarea.
2. Los objetos AVANTPOS_* se actualizan volviendo a ejecutar su script; después se vuelven a dar los permisos del login de escritura sobre lo nuevo.

Actualizar ICG

Siga la política del capítulo 4: aviso previo a Avant con la versión, comprobación del conector y, si algo deja de importar, los documentos esperan en el relé.

Desinstalar

1. Parar y quitar el servicio y la tarea programada del conector.
2. Ejecutar el script de desinstalación de los objetos AVANTPOS_* y el grupo de DataExchange.
3. Quitar los logins avantpos_lectura y avantpos_escritura (y sus usuarios en la base de gestión y en GENERAL).

Los documentos ya importados se quedan en Manager como cualquier otro documento.

16Seguridad y datos

Qué datos salen del servidor de Manager

1. Hacia el relé: el catálogo de cada local (artículos, precios, modificadores, menús, botonera, formas de pago, conceptos, motivos), sus usuarios (código, nombre corto y perfil), las entregas pendientes y las existencias de sus almacenes.
2. No salen: clientes, proveedores (salvo la central como proveedor del local), contabilidad, costes de compra más allá de los de las entregas, ni ningún otro dato de Manager.

Qué datos viajan desde el local

1. Los documentos del local: tickets, cobros (con la referencia del datáfono, nunca datos de tarjeta), cierres, fichajes de los empleados, movimientos de caja, recepciones y mermas.
2. Los correos de aviso que configure el local.

Cómo se protegen

1. Todo viaja por HTTPS. El conector y cada local se identifican ante el relé con su propia clave, que se puede revocar.
2. El relé de cada cliente es independiente: sus datos y claves no se comparten con ningún otro cliente.
3. En el servidor de Manager no se abre ningún puerto. El conector lee con un login de solo lectura y escribe solo en sus tablas; los procedimientos actúan con un usuario sin login y permisos mínimos.
4. Las contraseñas del conector están solo en su carpeta de instalación (accesible a SYSTEM y administradores) y en el almacén de credenciales de Avant. Nunca en correos ni en documentos.
5. El relé guarda los documentos mientras viajan; la copia de verdad está en Manager y, hasta que se confirma, en el local.

Accesos de Avant

Avant necesita acceso al servidor de Manager para instalar, actualizar y diagnosticar el conector, por el medio de acceso remoto que acuerde con el IT y siempre con su visto bueno. Las altas en Manager (cajas, series, front) las hace la central. Cualquier script sobre la base de datos de gestión se revisa con el IT antes de ejecutarlo, y se prueba antes en una copia cuando la hay.

Copias de seguridad

Las tablas AVANTPOS_* forman parte de la base de datos de gestión y entran en sus copias habituales. La carpeta del conector conviene incluirla en la copia del servidor (contiene su configuración). No hace falta copiar la carpeta de intercambio: solo contiene el fichero del lote en curso.

17Preguntas frecuentes

¿Tenemos que cambiar algo en el trabajo diario de la central? No. Se sigue trabajando en Manager. Lo único nuevo es dar de alta las cajas y series de cada TPV y, si se quiere, cerrar las Z de AvantPOS en Manager.

¿Cuánto tarda un cambio de Manager en llegar al local? Unos pocos minutos: el conector lo publica en el minuto siguiente y el TPV lo comprueba cada 2 minutos. Con «Actualizar ahora» es inmediato.

¿Y una venta en llegar a Manager? Unos minutos. Como máximo, el intervalo de subida del TPV (15 minutos por defecto) más el ciclo del conector.

¿Se puede usar AvantPOS en un local mientras otros siguen con FrontRest? Sí. Cada TPV de AvantPOS tiene su caja y sus series, y nada de lo que hace AvantPOS toca documentos ni stock de FrontRest, aunque compartan almacén.

¿Qué pasa con ICGRemote? Sigue sirviendo a los FrontRest que queden. El conector no escribe en sus tablas.

¿Escribe AvantPOS directamente en las tablas de ICG? Los documentos de venta entran por DataExchange. Lo que DataExchange no cubre lo aplican procedimientos AVANTPOS_* revisados, con permisos solo sobre las tablas que tocan.

¿Se puede repetir una importación? El diseño evita repetir: lo ya importado no se vuelve a subir, porque reimportar volvería a dejar la factura pendiente del SII. Si un lote falla, se reintenta solo, sin duplicar.

¿Los empleados tienen que tener PIN en Manager? No. El PIN es del local y se pone en AvantPOS. En Manager, el vendedor con su perfil.

¿Se pueden hacer facturas con NIF en el local? No en modo central: las hace la central en Manager.

¿Necesitamos abrir puertos o una VPN? No. Solo salida HTTPS del servidor de Manager y de cada local hacia el relé.

18Glosario

Soporte de Avant: 93 694 05 02 · soporte@avant-it.net.