Get invoice customization options
Retrieves available option catalogs to customize invoices:
Template types:
- MODERN_TABLE: Structured table design, ideal for standard products/services
- PROFESSIONAL_SERVICE: Text-based design, ideal for notaries/consultancies
Suggested color palette:
- BeeL default colors (orange, blue)
- Professional palette (dark grays)
- Creative palette (violet, pink, amber, emerald green)
- Classic palette (blue, red, green, purple)
Usage: User can choose a template and accent color to customize their invoices. These values are saved in their profile and automatically applied when generating new invoice PDFs.
Template and color names are returned translated to the user's invoice language preference.
API Key authentication.
Format: Authorization: Bearer beel_sk_<key>
Scopes: API Keys use the same scopes as OAuth2 tokens. Each key is created with
specific scopes that limit which endpoints it can access. The required scope for each
endpoint is documented in the operation's security section under OAuth2.
Obtaining Keys: API Keys are managed from the BeeL dashboard
Security: API Keys are secret credentials. Do not share them or store them in source code
In: header
Response Body
application/json
application/json
application/json
curl -X GET "https://app.beel.es/api/v1/configuration/invoice-customization-options"{
"success": true,
"data": {
"template_types": [
{
"code": "MODERN_TABLE",
"name": "Modern Table",
"description": "Design with structured table, ideal for standard products and services",
"preview_url": "/assets/previews/modern-table.png",
"features": [
"Structured table with columns",
"Quantity, unit price and totals",
"Clean and minimal design"
]
}
],
"suggested_colors": [
{
"hex": "#fc481d",
"name": "BeeL Orange",
"category": "DEFAULT"
}
]
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required"
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}{
"success": false,
"error": {
"code": "INTERNAL_ERROR",
"message": "Internal server error"
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}Update VeriFactu configuration PUT
Updates the user's VeriFactu configuration. **Business rules:** - If `enabled` is false, `apply_by_default` must also be false - If `apply_by_default` is true, `enabled` must be true
Update user preferred language PUT
Updates the authenticated user's preferred language. This language is used for: - UI translations - Template names and colors in invoice customization - Emails sent to the user **Supported languages:** - `es` - Spanish (default) - `en` - English - `ca` - Catalan