Bilingual PDF and tenant branding · How-to guide

Understand issue-time Bilty PDF snapshots

Understand why issued documents prefer saved party and shipment snapshots so later CRM master-data edits do not silently rewrite historical facts. The guide follows the Help Centre standard: exact route, prerequisites, ordered steps, verification and operational boundaries.

Audience: Administrators and authorised Bilty operations staffPermission: Relevant Bilty Management capabilityModule v1.0.0
Jump to steps
Where to goBilty Management → Bilties → Open → PDF
Before you startRequired access: Relevant Bilty Management capability. Work on the correct tenant and record. Use least privilege and review any dependency or protected workflow warning before continuing.

What you’ll accomplish

Understand why issued documents prefer saved party and shipment snapshots so later CRM master-data edits do not silently rewrite historical facts. Bilty Management keeps drafts, issued records, public capability links, finance, integration events and audit evidence as connected but separately verifiable records.

How the workflow fits together

Generate professional English/Urdu PDFs with tenant identity, configurable typography and controlled commercial evidence. Use the module's current status, permission checks, warnings and linked records to decide the next supported action. Where a downstream invoice, WhatsApp queue item, webhook, PDF, POD record or audit event applies, verify it separately.

Follow these steps

  1. Go to Bilty Management → Bilties → Open → PDF and open the relevant current record or configuration view.
  2. Review the displayed state and compare it with the explanation in this guide.
  3. Compare the live values with the workflow described in this guide: Understand why issued documents prefer saved party and shipment snapshots so later CRM master-data edits do not silently rewrite historical facts.
  4. Follow any linked record, status, public evidence, invoice, queue or audit entry rather than inferring that a downstream action happened.
  5. Use the related guides below for the operational action that changes the record.

Fields and decisions to review

LanguagesEnglish is page 1 and Urdu page 2 when bilingual output is enabled.
Tenant identityThe PDF uses the active tenant/company branding and configured contact details.
TypographyFont scale is configurable from 95% to 125%; supplied default is 112%.
Historical factsIssue-time snapshots prevent later master-data edits silently changing issued facts.

Record, audit and evidence checks

Reopen the relevant Bilty record or register and confirm its identifier, current status, related parties, timestamps and connected evidence. Check the audit/compliance, payment, public-link, report, API, webhook or WhatsApp evidence that applies to this workflow rather than relying only on a success alert.

How to confirm it worked

Return to Bilty Management → Bilties → Open → PDF or the resulting register and verify that the stored state matches the intended action. For any downstream automation, confirm the downstream record or queue/log entry as a separate completion check.

Technical basis for this guidance

This guide was checked against libraries/pdf/Bilty_document_pdf.php; views/themes/perfex/views/bilty_document_pdf.php; helpers/bilty_helper.php; views/admin/settings.php. It documents only behaviour exposed or enforced by the supplied module; internal secrets, raw signature payloads and unsupported future workflow assumptions are intentionally excluded.

Controls, checks and common mistakes

  • Work only on the intended tenant and Bilty record.
  • Do not bypass a missing permission, validation blocker or protected status by changing unrelated settings.
  • Verify the stored record, downstream integration state and audit evidence after any material action.
Data and workflow safetyConfirm the exact Bilty, authorised audience and final stored status before issuing, publishing a link, recording payment, changing shipment state or sharing a document.