This release fixes parsing of UBL invoices containing large embedded attachments.

Bug Fixes

• Reader: Enable LIBXML_PARSEHUGE to support parsing UBL documents with large base64-encoded PDF attachments (>10MB). Previously, libxml would throw "huge text node" errors when encountering large embedded binary objects. (Fixes #168)

v2.4.1 Latest

Latest

Compare

Choose a tag to compare

This release adds support for AdditionalItemProperty in Items and improves the robustness of the CommodityClassification reader.

New Features & Improvements

• Item: Added support for cac:AdditionalItemProperty elements. Items can now contain additional properties with name/value pairs. (Credits: @vtsiountas)

Bug Fixes

• CommodityClassification: Fixed reader to support CommodityCode element as fallback when ItemClassificationCode is not present. This prevents "Trying to access array offset on null" warnings when parsing UBL files that use CommodityCode. (Fixes #167)

Maintenance

• Bump symfony/process from 5.4.47 to 5.4.51.
• Bump phpunit/phpunit from 9.6.22 to 9.6.33.

Contributors

@vtsiountas

v2.4.0

Compare

Choose a tag to compare

This release adds support for the IssueTime field in Invoice documents.

New Features & Improvements

• Invoice: Added support for <cbc:IssueTime> tag, allowing you to set the issue time on invoices. This is required for Croatian e-invoicing compliance. (Credits: @hevesi)

Contributors

@hevesi

v2.3.1

Compare

Choose a tag to compare

This release adds support for self-billing credit notes and new getter methods for ID properties.

New Features & Improvements

• CreditNote: Added support for reading CreditNoteTypeCode when deserializing credit notes, enabling proper handling of self-billing credit notes (UNCL1001 code 261).
• Invoice: Added getCustomizationId() and getProfileId() getter methods to retrieve customization and profile identifiers.
• InvoiceTypeCode: Added SELF_BILLING_CREDIT_NOTE constant (261) for self-billing credit note documents.

v2.3.0

Compare

Choose a tag to compare

This release adds support for UBL 2.1 DebitNote documents and fixes SettlementPeriod date handling to comply with Peppol BIS 3.0 specification.

New Features & Improvements

• DebitNote: Add support for UBL 2.1 DebitNote documents, including DebitNote and DebitNoteLine classes, Generator::debitNote() method, and Reader support.

Bug Fixes

• SettlementPeriod: Make StartDate and EndDate optional per Peppol BIS 3.0 spec (BR-CO-19) - at least one of the dates must be present instead of requiring both.

Maintenance

• Translate comments from Dutch to English in SettlementPeriod.

v2.2.0

Compare

Choose a tag to compare

This release includes significant improvements to UBL invoice parsing, new features for tax handling, and several bug fixes for XML serialization.

New Features & Improvements

• TaxCurrencyCode: Added support for getting and setting cbc:TaxCurrencyCode on invoices. (Credits: @CasperBE)
• TaxSubtotal: Now reads all cac:TaxSubtotal elements from cac:TaxTotal instead of only the first one. (Credits: @CasperBE)
• PayeeParty: Improved retrieval of cac:PayeeParty with a dedicated class that properly handles its different structure. (Credits: @CasperBE)
• AllowanceCharge: Added support for reading cac:TaxCategory on cac:AllowanceCharge elements. (Credits: @CasperBE)

Bug Fixes

• Reference Classes: Fixed TypeError when parsing UBL files with missing optional ID elements by making setter types nullable for OrderReference, ProjectReference, ContractDocumentReference, and InvoiceDocumentReference. (Credits: @TNAJanssen)
• TaxAmount: Fixed reading of TaxAmount values.
• Price: Made cbc:BaseQuantity optional in Price XML serialization, aligning with the UBL 2.1 schema specification. Previously it was incorrectly written with a 0 value even when not set. (Credits: @hevesi)
• Delivery: Fixed ActualDeliveryDate to properly cast to a DateTime object. (Credits: @CasperBE)
• Date Handling: Improved handling of date values during parsing.

Maintenance

• Removed duplicate array key in codebase.
• Renamed variable for consistency.

Contributors

@TNAJanssen, @CasperBE, @hevesi

v2.1.0

Compare

Choose a tag to compare

Bug Fixes

• NumberFormatter: Fixed PHP 7.4 compatibility by removing trailing commas in function signatures that were only supported in PHP 8.0+.

Maintenance

• NumberFormatter: Refactored format() method for improved readability - simplified decimal point detection by always using localeconv(), applied consistent code style, and clarified comments explaining locale decimal point usage.

Full Changelog: v2.0.2...v2.0.3

v2.0.3

Compare

Choose a tag to compare

This release fixes a TypeError that occurred when using InvoiceTypeCode constants with strict types enabled.

Bug Fixes

• Invoice: Fixed TypeError when setting InvoiceTypeCode - changed type from string to int to match the constant definitions. (Fixes #96)

v2.0.2

Compare

Choose a tag to compare

This release includes bug fixes for XML deserialization and number formatting, along with a cleanup
of deprecated methods.

Note: This release contains a breaking change. Please refer to the Upgrading
Guide.

Bug Fixes

• TaxSubTotal: Fixed a typo when reading the TaxCategory from TaxSubTotal during XML
  deserialization. Added tests for reading TaxTotal information. (Credits: @CasperBE)

Maintenance

• Added comprehensive documentation guides for the 2.0 release.

Breaking Changes

• Invoice: Removed deprecated methods Invoice::setSupplierAssignedAccountID() and
  Invoice::getSupplierAssignedAccountID(). Use AccountingParty::setSupplierAssignedAccountId()
  and AccountingParty::getSupplierAssignedAccountId() instead. (Credits: @CasperBE)

Upgrading

See the upgrade guide for migration details:
UPGRADING.md

Contributors

@CasperBE

v2.0.1

Compare

Choose a tag to compare

This release introduces the ability to deserialize XML files into object trees. It also adds support for Carbon 3.x and Doctrine Collections 2.x, along with various updates to UBL structures.

Note: This is a major version release containing breaking changes. Please refer to the Upgrading Guide.

New Features & Improvements

• XML Deserialization: Added functionality to deserialize XML into an object tree.
• CreditNote: Added xmlDeserialize support for the CreditNote class to parse <cac:CreditNoteLine> elements. (Credits: @RoanB)
• Invoice References:
  • Added <cac:DespatchDocumentReference> to <Invoice>. (Credits: @fMads)
  • Added <cac:ReceiptDocumentReference> to <Invoice>.
  • Added <cac:OriginatorDocumentReference> to <Invoice>.
• Address & Location:
  • Added <cac:AddressLine> support to <cac:Address> for unstructured address lines. (Credits: @fMads)
  • Added <cac:OriginCountry> support to <cac:Item> for specifying country of origin. (Credits: @fMads)
• Standards:
  • Added FRCTC Electronic Address (0225) to EASCode. (Credits: @UbiManu)
  • Updated AllowanceCharge::allowanceChargeReasonCode to accept int|string|null, allowing string values like "ZZZ". (Credits: @Mikael-Leger)

Bug Fixes

• Fixed Attachment::xmlSerialize() to prevent output of EmbeddedDocumentBinaryObject when only externalReference is set. (Credits: @fMads)

Maintenance

• Updated dependency constraints to support Carbon 3.x and Doctrine Collections 2.x. (Credits: @GHuygen)

Breaking Changes

• Class Structure:
  • Invoice::setAccountingSupplierParty and getAccountingSupplierParty now use an AccountingParty object instead of Party.
  • Invoice::setAccountingCustomerParty and getAccountingCustomerParty now use an AccountingParty object instead of Party.
  • Removed Invoice::accountingCustomerPartyContact. Use Invoice::getAccountingCustomerParty()->setAccountingContact() instead.
  • Invoice::setSupplierAssignedAccountID/get moved to AccountingParty::setSupplierAssignedAccountID/get.
• Renamed Methods:
  • Attachment: setFileStream/getFileStream renamed to setBase64Content/getBase64Content.
  • setUBLVersionID -> setUBLVersionId
  • setSupplierAssignedAccountID -> setSupplierAssignedAccountId
  • setUnitCodeListID -> setUnitCodeListId
  • setSchemeID -> setSchemeId
  • setCustomizationID -> setCustomizationId
  • setProfileID -> setProfileId

Upgrading

See the upgrade guide for migration details:
UPGRADING.md

Contributors

@RoanB, @fMads, @UbiManu, @Mikael-Leger, @GHuygen

v2.0.0 🎉

Compare

Choose a tag to compare