Configuracion

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. This endpoint doesn't require authentication as the data is static and public.

GET
/configuracion/invoice-customization-options
X-API-Key<token>

API Key authentication.

Format: X-API-Key: beel_sk_<key>

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/configuracion/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"
        ],
        "template_html": "string"
      }
    ],
    "suggested_colors": [
      {
        "hex": "#fc481d",
        "name": "Naranja BeeL",
        "category": "DEFAULT"
      }
    ]
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "123e4567-e89b-12d3-a456-426614174000"
  }
}
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "The provided data is not valid",
    "details": {
      "campo": "specific error message"
    }
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "123e4567-e89b-12d3-a456-426614174000"
  }
}
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "The provided data is not valid",
    "details": {
      "campo": "specific error message"
    }
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "123e4567-e89b-12d3-a456-426614174000"
  }
}