Trifaco API
Empresa

Configurar destinatarios y entrega

PUT/v1/company/delivery-settings

Estado: parcial. Ambientes: simulation, qualification. Permisos: company:write.

Alcance: Requiere company:write y documents:deliver, If-Match, Idempotency-Key y razón. Uno a cinco destinatarios automáticos separados del correo fiscal; nuevas revisiones congelan configuración. Solo ensayo local.

Requiere además documents:deliver. Canal local o SES optativo en habilitación. Guardar configuración no demuestra verificación de identidad ni entrega.

Authorization

ClientApiKey
X-API-Key<token>

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

In: header

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 PUT "https://example.com/v1/company/delivery-settings" \  -H "Idempotency-Key: string" \  -H "If-Match: string" \  -H "Content-Type: application/json" \  -d '{    "mode": "external",    "automatic": true,    "recipients": [],    "reason": "string"  }'
{  "company_id": "b2e6a1c3-1a5e-44ae-a8fd-81f76fd715cf",  "environment": "simulation",  "version": 1,  "mode": "external",  "automatic": true,  "recipients": [],  "channel": "local_test",  "channel_status": "not_configured",  "message": "string"}

Consultar configuración de entrega GET

**Estado:** parcial. **Ambientes:** simulation, qualification. **Permisos:** `company:read`. **Alcance:** Configuración por empresa/ambiente; valores externos por defecto. channel_status solo indica URL de ensayo configurada; no verifica disponibilidad ni correo real. Consultar configuración de entrega

Listar claves sin secretos GET

**Estado:** implementada. **Ambientes:** simulation, qualification. **Permisos:** `keys:write`. **Alcance:** Lista metadatos de claves propias con paginación por cursor y estado calculado activo, revocado o vencido; nunca devuelve secretos ni huellas. Listar claves sin secretos