Productos
Create new product/service
Creates a new product or service in the catalog
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
Header Parameters
X-Idempotency-Key?string
Idempotency key to prevent duplicates
Format
uuidcodigo?string|null
Unique alphanumeric product code (optional)
Match
^[a-zA-Z0-9_-]*$Length
length <= 50nombrestring
Product/service name
Length
length <= 255descripcion?string
Detailed description (optional)
categoria?string
Product/service category:
- PRODUCTO - Physical, tangible products
- SERVICIO - General services
- CONSULTORIA - Consulting and advisory services
- SOFTWARE - Development, licenses, SaaS
- FORMACION - Courses, workshops, training
- OTROS - Other unclassified types
Value in
"PRODUCTO" | "SERVICIO" | "CONSULTORIA" | "SOFTWARE" | "FORMACION" | "OTROS"precio_por_defecto?number
Suggested default price (optional)
Format
decimalMultiple Of
0.0001Range
0 <= valueunidad?string
Unit of measure (optional)
Length
length <= 50impuesto_principal?
Complete tax information with cross-validations:
- IVA: only percentages 0, 4, 10, 21
- IGIC: only percentages 0, 3, 5, 7, 9.5, 15, 20
- IPSI: only percentages 0.5, 1, 2, 4, 8, 10
- OTROS: any percentage between 0 and 100
recargo_equivalencia?number
Equivalence surcharge percentage (optional)
Format
decimalMultiple Of
0.01Range
0 <= value <= 100irpf?number
IRPF withholding percentage (optional)
Format
decimalMultiple Of
0.01Range
0 <= value <= 100Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://app.beel.es/api/v1/productos" \ -H "Content-Type: application/json" \ -d '{ "nombre": "Consultoría técnica" }'{
"success": true,
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"codigo": "SERV-001",
"nombre": "Consultoría técnica",
"descripcion": "Servicios de consultoría técnica especializada en desarrollo web",
"categoria": "CONSULTORIA",
"precio_por_defecto": 85.5,
"unidad": "horas",
"impuesto_principal": {
"tipo": "IVA",
"porcentaje": 21,
"clave_regimen": "01"
},
"recargo_equivalencia": 5.2,
"irpf": 15,
"activo": true,
"created_at": "2025-01-18T10:30:00Z",
"updated_at": "2025-01-18T15:45:30Z"
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "123e4567-e89b-12d3-a456-426614174000"
}
}{
"success": false,
"error": {
"code": "BAD_REQUEST",
"message": "Invalid request"
},
"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": "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": "UNPROCESSABLE_ENTITY",
"message": "Data cannot be processed",
"details": {
"field": "Specific error description"
}
},
"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"
}
}