MANUAL DE INTEGRACIÓN

Versión 1.1

Revisiones

Fecha	Autor	Detalle
30/10/2019	Usuário desconhecido (martin.malievac)	Creación del documento
24/11/2020	Usuário desconhecido (noeliac)	Revisión servicios 2G

Contenido

Acerca del documento

Fiscal Flow es la solución de Napse para la emisión de documentos fiscales, según la normativa AFIP y la gestión de impresoras de 2da generación.

El presente manual esta destinado a todos los sistemas de punto de venta que se integren con Fiscal Flow mediante el uso del agente.

A continuación, se expone una descripción de los servicios REST disponibles a través del uso del agente, destinados a la autorización de comprobantes electrónicos.

1. SERVICIOS GENERALES

a. "Authenticate"

Servicio de seguridad para autenticarse en el sistema.

Es un método REST basado en el formato JSON.

Un ejemplo de invocación es: [post] http://[dirección-ip]:[puerto]/api/v1/oauth2/authenticate

Los datos de clientId y clientSecret habilitados pueden verse dentro del módulo Seguridad/Clientes API en Fiscal Flow.

Para la utilización del resto de los servicios de Fiscal Flow es necesario informar el token obtenido a través de este método.

POST- REQUEST- BODY

{
    "clientId":"vcn5keiiw0zf",
    "clientSecret":"g23n2tlt3fmap0ymaosv"
}

request
clientId	Envia el valor clientId
clientSecret	Envia el valor clientSecret

A continuación, se expone un ejemplo de la respuesta brindada por el servicio.

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJOYXBzZSIsImRhdGEiOnsiX2lkIjoiNWU5NDczZGU4YTk2NDI5MzlkMzVkYzhiIn0sImlhdCI6MTU5NTk0NzkyOSwiZXhwIjoxNTk1OTUxNTI5fQ.yrMsmYgyPtii59moYgujKE96ZeFNhHuZnwt3OeE59fM",
  "expiresIn": 3600000,
  "expUnit": "miliseconds"
}

Campos en la respuesta
token	Token de seguridad devuelto por el sistema
expiresIn	Tiempo de expiración del token medido en unidad de expiración
expUnit	Unidad de expiración

b. "clientStatus"

Este método es invocado por el punto de venta para verificar el estado activo de los servicios expuestos por Fiscal Flow. Asimismo, permite notificar que el punto de venta se encuentra activo.

Es un método REST basado en el formato JSON para el intercambio de datos.

Un ejemplo de invocación es: [post] http://[dirección-ip]:[puerto]/api/v1/clientStatus

PRE-REQUISITO

Para el uso del servicio es necesario informar en el header de la petición el token obtenido a través del servicio "Authenticate" con el parámetro x-access-token

REQUEST- HEADER

  "x-access-token": token

request
x-access-token	Token obtenido a través del servicio "Authenticate"

REQUEST- BODY

{ 
   "requestCredential":{ 
      "companyCode":"napse",
      "terminalCode":"10",
      "storeCode":"1"
   }
   "printerInfo":{
      "pointOfSale":"0002"
      "fiscalSerial":"PHAS10700005"
   }
}

requestCredential
	Descripción	Tipo de dato	Requerido	Validación
companyCode	Código de compañía, provisto para la empresa que contrata el servicio	String	Si	992
terminalCode	Código de terminal / punto de venta	String	Si	992
storeCode	Código de tienda	String	Si	992
printerInfo
pointOfSale	2G: Punto de Venta (Centro emisor)	String	Obligatorio: Solo para 2g
fiscalSerial	2G: Nro serie impresora	String	Obligatorio: Solo para 2g

A continuación, se expone un ejemplo de la respuesta brindada por el servicio.

{ 
   "ack":0,
   "message": ""
}

Campos en la respuesta

message

Detalle del error (si existiese)

ack

Código de respuesta:

0: ok

2007: Falta enviar las credenciales
2008: La compañia no existe
2010: No se encuentra configurado el CAE para la terminal
2013: La propiedad printerInfo debe ser un objeto
2014: La propiedad requestCredential debe ser un objeto
2015: Las credenciales tienen un error
2038: El numero de serie de la impresora debe ser alfanumérica
2043: La terminal esta configurada para operar en modo electronico. Por favor cambie la configuracion, comuniquese mediante el clientStatus e intente nuevamente
2046: Falta la propiedad printerInfo
2047: Falta la propiedad printerInfo.fiscalSerial
2048: Falta la propiedad printerInfo.pointOfSale
2049: La terminal electronica indicada no esta configurada en Fiscal Flow

3006: Falta el token de acceso
3016: Error en el requestCredential - printerInfo
3021: No existe CAEA para la compañía

c. "zReport"

SERVICIOS PARA OBTENER EL INFORME Z POR COMPAÑÍA, TIENDA Y TERMINAL

Este método se utiliza para obtener el informe Z de un determinado período..
Es un método REST cuyo contenido interno es JSON.
Un ejemplo de invocación es: [post] http://[dirección-ip]:[puerto]/api/v1/zReport

PRE-REQUISITO

Para el uso del servicio es necesario informar en el header de la petición el token obtenido a través del servicio "Authenticate" con el parámetro x-access-token

REQUEST- HEADER

  "x-access-token": token

request
x-access-token	Token obtenido a través del servicio "Authenticate"

REQUEST- BODY

{ 
   "requestCredential":{ 
      "companyCode":"napse",
      "terminalCode":"10",
      "storeCode":"1"
   },
   "zNumber": 20201029
}

Los campos marcados con son requeridos cuando operan con Impresoras de 2G.

requestCredential
	Descripción	Tipo de dato	Requerido
companyCode	Código de compañía, provisto para la empresa que contrata el servicio	String	Si
terminalCode	Código de terminal / punto de venta	String	Si
storeCode	Código de tienda	String	Si
printerInfo
zNumber	El número de cierre Z	String	Si

Ejemplo de respuesta:

{
    "ack": 0,
    "result": [
        {
            "_id": "5f9af52ee4eff21a457dd343",
            "lastInvoiceNumber": 352,
            "totalAuthorized": 2,
            "nonTaxedAmount": 0,
            "exemptAmount": 0,
            "companyCode": "napse",
            "storeCode": "1001",
            "terminalCode": "1001",
            "afipPosCode": "20",
            "invoiceType": 6,
            "zNumber": 20201028,
            "firstInvoiceNumber": 350,
            "relatedTaxes": [
                {
                    "_id": "5f997b2365fe1611e14ffd8b",
                    "amount": 242.98,
                    "baseAmount": 1157.02,
                    "code": "5",
                    "name": "IVA 21.00"
                }
            ],
            "relatedOtherTaxes": [],
            "createdAt": "2020-10-29T17:00:30.056Z",
            "updatedAt": "2020-10-29T17:00:30.119Z",
            "__v": 1
        }
    ]
}

Campos en la respuesta

ack

Código de respuesta:

0: ok

3006: Falta el token de acceso
3020: La terminal no existe, registrarse a traves del metodo clientStatus

3001: la información enviada (companyCode, terminalCode, storeCode y zNumber).
3002: no existe información de cierre.
999: error desconocido.

result

En caso de que el ack sea 0 (ok) se informará un registro por cada tipo de documento (invoiceType).

Para referencias de los tipos de comprobante, ir aquí: Tipos de Comprobante

3. SERVICIO FACTURA ELECTRÓNICA

Este servicio permite la emisión y almacenamiento de comprobantes electrónicos respetando el régimen de factura electrónica según la resolución dispuesta por AFIP.

Fiscal Flow solicitará y obtendrá el CAE de los comprobantes generados con su correspondiente fecha de vencimiento, gracias a un enlace directo de webservices con los servidores de AFIP.

a. 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.

b. Servicios específicos

i. "Authorize"

Este método se utiliza para autorizar documentos electrónicos por CAE.
El agente intenta autorizar por CAE, en caso de encontrar un inconveniente, autoriza en forma offline (CAEA).
Es un método REST basado en el formato JSON para el intercambio de datos.
Un ejemplo de invocación es: [post] http://[dirección-ip]:[puerto]/api/v1/invoice/authorize

PRE-REQUISITO

Para el uso del servicio es necesario informar en el header de la petición el token obtenido a través del servicio "Authenticate" con el parámetro x-access-token

REQUEST- HEADER

  "x-access-token": token

request
x-access-token	Token obtenido a través del servicio "Authenticate"

REQUEST- BODY

Acceso a JSON de ejemplo por tipos de comprobante: FF - Ejemplos JSON comprobantes

requestCredential
	Descripción	Tipo de dato	Requerido	Validación
companyCode	Código de compañía, provisto para la empresa que contrata el servicio	String	Si	992
terminalCode	Código de terminal / punto de venta	String	Si	992
storeCode	Código de tienda	String	Si	992
customer
code	Código del cliente	String	No
businessName	Nombre de la persona / Empresa cliente (Receptor del comprobante)	String	Si. No es requerido si se trata de un comprobante distinto de tipo A y se trata de Consumidor Final
fiscalAddress	Dirección fiscal de la persona / empresa	String	No
city	Nombre de la ciudad	String	No
state	Nombre de la provincia	String	No
postalCode	Código postal	String	No
taxCategory	Situación impositiva del cliente frente al IVA	Integer (1)	Si	4.2 Situación impositiva del cliente
IBCategory	Situación impositiva del cliente frente a Ingresos Brutos	String	No
documentType	Tipo de documento de identificación del cliente	Integer (2)	Si. En caso de tratarse de Consumidor Final y el monto en pesos resultante del comprobante es menor o igual a lo establecido por la RG 4444/2019, se deberá enviar 99.	4.1 Tipos de documentos permitidos	DocTipo
identificationNumber	Número de identificación del cliente. No es necesario si este fuese consumidor final.	Number	Si. En caso de tratarse de Consumidor Final y el monto en pesos resultante del comprobante es menor o igual a lo establecido por la RG 4444/2019, el campo deberá ser cero (0).		DocNro
IBIdentificationNumber	Número de inscripción en Ingresos Brutos	Number	No
personalEmail	Dirección de correo electrónico del cliente. Es un dato de contacto, no es al que se enviará la factura.	String	No
billingEmail	Dirección de correo electrónico del cliente adonde debe llegar la factura. Corresponde al mail de facturación	String	Si en caso de desear enviar factura por correo electrónico
sendVoucher	Si desea marcar la factura para su posterior envío por correo electrónico. Por default es FALSE.	String	No
civilStatus	Estado civil del cliente. No es necesario si es empresa.	String	No
fiscalDocument
internalId	Número de comprobante interno del punto de venta Debe ser un identificador único de la transacción de hasta 40 caracteres	Alfanumérico	Si
orderNumber	Número de pedido	Number	No
operator	Código del operador o vendedor	String	No
conceptCode	Conceptos a facturar	Integer (2)	Si	4.3 Conceptos a facturar	Concepto
invoiceType	Tipo de Comprobante	Integer (3)	Si	4.4 Tipos de Comprobantes	CbteTipo
saleCondition	Condición de venta	String	Si
currency	Código de moneda	String	Si	4.5 Monedas	MonId
currencyChange	Cotización de la moneda informada	Number (10,6)	Si		MonCotiz
invoiceDate	Fecha del documento (Formato: yyyy-mm-dd hh:mm:ss)	Date	Si		CbteFch
paymentDueDate	Fecha de vencimiento del pago del documento (Formato: yyyy-mm-dd)	Date	No		FchVtoPago
periodStartDate	Para servicio (invoiceType=2,3). Fecha de inicio periodo facturado (Formato: yyyy-mm-dd)	Date	No		FchServDesde
periodEndDate	Para servicio (invoiceType=2,3). Fecha de fin periodo facturado (Formato: yyyy-mm-dd)	Date	No		FchServHasta
businessDate	Fecha contable del documento (Formato: yyyy-mm-dd) Si no viene el valor por defecto es fecha del día formato yyyy-mm-dd	Date	No
zNumber	Numero de cierre Z Si no viene el valor por defecto es fecha del día formato yyyymmdd	Number	No
subtotalAmount	Importe total neto de descuentos e impuestos (IVA y otros impuestos: percepción, impuestos municipales, impuestos internos) (Comprobantes tipo A: importe sin IVA. Comprobantes tipos B: importe con IVA incluido)	Number (10,2)	Si
ticketDiscount	Descuento global sobre la venta (ticket). Importe sumatorio de todos los descuentos con scope: T (transaction) (Comprobantes tipo A: descuento neto sin IVA. Comprobantes tipos B: descuento con IVA incluido)	Number (10,2)	Si
discountAmount	Importe sumatorio de todos los descuentos de venta (a nivel ítems + a nivel factura o ticket) con scope: I (item) + T (transaction) (Comprobantes tipo A: total de descuentos neto sin IVA. Comprobantes tipos B: descuentos con IVA incluido)	Number (10,2)	Si
nonTaxedAmount	Importe conceptos no gravados	Number (10,2)	Si		ImpTotConc
taxedAmount	Importe neto gravado del documento Suma de relatedTaxes.baseAmount	Number (10,2)	Si		ImpNeto
amountIVA	Importe en concepto de IVA Suma de relatedTaxes.amount	Number (10,2)	Si		ImpIVA
amountOtherTaxes	Importe en concepto de Otros Tributos Suma de relatedOtherTaxes.amount	Number (10,2)	Si		ImpTrib
exemptAmount	Importe en concepto de valores exentos de impuestos	Number (10,2)	Si		ImpOpEx
totalAmount	Importe total del documento	Number (10,2)	Si		ImpTotal
relatedInvoices (sólo cuando es una nota de crédito o nota de débito. Obligatorio si no se informa periodo asociado (relatedInvoicesPeriod))					CbtesAsoc
invoiceType	Tipo de Comprobante asociado	Integer (3)	Si en caso de tratarse de Nota de crédito o Nota de debito y no se informa relatedInvoicesPeriod	4.4 Tipos de Comprobantes	Tipo
pointOfSale	Punto de venta AFIP del comprobante asociado	String (5)	Si en caso de tratarse de Nota de crédito o Nota de debito y no se informa relatedInvoicesPeriod		PtoVta
invoiceNumber	Número del punto de venta del comprobante asociado	String (8)	Si en caso de tratarse de Nota de crédito o Nota de debito y no se informa relatedInvoicesPeriod		Nro
invoiceDate	Fecha del comprobante asociado (Formato: yyyy-mm-dd)	Date	Si en caso de tratarse de Nota de crédito o Nota de debito y no se informa relatedInvoicesPeriod		CbteFch
relatedInvoicesPeriod (sólo cuando es una nota de crédito o nota de débito. Obligatorio si no se informan comprobantes asociados (relatedInvoices))					PeriodoAsoc
startDate	Fecha correspondiente al inicio del periodo del comprobante que se quiere identificar (Formato: yyyy-mm-dd)	Date	Si en caso de tratarse de Nota de crédito o Nota de debito y no se informa relatedInvioces		FchHasta
endDate	Fecha correspondiente al fin del periodo del comprobante que se quiere identificar (Formato: yyyy-mm-dd)	Date	Si en caso de tratarse de Nota de crédito o Nota de debito y no se informa relatedInvioces		FchDesde
Items
action	Concepto del ítem. S: Sale \| R: Return S: cuando se trata de un producto que suma a la transacción, por ejemplo, un item que se vende. R: cuando se trata de un producto que resta a la transacción, por ejemplo, un item que se devuelve, o un envase de bebida.	char (1)	Si
sku	Código del producto	String	Si
code	Código secundario del producto. Se utiliza como codigoMtx: Deberán corresponder a la estructura provista por la ASOCIACION ARGENTINA DE CODIFICACION DE PRODUCTOS COMERCIALES —CODIGO—, códigos GTIN 13, GTIN 12 y GTIN 8, correspondientes a la unidad de consumo minorista o presentación al consumidor final	String	No
name	Nombre del producto	String	Si
qty	Cantidad del producto	Number	Si
um	Unidad de medida del producto. Valor por defecto: UN	String	No
serialNumber	Número de serie del producto en caso de requerir	String	No
lotNumber	Número de lote o partida del producto en caso de requerir	String	No
barCode	Código de barras del producto	String	No
tax	Porcentaje de IVA asociado al ítem	Number (4,2)	Si. Se deberá enviar en 0 (cero) si es exento o no gravado.
taxAmount	Importe de IVA asociado al ítem	Number (10,2)	Si
internalTax	Importe de impuestos internos aplicados al ítem (unitario)	Number (10,2)	No
discount	Suma de descuentos aplicados. Default 0.0 Suma de items.promotions.amount (Comprobantes tipo A: descuento neto sin IVA. Comprobantes tipos B: descuento con IVA incluido)	Number (10,2)	Si
unitPrice	Precio unitario del producto. (Comprobantes tipo A: precio neto sin IVA. Comprobantes tipos B: precio IVA incluido)	Number (10,2)	Si
totalPrice	Precio unitario del producto x cantidad (qty) (Comprobantes tipo A: precio neto sin IVA. Comprobantes tipos B: precio IVA incluido)	Number (10,2)	Si
promotions
code	Código del descuento o Promoción	String	No
scope	Concepto de la promoción. I: Ítem \| T: Transacción I: Cuando se trata de un descuento propio del ítem o producto/servicio T: Cuando se trata de un descuento a nivel transacción. Se informa de manera prorrateada	Char (1)	Si
name	Nombre / descripción del descuento	String	No
amount	Importe aplicado como descuento (Comprobantes tipo A: descuento neto sin IVA. Comprobantes tipos B: descuento con IVA incluido)	Number (10,2)	No
taxAmount	Importe de IVA asociado a la promoción	Number (10,2)	No
internalTax	Importe de impuestos internos asociado a la promoción	Number (10,2)	No
percent	Porcentaje de descuento aplicado. SI no se informa poner 0.0	Number (4,2)	No
itemInfo
key / value	Colección clave / valor libre para información específica del producto o del negocio.		No
benefits
code	Código del beneficio	String	No
name	Nombre / descripción del beneficio	String	No
benefitType	Nombre / descripción del tipo de beneficio	String	No
amount	Valor numérico, que representa importe, cantidad de cupones, o puntos	Number (10,2)	No
couponCode	Código del CUPÓN	String	No
cardType	Código del TIPO DE TARJETA	String	No
cardCode	Código de la TARJETA de beneficio	String	No
cardCurrentAmount	Monto del beneficio de la TARJETA	Number (10,2)	No
relatedTaxes					AlicIva
amount	Importe liquidado según la alícuota de IVA	Number (10,2)	Si. No se deberá enviar el array relatedTaxes si es exento o no gravado. Informar en 0 (cero) en caso de tratarse de IVA 0%.		Importe
baseAmount	Base imponible para la determinación de la alícuota	Number (10,2)	Si		BaseImp
code	Código del Tipo de IVA	Integer (2)	Si	4.6 Tipos de IVA	Id
name	Descripción del impuesto	String	Si
relatedOtherTaxes (solo si hay impuestos: percepciones de IVA, percepciones de Ingresos Brutos, Impuestos Internos, retenciones nacionales, municipales, etc.-) En caso de mandarlo es obligatorio todos los campos del array.					Tributos
amount	Importe del impuesto	Number (10,2)	No		Importe
baseAmount	Base imponible para la determinación del tributo	Number (10,2)	No		BaseImp
code	Código del Tipo de Impuesto	Integer (2)	No	4.7 Códigos de Impuesto	Id
name	Descripción de impuesto	String	No		Desc
aliquot	Alícuota	Number (3,2)	No		Alic
optionals (solo si se encuentra dentro del conjunto de emisores habilitados a informar opcionales) (IMPORTANTE: si se trata de operaciones que no dan lugar al cómputo del crédito fiscal - F. 8001)					Opcionales
code	Código identificador del Opcional de AFIP	String	No	4.8 Códigos de opcionales permitidos 5. Operaciones que no dan lugar al crédito fiscal F.8001	Id
name	Valor del Parámetro opcional a informar	Ver 5. Operaciones que no dan lugar al crédito fiscal F.8001	No		Valor
paymentMethods
code	Código del medio de pago	String	Si
name	Nombre del medio de pago	String	Si
amount	Importe	Number (10,2)	Si
surcharge	Alícuota de recargo	Number (3,2)	No
paymentMethodsInfo
key / value	Colección clave / valor de objetos que representan información adicional del pago	Array	No
documentInfo
key / value	Colección clave / valor de objetos que representan información adicional del documento.		No

Formato y Códigos de Respuesta

A continuación, se expone un ejemplo de la respuesta brindada por el servicio.

{ 
   "authorizationDate":"2019-11-08T03:00:00.000Z",
   "authorizationCode":"69447792300310",
   "authorizationType": "CAE",
   "invoiceType": "1",
   "pointOfSale":"00010",
   "invoiceNumber": "00000044"
   "ack":0,
   "message":{},
   "url": "http://www.fiscalflow.com.ar/public/invoice/xyz123456"
}

Campos en la respuesta
authorizationDate	Fecha de vencimiento del CAE \| CAEA
authorizationCode	Código de Autorización Electrónico (CAE) / Código de Autorización Electrónico Anticipado (CAEA)
authorizationType	CAE \| CAEA
invoiceType	Tipo de comprobante autorizado
pointOfSale	Punto de venta AFIP (5 dígitos)
invoiceNumber	Numero de comprobante enviado a la AFIP, se asocia con el centro emisor AFIP utilizado para facturar.
ack	Código de respuesta: 0: ok 2000: Falta enviar header de la Autorización 2001: Formato de credenciales inválidos 2002: Usuario no encontrado 2003: Contraseña invalida 2004: Falta token de acceso 2005: Token de acceso no existe 2006: Token de acceso caducado 2007: Faltan las credenciales de solicitud 2008: La compañía no existe 2009: Falta enviar Fiscal serial 2010: No se encuentra configurado el CAE para la terminal 2011: CAEA no existente para el periodo y orden 2012: El header de la autorización debe ser de tipo string 2013: La propiedad printerInfo debe ser de tipo object 2014: La propiedad requestCredential debe ser de tipo object 2015: Error de tipo de atributos en las credenciales 2016: Falta el documento fiscal 2017: La propiedad fiscalDocument debe ser de tipo object 2018: La terminal no existe 2019: Falta la propiedad fiscalDocument.items 2020: Falta la propiedad Customer 2021: Falta la propiedad customer.businessName 2022: Falta la propiedad customer.documentType 2023: Falta la propiedad customer.fiscalAddress 2024: Falta la propiedad customer.identificationNumber 2025: Falta la propiedad fiscalDocument.relatedInvoices 2026: Falta la propiedad fiscalDocument.conceptCode 2027: Falta la propiedad fiscalDocument.internalNumber 2028: Falta la propiedad fiscalDocument.invoiceDate 2029: Falta la propiedad fiscalDocument.invoiceType 2030: Falta la propiedad fiscalDocument.nonTaxedAmount 2031: Falta la propiedad fiscalDocument.totalAmount 2032: Falta la propiedad fiscalDocument.relatedOtherTaxes 2033: La propiedad fiscalDocument.optional tiene valores incorrectos 2034: La propiedad fiscalDocument ya existe 2035: Falta la propiedad fiscalDocument.relatedInvoicesPeriod 2040: Falta la propiedad fiscalDocument.invoiceNumber 2041: Falta la propiedad fiscalDocument.pointOfSale 2042: La terminal esta configurada oara operar en modo 2G. Por favor cambie la configuración, comuniquese mediante el servicio clientStatus e intente nuevamente. 2043: La terminal esta configurada oara operar en modo Factura electronica. Por favor cambie la configuración, comuniquese mediante el servicio clientStatus e intente nuevamente. 2044: La terminal esta configurada oara operar en modo Impresora de 1G. Por favor cambie la configuración, comuniquese mediante el servicio clientStatus e intente nuevamente. 2045: Falta la propiedad fiscalDocument.zNumber 2046: Falta la propiedad printerInfo 2047: Falta la propiedad printerInfo.fiscalSerial 2048: Falta la propiedad printerInfo.pointOfSale 2900: Las credenciales son invalidas 2997: Timeout. El servidor no responde sobre la autorización que posee en curso y para el mismo centro emisor y tipo de comprobante, no es posible cursar un nuevo pedido de autorización. 2998: AFIP rechazo la solicitud de autorización 2999: Error interno del servidor 3006: Falta el token de acceso 3018: Esta deshabilitado la modalidad CAEA cuando AFIP esta fuera de linea 3019: Esta deshabilitado la modalidad CAEA cuando la tienda esta fuera de linea 3020: La terminal no existe, registrarse a través del método clientStatus 3021 : No hay CAEA para la empresa 3022 : No puede ser autorizado por CAEA porque la tienda excedió el porcentaje de autorización configurado 3023 : Terminal no registrado para operar en modo 2g. Por favor llame a clientStatus para registrarse 3024 : Credenciales no válidas o número interno faltante en el documento fiscal 3025: Error de agente interno. El agente no tiene información para el periodo actual para calcular el porcentaje de CAEA para autorizar 4000: Error de AFIP (según la especificación del manual del desarrollador, se informa en el campo message). https://www.afip.gob.ar/facturadecreditoelectronica/documentos/manual_desarrollador_COMPG_v2_18-beta1.pdf 4999: Fuera de servicio WebService de AFIP
message	Detalle específico, en caso de corresponder, del error informado OBSERVACIÓN: Cuando se envía una operación previamente autorizada por CAE o CAEA con el mismo número de identificador único de la transacción (internalId), el sistema dará como respuesta el mismo mensaje de la transacción original: authorizationDate authorizationCode authorizationType invoiceType pointOfSale invoiceNumber ack y lo siguiente: documentExisting": "Operacion previamente autorizada para el internalId informado."
url	Contiene la URL para poder ver el comprobante online (para casos en donde el canal de venta imprime un ticket).

ii. "fiscalDocuments"

Este servicio permite consultar un documento fiscal de acuerdo a determinados filtros:

companyCode (string)
storeCode (string)
terminalCode (string)
invoiceType (number)
internalId (string)

Es un método REST basado en el formato JSON para el intercambio de datos.
Un ejemplo de invocación es: [get] http://[dirección-ip]:[puerto]/api/v1/fiscalDocuments?invoiceType=1&internalId=640

PRE-REQUISITO

Para el uso del servicio es necesario informar en el header de la petición el token obtenido a través del servicio "Authenticate" con el parámetro x-access-token

REQUEST- HEADER

  "x-access-token": token

request
x-access-token	Token obtenido a través del servicio "Authenticate"

REQUEST- BODY

{ 
   "requestCredential":{ 
      "companyCode":"napse",
      "terminalCode":"1001",
      "storeCode":"1001"
   }
}

requestCredential
	Descripción	Tipo de dato	Requerido	Validación
companyCode	Código de compañía, provisto para la empresa que contrata el servicio	String	Si	992
terminalCode	Código de terminal / punto de venta	String	Si	992
storeCode	Código de tienda	String	Si	992

A continuación, se expone un ejemplo de la respuesta brindada por el servicio.

{
	 "authorizeInfo": [
		{
    		"code": 10017,
        	"message": "Factura individual, DocTipo: 80, DocNro 30470827047 no se encuentra registrado en los padrones de AFIP o se encuentra inactivo.",
    	    "date": "2020-10-26 23:22:40"       
		}   
	],   
	"attempts": 0,   
	"processed": true,
	"_id": "5f975a4074f8103e0f082ab5",  
	"internalId": "7922124961",
	"orderNumber": 1,   
	"operator": "ALE",
	"conceptCode": 1,
	"invoiceType": 1,
	"saleCondition": "1",
	"currency": "PES",
	"currencyChange": 1,
	"invoiceDate": "2020-10-26T00:00:00.000Z",
	"paymentDueDate": "2020-10-26T00:00:00.000Z",
	"periodStartDate": "2020-10-26T00:00:00.000Z",
	"periodEndDate": "2020-10-26T00:00:00.000Z",
	"businessDate": "2020-10-26T00:00:00.000Z",
	"zNumber": 16768153,
	"items": [      
		{
			"um": "7",
			"_id": "5f975a4074f8103e0f082ab6",
			"action": "S",
			"sku": "53094",
			"code": "1",
			"imageUrl": "",
			"name": "Televisor Sony",
			"qty": 1,
			"serialNumber": "49938801",
			"lotNumber": "12281",
			"barCode": "779893164411834",
			"tax": 21,
			"taxAmount": 100.66,
			"internalTax": 0,
			"discount": 10.2,
			"unitPrice": 587,
			"totalPrice": 587,
       		"promotions": [
                {
                    "_id": "5f975a4074f8103e0f082ab7",
                    "code": "PRS",
                    "scope": "I",
                    "name": "Dto 2x1",
                    "amount": 10.2,
                    "taxAmount": 0,
                    "internalTax": 0,
                    "percent": 0
                }           
			],
			"itemInfo": [
        	        {
                    "_id": "5f975a4074f8103e0f082ab8",
                    "key": "Peso",
                    "value": "15kg"
                },
                {
                    "_id": "5f975a4074f8103e0f082ab9",
                    "key": "ModalidadEnvio",
                    "value": "Envío a Domicilio"
                },
                {
                    "_id": "5f975a4074f8103e0f082aba",
                    "key": "ContactoEntrega",
                    "value": "Preguntar por Francisco Perez"
                }           
			]
		}
	],
	"relatedTaxes": [
			{
				"_id": "5f975a4074f8103e0f082abb",
				"amount": 100.66,
				"baseAmount": 479.34,
				"code": "5",
				"name": "IVA 21%"
			}   
	],
	"relatedOtherTaxes": [],
	"optionals": [],
	"paymentMethods": [
		{
			"_id": "5f975a4074f8103e0f082abc",
			"code": "VISACR",
			"name": "Tarjeta VISA Credito",
			"amount": 11.8,
			"surcharge": 2,
			"paymentMethodsInfo": [
  		  	{
				  "_id": "5f975a4074f8103e0f082abd",
    		  	  "key": "DatosTC",
    		  	  "value": "2345 01 123456 0044"
   			},
   		 	{
    			  "_id": "5f975a4074f8103e0f082abe",
    		   	  "key": "Tasas",
    		      "value": "TNA: 0.00% TEA: 0.00% TEM: 0.00% CFT: 0.00%"
       		}        
			]
  		}
	],
	"documentInfo": [
    	{
	   		"_id": "5f975a4074f8103e0f082abf",
       		"key": "footer",    
	   		"value": "Telefono gratuito CABA, area de defensa y proteccion al consumidor 0810-123-0000"
   		}
	], 
	"benefits": [],
	"subTotalAmount": 10,
	"ticketDiscount": 8.6,
	"discountAmount": 18.8,
	"nonTaxedAmount": 0,
	"taxedAmount": 479.34,  
	"amountIVA": 100.66,
	"amountOtherTaxes": 0,
	"exemptAmount": 0,
	"totalAmount": 580,
	"companyCode": "napse",
	"storeCode": "1001",
	"terminalCode": "1002",
	"testMode": true,
	"documentType": "80",
	"identificationNumber": "30470827047",
	"hasCustomer": true,
	"relatedInvoices": [],
	"authorizationCode": "70437875745658",
	"authorizationType": "CAE",
	"authorizationCodeDueDate": "2020-11-05T00:00:00.000Z",
	"invoiceNumber": 2604,
	"pointOfSale": 14,
	"status": "ok",
	"invoiceHour": 0,
	"createdAt": "2020-10-26T23:22:40.643Z",
	"updatedAt": "2020-10-26T23:23:00.095Z",
    "__v": 0
}

c. Tabla de maestros