...
En el siguiente manual, se expone una descripción de los servicios REST destinados a la autorización de comprobantes electrónicos.
| Informações | ||
|---|---|---|
| ||
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.
|
Tabla de contenidos
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
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.
| Gliffy Diagram | ||||
|---|---|---|---|---|
|
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
| Bloco de código | ||||
|---|---|---|---|---|
| ||||
{
"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
...
discount
...
name
...
qty
...
tax
...
taxed
...
unitPrice
...
1: Tipos de comprobante permitidos:
Se listan a continuación los valores posibles.
Algunos de ellos no son utilizados en la solución BRIDGE, se listan todos los existentes hasta el momento, a modo de referencia.
| Sem Formato |
|---|
1:Factura A
7:Nota de Débito B
6:Factura B
8:Nota de Crédito B
10:Notas de Venta al contado B
63:Liquidacion A
9:Recibos B
40:Otros comprobantes B que cumplan con R.G.Nro. 1415
39:Otros comprobantes A que cumplan con R.G.Nro. 1415
35:Cbtes. B del Anexo I,Apartado A,inc. f),R.G. Nro. 1415
12:Nota de Débito C
13:Nota de Crédito C
11:Factura C
52:Nota de Débito M
53:Nota de Crédito M
51:Factura M
206:Factura de Crédito electrónica MiPyMEs (FCE) B
203:Nota de Crédito electrónica MiPyMEs (FCE) A
202:Nota de Débito electrónica MiPyMEs (FCE) A
213:Nota de Crédito electrónica MiPyMEs (FCE) C
211:Factura de Crédito electrónica MiPyMEs (FCE) C
212:Nota de Débito electrónica MiPyMEs (FCE) C
2:Nota de Débito A
4:Recibos A
64:Liquidacion B
60:Cta de Vta y Liquido prod. A
15:Recibo C
54:Recibo M
207:Nota de Débito electrónica MiPyMEs (FCE) B
3:Nota de Crédito A
5:Notas de Venta al contado A
34:Cbtes. A del Anexo I, Apartado A,inc.f),R.G.Nro. 1415
61:Cta de Vta y Liquido prod. B
49:Comprobante de Compra de Bienes Usados a Consumidor Final
201:Factura de Crédito electrónica MiPyMEs (FCE) A
208:Nota de Crédito electrónica MiPyMEs (FCE) B |
2: Tipos de documento permitidos
Se listan a continuación los valores posibles.
Algunos de ellos no son utilizados en la solución BRIDGE, se listan todos los existentes hasta el momento, a modo de referencia.
| Sem Formato |
|---|
80:CUIT
87:CDI
89:LE
90:LC
86:CUIL
91:CI Extranjera
93:Acta Nacimiento
94:Pasaporte
92:en trámite
96:DNI
4:CI Corrientes
95:CI Bs. As. RNP
1:CI Buenos Aires
0:CI Policía Federal
3:CI Córdoba
6:CI Jujuy
2:CI Catamarca
8:CI La Rioja
11:CI San Luis
7:CI Mendoza
13:CI Santiago del Estero
17:CI Chubut
12:CI Santa Fe
19:CI Misiones
9:CI Salta
5:CI Entre Ríos
14:CI Tucumán
10:CI San Juan
20:CI Neuquén
22:CI Río Negro
18:CI Formosa
24:CI Tierra del Fuego
16:CI Chaco
99:Doc. (Otro)
23:CI Santa Cruz
21:CI La Pampa
|
3: Situación impositiva del cliente
Se listan a continuación los valores posibles.
| Sem Formato |
|---|
1: MONOTRIBUTISTA
2: RESPONSABLE INSCRIPTO
3: CONSUMIDOR FINAL
4: IVA EXENTO |
4: Conceptos a facturar
Se listan a continuación los valores posibles.
| Sem Formato |
|---|
1:Producto 2:Servicios 3:Productos y Servicios |
5: Tipos de comprobante
Se listan a continuación los valores posibles.
Algunos de ellos no son utilizados en la solución BRIDGE, se listan todos los existentes hasta el momento, a modo de referencia.
| Sem Formato |
|---|
1:Factura A
7:Nota de Débito B
6:Factura B
8:Nota de Crédito B
10:Notas de Venta al contado B
63:Liquidacion A
9:Recibos B
40:Otros comprobantes B que cumplan con R.G.Nro. 1415
39:Otros comprobantes A que cumplan con R.G.Nro. 1415
35:Cbtes. B del Anexo I,Apartado A,inc. f),R.G. Nro. 1415
12:Nota de Débito C
13:Nota de Crédito C
11:Factura C
52:Nota de Débito M
53:Nota de Crédito M
51:Factura M
206:Factura de Crédito electrónica MiPyMEs (FCE) B
203:Nota de Crédito electrónica MiPyMEs (FCE) A
202:Nota de Débito electrónica MiPyMEs (FCE) A
213:Nota de Crédito electrónica MiPyMEs (FCE) C
211:Factura de Crédito electrónica MiPyMEs (FCE) C
212:Nota de Débito electrónica MiPyMEs (FCE) C
2:Nota de Débito A
4:Recibos A
64:Liquidacion B
60:Cta de Vta y Liquido prod. A
15:Recibo C
54:Recibo M
207:Nota de Débito electrónica MiPyMEs (FCE) B
3:Nota de Crédito A
5:Notas de Venta al contado A
34:Cbtes. A del Anexo I, Apartado A,inc.f),R.G.Nro. 1415
61:Cta de Vta y Liquido prod. B
49:Comprobante de Compra de Bienes Usados a Consumidor Final
201:Factura de Crédito electrónica MiPyMEs (FCE) A
208:Nota de Crédito electrónica MiPyMEs (FCE) B |
6: Tipos de IVA
Se listan a continuación los valores posibles.
| Sem Formato |
|---|
3:0%
4:10.5%
6:27%
8:5%
5:21%
9:2.5% |
7: Códigos de Impuesto
Se listan a continuación los valores posibles.
| Sem Formato |
|---|
1:Impuestos nacionales
3:Impuestos municipales
99:Otro
2:Impuestos provinciales
4:Impuestos Internos
6:Percepción de IVA
5:IIBB
9:Otras Percepciones
8:Percepciones por Impuestos Municipales
13:Percepción de IVA a no Categorizado
7:Percepción de IIBB |
8 - Formato y Códigos de Respuesta
A continuación, se expone un ejemplo de la respuesta brindada por el servicio de autorización de comprobantes.
{
"authorizationDate":"2019-11-08T03:00:00.000Z",
"authorizationCode":"69447792300310",
"fiscalPointOfSale":10,
"ack":0
}
...
Código de respuesta:
...
999: error no identificado.
991: el comprobante que intenta autorizar, ya fue autorizado previamente.
992: las credenciales son inválidas.
993: debe existir al menos un ítem informado.
994: los totales informados a nivel comprobantes no cuadran.
995: los totales informados a nivel item no cuadran.
1001 | 2000 | 3000 | 4000 | 5000 | 6000: errores referentes a algún campo no informado (ver ack asociado en la tabla principal)
Método "getCAEA"
Este método es invocado por el punto de venta BRIDGE para obtener el número de CAEA del período y orden necesario para emitir en contingencia.
Es un método REST cuyo contenido interno es JSON.
Un ejemplo de invocación es: http://[dirección-ip]:[puerto]/api/v1/invoice/getCAEA
| Bloco de código | ||
|---|---|---|
| ||
{
"requestCredential":{
"companyCode":"napse",
"terminalCode":"10",
"storeCode":"1",
"invoiceType":1,
"clientSecret":"axjdjjjjj@jddhsahsh"
},
"caea":{
"period":"201910",
"order":2
}
} |
...
A continuación, se expone un ejemplo de la respuesta brindada por el servicio de autorización de comprobantes.
{
"ack":0,
"caea":{
"caea": "12093094409",
"validSince": 2019-11-08T03:00:00.000Z
"validUntil": 2019-11-08T03:00:00.000Z
"limitDateToInformInvoices": 2019-11-08T03:00:00.000Z
"processDate": 2019-11-08T03:00:00.000Z
}
}
...
Código de respuesta:
0: operación exitosa.
999: error no identificado.
99*: errores referentes a la autenticación.
600*: errores referentes a campos no informados.
Interpretación del Pos Log
Bridge utiliza un estandard basado en ARTS para documentar las transacciones.
Específicamente para el caso de BRIDGE, todas aquellas transacciones que no hayan sido autorizadas en línea, deberán informarse interpretando el log de cada transacción.
En el siguiente documento, se expone en forma genérica, la información de una transacción.
| Aviso |
|---|
La información podría variar de acuerdo a la instalación de BRIDGE, formato, vertical. Se recomienda descargar el archivo (no visualizar en línea). |
| View file | ||||
|---|---|---|---|---|
|
Específicamente en los siguientes TAGS se podrá encontrar la información requerida.
...
| language | xml |
|---|
...
FISCAL FLOW es la solución de NAPSE que concede a las empresas la posibilidad de emitir, controlar, gestionar, almacenar (ya sea en un servidor o en la nube) y enviar a sus clientes comprobantes electrónicos respetando el régimen de factura electrónica según la resolución dispuesta por la Administración Federal de Ingresos Públicos.
Además, permite gestionar las impresoras de 2da generación y posterior envío de las presentaciones correspondientes al organismo mencionado.
El sistema Factura Electrónica de Fiscal Flow cuenta con un enlace directo de webservices con los servidores de AFIP para solicitar el CAE de los comprobantes generados.
| Painel | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|