MANUAL DE INTEGRACIÓN - EXCLUSIVO SOLUCIÓN BRIDGE POS

Versión 1.0

Fiscal Flow es la solución de Napse para la emisión de documentos electrónicos y la gestión integral impositiva.

En el siguiente manual, se expone una descripción de los servicios REST destinados a la autorización de comprobantes electrónicos.

Este documento se encuentra enfocado exclusivamente en la integración con el punto de venta BRIDGE de Napse.

El objetivo de la misma, es utilizar la funcionalidad de autónomo que la solución posee, para garantizar la operación de cada terminal, sin necesidad de conexión con servidor de tienda o solución central de emisión de comprobantes fiscales.

En este contexto, el CAEA es gestionado por cada punto de venta en forma autónoma e informado a través del log de transacciones o TLOG.

Adicionalmente, aquellas APIs relacionadas con información que ya posee la solución de punto de venta, no son informadas.

Configuración
Informes contables (Citi, Iva)
Empadronamiento de clientes.

Tabla de contenidos

Diagrama

El siguiente diagrama es un flujo - muy sencillo - de operación del punto de venta y el sistema de emisión de comprobantes electrónicos Fiscal Flow.

Método "Authorize"

Este método se utiliza para autorizar documentos electrónicos por CAE.
Adicionalmente, envía por correo electrónico al cliente una copia del mismo en caso de indicarlo.
Es un método REST cuyo contenido interno es JSON.
Un ejemplo de invocación es: http://[dirección-ip]:[puerto]/api/v1/invoice/authorize

Un ejemplo de una autorización simple por CAE

{ 
   "requestCredential":{ 
      "companyCode":"napse",
      "terminalCode":"10",
      "storeCode":"1",
      "invoiceType":1,
	  "clientSecret": "axjdjjjjj@jddhsahsh"
   },
   "customer":{ 
      "billingEmail":"[email protected]",
      "businessName":"Alonso Diego",
      "city":"Santa Fe",
      "documentType":80,
      "fiscalAddress":"Facundo Zuviria 4677",
      "identificationNumber":"30561541619",
      "perceptionIIBB":true,
      "perceptionIVA":true,
      "personalEmail":"[email protected]",
      "postalCode":"3000",
      "sendVoucher":true
   },
   "fiscalDocument":{ 
      "conceptCode":1,
      "currency":"PES",
      "internalNumber":"169",
      "internalPerceptionAmount":"0",
      "internalTaxesAmount":"0",
      "invoiceDate":"2019-10-29T18:29:48.185-0300",
      "invoiceType":1,
      "items":[ 
         { 
            "discount":"0.00",
            "name":"Bombones Ferrero x3",
            "qty":"1",
            "sku":"111",
            "tax":"21.00",
            "taxed":true,
            "unitPrice":"70.00"
         },
         { 
            "discount":"0.00",
            "name":"Pack caramelos sugus",
            "qty":"1",
            "sku":"112",
            "tax":"21.00",
            "taxed":true,
            "unitPrice":"90.00"
         },
         { 
            "discount":"11.5368",
            "name":"Hamburguesa cn queso",
            "qty":"1",
            "sku":"113",
            "tax":"21.00",
            "taxed":true,
            "unitPrice":"190.00"
         },
         { 
            "discount":"0.00",
            "name":"Hamburguesa cn queso",
            "qty":"1",
            "sku":"113",
            "tax":"21.00",
            "taxed":true,
            "unitPrice":"190.00"
         },
         { 
            "discount":"11.5429",
            "name":"Fanta 600ml",
            "qty":"1",
            "sku":"326",
            "tax":"21.00",
            "taxed":true,
            "unitPrice":"70.00"
         }
      ],
      "nonTaxedAmount":"0.00",
      "amountOtherTaxes":"0.00",
      "amountIVA":"100.66",
      "exemptAmount":"0.00",
      "pointOfSale":"10",
      "relatedTaxes":[ 
         { 
            "amount":"100.66",
            "baseAmount":"479.34",
            "code":5
         }
      ],
      "sendVoucher":true,
      "taxedAmount":"479.34",
      "totalAmount":"580.00"
   }
}

Los campos marcados con son requeridos