CompanyTaxConfiguration

Get the tax configuration of a company

Returns the tax configuration of a company: its default main tax (IVA, IGIC, IPSI or OTHER) with the default percentage and regime key, the default exemption reason, its IRPF and equivalence surcharge settings, and the default payment method and payment term.

The catalogue of tax types this configuration draws from is not company data and lives outside this resource.

get/v1/companies/{company_id}/tax-configuration

Request

  • Base URL: https://app.beel.es/api
  • URL: https://app.beel.es/api/v1/companies/{company_id}/tax-configuration
  • Auth: HTTP bearer

Response

Configuration retrieved successfully

successboolean required

Example response

{
  "success": true,
  "data": {
    "default_main_tax": {
      "type": "IVA",
      "percentage": 21,
      "regime_key": "01"
    },
    "default_exemption_reason": "EXENTA_ART_20",
    "default_equivalence_surcharge": 5.2,
    "default_irpf_rate": 15,
    "default_payment_method": "BANK_TRANSFER",
    "withholding_options": {
      "allowed_irpf_rates": [
        0,
        19,
        24
      ]
    }
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.