Service Voucher D1216S (PDF)

Beta
View as Markdown
> 🚧 **Coming Soon** β€” This endpoint is not yet available. > RebateRight is completing DVA certification. Availability will be announced when certification is complete. ## 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.
patientobjectRequired
servicingProviderobjectRequired
Provider rendering the services on the voucher.
accountReferenceNumberstringRequired

Account or internal reference for this voucher (e.g. invoice or visit id).

treatmentLocationCodeenumRequired
Where treatment was provided. When **H**, send **facilityProviderNumber**. | Code | Meaning | |------|---------| | H | Hospital | | R | Rooms | | V | Home visit / residential care / community health / hostel |
Allowed values:
serviceslist of objectsRequired
One row per service to include on the voucher.
lspNumberstring or nullOptional

Location Specific Practice Number (diagnostic imaging). Omit or null when not used.

payeeProviderobject or nullOptional

Payee when different from the servicing provider; omit or null if the same.

referralobject or nullOptional

Referral or request details when applicable; omit or null if none.

facilityProviderNumberstring or nullOptional

Required when treatmentLocationCode is H (hospital establishment provider number).

kilometresTravelledstring or nullOptional

Distance in kilometres when a visit charge applies; omit or null if not used.

conditionTreatedstring or nullOptional

Condition treated (e.g. for White Card); omit or null if not applicable.

Response

PDF document β€” treatment service voucher (DVAVoucher.pdf).