Fiscal Flow API REST
A continuación se detallan los métodos e información necesaria para operar con la aplicación.
Eduardo Marcelo Salvadori Usuário desconhecido (laura.coradino) Marcos Omar Casado Juan Pablo Almeida
Método authorize
Este método se utiliza para autorizar documentos electrónicos por CAE.
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
requestCredential | ||
---|---|---|
companyCode | Código de compañía, provisto para la empresa que contrata el servicio. | 992 |
terminalCode | Código de terminal / punto de venta. | 992 |
storeCode | Código de tienda | 992 |
invoiceType | Tipo de comprobante a autorizar (**1) | 992 |
clientSecret | Clave de acceso otorgada a la compañía | 992 |
customer | ||
businessName | Nombre de la persona / Empresa | 1001 |
city | Ciudad | |
documentType | Tipo de identificación (**2) | 1002 |
fiscalAddress | Dirección fiscal de la persona / empresa | 1003 |
identificationNumber | Número de identificación del cliente. No es necesario si este fuese consumidor final. | 1004 |
perceptionIIBB | Si es agente de retención de ARBA. Por default es FALSE. | |
perceptionIVA | Si es agente de retención de IVA. Por default es FALSE. | |
postalCode | Código postal | |
sendVoucher | Si desea marcar la factura para su posterior envío por correo electrónico. Por default es FALSE. | |
billingEmail | Dirección de correo electrónico del cliente adonde debe llegar la factura. | |
personalEmail | Dirección de correo electrónico del cliente | |
taxCategory | Situación impositiva (**3) | 1005 |
fiscalDocument | ||
conceptCode | Conceptos a facturar (**4) | 2001 |
currency | Monedas (PES) | |
internalNumber | Número de comprobante interno del punto de venta. | 2002 |
internalPerceptionAmount | Si existe un requerimiento de impuestos extras, debe incluirse en este campo. Default: 0 | |
internalTaxesAmount | Si existe un requerimiento de impuestos extras, debe incluirse en este campo. Default: 0 | |
invoiceDate | Fecha de la factura | 2003 |
invoiceType | Tipo de Comprobante (**5) | 2004 |
nonTaxedAmount | Importe conceptos no gravados. | 2005 |
amountOtherTaxes | Importe en conceptos de impuestos internos. | 2006 |
amountIVA | Importe en concepto de IVA | 2007 |
exemptAmount | Importe en concepto de valores excentos de impuestos. | 2008 |
sendVoucher | Si esa factura, se enviará por email al cliente. Este parámetro es de menor relevancia que el del cliente. | |
taxedAmount | Importe conceptos gravados. | 2009 |
totalAmount | Importe total del documento. | 2010 |
notes | Notas relacionadas con el comprobante | |
Items | ||
discount | Porcentaje de descuento aplicado. Por default es 0 | |
name | Nombre del producto | 3001 |
qty | Cantidad del producto | 3002 |
tax | Porcentaje de IVA | 3003 |
taxed | Verdadero si posee impuestos, de lo contrario, falso. | 3004 |
unitPrice | Precio unitario del producto | 3005 |
unitsMtx | Unidades (solo en caso de invocar al servicio MTX) | |
codeMtx | Código (solo en caso de invocar al servicio MTX) | |
relatedTaxes | ||
code | Código del impuesto (**6) | 4001 |
baseAmount | Base imponible | 4002 |
amount | Importe liquidado según la alícuota de IVA | 4003 |
relatedOtherTaxes | ||
code | Código del impuesto (**7) | 5001 |
name | Descripción del impuesto | 5002 |
baseAmount | Base imponible | 5003 |
taxAmount | Importe del impuesto | 5004 |
aliquot | Alícuota | 5005 |
relatedInvoices (sólo cuando es una nota de crédito) | ||
invoiceInternalNumber | Número de la factura original (interna del punto de venta). | 6001 |
invoiceType | Tipo de comprobante original (**1). | 6002 |
storeCode | Número de tienda original. | 6003 |
terminalCode | Número de terminal original. | 6004 |
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.
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.
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.
1: MONOTRIBUTISTA, 2: RESPONSABLE INSCRIPTO, 3: CONSUMIDOR FINAL, 4: IVA EXENTO
4: Conceptos a facturar
Se listan a continuación los valores posibles.
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.
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.
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.
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
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
}
Campos en la respuesta | |
---|---|
authorizationDate | Fecha de vencimiento del CAE |
authorizationCode | CAE |
fiscalPointOfSale | Punto de venta AFIP |
detail | Detalle específico, en caso de corresponder, del error informado. |
ack | Código de respuesta: 999: error no identificado. |