---
title: "Document recognition QR codes on customer paperwork"
description: "QR codes are automatically added to uploaded customer paperwork PDFs, enabling automatic matching back to the correct consignment during scanning."
url: https://help.qargo.com/en/articles/567867-document-recognition-qr-codes-on-customer-paperwork
locale: en
updated: 2026-02-20
---

# Document recognition QR codes on customer paperwork

**Screenshots needed:**

1.  A customer paperwork PDF _before_ the QR code is added — showing the original document without any QR marking
2.  The same customer paperwork PDF _after_ upload — showing the QR code added to the top-left corner with the document content slightly resized
3.  The document upload dialog on a consignment, highlighting the _Customer Paperwork_ document type selection
4.  The bulk document scanning flow successfully matching a scanned document back to a consignment using the QR code
5.  A close-up of the QR code on the document, showing its position and size relative to the page content

## Summary {#h_9bbae596a1}

-   **What is this feature?**

    -   Qargo now automatically adds a recognition QR code to customer paperwork (COP) when it is uploaded to a consignment. The QR code is embedded in the top-left corner of each page of the PDF, and the existing document content is resized slightly to make room.
    -   This QR code enables Qargo's document scanning feature to automatically link scanned paperwork back to the correct consignment.

-   **Why was it introduced?**

    -   In pallet network operations, customer paperwork is typically printed, taken to the delivery point, signed by the consignee, and then scanned back into the system. Without a machine-readable identifier, matching the signed paperwork back to the right consignment is a manual and error-prone process — especially when dealing with high volumes.
    -   This feature eliminates that manual step by embedding a QR code at the point of upload, so the signed copy can be automatically recognised when it is scanned back in.

-   **How does it work?**

    -   When a PDF document is uploaded with the document type **_Customer Paperwork_**, the system checks whether a Qargo QR code is already present. If not, it resizes the document content and adds a QR code to the top-left corner of each page.
    -   The modified document replaces the original in the system. When the signed copy is later scanned or uploaded, Qargo reads the QR code and automatically matches it to the correct consignment.

* * *

## Terminology {#h_ccf2c56825}

| **Term** | **Definition** |
| --- | --- |
| Customer Paperwork (COP) | Documents provided by the customer that need to be signed by the consignee upon delivery. Also referred to as Customer Own Paperwork. |
| Unsigned Customer Paperwork | The original customer paperwork before it has been signed by the consignee. This is the version that receives the QR code. |
| Signed Customer Paperwork | The customer paperwork after it has been signed by the consignee and scanned back into the system. A new document type introduced to differentiate it from unsigned paperwork. |
| QR Code | A machine-readable square barcode embedded on the document that encodes a reference to the consignment. Used by Qargo's document scanning feature to automatically match documents. |
| Document Scanning | The process of uploading physical documents (typically scanned copies) into Qargo, where the system attempts to automatically match them to the correct consignment. |
| Consignment | A shipment or delivery job in Qargo to which documents, including customer paperwork, are attached. |
| Pallet Network | A logistics network (e.g., Palletforce, TPN, Palletline) through which palletised goods are distributed between depots. Customer paperwork often flows between requesting and delivery depots within these networks. |

* * *

## How the QR Code Is Added {#h_b359cf5d9b}

### Automatic Embedding on Upload {#h_d858dbb681}

When a PDF is uploaded with the document type **_Customer Paperwork_**, the system performs two checks before adding a QR code:

1.  **File format check** — The QR code is **only added to PDF documents**. Other file types (e.g., images) are uploaded without modification.
2.  **Existing QR code check** — The system scans the document to determine whether a Qargo QR code is already present. If one is found, no additional QR code is added. This prevents duplicate markings on documents that have already been processed.

If both checks pass, the system resizes the document content slightly and adds a QR code to the top-left corner of each page.

### Where the QR Code Is Applied {#h_265de94597}

The QR code is added during the upload process in the following contexts:

-   **Qargo web app** — When uploading customer paperwork on a consignment detail page
-   **Customer portal** — When customer paperwork is uploaded through the customer-facing portal
-   **Pallet network integrations** — When unsigned customer paperwork is received via pallet network APIs (e.g., Palletforce, Palletline, TPN)

_\[Screenshot: Customer paperwork PDF with QR code in the top-left corner\]_

* * *

## Signed vs Unsigned Customer Paperwork {#h_e9cb152aad}

A new document type — **_Signed Customer Paperwork_** — has been introduced to distinguish between the two stages of the customer paperwork lifecycle:

### Unsigned Customer Paperwork {#h_e0fcac6056}

This is the original document uploaded before delivery. It receives the QR code and is the version printed and taken to the consignee for signing. Unsigned paperwork is typically uploaded by the requesting or collection depot.

### Signed Customer Paperwork {#h_d0d2ace524}

This is the version returned after the consignee has signed it. It is uploaded by the delivery depot (or via the driver mobile app or bulk scanning flow). Signed paperwork does **not** receive a QR code, because it should already contain one from the unsigned version.

The system differentiates between signed and unsigned paperwork based on the upload context:

-   For pallet networks that explicitly distinguish between the two types via their APIs (e.g., Palletforce), the classification is based on the API metadata.
-   For networks that do not differentiate (e.g., Pallex), the system infers the type based on the depot role — collection depots upload unsigned paperwork, and delivery depots upload signed paperwork.

* * *

## Using QR Codes with Document Scanning {#h_63f32ef6fa}

### Scanning Signed Paperwork {#h_95a5bdf1ae}

Once signed customer paperwork is scanned or uploaded back into Qargo, the document scanning feature reads the QR code and automatically matches the document to the correct consignment.

This applies to:

-   **Bulk document scanning** — Multiple scanned documents can be processed at once, with each one matched automatically via its QR code
-   **Single document upload** — When a signed document is uploaded to a specific consignment, the QR code confirms the match

_\[Screenshot: Bulk document scanning flow showing automatic QR code matching\]_

### What Happens If There Is No QR Code {#h_9fc375ed2e}

If the signed paperwork does not contain a QR code (for example, if the original was not a PDF), the standard manual matching process applies. The document must be linked to the correct consignment manually during the scanning flow.

* * *

## Limitations {#h_cda478b9d6}

-   The QR code is only added to **PDF documents**. Other file formats (images, Word documents, etc.) are uploaded without a QR code.
-   The QR code is added to **unsigned customer paperwork only**. Signed customer paperwork is not modified.
-   For **pallet networks** that do not explicitly differentiate between signed and unsigned paperwork in their API, the system infers the **document type based on the depot role**. In rare cases involving implant consignments, this inference may not be accurate.
-   The document content is resized slightly to make space for the QR code. This may affect the layout of documents with very tight margins.

* * *

## Troubleshooting {#h_7b8d19a40e}

| **Issue** | **Solution** |
| --- | --- |
| The uploaded customer paperwork does not have a QR code | Confirm the file is a PDF. QR codes are only added to PDF documents. Other file types are uploaded without modification. |
| A QR code was added to signed customer paperwork | The document may have been uploaded with the wrong document type. Ensure signed paperwork is uploaded as **_Signed Customer Paperwork_**, not _Customer Paperwork_. |
| The document scanning flow does not match the signed paperwork automatically | The QR code may be damaged, partially obscured, or missing (if the original was not a PDF). In this case, use the manual matching option in the scanning flow. |
| Two QR codes appear on the same document | This should not occur — the system checks for an existing Qargo QR code before adding one. If it does happen, the document may have been processed through an older version. Re-uploading the original document will produce a clean result. |
| Upload is slightly slower than usual | Adding the QR code involves resizing the document and embedding the code, which adds a small amount of processing time (typically 1–4 seconds depending on the number of pages). This is expected behaviour. |
| Customer paperwork from a pallet network integration does not have a QR code | Verify that the integration is configured to process customer paperwork. QR codes are added automatically for supported pallet network integrations including Palletforce, Palletline, TPN, and others. |


## Related articles

- [FAQ -  Hazchem: Delivery Image and COP Visibility](https://help.qargo.com/en/articles/500462-faq-hazchem-delivery-image-and-cop-visibility.md)
- [CONFIGURATION - Signing customer paperwork with the sign-on-glass signature](https://help.qargo.com/en/articles/877455-configuration-signing-customer-paperwork-with-the-sign-on-glass-signature.md)
- [Export customer paperwork from Qargo](https://help.qargo.com/en/articles/140554-export-customer-paperwork-from-qargo.md)
- [PN - Hazchem Overview](https://help.qargo.com/en/articles/609628-pn-hazchem-overview.md)
- [PN - Digital signatures (POD) in UK Pallet Networks.](https://help.qargo.com/en/articles/518421-pn-digital-signatures-pod-in-uk-pallet-networks.md)
