Invoice Information

The EMIZOR API has some services to obtain the details and lists of invoices that are required.

Obtaining the detail of an invoice

When an invoice is already valid or rejected, this service must be consumed to obtain detailed information about it.

To consume the service refer to the documentation link:

GET/api/v1/facturas/{cuf_ackTicket_uniqueCode}The details of the invoice are obtained.

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 invoice creation, or the unique code UniqueCode.

Note: If you want to use the uniqueCode or facturaTicket you must send the query string ?unique_code=true.

Successful response (Code 200)

{
  "status": "string",
  "data": {
    "estado": "string",
    "codigoRecepcion": "string",
    "codigoEstado": {
      "codigo": 0,
      "descripcion": "string"
    },
    "tipoEmision": {
      "codigo": 0,
      "descripcion": "string"
    },
    "nitEmisor": "string",
    "numeroFactura": "string",
    "cuf": "string",
    "cufd": "string",
    "sucursal": {
      "codigoSucursal": 0,
      "municipio": "string",
      "pais": "string",
      "zona": "string",
      "ciudad": "string",
      "telefono": "string"
    },
    "cafc": "string",
    "descuentoAdicional": 0,
    "codigoExcepcion": "bool",
    "montoGiftCard": 0,
    "direccion": "string",
    "codigoPuntoVenta": 0,
    "fechaEmision": "string",
    "nombreRazonSocial": "string",
    "documentoIdentidad": {
      "codigo": 0,
      "descripcion": "string"
    },
    "numeroDocumento": 0,
    "complemento": "string",
    "codigoCliente": "string",
    "clientEmail": "string",
    "metodoPago": {
      "codigo": 0,
      "descripcion": "string"
    },
    "numeroTarjeta": 0,
    "montoTotal": 0,
    "moneda": {
      "codigo": 0,
      "descripcion": "string"
    },
    "montoTotalMoneda": 0,
    "leyenda": "string",
    "usuario": "string",
    "documentoSector": {
      "codigo": 0,
      "descripcion": "string",
      "codigoTipoFactura": 0
    },
    "extras": "string",
    "pdf_url": "string",
    "xml_url": "string",
    "errores": [
      {
        "code": 0,
        "warning": true,
        "index_file": 0,
        "description": "string"
      }
    ],
    "urlSin": "string",
    "package_id": 0,
    "index_package": 0,
    "montoTotalSujetoIva": 0,
    "tipoCambio": 0,
    "detalle": [
      {
        "actividadEconomica": 0,
        "codigoProductoSin": 0,
        "codigoproducto": "string",
        "descripcion": "string",
        "unidadMedida": {
          "codigo": 0,
          "descripcion": "string"
        },
        "precioUnitario": 0,
        "subTotal": 0,
        "cantidad": 0,
        "montoDescuento": 0,
        "numeroSerie": "string",
        "numeroImei": "string"
      }
    ]
  }
}

Where the most relevant fields of the response are the following:

• cuf: Unique code of the invoice managed by Impuestos Nacionales.
• estado: Status of the invoice record in the EMIZOR system.
• codigoEstado: Information about the status of the invoice in the SIN.
• fechaEmision: Date with which the invoice was issued.
• tipoEmision: Emission type, can be ONLINE or OFFLINE.
• errores: If the invoice was rejected or observed, they will be shown in this field.
• urlSin: Link of the invoice to the SIN portal (Impuestos Nacionales).
• pdf_url: Link to the PDF of the invoice.
• xml_url: Link to the XML of the invoice.
• cufd: Unique daily billing code.
• detalle: Detail of the items included in the invoice.

---

Obtaining Lists of Invoices

Additionally, a service is available to obtain the lists of invoices registered in the EMIZOR system.

To consume the service refer to the documentation link:

GET/api/v1/facturas/{branchCode}/{posCode}/{sector}The list of invoices is obtained (based on branch, point of sale and sector).

URL Parameters:

• branchCode: The branch code.
• posCode: The point of sale code.
• sector: The sector document type code of the invoices.

This service also allows applying invoice status filters, date range and document number search.

Successful response (Code 200)

{
  "facturas": [
    {
      "id": 0,
      "numeroFactura": 0,
      "cuf": "string",
      "nombreRazonSocial": "string",
      "numeroDocumento": "string",
      "MetodoPago": "string",
      "montoTotal": 0,
      "fechaEmision": "string",
      "urlSin": "string",
      "razonSocialEmisor": "string",
      "correoCliente": "string",
      "telefonoCliente": "string",
      "pdfUrl": "string",
      "estado": "string",
      "codigoEstado": "string",
      "codigoSucursal": 0,
      "tipoEmision": "string",
      "moneda": "string"
    }
  ],
  "paginacion": {
    "paginaActual": 0,
    "porPagina": 0,
    "ultimaPagina": 0,
    "total": 0
  }
}

Where the most relevant fields of the response are the following:

• numeroFactura: Number assigned to each invoice at the time of creation.
• cuf: Unique code of each invoice managed by Impuestos Nacionales.
• nombreRazonSocial: Name or business name registered on each invoice.
• numeroDocumento: Document number registered on each invoice.
• estado: Status of the record of each invoice in the EMIZOR system.
• codigoEstado: Information about the status of each invoice in the SIN.
• fechaEmision: Date with which each invoice was issued.
• tipoEmision: Emission type, can be ONLINE or OFFLINE.
• errores: If any invoice was rejected or observed, it will be shown in this field.
• urlSin: Link of each invoice to the SIN portal.
• pdfUrl: Link to the PDF of each invoice.