La personalización se aplica a la plantilla principal

22 de octubre de 2026 (provisional: la fecha final es el día en que se publique esta versión) — En una empresa que ya trabaja con la biblioteca de plantillas PDF, PATCH /v1/companies/{company}/personalization y su herramienta MCP update_account_personalization cambian su plantilla principal en lugar de la configuración PDF anterior. El contrato no cambia: mismo cuerpo, mismos scopes, misma respuesta.

Qué cambia en una empresa con la biblioteca

• Escritura. pdf_template y accent_color se aplican a la plantilla principal de la empresa, lo que publica una revisión nueva de ella. Los documentos ya emitidos conservan el PDF con el que se capturaron. language se sigue guardando en la empresa, como antes.
• Lectura. El bloque personalization del recurso Account devuelve los valores efectivos de la plantilla principal: su diseño como pdf_template y su color de marca como accent_color. Una empresa sin plantilla principal lee classic y null.
• Mismos permisos. Las comprobaciones de plan (derecho de editor para cambiar el color o elegir Corporativa o Premium) y las validaciones 422 del slug y del color #RRGGBB no cambian.
• Empresas aún sin migrar. No cambia nada: siguen escribiendo y leyendo los ajustes anteriores.

No hay nada que adaptar en tu integración: no necesitas enviar campos nuevos ni llamar a otra operación. Si además gestionas la plantilla principal desde la biblioteca, la revisión que publica esta operación aparece en su historial como cualquier otra.

Error nuevo: pdf_main_template_required

Cuando la empresa está en la biblioteca pero no tiene plantilla principal, no hay a qué aplicar el diseño ni el color y la operación responde 409 pdf_main_template_required. No se cambia nada, tampoco el language de la factura. Fija una plantilla principal en la biblioteca de la empresa y repite la misma petición.

Herramientas MCP

update_account_personalization se comporta exactamente como la operación HTTP y devuelve el mismo error, de modo que un asistente no necesita instrucciones nuevas.

La tabla siguiente lista la operación de esta versión.