Recommended update with WordPress.org compatibility improvements, WooCommerce dependency metadata, Playground Live Preview support, and checkout recalculation fixes.<\/p>","1.0.0":"
Initial release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3502669,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3502669,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3502646,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3502646,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{"blueprint.json":{"filename":"blueprint.json","revision":3503705,"resolution":false,"location":"assets","locale":"","contents":"{\"landingPage\":\"\\\/wp-admin\\\/admin.php?page=wc-settings&tab=shipping\",\"login\":true,\"plugins\":[\"woocommerce\"],\"steps\":[{\"step\":\"installPlugin\",\"pluginData\":{\"resource\":\"wordpress.org\\\/plugins\",\"slug\":\"drusoft-shipping-for-speedy\"},\"options\":{\"activate\":true}}]}"}},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Checkout page with Speedy delivery type selection (Address, Office, Automat).","2":"Shipping method settings in the WooCommerce shipping zone modal.","3":"Speedy Shipment metabox on the order edit screen.","4":"Speedy Orders admin page with bulk actions."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[2986,13827,3546,206280,286],"plugin_category":[45],"plugin_contributors":[259833],"plugin_business_model":[],"class_list":["post-296122","plugin","type-plugin","status-publish","hentry","plugin_tags-bulgaria","plugin_tags-delivery","plugin_tags-shipping","plugin_tags-speedy","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-ventzie","plugin_committers-ventzie"],"banners":{"banner":"https:\/\/ps.w.org\/drusoft-shipping-for-speedy\/assets\/banner-772x250.png?rev=3502646","banner_2x":"https:\/\/ps.w.org\/drusoft-shipping-for-speedy\/assets\/banner-1544x500.png?rev=3502646","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/drusoft-shipping-for-speedy\/assets\/icon-128x128.png?rev=3502669","icon_2x":"https:\/\/ps.w.org\/drusoft-shipping-for-speedy\/assets\/icon-256x256.png?rev=3502669","generated":false},"screenshots":[],"raw_content":"\n
Drusoft Shipping for Speedy<\/strong> is a high-performance, conflict-free WooCommerce integration for Speedy delivery services in Bulgaria. Designed for speed, reliability, and ease of use, it provides a seamless shipping experience for both merchants and customers.<\/p>\n\n This plugin is currently not compatible<\/strong> with the WooCommerce Block Cart and Block Checkout pages. Please ensure your store uses the classic shortcode-based Cart ( This plugin relies on the Speedy REST API<\/strong>, a third-party service provided by Speedy AD<\/strong> (Speedy Bulgaria), to deliver its shipping functionality. The plugin cannot operate without a valid Speedy API account.<\/p>\n\n Speedy AD is a courier and logistics company operating in Bulgaria. Their REST API allows merchants to calculate shipping rates, create shipments (waybills), manage deliveries, and retrieve location data (cities, offices, automats, streets).<\/p>\n\n Data is transmitted only when the corresponding action is triggered (e.g., a customer proceeds to checkout, a merchant generates a waybill, or the background sync runs).<\/p>\n\n This plugin communicates with the Speedy REST API v1<\/strong> ( The plugin minimizes API calls through several strategies:<\/p>\n\n You need the username and password provided by Speedy for their REST API (v1). Contact Speedy Bulgaria to obtain API access.<\/p><\/dd>\n Not yet. The plugin currently requires the classic shortcode-based Checkout page ( The plugin uses the WooCommerce Action Scheduler to sync cities and offices from the Speedy API in the background. You can monitor the scheduled action ( Upload a CSV with columns: Yes. Enable the Automatic Waybill<\/strong> option in the shipping method settings. A waybill will be created automatically when an order reaches the \"Processing\" or \"On Hold\" status.<\/p><\/dd>\n\n<\/dl>\n\n\nImportant Compatibility Note<\/h4>\n\n
[woocommerce_cart]<\/code>) and Checkout ([woocommerce_checkout]<\/code>) pages.<\/p>\n\nFor Your Customers<\/h4>\n\n
\n
For Merchants<\/h4>\n\n
\n
External Services<\/h3>\n\n
What the service is<\/h4>\n\n
What data is sent and when<\/h4>\n\n
\n
Service links<\/h4>\n\n
\n
Speedy API Endpoints<\/h3>\n\n
https:\/\/api.speedy.bg\/v1\/<\/code>). All requests are authenticated using the userName<\/code> and password<\/code> fields configured in the shipping method settings. Below is a summary of every endpoint used, along with its purpose and where it is called in the plugin.<\/p>\n\nAuthentication & Account<\/h4>\n\n
\n
POST \/v1\/client\/contract<\/code><\/strong> \u2014 Validates API credentials and retrieves the list of client contracts (sender accounts). Used during credential validation when the merchant saves settings, and to populate the \"Sender (Object)\" dropdown in the shipping method configuration.<\/li>\nPOST \/v1\/client\/contract\/info<\/code><\/strong> \u2014 Retrieves detailed contract information, including special delivery requirements (e.g., mandatory open-on-test, two-way receipt). Used to populate the \"Special Requirements\" multi-select in the shipping method settings.<\/li>\n<\/ul>\n\nLocation Data<\/h4>\n\n
\n
POST \/v1\/location\/site<\/code><\/strong> \u2014 Searches for cities\/sites by name within Bulgaria (countryId: 100<\/code>). Used by the admin Select2 city search when configuring the sender city, and for the public-facing city autocomplete on checkout.<\/li>\nPOST \/v1\/location\/site\/csv\/100<\/code><\/strong> \u2014 Downloads the complete list of Bulgarian cities in CSV format. Used by the background syncer (Drushfo_Syncer<\/code>) to populate and update the wp_drushfo_cities<\/code> database table via Action Scheduler.<\/li>\nPOST \/v1\/location\/office<\/code><\/strong> \u2014 Retrieves all Speedy offices and automats for Bulgaria. Used in two contexts: (1) the background syncer updates the wp_drushfo_offices<\/code> table, and (2) the admin Select2 office search for configuring the sender office.<\/li>\nPOST \/v1\/location\/street<\/code><\/strong> \u2014 Searches for streets within a specific city (siteId<\/code>). Used on the checkout page to provide street autocomplete when the customer selects \"Delivery to Address.\"<\/li>\n<\/ul>\n\nServices & Pricing<\/h4>\n\n
\n
POST \/v1\/services<\/code><\/strong> \u2014 Retrieves the list of available shipping services (e.g., Standard 505, Express 501) for the authenticated account. Used to populate the \"Active Services\" multi-select in the shipping method settings.<\/li>\nPOST \/v1\/calculate<\/code><\/strong> \u2014 Calculates the shipping price for a specific service, weight, destination, and delivery type. Used at cart\/checkout time when the pricing method is set to \"Speedy Calculator\" or \"Calculator + Surcharge.\"<\/li>\n<\/ul>\n\nShipment Management<\/h4>\n\n
\n
POST \/v1\/shipment\/<\/code><\/strong> \u2014 Creates a new shipment (waybill) with the Speedy system. Includes sender\/recipient details, service, weight, COD amount, and delivery type. Used by the waybill generator, either automatically on order status change or manually from the order metabox.<\/li>\nPOST \/v1\/shipment\/cancel<\/code><\/strong> \u2014 Cancels an existing shipment by its waybill ID. Used from the \"Cancel Shipment\" button in the Speedy order metabox or the Speedy Orders bulk action.<\/li>\nPOST \/v1\/pickup<\/code><\/strong> \u2014 Requests a courier pickup for one or more shipments. Accepts a visit end time and auto-adjusts the pickup date. Used from the \"Request Courier\" button in the order metabox.<\/li>\nPOST \/v1\/print<\/code><\/strong> \u2014 Generates a printable waybill label (PDF) for a shipment. Supports A4, A6, and label formats with optional additional barcode copy. Used from the \"Print Waybill\" button in the order metabox and the Speedy Orders page.<\/li>\n<\/ul>\n\nRate Limiting & Caching<\/h4>\n\n
\n
\n
drusoft-shipping-for-speedy<\/code> folder to the \/wp-content\/plugins\/<\/code> directory.<\/li>\n\n
What Speedy API credentials do I need?<\/h3><\/dt>\n
Does this plugin support the WooCommerce Block Checkout?<\/h3><\/dt>\n
[woocommerce_checkout]<\/code>). Block Checkout support is planned for a future release.<\/p><\/dd>\nHow are cities and offices kept up to date?<\/h3><\/dt>\n
drushfo_sync_locations_event<\/code>) under WooCommerce > Status > Scheduled Actions<\/strong>.<\/p><\/dd>\nWhat pricing methods are available?<\/h3><\/dt>\n
\n
How does the CSV custom pricing work?<\/h3><\/dt>\n
service_id, delivery_type, max_weight, max_order_total, price<\/code>. Delivery type mapping: 0<\/code> = Address, 1<\/code> = Office, 2<\/code> = Automat. The plugin matches rows where the order's weight and subtotal are within the specified limits.<\/p><\/dd>\nCan I automatically generate waybills?<\/h3><\/dt>\n
1.0.1<\/h4>\n\n
\n
1.0.0<\/h4>\n\n
\n