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

<p>Този плъгин добавя възможност за:</p>
<ul>
<li>Генериране на одиторски XML файл съобразно Наредба – H-18. </li>
<li>Проверка на цените в магазина за “Математически невъзможни цени с ДДС”.</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://pigeonexpress.com/" rel="nofollow ugc">Pigeon Express</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>За да използвате методи на доставка с Еконт/BOX NOW/Pigeon Express/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://api.bulgarisation.bg/</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>Pigeon Express</li>
<li>https://api.pigeonexpress.com/v1</li>
<li>https://api-demo.pigeonexpress.com/v1</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 Econt</strong> is a high-performance, conflict-free WooCommerce integration for Econt delivery services in Bulgaria. Real-time shipping rates, two-step waybill generation, courier pickup requests, and full order management — all through the official Econt API.</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, office, and automat (APS) selection directly on the checkout page.</li>
<li><strong>Multiple Delivery Types</strong> — Choose between delivery to Address, Econt Office, or Econt Automat (APS).</li>
<li><strong>Smart Street Search</strong> — Built-in autocomplete for Bulgarian street names with intelligent prefix handling (e.g. “ул.”, “бул.”).</li>
<li><strong>Region-Based City Filtering</strong> — Cities are filtered by the Bulgarian province selected at checkout.</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 Econt offices/automats up to date in the background.</li>
<li><strong>Waybill Management</strong> — Generate, print (PDF), and cancel waybills from the order edit screen.</li>
<li><strong>Courier Pickup Requests</strong> — Request a courier pickup directly from WP admin, with automatic skip of weekends and Bulgarian bank holidays.</li>
<li><strong>Dedicated Econt Orders Page</strong> — Filtered admin list of every Econt order with bulk Generate / Print / Cancel actions.</li>
<li><strong>Bulgarian (bg_BG) Translation Included.</strong></li>
</ul>
<h4>Also Ship via Speedy?</h4>
<p>This plugin has a sibling for the <strong>Speedy</strong> courier: <a href="https://wordpress.org/plugins/drusoft-shipping-for-speedy/" rel="ugc">Drusoft Shipping for Speedy</a>. Both plugins share the same checkout UI, settings layout, and admin order-management screens — once you’ve learned one, the other feels familiar. Install both if your store supports delivery via either courier.</p>
<h3>External Services</h3>
<p>This plugin relies on the <strong>Econt API</strong>, a third-party service provided by <strong>Econt AD</strong> (Econt Bulgaria), to deliver its shipping functionality. The plugin cannot operate without a valid Econt API account.</p>
<h4>What the service is</h4>
<p>Econt AD is a courier and logistics company operating in Bulgaria. Their JSON API allows merchants to calculate shipping rates, create shipments (waybills), manage deliveries, request courier pickups, and retrieve location data (cities, offices, automats, streets).</p>
<h4>What data is sent and when</h4>
<p>Authentication: every request is sent over HTTPS with an <code>Authorization: <private_key></code> header. The Store ID is only stored locally to identify the merchant in the WooCommerce settings and is not transmitted on every request.</p>
<ul>
<li><strong>Recipient address data</strong> (city, street, num, office/automat code, postcode, phone, email) — sent when calculating shipping rates on the cart/checkout page and when creating a waybill after order placement.</li>
<li><strong>Sender address data</strong> (name, phone, email, city, street, num) — sent when creating a waybill and when requesting a courier pickup.</li>
<li><strong>Shipment details</strong> (weight, COD flag, currency, package count, item descriptions) — sent when creating a waybill.</li>
<li><strong>Waybill identifiers</strong> (internal id, shipment number) — sent when cancelling a shipment, requesting a courier pickup, or generating an Air Waybill (AWB).</li>
<li><strong>Location queries</strong> (city ID, street name) — sent when the customer searches for cities, offices, automats, or streets, and during the daily background sync of the full Bulgarian nomenclature.</li>
</ul>
<p>Data is transmitted only when the corresponding action is triggered (a customer changes their selection on checkout, a merchant generates a waybill, the background sync runs, etc.).</p>
<h4>Service links</h4>
<ul>
<li>Econt API documentation (Shipments / Nomenclatures): <a href="https://ee.econt.com/services/" rel="nofollow ugc">https://ee.econt.com/services/</a></li>
<li>Econt Terms and Conditions: <a href="https://www.econt.com/en/general-conditions" rel="nofollow ugc">https://www.econt.com/en/general-conditions</a></li>
<li>Econt Privacy Policy: <a href="https://www.econt.com/en/privacy-policy" rel="nofollow ugc">https://www.econt.com/en/privacy-policy</a></li>
</ul>
<h3>Econt API Endpoints</h3>
<p>This plugin communicates with two Econt API hosts:</p>
<ul>
<li><strong><code>delivery.econt.com</code></strong> — Orders, payments, grouping (demo: <code>delivery-demo.econt.com</code>)</li>
<li><strong><code>ee.econt.com</code></strong> — Nomenclatures and Shipments (demo: <code>demo.econt.com/ee/</code>)</li>
</ul>
<p>All requests are authenticated with an <code>Authorization: <private_key></code> header.</p>
<h4>Location Data (Nomenclatures)</h4>
<ul>
<li><strong><code>POST /services/Nomenclatures/getCities.json</code></strong> — Full list of Bulgarian cities. Used by the background syncer to populate the local <code>wp_drushfe_cities</code> table.</li>
<li><strong><code>POST /services/Nomenclatures/getOffices.json</code></strong> — All Econt offices and automats (APS). Used by the background syncer to populate the local <code>wp_drushfe_offices</code> table.</li>
<li><strong><code>POST /services/Nomenclatures/getStreets.json</code></strong> — Streets within a specific city. Used by the checkout-page street autocomplete and cached per city in a 24h transient.</li>
</ul>
<h4>Pricing</h4>
<ul>
<li><strong><code>POST /services/OrdersService.getPrice.json</code></strong> — Calculates the shipping price for a recipient address, delivery type, and weight. Used live at cart/checkout each time the customer changes their selection.</li>
</ul>
<h4>Shipment Management</h4>
<ul>
<li><strong><code>POST /services/OrdersService.updateOrder.json</code></strong> — Creates a waybill draft. Used by the waybill generator on order status change or via the manual “Generate Waybill” action.</li>
<li><strong><code>POST /services/OrdersService.createAWB.json</code></strong> — Promotes a draft to a committed Air Waybill, returning the shipment number and PDF URL.</li>
<li><strong><code>POST /services/OrdersService.deleteLabel.json</code></strong> — Cancels a single waybill draft by internal id. Used by the per-order “Cancel Shipment” action.</li>
<li><strong><code>POST /services/Shipments/LabelService.deleteLabels.json</code></strong> — Bulk-cancels committed AWBs by shipment number. Used by the Econt Orders bulk “Cancel” action.</li>
<li><strong><code>POST /services/Shipments/ShipmentService.requestCourier.json</code></strong> — Requests a courier pickup for one or more shipments. Used from the per-order “Request Courier” action; auto-retries on national holiday rejections.</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 once per day via Action Scheduler and queried locally.</li>
<li><strong>Transient caching</strong> — Per-city street lists are cached for 24 hours.</li>
<li><strong>Session storage</strong> — Cart selections and the most recent shipping quote are stored in the WooCommerce session, so unchanged selections do not re-quote.</li>
</ul>


Drusoft Shipping for Econt

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

Bulgarisation for WooCommerce vs Drusoft Shipping for Econt