For clean Markdown of any page, append .md to the page URL. For a complete documentation index, see https://docs.rebateright.com.au/api-reference/dva/llms.txt. For full documentation content, see https://docs.rebateright.com.au/api-reference/dva/llms-full.txt. # Service Voucher D1216S (PDF) POST https://api.rebateright.com.au/DVAVoucher Content-Type: application/json > 🚧 **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. Reference: https://docs.rebateright.com.au/api-reference/dva/service-voucher-d-1216-s-pdf ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: collection version: 1.0.0 paths: /DVAVoucher: post: operationId: service-voucher-d-1216-s-pdf summary: Service Voucher D1216S (PDF) description: > > 🚧 **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. tags: - subpackage_dva parameters: - name: x-api-key in: header required: true schema: type: string responses: '200': description: PDF document — treatment service voucher (`DVAVoucher.pdf`). content: application/octet-stream: schema: type: string format: binary requestBody: content: application/json: schema: type: object properties: lspNumber: type: - string - 'null' description: >- Location Specific Practice Number (diagnostic imaging). Omit or `null` when not used. patient: $ref: >- #/components/schemas/DvaVoucherPostRequestBodyContentApplicationJsonSchemaPatient servicingProvider: $ref: >- #/components/schemas/DvaVoucherPostRequestBodyContentApplicationJsonSchemaServicingProvider description: Provider rendering the services on the voucher. payeeProvider: oneOf: - $ref: >- #/components/schemas/DvaVoucherPostRequestBodyContentApplicationJsonSchemaPayeeProvider - type: 'null' description: >- Payee when different from the servicing provider; omit or `null` if the same. referral: oneOf: - $ref: >- #/components/schemas/DvaVoucherPostRequestBodyContentApplicationJsonSchemaReferral - type: 'null' description: >- Referral or request details when applicable; omit or `null` if none. accountReferenceNumber: type: string description: >- Account or internal reference for this voucher (e.g. invoice or visit id). treatmentLocationCode: $ref: >- #/components/schemas/DvaVoucherPostRequestBodyContentApplicationJsonSchemaTreatmentLocationCode description: > Where treatment was provided. When **H**, send **facilityProviderNumber**. | Code | Meaning | |------|---------| | H | Hospital | | R | Rooms | | V | Home visit / residential care / community health / hostel | facilityProviderNumber: type: - string - 'null' description: >- Required when `treatmentLocationCode` is `H` (hospital establishment provider number). kilometresTravelled: type: - string - 'null' description: >- Distance in kilometres when a visit charge applies; omit or `null` if not used. conditionTreated: type: - string - 'null' description: >- Condition treated (e.g. for White Card); omit or `null` if not applicable. services: type: array items: $ref: >- #/components/schemas/DvaVoucherPostRequestBodyContentApplicationJsonSchemaServicesItems description: One row per service to include on the voucher. required: - patient - servicingProvider - accountReferenceNumber - treatmentLocationCode - services servers: - url: https://api.rebateright.com.au - url: https://test-api.rebateright.com.au components: schemas: DvaVoucherPostRequestBodyContentApplicationJsonSchemaPatient: type: object properties: dvaFileNumber: type: string description: DVA file number (e.g. `NX901667`). givenName: type: string description: Patient's given name. familyName: type: string description: Patient's family name. dateOfBirth: type: string format: date description: ISO date `YYYY-MM-DD`. telephone: type: string description: Patient contact telephone number, digits only. residentialAddress: type: string description: Full residential address as a single line. required: - dvaFileNumber - givenName - familyName - dateOfBirth - telephone - residentialAddress title: DvaVoucherPostRequestBodyContentApplicationJsonSchemaPatient DvaVoucherPostRequestBodyContentApplicationJsonSchemaServicingProvider: type: object properties: providerNumber: type: string description: Medicare-issued provider number of the servicing provider. providerName: type: string description: Servicing provider's name as it should appear on the voucher. required: - providerNumber - providerName description: Provider rendering the services on the voucher. title: DvaVoucherPostRequestBodyContentApplicationJsonSchemaServicingProvider DvaVoucherPostRequestBodyContentApplicationJsonSchemaPayeeProvider: type: object properties: providerNumber: type: string description: Payee provider number. providerName: type: string description: Payee provider's name. required: - providerNumber - providerName description: >- Payee when different from the servicing provider; omit or `null` if the same. title: DvaVoucherPostRequestBodyContentApplicationJsonSchemaPayeeProvider DvaVoucherPostRequestBodyContentApplicationJsonSchemaReferralProvider: type: object properties: providerNumber: type: string description: Referring/requesting provider's Medicare-issued provider number. providerName: type: string description: Referring/requesting provider's name. required: - providerNumber - providerName description: Referring or requesting provider. title: DvaVoucherPostRequestBodyContentApplicationJsonSchemaReferralProvider DvaVoucherPostRequestBodyContentApplicationJsonSchemaReferral: type: object properties: issueDate: type: string format: date description: Date the referral or request was issued. periodOrNotes: type: - string - 'null' description: Referral period or other notes. provider: $ref: >- #/components/schemas/DvaVoucherPostRequestBodyContentApplicationJsonSchemaReferralProvider description: Referring or requesting provider. required: - issueDate - provider description: Referral or request details when applicable; omit or `null` if none. title: DvaVoucherPostRequestBodyContentApplicationJsonSchemaReferral DvaVoucherPostRequestBodyContentApplicationJsonSchemaTreatmentLocationCode: type: string enum: - H - R - V description: > Where treatment was provided. When **H**, send **facilityProviderNumber**. | Code | Meaning | |------|---------| | H | Hospital | | R | Rooms | | V | Home visit / residential care / community health / hostel | title: >- DvaVoucherPostRequestBodyContentApplicationJsonSchemaTreatmentLocationCode DvaVoucherPostRequestBodyContentApplicationJsonSchemaServicesItems: type: object properties: dateOfService: type: string format: date description: Date the service was provided (`YYYY-MM-DD`). itemNumber: type: string description: MBS or DVA item number. chargeAmountCents: type: string description: >- Charge in whole cents as a decimal string (e.g. `10000` for $100.00). associatedText: type: - string - 'null' description: Optional line narrative for the service. required: - dateOfService - itemNumber - chargeAmountCents title: DvaVoucherPostRequestBodyContentApplicationJsonSchemaServicesItems securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key minorId: type: apiKey in: header name: x-minor-id ``` ## SDK Code Examples ```python import requests url = "https://api.rebateright.com.au/DVAVoucher" payload = { "patient": { "dvaFileNumber": "NX901667", "givenName": "JANET", "familyName": "IAN", "dateOfBirth": "1958-09-27", "telephone": "0262626111", "residentialAddress": "63 DANUTA ST, YARRALUMLA ACT 2600" }, "servicingProvider": { "providerNumber": "2447781L", "providerName": "GWENDA HUNTER" }, "accountReferenceNumber": "0001", "treatmentLocationCode": "R", "services": [ { "dateOfService": "2026-04-09", "itemNumber": "23", "chargeAmountCents": "10000" } ], "conditionTreated": "OSTEOARTHRITIS" } headers = { "x-api-key": "", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.rebateright.com.au/DVAVoucher'; const options = { method: 'POST', headers: {'x-api-key': '', 'Content-Type': 'application/json'}, body: '{"patient":{"dvaFileNumber":"NX901667","givenName":"JANET","familyName":"IAN","dateOfBirth":"1958-09-27","telephone":"0262626111","residentialAddress":"63 DANUTA ST, YARRALUMLA ACT 2600"},"servicingProvider":{"providerNumber":"2447781L","providerName":"GWENDA HUNTER"},"accountReferenceNumber":"0001","treatmentLocationCode":"R","services":[{"dateOfService":"2026-04-09","itemNumber":"23","chargeAmountCents":"10000"}],"conditionTreated":"OSTEOARTHRITIS"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.rebateright.com.au/DVAVoucher" payload := strings.NewReader("{\n \"patient\": {\n \"dvaFileNumber\": \"NX901667\",\n \"givenName\": \"JANET\",\n \"familyName\": \"IAN\",\n \"dateOfBirth\": \"1958-09-27\",\n \"telephone\": \"0262626111\",\n \"residentialAddress\": \"63 DANUTA ST, YARRALUMLA ACT 2600\"\n },\n \"servicingProvider\": {\n \"providerNumber\": \"2447781L\",\n \"providerName\": \"GWENDA HUNTER\"\n },\n \"accountReferenceNumber\": \"0001\",\n \"treatmentLocationCode\": \"R\",\n \"services\": [\n {\n \"dateOfService\": \"2026-04-09\",\n \"itemNumber\": \"23\",\n \"chargeAmountCents\": \"10000\"\n }\n ],\n \"conditionTreated\": \"OSTEOARTHRITIS\"\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("x-api-key", "") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.rebateright.com.au/DVAVoucher") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["x-api-key"] = '' request["Content-Type"] = 'application/json' request.body = "{\n \"patient\": {\n \"dvaFileNumber\": \"NX901667\",\n \"givenName\": \"JANET\",\n \"familyName\": \"IAN\",\n \"dateOfBirth\": \"1958-09-27\",\n \"telephone\": \"0262626111\",\n \"residentialAddress\": \"63 DANUTA ST, YARRALUMLA ACT 2600\"\n },\n \"servicingProvider\": {\n \"providerNumber\": \"2447781L\",\n \"providerName\": \"GWENDA HUNTER\"\n },\n \"accountReferenceNumber\": \"0001\",\n \"treatmentLocationCode\": \"R\",\n \"services\": [\n {\n \"dateOfService\": \"2026-04-09\",\n \"itemNumber\": \"23\",\n \"chargeAmountCents\": \"10000\"\n }\n ],\n \"conditionTreated\": \"OSTEOARTHRITIS\"\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.rebateright.com.au/DVAVoucher") .header("x-api-key", "") .header("Content-Type", "application/json") .body("{\n \"patient\": {\n \"dvaFileNumber\": \"NX901667\",\n \"givenName\": \"JANET\",\n \"familyName\": \"IAN\",\n \"dateOfBirth\": \"1958-09-27\",\n \"telephone\": \"0262626111\",\n \"residentialAddress\": \"63 DANUTA ST, YARRALUMLA ACT 2600\"\n },\n \"servicingProvider\": {\n \"providerNumber\": \"2447781L\",\n \"providerName\": \"GWENDA HUNTER\"\n },\n \"accountReferenceNumber\": \"0001\",\n \"treatmentLocationCode\": \"R\",\n \"services\": [\n {\n \"dateOfService\": \"2026-04-09\",\n \"itemNumber\": \"23\",\n \"chargeAmountCents\": \"10000\"\n }\n ],\n \"conditionTreated\": \"OSTEOARTHRITIS\"\n}") .asString(); ``` ```php request('POST', 'https://api.rebateright.com.au/DVAVoucher', [ 'body' => '{ "patient": { "dvaFileNumber": "NX901667", "givenName": "JANET", "familyName": "IAN", "dateOfBirth": "1958-09-27", "telephone": "0262626111", "residentialAddress": "63 DANUTA ST, YARRALUMLA ACT 2600" }, "servicingProvider": { "providerNumber": "2447781L", "providerName": "GWENDA HUNTER" }, "accountReferenceNumber": "0001", "treatmentLocationCode": "R", "services": [ { "dateOfService": "2026-04-09", "itemNumber": "23", "chargeAmountCents": "10000" } ], "conditionTreated": "OSTEOARTHRITIS" }', 'headers' => [ 'Content-Type' => 'application/json', 'x-api-key' => '', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.rebateright.com.au/DVAVoucher"); var request = new RestRequest(Method.POST); request.AddHeader("x-api-key", ""); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"patient\": {\n \"dvaFileNumber\": \"NX901667\",\n \"givenName\": \"JANET\",\n \"familyName\": \"IAN\",\n \"dateOfBirth\": \"1958-09-27\",\n \"telephone\": \"0262626111\",\n \"residentialAddress\": \"63 DANUTA ST, YARRALUMLA ACT 2600\"\n },\n \"servicingProvider\": {\n \"providerNumber\": \"2447781L\",\n \"providerName\": \"GWENDA HUNTER\"\n },\n \"accountReferenceNumber\": \"0001\",\n \"treatmentLocationCode\": \"R\",\n \"services\": [\n {\n \"dateOfService\": \"2026-04-09\",\n \"itemNumber\": \"23\",\n \"chargeAmountCents\": \"10000\"\n }\n ],\n \"conditionTreated\": \"OSTEOARTHRITIS\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "x-api-key": "", "Content-Type": "application/json" ] let parameters = [ "patient": [ "dvaFileNumber": "NX901667", "givenName": "JANET", "familyName": "IAN", "dateOfBirth": "1958-09-27", "telephone": "0262626111", "residentialAddress": "63 DANUTA ST, YARRALUMLA ACT 2600" ], "servicingProvider": [ "providerNumber": "2447781L", "providerName": "GWENDA HUNTER" ], "accountReferenceNumber": "0001", "treatmentLocationCode": "R", "services": [ [ "dateOfService": "2026-04-09", "itemNumber": "23", "chargeAmountCents": "10000" ] ], "conditionTreated": "OSTEOARTHRITIS" ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.rebateright.com.au/DVAVoucher")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```