Drusoft Shipping for Sameday
| 开发者 | ventzie |
|---|---|
| 更新时间 | 2026年10月10日 03:48 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
[woocommerce_cart]) and Checkout ([woocommerce_checkout]) pages.
For Your Customers
- Three delivery options — to an address (24H), to an easybox locker, or to a SAMEDAY point.
- Live prices — each option is priced by Sameday for the actual parcel, city and payment method.
- City list — the customer picks a region, then a city from a searchable list (Latin or Cyrillic); the postcode fills itself.
- Only what the city has — easybox and SAMEDAY point are offered only in cities that have one, with a searchable list of that city's locations.
- Map picker — a map of every easybox and SAMEDAY point in the country, opened on the customer's city, with filters and search. Picking a location elsewhere sets the region, city and delivery type by itself.
- Full lockers hidden — locations Sameday reports as over capacity are not offered.
- HPOS Compatible — Fully supports WooCommerce High-Performance Order Storage.
- Automated Data Sync — Uses Action Scheduler to refresh Bulgarian cities and Sameday pickup locations daily, so checkout never waits on the API.
- Fallback prices — if Sameday cannot be reached, checkout still shows a price from a table you configure.
- Waybill Management — Create, print (PDF) and cancel waybills from the order edit screen, or create them automatically when an order becomes Processing or On hold.
- Cash on delivery collected correctly — the waybill always carries the order total, never a stale checkout estimate.
- Declared value — off, above a threshold, or always.
- Open before paying — optionally add Sameday's „Отвори преди да платиш“ extra to every waybill for delivery to an address.
- Demo and production — switch between Sameday's demo and live environments in the settings.
- Bulgarian (bg_BG) Translation Included.
安装:
- Upload the
drusoft-shipping-for-samedayfolder to the/wp-content/plugins/directory. - Ensure WooCommerce is installed and active.
- Activate the plugin through the Plugins menu in WordPress.
- Navigate to WooCommerce > Settings > Shipping > Shipping Zones.
- Add or edit a shipping zone (e.g. "Bulgaria").
- Click Add shipping method and select Sameday.
- Choose the environment, enter your Sameday API username and password, and click Save Changes. The credentials are checked immediately and the first location sync runs.
- Select your pickup point and the delivery options you want to offer, then save again.
屏幕截图:
常见问题:
What Sameday credentials do I need?
An API username and password issued by Sameday for your contract. Demo credentials and production credentials are separate — ask Sameday's integration team for both.
Does this plugin support the WooCommerce Block Checkout?
Not yet. The plugin currently requires the classic shortcode-based Checkout page ([woocommerce_checkout]).
How are pickup locations kept up to date?
The plugin uses the WooCommerce Action Scheduler to refresh cities, easybox lockers and SAMEDAY points from the Sameday API once a day. You can monitor the scheduled action (drushfs_sync_locations_event) under WooCommerce > Status > Scheduled Actions. The settings screen shows when the last refresh ran.
How is shipping cost calculated?
Each delivery option is priced live by Sameday's estimate-cost endpoint for the parcel weight, destination, cash-on-delivery amount and declared value. Quotes are cached for 15 minutes so a checkout does not call the API on every keystroke. If Sameday cannot be reached, the fallback prices from the settings are used instead.
Why is the SAMEDAY point option missing at checkout?
Each pickup option appears only when the customer's city has such a location. A city with no SAMEDAY point offers address delivery and, if it has one, easybox.
Can I automatically generate waybills?
Yes. Enable Create automatically in the shipping method settings. A waybill is created when an order becomes "Processing" or "On hold"; an order that already has one is never given a second.
The browser console shows a 404 for “…/undefinedwc/store/v1/cart” on the cart page. Is that this plugin?
No. That request is made by WooCommerce's own Mini-Cart block (the cart icon in the header of block themes such as Twenty Twenty-Five) when the cart itself is the classic shortcode page this plugin requires. WooCommerce builds the address from a value that is not set on that page, so it starts with the word “undefined”. It appears with every shipping plugin switched off as well, and it does not affect prices, delivery options or orders — only the header icon's item count may lag until the next page load.
What happens to my data if I deactivate or delete the plugin?
Deactivating stops the daily sync and nothing else — your settings and the synced cities and pickup locations stay, so switching the plugin back on costs nothing. Deleting the plugin removes its two tables, its settings and its cached data. Orders keep their waybill number and pickup location either way.
Can I request a courier from WordPress?
No. Sameday's client API has no courier-request endpoint. Collection follows your pickup point arrangement with Sameday, or you drop parcels into an easybox.
更新日志:
- Improved: when Sameday stops answering, the fallback table prices the checkout for two minutes and then Sameday is asked again. A table price is now remembered for one minute instead of fifteen, so live prices return as soon as Sameday does. A price request waits at most 15 seconds instead of 45.
- Improved: a Sameday method saved without a pickup point used to price everything from the fallback table in silence. The pickup point is now selected automatically when the account has only one; otherwise the settings refuse to save without one, a notice appears on the WooCommerce screens and the log says why.
- Fixed: a Sameday reply without a price is logged instead of silently falling back.
- Security: the delivery choice posted with the cart or checkout is only read when WooCommerce's own nonce for that request verifies; any other request leaves the customer's saved choice untouched. The checkout validation and order-meta hooks check the checkout nonce themselves as well.
- Fixed: activating the plugin no longer contacts Sameday. Activation used to fetch cities, lockers and services straight away, which could hold the admin for over two minutes if Sameday was unreachable; the first sync is now scheduled a minute after activation and runs in the background instead.
- First public release.
- Three delivery options priced live by Sameday: to an address (24H), to an easybox and to a SAMEDAY point.
- Region and city pickers that fill the postcode, offering only the options the chosen city actually has.
- Searchable pickup list plus a map of every location in the country, opened on the customer's city.
- Daily location sync through Action Scheduler; fallback prices when Sameday cannot be reached.
- Waybills created by hand or automatically, PDF labels, cancellation and tracking links.
- Optional "open before paying" extra on address deliveries; declared value off, above a threshold or always.
- Demo and production environments; Bulgarian translation included.
- Deactivating the plugin keeps your settings and synced locations; they are removed only when the plugin is deleted.