Configuration

The Pingen Post interface is where you connect your Pingen account, set your letter defaults, decide how invoices are delivered, and track everything you send. This page covers the layout of the interface and the Settings tab; the operational tabs are documented on their own pages.

Opening the configuration interface

Once Pingen Post is installed and licensed (see Installation), open it from the admin Tools menu — click Tools in the main navigation and select Pingen.

The Pingen Post interface at a glance

The interface is organised into tabs across the top:

Tab	What it does	Documented in
Overview	Landing page — license status, environment, module version, and a summary of what Pingen Post does.	(this page)
Settings	License key, Pingen API credentials, letter defaults, and delivery behaviour.	(this page)
Integrations	Shows which BlueRabbIT add-ons (BestPDF, Billing Booster) are detected and what they enable.	Integrations
Invoices	Send invoices as physical mail and see which ones have already been sent.	Sending Invoices & Quotes
Quotes	Send quotes as physical mail and track their status.	Sending Invoices & Quotes
Mailroom	Track every letter Pingen Post has printed and posted; upload a PDF by hand; estimate a mailing's cost.	Mailroom
Logs	A searchable, filterable view of Pingen Post's activity log — used when something goes wrong.	Troubleshooting → Reading the logs
Help	This documentation, embedded inside the admin area.	—

Overview tab

The Overview tab is the landing page. It surfaces, at a glance:

• System information — module version and license status.
• Environment — whether you are pointed at Staging (letters validated but never dispatched) or Production (letters printed and posted for real).
• What Pingen does — a short recap of automatic sending, worldwide delivery, and full tracking.

Staging vs production

While the environment reads Staging, letters are validated against Pingen but never physically sent and never charged. Switch to Production (on Settings → Account) only when you're ready to post real mail.

Settings

The Settings tab holds all module configuration, split across sub-tabs down the side.

General

• License — paste your license key here and click Save settings. The Overview tab reflects the resulting status. Force refresh re-checks the license against our server immediately, which is what to reach for after a renewal.
• Logging — Log retention (days) controls how long activity-log entries are kept before the daily cleanup task removes them. Default 90; set to 0 to keep logs forever.

Where PDFs go while they're sent

There is nothing to configure: the plugin writes each document to the system temporary directory for the moment it takes to hand it to Pingen, then removes it.

Account

The Account sub-tab holds your Pingen API credentials.

• Environment — choose Staging or Production. The plugin uses the credentials for whichever environment is selected.
• Production credentials — Production Client ID, Client Secret, and Organisation ID.
• Staging credentials — Staging Client ID, Client Secret, and Organisation ID.

To obtain these values, follow Pingen Account Configuration.

Preferences

The Preferences sub-tab sets the letter defaults applied to every mailing unless overridden at send time.

Default	Options	Notes
Speed	Economy / Priority	Priority is faster and more expensive; tracking availability depends on the destination country.
Colour	Colour / Grayscale	Grayscale prints are cheaper; colour looks nicer.
Print Mode	Simplex / Duplex	Single- or double-sided printing.
Address Position	Left / Right	Which side of the page carries the recipient address for the window envelope.

Delivery

The Delivery sub-tab controls how invoices are turned into physical mail automatically.

• Paper Delivery
  • Send Paper-delivery invoices via Pingen — when enabled, the paper-delivery cron task picks up invoices whose Blesta delivery method is Paper and mails them physically.
  • Send when balance is zero — also mail invoices with a zero (or credit) balance.
• Delivery Fee
  • Charge a delivery fee — add a postal-handling fee as a line item on paper-delivered invoices.
  • Fee product — the product whose multi-currency pricing supplies the fee (the price in the invoice's currency is used). Don't have a suitable product? Click Generate to create a ready-made one, then set its price on its edit page.

See Sending Invoices & Quotes for how the Paper delivery method and this cron sweep work together.

Restrictions

The Restrictions sub-tab narrows the paper-delivery sweep down to invoices paid — or payable — through particular gateways.

• Payment Gateways — pick the gateways whose invoices may be posted. Leave the selection empty to allow all of them.

Blesta invoices carry no payment gateway of their own, so Pingen Post works out the gateways associated with each invoice: the gateways of transactions already applied to it, the merchant gateway that would charge the client's stored payment account in the invoice's currency, and failing both, the company's default merchant gateway for that currency. An invoice that matches none of the selected gateways is skipped and left in Blesta's pending-paper queue, so you can still print or send it by hand.

Manual sends are never restricted

This filter applies to the automatic sweep only. A Send you click on the Invoices or Quotes tab always goes through.

Nonmerchant gateways

PayPal and other nonmerchant gateways are only ever matched through transactions already applied to the invoice — Blesta does not associate them with a client in advance. A selection consisting only of nonmerchant gateways therefore excludes unpaid invoices that have no transaction history yet.

Notifications

• Email staff when a Pingen send fails — emails your Blesta staff when a letter could not be sent. Failures from the paper-delivery sweep are summarised in a single email per run, so a bad afternoon can't flood your inbox; a failed manual send is reported on the spot. Successful sends are not emailed — the Mailroom, the log and the balance widget already cover the happy path.

Advanced

Backup & Restore

Saves Pingen Post's settings to a file, and restores them from one — to move them to another installation, or to keep a copy before you change things. Both act straight away rather than through Save settings.

• Export settings — Download saves a JSON file with the settings, stamped with the Pingen Post version and the platform it came from. The license key and the Pingen API credentials are left out unless you tick Include license key and API credentials; a file that holds them should be stored like a password, and not attached to a support ticket.
• Import settings — Choose file… reads an exported file first and shows where it came from and when it was made, with a warning if it is from another platform or another Pingen Post version. Nothing changes until you click Import: the file's settings then replace the current ones, and settings the file doesn't contain are left as they are. If the file carries the license key and API credentials, Also restore the license key and API credentials decides whether they replace this installation's. Settings this installation doesn't use are skipped, and the confirmation lists them.

The record of sent letters is not part of the file. An import can't be undone, so export the current settings first if you might want them back.

Danger Zone

• Remove all data when the plugin is uninstalled — off by default: uninstalling Pingen Post keeps its tables, and reinstalling it picks up where you left off. Switch it on, and click Save settings, before uninstalling if you want every Pingen Post table dropped with it. See Uninstall.
• Reset Pingen data — Remove all data… drops every Pingen Post table and recreates them empty, while the plugin stays installed: the API credentials (staging and production) and the license key, all settings and restrictions, the record of every sent invoice and quote, and the activity log. Letters already handed to Pingen are not affected. Type DELETE to confirm. There is no undo.

Scheduled tasks

Installing the plugin registers two Blesta cron tasks (Settings → Automation → Tasks):

Task	Schedule	Purpose
Pingen Paper Delivery	every 5 minutes	Sweeps invoices set to Paper delivery and submits each to Pingen for mailing.
Pingen Log Cleanup	daily (≈ 03:28)	Prunes activity-log entries older than the configured retention window.

Both are enabled by default. Blesta's own system cron must be configured and running on the server for them to fire.

The balance widget

Pingen Post adds a Pingen Balance widget to the staff dashboard, showing what is left in your Pingen account and linking straight into the module — so a mailing budget running out is something you notice before letters start failing.

Next steps

With your account connected and defaults set, see Sending Invoices & Quotes to mail your first document, or the Quick start for the fastest path from zero to a posted letter.