Complete Installation & Configuration Guide for ACS Voucher for WooCommerce
In this guide you will see step-by-step how to install and configure
ACS Voucher for WooCommerce, how to correctly enter ACS test/live
Web Services, how to complete the required test scenario
and how to use the plugin daily directly from WooCommerce orders.
What we are going to configure
ACS Voucher for WooCommerce connects your store with ACS Web Services, so you can issue, print, cancel and track vouchers directly from WooCommerce orders.
1) Before you start
To use the plugin, ACS Web Services are required. ACS usually provides test credentials first and, after the test procedure is successfully completed, sends the live credentials.
You will need:
- Company ID
- Company Password
- User ID
- User Password
- Billing Code
- API Key
2) Installation & activation
Installation is the same as with any WooCommerce plugin.
.zip file you downloaded after purchase.
3) API connection settings
Open the plugin settings page, for example from VGDev Solutions → ACS Courier Voucher.
API connection details
In the API connection details section, enter:
- Sender: the sender name you want to appear on the voucher.
- Company ID / Company Password
- User ID / User Password
- Billing Code
- API Key
Save & connection test
- First click Save settings, so the new credentials are stored.
- Then click Connection Test to confirm that communication with ACS is working properly.
4) General settings
In the General Settings section, you will find options that affect day-to-day operation.
Default weight
The Default weight (kg) field acts as a fallback when products do not have a defined weight.
- If you leave the field empty, the plugin automatically pulls weights from your WooCommerce products and calculates the total order weight.
- If you have products without weight, set a safe value such as
0.5kg, so voucher creation does not fail.
Print size
From the Print Size field, you can choose the default voucher print format.
- Flyer (A5): printing in A5 flyer format.
- Sticker (10×10): printing in 10×10 cm sticker format.
Convert to uppercase
If you want recipient details, such as address and other fields, to be converted to uppercase without accents, enable this option.
Change order status
You can set an automatic order status change when a voucher is created, or keep the setting without change.
5) Test operation
ACS usually requires confirmation that the main parts of the integration work correctly.
- Voucher issuance.
- Voucher printing.
- Voucher cancellation.
- Collection manifest issuance.
Step-by-step test
- Enter the test Web Services provided by ACS in the plugin settings and click Save settings.
- Create a test WooCommerce order or open an existing order.
- In the order’s right sidebar, inside the ACS Courier Voucher box, click Create voucher.
- Once the voucher is successfully created, the voucher number appears and the Print, Tracking and Cancel buttons become available.
- Click Print and save the voucher PDF.
- From the plugin settings, issue a Collection Manifest and save that PDF as well.
- Return to the order and click Cancel voucher.
- Email ACS to confirm that the test has been completed and attach the 2 PDFs: voucher and collection manifest.
- Wait for the live Web Services and replace the test credentials in the settings.
6) Issuing a voucher from the order
After setup, voucher management is handled directly inside the order.
- Go to WooCommerce → Orders.
- Open the order.
- In the ACS Courier Voucher box, click Create voucher.
After issuance, you can use:
- Print: download the voucher PDF.
- Tracking: view shipment tracking.
- Cancel: cancel the voucher when needed.
7) Collection Manifest
The Collection Manifest is the document you hand to the courier and includes the vouchers for the shipments you are handing over.
How to issue it
From the plugin settings, in the Print Collection Manifest section, click Issue collection manifest for the current day.
Older collection manifests
You can print manifests from previous days, as long as they had already been created.
- Select a date.
- Click Search.
- Choose the manifest you need from the results.
Rules you should know
- The collection manifest refers to the vouchers of the day.
- If you issue a manifest and then create new vouchers, you can issue a second manifest on the same day.
- It is not recommended to move vouchers to a following day so they can be included in a different manifest.
8) Email Tracking & Preview
In the Email & Tracking Settings section, you can enable customer notification for shipment tracking.
- Send Tracking Email to the customer when the order is completed.
- Choose a color for the tracking email.
- Preview the email before enabling it.
9) Debug Mode
There is a Debug Mode option that logs requests and responses to a log file for troubleshooting.
Use it when:
- Voucher creation fails.
- There is an issue printing or downloading the PDF.
- You need to send technical information to support.
10) Frequently Asked Questions
You hand the collection manifest to the courier and it contains the vouchers for the shipments you are handing over.
The collection manifest must be issued within the same day and includes that day’s vouchers.
You can issue a second manifest on the same day if new vouchers are created.
From the plugin settings, select a date, click Search, and choose the manifest you want, provided it had been created on that date.
11) Print sizes
The plugin supports the print sizes provided by ACS Courier through the Web Services. From the Print Size setting, you can choose:
- Flyer (A5): printing in flyer format, A5 size.
- Sticker (10×10): printing in 10×10 cm sticker format.
12) Support
For any issue or question regarding plugin setup or operation, you can contact technical support.
