Documentation

Getting started > Quick start

Getting started

Quick start

Time needed: About 15 minutes

This guide walks you through setting up BridgeSync PDF Invoices for the first time. The Setup Wizard handles all configuration in 6 steps. By the end, your WooCommerce store will automatically generate professional PDF invoices, credit notes, and packing slips.

Before you start

Make sure you have:

  • A WooCommerce store that's up and running
  • Your BridgeSync licence key (check your welcome email or your BridgeSync account)
  • Your company logo in PNG or JPG format (recommended: transparent PNG, max 500 KB)
  • Your company details (address, VAT number, Chamber of Commerce number)
1

Install the plugin

Takes: 2 minutes

  1. Download the plugin ZIP file from your BridgeSync account
  2. In WordPress, go to Plugins → Add Plugin
  3. Click Upload Plugin at the top of the page
  4. Choose the ZIP file you downloaded and click Install Now
  5. After installation completes, click Activate Plugin

The Setup Wizard starts automatically after activation. If it doesn't, go to PDF Invoices → Setup Wizard in the WordPress sidebar.

Upload the BridgeSync PDF Invoices & Packing Slips plugin
2

Enter your licence key

Takes: 1 minute

The Setup Wizard opens on Step 1: Licence.

  1. Find your licence key in the welcome email you received after purchase, or log in to your BridgeSync account under Licences
  2. Paste the licence key into the Licence Key field
  3. The wizard automatically validates your licence — wait for the green success message: "Licence validated! Activating..."
  4. You'll be redirected to Step 2 automatically
Setup wizard step 1: welcome screen

Licence validation failed?

  • Double-check you copied the entire licence key with no missing characters or extra spaces
  • Verify you're using a valid, active licence (not expired or already activated on another site)
  • Make sure your WordPress site can connect to the internet
3

Choose a template

Takes: 2 minutes

Step 2 of the Setup Wizard lets you choose a document template. This template applies to all three document types (invoice, packing slip, credit note). You can customise per document type later in Invoice Settings.

Template Style Best for
Default Standard formatting with clear sections Most businesses
Basic Sleek and compact Minimalist brands
Modern Light and spacious Premium/luxury brands

Click the Preview button next to any template to see how it looks.

Select your preferred template and click Next Step.

Setup wizard step 2: document settings

Need a pixel-perfect invoice?

If you need invoices that exactly match your current design (colours, fonts, layout), BridgeSync offers two options: create your own custom template in WordPress, or let BridgeSync design it for you. Click "Design my invoice →" in the Setup Wizard for more information.

4

Add your company details

Takes: 3 minutes

Step 3 of the Setup Wizard is where you configure your branding and company information. Everything you enter here will appear on your invoices, credit notes, and packing slips.

Upload your logo

  1. Click Upload/Update in the Logo section
  2. Select your company logo from the WordPress Media Library or upload a new file
  3. PNG format with transparent background works best

Set your brand colours

  1. Click Select Colour next to Primary colour to choose your brand's main colour
  2. Click Select Colour next to Text colour to set the document text colour
  3. The wizard shows contrast indicators (AA/AAA) to help ensure readability

Enter company details

Fill in all relevant fields. At minimum, complete:

  • Company name (required — shows a red indicator if empty)
  • Street, ZIP code, City, Country
  • VAT number (important for tax compliance)
  • Chamber of Commerce number (KVK in the Netherlands)
  • Email and Website

Click Next Step when done.

Setup wizard step 3: invoice numbering
5

Configure email attachments

Takes: 2 minutes

Step 4 determines which PDFs automatically attach to which WooCommerce emails.

Simple mode (recommended)

The Simple tab shows the most common options:

Setting What it does Recommended
Attach to "Customer Refunded" email Sends invoice with refund notification ✓ On
Attach to "Customer Completed" email Sends invoice when order completes ✓ On
Attach packing slip to "Customer Processing" email Sends packing slip when order starts processing Off (usually internal)
Attach credit note PDF to refund emails Sends credit note with refund notification ✓ On

Advanced mode (e-invoices)

Click the Advanced tab if you need to send machine-readable e-invoices for B2B customers or accountants:

  • UBL (XML) — Standard EU e-invoice format (EN16931)
  • CII (XML) — Alternative e-invoice format
  • Also attach UBL when embedded (hybrid) — For recipients who need both PDF and XML

Most stores can leave Advanced settings off and enable them later if a customer requests e-invoices.

Click Next Step when done.

Setup wizard step 4: PDF templates
6

Set filename patterns

Takes: 2 minutes

Step 5 lets you customise how PDF files are named when stored. The plugin uses tokens that get replaced with actual values.

Default patterns

Document Default pattern Example output
Invoice invoice-{invoice_number}.pdf invoice-INV-2026-0001.pdf
Credit note creditnote-{credit_number}.pdf creditnote-CRN-2026-0001.pdf
Packing slip packing-slip-{packing_number}.pdf packing-slip-PS-2026-0001.pdf

Available tokens

Token What it shows
{invoice_number} Sequential invoice number
{credit_number} Sequential credit note number
{packing_number} Sequential packing slip number
{order_number} WooCommerce order number
{YYYY} 4-digit year (2026)
{YY} 2-digit year (26)
{MM} 2-digit month (01-12)
{DD} 2-digit day (01-31)

If you want invoice files named like INV-2026-01-000123.pdf, use:

INV-{YYYY}-{MM}-{invoice_number}.pdf

Click Next Step when done.

Setup wizard step 5: email attachments
7

Setup complete!

Takes: 1 minute

Step 6 confirms that everything is configured correctly. You'll see a list of features that are now enabled:

  • ✓ Licence verified & activated
  • ✓ Template selected for all documents
  • ✓ Logo and brand colours applied
  • ✓ Company details saved (address, VAT, Chamber of Commerce)
  • ✓ Email attachment rules enabled
  • ✓ Automatic document generation before emails
  • ✓ Filename patterns saved
  • ✓ Recommended defaults applied for reliability
  • ✓ WooCommerce Blocks & HPOS compatibility confirmed
  • ✓ Connection to BridgeSync services tested

Click Go to Dashboard to open the plugin dashboard.

Setup wizard step 6: finish
8

Test your setup

Takes: 3 minutes

Generate a test invoice

  1. Go to WooCommerce → Orders
  2. Open any existing order (or create a test order)
  3. Look for the PDF Invoices meta box in the order sidebar
  4. Click Generate Invoice or Download Invoice
  5. Verify the PDF shows your logo, colours, and company details correctly

Test email attachments

  1. Open the same order
  2. Use the Order Actions dropdown to resend an email (e.g., "Resend order details to customer")
  3. Check your email inbox to confirm the PDF is attached
WooCommerce order actions for PDF documents

You’re all set!

BridgeSync PDF Invoices is now configured and will automatically generate documents for your orders.

What to do next