Cómo integrar Finnegans con Maxirest

Ventas
, ,
1

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 buscan en Maxirest (tickets del día anterior o rango configurado), pasan por Deals y se contabilizan cuando corre el trabajo Generación Resumen Punto de Venta.

Checklist: si no ves nada en los monitores

  1. Confirmá tickets en Maxirest en el rango de fechas.
  2. Revisá el monitor de Deals (método de descarga configurado) y el Monitor de Trabajos.
  3. Configurá y programá el trabajo Generación Resumen Punto de Venta (Configuración → Diseño del espacio de trabajo → Trabajos): solapa Pasos (acción de request/pull según versión del trabajo), solapa Pull Manager con DOCUMENTO, WORKFLOW, CLIENTE, CTACTE y fechas, y programación (ej. diaria).
  4. Si la solapa Pasos está vacía o falta el formulario de factura resumen, puede requerir módulos adicionales o asistencia comercial/funcional (no alcanza con solo publicar en Deals).

  • 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(menú) del punto de venta y mientras que Maxirest mantendrá actualizado el maestro.

Configuración Necesaria

IMPORTANTE: Se deben comunicar con soporte de Maxirest para solicitar autorización para poder utilizar la integración. Solicitar a soporte de Finnegans el numero de Partner para pedir la autorización.

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”

image
image663×279 16.6 KB

En la solapa Parámetros Publicos

image
image1317×462 19.8 KB

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 de tipo de documento de Maxirest (CPB) 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 de tipo de documento de Maxirest (CPB) 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 de tipo de documento de Maxirest (CPB) 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.

image
image1348×226 21.7 KB

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

image
image661×262 15.1 KB

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

image
image1347×302 19.7 KB

image891×338 19.5 KB

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

image
image1310×270 13.4 KB

En “Parametros” completar

image
image1321×332 17.5 KB

  • 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

image
image1327×506 26.6 KB

image
image1295×348 32 KB

image
image1270×231 16.7 KB

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.

:backhand_index_pointing_right: Nota: La operación bancaria debe tener configurada una cuenta contable default.
:backhand_index_pointing_right: Nota: Los cobros con billeteras virtuales, que llegue de Maxirest con método de pago Otros, en Finnegans se reflejan como cobros con tarjeta, en caso de tener disponible los datos de cupon del cobro, la operación Bancaria de las Billeteras virtuales, no deben dar de alta documentos.

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.

image
image1327×227 18 KB

image
image1278×470 65 KB

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"

image
image1326×208 18 KB

En la solapa “Parámetros Públicos”

image
image1300×385 21.5 KB

image
image1270×183 6.81 KB

  • 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”

image
image639×266 15.2 KB

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

image
image1296×249 11.5 KB

Ir a “Parámetro Públicos”

image
image1283×373 23.4 KB

image
image1283×186 7.65 KB

  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)

  8. NoActualizarProductos, debe ser tipo boleano: se recomiendo poner el campo true.
    a. por defecto debe venir False o Vació, eso implica que permite actualizar productos.
    b. Si se carga true, no se deben actualizar y unicamente debe crear productos.

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.