Trifaco API
Configuración XML de habilitación

Versionar configuración para XML candidato de habilitación

POST/v1/qualification-xml-configurations

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

Alcance: Registra una configuración declarada, versionada y con secretos cifrados para un rango propio. Permite preparación en simulation o qualification; SendBillSync exige qualification. No acredita habilitación ante DIAN.

Versionar configuración para XML candidato de habilitación

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Configuración declarada para preparación local de habilitación. No activa envío real ni verifica numeración ante DIAN. PIN y clave técnica se reciben una sola vez y se cifran.

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/qualification-xml-configurations" \  -H "Idempotency-Key: string" \  -H "Content-Type: application/json" \  -d '{    "numbering_range_id": "d065a90b-5366-48c7-8bff-81d217b766c5",    "software_id": "27caa3f5-790d-4c74-b6eb-c82815d170bb",    "provider_identification": {      "type_code": "10",      "number": "string"    },    "test_set_id": "96aed6d3-226a-4988-9792-5aab0f7162f5",    "invoice_authorization": "string",    "valid_from": "2019-08-24",    "valid_until": "2019-08-24",    "software_pin": "string",    "technical_key": "string",    "expected_version": 0,    "reason": "string"  }'
{  "numbering_range_id": "d065a90b-5366-48c7-8bff-81d217b766c5",  "software_id": "27caa3f5-790d-4c74-b6eb-c82815d170bb",  "provider_identification": {    "check_digit": "s",    "type_code": "31",    "number": "string"  },  "test_set_id": "96aed6d3-226a-4988-9792-5aab0f7162f5",  "invoice_authorization": "string",  "valid_from": "2019-08-24",  "valid_until": "2019-08-24",  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "version": 1,  "prefix": "stri",  "range_from": "string",  "range_to": "string",  "created_at": "2019-08-24T14:15:22Z",  "status": "declared",  "secrets_configured": true,  "submission_method": "SendTestSetAsync"}

Consultar configuraciones declaradas sin secretos GET

**Estado:** implementada. **Ambientes:** simulation, qualification. **Permisos:** `company:read`. **Alcance:** Lista las versiones declaradas de configuración de la empresa y ambiente; no devuelve secretos de software. Consultar configuraciones declaradas sin secretos

Consultar versión sin PIN ni clave técnica GET

**Estado:** implementada. **Ambientes:** simulation, qualification. **Permisos:** `company:read`. **Alcance:** Devuelve una versión declarada e inmutable de configuración propia, sin secretos de software. Consultar versión sin PIN ni clave técnica