Trifaco API
Documentos

Reanudar revisión bloqueada

POST/v1/documents/{id}/resumption

Estado: parcial. Ambientes: qualification. Permisos: documents:write.

Alcance: Solo qualification: reanuda firma/empaquetado o primer envío bloqueados con la misma identidad y autorización vigente. Tras un upload incierto únicamente concilia por consulta; conserva intentos y nunca reenvía el documento.

Conserva la reserva vigente. No cambia datos fiscales ni reenvía un resultado unknown sin conciliación.

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

Header Parameters

Idempotency-Key*string

Obligatoria en mutaciones. Alcance: empresa/ambiente/operación/recurso destino. Retención mínima 90 días y mientras haya trabajo pendiente. Mismo contenido recupera resultado; contenido diferente produce 409.

Match^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$
Length1 <= length <= 128
If-Match*string

ETag de versión vigente. Replay idempotente se resuelve ANTES de revalidar If-Match; un comando nuevo con versión antigua produce 409 VERSION_CONFLICT.

Match^"[1-9][0-9]*"$
Length1 <= length <= 30

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/documents/497f6eca-6276-4993-bfeb-53cbbbba6f08/resumption" \  -H "Idempotency-Key: string" \  -H "If-Match: string" \  -H "Content-Type: application/json" \  -d '{    "reason": "string"  }'
{  "operation_id": "cb4ede3c-a5d1-45e3-a9d2-fe83accbce52",  "document_id": "b792e8ae-2cb4-4209-85b9-32be4c2fcdd6",  "revision": 1,  "version": 1,  "environment": "simulation",  "external_reference": "string",  "processing_status": "queued",  "dian_status": "not_sent",  "billing_status": "not_reserved",  "created_at": "2019-08-24T14:15:22Z",  "status_url": "../dictionary"}

Cancelar antes de firma POST

**Estado:** parcial. **Ambientes:** simulation, qualification. **Permisos:** `documents:write`. **Alcance:** Requiere If-Match e idempotencia. Solo cancela antes de iniciar la firma, con estado DIAN not_sent y procesamiento no completado. No anula documentos emitidos ni libera resultados DIAN inciertos. Cancelar antes de firma

Consultar archivos de una revisión GET

**Estado:** parcial. **Ambientes:** simulation, qualification. **Permisos:** `documents:read`. **Alcance:** Consulta por revisión archivos originales y derivados con estados pending/available/failed y reason_code. PDF en simulación/habilitación; respuesta XML DIAN correlacionada y AttachedDocument firmado requieren evidencia y autorización. Limit de 1 a 100, sin cursor. Consultar archivos de una revisión