beel_get_issuing_readiness
Check if a company (NIF) is ready to issue a standard invoice now, returning a readiness flag and listing any blockers that prevent it.
Instructions
Returns whether a company (NIF) can issue its STANDARD invoice right now in the
environment of the request, and the blockers that stop it otherwise. ready is true
only when blockers is empty. Readiness is a per-NIF property, evaluated independently
for each company of the account.
Issuing any fiscal document requires the company to be activated in the environment of
that document, whether or not it goes to VeriFactu. The VeriFactu capability chain — AEAT
census and signed representation — is additionally demanded only when the company applies
VeriFactu by default, the same derivation invoice creation uses when verifactu_enabled
is omitted; a company with VeriFactu off is ready with a NIF, a default series and an
activation. Issuing an invoice with an explicit verifactu_enabled: true still enforces
the full chain at emission time regardless of this answer, and the separate verifactu
block reports that chain independently of the setting.
This does not evaluate the account's quota or subscription, nor the payload of any particular invoice.
Endpoint: GET /v1/companies/{company_id}/issuing-readiness
⚠️ Fiscal guardrails — read before calling:
Which company an operation acts on, and how that is selected. (resource: beel://guardrails/multi-nif)
For the exhaustive rules and worked examples, call beel_docs_search.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company_id | Yes | NIF (company) whose issuing readiness is evaluated. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A NIF you do not reach answers `403`, and so does a NIF that does not exist. |