Los documentos de control usan la biblioteca de plantillas PDF
El PDF del documento de control de transporte (DeCA) toma su diseño de la biblioteca de plantillas. El default de documentos de control se fija en PATCH /v1/companies/{company}/pdf-templates/defaults y en la tool MCP, y cada versión del DeCA informa del diseño con el que se pintó en versions[].presentation.
19 de octubre de 2026 (provisional: la fecha definitiva es el día en que se publique esta release) — El PDF del documento de control de transporte toma ahora su diseño de la biblioteca de plantillas PDF: diseño base, colores, letra y marca. La estructura del documento sigue siendo la que fija la normativa, así que ninguna plantilla puede mover ni quitar un bloque legal. Todo es aditivo. Con la presentación con revisiones inactiva, el DeCA se pinta exactamente como antes.
El default de «documentos de control»
PATCH /v1/companies/{company}/pdf-templates/defaults y la tool MCP set_pdf_template_defaults aceptan una
entrada nueva en type_defaults:
{
"expected_version": 3,
"type_defaults": [
{ "document_type": "transport-document", "purpose": "complete", "template_id": "0192f6a0-7c1e-7d3a-9f4b-5a2e8c1d3b60" }
]
}- Solo existe
transport-documentconpurpose: "complete". Cualquier otropurposepara ese tipo se rechaza como cualquier otra entrada inválida. - Compatibilidad derivada. Vale cualquier plantilla activa cuya revisión vigente
admita el formato
a4, sea cual sea su familia. Una plantilla que solo admite el formato ticket se rechaza con422 invalid_pdf_template_configurationyparamtype_defaults.N.template_id. type_defaultssigue sustituyendo la lista entera: envía todas las entradas que quieras conservar.GET /v1/companies/{company}/pdf-templates/defaultsyget_pdf_template_defaultsdevuelven la entrada cuando existe.- El impacto en la biblioteca de una plantilla o de una marca
(
GET /v1/companies/{company}/pdf-templates/{template}/impactyGET /v1/companies/{company}/pdf-commercial-identities/{identity}/impact) acepta e informa detransport-document, publicar una revisión comprueba la misma compatibilidad y archivar una plantilla que es el default de documentos de control se trata como los demás defaults.
Qué diseño usa un documento
Para cada versión nueva de un DeCA el diseño se elige en este orden: el default de «documentos de control», después la plantilla principal de la empresa y después el diseño legacy. La elección se captura en la versión al emitirla o modificarla, así que los cambios posteriores de la biblioteca nunca repintan una versión que ya existe. El justificante de emisión usa también el diseño capturado.
versions[].presentation
Cada versión de un documento de transporte lleva presentation, un objeto de solo
lectura sin la política del plan:
| Campo | Significado |
|---|---|
origin | transport_document_default, company_default o legacy. |
template_id, template_revision_id | UUID v7 de la plantilla y de la revisión exacta, o null. |
template_name | Nombre de la plantilla cuando se emitió la versión, o null. |
base_preset | classic, modern, minimal, corporative, premium o null. |
commercial_identity_id, commercial_identity_revision_id | UUID v7 de la marca y de su revisión, o null. |
Las versiones emitidas antes de la biblioteca de plantillas, o mientras la presentación
con revisiones estaba inactiva, informan origin: "legacy" y todos los demás campos a
null. El mismo objeto viaja en GET /v1/companies/{company}/transport-documents/{id}, en el listado, en la
respuesta de cada operación de escritura, en las tools MCP del recurso y en el
data.object de los webhooks transport_document.*, y por tanto en GET /v1/companies/{company}/events,
GET /v1/companies/{company}/events/{event} y en las entregas de webhook (listado y detalle).
Las operaciones de la biblioteca que cita esta página son nuevas en Biblioteca de plantillas PDF y facturas estructuradas. Las tablas de abajo listan las operaciones de los documentos de control, los eventos y las entregas de webhook cuyas respuestas cambian.