Configuracion

Get user tax configuration

Retrieves the user's tax configuration, including: - Default tax regime (VAT, IGIC, IPSI, OTHERS) - Default main tax percentage - IRPF and equivalence surcharge configuration

GET
/configuracion/impuestos

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

Response Body

application/json

application/json

application/json

curl -X GET "https://app.beel.es/api/v1/configuracion/impuestos"
{
  "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": "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"
  }
}

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.

Get VeriFactu configuration GET

Retrieves the current VeriFactu configuration