Trifaco API
Rangos de numeración

Registrar rango o secuencia

POST/v1/numbering-ranges

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

Alcance: Rangos de factura declarados en simulation/qualification y secuencias de notas en qualification. Prefijo 1–4, máximo 999999999; sin sedes/contingencia ni secretos. Resolución/vigencia requerida en habilitación; configuración cifrada por su endpoint.

Registrar rango o secuencia

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.

Prefijo vacío permitido si la secuencia/autorización lo permite; longitud fiscal según perfil. Autorización, vigencia y clave técnica condicionales. Toda secuencia se verifica antes de activar; controles de solapamiento y continuidad son semánticos.

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/numbering-ranges" \  -H "Idempotency-Key: string" \  -H "Content-Type: application/json" \  -d '{    "document_type": "invoice",    "kind": "authorized_invoice",    "prefix": "string",    "range_from": 1,    "range_to": 1,    "next_number": 1  }'
{  "document_type": "invoice",  "kind": "authorized_invoice",  "prefix": "string",  "resolution_number": "string",  "valid_from": "2019-08-24",  "valid_until": "2019-08-24",  "range_from": 1,  "range_to": 1,  "next_number": 1,  "branch_code": "string",  "evidence_id": "5360afe2-6320-4611-b2b1-06edeee7fc1e",  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "status": "pending",  "version": 1,  "technical_key_configured": true}

Listar rangos sin claves técnicas GET

**Estado:** parcial. **Ambientes:** simulation, qualification. **Permisos:** `numbering:read`. **Alcance:** Lista los rangos propios y si tienen clave técnica configurada. El estado publicado distingue únicamente activo o agotado según el siguiente número. Listar rangos sin claves técnicas

Consultar rango GET

**Estado:** implementada. **Ambientes:** simulation, qualification. **Permisos:** `numbering:read`. **Alcance:** Consulta metadatos propios y ETag, sin clave técnica. Consultar rango