AV Solutions Courier Shipping for WooCommerce

AV Solutions Courier Shipping for WooCommerce connects a WooCommerce store to Econt, Speedy, BOX NOW and Pigeon Express. The plugin provides:

• Separate fixed checkout prices for delivery to an office, locker or address.
• Local office and locker lists, with search in the classic checkout.
• WooCommerce Checkout Block fields for delivery locations.
• Contract price checks from the order screen without changing the order total.
• Shipment creation, PDF labels, tracking and cancellation.
• Protection against accidentally creating a second shipment after an uncertain API response.
• Optional cash on delivery according to the merchant's courier contract.
• Bulgarian sales documents for confirmed remote card payments, with a local QR code and PDF attachment.
• Documents for postal money transfer sales when supported by the merchant's Econt or Speedy contract.
• An immutable document snapshot, a separate sequential document number and an event log.
• Monthly audit XML exports validated against the included GPL-licensed schema.
• WooCommerce HPOS, classic checkout and Checkout Block compatibility.

The administration interface is in Bulgarian because the plugin is intended for Bulgarian stores. Shipping is limited to Bulgaria. Store owners must obtain their own courier API credentials and contracts. Checkout uses the fixed shipping prices configured by the store. The price-check button on an order requests the merchant's contract price from the courier, but it does not change the checkout or order total. The plugin does not connect to a fiscal printer, issue invoices or submit files automatically to the Bulgarian National Revenue Agency. It does not guarantee legal or tax compliance. The merchant and their accountant must verify the configured payment methods, VAT groups, document numbering, postal money transfer contract and current reporting requirements before production use. The bundled audit XSD is an independently authored validation subset for the XML generated by the plugin. It follows the publicly described Appendix 38 field structure, but it is not an official National Revenue Agency schema and its acceptance in the current reporting period has not been independently confirmed. Compare every export with the current official schema before submission.

1. Upload the plugin ZIP through Plugins > Add New > Upload Plugin, then activate it.
2. Open WooCommerce > AV Solutions Доставки > Couriers and settings.
3. Enter the sender and API credentials for each courier. All couriers are disabled by default.
4. Select the correct test or live environment. BOX NOW and Pigeon API URLs and credentials are not changed automatically when the environment selector changes.
5. Save the settings and synchronize locations for each enabled courier.
6. Open WooCommerce > Settings > Shipping > Shipping zones, select the Bulgaria zone and add the AV Solutions Доставки method.
7. Configure checkout prices, free-shipping thresholds and shipping tax treatment.
8. Place test orders for every enabled courier and verify location selection, price checks, shipment creation, labels, tracking and cancellation before using live credentials.

MySQL or MariaDB with InnoDB and working GET_LOCK() / RELEASE_LOCK() functions is required. SQLite is not supported in production. The server also needs DOM/XML, mbstring and OpenSSL or Sodium PHP extensions, outbound HTTPS access and a working WordPress mail transport if documents are sent by email.

1.0.0

• Initial public release.
• Added Econt, Speedy, BOX NOW and Pigeon Express courier adapters.
• Added WooCommerce classic checkout and Checkout Block location fields.
• Added sales document PDFs, local QR generation and monthly audit XML export.