Clientes
Update client
Updates an existing client
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
Path Parameters
cliente_idstring
Client ID
Format
uuidnombre_fiscal?string
Customer legal name
Length
1 <= length <= 120nombre_comercial?string|null
Customer trade name (optional)
Length
length <= 120direccion?
telefono?string
email?string|null
Email address
Format
emailLength
0 <= length <= 255emails_facturacion?|null
Additional emails for invoice delivery (optional)
persona_contacto?string|null
Contact person name (optional)
Length
length <= 200notas?string|null
Additional notes about the customer (optional)
forma_pago_preferida?
descuento_general?number|null
General discount percentage (optional)
Format
decimalRange
0 <= value <= 100activo?boolean
Whether the customer is active or inactive
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PUT "https://app.beel.es/api/v1/clientes/550e8400-e29b-41d4-a716-446655440000" \ -H "Content-Type: application/json" \ -d '{}'{
"success": true,
"data": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"nombre_fiscal": "Empresa Cliente SL",
"nombre_comercial": "EmpresaCliente",
"nif": "12345678A",
"direccion": {
"calle": "Calle Mayor, 123",
"numero": "123",
"piso": "2º A",
"puerta": "A",
"codigo_postal": "28001",
"poblacion": "Madrid",
"provincia": "Madrid",
"pais": "España",
"codigo_pais": "ES"
},
"telefono": "+34 600 123 456",
"email": "user@example.com",
"emails_facturacion": [
"usuario@ejemplo.com"
],
"persona_contacto": "María García",
"notas": "string",
"forma_pago_preferida": {
"metodo": "NINGUNO",
"iban": "ES1234567890123456789012",
"swift": "ABCDESMMXXX",
"plazo_dias": 30
},
"descuento_general": 0,
"activo": true,
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"id_otro": {
"tipo": "02",
"numero": "string",
"codigo_pais": "st"
}
},
"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": "NOT_FOUND",
"message": "Resource not found"
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "123e4567-e89b-12d3-a456-426614174000"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Validation error",
"details": {
"field_name": "Field is 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"
}
}