Trifaco API
Archivos

Reintentar generación del archivo

POST/v1/artifacts/{id}/retries

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

Alcance: Solo generación fallida; Idempotency-Key y razón auditada. Conserva revisión, consecutivo y estado fiscal. Firma y fuentes se revalidan antes de publicar.

Solo archivos fallidos. Mantiene revisión y estado fiscal; requiere Idempotency-Key.

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/artifacts/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,  "kind": "signed_xml",  "status": "pending",  "sha256": "string",  "content_type": "string",  "size_bytes": 0,  "download_path": "../dictionary",  "reason_code": "string"}

Consultar ejecución por operation_id GET

**Estado:** parcial. **Ambientes:** simulation, qualification. **Permisos:** `documents:read`. **Alcance:** Solo consulta operaciones de admisión documental y exige documents:read. Las operaciones de compras, certificados, empresa, solicitudes de producción y exportaciones descritas por el contrato aún no están conectadas. Dentro de la empresa/ambiente de la credencial se exige el permiso de lectura de la clase de recurso destino. No se acumulan permisos de otras clases ni se concede lectura por conocer operation_id.

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