Les plantilles de documents de control tenen el seu propi tipus

19 d'octubre de 2026 (provisional: la data definitiva és el dia que es publiqui aquesta release) — Cada plantilla PDF té ara un tipus: commercial per a factures, pressupostos, factures proforma i albarans, o transport-document per al document de control de transport (DeCA). El tipus es fixa en crear la plantilla i mai canvia. Tot és additiu: les plantilles que ja tens informen commercial.

document_kind a la plantilla i a la revisió

TenantPdfTemplate i PdfTemplateRevision porten document_kind, amb els valors commercial i transport-document. Apareix a cada resposta que retorna una plantilla o una revisió, a les operacions de la biblioteca i a les tools MCP del recurs.

Una plantilla del tipus transport-document accepta només branding, typography i colors a configuration, i cap camp supported_*. Qualsevol altra clau es rebutja amb 422 invalid_pdf_template_configuration i el param infractor.

Crear, duplicar i convertir

POST /v1/companies/{company}/pdf-templates i la tool MCP create_pdf_template accepten un document_kind opcional al cos:

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

• Si s'omet, és commercial. Un valor desconegut retorna 422 invalid_pdf_template_configuration amb param document_kind.
• Crear una plantilla transport-document sense el mòdul de documents de transport al pla retorna 403 feature_not_available_in_plan.

POST /v1/companies/{company}/pdf-templates/{template}/duplicate i duplicate_pdf_template accepten el mateix camp:

• Duplicar una plantilla comercial amb document_kind: "transport-document" la converteix: la còpia és una plantilla de document de control nova que comença a la versió 1 i conserva només el disseny, la lletra (acotada a 8–11 pt), els colors i la marca de l'origen i descarta el seu contingut, taules, textos, pàgina i camps propis. Duplicar una plantilla de control amb document_kind: "commercial" retorna 422 invalid_pdf_template_configuration amb param document_kind, igual que un valor desconegut.
• Si s'omet, la còpia conserva el tipus de l'origen.
• També retorna 403 feature_not_available_in_plan quan el pla no té el mòdul de documents de transport.

POST /v1/companies/{company}/pdf-templates/{template}/revisions i publish_pdf_template_revision rebutgen document_kind: el tipus d'una plantilla mai canvia, així que enviar-lo retorna 422 invalid_pdf_template_configuration amb param document_kind.

Filtra el llistat

GET /v1/companies/{company}/pdf-templates i list_pdf_templates accepten el paràmetre de query document_kind. Amb commercial o transport-document el llistat conté només aquest tipus. Si s'omet, llista tots els tipus, com abans. Qualsevol altre valor retorna 422 invalid_pdf_template_configuration amb param document_kind.

El valor per defecte de «documents de control» accepta només plantilles de control

A PATCH /v1/companies/{company}/pdf-templates/defaults i set_pdf_template_defaults, l'entrada transport-document de type_defaults admet ara només plantilles actives del tipus transport-document en A4. Una plantilla del tipus commercial es rebutja amb 422 invalid_pdf_template_configuration i param type_defaults.N.template_id. Això substitueix la regla anterior, que acceptava qualsevol plantilla la revisió actual de la qual admetés el format a4, vegeu Els documents de control utilitzen la biblioteca de plantilles PDF.

Tools MCP

Les taules següents llisten les operacions d'aquesta release.