Capacidades PDF en la cuenta
El recurso Account y el endpoint de plantillas exponen un bloque de capacidades de solo lectura: qué permite el plan en la marca de los documentos, qué plantillas pueden fijarse y qué plan desbloquea el editor. Las actualizaciones de personalización fuera del plan devuelven ya 403.
GET /v1/account y GET /v1/account/personalization/templates incluyen ya
pdf_capabilities, un bloque de solo lectura calculado a partir del plan de la
cuenta. Permite a una integración activar o desactivar los controles de marca
antes de llamar a PATCH /v1/account/personalization.
| Campo | Significado |
|---|---|
can_upload_logo | La cuenta puede subir un logotipo. can_upload_brand_image lo replica. |
can_customize | El editor PDF avanzado está disponible: color de acento, plantillas avanzadas y opciones de maquetación. |
requires_attribution | Los documentos generados conservan la atribución de Factuarea. true siempre que can_customize sea false. |
available_templates | Slugs que la cuenta puede fijar: las cinco con el editor; si no, classic, modern y minimal. |
upgrade_plan | Plan que desbloquea el editor para una cuenta emprendedor (empresario), o null. |
PATCH /v1/account/personalization aplica la misma regla: un accent_color o una
plantilla fuera de available_templates en una cuenta sin el editor devuelve
403 con code: feature_not_available_in_plan y no aplica ningún campo. Los
valores fuera del catálogo siguen devolviendo 422 con los valores aceptados.
Lee Personalización de la cuenta.
Endpoints actualizados3
| Endpoint | Descripción |
|---|---|
GET/v1/account | Obtener los detalles de la cuenta |
GET/v1/account/personalization/templates | Lista las plantillas de personalización disponibles |
PATCH/v1/account/personalization | Actualiza la personalización de la cuenta |