Spanish-English glossary of fiscal and business terms used in the BeeL. API.
The BeeL. API serves businesses in Spain. Since Spanish tax and invoicing terminology appears throughout the API, this glossary maps each term to its English equivalent and the relevant API fields.
Spanish English API Field / Context IVA (Impuesto sobre el Valor Añadido) VAT (Value Added Tax) TaxType: IVA, total_vatIGIC (Impuesto General Indirecto Canario) Canary Islands General Indirect Tax TaxType: IGICIPSI (Impuesto sobre la Producción, Servicios e Importación) Production, Services & Import Tax (Ceuta & Melilla) TaxType: IPSIIRPF (Impuesto sobre la Renta de las Personas Físicas) Personal Income Tax Withholding default_irpf_rate, total_irpfRecargo de equivalencia Equivalence surcharge default_equivalence_surcharge, total_equivalence_surchargeInversión del sujeto pasivo Reverse charge exemption_reason from ISP_ART_84_2_A to ISP_ART_84_2_FBase imponible Taxable base taxable_baseSuplido Disbursement: a payment on behalf of the client (art. 78.Tres.3 LIVA) line_type: SUPLIDO, total_disbursements, total_to_payRetención Withholding total_irpf, irpf_rateTipo impositivo Tax rate percentageCuota tributaria Tax amount amount in breakdownsExento Exempt irpf_exempt, 0% ratesRégimen fiscal Tax regime TaxRegime, regime_keyDesglose Breakdown vat_breakdown, irpf_breakdown, surcharge_breakdown
Spanish English API Field / Context Factura Invoice InvoiceFactura ordinaria Standard invoice type: STANDARDFactura rectificativa Corrective invoice type: CORRECTIVEFactura simplificada Simplified invoice type: SIMPLIFIEDProforma / Presupuesto Proforma (formal quote, no fiscal validity) type: PROFORMASerie de facturación Invoice series seriesNúmero de factura Invoice number invoice_number (assigned on issue — see Series and numbering )Emisor Issuer issuerReceptor / Destinatario Recipient recipientLínea de factura Invoice line item lines[]Forma de pago Payment method payment_methodFecha de emisión Issue date issue_date (read-only, set to the day the invoice is issued)Fecha de operación Operation date operation_dateFecha de vencimiento Due date due_dateBorrador Draft status: DRAFTEmitida Issued status: ISSUEDEnviada Sent status: SENTPagada Paid status: PAIDAnulada Voided / Cancelled status: VOIDEDRectificada Corrected status: RECTIFIEDProgramada Scheduled status: SCHEDULEDProforma activa Active proforma status: ACTIVEProforma caducada Expired proforma status: EXPIRED (derived from valid_until, never stored)Proforma convertida Converted proforma status: CONVERTED (terminal — the proforma survives, linked to the invoice)Factura duplicada Duplicate invoice POST …/invoices/derivations with mode: DUPLICATEFactura recurrente Recurring invoice Scheduled invoices with repeat
Which status can move to which, and how, is in Invoice lifecycle — with what each status allows and the error you get outside it.
Spanish English API Value Transferencia bancaria Bank transfer BANK_TRANSFERTarjeta Card CARDEfectivo Cash CASHCheque Check CHECKDomiciliación bancaria Direct debit DIRECT_DEBITBizum Bizum BIZUMOtro Other OTHERSin forma de pago None NONE — no payment information is shown on the invoice
When creating a corrective invoice, you must specify a reason code in rectification_code (the free-text explanation goes in reason):
Code Spanish English R1Error fundado en derecho y Art. 80 Uno, Dos y Seis LIVA Legal error and Art. 80 One, Two and Six LIVA R2Artículo 80 Tres LIVA (Concurso de acreedores) Article 80 Three LIVA (Bankruptcy proceedings) R3Artículo 80 Cuatro LIVA (Créditos incobrables) Article 80 Four LIVA (Uncollectable debts) R4Resto de causas Other causes R5Facturas simplificadas (Art. 80 Uno y Dos LIVA) Simplified invoices only
Type Spanish English PARTIALRectificación por diferencias Partial correction (a delta) TOTALRectificación por sustitución Total correction (replaces the original)
What each code and type is for, and what it does to the original invoice: Corrective invoices .
Spanish English Notes NIF (Número de Identificación Fiscal) Tax Identification Number Umbrella term for all Spanish tax IDs DNI (Documento Nacional de Identidad) National ID (individuals) Format: 8 digits + check letter (e.g., 12345678Z) NIE (Número de Identidad de Extranjero) Foreigner ID Number Format: X/Y/Z + 7 digits + letter (e.g., X1234567A) CIF (Código de Identificación Fiscal) Company Tax ID Legacy term, now part of NIF
A customer without a Spanish NIF is identified with alternative_id (NIF_IVA, PASSPORT, COUNTRY_ID, RESIDENCE_CERTIFICATE, OTHER_DOCUMENT or NOT_REGISTERED). Which type each country allows, and the errors for a wrong combination, are in International customers .
Spanish English API Field / Context Cliente Customer CustomerPersona física Individual entity_type: INDIVIDUAL (on a company/NIF — customers carry no type field)Persona jurídica Legal entity entity_type: LEGAL_ENTITY (on a company/NIF)Autónomo Self-employed person An individual with an economic activity; entity_type: INDIVIDUAL Gestoría Accounting firm A provisioner in Managed accounts Razón social Legal name legal_nameNombre comercial Trade name trade_nameDirección Address addressCódigo postal Postal code postal_codeProvincia Province provinceDesactivado Deactivated active: false — the customer stays retrievable and is listed with ?active=false. Not the same as DELETE, which removes it from the API and releases its NIF
Spanish English API Field / Context Producto Product category: PRODUCTServicio Service category: SERVICE (also CONSULTING, SOFTWARE, TRAINING, OTHER)Precio unitario Unit price default_priceUnidad Unit unit
Spanish English API Field / Context Serie Series seriesCódigo de serie Series code codeSerie por defecto Default series default_series, PUT …/series/{series_id}/defaultReinicio de numeración Counter reset counter_resetReinicio anual Annual reset counter_reset: ANNUALReinicio mensual Monthly reset counter_reset: MONTHLYSin reinicio No reset counter_reset: NEVER
Spanish English Notes AEAT (Agencia Estatal de Administración Tributaria) Spanish Tax Agency Government entity VeriFactu (Sistema de Facturación Verificable) Verifiable Invoice System AEAT's chain-integrity system Registro de facturación Billing record VeriFactu submission Alta Registration record New invoice submission Anulación Cancellation record Invoice cancellation Subsanación Kept in Spanish: replacing a registration record with a corrected one See Cancel vs amend Declaración responsable Kept in Spanish: the producer's signed statement that its billing system complies See Compliance and responsibilities Huella Hash / Fingerprint SHA-256, chain integrity Código QR QR Code qr_url, qr_base64Representación Representation Digital signature delegation document Censo de obligados tributarios Tax registry AEAT database for NIF validation
The values of verifactu.submission_status — what each one means and when you must act — are in Submission states .
Status Spanish Description VALIDVálido Successfully validated against the AEAT tax registry INVALIDInválido Invalid tax ID, or it does not exist in the AEAT tax registry PENDINGPendiente Not yet validated, or the AEAT service is temporarily unavailable ERRORError Technical error after exhausting retries
The finer-grained outcome of a census lookup travels in census_status (IDENTIFIED, IDENTIFIED_DEREGISTERED, IDENTIFIED_REVOKED, NOT_IDENTIFIED, NOT_IDENTIFIED_SIMILAR, UNKNOWN).
The regime_key values (clave de régimen ) with their Spanish names and when each applies are in Regime keys .
Term Description Subscription A registered URL that receives webhook events Event A notification triggered by an action (e.g., invoice.issued) Delivery A single HTTP attempt to deliver an event to your URL Secret HMAC key used to sign and verify webhook payloads Signature BeeL-Signature header with t=timestamp,v1=hmac formatRetry Automatic re-delivery after a failed attempt — see Retries Deduplication Using BeeL-Event-Id to prevent processing the same event twice
