Gabor Angyal

<p>Integration for Billingo and FluentCart is a WordPress plugin that seamlessly connects your FluentCart store with Billingo, automatically generating professional invoices when orders are paid.</p>
<h3>External Services</h3>
<p>This plugin relies on the Billingo invoice generation service to create and manage invoices for FluentCart orders.</p>
<h4>Service Information</h4>
<ul>
<li>Service Provider: Billingo (billingo.hu)</li>
<li>Service Purpose: The plugin connects to Billingo’s API to automatically generate invoices, fetch taxpayer information from the Hungarian Tax Authority (NAV), and retrieve generated invoice PDFs.</li>
</ul>
<h4>Data Transmission</h4>
<p>The plugin sends the following data to https://api.billingo.hu/v3:</p>
<p><strong>Generating Invoices</strong> (when an order is marked as paid):</p>
<p>Calls these endpoints:<br />
* <code>GET /utils/check-tax-number/{tax_number}</code> – Validates taxpayer data<br />
* <code>GET /partners?query={tax_number}</code> – Searches for existing partners by tax number<br />
* <code>POST /partners</code> – Creates new partner if not found<br />
* <code>GET /document-blocks?type=invoice</code> – Retrieves available invoice pads<br />
* <code>POST /documents</code> – Creates the invoice document</p>
<p>Data transmitted:<br />
* Your Billingo API Key<br />
* Order information: order number, dates, amounts, currency<br />
* Buyer information: name, email, address, postal code, city, country<br />
* Buyer’s VAT/tax number (if provided)<br />
* Product details: names, quantities, prices, VAT rates<br />
* Shipping information: title, amount, VAT rate<br />
* Invoice settings: language, type (paper/electronic), payment method</p>
<p><strong>Fetching Taxpayer Data</strong> (when a Hungarian VAT number is provided):</p>
<p>Calls these endpoints:<br />
* <code>GET /utils/check-tax-number/{tax_number}</code> – Validates Hungarian tax identification number</p>
<p>Data transmitted:<br />
* Your Billingo API Key<br />
* The taxpayer’s tax identification number (in format 12345678-1-23)</p>
<p><strong>Downloading Invoice PDFs</strong> (when users click to download invoices):</p>
<p>Calls these endpoints:<br />
* <code>GET /documents/vendor/{order_id}</code> – Retrieves document by order ID<br />
* <code>GET /documents/{document_id}/download</code> – Downloads the invoice PDF</p>
<p>Data transmitted:<br />
* Your Billingo API Key<br />
* The order ID and document ID</p>
<h4>Legal Information</h4>
<ul>
<li>Billingo Terms of Service: https://www.billingo.hu/felhasznalasi-feltetelek</li>
<li>Billingo Privacy Policy: https://www.billingo.hu/adatkezelesi-tajekoztato</li>
</ul>
<p><strong>Important:</strong> By using this plugin, you agree to transmit your store and customer data to Billingo. Ensure you have proper consent from your customers and comply with applicable data protection regulations (GDPR, etc.).</p>
<h4>Key Features</h4>
<ul>
<li><strong>Automatic Invoice Generation</strong> – Invoices are automatically created when orders are marked as paid</li>
<li><strong>Download Invoices</strong> – Every receipt download button is overriden with Billingo invoice download.</li>
<li><strong>Multi-language Support</strong> – Generate invoices in 11 languages: Hungarian, English, German, Italian, Romanian, Slovak, Croatian, French, Spanish, Czech, Polish</li>
<li><strong>Invoice Types</strong> – Choose between Paper Invoice and E-Invoice formats</li>
<li><strong>VAT Number Validation</strong> – Automatically fetches company data from NAV (Hungarian Tax Authority) when VAT number is provided</li>
<li><strong>Customizable Settings</strong> – Configure invoice language, type, quantity units, and shipping details</li>
<li><strong>Shipping VAT Management</strong> – Easily set and apply VAT rates for shipping</li>
<li><strong>Cache Management</strong> – Built-in cache system with easy cleanup</li>
<li><strong>Bilingual Admin Interface</strong> – Full support for English and Hungarian languages</li>
<li><strong>Subscription Support</strong> – Automatically generates invoices for subscription renewals</li>
</ul>
<h4>Requirements</h4>
<ul>
<li>WordPress 5.0 or higher</li>
<li>FluentCart plugin installed and activated</li>
<li>Active Billingo account with Agent API Key</li>
<li>PHP 7.4 or higher</li>
</ul>
<h4>Important Warnings</h4>
<p><strong>Before using this plugin in production:</strong></p>
<ol>
<li><strong>Enable Test Mode</strong> in both FluentCart and Billingo</li>
<li><strong>Generate test invoices</strong> to verify everything works correctly</li>
<li><strong>Consult with your accountant</strong> to ensure the plugin meets your accounting requirements</li>
<li><strong>Review all generated invoices</strong> for accuracy</li>
<li><strong>Test all edge cases</strong> relevant to your business</li>
</ol>
<p><strong>This plugin generates official accounting documents. Incorrect invoices can have legal and tax implications.</strong></p>
<h4>API Usage Costs</h4>
<p><strong>Billingo charges for API usage.</strong> This plugin uses the Billingo Agent API to generate invoices automatically, which is a paid service. Review the <a href="https://www.billingo.hu/szolgaltatasok/api" rel="nofollow ugc">Billingo pricing</a> before enabling automatic invoice generation.</p>
<h4>Limitations</h4>
<ul>
<li><strong>VAT Rates</strong>: Only explicit rates supported (0%, 5%, 18%, 27%). Named VAT keys (AAM, TAM, TEHK) are not supported.</li>
<li><strong>Document Types</strong>: Only Invoices can be generated. Receipts and Pro forma invoices are not supported.</li>
<li><strong>IPN</strong>: Instant Payment Notification is not yet supported.</li>
<li><strong>Lag</strong>: Customers might need to wait a few seconds on the order conrifmation page before being able to download the invoice.</li>
<li><strong>Shipping VAT</strong>: FluentCart shipping VAT may contain <strong>minor rounding errors</strong>. This is a known bug in FluentCart, which will be corrected in the following releases. The shipping VAT on the <strong>invoice is calculated correctly</strong> according to Hungarian legal regulations. This may cause a small difference (fraction of a Forint) between what the customer pays, and what appears on the invoice.</li>
</ul>
<h4>Language Support</h4>
<p>The admin interface is available in:<br />
* English (Default)<br />
* Hungarian (Magyar)</p>
<p>The interface language follows your WordPress language settings.</p>
<h4>Configuration</h4>
<ol>
<li>Navigate to <strong>Settings > Billingo</strong></li>
<li>Enter your Billingo Agent API Key (<a href="https://support.billingo.hu/content/951124273" rel="nofollow ugc">How to get API key</a>)</li>
<li>Configure invoice settings:
<ul>
<li>Invoice Language (default: Hungarian)</li>
<li>Invoice Type (Paper Invoice or E-Invoice)</li>
<li>Quantity Unit (default: “db”)</li>
<li>Shipping Title (default: “Szállítás”)</li>
<li>Shipping VAT Rate (default: 27%)</li>
</ul>
</li>
<li>Save settings</li>
</ol>
<h3>Additional Information</h3>
<h4>Troubleshooting for advanced users</h4>
<p>Enable <code>WP_DEBUG</code> to see debug information on each orders activity log.</p>
<h4>Support</h4>
<p>For general questions, please visit the <a href="https://webshop.tech/integration-for-billingo-fluentcart/" rel="nofollow ugc">plugin website</a>.<br />
Bug reports and feature requests can be submitted on the project’s <a href="https://github.com/agabor/integration-for-billingo-fluentcart" rel="nofollow ugc">GitHub</a> page.</p>
<h4>Contributing</h4>
<p>This plugin is open source. Contributions are welcome!</p>
<h4>Credits</h4>
<ul>
<li>Author: Gábor Angyal</li>
<li>Website: <a href="https://webshop.tech" rel="nofollow ugc">webshop.tech</a></li>
</ul>


Integration for Billingo and FluentCart

Automatically generates invoices on Billingo for FluentCart orders with VAT validation and multi-language support.

billingo

<h4>FUNKCIÓK</h4>
<p>A hivatalos Billingo plugin használata a Billingo előfizetési csomagokkal rendelkező felhasználók számára funkciókorlátozások nélkül elérhető.</p>
<p>Bővítményünk a 2.0.0-ás verziót követően már a V3-as Billingo API kapcsolatot használja, amelynek köszönhetően még jobbá tehetjük a pluginünket.</p>
<p>Korábbi verzió használata esetén átállási segédletünket itt találod: https://support.billingo.hu/content/797736961</p>
<ul>
<li>Manuális számla kiállítás – Amennyiben szereted ellenőrizni a rendeléseid a számla kiállítás előtt, lehetőséged van a számlák kiállítására egyesével. Minden beérkező rendelésnél a megjelenik majd a számlakészítés opció, ahol módosíthatsz a beállításokon is.</li>
<li>Díjbekérő készítés – Pluginünk segítségével dönthetsz úgy, hogy díjbekérőt küldesz a vásárlóidnak első körben. Ebben az esetben, a függőben lévő rendelési állapotban egy díjbekérőt küldünk ki, majd a befizetést követően egy számlát tudsz kiállítani a rendelésről. A díjbekérő készítést fizetési módonként is beállíthatod.</li>
<li>Automata számlakészítés – Az automatizmusok nagyban segíthetik az adminisztratív teendőid, emellett rengeteg időt spórolhatsz. A beállítási lehetőségek között megadhatod, hogy milyen rendelési állapotban kerüljenek kiállításra a számláid. Természetesen dönthetsz úgy, hogy elsőre csak piszkozatot készítesz, így lesz egy ellenőrzési lehetőséged is</li>
<li>Automatikus sztornózási lehetőség – Abban az esetben, ha a vásárlód visszamondja a rendelését, viszont már kiállítottad a számlát, lehetőséged van a felületről sztornózást indítani. Megadhatod, hogy melyik rendelési állapotban készítsünk neked sztornó számlát.</li>
<li>Számla típus választás – Kiválaszthatod, hogy vásárlóid számára hagyományos, vagy elektronikus számlát szeretnél kiállítani a webshopodból. Természetesen bármikor módosíthatsz, ha esetleg változtatni szeretnél.</li>
<li>Nyelvesítési opciók – Számláid Magyar, Angol, Német, Francia, Horvát, Olasz, Román és Szlovák nyelven egyaránt kiállíthatod. Ezen felül bekapcsolhatod azt is, hogy ha valaki a weboldaladtól eltérő nyelven használja a böngészőjét, az adott nyelven kerüljön kiállításra a számla. Ehhez az opcióhoz WPML és Woocommerce Multilingual bővítményre is szükség van.</li>
<li>Megjegyzések kezelése – Van lehetőséged arra, hogy globálisan adj megjegyzést a számláidhoz, de természetesen egyesével is tudod módosítani a kiállított számlák megjegyzéseit. Ezen felül hozzáadhatod a Barion tranzakciós fizetési azonosítót és a termékeid cikkszámát hozzáadhatod a tételek megjegyzéseihez is.</li>
<li>Adószámmal kapcsolatos funkciók – Bizonyos vásárlási esetekben előfordul, hogy az adószámot fel kell tüntetni a kiállított számlákon. Ennek a megadását a WooCommerce alapvetően nem teszi lehetővé, viszont bővítményünk segítségével a rendeléseknél bekérheted a vásárló adószámát, majd ezt a kiállított számlán könnyedén, automatikusan megjelenítjük számodra.</li>
<li>ÁFA beállítások – Nem a szokványos ÁFA beállításokat kell használnod? Esetlegesen vannak olyan tételek a termékeid között, amelyeket 0%-os ÁFA helyett AM vagy egyéb más jelöléssel helyettesítenél? Semmi gond, mert erre is tudunk megoldást nyújtani számodra. A beállításaidnál megadhatod, hogy az ÁFA felülírás a teljes termékpalettádra érvényes legyen, vagy csupán a 0%-os termékekre, ezen felül megadhatod azt is, hogy a szállítási díjakra vonatkozzon e a felülírás vagy sem. Természtesen, felsoroltuk neked azokat a választási lehetőségeket is a felületen, amellyel felülírhatod az alapértékeket.</li>
<li>Fizetési módok és kapcsolódó funkciók – A WooCommerceben telepített fizetési módok megjelennek a Billingo modulban. Minden fizetési módod mellett kiválaszthatod azt, hogy mi jelenjen meg a kiállított számlán. Tehát, ha például közvetlen banki utalással fizet valaki, beállíthatod, hogy a számlán a fizetés módja átutalás legyen. Ezen felül minden fizetési mód esetén beállíthatod azt is, hogy hozzunk e létre díjbekérőt, vagy ha az adott rendelés sikeres volt, fizetettnek jelöljük e a kiállított számlát/díjbekérőt. Tehát, ha online bankkártyával fizet a vásárlód, és sikeres a vásárlás, az automatikusan kiállított számla egyből fizetettként kerül kiállításra.</li>
<li>Kuponok használata – Abban az esetben, ha webáruházadban kuponokat is használsz, a kiállított számláidon ezek a kedvezmények is meg fognak jelenni. Ehhez csupán engedélyezned kell a webshopban a kuponhasználatot, majd a Billingo bővítmény ezt automatikusan feltünteti a számláidon.</li>
<li>Számla értesítő rendszer – A vásárlók tájékoztatása mindig elsődleges szempont a rendelésekkel kapcsolatosan. Ebből nem maradhat ki a számlázás sem. Az általunk készített bővítmény segítségével automatikusan e-mailben elküldheted a felhasználóidnak a kiállított díjbekérőket és számlákat egyaránt.</li>
<li>Rendelések kezelése – A rendelésektől kiállított számlák közvetlenül a rendeléskezelőből is megnyithatók. A PDF fájl letölthető a rendelési adatlapról. Minden számla készítésénél létrehozunk egy megjegyzést a rendeléshez, amin láthatod, hogy mikor és milyen sorszámmal készült el az adott számla.</li>
<li>Támogatás és hibakezelés – Bővítményünk fejlesztése során törekszünk arra, hogy minden jelzést megfelelően tudjunk kezelni. Ahhoz, hogy a bejelentéseknek könnyedén utána tudjunk járni, elhelyeztünk egy hibakereső kódot a pluginünkben. Ennek a kódnak és a naplófájloknak köszönhetően, kérdés esetén azonnali segítséget tudunk nyújtani számodra kollégáinkkal.</li>
</ul>
<h4>HASZNÁLAT</h4>
<p>Az összekötés a két felület között rendkívül egyszerű. Folyamatosan frissítjük felhasználói kézikönyvünkben az összekötésre vonatkozó segédletünket is, ahol lépésről lépésre mutatjuk be a bővítmény használatát.</p>
<p>A segédletet ide kattintva érheted el:https://support.billingo.hu/content/2996830214</p>
<p>Pár kiemelt pont a működéssel kapcsolatosan:<br />
*   Telepítést követően a WooCommerce/Beállítások menüpontban a Billingo fülön add meg a fiókodból kinyert API kulcsokat, majd ments rá a felületre.<br />
*   Állítsd be a számodra megfelelő opciókat a funkciólistában.<br />
*   Ezt követően a rendeléseidnél megjelenik jobboldalon egy számla szerkesztésre vonatkozó felület, itt manuálisan is ki tudod állítani a számláid rendelésenként.<br />
*   Amennyiben az automatikus számla készítést választottad, a rendelés megfelelő állapotba állítását követően (pl.: Teljesítve) kiállítjuk a számlát.<br />
*   Bizonyos rendelésenként az opciók gombra kattintva kikapcsolhatod a számlázást és adhatsz hozzá egyéni megjegyzést is.<br />
*   Választhatsz ki sztornó állapotot is, így, ha a megadott rendelési állapotra állítod a rendelés státuszát (Pl.: visszamondva), a sztornó számla automatikusan elkészül.</p>


Billingo Official for WooCommerce

Remek plugin, szinte minden fontos dolog könnyedén beállítható.
Fejlesztőknek lehetne benne valamivel több filter. Az ÁFA kapcsán például nehezen módosítható, ha egyedi beállítás szükséges.

Működő megoldás

Hivatalos Billingo összeköttetés WooCommerce-hez.

Integration for Billingo and FluentCart vs Billingo Official for WooCommerce