Factuarea APIDevelopers

Crear una revisió de presentació de factura

Afegeix una captura derivada utilitzant la vista prèvia autèntica de presentation_revision del pare exacte, la destinació, la política i l'origen actual.

  • Envia el token d'origen i l'empremta de la vista prèvia; una vista prèvia de lliurament o il·lustrativa no pot autoritzar aquesta acció.
  • L'estat del document existent, la numeració fiscal, les referències, els venciments i els totals romanen intactes.
  • Aquesta acció no renderitza, no publica ni envia cap PDF.
  • L'esborrat de dades personals és terminal.
POST
/companies/{company}/invoices/{invoice}/presentation-revisions

Authorization

AuthorizationBearer <token>

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

company*string

Identificador públic (UUID v7) de l'empresa. Obtén-lo de GET /v1/me (data.scope[].id).

Formatuuid
invoice*string

Identificador públic (UUID v7) de la factura.

Formatuuid

Headers

Idempotency-Key?string

Clau opaca generada pel client (fins a 255 caràcters; es recomana UUID v7) que fa segurs els reintents: la primera resposta es cacheja i es reprodueix a 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.

Longitud1 <= length <= 255
Factuarea-Version?string

Fixa 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.

Formatdate

Cos 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

application/json

application/json