Gabor Angyal

<p>Integration for Számlázz.hu and FluentCart is a WordPress plugin that seamlessly connects your FluentCart store with Számlázz.hu, automatically generating professional invoices when orders are paid.</p>
<h3>External Services</h3>
<p>This plugin relies on the Számlázz.hu invoice generation service to create and manage invoices for FluentCart orders.</p>
<p><strong>Service Information:</strong><br />
* <strong>Service Provider:</strong> Számlázz.hu (szamlazz.hu)<br />
* <strong>Service Purpose:</strong> The plugin connects to Számlázz.hu’s Agent API to automatically generate invoices, fetch taxpayer information from the Hungarian Tax Authority (NAV), and retrieve generated invoice PDFs.</p>
<p><strong>Data Transmission:</strong></p>
<p>The plugin sends the following data to https://www.szamlazz.hu/szamla/ when:</p>
<ol>
<li>
<p><strong>Generating Invoices</strong> (when an order is marked as paid):</p>
<ul>
<li>Your Számlázz.hu Agent API Key</li>
<li>Order information: order number, dates, amounts, currency</li>
<li>Buyer information: name, email, address, postal code, city, country</li>
<li>Buyer’s VAT/tax number (if provided)</li>
<li>Product details: names, quantities, prices, VAT rates</li>
<li>Shipping information: title, amount, VAT rate</li>
<li>Invoice settings: language, type (paper/electronic)</li>
</ul>
</li>
<li>
<p><strong>Fetching Taxpayer Data</strong> (when a Hungarian VAT number is provided):</p>
<ul>
<li>Your Számlázz.hu Agent API Key</li>
<li>The taxpayer’s 8-digit tax identification number (truncated from the full VAT number)</li>
</ul>
</li>
<li>
<p><strong>Downloading Invoice PDFs</strong> (when users click to download invoices):</p>
<ul>
<li>Your Számlázz.hu Agent API Key</li>
<li>The invoice number</li>
</ul>
</li>
</ol>
<p><strong>Legal Information:</strong><br />
* Számlázz.hu Terms of Service: https://www.szamlazz.hu/aszf/<br />
* Számlázz.hu Privacy Policy: https://www.szamlazz.hu/adatvedelem/</p>
<p><strong>Important:</strong> By using this plugin, you agree to transmit your store and customer data to Számlázz.hu. 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 Számlázz.hu 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 Számlázz.hu 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 Számlázz.hu</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>Számlázz.hu charges for API usage.</strong> This plugin uses the Számlázz.hu Agent API to generate invoices automatically, which is a paid service. Review the <a href="https://www.szamlazz.hu/egyedi-megoldasok/tomeges-szamlageneralas/" rel="nofollow ugc">Számlázz.hu 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 > Számlázz.hu</strong></li>
<li>Enter your Számlázz.hu Agent API Key (<a href="https://tudastar.szamlazz.hu/gyik/kulcs" 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-szamlazzhu-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-szamlazzhu-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 Számlázz.hu and FluentCart

Automatically generates invoices on Számlázz.hu for FluentCart orders with VAT validation and multi-language support.

Viszt Péter

<blockquote>
<p><strong>PRO verzió</strong><br />
  A bővítménynek elérhető a PRO verziója 10.000 Ft-ért, amelyet itt vásárolhatsz meg: <a href="https://visztpeter.me/" rel="nofollow ugc">https://visztpeter.me/</a><br />
  A licensz kulcs egy weboldalon aktiválható és 1 év emailes support is jár hozzá beállításhoz, testreszabáshoz, konfiguráláshoz.<br />
  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.</p>
</blockquote>
<h4>Funkciók</h4>
<ul>
<li><strong>Manuális számlakészítés</strong><br />
Minden bejegyzésnél a jobb oldalon megjelenik egy új gomb, rákattintáskor elküldi az adatokat számlázz.hu-nak és legenerálja a számlát.</li>
<li><strong>Automata számlakészítés</strong></li>
<li><strong>E-Nyugta</strong><br />
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 elekronikus nyugtát készít<br />
Lehetőség van a számlát automatikusan elkészíteni bizonyos fizetési módoknál</li>
<li><strong>Mennyiségi egység</strong><br />
A tételek mellett a mennyiségi egységet is feltüntetni a számlát</li>
<li><strong>Számlaértesítő</strong><br />
Az ingyenes verzióban a számlázz.hu küldi ki a számlaértesítőt a vásárlónak. Automata számlakészítéskor az űrlap visszaigazolásába beszúrható a generált PDF fájl linkje.</li>
<li><strong>Nemzetközi számla</strong><br />
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.</li>
<li><strong>Díjbekérő számla</strong><br />
Fizetési módtól függően beállítható, hogy díjbekérő készüljön el automatikusan.</li>
<li><strong>Teljesítettnek jelölés</strong><br />
Automatán teljesítettnek jelölheti a számlát a beállított feltételek szerint</li>
<li><strong>Naplózás</strong><br />
Minden számlakészítésnél létrehoz egy megjegyzést a bejegyzéshez, hogy mikor, milyen néven készült el a számla</li>
<li><strong>Sztornózás</strong><br />
A számla sztornózható a bejegyzés oldalon</li>
<li><strong>És még sok más</strong><br />
Papír és elektronikus számla állítás, Áfakulcs állítás, Számlaszám előtag módosítása, figyelmeztetés hibás számlakészítésről stb…</li>
</ul>
<h4>Fontos kiemelni</h4>
<ul>
<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/gf_szamlazz mappában</li>
<li>Fizetési határidő és megjegyzés írható a számlákhoz</li>
<li>Szállítást is ráírja a számlára</li>
<li>A PDF fájl letölthető egyből a Bejegyzések oldalról is(táblázat utolsó oszlopa)</li>
</ul>
<h4>Használat</h4>
<p>Részletes dokumentációt <a href="https://visztpeter.me/dokumentacio/" rel="nofollow ugc">itt</a> találsz.<br />
Telepítés után a Gravity Froms / Beállítások / Számlázz.hu oldalon meg kell adni a szamlazz.hu felhasználónevet és jelszót.<br />
Az űrlap beállításainál a Számlázz.hu opció alatt hozz létre egy új Feed-et és állítsd be értelem szerűen. Itt kell például összepárosítanod az űrlapod mezőit a számlán megjelenő adatokkal.<br />
Minden bejegyzé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.<br />
A bejegyzés létrehozásakor, ha volt sikeres fizetés, automatán létrejöhet a számla.<br />
Az elkészült számla a bejegyzés aloldalán és a bejegyzés listában az utolsó oszlopban található PDF ikonra kattintva letölthető.</p>
<p><strong>FONTOS:</strong> 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.</p>
<h4>Fejlesztőknek</h4>
<p>A plugin egy XML fájlt generál, ezt küldi el a szamlazz.hu-nak, majd az egy pdf-ben visszaküldi az elkészített számlát. Az XML fájl generálás előtt módosítható a <code>gf_szamlazz_xml</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!</p>


Integration for Szamlazz.hu & Gravity Forms

Számlázz.hu összeköttetés Gravity Forms-hoz.

Integration for Számlázz.hu and FluentCart vs Integration for Szamlazz.hu & Gravity Forms