Trifaco API
Empresa

Actualizar perfil para futuras emisiones

PATCH/v1/company

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

Alcance: Reemplazo versionado/idempotente para operaciones futuras; conserva NIT e historial y rechaza cambios con documentos pendientes o inciertos.

Actualizar perfil para futuras emisiones

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.

Reemplazo explícito del perfil para operaciones futuras. No cambia el NIT de la empresa; requiere If-Match.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/v1/company" \  -H "Idempotency-Key: string" \  -H "If-Match: string" \  -H "Content-Type: application/json" \  -d '{    "profile": {      "identification": {        "type_code": "10",        "number": "string"      },      "legal_name": "string",      "party_type": "company",      "address": {        "country_code": "CO",        "department_code": "st",        "municipality_code": "strin",        "city_name": "string",        "line": "string"      },      "tax_registration": {        "responsibility_codes": [          "string"        ],        "tax_scheme_codes": [          "string"        ]      },      "operations_contact": {        "name": "string",        "email": "user@example.com"      },      "billing_contact": {        "name": "string",        "email": "user@example.com"      }    },    "reason": "string"  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "environment": "simulation",  "version": 1,  "profile": {    "identification": {      "check_digit": "s",      "type_code": "31",      "number": "string"    },    "legal_name": "string",    "party_type": "company",    "address": {      "country_code": "CO",      "department_code": "st",      "municipality_code": "strin",      "city_name": "string",      "line": "string",      "postal_code": "string"    },    "tax_registration": {      "responsibility_codes": [        "string"      ],      "tax_scheme_codes": [        "string"      ]    },    "operations_contact": {      "name": "string",      "email": "user@example.com"    },    "billing_contact": {      "name": "string",      "email": "user@example.com"    }  },  "status": "configuring",  "updated_at": "2019-08-24T14:15:22Z",  "account_type": "company"}

Consultar empresa propia GET

**Estado:** implementada. **Ambientes:** simulation, qualification. **Permisos:** `company:read`. **Alcance:** Perfil y estado actuales; updated_at refleja cambios de perfil, versión o estado. Consultar empresa propia

Consultar preparación para emitir GET

**Estado:** parcial. **Ambientes:** simulation, qualification. **Permisos:** `company:read`. **Alcance:** Preparación efectiva por ambiente sin activación: numeración, firma y configuración; no certifica habilitación DIAN, entrega ni comercio. Consultar preparación para emitir