Configuracion
Update tax configuration
Updates the user's tax configuration
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
impuesto_principal_defecto?
aplicar_recargo_equivalencia?boolean
Whether the freelancer is under the equivalence surcharge regime
Default
falserecargo_equivalencia_defecto?number
Value in
0 | 0.5 | 1.4 | 5.2aplicar_irpf?boolean
Whether IRPF withholding should be applied
Default
truetipo_irpf_defecto?integer
Value in
0 | 7 | 15 | 19 | 21exento_irpf?boolean
Whether the freelancer is exempt from IRPF withholding
Default
falsemetodo_pago_defecto?string|null
Default payment method for new invoices. If NINGUNO is selected, no payment information will be shown on the invoice.
Value in
"NINGUNO" | "TRANSFERENCIA" | "TARJETA" | "EFECTIVO" | "CHEQUE" | "DOMICILIACION" | "OTRO"plazo_pago_dias?integer|null
Default payment term in days (0-365)
Range
0 <= value <= 365Response Body
application/json
application/json
application/json
application/json
application/json
curl -X PUT "https://app.beel.es/api/v1/configuracion/impuestos" \ -H "Content-Type: application/json" \ -d '{}'{
"success": true,
"data": {
"impuesto_principal_defecto": {
"tipo": "IVA",
"porcentaje": 21,
"clave_regimen": "01"
},
"aplicar_recargo_equivalencia": false,
"recargo_equivalencia_defecto": 5.2,
"aplicar_irpf": true,
"tipo_irpf_defecto": 15,
"exento_irpf": false,
"metodo_pago_defecto": "NINGUNO",
"plazo_pago_dias": 30
},
"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": "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"
}
}