GET /v1/documents

Scope: documents:read

Lista documentos de la empresa asociada a la API Key, con paginación y filtros.

Query params (todos opcionales)

Parámetro	Tipo	Default	Descripción
`limit`	number	50	Tamaño de página. Máximo 200.
`offset`	number	0	Cantidad de registros a saltar.
`status`	string	—	Filtrar por estado: `PENDING`, `SUBMITTED`, `AUTHORIZED`, `REJECTED`, `ERROR`.
`type`	string	—	Filtrar por tipo: `INVOICE`, `CREDIT_NOTE`.

Respuesta 200

{
  "success": true,
  "data": {
    "total": 42,
    "limit": 50,
    "offset": 0,
    "items": [
      {
        "id": "uuid",
        "documentType": "INVOICE",
        "documentNumber": "001-001-000000001",
        "accessKey": "07032...",
        "status": "AUTHORIZED",
        "ambiente": "PRUEBAS",
        "establishmentCode": "001",
        "emissionPointCode": "001",
        "createdAt": "2026-03-08T20:00:00.000Z",
        "updatedAt": "2026-03-08T20:00:05.000Z"
      }
    ]
  }
}

El listado incluye solo metadatos. Para obtener los XML completos usar GET /v1/documents/detail o GET /v1/documents/:id.

GET /v1/documents/detail

Scope: documents:read

Detalle completo de un documento. Enviar uno y solo uno de los query params.

Query params

Parámetro	Descripción
`accessKey`	Clave de acceso (49 dígitos).
`documentNumber`	Número de comprobante. Formato `001-001-000000001`.

Si se envían ambos o ninguno → 400 INVALID_PARAMS.

Respuesta 200

Objeto documento completo: id, documentType, documentNumber, accessKey, status, requestPayload, sriResponse, errorDetail, unsignedXml, signedXml, authorizedXml, createdAt, updatedAt, etc.

Errores

HTTP	error.code	Cuándo
400	`INVALID_PARAMS`	Falta uno o se enviaron ambos query params.
400	`INVALID_ACCESS_KEY`	`accessKey` no tiene 49 dígitos.
400	`INVALID_DOCUMENT_NUMBER`	`documentNumber` no cumple formato.
400	`DOCUMENT_NOT_FOUND`	Documento no encontrado en la empresa.

GET /v1/documents/:id

Scope: documents:read

Detalle del documento por UUID interno. Mismo objeto que GET /v1/documents/detail.

Para nuevas integraciones se recomienda usar GET /v1/documents/detail?accessKey=... en lugar de este endpoint.

Errores: 400 DOCUMENT_NOT_FOUND si el documento no existe.