Factuarea APIDevelopers
Support
Open app

Unsend an invoice

Clear the delivery marker (sent_at) of a sent invoice while keeping its sent status.

  • The correlative number and VeriFactu record stay intact — the invoice is not reverted to draft and remains immutable per AEAT.
  • Use it to undo an accidental mark-as-sent.
  • Idempotent: a no-op when sent_at is already null.
  • It does not touch stock: undoing the delivery marker does NOT return any goods to the warehouse, because the movement was booked when the invoice was issued and not when it was marked as sent.
  • To undo the sale itself — and with it its stock — void the invoice or issue a corrective one.
POST
/invoices/{invoice}/unsend

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

invoice*string

Headers

Idempotency-Key?string

Client-generated opaque key (up to 255 characters; UUID v7 recommended) that makes retries safe: the first response is cached and replayed for repeats without re-executing the mutation. Reusing a key with a different body returns 409 idempotency_key_reused. See the Idempotency guide.

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

Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.

Formatdate
X-Active-Profile?string

Operate on behalf of a child company (gestoría master key): pass its public id (UUID v7) and the request runs against that child's data without changing the key's scope, tier or environment (omit to use the key's own company). Invalid UUID → 400 parameter_invalid_uuid; unknown or non-owned id → 404 profile_not_found. See the Acting on behalf guide.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

Previous/v1/invoices/{invoice}/unschedule
POST

Unschedule an invoice

Cancel a scheduled issuance. The invoice returns to draft, scheduled_for and scheduled_action are set back to null, and it becomes editable and deletable again as any other draft. Unscheduling leaves no fiscal trace, because nothing fiscal had happened yet: no correlative number of the series was consumed (the invoice still carries its BORRADOR placeholder), nothing was registered with VeriFactu and no email was sent. This is not an annulment and it does not appear in any AEAT record. Window of use. It only applies while the invoice is scheduled. A draft that was never scheduled returns…

Next/v1/invoices/{invoice}/void
POST

Void an invoice

Withdraw an issued invoice. The invoice moves to annulled, voided_at starts reporting when that happened and the status is terminal: voiding is irreversible and there is no way back to sent or draft. Void or correct? Void when the whole document should never have existed and has not been paid — the invoice is withdrawn as a whole and no amending document is produced. Issue a corrective (POST /v1/invoices/{id}/corrective) when the invoice was already paid, or when only part of it is wrong (amount, recipient, partial return): a paid invoice can never be voided, and voiding never fixes a…