Status Review

After issuing an invoice, it is necessary to check the status, this is because it is possible that the SIN (Impuestos Nacionales) has rejected the invoice.

The service available for this purpose contemplates the following scenarios:

• VALID INVOICE: Means that the SIN has already accepted the invoice and also validated it.
• REJECTED INVOICE: Means that the SIN rejected the invoice therefore it is not valid.
• OBSERVED INVOICE: Means that the SIN observed the invoice, but it continues to be valid.
• INVOICE IN PROCESS: Means that the SIN received the invoice, but has not yet validated it.

To consume the service refer to the documentation link:

GET/api/v1/facturas/{cuf_ackTicket_uniqueCode}/statusReturns the status of the invoice.

URL Parameter:

• ack_ticket_uniqueCode: Represents the data that will be used to identify the invoice to be consulted; this can be the cuf or ack_ticket data, which are received in the response when consuming the invoice creation service, or the unique code UniqueCode that is registered at the time of creating the invoice.

Note: If you want to use the uniqueCode or facturaTicket you must send the following query string in the URL ?unique_code=true. With this we must send in ack_ticket_uniqueCode the unique code or facturaTicket that we send for the registration of the fiscal document (Invoice or NCD).

Successful response (Code 200)

{
  "status": "string",
  "data": {
    "codigoEstado": 0,
    "estado": "string",
    "errores": []
  }
}

Where:

• estado: Invoice status (In Process, Pending, Valid, Cancelled, Cancellation Rejected, Observed, Cancellation Observed, Rejected).
• codigoEstado: This value can be one of the following:
  • 690: VALID INVOICE
  • 908: VALIDATED INVOICE
  • 902: REJECTED INVOICE
  • 1027: OBSERVED INVOICE
• errores: This value returns the errors for which the invoice was rejected.

Possible error responses (Code 400)

{
  "status": "error",
  "errors": [
    "Invoice not found"
  ]
}