Gabor Angyal

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.
<h3>External Services</h3>
This plugin relies on the Billingo invoice generation service to create and manage invoices for FluentCart orders.
<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>
The plugin sends the following data to https://api.billingo.hu/v3:
Generating Invoices (when an order is marked as paid):
Calls these endpoints: 
* <code>GET /utils/check-tax-number/{tax_number}</code> – Validates taxpayer data 
* <code>GET /partners?query={tax_number}</code> – Searches for existing partners by tax number 
* <code>POST /partners</code> – Creates new partner if not found 
* <code>GET /document-blocks?type=invoice</code> – Retrieves available invoice pads 
* <code>POST /documents</code> – Creates the invoice document
Data transmitted: 
* Your Billingo API Key 
* Order information: order number, dates, amounts, currency 
* Buyer information: name, email, address, postal code, city, country 
* Buyer’s VAT/tax number (if provided) 
* Product details: names, quantities, prices, VAT rates 
* Shipping information: title, amount, VAT rate 
* Invoice settings: language, type (paper/electronic), payment method
Fetching Taxpayer Data (when a Hungarian VAT number is provided):
Calls these endpoints: 
* <code>GET /utils/check-tax-number/{tax_number}</code> – Validates Hungarian tax identification number
Data transmitted: 
* Your Billingo API Key 
* The taxpayer’s tax identification number (in format 12345678-1-23)
Downloading Invoice PDFs (when users click to download invoices):
Calls these endpoints: 
* <code>GET /documents/vendor/{order_id}</code> – Retrieves document by order ID 
* <code>GET /documents/{document_id}/download</code> – Downloads the invoice PDF
Data transmitted: 
* Your Billingo API Key 
* The order ID and document ID
<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>
Important: 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.).
<h4>Key Features</h4>
<ul>
<li>Automatic Invoice Generation – Invoices are automatically created when orders are marked as paid</li>
<li>Download Invoices – Every receipt download button is overriden with Billingo invoice download.</li>
<li>Multi-language Support – Generate invoices in 11 languages: Hungarian, English, German, Italian, Romanian, Slovak, Croatian, French, Spanish, Czech, Polish</li>
<li>Invoice Types – Choose between Paper Invoice and E-Invoice formats</li>
<li>VAT Number Validation – Automatically fetches company data from NAV (Hungarian Tax Authority) when VAT number is provided</li>
<li>Customizable Settings – Configure invoice language, type, quantity units, and shipping details</li>
<li>Shipping VAT Management – Easily set and apply VAT rates for shipping</li>
<li>Cache Management – Built-in cache system with easy cleanup</li>
<li>Bilingual Admin Interface – Full support for English and Hungarian languages</li>
<li>Subscription Support – 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>
Before using this plugin in production:
<ol>
<li>Enable Test Mode in both FluentCart and Billingo</li>
<li>Generate test invoices to verify everything works correctly</li>
<li>Consult with your accountant to ensure the plugin meets your accounting requirements</li>
<li>Review all generated invoices for accuracy</li>
<li>Test all edge cases relevant to your business</li>
</ol>
This plugin generates official accounting documents. Incorrect invoices can have legal and tax implications.
<h4>API Usage Costs</h4>
Billingo charges for API usage. 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.
<h4>Limitations</h4>
<ul>
<li>VAT Rates: Only explicit rates supported (0%, 5%, 18%, 27%). Named VAT keys (AAM, TAM, TEHK) are not supported.</li>
<li>Document Types: Only Invoices can be generated. Receipts and Pro forma invoices are not supported.</li>
<li>IPN: Instant Payment Notification is not yet supported.</li>
<li>Lag: Customers might need to wait a few seconds on the order conrifmation page before being able to download the invoice.</li>
<li>Shipping VAT: FluentCart shipping VAT may contain minor rounding errors. This is a known bug in FluentCart, which will be corrected in the following releases. The shipping VAT on the invoice is calculated correctly 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>
The admin interface is available in: 
* English (Default) 
* Hungarian (Magyar)
The interface language follows your WordPress language settings.
<h4>Configuration</h4>
<ol>
<li>Navigate to Settings > Billingo</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>
Enable <code>WP_DEBUG</code> to see debug information on each orders activity log.
<h4>Support</h4>
For general questions, please visit the <a href="https://webshop.tech/integration-for-billingo-fluentcart/" rel="nofollow ugc">plugin website</a>. 
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.
<h4>Contributing</h4>
This plugin is open source. Contributions are welcome!
<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.

Viszt Péter

<blockquote>
Ez nem a hivatalos Billingo bővítmény, viszont sokkal több funkciója van, így érdemes ezt is kipróbálnod.
PRO verzió 
 A bővítménynek elérhető a PRO verziója évi 30 €-ért, amelyet itt vásárolhatsz meg: <a href="https://visztpeter.me/woo-billingo-plus" rel="nofollow ugc">https://visztpeter.me/woo-billingo-plus</a> 
 A licensz kulcs egy weboldalon aktiválható, 1 évig érvényes és 1 év e-mailes support is jár hozzá beállításhoz, testreszabáshoz, konfiguráláshoz. 
 A vásárlással támogathatod a fejlesztést akkor is, ha esetleg a PRO verzióban elérhető funkciókra nincs is szükséged.
</blockquote>
<h4>Funkciók</h4>
<ul>
<li>
Számlakészítés 
Minden rendelésnél egy kattintással tudsz számlát létrehozni:
<ul>
<li>A generált számlát eltárolja a rendelés adataiban.</li>
<li>A generált számlát letölti saját weboldalra is, egy véletlenszerű fájlnéven tárolja a wp-content/uploads/wc_billingo_plus mappában</li>
<li>Fizetési határidő és megjegyzés írható a számlákhoz</li>
<li>Kuponokkal is működik, a számlán negatív tételként fog megjelenni</li>
<li>Szállítást is ráírja a számlára</li>
<li>A PDF fájl letölthető egyből a Rendelések táblázatból is, a műveletek, vagy a külön bekapcsolható Billingo oszlopból</li>
</ul>
</li>
<li>
Díjbekérő, előlegszámla, sztornó számla 
A Billingo által támogatott összes dokumentumtípust létre tudod hozni a rendeléseidhez.
</li>
<li>
Csoportos műveletek 
A rendeléskezelőben a csportos műveletekkel tudsz számlát létrehozni és egyben letölteni, vagy nyomtatni a számlákat.
</li>
<li>
Adószám mező 
A számlázási adatok között megjelenjenik egy új adószám mező. Az adószámot a rendszer validálja, eltárolja, a vásárlónak küldött emailben és a rendelés adatai között is megjelenik.
</li>
<li>
Naplózás 
A rendelés jegyzeteiben látod, hogy pontosan mikor és milyen dokumentumot hoztál létre.
</li>
<li>
Automata fizetettnek jelölés 
Beállítható, melyik fizetési módoknál hozzon létre már fizetett számlát.
</li>
<li>
Nemzetközi számla 
Ha külföldre értékesítesz például euróban, lehetőség van a számla nyelv átállítására és az aktuális MNB árfolyam feltüntetésére a számlán. Kompatibilis WPML-el, TranslatePress-el és Polylang-al is.
</li>
<li>
És még sok más 
Papír és elektronikus számla állítás, áfakulcs állítás, számlaszám előtag módosítása, letölthető számlák a vásárló profiljában, hibás számlakészítésről e-mailes értesítő stb…
</li>
</ul>
<h4>PRO verzióban elérhető</h4>
<ul>
<li>
Automata számlakészítés 
Lehetőség van számlát és egyéb dokumentumokat(díjbekérő, előlegszámla, sztornó számla) automatikusan a rendelés állapota szerint létrehozni, különböző feltételek alapján.
</li>
<li>
Számlaértesítő 
Az ingyenes verzióban a Billingo küldi ki a számlaértesítőt a vásárlónak. A PRO verzióban csatolni lehet a WooCommerce által küldött emailekhez a PDF számlát, így nem fontos használni a Billingo számlaértesítőjét és a vásárlód egyel kevesebb emailt fog kapni.
</li>
<li>
Banki átutalások automata kezelése 
A Billingo-s Bankszinkron funkció segítségével a díjbekérő kifizetettségéről értesítést kaphat a webáruház, ami után automatán teljesítettnek jelölheti a számlát.
</li>
<li>
Speciális áfakulcsok használata 
Különböző feltételek alapján beállíthatod, hogy bizonyos termékek milyen speciális áfakulccsal jelenjenek meg a számlán(EUKT, EUT, EUFADE stb…).
</li>
<li>
Csoportos műveletek 
A dokumentumok létrehozása művelettel nem csak számlát, hanem díjbekérőt, előlegszámlát és sztornó számlát is készíthetsz.
</li>
<li>
Adatok felülírása 
Feltételekkel módosíthatod a számlán megjelenő számlatömböt, nyelvet és bankszámlaszám adatokat.
</li>
<li>
E-Nyugta 
Ha elektronikus termékeket, jegyeket, letölthető tartalmakat értékesítesz, nem fontos bekérni a vásárló számlázási címét, elég csak az email címét, a bővítmény pedig elektronikus nyugtát készít.
</li>
<li>
Cégadatok kitöltése automatán 
Az adószám mezőt a NAV API-val validálja és a számlázási adatokat automatikusan kitölti.
</li>
<li>
EU adószám 
Az adószám mező elfogad EU adószámot is és automatikusan nettósítja a rendelést, ha sikerült validálni(a validáció a VIES API-n keresztül megy).
</li>
</ul>
<h4>Használat</h4>
Részletes dokumentációt <a href="https://visztpeter.me/dokumentacio/" rel="nofollow ugc">itt</a> találsz. 
Telepítés után a WooCommerce / Beállítások / Woo Billingo Plus oldalon meg kell adni az API V3 kulcsod. 
Minden rendelésnél jobb oldalon megjelenik egy új doboz, ahol egy gombnyomással létre lehet hozni a számlát. Az Opciók gombbal felül lehet írni a beállításokban megadott értékeket 1-1 számlához. 
Ha az automata számlakészítés be van kapcsolva, akkor automatikusan létrehozza a számlát a rendszer a rendelés állapotának változásakor. 
A számlakészítés kikapcsolható 1-1 rendelésnél az Opciók legördülőn belül. 
Az elkészült számla a rendelés aloldalán és a rendelés listában az utolsó oszlopban található PDF ikonra kattintva letölthető.
FONTOS: Mindenen esetben ellenőrizd le, hogy a számlakészítés megfelelő e és konzultálj a könyvelőddel, neki is megfelelnek e a generált számlák. Sajnos minden esetet nem tudok tesztelni, különböző áfakulcsok, termékvariációk, kuponok stb…, így mindenképp teszteld le éles használat előtt és ha valami gond van, jelezd felém és megpróbálom javítani.
<h4>Fejlesztőknek</h4>
A plugin a Billingo API-n keresztül küldi be az adatokat és készíti el a számlát. Az API hívás előtt módosítható a <code>wc_billingo_plus_partner</code> és a <code>wc_billingo_plus_invoice</code> filterrel. Ez minden esetben az éppen aktív téma functions.php fájlban történjen, hogy az esetleges plugin frissítés ne törölje ki a módosításokat! Bővebb fejlesztői dokumentációt <a href="https://visztpeter.me/dokumentacio/" rel="nofollow ugc">itt</a> találsz.

Billingo Plus integráció WooCommerce-hez

Billingo integráció WooCommerce-hez rengeteg extra funkcióval

Integration for Billingo and FluentCart vs Billingo Plus integráció WooCommerce-hez