AV Solutions Courier Shipping for WooCommerce
| 开发者 | avsolutions |
|---|---|
| 更新时间 | 2026年11月4日 19:43 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
AV Solutions Courier Shipping for WooCommerce connects a WooCommerce store to Econt, Speedy, BOX NOW and Pigeon Express.
The plugin provides:
- Fixed or live contract checkout prices for delivery to an office, locker or address.
- Local office and locker lists, filtered automatically by the customer's delivery city, with optional manual search.
- Courier address search with street or quarter selection and validation before an address-delivery order can be placed.
- WooCommerce Checkout Block fields for delivery locations.
- Contract price checks from the order screen without changing the order total.
- Shipment creation, PDF labels, automatic tracking history and cancellation.
- Courier, waybill and current delivery status fields in WooCommerce orders, customer order pages and outgoing order emails.
- Optional automatic completion of an order after the courier confirms delivery; returned and problematic shipments are flagged without automatic refunds or cancellation.
- Protection against accidentally creating a second shipment after an uncertain API response.
- Optional cash on delivery according to the merchant's courier contract.
- Automatic customer PDF documents for every accepted order. The Article 52o wording and statutory Appendix 18a QR payload are used only for confirmed remote card payments; other payment methods receive a clearly identified sales document with a verification QR code.
- 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. Newly issued sales documents include the courier, destination, waybill and delivery status available at issuance.
- Monthly audit XML exports validated against the included GPL-licensed schema.
- WooCommerce HPOS, classic checkout and Checkout Block compatibility.
- Merchant-defined shipping prices or live contract prices from the courier API, with percentage adjustment, minimum, maximum and fallback controls.
- Courier logos in the administration and responsive delivery-method cards in classic checkout and Checkout Blocks.
- Invoices, pro forma invoices and credit notes with sequential numbering and PDF output.
- Invoice-request and company fields in classic checkout and Checkout Blocks.
- Monthly Microinvest Delta TXT export and a ZIP archive of generated accounting documents.
- Bulk shipping-label and invoice generation from the WooCommerce orders list, without an artificial plugin limit.
- Optional customer delivery-history checks through Connectix and NepoStop.
- Optional VAT-number validation through VIES.
- Optional monthly audit XML email to the configured accountant.
安装:
- Upload the plugin ZIP through Plugins > Add New > Upload Plugin, then activate it.
- Open WooCommerce > AV Solutions Доставки > Couriers and settings.
- Enter the sender and API credentials for each courier. All couriers are disabled by default.
- Select the correct test or live environment. BOX NOW and Pigeon API URLs and credentials are not changed automatically when the environment selector changes.
- Save the settings and synchronize locations for each enabled courier.
- Open WooCommerce > Settings > Shipping > Shipping zones, select the Bulgaria zone and add the AV Solutions Доставки method.
- Configure checkout prices, free-shipping thresholds and shipping tax treatment.
- Place test orders for every enabled courier and verify location selection, price checks, shipment creation, labels, tracking and cancellation before using live credentials.
- In the plugin settings, review automatic tracking and whether a courier-confirmed delivery may complete the WooCommerce order.
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.屏幕截图:
常见问题:
Does it calculate live courier prices during checkout?
Yes, when the courier supports price calculation and the store selects the API price mode. Each courier can instead use fixed office and address prices. The administrator can also configure an API-price adjustment, minimum, maximum and either a fixed-price fallback or hiding the unavailable method.
Does it submit the monthly XML to the National Revenue Agency?
No. The plugin validates and downloads an XML file. The merchant must review and submit it separately using the current official procedure.
Is this a fiscal printer?
No. It does not control fiscal hardware. Version 1.1.0 can generate commercial invoices, pro forma invoices and credit notes, but these documents must be reviewed against the merchant's accounting policy before production use.
What happens if the courier connection fails while creating a shipment?
The request is marked as uncertain and automatic retry is blocked. Check the courier portal using the order reference. Only after confirming that no shipment exists should a manager reset the request and try again.
Can I use postal money transfer reporting for every courier?
No. In this version it is limited to Econt and Speedy, and only when the merchant confirms the relevant contract. Econt also requires the correct postal money transfer template. BOX NOW and Pigeon cash-on-delivery orders require separate fiscal handling outside this plugin.
Does uninstalling remove the accounting records?
No. Shipment, tracking history, document, audit and refund records are intentionally retained. The scheduled synchronization events are removed.
Are existing issued documents changed when tracking is updated?
No. Issued documents are immutable. A newly issued document stores the courier and waybill status that was available at the time of issue. Later tracking changes remain visible in the WooCommerce order and its delivery history without rewriting an accounting document.
更新日志:
1.1.10
- Add a QR code to every newly rendered customer document. Confirmed card payments keep the Appendix 18a payload; other sales use a clearly identified document-verification payload.
- Add a separate report for accepted orders that have no document, because a missing order is not the same as a skipped sequential number.
- Add an “Issue now” action to the WooCommerce order list and the documents report, with the exact document-generation error shown in the list.
- Run the missing-document reconciliation from the administration as well as the hourly WordPress cron so delayed cron cannot leave old accepted orders unnoticed.
- Issue non-card sales documents as soon as checkout creates the order, and reconcile recent accepted orders hourly so temporary configuration or mail errors do not leave an order without a document.
- Keep Article 52o documents limited to confirmed remote card payments and show pending card orders as waiting for payment instead of silently missing a document.
- Replace the customer PDF with a compact one-page layout containing merchant, customer, courier destination, payment, item, tax and total sections.
- Audit the shared sales-document sequence, show gaps in the administration and allow a verified skipped number to be recorded as annulled without renumbering issued documents or reusing the number.
- Prevent a single order from receiving both a generic sales document and a separate Article 52o document.
- Issue and email a PDF document automatically for every accepted WooCommerce order while keeping Article 52o wording and QR codes limited to confirmed remote card payments.
- Add a document download column to both HPOS and classic WooCommerce order lists.
- Compact the customer sales-document layout so ordinary orders fit on one A4 page.
- Recognize Speedy’s “Приемане от подател” event as an in-transit shipment and move the WooCommerce order to “Изпратена”.
- Add the WooCommerce order status “Изпратена” after the courier confirms that a shipment is in transit or ready for collection.
- Move delivered orders from “Изпратена” to “Приключена” when automatic completion is enabled.
- Check active shipments every 15 minutes throughout the day and replace the previous four-hour schedule automatically.
- Select monthly audit orders by the confirmed delivery month, including courier-confirmed deliveries that remain in processing status.
- Include every delivered order with its actual Appendix 38 payment code instead of limiting the report to virtual-POS sales.
- Export pre-discount article values while preserving the order discount and final total fields.
- Recover shipping VAT only when it is present in the WooCommerce order totals, and use the Appendix 38 header order produced by Bulgarisation.
- Upgrade existing audit snapshots safely without changing already issued customer PDFs.
- Fixed label printing from the WooCommerce order screen so the selected size opens the courier PDF instead of submitting the order form to edit.php.
- Added per-print label size selection and a per-courier default for Speedy A4/A6 and Pigeon A4/100×150/100×90 mm labels.
- Show the selected courier destination in the WooCommerce order list before and after a shipment is created, with a fallback to the stored office or structured courier address.
- Fixed Speedy label printing when the API negotiates PDF success and JSON error responses, and print every parcel in a multi-parcel shipment.
- Added fixed or live API courier pricing with adjustments, limits and fallback rules.
- Added invoices, pro forma invoices, credit notes, PDF output and company checkout fields.
- Added Microinvest export, document ZIP archives and optional accountant email delivery.
- Added bulk label and invoice generation.
- Added optional Connectix, NepoStop and VIES integrations.
- Added official courier logos to the administration and checkout.
- Added Speedy contract-client synchronization and sender profile selection.
- Added automatic office and locker filtering by the checkout delivery city.
- Fixed switching between courier delivery methods so stale Speedy locations cannot appear after selecting BOX NOW.
- Added responsive courier-logo cards for choosing office, locker or address delivery.
- Added carrier-nomenclature address search for Econt, Speedy and Pigeon, with Econt/Speedy API validation and checkout blocking until a courier address is confirmed.
- Stores the structured courier address with the order and uses it when calculating a live price and creating the shipment.
- Added BOX NOW postcode and location-note data to synchronized lockers for more reliable city filtering.
- Added automatic shipping-label creation as an optional per-courier setting.
- Added automatic courier tracking, normalized delivery statuses and an immutable shipment-event history.
- Added courier, waybill and delivery-status fields to WooCommerce order screens, customer order pages and order emails.
- Added optional order completion after API-confirmed delivery, while returned and problematic shipments remain flagged for manual review.
- Added the courier, destination, waybill and status-at-issue to newly generated N-18 sales documents without changing previously issued documents.
- Fixed courier selection so the complete logo card is rendered and clickable in classic checkout and Checkout Blocks.
- Fixed courier address fields and suggestions overflowing outside the delivery panel, including themes that force content-box sizing.
- Added Bulgarian month names to generated sales documents and monthly report emails.
- Completed orders missing an audit snapshot are now safely archived during monthly XML generation using their WooCommerce completion date.
- Added reliable automatic monthly XML delivery and manual selected-month delivery to the configured accountant email.
- Limited audit exports to completed calendar months and replaced the browser month field with a Bulgarian month selector.
- Added 10-digit sales-document numbers for every exported order and logged repair of audit records created by the earlier invalid schema.
- Added PAYM 6 for cash-on-delivery sales recorded with a fiscal receipt and tightened the local XSD validation.
- Accountant emails now preserve the .xml attachment name and use the WordPress administrator email with the configured company or site name.
- Added a read-only migration from current and legacy Bulgarisation/woo-bg/bfw metadata that preserves original document numbers and PDFs, checks conflicts before import and continues the shared numbering sequence.
- Added a submitted-through cutoff so audit months already filed through Bulgarisation cannot be generated or emailed again.
- 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.