CompanyFiscalSummary

Get the fiscal summary of a company

Returns the VAT and IRPF summary of the invoices issued under this company over the requested period, together with the annual IRPF projection and its progressive bracket breakdown. start_date and end_date go together: send both, or neither. Omitting both defaults to the current month; sending only one answers 400, because a period you did not ask for is worse than an error. The range may not exceed 365 days, and every fault names itself in details.reason.

get/v1/companies/{company_id}/fiscal-summary

Request

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

Query parameters

start_datestring date

Period start date (inclusive), as YYYY-MM-DD. Goes together with end_date: supply both or neither. Omitting both defaults to the current month; supplying only one is rejected with 400 (PERIOD_INCOMPLETE).

end_datestring date

Period end date (inclusive), as YYYY-MM-DD. Goes together with start_date: supply both or neither. Omitting both defaults to the current month; supplying only one is rejected with 400 (PERIOD_INCOMPLETE).

Response

The fiscal summary of the company for the requested period.

successboolean required

Example response

{
  "success": true,
  "data": {
    "queried_period": {
      "start_date": "2025-01-01",
      "end_date": "2025-03-31",
      "days_included": 90
    },
    "total_taxable_base": 15000,
    "total_vat": 3150,
    "tax_breakdown": [
      {
        "tax_type": "IVA",
        "percentage": 21,
        "taxable_base": 8000,
        "tax_amount": 1680
      },
      {
        "tax_type": "IGIC",
        "percentage": 7,
        "taxable_base": 2000,
        "tax_amount": 140
      }
    ],
    "vat_breakdown_by_rate": {
      "21.000": 3150
    },
    "surcharge_breakdown": [
      {
        "type": 5.2,
        "base": 1000,
        "amount": 52
      }
    ],
    "total_equivalence_surcharge": 52,
    "total_irpf_withheld": 750,
    "period_base": 15000,
    "projected_annual_base": 60000,
    "estimated_annual_irpf": 14582.5,
    "pending_annual_irpf": 11546.17,
    "bracket_details": [
      {
        "base_to": 12450,
        "rate_percentage": 19,
        "applicable_base": 12450,
        "amount": 2365.5
      }
    ],
    "invoices": [
      {
        "invoice_number": "F2025/001",
        "issue_date": "2025-01-15",
        "customer_name": "Empresa SL",
        "taxable_base": 1000,
        "total_vat": 210,
        "total_irpf": 150,
        "invoice_total": 1060
      }
    ],
    "total_invoices": 12
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

Changes

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