Trifaco API
Entregas

Recuperar entrega fallida o reanudar conciliación

POST/v1/deliveries/{id}/retries

Estado: parcial. Ambientes: simulation, qualification. Permisos: documents:deliver.

Alcance: Rechazo SES confirmado y recuperable: reintento del mismo paquete tras corregir causa. Incertidumbre: solo conciliación. Motivo, permisos, idempotencia y auditoría; no permite borrar evidencia ni forzar reenvío.

Rechazo SES recuperable: después de corregir la causa, programa el mismo paquete. Resultado incierto: solo reanuda conciliación, nunca borra la reserva ni prueba ausencia de envío. Requiere motivo e Idempotency-Key; conserva auditoría.

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

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/deliveries/497f6eca-6276-4993-bfeb-53cbbbba6f08/retries" \  -H "Idempotency-Key: string" \  -H "Content-Type: application/json" \  -d '{    "reason": "string"  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "document_id": "b792e8ae-2cb4-4209-85b9-32be4c2fcdd6",  "revision": 1,  "status": "not_ready",  "recipients": [    "user@example.com"  ],  "created_at": "2019-08-24T14:15:22Z",  "next_attempt_at": "2019-08-24T14:15:22Z",  "failure_code": "string",  "source": "automatic",  "channel": "local_test",  "recipient_results": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "recipient": "user@example.com",      "status": "not_ready",      "attempt_count": 0,      "next_attempt_at": "2019-08-24T14:15:22Z",      "failure_code": "string",      "reconciliation_required": true,      "recovery_action": "none"    }  ]}

Descargar documento autorizado GET

**Estado:** parcial. **Ambientes:** simulation, qualification. **Permisos:** `documents:read`. **Alcance:** Bytes XML, ZIP o PDF por tenant y ambiente, autenticados, inmutables, SHA-256/ETag, descarga forzada, no-store y nosniff. AttachedDocument requiere respuesta DIAN aprobada y firma propia vigente. Sin entrega por correo ni soporte de producción. Descargar documento autorizado

Consultar intentos por destinatario GET

**Estado:** parcial. **Ambientes:** simulation, qualification. **Permisos:** `documents:read`. **Alcance:** Historial local de intentos send/reconcile por destinatario con estado, fechas y causas acotadas. limit 1–100 y cursor firmado; no incluye contenido MIME ni archivos. Consultar intentos por destinatario