DOCSEARCHbyAlgolia
Submit Docs

Számlázz.hu API Documentation

website·Indexed 37 days ago

https://docs.szamlazz.hu

API documentation for Számlázz.hu, covering invoice and receipt issuance, including standard, delegated, and self-billing models. Includes technical references for the Számla Agent, XML request structures, XSD schemas, and a PHP API available via Composer (kboss/szamlaagent v2).

Tokens
61.3K
Snippets
164
Records
374
Agent score
65%

What's inside Számlázz.hu

  1. Overview of Számlázz.hu Online Financial Data Connection

    The Online Financial Data Connection service allows Számlázz.hu to send data from invoices, receipts, and bank transactions to external systems (e.g., online accounting systems, CRM, ERP, or other business applications). The current version (v5.0) operates on a PUSH basis, meaning Számlázz.hu automatically initiates the transmission of data packages to registered receiving systems on a scheduled basis.

  2. Overview of Számla Agent PHP API usage

    The Számla Agent PHP API is designed to handle the complexities of XML generation and remote data connections. A typical implementation flow for creating or querying data involves four steps: 1. Setting up the Agent with Számlázz.hu account credentials (username and password), 2. Configuring the data to be sent (such as invoices or receipts), 3. Sending the request to Számlázz.hu, and 4. Processing the resulting success or error response.

  3. Overview of Számla Agent API

    Számla Agent is an API interface for Számlázz.hu designed for developers and IT professionals to 100% automate invoicing, receipting, and related operations. It provides a simple, fast, and reliable way to integrate invoicing workflows into external systems.

  4. Overview of outgoing invoice transfer to external systems

    Számlázz.hu uses a push-based mechanism to transfer invoices and PDFs to an external system. When an invoice is issued or updated in Számlázz.hu, the system sends a message to a pre-configured receiving URL. The receiving system cannot query the data; it must wait for the push notification. To enable this, two additional parameters (the receiving URL for outgoing invoices) must be provided during the registration process.

  5. Overview of Számla Agent API

    Számla Agent is an API interface for Számlázz.hu designed for developers and IT professionals to 100% automate invoicing, receipting, and related financial operations. It provides a simple, fast, and reliable way to integrate invoicing workflows into external systems.

  6. Overview of Számla Agent PHP API

    The Számla Agent PHP API simplifies data communication with the Számla Agent system by encapsulating XML generation and remote data connection functions behind simple method invocations. The library handles the complexity of formatting and sending requests to Számlázz.hu.

  7. Overview of Számla Agent API capabilities

    Számla Agent is the API interface for Számlázz.hu, allowing developers to automate billing workflows using XML messages sent over HTTP. Key automation capabilities include:

    • Invoice Management: Create regular, prepayment, final, or corrective invoices; issue storno (reverse) invoices; and register full or partial payments.
    • Document Retrieval: Download created documents in PDF format or fetch their raw XML data.
    • Pro-forma & Delivery Notes: Create pro-forma invoices and delivery notes (via the invoice creation operation) and delete pro-forma invoices.
    • Receipts: Generate, cancel, query, and email receipts to customers.
    • Taxpayer Data: Look up company information using a tax number.

  8. Overview of Számlázz.hu self-billing

    Self-billing (or self-invoicing) allows a user belonging to a customer company to access a supplier's company account with accounting privileges to issue invoices on their behalf.

    Key Constraints & Requirements:

    • A legal self-billing agreement must be signed between the customer and supplier outside of the Számlázz.hu system.
    • The service has a fixed monthly fee charged to the delegate (customer), payable in arrears. This fee is independent of the number of suppliers managed.
    • Variable costs for bulk invoicing or Számla Agent services are borne by the delegate.
    • E-invoices issued as a delegate have no extra cost.

  9. Automate invoicing with Számla Agent

    Számla Agent allows developers to automate invoice and receipt-related operations using XML-based communication.

  10. Outgoing invoice submission XML schema

    Számlázz.hu transfers outgoing invoices to external systems using a specific XML format. The XML structure includes detailed information about the issuer (szallito), the invoice basics (alap), the customer (vevo), and the line items (tetelek).

    Key data fields include:

    • Invoice Types (tipus): SZ (Invoice), SS (Cancellation), JS (Credit note), HS (Corrective), ES (Advance), VS (Final), D (Pro forma), SL (Delivery note).
    • Invoice Categories (eszamla): 0 (not an invoice), 1 (paper), 2 or 3 (e-invoice).
    • Customer Location (lokacio): 1 (Domestic/Hungarian), 2 (EU), 3 (Outside EU), -1 (Unknown).
    • Source (forras): Indicates if the invoice was issued outside Számlázz.hu (e.g., 26: QUiCK, 28: SMARTBooks, 34: NAV Online invoice).

    The XML schema is validated against the XSD located at https://www.szamlazz.hu/szamla/docs/xsds/szamla/szamla.xsd.

    <?xml version="1.0" encoding="UTF-8"?>
<szamla xmlns="http://www.szamlazz.hu/szamla" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.szamlazz.hu/szamla https://www.szamlazz.hu/szamla/docs/xsds/szamla/szamla.xsd">
    <szallito>
        <id>12345</id>
        <nev>Példa Kft.</nev>
        <cim>
            <orszag></orszag>
            <irsz>1234</irsz>
            <telepules>Budapest</telepules>
            <cim>Kis utca 2.</cim>
        </cim>
        <adoszam>12345678-9-99</adoszam>
        <bank>
            <bankszamla>12345678-12345678</bankszamla>
        </bank>
    </szallito>
    <alap>
        <id>123456</id>
        <szamlaszam>2015-123</szamlaszam>
        <gazdEsemAzon>123456</gazdEsemAzon>
        <tipus>SZ</tipus>
        <eszamla>1</eszamla>
        <kelt>2015-12-01</kelt>
        <telj>2015-12-02</telj>
        <fizh>2015-12-03</fizh>
        <fizmod>bankkártya</fizmod>
        <nyelv>hu</nyelv>
        <devizanem>EUR</devizanem>
        <penzforg>true</penzforg>
        <kata>true</kata>
        <teszt>false</teszt>
    </alap>
    <vevo>
        <id>1234567</id>
        <nev>Customer Name</nev>
        <cim>
            <orszag>HU</orszag>
            <irsz>1234</irsz>
            <telepules>Budapest</telepules>
            <cim>Main street 1</cim>
        </cim>
        <lokacio>1</lokacio>
    </vevo>
    <tetelek>
        <tetel>
            <nev>Alma</nev>
            <mennyiseg>2</mennyiseg>
            <mennyisegiegyseg>kg</mennyisegiegyseg>
        </tetel>
    </tetelek>
</szamla>

  11. Understand the Számla Agent document generation flow

    The Számla Agent follows a specific request-response cycle to create and deliver invoices or receipts from an external system (such as a webshop):

    1. Transaction Initiation: The customer initiates a purchase in the external system.
    2. Request Submission: The external system sends an XML file containing document data via an HTTP POST request to https://www.szamlazz.hu/szamla/.
    3. Processing: Számla Agent processes the XML, generates the document, and returns the generated PDF in the HTTP response to the requesting system.
    4. PDF Delivery: The external system can then forward this received PDF to the customer.
    5. Optional Direct Email: If the XML request includes the customer's email address and a delivery request, Számlázz.hu can deliver the document directly to the customer via email.

  12. Understand self-billing vs delegated invoicing on Számlázz.hu

    On Számlázz.hu, self-billing is a specific type of delegated (third-party) invoicing. While both use the same technical connection, the roles differ:

    • Delegated invoicing: A delegate issues invoices on behalf of a supplier to any third-party buyer.
    • Self-billing: The delegate and the buyer are the same company. The buyer issues the invoice to itself in the supplier's name.

    For self-billing invoices, the system automatically adds the "self-billing" ("önszámlázás") indication to the printed document and the NAV Online Számla data report if the buyer's tax number matches the delegate company's tax number. No additional fields are required in the API request to trigger this.