> For the complete documentation index, see [llms.txt](https://wallee.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wallee.gitbook.io/documentation/developer-tools/customization/pingen-printing-service.md).

# Pingen Printing Service

## Introduction

Pingen Print is a **cloud‑based printing and mailing service** integrated with the {inject-brand-name} platform. It allows you to **automate PDF printing and postal dispatch** of invoices, reminders, packing slips, and other documents, either for dunning purposes or order fulfillment. The printing job is triggered via a web request and sent to a supported printing provider; default or custom printer configurations are used per document type or connector.

### Key Capabilities

<table><thead><tr><th width="350.51104736328125">Feature</th><th>Description</th></tr></thead><tbody><tr><td><strong>Service Integration</strong></td><td>Seamlessly integrates with services like <em>pingen.com</em> (Classic) to print and mail documents directly from {inject-brand-name}.</td></tr><tr><td><strong>Connector Assignment</strong></td><td>Assign a specific Pingen printer per Connector or Dunning Flow level. Can trigger printing at invoice or dunning stages. See for more details <a href="/documentation/activate-your-account/reconciliation-accounting/wallee-accounting-capabilities/dunning.md">here</a></td></tr><tr><td><strong>Automatic Triggering</strong></td><td>Auto-triggers print jobs when transactions reach specific states (<code>Completed</code> or <code>Fulfill</code> ) based on connector settings. This could be used to automatically print orders when they are placed in your store to send the invoice etc.</td></tr><tr><td><strong>Monitoring &#x26; Retry Logic</strong></td><td>Print jobs can be inspected, rescheduled, or downloaded; system retries failed jobs until success, but cannot guarantee actual print completion.</td></tr></tbody></table>

***

### Configuration & Activation

#### How to sign up for Pingen

Before using the integration, create a **Pingen.com account** and obtain:

* **Client ID and Client Secret** via *Profile → API Access → Create Developer-App*
* **Organisation ID** via *Organisation Administration*

#### How to add a Pingen Printer

* Navigate to **Space → Connect → Printers**
* Choose **“Pingen”** as the service provider
* Define a friendly name, API credentials, and default printing profile
* Pingen help: [Manage integrations](https://help.pingen.com/en/api-and-integrations/manage-integrations) and [Upload letters via the Pingen app](https://help.pingen.com/en/transfer-letters/upload-letters-via-pingen-app)

#### Set as Default Printer (Optional)

* The first printer you create becomes the **default**—used if no specific printer is assigned.
* Only one printer can be default; missing this configuration will cause all print jobs to fail.\\

***

### Assigning Printers to Connectors & Dunning Flows

#### To print documents at specific workflow stages

* Edit the **Connector configuration** (QR‑Bill, eBill, etc.)
* Navigate to the **"Print"** section

#### To print a dunning reminder

* Assign the same Pingen printer to that dunning level via its configuration screen
* When the system escalates an invoice into that level, the document will be sent using the assigned printer

#### Rescheduling & Retry Logic

* On failure, the system retries automatically
* If all retries fail, the job moves to **Failed**
* You may **reschedule** failed jobs manually via the UI\\

***

### Document Validation & Automatic Fixes

#### Interactive PDFs & Metadata Issues

If your document contains **interactive elements** (e.g. form fields, annotations, multimedia), Pingen assigns a status of **"Action Required"**, and the document will **not be accepted** until the elements are converted into static PDF content. Make sure you position those according to the pingen limits.

* Conversion can be done **manually** via the WebApp
* Or automatically using **Presets** (recommended for bulk uploads)\\