Error handling
When a Számla Agent request fails (e.g. invoice or receipt is not created), the cause is usually in the request data or parameters. Sending the same request again without changing anything will not resolve the problem.
Do not program your system to retry failed requests automatically until success. Real cases have led to tens of thousands of duplicate requests overnight and overloaded servers. If a request fails, fix the request (or wait for human/operator action), then try again with a corrected call.
During the testing phase, do not generate more than 100 invoices per hour in the testing environment. For details on creating and using the test account (the user can turn it on and off), see the knowledge base.
Retry limit
You may send the same request to Számla Agent at most five times. If all five attempts are unsuccessful, you must stop and contact the operator of your webshop (or the responsible person). Do not continue with that invoice/receipt until the issue is resolved by human intervention.
Számla Agent is not responsible if an invoice or receipt could not be generated. Repeated violations of these rules (e.g. excessive retries or unnecessary server load) may result in banning the calling party from the service.
Error codes and messages
Look up the code returned in the response below and adjust your request or process accordingly. The first column is the error code, the second is the message received in the response (in Hungarian), and the last column has the English translation and explanation.
| CODE | DESCRIPTION | TRANSLATION |
|---|---|---|
1 | Rendszerkarbantartás, kérem próbálja meg pár perc múlva. | System Maintenance, please try again in a few minutes. Internal error in Számla Agent. No action is required from the webshop, the maintenance team of Számlázz.hu is notified and will take action. |
3 | Sikertelen bejelentkezés | Login error. Invalid login name or password. |
53 | Hiányzó XML fájl. | Missing XML file. The XML was probably not sent as a file, but as an input content of an HTML. |
54 | E-számla készítés nincs engedélyezve. | The issuing of e-invoices is not permitted. Your subscription package probably does not contain it, or there is no own certificate uploaded. In this case, you need to accept that KBOSS.hu Kft. can use its own certificate for the invoices. |
55 | E-számla aláírása sikertelen. | E-invoice signature was unsuccessful. Either your certificate expired or the timestamp server could not be reached. |
57 | XML beolvasási hiba. | XML reading error. There is an error in the sent XML file. The response body contains more information. |
135 | Számla Agent futtatásához kérjük böngészőkében lépjen ki a Számlázz.hu rendszerből | In order to run Számla Agent, please log out from Számlázz.hu in your browser. This can happen in case you are logged in to Számlázz.hu in one browser window and in another you are testing the XML with the test HTML file or a curl POST request. |
136 | Bejelentkezési hiba ... Kérjük lépjen be a Számlázz.hu rendszérbe böngészőn keresztül. | Login error ... Please log in to the Számlázz.hu system via a browser. Possible reasons: the subscription has expired; there is a pending invoice towards Számlázz.hu; there is a delay in payment. In these cases please log in to Számlázz.hu and check your subscription in the menu "Díjcsomagom". |
164 | Ezt a funkciót csak olyan felhasználó veheti igénybe, aki egyetlen Számlázz.hu-s fiókhoz férhet hozzá. Több fiókhoz történő hozzáférés kizárja a funkció használatát. | The user is allowed to access only one company's billing account. If the user has access to more than one billing account, the operation will fail. Consider using an Agent key for authentication. |
202 | A megadott számlaszám előtag nem megfelelő. Agent használat során, csak a Számlázz.hu rendszerében korábban regisztrált előtagokat lehet használni. | The provided invoice prefix cannot be used. For Számla Agent, you can only use prefixes that have been previously registered in the Számlázz.hu. Log in to the website and add the desired prefixes before you can use them with Számla Agent. |
259 | A tétel nettó értéke nem megfelelő; nettó érték = nettó egységár x mennyiség. Termék: ** | The NET value of the item is not correct; NET value = NET unit price * quantity. Product: Your values don't fit into this formula, please verify and fix the NET value. The response body contains the name of the wrong product after the "Termék" word. |
260 | A tétel áfa értéke nem megfelelő; áfa érték = tétel nettó értéke x áfakulcs mértéke / 100. Termék: ** | The VAT value of the item is not correct; VAT value = NET price of item * VAT rate / 100. Product: Your values don't fit into this formula, please verify and fix the VAT value. The response body contains the name of the wrong product after the "Termék" word. |
261 | A tétel bruttó értéke nem megfelelő; bruttó érték = tétel nettó értéke + tétel áfa értéke. Termék: ** | The gross value of the item is not correct; gross value = NET value of item + VAT value of item. Product: Your values don't fit into this formula, please verify and fix the gross value. The response body contains the name of the wrong product after the "Termék" word. |
262 | A tétel nettó értéke nem megfelelő; nettó érték = nettó egységár x mennyiség. Termék: ** | The NET value of the item is not correct; NET value = NET unit price * quantity. Product: Your values don't fit into this formula, please verify and fix the NET value. The response body contains the row number of the wrong product after the "Termék" word. |
263 | A tétel áfa értéke nem megfelelő; áfa érték = tétel nettó értéke x áfakulcs mértéke / 100. Termék: ** | The VAT value of the item is not correct; VAT value = NET price of item * VAT rate / 100. Product: Your values don't fit into this formula, please verify and fix the VAT value. The response body contains the row number of the wrong product after the "Termék" word. |
264 | A tétel bruttó értéke nem megfelelő; bruttó érték = tétel nettó értéke + tétel áfa értéke. Termék: ** | The gross value of the item is not correct; gross value = NET value of item + VAT value of item. Product: Your values don't fit into this formula, please verify and fix the gross value. The response body contains the row number of the wrong product after the "Termék" word. |
537 | Agent-en maximálisan 400 törlőkód adható egy tételhez. | The number of data erasure codes that can be requested for an item has been reached. The error message always informs you of the maximum number of data eraser codes. |
538 | Adattörlő kód demo-ban és tesztfiókban nem használható. | Data deletion code cannot be used in demo and test accounts. |
539 | Nincs bekapcsolva az adattörlőkód használata a beállítások menüben | Use of the data deletion code is not enabled in the settings menu. You must enable the Data Eraser code in the Billing settings menu. |