📄️ What is Számla Agent?
Számla Agent is an old and well-established Számlázz.hu API that has been in continuous operation since 2010. Its main purpose is to generate invoices and receipts, retrieve their data, send them and manage their payment. The service receives simple XML messages and is able to process them according to the information received:
📄️ How does Számla Agent work?
The mechanics of the system are shown in the image below. The case illustrated is a classic webshop purchase where a transaction document - invoice or receipt - is created and sent to the customer.
📄️ Agent user
A company (= a Számlázz.hu account belonging to an enterprise) using Számla Agent can be accessed by multiple users. We recommend to create a separate user for the Agent with "accounting” privileges. The e-mail address of this user will receive Agent usage error messages. Or user Számla Agent key (API KEY), generated from desktop. Read more here.
📄️ Agent Key
It is possible to use a generated Agent key for authentication instead of using our old method, a username and password in the sent XML. This means that it's no longer mandatory to use the username and password field, instead you can simply use the `` tag. (Self-billing and invoicing on behalf of a third party are exceptions.)
📄️ Error handling
There can be different reasons if Számla Agent does not create an invoice. Those reasons will not disappear without changing the call parameters in the XML.
📄️ Error messages and codes
The first column is the error code. The second is the error message received in the response (in Hungarian). The translated error message can be found in the last column with further explanation.
📄️ Session cookies
Számla Agent is optimized in a way that the caller side must take care of storing the session cookie and make sure that it is sent to Számla Agent during the call. One single user has to handle all Agent related actions in the webshop, so all the requests need to be handled by the same user.
📄️ XML sending
You need to send the requests to the same URL, that is, https://www.szamlazz.hu/szamla/every time. Számla Agent decides which function to perform using the name of the field containing the XML file in the HTTPS request. The following table contains the names which you can use to perform a given function.
📄️ Other details
Find out more about the way the Számla Agent works.