Información de Facturas

El API de EMIZOR dispone de algunos servicios para obtener los detalles y listados de facturas que se requieran.

Obtención del detalle de una factura

Cuando una factura ya esté válida o rechazada, se debe consumir este servicio para la obtención de la información detallada de la misma.

Para consumir el servicio referirse al enlace de la documentación:

GET/api/v1/facturas/{cuf_ackTicket_uniqueCode}Se obtiene el detalle de la factura.

Parámetro URL:

• ack_ticket_uniqueCode: Representa el dato que se utilizará para identificar a la factura a consultar; este puede ser el dato cuf o ack_ticket, que se reciben en la creación de factura, o el código único UniqueCode.

Nota: Si se desea usar el uniqueCode o facturaTicket se debe enviar el query string ?unique_code=true.

Respuesta exitosa (Código 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"
      }
    ]
  }
}

Donde los campos más relevantes de la respuesta son los siguientes:

• cuf: Código único de la factura manejado por Impuestos Nacionales.
• estado: Estado del registro de la factura en el sistema de EMIZOR.
• codigoEstado: Información sobre el estado de la factura en el SIN.
• fechaEmision: Fecha con la que se emitió la factura.
• tipoEmision: Tipo de emisión, puede ser EN LÍNEA o FUERA DE LÍNEA.
• errores: Si la factura fue rechazada u observada, se mostrarán en este campo.
• urlSin: Enlace de la factura al portal del SIN (Impuestos Nacionales).
• pdf_url: Enlace al PDF de la factura.
• xml_url: Enlace al XML de la factura.
• cufd: Código único de facturación diaria.
• detalle: Detalle de los ítems incluidos en la factura.

---

Obtención de Listados de Facturas

Adicionalmente se dispone de un servicio para obtener los listados de facturas registradas en el sistema de EMIZOR.

Para consumir el servicio referirse al enlace de la documentación:

GET/api/v1/facturas/{branchCode}/{posCode}/{sector}Se obtiene el listado de las facturas (basado en sucursal, punto de venta y sector).

Parámetros URL:

• branchCode: El código de sucursal.
• posCode: El código de punto de venta.
• sector: El código del tipo de documento sector de las facturas.

Este servicio también permite aplicar filtros de estado de las facturas, rango de fechas y búsqueda de número de documento.

Respuesta exitosa (Código 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
  }
}

Donde los campos más relevantes de la respuesta son los siguientes:

• numeroFactura: Número asignado a cada factura al momento de la creación.
• cuf: Código único de cada factura manejado por Impuestos Nacionales.
• nombreRazonSocial: Nombre o razón social registrado en cada factura.
• numeroDocumento: Número de documento registrado en cada factura.
• estado: Estado del registro de cada factura en el sistema de EMIZOR.
• codigoEstado: Información sobre el estado de cada factura en el SIN.
• fechaEmision: Fecha con la que se emitió cada factura.
• tipoEmision: Tipo de emisión, puede ser EN LÍNEA o FUERA DE LÍNEA.
• errores: Si alguna factura fue rechazada u observada, se mostrará en este campo.
• urlSin: Enlace de cada factura al portal del SIN.
• pdfUrl: Enlace al PDF de cada factura.