La personalització s'aplica a la plantilla principal

22 d'octubre de 2026 (provisional: la data final és el dia en què es publiqui aquesta versió) — En una empresa que ja treballa amb la biblioteca de plantilles PDF, PATCH /v1/companies/{company}/personalization i la seva eina MCP update_account_personalization canvien la seva plantilla principal en lloc de la configuració PDF anterior. El contracte no canvia: mateix cos, mateixos scopes, mateixa resposta.

Què canvia en una empresa amb la biblioteca

• Escriptura. pdf_template i accent_color s'apliquen a la plantilla principal de l'empresa, cosa que publica una revisió nova d'aquesta. Els documents ja emesos conserven el PDF amb què es van capturar. language continua desant-se a l'empresa, com abans.
• Lectura. El bloc personalization del recurs Account retorna els valors efectius de la plantilla principal: el seu disseny com a pdf_template i el seu color de marca com a accent_color. Una empresa sense plantilla principal llegeix classic i null.
• Mateixos permisos. Les comprovacions de pla (dret d'editor per canviar el color o triar Corporativa o Premium) i les validacions 422 del slug i del color #RRGGBB no canvien.
• Empreses encara sense migrar. No canvia res: continuen escrivint i llegint els ajustos anteriors.

No hi ha res a adaptar a la teva integració: no necessites enviar camps nous ni cridar una altra operació. Si a més gestiones la plantilla principal des de la biblioteca, la revisió que publica aquesta operació apareix al seu historial com qualsevol altra.

Error nou: pdf_main_template_required

Quan l'empresa és a la biblioteca però no té plantilla principal, no hi ha on aplicar el disseny ni el color i l'operació respon 409 pdf_main_template_required. No es canvia res, tampoc el language de la factura. Fixa una plantilla principal a la biblioteca de l'empresa i repeteix la mateixa petició.

Eines MCP

update_account_personalization es comporta exactament com l'operació HTTP i retorna el mateix error, de manera que un assistent no necessita instruccions noves.

La taula següent llista l'operació d'aquesta versió.