---
title: "Void Document"
method: POST
path: "/billing/documents/{number}/void"
---

# Void Document

`POST /billing/documents/{number}/void`

## Request

- Base URL: `https://api-docs.session-exchange.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.session-exchange.com/billing/documents/{number}/void`
- Auth: none declared

Void an ISSUED journal document (global admin). Event-sourced (`billing.document.voided`): the
document and its number stay in the register and the GoBD export, annotated with the void record —
nothing is deleted or renumbered. Deliberately narrow: only a document of a synthetic QA buyer
(`reason_code: qa_test_document`, e.g. the historic INV-000001 / CN-000001, O-5) — a real sale is
corrected by a credit note, never voided. Idempotent: a second void of the same number is a no-op.
Body: {reason_code: "qa_test_document", reason: "<free text for the record>", dry_run?}.

## Path parameters

- `number` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/session-exchange/apis/a4sx.md) · [All operations](https://skmtc.dev/session-exchange/apis/a4sx/llms.txt) · [OpenAPI document](https://skmtc.dev/session-exchange/apis/a4sx/revisions/abaefc33dfc7?raw)