Skip to main content

Changelog

All notable changes to this project will be documented in this file. The format is based on Keep a Changelog.

[2.10.18] - 2024.04.18

Removed

  • szamlaagent/cert/cacert.pem
  • removed functions: 'setCertificationPath' , 'getCertificationPath', 'getCertificationFile', 'getCertificationFileName'
    • szamlaagent/src/szamlaagent/item/SzamlaAgent.php
  • response header key check change (case insensitive handing)
    • SzamlaAgentResponse.php, InvoiceResponse.php, ReceiptResponse.php

[2.10.17] - 2023.06.14

Added

  • added new function: receipt item comment
    • szamlaagent/src/szamlaagent/item/ReceiptItem.php
    $item = new ReceiptItem();
...
$item->setComment($comment);
...
$item->getComment();

[2.10.16] - 2023.01.25

Fixed

  • date validation check update (PHP 8.2)
    • src/szamlaagent/SzamlaAgentUtil.php

[2.10.15] - 2022.10.26

Added

  • added: xml saving change, throw an exception in case of error
    • /src/szamlaagent/SzamlaAgentRequest.php
    • /src/szamlaagent/response/SzamlaAgentResponse.php

[2.10.14] - 2022.09.28

Removed

Legacy request mode has been removed! If you have used any of the request mode constants (e.g. CALL_METHOD_) or the request mode handler function, update your code. The default request mode is CURL and you don't need to set it in the constructor now.

  • removed function: 'makeLegacyCall', the only request method is CURL
    • src/szamlaagent/SzamlaAgentRequest.php
  • removed functions: 'setCallMethod', 'getCallMethod', 'getConnectionModeName'
    • src/szamlaagent/SzamlaAgent.php

Added

  • added new function: 'getInvoiceIdentifier' get invoice identifier number from response
    • src/szamlaagent/response/InvoiceResponse.php
    $agent = SzamlaAgentAPI::create('agentApiKey');
...
$result = $agent->generateInvoice($invoice);
...
$result->getInvoiceIdentifier();

Changed

  • 'downloadPdf(file_name)' change filename of pdf file, default is invoice/receipt number
    • src/szamlaagent/response/SzamlaAgentResponse.php
  • Traditional and envelope-friendly template name change
    • src/szamlaagent/document/invoice/Invoice.php
    const INVOICE_TEMPLATE_TRADITIONAL = 'SzlaNoEnv';
const INVOICE_TEMPLATE_ENV_FRIENDLY = 'SzlaAlap';

[2.10.13] - 2022.07.13

Added

  • added new function: 'setCookieHandleMode' set cookie handle mode (default: file mode)
    • src/szamlaagent/SzamlaAgent.php
    • src/szamlaagent/CookieHandler.php
    • src/szamlaagent/SzamlaAgentRequest.php
    $agent = SzamlaAgentAPI::create('agentApiKey');
...
$agent->setCookieHandleMode(SzamlaAgent::COOKIE_HANDLE_MODE_DATABASE);
...
$result->getCookieSessionId();
...
$agent->setCookieSessionId('SESSION_ID');

[2.10.12] - 2022.06.01

Added

  • added new buyer field: 'groupIdentifier'.
    • src/szamlaagent/Buyer.php
    • examples/document/invoice/create_invoice_with_custom_data.php
    $agent = SzamlaAgentAPI::create('agentApiKey');
...
$buyer = new Buyer('Kovacs Bt.', '2030', 'Erd', 'Tarnoki street 23.');
...
$buyer->setGroupIdentifier('12345678-5-42');

[2.10.11] - 2022.03.02

Added

  • added new function: certification path setting (eg if the default path is changed)
    • src/szamlaagent/SzamlaAgent.php
    $agent = SzamlaAgentAPI::create('agentApiKey');
$agent->setCertificationPath('path');
...

[2.10.10] - 2022.02.23

Changed

  • default SzamlaAgent request method is CURL.

    • src/szamlaagent/SzamlaaAgent.php
  • Log::writeLog method will not throw SzamlaAgentException.

    • src/szamlaagent/Log.php
  • xml file save setting changing: if you don't want to save the xml, the API will delete the temporary file created for the request (before PHP v7.4.1). After PHP v7.4.1, it will not create a temporary file (for CURL sending mode).

Fixed

  • check xml file creation when xml generation is turned off (eg if the default path is changed)
    • src/szamlaagent/SzamlaaAgent.php
    • src/szamlaagent/SzamlaaAgentRequest.php

[2.10.9] - 2021.12.08

Added

  • added new setting field: 'taxNumber' if pay invoice.
    • src/szamlaagent/SzamlaAgentSetting.php
    • examples/document/invoice/pay_invoice.php
    $agent = SzamlaAgentAPI::create('agentApiKey');
$agent->getSetting()->setTaxNumber('taxNumber');
...

Deprecated

  • It isn't recommended to use the legacy request mode. Use default CURL mode instead.
    • src/szamlaagent/response/SzamlaAgentRequest.php
        $agent = SzamlaAgentAPI::create('agentApiKey');
    ...
    $agent->setCallMethod(SzamlaAgentRequest::CALL_METHOD_CURL);
    ...

[2.10.8] - 2021.09.01

Added

  • added new function: reverse invoice comment setting

    • examples/document/invoice/create_reverse_invoice.php
    • src/szamlaagent/header/ReverseInvoiceHeader.php
    • src/szamlaagent/SzamlaAgent.php
        $invoice = new ReverseInvoice(Invoice::INVOICE_TYPE_E_INVOICE);
    ...
    $header->setComment('reverse invoice comment');
    ...
  • added new function: get invoice by external ID

    • src/szamlaagent/SzamlaAgent.php
    • src/szamlaagent/SzamlaAgentSetting.php
    • src/szamlaagent/document/invoice/Invoice.php
    • examples/document/invoice/get_invoice_pdf.php
        $agent = SzamlaAgentAPI::create('agentApiKey');
    ...
    $result = $agent->getInvoicePdf('TESZT-001', Invoice::FROM_INVOICE_EXTERNAL_ID);
    ...
  • added new function: check invoice by external ID

        $agent = SzamlaAgentAPI::create('agentApiKey');
    ...
    $agent->isExistsInvoiceByExternalId('invoiceExternalId');
    ...

[2.10.7] - 2021.08.25

Added

  • added new function: create final invoice by prepayment invoice number
    • src/szamlaagent/SzamlaAgent.php
    • src/szamlaagent/header/InvoiceHeader.php
  • added new examples:
    • examples/document/invoice/create_final_invoice_by_invoicenumber.php
    • examples/document/invoice/create_final_invoice_by_ordernumber.php

[2.10.6] - 2021.07.30

Removed

  • removed own certificate, keychain settings functions (setKeychain, setCertificationFileName)
    • src/szamlaagent/SzamlaAgent.php
    • src/szamlaagent/SzamlaAgentSettings.php
  • removed "kulcstartojelszo" field from generated xml

[2.10.5] - 2021.07.07

Added

  • added new functions: xml file save setting
    • src/szamlaagent/SzamlaAgent.php
    • src/szamlaagent/SzamlaAgentRequest.php
    • src/szamlaagent/SzamlaAgentResponse.php
    • examples/document/invoice/create_invoice_with_custom_data.php
    $agent = SzamlaAgentAPI::create('agentApiKey');
...
$agent->setXmlFileSave(true);
// if you don't want to save the request xml (opcional)
$agent->setRequestXmlFileSave(false);
// if you don't want to save the response xml (opcional)
$agent->setResponseXmlFileSave(false);
  • added new functions: empty xml, pdf, log directory
    • src/szamlaagent/SzamlaAgentUtil.php
    SzamlaAgentUtil::emptyXmlDir();
SzamlaAgentUtil::emptyPdfDir();
SzamlaAgentUtil::emptyLogDir();

[2.10.4] - 2021.06.30

Added

  • added new header field: 'euVat' (The invoice doesn't include Hungarian VAT. The invoice details will not be sent to the NAV Online invoicing system).
    • src/szamlaagent/header/InvoiceHeader.php
    • examples/document/invoice/create_invoice_with_custom_data.php
    $agent = SzamlaAgentAPI::create('agentApiKey');
...
$invoice = new Invoice(Invoice::INVOICE_TYPE_E_INVOICE);
$header = $invoice->getHeader();
...
$header->setEuVat(true);

[2.10.3] - 2021.06.23

Added

  • added new function: custom request-timeout setting
    • src/szamlaagent/SzamlaAgent.php (setRequestTimeout)
    • src/szamlaagent/SzamlaAgentRequest.php
    $agent = SzamlaAgentAPI::create('agentApiKey');  
$agent->setRequestTimeout(60);

[2.10.2] - 2021.04.14

Changed

  • added 11 new item VAT type
    • src/szamlaagent/item/Item.php

[2.10.1] - 2021.03.24

Changed

  • we will not send notification email, if the Buyer.sendEmail property is not set
    • src/szamlaagent/Buyer.php
    • src/szamlaagent/BuyerLedger.php
  • The last two parameters of the InvoiceItemLedger constructor can also be numbers
    • src/szamlaagent/ledger/InvoiceItemLedger.php
    $itemLedger = new InvoiceItemLedger('economic event type', 'vat economic event type', 123, 467);

[2.10.0] - 2021.03.10

Added

  • added changelog to the package
    • src/szamlaagent/changelog.md

[2.9.10] - 2021.01.27

Added

  • added new function: invoice PDF preview creation
    • src/szamlaagent/header/InvoiceHeader.php
    $invoice = new Invoice(Invoice::INVOICE_TYPE_E_INVOICE);  
$invoice->getHeader()->setPreviewPdf(true);
  • added new function: Turn off default PDF file saving (you can save the preview PDF yourself)
    • src/szamlaagent/SzamlaAgent.php
    $agent = SzamlaAgentAPI::create('agentApiKey');  
$agent->setPdfFileSave(false);

Changed

  • TaxPayer interface update (NAV 3.0 format). If you are building business logic on this interface, you recommend using your own XML processor to handle the data coming from NAV.
    • src/szamlaagent/response/TaxPayerResponse.php
    • src/szamlaagent/response/SzamlaAgentResponse.php

Deprecated

  • Processing of data received via the NAV TaxPayer interface via the TaxPayerResponse object was supported until version 2.9.10.
    • src/szamlaagent/response/TaxPayerResponse.php

[2.9.9] - 2020.12.10

Added

  • added new VAT codes (TAHK, TEHK)
    • src/szamlaagent/item/Item.php

Changed

  • XML creation logging update (if the creation fails, the generated XML is logged)
    • src/szamlaagent/SzamlaAgentRequest.php
    • src/szamlaagent/SzamlaAgentException.php

[2.9.8] - 2020.11.24

Fixed

  • TaxPayer interface bugfix (& character handing in taxpayerName field)
    • src/szamlaagent/SimpleXMLExtended.php (cleanXMLNode)

[2.9.7] - 2020.10.07

Added

  • added new function: corrective and reverse invoice buyer taxnumber setting
    • src/szamlaagent/Buyer.php

[2.9.6] - 2020.09.16

Changed

  • Taxpayer options changed
    • src/szamlaagent/TaxPayer.php
  • The name of the generated XML file contains the full timestamp
    • src/szamlaagent/SzamlaAgentUtil.php (getDateTimeWithMilliseconds)

Deprecated

  • Taxpayer options changed (Don't use the following values, use this instead: TaxPayer::TAXPAYER_HAS_TAXNUMBER)
    • src/szamlaagent/TaxPayer.php
    const TAXPAYER_JOINT_VENTURE = 5;
const TAXPAYER_INDIVIDUAL_BUSINESS = 4;
const TAXPAYER_PRIVATE_INDIVIDUAL_WITH_TAXNUMBER = 3;
const TAXPAYER_OTHER_ORGANIZATION_WITH_TAXNUMBER = 2;
const TAXPAYER_PRIVATE_INDIVIDUAL = -2;
const TAXPAYER_OTHER_ORGANIZATION_WITHOUT_TAXNUMBER = -3;

[2.9.5] - 2020.07.15

Added

  • added new TaxPayer interface options (added 6 and 7 value)
    • src/szamlaagent/TaxPayer.php
    const TAXPAYER_NON_EU_ENTERPRISE = 7;
const TAXPAYER_EU_ENTERPRISE = 6;
  • Automatic cookie creation for billing accounts per API key (creates a completely unique cookie based on agent key).
    • src/szamlaagent/SzamlaAgent.php (buildCookieFileName)

[2.9.4] - 2020.07.08

Added

  • added new TaxPayer tag
    • src/szamlaagent/Buyer.php

[2.9.3] - 2020.06.24

Added

  • added new function: custom NAV errorcodes handing (TaxPayer interface - query and convert to JSON)
    • src/szamlaagent/SzamlaAgentUtil.php
    $data = SzamlaAgentAPI::create('agentApiKey')->getTaxPayer('12345678')->toJson();
$data = SzamlaAgentAPI::create('agentApiKey')->getTaxPayer('12345678')->getDataObj();

Fixed

  • taxpayerData property duplication bugfix (TaxPayer interface)
  • SimpleXMLExtended XML parser nullpointer fix
    • src/szamlaagent/SimpleXMLExtended.php (removeChild)

[2.9.2] - 2020.06.19

Changed

  • update TaxPayer interface (custom namespace handing)
    • src/szamlaagent/SzamlaAgentUtil.php
    • src/szamlaagent/SimpleXMLExtended.php
    • src/szamlaagent/response/SzamlaAgentResponse.php

[2.9.1] - 2020.06.17

Added

  • added new function: custom request-header setting
    • src/szamlaagent/SzamlaAgent.php (addCustomHTTPHeader)
    • src/szamlaagent/SzamlaAgentRequest.php

[2.9.0] - 2020.06.10

Added

  • added new function: custom invoice template setting (retro, 8 cm, traditional, etc.)
    • src/szamlaagent/header/InvoiceHeader.php
    • src/szamlaagent/header/ReverseInvoiceHeader.php
    • src/szamlaagent/document/invoice/Invoice.php
    • src/szamlaagent/response/InvoiceResponse.php
    • src/szamlaagent/response/ReceiptResponse.php
    • src/szamlaagent/response/SzamlaAgentResponse.php
    • src/szamlaagent/response/ProformaDeletionResponse.php
    $invoice->getHeader()->setInvoiceTemplate(Invoice::INVOICE_TEMPLATE_8CM);
  • added new function: failed invoice notification sending handling
    • src/szamlaagent/response/SzamlaAgentResponse.php
    // successful response handing
if ($result->isSuccess()) {
echo 'A számla sikeresen elkészült. Számlaszám: ' . $result->getDocumentNumber();
}
// if notification sending fails, we can handle it
if ($result->hasInvoiceNotificationSendError()) {
var_dump($result->getDataObj());
}

[2.8.4] - 2020.05.21

Added

  • added new function: certification filename setting
    • src/szamlaagent/SzamlaAgent.php (setCertificationFileName)

Changed

  • changed TaxPayer interface (NAV data structure changed)
    • src/szamlaagent/response/TaxPayerResponse.php

[2.8.3] - 2020.05.06

Changed

  • setting a default path for generated files (xmls, pdf, logs, attachments)
    • src/szamlaagent/SzamlaAgentUtil.php (setBasePath)
  • the request connection function has been optimized
    • src/szamlaagent/SzamlaAgentRequest.php (checkConnection)

Removed

  • removed function: setting request calling type from session (PHP v1.0)
    • src/szamlaagent/SzamlaAgentRequest.php

[2.8.2] - 2019.12.26

Added

  • added new function: setting logging path and filename
    • src/szamlaagent/Log.php
    • src/szamlaagent/SzamlaAgent.php

[2.8.1] - 2019.11.20

Fixed

  • fixed cookie management bug (custom cookie filename setting)
    • src/szamlaagent/SzamlaAgentRequest.php

[2.8.0] - 2019.10.24

Added

  • added new functions: buyer ledger invoices settlement period
    • src/szamlaagent/BuyerLedger.php

[2.7.0] - 2019.09.04

Added

  • added new function: attach files to an invoice (maximum 5)
    • src/szamlaagent/SzamlaAgent.php
    • src/szamlaagent/SzamlaAgentUtil.php
    • src/szamlaagent/SzamlaAgentRequest.php
    • src/szamlaagent/SzamlaAgentException.php
    • src/szamlaagent/document/invoice/Invoice.php
    • examples/document/invoice/create_invoice_with_attachment.php

[2.6.0] - 2019.08.28

Added

  • added new interfaces: "getInvoiceData" and "getReceiptData" (xmlszamlaxml XML interface update)
    • examples/document/invoice/get_invoice_data.php
    • examples/document/invoice/get_invoice_pdf.php
  • Nyugta adatok lekérdezése:
    • examples/document/receipt/get_receipt_data.php

[2.5.0] - 2019.07.25

Added

  • added SzamlaAgent API key interface
    • src/szamlaagent/SzamlaAgent.php
    • src/szamlaagent/SzamlaAgentAPI.php
    • src/szamlaagent/SzamlaAgentRequest.php
    • src/szamlaagent/SzamlaAgentSetting.php
    • src/szamlaagent/document/invoice/Invoice.php

[2.4.0] - 2019.07.25

Changed

  • changed autoload function (import only from 'SzamlaAgent' namespace)

    • examples/autoload.php
    • src/szamlaagent/SzamlaAgent.php
    • examples/document/receipt/create_receipt_with_default_data.php
    • examples/document/receipt/create_receipt_with_custom_data.php
  • logging optimized (easier search)

    • src/szamlaagent/Log.php
  • changed the invoice response customer account url decoding

    • src/szamlaagent/response/InvoiceResponse.php

Fixed

  • fixed documentation bug (cookie management)

[2.3.0] - 2019.06.26

Changed

  • changed exception handling
    • src/szamlaagent/response/SzamlaAgentResponse.php

[2.2.0] - 2019.06.05

Added

  • added new function: create proforma invoice with ordernumber
    • src/szamlaagent/header/InvoiceHeader.php

[2.1.0] - 2019.05.21

Added

  • added PHP API logging
    • src/szamlaagent/SzamlaAgent.php

[2.0.0] - 2019.03.20

Added

  • PHP API package created