Cómo integrar Finnegans con Maxirest

[Martin_Saba (Martín Saba)]

1. Descripción de la Solución

Maxirest gestiona la operación diaria del local (comandas, facturación a clientes, medios de pago y mesas). La integración con Finnegans permite registrar las ventas darías se transfiera automáticamente al ERP, transformando los Tickets en documento de factura de punto de venta y recibos de cobranzas

---

2. Beneficios Clave

• Centralización de Ventas: Consolida la facturación de múltiples sucursales de Maxirest en Finnegans.

• Mantenimiento de maestro de productos: Se mantiene actualizado los cambios en el menu del punto de venta.

• Reducción de Carga Administrativa: Elimina la necesidad de cargar manualmente el resumen de ventas en el ERP.

Alcance Funcional de la Integración:

• Ventas y Contabilidad: Los comprobantes de venta y cobro se busca a Maxirest creados el día anterior, se utiliza Deals como intermediario de la informacion y se genera la contabilidad al momento se ejecuta el trabajo Generación resumen Punto de Venta los comprobantes.

• Control de Facturación: La responsabilidad de la emisión y categorización correcta de la factura recae en Maxirest, ya que Finnegans recibe y procesa el comprobante que le es enviado.

• Mantenimiento de maestro de productos: Finnegans se encargará de recuperar los productos(menu) del punto de venta y mientras que Maxirest mantendrá actualizado el maestro.

Configuración Necesaria

Obtención de tickets.

Ir a menú –> Deals–> Publicaciones –>Publicaciones Propias, agregar un nuevo método de publicaciones. Seleccionar documento “PuntoVenta” y método de publicación “MaxiPuntoVenta”

En la solapa Parámetros Publicos

Parámetros a completar:

• EMAIL: Email del usuario con permisos para buscar facturas de ventas en Maxirest

• PASS: Contraseña del usuario con permisos para ver buscar facturas de venta

• COD_CLI: Código de cliente que identifica a la sucursal a buscar facturas de venta.

• FROM: Parámetro Fecha desde para realizar una búsqueda particular ejemplo 2026-07-04

• TO: Parámetro Hasta desde para realizar una búsqueda particular ejemplo 2026-07-04

• concatenarSucursalPrefijo: Se debe completar true o false, en que caso de que sea true permite construir el código de sucursal utilizando Codigo de cliente + punto de venta ejemplo COD_CLI: 7785 y Punto de venta: 001, el campo sucursal se completara con el valor 7785-1

• tipoA: Se deberán completar con los códigos separados por punto y coma cuyo letra de numero de comprobante inicia con la letra A.

• tipoB: Se deberán completar con los códigos separados por punto y coma cuyo letra de numero de comprobante inicia con la letra B.

• tipoC: Se deberán completar con los códigos separados por punto y coma cuyo letra de numero de comprobante inicia con la letra C.

• bancocodigo: código de banco genérico para las ventas que se realizan mediante el medio de pago banco cuando no se tiene dicha referencia en maxirest. Se puede obtener desde el maestro de bancos.

Nota:

1. Cada vez que se intente modificar un parámetro se deberá cargar el parámetro PASS.
2. Los parámetros fecha FROM y TO se deben completar en formato AAAA-MM-DD y debe ser para un rango de 7 días Maximo.
3. Los parametros TypeA, TypeB y TypeC, permiten construir la mascara de los talonarios.
   Ejemplos de tipos de códigos en maxireste:

“A” - factura A fiscal

“G” - factura B fiscal

“K” - nota de crédito A fiscal

“L” - nota de crédito B fiscal

Una vez completo los parámetros de entrada se van a generar un servicio programable para buscar facturas a Maxirest.

Ir a menú –> Deals–> Descargas –> Mis descargas, agregar un nuevo método de Descargar. Seleccionar documento “PuntoVenta” y método de descarga “PuntoVentaSendToERP”

Luego activar el check “Activar Webhook” e ir a “orígenes permitidos”

image891×338 19.5 KB

En “orígenes permitidos” Seleccionar la opción MaxiPuntoVenta

En “Parametros” completar

• cuentaContableCliente: Código de cuenta cliente
• conceptoCliente: Código de concepto de cliente
• moneda: código de moneda PES

Cuando un Ticket envié información del cliente el mismo se creara en el maestro de cliente previo a guardar el Ticket en las tablas intermedias que utiliza el trabajo Generación de resumen de punto de venta v2.

Como Maxirest no informa la moneda, se debe configurar un parámetro que guarde la moneda del ticket.

Ir a menú –> Deals–> Sinónimos –> Seleccionar documento PuntoVenta. y completar los siguientes sinónimos:

Campos Sinonimizables:

1. TipoIdentificacionTributaria - Ejemplo cuit = CUIT
2. CategoriaFiscal - Ejemplo 1 = CF
3. CodigoTasaImpositiva - Ejemplo 21 =VENTA_IVA 21 INCLUIDO
4. TipoDocumento - Ejemplo factura b fiscal = FACTVEN
5. ComprobanteTipoImpositivoCodigo - Ejemplo b fiscal = 006
6. SucursalCodigo - Ejemplo 7782-1 = EMPRE01
7. MetodoPago - Ejemplo EFECTIVO = CCE
8. CodiciónPago - Ejemplo EFECTIVO = CE
9. bancoCodigo Ejemplo Macro = 0007

Tener en cuenta los siguiente:

1. Si el campo FormaPago tiene el valor “EF”, la información a sinonimizar en el campo MetodoPago debe ser un código de cuenta contable

2. Si el campo FormaPago tiene el valor “BANCO”, la información a sinonimizar el campo MetodoPago debe ser un código de operación bancaria.

3. Si el campo FormaPago tiene el valor “TARJ”, la información a sinonimizar el campo MetodoPago debe ser un código de operación bancaria.

4. Si el campo FormaPago tiene el valor “CTACTE”, la información a sinonimizar el campo MetodoPago debe ser un código de cuenta contable

Con el campo CodiciónPago se va a visualizar el método de pago que se utilizo en maxirest, se debe completar con el código de condición de pago que se adecue en Finnegans.

Nota: La operación bancaria debe tener configurada una cuenta contable default.

Para transformar los tickets en Facturas de venta y recibos de cobranzas, se debe configurar el Trabajo Generación Resumen Punto de Venta.

Para corroborar el estado de las tickets que llegan a Finnegans

Ir a menú –> Deals–> Descargas –> Mis descargas, buscar el método de descarga “PuntoVentaSendToERP” y darle clic a ver monitor.

Obtención de Productos.

Ir a menú –> Deals–> Publicaciones –>Publicaciones Propias, agregar un nuevo método de publicaciones. Seleccionar documento “Producto” y método de publicación “MaxiProducto"

En la solapa “Parámetros Públicos”

• EMAIL: Email del usuario con permisos para buscar facturas de ventas en Maxirest
• PASS: Contraseña del usuario con permisos para ver buscar facturas de venta
• COD_CLI: Código de cliente que identifica a la sucursal a buscar facturas de venta.
• Listmode: se debe enviar en -1
• List: se debe enviar ONLY
• UnidadVenta: se debe enviar UN
• TasaImpositiva: se debe enviar 21

Ir a menú –> Deals–> Descargas –> Mis descargas, agregar un nuevo método de Descargar. Seleccionar documento “Producto” y método de descarga “ProductoSendToERP”

Luego activar el check “Activar Webhook” e ir a “orígenes permitidos”

Ir a “Parámetro Públicos”

1. ProductoTipo: Indicar codigo de Tipo, enviar siempre OTR

2. ConceptoCodigoVenta: Código de concepto de venta

3. ConceptoCodigoCompras: Código de concepto de Compra

4. CuentaCodigoVentas: Código de cuenta de venta

5. CuentaCodigoCompras: Código de cuenta de Compra

6. Moneda: Codigo de Moneda

7. UnidadValorizacion: Unidad de Valorizacion 0 (sin asignar)

Nota: Tantos los parámetros publico del método de publicación de descarga como de publicación deben estar completos para que los productos se creen correctamente para ser utilizando por el trabajo Punto de venta resumen V2.
Sí se cuenta con más de una sucursal en Maxirest, tener en cuenta que se debe tener el maestro de productos (Menú) unificado entre sucursales.

Una vez completo los parámetros de entrada se van a generar un servicio programable para buscar Productos a Maxirest.