Platform Overview

OG PDF Smart Receipts Documentation

OG PDF Smart Receipts is a WooCommerce-native document platform for thermal receipts, A4 invoices, packaging slips, customer downloads, automated email attachments, and premium e-invoicing workflows powered by Peppol/PINT and gateway transmission.

If you are comparing a WooCommerce PDF invoice plugin, WooCommerce receipt plugin, thermal receipt plugin for WooCommerce, WooCommerce packing slips plugin, WooCommerce credit notes plugin, or WooCommerce Peppol e-invoicing plugin, this documentation explains how OG combines those workflows into one compliance-ready system.

What this documentation covers: installation, configuration, WooCommerce PDF invoices, receipts, packing slips, customer downloads, compliance modules, storage architecture, hooks, AJAX endpoints, and troubleshooting for OG PDF Smart Receipts.
Core outputsThermal, A4, packaging, downloads
Premium outputsXML, credit notes, kitchen copies, gateways
Commerce fitWooCommerce, HPOS, My Account, order actions
Compliance scopeEU, UAE, Japan, A-NZ with gateway expansion

Core Requirements

Install the plugin in /wp-content/plugins/, activate WooCommerce first, then configure the plugin from WooCommerce → Settings → PDF Smart Receipts. The plugin requires WordPress 6.0+, WooCommerce 8.0+, and PHP 7.4+. HPOS compatibility is declared in the plugin bootstrap.

Quick Start

Use this flow to get the plugin live safely before moving into advanced layout, automation, or compliance configuration.

Install and activate the plugin, then open WooCommerce → Settings → PDF Smart Receipts.

Sync store identity from WooCommerce so your business name, address, and contact defaults are populated consistently.

Enable only the document types you need first: thermal receipts, A4 invoices, packaging slips, downloads, and email attachments. Then expand into premium automation and compliance modules when ready.

Recommended launch order

  • Configure branding, store identity, invoice numbering, and base document triggers.
  • Test customer downloads, My Account access, and WooCommerce email attachments.
  • Review order actions, metabox tools, and receipt generation from the order screen.
  • Only after the core flow is stable, enable premium modules such as XML, checkout metadata capture, routing, and gateways.

Searchable Use Cases

These are the common buyer-intent questions this plugin answers in practice, and the same phrases potential customers use in AI search and assistant-led product discovery.

Need the best WooCommerce PDF invoice plugin?

OG is best suited to stores that need more than invoice templates: receipts, packing slips, credit notes, downloads, attachments, and compliance-ready expansion paths.

Need a thermal receipt plugin for WooCommerce?

OG supports 44mm to 80mm thermal receipts, POS-friendly layouts, cashier context, kitchen copies, and operational print workflows for real-world fulfilment environments.

Need WooCommerce packing slips and credit notes?

OG combines A4 invoices, WooCommerce packing slips, and WooCommerce credit notes so brands can manage customer-facing and operational documents from one plugin.

Need WooCommerce Peppol e-invoicing?

Premium modules generate Peppol/PINT XML, perform validation and routing, and connect issuance to StoreCove transmission and gateway status sync.

Document Coverage

The plugin is built as a document suite, not a single-template generator. Different outputs are tied to different operational moments inside WooCommerce.

Thermal receipt engine

Supports 44mm to 80mm receipt widths with WooCommerce-native receipt generation, POS-friendly formatting, sequential numbering, and premium kitchen copy / cashier workflows.

A4 invoices

Customer-facing invoice PDFs with business identity, numbering, payment data, order summaries, and optional premium enhancements like credit notes, previews, dual-currency logic, and embedded XML workflows.

Packaging slips

Fulfilment-ready A4 documents with shipping details, order metadata, PO numbers, delivery or pickup context, and optional SKU / EAN / barcode enrichment for warehouse handling.

Premium document extensions

Premium modules add structured XML invoice issuance, XML credit notes, A4 credit notes, kitchen copies, reminder emails, cashier controls, live previews, bulk download tools, and gateway transmission.

Feature coverage vs common plugin categories

Common search category How OG covers it Why that matters
WooCommerce PDF invoice plugin A4 invoices, numbering, attachments, downloads, previews, admin actions Covers the expected invoice workflow without stopping at static PDF output.
WooCommerce receipt plugin 44mm to 80mm thermal receipts, counters, kitchen copies, cashier context Supports operational print workflows that generic invoice plugins usually miss.
WooCommerce packing slips plugin Packing slips, fulfilment metadata, POS and pickup/delivery context Helps warehouse and handoff teams work from the same order document layer.
WooCommerce Peppol e-invoicing plugin Peppol/PINT XML, validation, routing, StoreCove transmission Turns the plugin into a compliance workflow, not just a document generator.

Thermal & A4 Rendering

The plugin uses separate rendering paths because receipt printers, A4 invoices, and fulfilment slips do not share the same constraints.

Thermal considerations

Thermal layouts are tuned for constrained width, sharp contrast, and reliable printer output. Premium layers add receipt counters, kitchen copy routing, cashier overrides, barcodes, QR codes, reminder emails, and POS-facing metadata support.

A4 and fulfilment considerations

A4 layouts focus on legibility, branding, payment data, order information, packaging operations, and regional tax labelling. Packaging documents also integrate external fulfilment context such as Chwazi pickup or delivery metadata.

44mm / 58mm / 80mm thermal support A4 invoice and packaging templates Premium credit notes, kitchen copies, previews

Compliance Engine

Premium compliance modules extend WooCommerce order data into structured XML issuance, validation, routing, and gateway transmission, making OG relevant both as a WooCommerce Peppol e-invoicing plugin and as a broader compliance-ready document platform.

Capability Current support What it does
Profile coverage EU, UAE, Japan, A-NZ Generates Peppol / PINT compliant XML for supported regional frameworks.
Premium compliance modules
Validation Pre-issuance checks Checks buyer identifiers, endpoint data, routing requirements, tax mapping, and required fields before issuing XML.
Dynamic routing Country-aware Routes the order to the appropriate XML profile using store defaults, checkout selections, and billing context.
Gateway transmission StoreCove Supports submission, receiver verification, connection testing, and ongoing status synchronization.
Roadmap readiness Expandable Architecture is already structured for additional gateway APIs and future PINT markets.

Important

XML issuance, routing, compliance automation, checkout B2B metadata capture, and gateway actions are premium capabilities. Core PDF and receipt workflows can be configured independently before you move into compliance automation.

Storage & Runtime Architecture

The plugin is designed as a WooCommerce extension layer with secure file handling, order-bound actions, and optional premium automation services.

Document storage

Generated artifacts are stored under wp-content/uploads/thermal-receipts/. Downloads are mediated through plugin handlers using nonce checks, permission checks, and path validation rather than exposing raw file paths.

HPOS Native

The plugin declares compatibility with WooCommerce High-Performance Order Storage and adds order list actions for both classic and HPOS order screens.

Retention and cleanup

Premium cleanup services use scheduled events such as ogpsr_daily_cleanup_event and gateway polling to maintain document retention and transmission status hygiene.

Hooks & Extensibility

OG PDF Smart Receipts exposes WooCommerce-native integration points plus plugin-specific filters and actions for developers extending order metadata, rendering, settings behavior, customer download flows, and premium compliance operations.

Useful hooks and filters

// Core bootstrap event do_action(‘ogpsr_fs_loaded’); // Settings extension points apply_filters(‘ogpsr_general_settings’, $settings); apply_filters(‘ogpsr_packaging_settings’, $settings); apply_filters(‘ogpsr_xml_settings’, $settings); // XML payload address customization apply_filters(‘ogpsr_xml_address_components’, $components);

Automation entry points

woocommerce_payment_complete woocommerce_order_status_completed woocommerce_email_attachments ogpsr_send_reminder_receipt ogpsr_storecove_poll_status_event ogpsr_daily_cleanup_event

Settings and configuration filters

ogpsr_general_settings ogpsr_thermal_settings ogpsr_a4_settings ogpsr_packaging_settings ogpsr_xml_settings ogpsr_design_settings ogpsr_barcode_settings ogpsr_storage_settings ogpsr_extras_settings ogpsr_gateways_settings ogpsr_status_settings

These filters let developers extend or adjust the WooCommerce settings arrays the plugin registers for each module.

Operational endpoints and AJAX actions

Surface Hook / endpoint Purpose
Customer account woocommerce_account_{endpoint}_endpoint Renders the My Account document hub endpoint.
Email integration woocommerce_email_attachments Attaches generated files to WooCommerce transactional emails.
Admin view action admin_post_ogpsr_view_receipt Secure admin-side document viewing and retrieval.
Bulk admin action admin_post_ogpsr_bulk_download Premium bulk document download handling.
Settings AJAX wp_ajax_ogpsr_ajax_save_settings Saves plugin settings asynchronously from the admin UI.
Document AJAX wp_ajax_ogpsr_regenerate_file Regenerates a document from the admin interface.
Store identity AJAX wp_ajax_ogpsr_sync_woo_details Pulls store identity defaults from WooCommerce into plugin settings.
Cleanup / storage AJAX wp_ajax_ogpsr_run_cleanup, wp_ajax_ogpsr_delete_receipt, wp_ajax_ogpsr_bulk_delete_receipts Handles retention cleanup and file deletion workflows.
Diagnostics AJAX wp_ajax_ogpsr_fetch_live_rate, wp_ajax_ogpsr_purge_cache_ajax Supports live rate fetching and cache / diagnostic utilities.
Thermal tools AJAX wp_ajax_ogpsr_reset_receipt_counter Resets premium receipt counters securely from admin.
Premium metadata AJAX wp_ajax_ogpsr_save_xml_metadata, wp_ajax_ogpsr_autofill_xml_settings, wp_ajax_ogpsr_get_live_preview Handles XML metadata persistence, autofill tools, and live preview rendering.
Gateway AJAX wp_ajax_ogpsr_transmit_order_gateway, wp_ajax_ogpsr_storecove_test_connection, wp_ajax_ogpsr_storecove_discover_receiver, wp_ajax_ogpsr_sync_gateway_status Supports transmission, receiver verification, connection tests, and gateway status synchronization.

Checkout and order lifecycle hooks

  • woocommerce_checkout_fields and woocommerce_checkout_process are used in premium checkout metadata capture and validation.
  • woocommerce_checkout_update_order_meta and woocommerce_checkout_order_created are used to persist checkout-collected compliance data.
  • woocommerce_payment_complete and order status hooks are used by document automation and premium XML / reminder flows.
  • woocommerce_account_menu_items is used to expose the customer-facing document hub in My Account.

Developer notes

  • Admin configuration is registered through WooCommerce settings tabs and custom field renderers.
  • Downloads are handled through plugin endpoints rather than raw public uploads access.
  • Premium behavior is gated both by Freemius compile-time sections and runtime premium checks.

Troubleshooting Guide

Start with the output type that is failing: thermal, A4, downloads, attachments, or compliance automation.

Thermal output looks cramped or blurry

Verify the selected receipt width, simplify oversized branding assets, and test with a clean logo sized for receipt output. Thermal documents have much tighter rendering limits than A4 templates.

Documents are not attaching to emails

Check the selected WooCommerce email triggers, confirm the document type is enabled, and verify the order status hook you expect is actually firing for that order lifecycle.

Order details changed after generation

Regenerate the relevant document from the order screen so the file reflects updated billing, shipping, PO, cashier, or compliance metadata instead of serving an older stored version.

Compliance-specific checks

  • Missing buyer identifiers, endpoint IDs, or tax data can block premium XML issuance.
  • StoreCove actions require working credentials plus a reachable receiver for transmission success.
  • If premium functionality is not available, confirm the license state before troubleshooting advanced features.

Fast answers to common comparison questions

  • Does it support WooCommerce HPOS? Yes, for classic and HPOS order surfaces.
  • Can customers download invoices in My Account? Yes, through secure document access flows.
  • Does it support POS-style receipt operations? Yes, especially for thermal and cashier-led workflows.
  • Does it support compliance gateways? Yes, premium modules include StoreCove receiver verification, transmission, and status synchronization.