Skip to navigation
RebateRight APIDVA

Service Voucher D1216S (PDF)

How do I produce the treatment service voucher for a DVA claim?

This endpoint produces it as a PDF, for the patient to sign and keep a copy.

Treatment service voucher

The treatment service voucher records the visit and the services. Services Australia requires it for DVA claims. Treatment Service Voucher sets out when it applies and what the patient does with it.

This endpoint produces the voucher only. Claims are lodged through the DVA claim endpoints, and the manual claim cover sheet used when posting some paper claims is a separate document.

Request body

Send a single JSON object at the root, without the claim wrapper the claim endpoints use. A root-level property that the schema below does not list is 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.

Location on the voucher

The location ID printed on the voucher is the Minor ID you send in the x-minor-id header, the same header the other Medicare and DVA endpoints use.

Response

On success, the response body is application/pdf. The download is offered as DVAVoucher.pdf.

Errors

A validation failure returns 400, and the body is a plain-text message that describes the problem.

Technical references. The PDF follows the approved D1216S treatment service voucher layout. Its wording and rules follow the current Services Australia specification.

Authentication

x-api-keystring
API Key authentication via header
x-minor-idstring

Your Minor ID is 3 uppercase letters followed by 5 digits, such as MDE00000. Send the Minor ID exactly as issued. A malformed value returns 400 with the text The Minor ID is not valid. on every endpoint.

Headers

x-minor-idstringRequired

The Minor ID of the clinic you act for. See Keys, Minor ID and environments.

Request

This endpoint expects an object.
patientobjectRequired
servicingProviderobjectRequired
Provider rendering the services on the voucher.
accountReferenceNumberstringRequired
Account or internal reference for this voucher, such as an invoice or visit ID.
treatmentLocationCodeenumRequired

Where treatment was provided. When it is H, also send facilityProviderNumber.

CodeMeaning
HHospital
RRooms
VHome visit (residential care, community health centre or hostel)
Allowed values:
serviceslist of objectsRequired
One row per service to include on the voucher.
lspNumberstring or nullOptional

Location Specific Practice Number (LSPN), for diagnostic imaging. Omit it or send null when it does not apply.

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

The hospital establishment provider number. Required when treatmentLocationCode is H.

kilometresTravelledstring or nullOptional

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

conditionTreatedstring or nullOptional

Condition treated, for example for a White Card holder. Omit it or send null when it does not apply.

Response

The treatment service voucher as a PDF (DVAVoucher.pdf).