Тихомир Парушев

<p>Този плъгин добавя възможност за:</p>
<ul>
<li>Генериране на одиторски XML файл съобразно Наредба – H-18. </li>
<li>Генериране на документ за поръчката. </li>
<li>Генериране на фактури за поръчката. </li>
<li>Генериране на кредитно известие при върната поръчка.</li>
<li>Генериране на експорт файл с фактури и кредитни известия за Microinvest Delta</li>
<li>Добавя полета за фактуриране към фирма.</li>
<li>Проверка на ДДС номер с европейската система VIES.</li>
<li>Проверка за отзиви от Connectix.bg</li>
<li>Проверка за отзиви от nepostop.bg</li>
<li>Добавена възможност за добавяне на вече създадени поръчки към одиторският файл.</li>
<li>Добавени методи за доставка с <a href="https://www.econt.com/" rel="nofollow ugc">Еконт</a>.</li>
<li>Добавени методи за доставка със <a href="https://boxnow.bg/e-shops" rel="nofollow ugc">BOX NOW</a>.</li>
<li>Добавени методи за доставка със <a href="https://speedy.bg/" rel="nofollow ugc">Спиди</a>.</li>
<li>Добавени методи за доставка със <a href="https://cvc.bg/" rel="nofollow ugc">CVC</a>.</li>
<li>Добавена възможност за показване на цените в две валути BGN/EUR.</li>
</ul>
<p>Плъгинът използва следните помощни библиотеки:</p>
<ul>
<li>За генериране на одиторския файл – https://github.com/escapeboy/nra-audit-generator ( модифициран )</li>
<li>За генериране на QR код в документите – https://github.com/chillerlan/php-qrcode</li>
<li>За валидиране на ДДС номер – https://github.com/ddeboer/vatin</li>
</ul>
<h3>Забележки</h3>
<ul>
<li>За да работи коректно плъгина моля попълнете всички задължителни полета, включително настройките за всеки платежен метод.</li>
<li>При нужда свържете се с вашият счетоводител, ако не сте сигурни за някое от полетата.</li>
<li>За да използвате отзивите от nekorekten.com трябва да включите опцията в главните настройки на плъгина и да добавите API ключ в новопоявилия се таб.</li>
<li>За да използвате методи на доставка с Еконт/BOX NOW/CVC/Спиди, трябва да включите опцията в главните настройки на плъгина. След запазване и презареждане на страницата ще се появи нов таб с настройките за Еконт/BOX NOW/CVC/Спиди. След това добавете желаните методи за доставка ( за адрес и офис трябва да имате 2 метода за доставка ) в зоните за доставка – WooCommerce >> Настройки >> Доставка >> Зони за доставка.</li>
</ul>
<p><a href="https://www.facebook.com/groups/bulgarisationforwoocommerce/" rel="nofollow ugc">Facebook група</a><br />
<a href="https://github.com/susameca/bulgarisation-for-woocommerce" rel="nofollow ugc">GitHub</a> хранилището на плъгина където можете да допринесете към развитието на плъгина.</p>
<h3>PRO version</h3>
<ul>
<li>Скрива повечето нежелани полета от чекаута като държава, град, област, пощенски код, адрес 1/2 и като техен заместител добавя ново поле за град с дропаун с градовете от API на спедитора. Потребителя също има поле за търсене. В допълнение ще имате друга настройка, която да включи полето за държава ако искате да продавате в Гърция и Румъния.</li>
<li>Променя дефолтните радио бутони на шипинг методите с по-стилизирани нормални бутони.</li>
<li>Добавяне на доставки до Гърция и Румъния за Еконт и Спиди.</li>
<li>Възможност за добавяне номера на поръчката в описанието на товарителницата.</li>
<li>Добавя възможност за автоматична смяна на статусите на поръчките спрямо статуса на товарителницата.</li>
<li>Добавя nekorekten.com като източник на отзиви за потребителите</li>
<li>Добавя възможност за автоматично попълване на данните за фирмата според въведения ЕИК.</li>
</ul>
<h3>External services</h3>
<p>Този плъгин използва външни услуги (API) с цел автоматизация на процесите в електронния магазин:</p>
<ul>
<li>
<p>Създаване и управление на товарителници към куриерски услуги, добавяне на офис локатори и предоставяне на линкове за проследяване на пратките:</p>
<ul>
<li>Econt ( <a href="https://www.econt.com/econt-express/terms-of-use" rel="nofollow ugc">terms-of-use</a> ) </li>
<li>https://www.econt.com/</li>
<li>http://ee.econt.com/</li>
<li>http://demo.econt.com/</li>
<li>https://officelocator.econt.com/</li>
<li>Speedy ( <a href="https://api.speedy.bg/api/docs/#href-terms" rel="nofollow ugc">terms</a> )</li>
<li>https://www.speedy.bg/</li>
<li>https://api.speedy.bg/</li>
<li>https://services.speedy.bg/</li>
<li>BoxNow </li>
<li>https://api.bulgarisation.bg/</li>
<li>https://boxnow.bg/en/</li>
<li>https://widget-v5.boxnow.bg/</li>
<li>https://api-production.boxnow.bg/</li>
<li>https://api-stage.boxnow.bg/</li>
<li>CVC</li>
<li>https://lox.e-cvc.bg/</li>
</ul>
</li>
<li>
<p>Проверка за некоректни клиенти чрез услугата:</p>
<ul>
<li>connectix.bg</li>
<li>https://api-sandbox.connectix.bg/</li>
<li>https://api.connectix.bg/trackings</li>
<li>https://api.connectix.bg/shopper/check</li>
<li>https://api.connectix.bg/integration/register</li>
<li>nepostop.bg</li>
<li>https://nepostop.com/api/v1/phone-check</li>
<li>https://nepostop.com/api/v1/shipments</li>
</ul>
</li>
<li>
<p>При съгласие за подпомагане на разработката за плъгина се събира информация коя основна настройка е включена от плъгина към https://license.bulgarisation.bg/</p>
</li>
</ul>
<p>При работа с тези външни услуги могат да бъдат изпращани данни като: име и адрес на получателя, телефон, имейл, стойност на поръчката, наложен платеж, както и друга информация, необходима за създаване на товарителници и/или проверка на коректността на клиента. Данните се изпращат единствено с цел обработка и доставка на поръчката и проверка за потенциални злоупотреби.</p>


Bulgarisation for WooCommerce

Този плъгин ви улеснява живота и то безплатно! Задължителен, ако продавате в България!

Страхотен плъгин


Решава страшно много проблеми !


Супер е


Благодаря за полезният плъгин и за съдействието с някои бъгове :)


Благодаря за плъгина и поддръжката

Всичко необходимо за вашият онлайн магазин за България. Включва облекчен режим за Наредба - H-18 и методи за доставка с Еконт, CVC и Спиди.

drusoftltd

<p><strong>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>
<h4>Important Compatibility Note</h4>
<p>This plugin is currently <strong>not compatible</strong> with the WooCommerce Block Cart and Block Checkout pages. Please ensure your store uses the classic shortcode-based Cart (<code>[woocommerce_cart]</code>) and Checkout (<code>[woocommerce_checkout]</code>) pages.</p>
<h4>For Your Customers</h4>
<ul>
<li><strong>Dynamic Checkout Experience</strong> — Real-time city and office selection directly on the checkout page.</li>
<li><strong>Multiple Delivery Types</strong> — Choose between delivery to Address, Speedy Office, or Speedy Automat (APS).</li>
<li><strong>Smart Street Search</strong> — Built-in autocomplete for Bulgarian street names with intelligent prefix handling (e.g., stripping “ул.”, “бул.”).</li>
<li><strong>Live Service Selection</strong> — Customers can choose between available services (Economy, Express, etc.) with real-time price updates.</li>
<li><strong>Region Mapping</strong> — Automated city filtering based on the selected Bulgarian province.</li>
</ul>
<h4>For Merchants</h4>
<ul>
<li><strong>HPOS Compatible</strong> — Fully supports WooCommerce High-Performance Order Storage.</li>
<li><strong>Automated Data Sync</strong> — Uses Action Scheduler to keep Bulgarian cities and Speedy offices up-to-date in the background.</li>
<li><strong>Credential Validation</strong> — Validates API credentials in real-time before saving.</li>
<li><strong>Custom Pricing</strong> — Support for custom pricing CSV files for specialized shipping rates.</li>
<li><strong>Advanced Order Management</strong> — Dedicated metabox in the order edit screen, integrated waybill generation, and bulk actions for managing multiple Speedy orders.</li>
<li><strong>Clean Codebase</strong> — Built with modern PHP standards and conflict-free architecture.</li>
</ul>
<h3>External Services</h3>
<p>This plugin relies on the <strong>Speedy REST API</strong>, a third-party service provided by <strong>Speedy AD</strong> (Speedy Bulgaria), to deliver its shipping functionality. The plugin cannot operate without a valid Speedy API account.</p>
<h4>What the service is</h4>
<p>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>
<h4>What data is sent and when</h4>
<ul>
<li><strong>API credentials</strong> (username and password) — sent with every API request for authentication.</li>
<li><strong>Recipient address data</strong> (city, street, office ID) — sent when calculating shipping rates at cart/checkout and when creating a waybill after order placement.</li>
<li><strong>Shipment details</strong> (weight, dimensions, COD amount, service type, sender/recipient info) — sent when generating a waybill.</li>
<li><strong>Waybill ID</strong> — sent when cancelling a shipment, requesting a courier pickup, or printing a waybill label.</li>
<li><strong>Location queries</strong> (city name, street name) — sent when the customer or admin searches for cities, offices, or streets.</li>
</ul>
<p>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>
<h4>Service links</h4>
<ul>
<li>Speedy API base URL: <a href="https://api.speedy.bg/v1/" rel="nofollow ugc">https://api.speedy.bg/v1/</a></li>
<li>Speedy Terms and Conditions: <a href="https://www.speedy.bg/en/general-conditions" rel="nofollow ugc">https://www.speedy.bg/en/general-conditions</a></li>
<li>Speedy Privacy Policy: <a href="https://www.speedy.bg/en/privacy-policy" rel="nofollow ugc">https://www.speedy.bg/en/privacy-policy</a></li>
<li>Speedy API Documentation: <a href="https://api.speedy.bg/" rel="nofollow ugc">https://api.speedy.bg/</a></li>
</ul>
<h3>Speedy API Endpoints</h3>
<p>This plugin communicates with the <strong>Speedy REST API v1</strong> (<code>https://api.speedy.bg/v1/</code>). All requests are authenticated using the <code>userName</code> and <code>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>
<h4>Authentication & Account</h4>
<ul>
<li><strong><code>POST /v1/client/contract</code></strong> — 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>
<li><strong><code>POST /v1/client/contract/info</code></strong> — 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>
</ul>
<h4>Location Data</h4>
<ul>
<li><strong><code>POST /v1/location/site</code></strong> — Searches for cities/sites by name within Bulgaria (<code>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>
<li><strong><code>POST /v1/location/site/csv/100</code></strong> — Downloads the complete list of Bulgarian cities in CSV format. Used by the background syncer (<code>Drushfo_Syncer</code>) to populate and update the <code>wp_drushfo_cities</code> database table via Action Scheduler.</li>
<li><strong><code>POST /v1/location/office</code></strong> — Retrieves all Speedy offices and automats for Bulgaria. Used in two contexts: (1) the background syncer updates the <code>wp_drushfo_offices</code> table, and (2) the admin Select2 office search for configuring the sender office.</li>
<li><strong><code>POST /v1/location/street</code></strong> — Searches for streets within a specific city (<code>siteId</code>). Used on the checkout page to provide street autocomplete when the customer selects “Delivery to Address.”</li>
</ul>
<h4>Services & Pricing</h4>
<ul>
<li><strong><code>POST /v1/services</code></strong> — 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>
<li><strong><code>POST /v1/calculate</code></strong> — 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>
</ul>
<h4>Shipment Management</h4>
<ul>
<li><strong><code>POST /v1/shipment/</code></strong> — 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>
<li><strong><code>POST /v1/shipment/cancel</code></strong> — 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>
<li><strong><code>POST /v1/pickup</code></strong> — 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>
<li><strong><code>POST /v1/print</code></strong> — 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>
</ul>
<h4>Rate Limiting & Caching</h4>
<p>The plugin minimizes API calls through several strategies:</p>
<ul>
<li><strong>Local database tables</strong> — Cities and offices are synced periodically via Action Scheduler and queried locally, avoiding per-request API calls for location data.</li>
<li><strong>Transient caching</strong> — Service lists, contract data, and client information are cached using WordPress transients to reduce redundant API calls.</li>
<li><strong>Session storage</strong> — Cart selections (city, delivery type, office) are stored in the WooCommerce session, so shipping calculations reuse the customer’s choices without extra lookups.</li>
</ul>


Drusoft Shipping for Speedy

A clean, conflict-free Speedy integration for WooCommerce stores in Bulgaria.

Bulgarisation for WooCommerce vs Drusoft Shipping for Speedy