Configuracion

Update VeriFactu configuration

Updates the user's VeriFactu configuration. **Business rules:** - If `habilitado` is false, `aplicar_por_defecto` must also be false - If `aplicar_por_defecto` is true, `habilitado` must be true

PUT
/configuracion/verifactu

Authorization

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

Request Body

habilitadoboolean

Whether VeriFactu is enabled for this user. When enabled, the user can submit invoices to AEAT. Freelancers who don't need to submit invoices to AEAT can leave it disabled.

Defaultfalse
aplicar_por_defectoboolean

Whether VeriFactu should be automatically applied to new invoices. Requires 'habilitado' to be true.

Defaultfalse
nif_estado?string|null

VeriFactu registration status (can be null if VeriFactu was never enabled):

  • PENDIENTE: Initial registration in progress
  • ACTIVADO: NIF validated and user created in the corresponding environment
  • DESACTIVADO: Deactivated (data retained for 30 days)
  • ERROR: Some step of the process failed
Value in"PENDIENTE" | "ACTIVADO" | "DESACTIVADO" | "ERROR"
nif_registrado_en?string|null

Successful activation date in VeriFactu production

Formatdate-time

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://app.beel.es/api/v1/configuracion/verifactu" \  -H "Content-Type: application/json" \  -d '{    "habilitado": false,    "aplicar_por_defecto": false  }'
{
  "success": true,
  "data": {
    "habilitado": false,
    "aplicar_por_defecto": false,
    "nif_estado": "PENDIENTE",
    "nif_registrado_en": "2019-08-24T14:15:22Z"
  },
  "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"
  }
}

Update tax configuration PUT

Updates the user's tax configuration

Update user preferred language PUT

Updates the authenticated user's preferred language. This language is used for: - UI translations - Template names and colors in invoice customization - Emails sent to the user **Supported languages:** - `es` - Spanish (default) - `en` - English - `ca` - Catalan