List invoice series
Retrieves all invoice series for the user
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
Query Parameters
Filter by active/inactive series
Response Body
application/json
application/json
application/json
curl -X GET "https://app.beel.es/api/v1/configuracion/series"{
"success": true,
"data": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"nombre": "Serie Principal",
"codigo": "FAC",
"descripcion": "Serie para facturas ordinarias",
"formato": "{CODIGO}-{YYYY}-{NUM:4}",
"reseteo_contador": "NUNCA",
"numero_inicial": 1,
"activa": true,
"predeterminada": false,
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "123e4567-e89b-12d3-a456-426614174000"
}
}{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required"
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "123e4567-e89b-12d3-a456-426614174000"
}
}{
"success": false,
"error": {
"code": "INTERNAL_ERROR",
"message": "Internal server error"
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "123e4567-e89b-12d3-a456-426614174000"
}
}Get invoice customization options GET
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.
Mark series as default POST
Marks an invoice series as the user's default. **Business rules:** - Only one series can be default per user - The series must be active (cannot mark an inactive series) - The previous default series is automatically unmarked **Note:** This operation is idempotent - calling it multiple times with the same series has no additional effects.