Service Voucher D1216S (PDF)
Service Voucher D1216S (PDF)
## Treatment service voucher
Generates a **printable treatment service voucher** for the veteran to keep — a PDF that records the visit and the
services. Use it when your workflow needs a paper or saved copy for the patient's own records.
This endpoint **does not** lodge a claim and **does not** produce the separate **manual claim cover sheet** used
when posting some paper claims.
## Request body
Send a **single JSON object** at the root (no `claim` wrapper). Field names match the schema below. Unknown root-level
property names are rejected.
Optional blocks (`payeeProvider`, `referral`) may be omitted or set to JSON `null`. When `referral` is an object,
`issueDate` and `provider` (with `providerNumber` and `providerName`) are required.
**`treatmentLocationCode`** must be **`H`** (Hospital), **`R`** (Rooms), or **`V`** (home visit / residential care /
community health / hostel). When it is **`H`**, **`facilityProviderNumber`** is required.
**`chargeAmountCents`** is a non-negative whole number as a string (e.g. `10000` for $100.00).
## Location on the voucher
The **location ID** printed on the voucher is taken from the **`x-minor-id`** request header (the same header as
other RebateRight Medicare and DVA endpoints), not from the JSON body.
## Response
On success, the response body is **`application/pdf`**. The download is offered as **`DVAVoucher.pdf`**.
## Errors
Validation failures return **HTTP 400** with a **plain-text** message describing the problem (not a JSON error
envelope).
**Technical references:** The PDF follows the approved **D1216S** treatment service voucher layout.
Authoritative wording and rules are according to the current specification from Services Australia.
Authentication
x-api-keystring
API Key authentication via header
x-minor-idstring
API Key authentication via header
Request
This endpoint expects an object.
patient
servicingProvider
Provider rendering the services on the voucher.
accountReferenceNumber
Account or internal reference for this voucher (e.g. invoice or visit id).
treatmentLocationCode
Where treatment was provided. When **H**, send **facilityProviderNumber**.
| Code | Meaning |
|------|---------|
| H | Hospital |
| R | Rooms |
| V | Home visit / residential care / community health / hostel |
Allowed values:
services
One row per service to include on the voucher.
lspNumber
Location Specific Practice Number (diagnostic imaging). Omit or null when not used.
payeeProvider
Payee when different from the servicing provider; omit or null if the same.
referral
Referral or request details when applicable; omit or null if none.
facilityProviderNumber
Required when treatmentLocationCode is H (hospital establishment provider number).
kilometresTravelled
Distance in kilometres when a visit charge applies; omit or null if not used.
conditionTreated
Condition treated (e.g. for White Card); omit or null if not applicable.
Response
PDF document — treatment service voucher (DVAVoucher.pdf).