E-Invoicing

Submit invoice to FACe B2G portal

Submit a signed Facturae XML to Spain's FACe B2G portal (face.gob.es).

Pipeline: load invoice → generate Facturae XML → sign with XAdES-EPES → submit to FACe. Result is persisted to invoices/{id}/face/submission subdoc.

Idempotent: if the invoice was already accepted (registered), returns the prior result with idempotent: true — does not resubmit.

Trust Area: COMPLIANCE — Requires owner role or API key with einvoice:* scope. Requires a PKCS#12 certificate for sandbox/production modes.

post/v1/invoices/{invoiceId}/face/submit

Request

  • Base URL: https://api.frihet.io
  • URL: https://api.frihet.io/v1/invoices/{invoiceId}/face/submit
  • Auth: API key in header X-API-Key

Path parameters

invoiceIdstring required

Invoice unique identifier

Request body

mode'mock' | 'sandbox' | 'production'

FACe submission mode. Defaults to ES_FACE_MODE env var (default mock).

correostring email

Recipient notification email (required by FACe protocol). Defaults to fiscal billing email.

Response

Invoice submitted to FACe

Example response

{
  "data": {
    "status": "submitted",
    "numeroRegistro": "REG/2026/000042",
    "codigo": "0",
    "descripcion": "Registrada"
  }
}

Changes

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