> For the complete documentation index, see [llms.txt](https://docs.digit.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digit.org/health/v1.5/hcm-product-suite/health-products/digit-hcm-app/user-manual/common-functions/voucher-based-registration-and-distribution.md).

# Voucher-Based Registration and Distribution

An illustrative guide to using the Multi-Round Campaign Module

With the help of Voucher-Based Registration and Distribution, the registrar can use a QR code-based voucher provided by the program to link beneficiaries to the QR code  voucher at the time of registration. This will enable distributors to search for beneficiaries at the time of delivery by scanning the QR code vouchers linked to a specific beneficiary.

## Key Features

* Allows a registrar to link a QR code voucher provided by the program to the beneficiary by scanning the QR code at the time of registration.
* Allows a distributor to search for a beneficiary in the system by scanning the QR code voucher shown by the beneficiary when the Distributor has to deliver the drug.

## User Roles

<table><thead><tr><th width="140">User Role</th><th width="166">Scope of Action</th><th>Role Description</th></tr></thead><tbody><tr><td>Registrar</td><td>Scan and link voucher to the households during registration</td><td>The user goes from house-to-house and links the beneficiaries to the QR code voucher at the time of registration. </td></tr><tr><td>Distributor</td><td>Scan and retrieve household details for distribution</td><td>The user goes from house-to-house, and searches for beneficiaries by scanning the QR code voucher.</td></tr></tbody></table>

## Steps to Register Using Voucher Based Registration and Distribution

#### User Role: Registrar

**Step 1**

Once the all the mandatory details for an individual are added on the Individual Details screen, you can link the QR code voucher by clicking on the "Link Voucher To Individual" button.

<figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/og5m8rrUvoE9eZ7iGDnm/image.png" alt="" width="185"><figcaption></figcaption></figure>

**Step 2**

The QR code scanner is launched and you can scan the unique QR code linked to the beneficiary. The "1 Resource Scanned" message will appear below the QR scanning panel.&#x20;

<figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/0S4gArFYI74o7VxEP7MK/image.png" alt="" width="185"><figcaption></figcaption></figure>

If the QR code voucher scanning shows an error, you can link the voucher manually by clicking on the "Enter Beneficiary Code". The following screen appears, which lets you add the voucher code manually. Next, click on 'Submit' to link the code successfully to the beneficiary.

<figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/VStBW5SiG1J2jkIPHh8i/image.png" alt="" width="185"><figcaption></figcaption></figure>

**Step 3**

The voucher will appear on the Individual Details page. If click on the 'Edit' button next to the voucher code, you redo step 2 and link the correct QR code voucher to the beneficiary. Click on 'Submit' after adding the correct voucher code for the beneficiary to link the Voucher to the Beneficiary in the database.

<figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/w0LDF2nklDsGtaSH9v6i/image.png" alt="" width="185"><figcaption></figcaption></figure>

**Step 4**

You will be directed to the "Data Record Successfully" screen.

<figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/nMaT5KnVaxGXAdrqpC51/image.png" alt="" width="185"><figcaption></figcaption></figure>

#### **User Role: Distributor**

After the registrations have been done and the respective QR code vouchers are linked to all beneficiaries, the distributors at the time of delivering the drug can search for beneficiaries using the QR code voucher associated to that beneficiary.

**Step 1**

Come to the "Search Individual" screen, and click on the "Scan QR Code" button.

<figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/IW2yQxB2dBesigx6b7Zf/image.png" alt="" width="185"><figcaption></figcaption></figure>

**Step 2**

The QR code scanner will open up. Scan the voucher shown by the beneficiary and click on submit.

<figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/OVmNkPIqUMDuVb5zRblL/image.png" alt="" width="185"><figcaption><p>The QR Code associated to the Beneficiary was scanned and then Submit was pressed. </p></figcaption></figure>

**Step 3**

If there is a user linked to the voucher scanned by the distributor, the details of the beneficiaries will appear on the "Individual Details" page. If not, a message will be shown saying "Match Not Found".&#x20;

<figure><img src="https://content.gitbook.com/content/GYQEda2SOh4goA6Ee2d2/blobs/a77NwuW2dEyQIrIJmE1o/image.png" alt="" width="185"><figcaption></figcaption></figure>

**Step 4**

If the beneficiary is found after scanning, you can open the record of the beneficiary and add the drug administration as per the regular flow.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.digit.org/health/v1.5/hcm-product-suite/health-products/digit-hcm-app/user-manual/common-functions/voucher-based-registration-and-distribution.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
