Las plantillas de documentos de control tienen su propio tipo

19 de octubre de 2026 (provisional: la fecha definitiva es el día en que se publique esta release) — Cada plantilla PDF tiene ahora un tipo: commercial para facturas, presupuestos, facturas proforma y albaranes, o transport-document para el documento de control de transporte (DeCA). El tipo se fija al crear la plantilla y nunca cambia. Todo es aditivo: las plantillas que ya tienes informan commercial.

document_kind en la plantilla y en la revisión

TenantPdfTemplate y PdfTemplateRevision llevan document_kind, con los valores commercial y transport-document. Aparece en cada respuesta que devuelve una plantilla o una revisión, en las operaciones de la biblioteca y en las tools MCP del recurso.

Una plantilla del tipo transport-document acepta solo branding, typography y colors en configuration, y ningún campo supported_*. Cualquier otra clave se rechaza con 422 invalid_pdf_template_configuration y el param infractor.

Crear, duplicar y convertir

POST /v1/companies/{company}/pdf-templates y la tool MCP create_pdf_template aceptan un document_kind opcional en el cuerpo:

{
  "name": "Documento de control",
  "document_kind": "transport-document"
}

• Si se omite, es commercial. Un valor desconocido devuelve 422 invalid_pdf_template_configuration con param document_kind.
• Crear una plantilla transport-document sin el módulo de documentos de transporte en el plan devuelve 403 feature_not_available_in_plan.

POST /v1/companies/{company}/pdf-templates/{template}/duplicate y duplicate_pdf_template aceptan el mismo campo:

• Duplicar una plantilla comercial con document_kind: "transport-document" la convierte: la copia es una plantilla de documento de control nueva que empieza en la versión 1 y conserva solo el diseño, la letra (acotada a 8–11 pt), los colores y la marca del origen y descarta su contenido, tablas, textos, página y campos propios. Duplicar una plantilla de control con document_kind: "commercial" devuelve 422 invalid_pdf_template_configuration con param document_kind, igual que un valor desconocido.
• Si se omite, la copia conserva el tipo del origen.
• También devuelve 403 feature_not_available_in_plan cuando el plan no tiene el módulo de documentos de transporte.

POST /v1/companies/{company}/pdf-templates/{template}/revisions y publish_pdf_template_revision rechazan document_kind: el tipo de una plantilla nunca cambia, así que enviarlo devuelve 422 invalid_pdf_template_configuration con param document_kind.

Filtra el listado

GET /v1/companies/{company}/pdf-templates y list_pdf_templates aceptan el parámetro de query document_kind. Con commercial o transport-document el listado contiene solo ese tipo. Si se omite, lista todos los tipos, como antes. Cualquier otro valor devuelve 422 invalid_pdf_template_configuration con param document_kind.

El default de «documentos de control» acepta solo plantillas de control

En PATCH /v1/companies/{company}/pdf-templates/defaults y set_pdf_template_defaults, la entrada transport-document de type_defaults admite ahora solo plantillas activas del tipo transport-document en A4. Una plantilla del tipo commercial se rechaza con 422 invalid_pdf_template_configuration y param type_defaults.N.template_id. Esto sustituye a la regla anterior, que aceptaba cualquier plantilla cuya revisión actual admitiera el formato a4, ver Los documentos de control usan la biblioteca de plantillas PDF.

Tools MCP

Las tablas siguientes listan las operaciones de esta release.