Sending requests

Base URL and form field

You need to send the requests to the same URL every time: https://www.szamlazz.hu/szamla/. Számla Agent decides which function to perform using the name of the form field containing the XML file in the HTTPS request. The following table contains the field names for each function.

Function	Form field name
Generate invoice	action-xmlagentxmlfile
Reverse invoice	action-szamla_agent_st
Register credit entry	action-szamla_agent_kifiz
Query document (PDF)	action-szamla_agent_pdf
Query document (XML)	action-szamla_agent_xml
Delete pro forma invoice	action-szamla_agent_dijbekero_torlese
Create receipt	action-szamla_agent_nyugta_create
Reverse receipt	action-szamla_agent_nyugta_storno
Query receipt	action-szamla_agent_nyugta_get
Send receipt	action-szamla_agent_nyugta_send
Query taxpayer	action-szamla_agent_taxpayer

Requirements

Your system needs to send an XML file in an HTTPS POST request to Számlázz.hu. This XML file has to contain the controlling parameters and the data that is necessary to perform the given Számla Agent function. Do not forget to handle session cookies.

The request/response pairs of the given Számla Agent call types (new invoice, reverse invoice, query pdf, etc.) are described in the corresponding operation pages.

Use multipart/form-data as the content type for the POST request.

One XML per document

Each XML file contains the information of a single invoice or receipt only. You cannot include details of multiple invoices (or receipts) in one XML file.

Testing

During the testing phase, a limit applies to the number of invoices per hour in the testing environment. See Error handling for the limit and how to use the test account (can be turned on and off by the user).

Multiple websites (invoice prefix)

The Számlázz.hu user can be used for the Agent by multiple websites. If you would like to separate invoices by webshop, configure a separate invoice prefix (szamlaszamElotag) for each of them.