Generar factura rectificativa
Emet una factura rectificativa que corregeix una de ja emesa; retorna 201 amb la nova factura. - Neix emesa; l'original mai es modifica; l'alta a l'AEAT és asíncrona. - 422 series_invoice_kind_mismatch. - payment_terms pren per defecte []; els venciments negatius han de sumar exactament un total_to_pay negatiu.
Certificat de signatura (NO VERI*FACTU). Només en aquest mode, un certificat d'empresa absent o no vàlid es rebutja abans d'emetre la factura: 422 verifactu_not_eligible, error.subcode: signing_certificate_unavailable; no es consumeix res, així que corregeix-lo i repeteix la crida.
La teva API key com a token Bearer: fact_live_… en producció, fact_test_… en sandbox. Consulta la guia d'autenticació.
A: header
Paràmetres de ruta
Identificador públic (UUID v7) de l'empresa. Obtén-lo de GET /v1/me (data.scope[].id).
uuidIdentificador públic (UUID v7) de la factura.
uuidHeaders
Clau opaca generada pel client (fins a 255 caràcters; es recomana UUID v7) que permet reintents segurs: la primera resposta s'emmagatzema i es reprodueix en les repeticions sense tornar a executar la mutació. Reutilitzar una clau amb un cos diferent retorna 422 idempotency_key_reused; els valors dels camps secrets (password, secret…) compten com a part del cos, així que reintentar amb un secret corregit sota la mateixa clau és una petició diferent, mai la repetició de la resposta anterior. Consulta la guia d'idempotència. Obligatòria en aquesta operació: repetir-la produeix un efecte irreversible (un correu enviat, un fitxer generat, una crida a un tercer o un càrrec), per la qual cosa una petició sense aquesta capçalera es rebutja amb 422 idempotency_key_required abans d'executar lògica de negoci.
1 <= length <= 255Fixa la versió de l'API (YYYY-MM-DD, versionat per data estil Stripe) per a aquesta petició; omet-lo per usar la versió fixada de la clau, o l'última si no n'hi ha cap. Versió no suportada → 400 unsupported_api_version; mal formada → 400 parameter_invalid_format. La versió efectiva es reflecteix a la capçalera de resposta Factuarea-Version. Consulta la guia de Versioning.
dateCos de la petició
application/json
Definicions de TypeScript
Usa el tipus request body a TypeScript.
Cos de la resposta
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json