Sellissimo

Issue Hungarian invoices with Számlázz.hu

Connect Számla Agent, issue an invoice from a HUF order, and retrieve its original PDF. Pro can issue invoices when payment or dispatch is confirmed.

Browse guides
On this page

Use Számlázz.hu to invoice domestic HUF orders for individuals and Hungarian businesses. Free includes manual issuance, original PDFs and corrections. Pro adds automatic issuance, optional invoice notification emails and a site-wide list of orders requiring attention. Számlázz.hu charges its own Számla Agent fees in either edition. Magyar kezelési útmutató · Számla Agent fees

Install the add-on#

The Free and Pro editions use the same package. It requires Statamic 6, PHP 8.3 or later in the 8.x series, and Sellissimo Core 1.0.1 or later in the 1.x series. Run the Composer command from the root of your Statamic site.

composer require sellissimo/szamlazz-hu-invoicing

On a new store, install Sellissimo Core with php please sellissimo:install. On an existing store, back up the commerce database and apply pending Core migrations. Apply the invoicing migration on both new and existing stores. If you use a custom Sellissimo database connection, replace sellissimo below with the configured connection name.

php artisan migrate --database=sellissimo --path=vendor/sellissimo/core/database/migrations --force
php artisan migrate --database=sellissimo --path=vendor/sellissimo/szamlazz-hu-invoicing/database/migrations --force

Keep the application's encryption key backed up with your private store data. The add-on uses it to protect Agent credentials and saved invoice details. Packagist package · Source and releases

Connect a test account#

  1. In Store → Settings → Számlázz.hu, select the Statamic site and Test account. Enter the Agent key from a dedicated Számlázz.hu test account. Test and live accounts use the same provider endpoint, so the account that issued the key matters.
  2. Set the document language, payment term and invoice format. Select the invoice VAT code for each tax class used on this site, including any class used for shipping or fees. Check the treatment against the rates configured in Sellissimo.
  3. Enter the payment name to print beside each checkout gateway, such as Bankkártya for a card payment. Save before placing the order. The add-on records the buyer, rates, payment labels and issuing account at checkout.
  4. Give staff access to the site and View invoices and PDFs. Staff who issue or correct invoices also need Issue, adjust and reconcile invoices. Reserve Manage invoice settings and Agent keys for those who maintain the account.

When the test is complete, select Live account and save the live account's own Agent key. On subsequent edits you can leave the key blank to retain the one saved for the selected mode. Provider test accounts · Set up tax classes

Issue the first invoice and open the PDF#

Place a new HUF order with a complete Hungarian billing address. Select individual or business at checkout. For a business, supply its registered name and Hungarian tax number. The local payment simulator can mark a test order as paid.

Open Store → Orders, select the order, then open Számlázz.hu → Invoice documents. Set the date of supply and payment due date, then select Review document. Check the account mode, recipient, payment status, line VAT and gross total. Select Issue invoice once the preview matches the sale. The order records the provider's invoice number. Select Open original PDF to view or download the document.

Older orders may lack the tax or buyer details captured by the add-on. For an eligible invoice issued directly in Számlázz.hu, record the Sellissimo order reference on the invoice, then use Verify and link on the order with the exact provider invoice number. Handle foreign currency, cross-border sales, vouchers and unresolved tax treatments separately.

Automate new invoices with Pro#

The installation defaults to Free. To activate Pro, set SELLISSIMO_SZAMLAZZ_PRO=true in the site's deployment environment. If your site explicitly sets the add-on's edition in config/statamic/editions.php, set its sellissimo/szamlazz-hu-invoicing entry under addons to pro. Refresh cached configuration and restart long-running queue workers after changing the edition.

Check that the settings page shows Pro, then enable automation for the selected site. Choose confirmed payment to issue after the payment succeeds or staff record cash collection. Choose final dispatch for physical orders to issue when the last parcel leaves, using its payment status at dispatch. Digital-only orders use confirmed payment. Enable the optional provider notification to ask Számlázz.hu to email the invoice to the buyer.

Run the Laravel scheduler and a queue worker for background processing. Automation starts with eligible new orders. Returning to Free pauses unsent automatic jobs and retains access to existing PDFs. Production checklist

Review a correction or uncertain submission#

Open the issued invoice to review a linked correction or reversal. For a full cancellation after a correction, the next correction credits the remaining balance. Both editions require staff approval for each adjustment. Pro flags settled refunds and applied order changes in Invoices requiring attention.

If the provider response is lost, use the order's lookup action. The provider may already have issued the document. For a reversal, use the exact reversal number from the issuing account. Check the document register and reconcile the existing operation before deciding whether to retry. Order refunds

All guides in Orders and customers