# Como integrarse con Punto de Venta Item **URL:** \ **Category:** Deals\ **Tags:** integraciones, instructivo, punto-de-venta\ **Created:** [24 Abril, 2026 12:41 UTC](https://bc.finneg.com/t/como-integrarse-con-punto-de-venta-item/6737 "2026-04-24T12:41:28Z")\ **Posts on this page:** 1\ **Page:** 1
**Author:** ![Martin\_Saba](https://bc.finneg.com/user_avatar/bc.finneg.com/martin_saba/32/14127_2.png) [@Martin\_Saba](https://bc.finneg.com/u/Martin_Saba)\ **Post date:** [24 Abril, 2026 12:41 UTC](https://bc.finneg.com/t/como-integrarse-con-punto-de-venta-item/6737/1 "2026-04-24T12:41:29Z")
## **1. Descripción General** Documento publico **PuntoVenta** que contiene un schema genérico que permite enviar tickets para ser procesados posteriormente por el [trabajo Resumen Punto de Venta v2](https://bc.finneg.com/t/trabajo-generacion-resumen-punto-de-venta-v2/6603) > IMPORTANTE: Para el correcto funcionamiento del proceso de generación de punto de venta resumen se debe tener instalado el módulo COMERCIALIZADORALIVE. pedir a soporte su instalación. **Componentes Principales:** - Documento público “PuntoVenta” en la plataforma Deals - Método POST público “PuntoVentaItemPost” - Método GET público “PuntoVentaItemPost” ![image](https://bc.finneg.com/uploads/default/original/3X/3/0/30b81357e3fbeaed4aff2b4c5d22b56e338fbc5a.png) ![image](https://bc.finneg.com/uploads/default/original/3X/6/7/67500231d434284e2267190e67040ad468a6ad06.png) ## **2. Esquema del Documento** ```json { "IdentificacionExterna": "referencia del sistema externo", "Fecha": "String - Fecha de emisión del comprobante (AAAA-MM-DD)", "SucursalCodigo": "String - Código identificador de la sucursal emisora", "CondicionPagoCodigo": "String - Código de la condición de venta (Ej: Contado, Cuenta Corriente)", "NumeroDocumento": "String - Número legal del comprobante (Punto de venta y número)", "MonedaCodigo": "String - Código de la moneda (Ej: PES, USD)", "ComprobanteTipoImpositivoCodigo": "String - Código fiscal del tipo de comprobante (Ej: 001)", "TipoDocumento": "String -Código de Tipo de documento", "ListaPrecioCodigo": "String - Código de la lista de precios", "VendedorCodigo": "String - Código del vendedor", "Descripcion": "String - Observaciones generales del comprobante", "Cae": "String - Código de Autorización Electrónico (otorgado por ente fiscal)", "FechaCae": "String - Fecha de vencimiento del CAE", "ImporteTotal": "Number/Decimal - Monto total final del comprobante", "Cliente": { "CodigoCliente": "String - Código de cliente ", "IdentificacionCliente": "String - Número de documento o CUIT del cliente", "TipoIdentificacionTributaria": "String - Tipo de ID (Ej: DNI, CUIT, PAS)", "Nombre": "String - Nombre comercial o nombre del cliente", "RazonSocial": "String - Razón social legal del cliente", "CategoriaFiscalCodigo": "String - Condición frente al IVA (Ej: RI, CF, EX)" }, "ItemsProductos": [ { "ProductoCodigo": "String - Código SKU o identificador del producto", "Cantidad": "Number - Cantidad de unidades vendidas", "Precio": "Number/Decimal - Precio unitario del producto", "ImporteExento": "Number/Decimal - Monto del ítem no sujeto a impuestos", "Descripcion": "String - Nombre o descripción detallada del producto", "DepositoCodigo": "String - Código del depósito de donde egresa el stock", "ItemsProductosConceptos": [ { "CodigoTasaImpositiva": "String - Código de Conceptos o Impuesto Interno Calculado (Ej: VENTA_IVA 21)", "ImporteDeIVA": "Number/Decimal - Monto calculado del impuesto", "IVAImporteGravado": "Number/Decimal - Base imponible sobre la cual se calcula el IVA", "PorcentajeTasaImpositiva": "Number/Decimal - Porcentaje de la alícuota (Ej: 21.00)" } ] } ], "Cobro": [ { "ImporteACobrar": "Number/Decimal - Monto parcial o total abonado en este medio", "MonedaCobroCodigo": "String - Código de Moneda", "CUIT": "String - CUIT relacionado a la tarjeta o medio de pago", "NumeroTarjeta": "String - Números de la tarjeta", "FormaPago": "String - Código del medio de pago (EF, BANCO, TARJ, CTACTE)", "MetodoPago": "String - Cuenta contable si corresponde a CTACTE o EF, o Código de Operación Bancaria si la forma de pago es TARJ o BANCO.", "BancoCodigo": "String - Código del banco emisor", "FechaVencimiento": "String - Vencimiento del medio de pago o cupón", "NumeroAutorizacionCupon": "String - Código de autorización de la transacción", "NumeroCupon": "String - Número de comprobante del posnet/transacción", "NumeroLote": "String - Número de lote del cierre de terminal", "Titular": "String - Nombre del dueño de la tarjeta o cheque", "Beneficiario": "String - Nombre a quien se emite el pago (si aplica)", "Descripcion": "String - Nota adicional sobre el cobro", "FechaCupon": "String - Fecha en que se realizó la transacción de cobro", "DocumentoTitular": "String - DNI del titular del medio de pago" } ], "Percepciones": [ { "Numero": "Number - Número de certificado de percepción/retención", "RetencionCodigo": "String - Código del tipo de percepción aplicada", "Fecha": "String - Fecha de aplicación del impuesto", "Importe": "Number/Decimal - Monto de la percepción", "IsarAcumulado": "Number/Decimal - Valor acumulado de seguridad social/impuesto específico", "Isar": "Number/Decimal - Valor actual del impuesto específico" } ], "ImporteTotalCobranza": "Number/Decimal - Sumatoria total de los montos en el array de Cobro", "ImporteTotalCtaCte": "Number/Decimal - Monto remanente que queda como deuda en cuenta corriente" } ``` ### Configuración Necesaria Ir a menú → Deals–\> Publicaciones --\>Publicaciones Propias, agregar un nuevo método de publicaciones. Seleccionar documento **“PuntoVenta”** y método de publicación **“PuntoVentaItemPost”** ![image](https://bc.finneg.com/uploads/default/original/3X/d/3/d39d6fd8280f1492e380fdaf6d549c843d037794.png) Ir a menú → Deals–\> Descargas → Mis descargas, agregar un nuevo método de Descargar. Seleccionar documento **“PuntoVenta”** y método de descarga **“PuntoVentaSendToERP”** ![image](https://bc.finneg.com/uploads/default/original/3X/2/5/25ae54061b47f7d89b79a9463fddade35a546ac7.png) Luego activar el check **“Activar Webhook”** e ir a **“orígenes permitidos”** ![image](https://bc.finneg.com/uploads/default/original/3X/a/5/a571206a2dc2d42fdce269f1231e788950482dee.png) En **“orígenes permitidos”** Seleccionar la opción **PuntoVentaItemPost** \*.\* ![image](https://bc.finneg.com/uploads/default/original/3X/d/0/d0f57d39c15fb77a963c6ecea89253751b0fab85.png) **Parámetros Públicos:** Los siguientes parámetros son opcionales: - **cuentaContableCliente:** código de cuenta contable para crear un cliente - **conceptoCliente:** código de concepto para crear un cliente - **moneda:** código de moneda para las ventas ingresen siempre con la moneda designada. ![image](https://bc.finneg.com/uploads/default/original/3X/c/3/c3d2a61cd1d4fa8aca8e7afb92ec89fd751ec7e0.png) **4.2 Configuración de Sinónimos** **Campos Sinonimizables:** 1. **TipoIdentificacionTributaria** - Ejemplo _`cuit = CUIT`_ 2. **CategoriaFiscal** - Ejemplo _`1 = RI`_ 3. _ **CodigoTasaImpositiva** _ - Ejemplo `21 =`_`VENTA_IVA 21`_ 4. **TipoDocumento** - Ejemplo _`factura b fiscal = FACTVEN`_` ` 5. **ComprobanteTipoImpositivoCodigo** - Ejemplo _`b fiscal = 006`_ 6. **SucursalCodigo** - Ejemplo _`21482-1 = EMPRE01`_ 7. **MetodoPago** - Ejemplo _`EFECTIVO = CE`_ Estos campos sinonimizables nos permiten mapear información del sistemas externo que no puede resolver con los códigos de Finnegans. #### Consideraciones: La API esta preparada para crear clientes si es necesario: ```json "Cliente": [ { "CodigoCliente: "5" "IdentificacionCliente": "40571936", "TipoIdentificacionTributaria": "DNI", "Nombre": "Martín Saba", "RazonSocial": "Martín Saba", "CategoriaFiscalCodigo": "CF" } ] ``` #### Manejo de Formas de cobro: 1. Si el campo **FormaPago** tiene el valor “ **EF** ”, la información a enviar el campo **MetodoPago** debe ser un código de cuenta contable 2. Si el campo **FormaPago** tiene el valor “ **BANCO** ”, la información a enviar 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 enviar 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 enviar el campo **MetodoPago** debe ser un código de cuenta contable > 👉 Nota: La operación bancaria debe tener configurada una cuenta contable default. ### Ejemplo de publicación. ```json [ { "head": { "CFUtoList": [ "7488113047121625670" ], "externalIdentification": "PruebaMartin04", "origin": "PuntoVentaItemPost" }, "document": { "IdentificacionExterna": "PruebaMartin04", "Fecha": "2026-06-25", "SucursalCodigo": "1", "CondicionPagoCodigo": "CE", "NumeroDocumento": "B-0006-00026875", "MonedaCodigo": "PES", "ComprobanteTipoImpositivoCodigo": "006", "TipoDocumento": "FACTVENELECII", "Cae": "0", "FechaCae": "", "ImporteTotal": 126200, "ImporteTotalCobranza": 126200, "ImporteTotalCtaCte": 0, "Cliente": { "CodigoCliente": "1", "IdentificacionCliente": "20-11111111-2", "CategoriaFiscalCodigo": "", "TipoIdentificacionTributaria": "CUIL", "Nombre": "", "RazonSocial": "" }, "ItemsProductos": [ { "ProductoCodigo": "104", "Cantidad": 2, "Precio": 63100, "ItemsProductosConceptos": [ { "CodigoTasaImpositiva": "21.00", "ImporteDeIVA": 21902.4794, "IVAImporteGravado": 104297.5206, "PorcentajeTasaImpositiva": "21.00" } ] } ], "Cobro": [ { "ImporteACobrar": 126200, "NumeroTarjeta": "10000", "FormaPago": "TARJ", "MetodoPago": "DEBAUTENCTA", "FechaVencimiento": "2026-06-24", "NumeroCupon": "100", "NumeroLote": "100", "FechaCupon": "2026-06-24", "DocumentoTitular": "0", "BancoCodigo": "00005" } ] } } ] ``` Para transformar los tickets en Facturas y recibos de cobranzas, se debe configurar el [Trabajo Generación Resumen Punto de Venta](https://bc.finneg.com/t/trabajo-generacion-resumen-punto-de-venta-v2/6603).