Trifaco API
Catálogos

Consultar catálogo versionado

GET/v1/catalogs/{catalog}

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

Alcance: Publica catálogos versionados del subconjunto fiscal implementado, con autenticación y aislamiento por ambiente. No contiene el catálogo DIAN completo. Perfil optativo co-sale-cop-iva-v1/v3: IVA gravado/exento/excluido solo en simulación sin firma ni notas; habilitación real bloqueada.

Catálogos efectivos del perfil, no catálogo DIAN completo. IDs y semántica de active/valid_from en CATALOGS.md. Catálogo desconocido: 404 CATALOG_NOT_FOUND. Cursores firmados por empresa, ambiente, catálogo y versión; vencen en 24 horas.

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

catalog*string

Código validado contra catálogo y perfil vigente; no es texto libre.

Match^[A-Za-z0-9_.-]+$
Length1 <= length <= 30

Query Parameters

cursor?string

Opaco y ligado a filtros/empresa/ambiente; caduca en 24 h. CURSOR_EXPIRED exige reiniciar listado.

Length1 <= length <= 2048
limit?integer
Range1 <= value <= 100
Default50

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/catalogs/string"
{  "id": "product_schemes",  "version": "trifaco-2026-09-14-v6",  "items": [    {      "code": "001",      "label": "001",      "active": false,      "valid_from": "2026-09-14"    },    {      "code": "010",      "label": "010",      "active": false,      "valid_from": "2026-09-14"    },    {      "code": "020",      "label": "020",      "active": false,      "valid_from": "2026-09-14"    },    {      "code": "999",      "label": "999",      "active": true,      "valid_from": "2026-09-14"    }  ],  "next_cursor": null}

Consultar perfiles y límites efectivos GET

**Estado:** parcial. **Ambientes:** simulation, qualification. **Permisos:** `company:read`. **Alcance:** Publica disponibilidad según permisos efectivos, ambiente, estado de la empresa y custodia. enabled no sustituye las comprobaciones del rango, certificado y configuración de cada admisión ni acredita aceptación DIAN. Perfil optativo co-sale-cop-iva-v1/v3: IVA gravado/exento/excluido solo en simulación sin firma ni notas; habilitación real bloqueada. Consultar perfiles y límites efectivos

Consultar salud de servicio y dependencias GET

**Estado:** implementada. **Ambientes:** simulation, qualification. **Permisos:** `company:read`. **Alcance:** Estado autenticado y saneado del último muestreo por ambiente; ausencia/caducidad implica unknown. Incidentes estables de atraso, incertidumbre y recursos, sin conteos de otras empresas. Entrega y cobro comercial permanecen sin soporte. Una respuesta reciente no es una declaración oficial de disponibilidad DIAN. Consultar salud de servicio y dependencias