Factuarea APIDevelopers
Support
Open app

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 422, and so does an invoice the sweep has already issued: from that instant on it is sent, it owns a definitive number and — where VeriFactu applies — an AEAT record, so the way back is no longer unschedule but void/annul to withdraw it (only while it is unpaid) or corrective to amend it.

  • In practice the race is real: an invoice whose scheduled_for has just elapsed may already have been issued when your call lands.

  • If you only want to move the date, use PATCH /v1/invoices/{id}/reschedule instead — it avoids the round trip through draft and the window in which the document is editable.

POST
/invoices/{invoice}/unschedule

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/substitute-simplified
POST

Substitute simplified invoices with full invoice

Groups N simplified invoices (F2) under a single substitutive full invoice (F3) with complete recipient data. Marks the originals as substituted.

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

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.