API Facturación

Consulta de Documentos Tributarios

Esta sección describe cómo consultar Documentos Tributarios Electrónicos (DTE) en el sistema de facturación electrónica.

Autenticación requerida

Todos los endpoints requieren autenticación mediante token JWT. Consulta la sección de Autenticación para más detalles.

Consultar DTE por ID

GET /api/v1/dte/{id}

Recupera un documento tributario electrónico por su código de generación

Este endpoint permite recuperar la información completa de un documento tributario electrónico mediante su código de generación (UUID).

Ejemplo de Respuesta

Response 

{
    "success": true,
    "data": {
        "control_number": "DTE-03-00000000-000000000000000",
        "generation_code": "A10A53BF-86E0-4...",
        "reception_stamp": "2025F05DF0B4560...",
        "transmission": "NORMAL",
        "status": "INVALIDATED",
        "created_at": "2025-04-16 02:56:33",
        "updated_at": "2025-04-16 02:56:49",
        "json_data": {
          // El DTE emitido
        }
    }

Listar Documentos

GET /api/v1/dte

Lista todos los documentos tributarios con posibilidad de filtrado

Este endpoint devuelve una lista paginada de documentos tributarios electrónicos. Puedes filtrar por tipo, estado, fecha, etc.

Parámetros de consulta

Parámetros que pueden usarse para filtrar la lista de documentos

startDate

Opcional
string
Fecha inicial en formato YYYY-MM-DD

endDate

Opcional
string
Fecha final en formato YYYY-MM-DD

status

Opcional
string
Estado del documento (RECEIVED, PENDING, REJECTED, INVALIDATED)

type

Opcional
string
Tipo de documento (01: Factura, 03: CCF, 05: Nota de Crédito, etc.)

page

Opcional
integer
Número de página para paginación

page_size

Opcional
integer
Cantidad de documentos por página (máx. 100)
Sí Indica campo obligatorio

Ejemplo de Respuesta

Response 

{
    "success": true,
    "data": {
        "documents": [
              {
                "status": "INVALIDATED",
                "transmission_type": "NORMAL",
                "document": {
                  // El DTE emitido
                },
              },
              {
                "status": "RECEIVED",
                "transmission_type": "CONTINGENCY",
                "document": {
                  // El DTE emitido
                },
              },
              // ...
        ],
        "summary": {
            "total": 189,
            "received": 133,
            "invalid": 10,
            "rejected": 46,
            "pending": 0,
            "by_contingency": 75,
            "by_normal": 114
        },
        "pagination": {
            "total_pages": 38,
            "page": 1,
            "page_size": 5
        }
    }