Els documents de control utilitzen la biblioteca de plantilles PDF
El PDF del document de control de transport (DeCA) pren el disseny de la biblioteca de plantilles. El valor per defecte de documents de control es fixa a PATCH /v1/companies/{company}/pdf-templates/defaults i a la tool MCP, i cada versió del DeCA informa del disseny amb què es va pintar a versions[].presentation.
19 d'octubre de 2026 (provisional: la data definitiva és el dia que es publiqui aquesta release) — El PDF del document de control de transport pren ara el disseny de la biblioteca de plantilles PDF: disseny base, colors, lletra i marca. L'estructura del document continua sent la que fixa la normativa, de manera que cap plantilla pot moure ni treure un bloc legal. Tot és additiu. Amb la presentació amb revisions inactiva, el DeCA es pinta exactament com abans.
El valor per defecte de «documents de control»
PATCH /v1/companies/{company}/pdf-templates/defaults i la tool MCP set_pdf_template_defaults accepten una
entrada nova a type_defaults:
{
"expected_version": 3,
"type_defaults": [
{ "document_type": "transport-document", "purpose": "complete", "template_id": "0192f6a0-7c1e-7d3a-9f4b-5a2e8c1d3b60" }
]
}- Només existeix
transport-documentambpurpose: "complete". Qualsevol altrepurposeper a aquest tipus es rebutja com qualsevol altra entrada invàlida. - Compatibilitat derivada. Val qualsevol plantilla activa la revisió vigent de la
qual admeti el format
a4, sigui quina sigui la seva família. Una plantilla que només admet el format tiquet es rebutja amb422 invalid_pdf_template_configurationiparamtype_defaults.N.template_id. type_defaultscontinua substituint tota la llista: envia totes les entrades que vulguis conservar.GET /v1/companies/{company}/pdf-templates/defaultsiget_pdf_template_defaultsretornen l'entrada quan existeix.- L'impacte a la biblioteca d'una plantilla o d'una marca
(
GET /v1/companies/{company}/pdf-templates/{template}/impactiGET /v1/companies/{company}/pdf-commercial-identities/{identity}/impact) accepta i informa detransport-document, publicar una revisió comprova la mateixa compatibilitat i arxivar una plantilla que és el valor per defecte de documents de control es tracta com els altres valors per defecte.
Quin disseny utilitza un document
Per a cada versió nova d'un DeCA el disseny s'escull en aquest ordre: el valor per defecte de «documents de control», després la plantilla principal de l'empresa i després el disseny legacy. L'elecció es captura a la versió en emetre-la o modificar-la, de manera que els canvis posteriors de la biblioteca mai repinten una versió que ja existeix. El justificant d'emissió també utilitza el disseny capturat.
versions[].presentation
Cada versió d'un document de transport porta presentation, un objecte de només
lectura sense la política del pla:
| Camp | Significat |
|---|---|
origin | transport_document_default, company_default o legacy. |
template_id, template_revision_id | UUID v7 de la plantilla i de la revisió exacta, o null. |
template_name | Nom de la plantilla quan es va emetre la versió, o null. |
base_preset | classic, modern, minimal, corporative, premium o null. |
commercial_identity_id, commercial_identity_revision_id | UUID v7 de la marca i de la seva revisió, o null. |
Les versions emeses abans de la biblioteca de plantilles, o mentre la presentació amb
revisions estava inactiva, informen origin: "legacy" i tots els altres camps a null.
El mateix objecte viatja a GET /v1/companies/{company}/transport-documents/{id}, al llistat, a la resposta
de cada operació d'escriptura, a les tools MCP del recurs i al data.object dels
webhooks transport_document.*, i per tant a GET /v1/companies/{company}/events, GET /v1/companies/{company}/events/{event}
i a les entregues de webhook (llistat i detall).
Les operacions de la biblioteca que cita aquesta pàgina són noves a Biblioteca de plantilles PDF i factures estructurades. Les taules de sota llisten les operacions dels documents de control, els esdeveniments i les entregues de webhook les respostes dels quals canvien.