Trifaco API
Documentos

Consultar estado actual del documento

GET/v1/documents/{id}

Estado: implementada. Ambientes: simulation, qualification. Permisos: documents:read.

Alcance: Devuelve el documento propio, su ETag y los estados separados de procesamiento y DIAN. Un resultado de simulation no representa aceptación fiscal real.

Consultar estado actual del documento

Authorization

ClientApiKey
X-API-Key<token>

Secreto ligado a empresa, actor, permisos y ambiente. No admite cambiar empresa por body/header.

In: header

Path Parameters

id*string

Identificador opaco. No autoriza acceso por sí mismo.

Formatuuid
Length1 <= length <= 36

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/documents/497f6eca-6276-4993-bfeb-53cbbbba6f08"

{  "id": "00000000-0000-4000-8000-000000000020",  "company_id": "00000000-0000-4000-8000-000000000001",  "environment": "simulation",  "document_type": "invoice",  "external_reference": "DEMO-INVOICE-001",  "revision": 1,  "version": 2,  "processing_status": "retry_scheduled",  "dian": {    "status": "unknown",    "errors": [],    "warnings": []  },  "delivery_status": "not_ready",  "billing_status": "not_billable",  "rules_version": "dian-1.9-draft",  "created_at": "2026-09-10T15:00:00Z",  "updated_at": "2026-09-10T15:00:00Z",  "allowed_actions": [],  "related_note_ids": [],  "blocked_reason": "DIAN_RESULT_UNKNOWN"}

Buscar documentos propios GET

**Estado:** implementada. **Ambientes:** simulation, qualification. **Permisos:** `documents:read`. **Alcance:** Lista documentos propios con filtros y cursores ligados a la empresa, ambiente y consulta. La paginación excluye admisiones posteriores a la instantánea inicial. Buscar documentos propios

Consultar revisión inmutable GET

**Estado:** implementada. **Ambientes:** simulation, qualification. **Permisos:** `documents:read`. **Alcance:** Consulta revisión actual o archivada con entrada e historial, sin modificar evidencia. Consultar revisión inmutable