@financica/ubl 0.17.0 → 0.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":["XmlDomParser","trimmed","cbcText","cacElement","cbcDirectText"],"sources":["../src/xml-dom.ts","../src/parser.ts","../src/attachments.ts","../src/mlr.ts","../src/normalize.ts"],"sourcesContent":["import { type Document, DOMParser as XmlDomParser } from \"@xmldom/xmldom\";\nimport { UblParseError } from \"./errors.js\";\n\nexport const CBC_NS =\n\t\"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2\";\nexport const CAC_NS =\n\t\"urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2\";\n\n/**\n * Strip DOCTYPE declarations to prevent XXE (XML External Entity) attacks.\n * @xmldom/xmldom resolves external entities by default, so we remove DOCTYPE\n * blocks (including inline DTD subsets) before parsing.\n */\nexport const stripDoctype = (xml: string): string =>\n\txml.replace(/<!DOCTYPE\\s[^>[]*(?:\\[[^\\]]*\\])?>/gi, \"\");\n\n/**\n * Parse XML into a DOM, preferring the host's `DOMParser` (browsers) and\n * falling back to @xmldom/xmldom. Throws {@link UblParseError} when the XML\n * is malformed.\n */\nexport const parseXmlDocument = (xml: string): Document => {\n\tconst safeXml = stripDoctype(xml);\n\tconst BrowserDomParser = (globalThis as { DOMParser?: typeof XmlDomParser })\n\t\t.DOMParser;\n\tconst parser = BrowserDomParser ? new BrowserDomParser() : new XmlDomParser();\n\tlet doc: Document;\n\ttry {\n\t\tdoc = parser.parseFromString(safeXml, \"text/xml\");\n\t} catch (cause) {\n\t\tthrow new UblParseError(\"Malformed XML\", { cause });\n\t}\n\tif (doc.getElementsByTagName(\"parsererror\").length > 0 || !doc.documentElement) {\n\t\tthrow new UblParseError(\"Malformed XML\");\n\t}\n\treturn doc;\n};\n","import type { Element } from \"@xmldom/xmldom\";\nimport type {\n\tUblAddress,\n\tUblAllowanceCharge,\n\tUblAttachment,\n\tUblBillingReference,\n\tUblContact,\n\tUblDelivery,\n\tUblDocumentReference,\n\tUblInvoice,\n\tUblInvoicePeriod,\n\tUblItemProperty,\n\tUblLine,\n\tUblMonetaryTotal,\n\tUblParty,\n\tUblPartyIdentification,\n\tUblPaymentMeans,\n\tUblTaxCategory,\n\tUblTaxSubtotal,\n\tUblTaxTotal,\n} from \"./types.js\";\nimport { UblParseError } from \"./errors.js\";\nimport { CAC_NS, CBC_NS, parseXmlDocument } from \"./xml-dom.js\";\n\n// --- DOM helpers ---\n\nconst trimmed = (value: string | null | undefined): string | undefined => {\n\tconst text = value?.trim();\n\treturn text ? text : undefined;\n};\n\n/** First descendant CBC element's trimmed text; absent or blank is `undefined`. */\nfunction cbcText(parent: Element, tag: string): string | undefined {\n\treturn trimmed(parent.getElementsByTagNameNS(CBC_NS, tag)[0]?.textContent);\n}\n\n/** Like {@link cbcText} but throws: the element is mandatory in EN 16931. */\nfunction requiredCbcText(parent: Element, tag: string, what: string): string {\n\tconst value = cbcText(parent, tag);\n\tif (value === undefined) throw new UblParseError(`Missing ${what} (cbc:${tag})`);\n\treturn value;\n}\n\nconst toNumber = (value: string | undefined): number | undefined => {\n\tif (value === undefined) return undefined;\n\tconst parsed = Number.parseFloat(value);\n\treturn Number.isNaN(parsed) ? undefined : parsed;\n};\n\nfunction cacElement(parent: Element, tag: string): Element | null {\n\treturn parent.getElementsByTagNameNS(CAC_NS, tag)[0] ?? null;\n}\n\nfunction cacElements(parent: Element, tag: string): Element[] {\n\treturn Array.from(parent.getElementsByTagNameNS(CAC_NS, tag));\n}\n\n/** First descendant CBC element as a number; absent or non-numeric is `undefined`. */\nfunction cbcNumber(parent: Element, tag: string): number | undefined {\n\treturn toNumber(cbcText(parent, tag));\n}\n\nfunction childElementsByTagNs(\n\tparent: Element,\n\tnamespace: string,\n\ttag: string,\n): Element[] {\n\tconst elements: Element[] = [];\n\tfor (let i = 0; i < parent.childNodes.length; i++) {\n\t\tconst node = parent.childNodes[i];\n\t\tif (!node || node.nodeType !== 1) continue;\n\t\tconst element = node as Element;\n\t\tif (element.namespaceURI === namespace && element.localName === tag) {\n\t\t\telements.push(element);\n\t\t}\n\t}\n\treturn elements;\n}\n\nfunction cbcDirectText(parent: Element, tag: string): string | undefined {\n\treturn trimmed(childElementsByTagNs(parent, CBC_NS, tag)[0]?.textContent);\n}\n\nfunction cbcDirectNumber(parent: Element, tag: string): number | undefined {\n\treturn toNumber(cbcDirectText(parent, tag));\n}\n\nconst attribute = (el: Element | null | undefined, name: string): string | undefined =>\n\ttrimmed(el?.getAttribute(name));\n\nfunction cacDirectElement(parent: Element, tag: string): Element | null {\n\treturn childElementsByTagNs(parent, CAC_NS, tag)[0] ?? null;\n}\n\nfunction cacDirectElements(parent: Element, tag: string): Element[] {\n\treturn childElementsByTagNs(parent, CAC_NS, tag);\n}\n\n// --- Section parsers ---\n\nfunction parseAddressFromElement(address: Element | null): UblAddress | undefined {\n\tif (!address) return undefined;\n\tconst country = cacElement(address, \"Country\");\n\treturn {\n\t\tstreet: cbcText(address, \"StreetName\"),\n\t\tadditionalStreet: cbcText(address, \"AdditionalStreetName\"),\n\t\tcity: cbcText(address, \"CityName\"),\n\t\tpostalZone: cbcText(address, \"PostalZone\"),\n\t\tcountrySubentity: cbcText(address, \"CountrySubentity\"),\n\t\tcountryCode: country ? cbcText(country, \"IdentificationCode\") : undefined,\n\t};\n}\n\nfunction parseAddress(party: Element): UblAddress | undefined {\n\tconst postal = cacElement(party, \"PostalAddress\");\n\treturn parseAddressFromElement(postal);\n}\n\nfunction parseTaxSchemeId(parent: Element | null): string | undefined {\n\tif (!parent) return undefined;\n\tconst taxScheme = cacElement(parent, \"TaxScheme\");\n\tif (!taxScheme) return undefined;\n\treturn cbcText(taxScheme, \"ID\");\n}\n\nfunction parseContact(party: Element): UblContact | undefined {\n\tconst contact = cacElement(party, \"Contact\");\n\tif (!contact) return undefined;\n\tconst name = cbcText(contact, \"Name\");\n\tconst phone = cbcText(contact, \"Telephone\");\n\tconst email = cbcText(contact, \"ElectronicMail\");\n\tif (!name && !phone && !email) return undefined;\n\treturn { name, phone, email };\n}\n\nfunction parsePartyIdentifications(party: Element): UblPartyIdentification[] {\n\tconst ids = cacElements(party, \"PartyIdentification\");\n\tconst result: UblPartyIdentification[] = [];\n\tfor (const idEl of ids) {\n\t\tconst idValue = cbcText(idEl, \"ID\");\n\t\tif (!idValue) continue;\n\t\tresult.push({\n\t\t\tid: idValue,\n\t\t\tschemeId: attribute(\n\t\t\t\tidEl.getElementsByTagNameNS(CBC_NS, \"ID\")[0],\n\t\t\t\t\"schemeID\",\n\t\t\t),\n\t\t});\n\t}\n\treturn result;\n}\n\nfunction parseParty(root: Element, role: string): UblParty {\n\tconst wrapper = cacElement(root, role);\n\tconst party = wrapper ? cacElement(wrapper, \"Party\") : null;\n\tif (!party) return {};\n\n\tconst partyName = cacElement(party, \"PartyName\");\n\tconst legalEntity = cacElement(party, \"PartyLegalEntity\");\n\tconst taxScheme = cacElement(party, \"PartyTaxScheme\");\n\tconst partyId = cacElement(party, \"PartyIdentification\");\n\tconst endpointEl = party.getElementsByTagNameNS(CBC_NS, \"EndpointID\")[0];\n\tconst partyIdentifications = parsePartyIdentifications(party);\n\tconst companyIdEl = legalEntity\n\t\t? legalEntity.getElementsByTagNameNS(CBC_NS, \"CompanyID\")[0]\n\t\t: null;\n\n\tconst endpointValue = trimmed(endpointEl?.textContent);\n\tconst companyIdValue = companyIdEl\n\t\t? trimmed(companyIdEl.textContent)\n\t\t: partyId\n\t\t\t? cbcText(partyId, \"ID\")\n\t\t\t: undefined;\n\n\treturn {\n\t\tname: partyName ? cbcText(partyName, \"Name\") : undefined,\n\t\tregistrationName: legalEntity\n\t\t\t? cbcText(legalEntity, \"RegistrationName\")\n\t\t\t: undefined,\n\t\tcompanyLegalForm: legalEntity\n\t\t\t? cbcText(legalEntity, \"CompanyLegalForm\")\n\t\t\t: undefined,\n\t\tvatId: taxScheme ? cbcText(taxScheme, \"CompanyID\") : undefined,\n\t\ttaxSchemeId: parseTaxSchemeId(taxScheme),\n\t\tcompanyId:\n\t\t\tcompanyIdValue !== undefined\n\t\t\t\t? { value: companyIdValue, scheme: attribute(companyIdEl, \"schemeID\") }\n\t\t\t\t: undefined,\n\t\tendpoint:\n\t\t\tendpointValue !== undefined\n\t\t\t\t? { value: endpointValue, scheme: attribute(endpointEl, \"schemeID\") }\n\t\t\t\t: undefined,\n\t\tpartyIdentifications:\n\t\t\tpartyIdentifications.length > 0 ? partyIdentifications : undefined,\n\t\taddress: parseAddress(party),\n\t\tcontact: parseContact(party),\n\t};\n}\n\n/**\n * `cac:TaxCategory` / `cac:ClassifiedTaxCategory`. Emitted whenever the\n * element states anything; `percentFallback` covers the E-FFF habit of putting\n * `cbc:Percent` on the subtotal instead of inside the category.\n */\nfunction parseTaxCategory(\n\tcat: Element | null,\n\tpercentFallback?: Element,\n): UblTaxCategory | undefined {\n\tconst percentFromParent = percentFallback\n\t\t? cbcDirectNumber(percentFallback, \"Percent\")\n\t\t: undefined;\n\tif (!cat) {\n\t\treturn percentFromParent !== undefined\n\t\t\t? { percent: percentFromParent }\n\t\t\t: undefined;\n\t}\n\tconst category: UblTaxCategory = {\n\t\tid: cbcText(cat, \"ID\"),\n\t\tpercent: cbcNumber(cat, \"Percent\") ?? percentFromParent,\n\t\tschemeId: parseTaxSchemeId(cat),\n\t\texemptionReason: cbcText(cat, \"TaxExemptionReason\"),\n\t\texemptionReasonCode: cbcText(cat, \"TaxExemptionReasonCode\"),\n\t};\n\treturn Object.values(category).some((value) => value !== undefined)\n\t\t? category\n\t\t: undefined;\n}\n\nfunction parseTaxSubtotal(sub: Element): UblTaxSubtotal {\n\treturn {\n\t\ttaxableAmount: cbcNumber(sub, \"TaxableAmount\"),\n\t\ttaxAmount: cbcNumber(sub, \"TaxAmount\"),\n\t\tcategory: parseTaxCategory(cacElement(sub, \"TaxCategory\"), sub),\n\t};\n}\n\nfunction parseTaxSubtotalsFromTaxTotal(taxTotal: Element): UblTaxSubtotal[] {\n\treturn cacDirectElements(taxTotal, \"TaxSubtotal\").map(parseTaxSubtotal);\n}\n\n/**\n * `cac:TaxTotal` (BG-22). BT-110 is read from the first `cac:TaxTotal` as\n * stated, never summed from the subtotals; the subtotals of every `TaxTotal`\n * (a second one carries the accounting-currency figure) are concatenated.\n */\nfunction parseTaxTotal(root: Element): UblTaxTotal {\n\tconst taxTotals = cacDirectElements(root, \"TaxTotal\");\n\tconst first = taxTotals[0];\n\treturn {\n\t\ttaxAmount: first ? cbcDirectNumber(first, \"TaxAmount\") : undefined,\n\t\tsubtotals: taxTotals.flatMap(parseTaxSubtotalsFromTaxTotal),\n\t};\n}\n\nfunction parseAllowanceCharge(charge: Element): UblAllowanceCharge {\n\tconst taxCategory = cacElement(charge, \"TaxCategory\");\n\tconst indicatorRaw = cbcDirectText(charge, \"ChargeIndicator\")?.toLowerCase();\n\tconst chargeIndicator = indicatorRaw === \"true\" || indicatorRaw === \"1\";\n\treturn {\n\t\tchargeIndicator,\n\t\tamount: cbcNumber(charge, \"Amount\"),\n\t\tbaseAmount: cbcDirectNumber(charge, \"BaseAmount\"),\n\t\tmultiplierFactorNumeric: cbcDirectNumber(charge, \"MultiplierFactorNumeric\"),\n\t\treason: cbcText(charge, \"AllowanceChargeReason\"),\n\t\treasonCode: cbcText(charge, \"AllowanceChargeReasonCode\"),\n\t\ttaxCategory: parseTaxCategory(taxCategory),\n\t};\n}\n\nfunction parseAllowanceCharges(parent: Element): UblAllowanceCharge[] {\n\treturn cacDirectElements(parent, \"AllowanceCharge\").map(parseAllowanceCharge);\n}\n\nfunction mergeTaxCategories(\n\tpreferred: UblTaxCategory | undefined,\n\tfallback: UblTaxCategory | undefined,\n): UblTaxCategory | undefined {\n\tif (!preferred) return fallback;\n\tif (!fallback) return preferred;\n\treturn {\n\t\tid: preferred.id ?? fallback.id,\n\t\tpercent: preferred.percent ?? fallback.percent,\n\t\tschemeId: preferred.schemeId ?? fallback.schemeId,\n\t\texemptionReason: preferred.exemptionReason ?? fallback.exemptionReason,\n\t\texemptionReasonCode:\n\t\t\tpreferred.exemptionReasonCode ?? fallback.exemptionReasonCode,\n\t};\n}\n\nfunction parseLines(root: Element, isCreditNote: boolean): UblLine[] {\n\tconst qtyTag = isCreditNote ? \"CreditedQuantity\" : \"InvoicedQuantity\";\n\tconst lineTag = isCreditNote ? \"CreditNoteLine\" : \"InvoiceLine\";\n\n\treturn cacElements(root, lineTag).map((line) => {\n\t\tconst item = cacElement(line, \"Item\");\n\t\tconst price = cacElement(line, \"Price\");\n\t\tconst classifiedCategory = parseTaxCategory(\n\t\t\titem ? cacElement(item, \"ClassifiedTaxCategory\") : null,\n\t\t);\n\t\tconst sellersId = item ? cacElement(item, \"SellersItemIdentification\") : null;\n\t\tconst buyersId = item ? cacElement(item, \"BuyersItemIdentification\") : null;\n\t\tconst qtyEl = line.getElementsByTagNameNS(CBC_NS, qtyTag)[0];\n\t\tconst lineExtensionAmount = cbcNumber(line, \"LineExtensionAmount\");\n\t\tconst lineTaxTotal = cacDirectElement(line, \"TaxTotal\");\n\t\tconst lineTaxSubtotals = lineTaxTotal\n\t\t\t? parseTaxSubtotalsFromTaxTotal(lineTaxTotal)\n\t\t\t: [];\n\t\tconst taxAmountFromSubtotals = lineTaxSubtotals.reduce(\n\t\t\t(sum, subtotal) => sum + (subtotal.taxAmount ?? 0),\n\t\t\t0,\n\t\t);\n\t\tconst taxAmountFromLineTotal = lineTaxTotal\n\t\t\t? cbcDirectNumber(lineTaxTotal, \"TaxAmount\")\n\t\t\t: undefined;\n\t\t// A line-level TaxSubtotal (E-FFF) wins over the classified category,\n\t\t// field by field.\n\t\tconst subtotalCategory = lineTaxSubtotals[0]?.category;\n\t\tconst taxCategory = mergeTaxCategories(subtotalCategory, classifiedCategory);\n\t\tconst taxPercent = taxCategory?.percent;\n\t\tconst computedTaxAmount =\n\t\t\ttaxPercent !== undefined && lineExtensionAmount !== undefined\n\t\t\t\t? Number(((lineExtensionAmount * taxPercent) / 100).toFixed(2))\n\t\t\t\t: undefined;\n\t\tconst lineAllowanceCharges = parseAllowanceCharges(line);\n\t\tconst priceAllowanceCharges = price ? parseAllowanceCharges(price) : [];\n\t\tconst allowanceCharges = [...lineAllowanceCharges, ...priceAllowanceCharges];\n\t\tconst discountAmount = allowanceCharges.reduce(\n\t\t\t(sum, charge) =>\n\t\t\t\tcharge.chargeIndicator ? sum : sum + Math.abs(charge.amount ?? 0),\n\t\t\t0,\n\t\t);\n\t\tconst chargeAmount = allowanceCharges.reduce(\n\t\t\t(sum, charge) =>\n\t\t\t\tcharge.chargeIndicator ? sum + Math.abs(charge.amount ?? 0) : sum,\n\t\t\t0,\n\t\t);\n\n\t\tconst additionalItemProperties: UblItemProperty[] = [];\n\t\tif (item) {\n\t\t\tfor (const prop of cacElements(item, \"AdditionalItemProperty\")) {\n\t\t\t\tconst propName = cbcText(prop, \"Name\");\n\t\t\t\tconst propValue = cbcText(prop, \"Value\");\n\t\t\t\tif (propName) {\n\t\t\t\t\tadditionalItemProperties.push({\n\t\t\t\t\t\tname: propName,\n\t\t\t\t\t\tvalue: propValue,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// EN16931 BT-146 (PriceAmount) is the price for BT-149 (BaseQuantity) units\n\t\t// of the item, not necessarily for one unit. Effective unit price is\n\t\t// PriceAmount / BaseQuantity, with BaseQuantity defaulting to 1 when absent.\n\t\tconst priceAmount = price ? cbcNumber(price, \"PriceAmount\") : undefined;\n\t\tconst priceBaseQuantity = price\n\t\t\t? cbcDirectNumber(price, \"BaseQuantity\")\n\t\t\t: undefined;\n\t\tconst unitPrice =\n\t\t\tpriceAmount !== undefined && priceBaseQuantity && priceBaseQuantity > 0\n\t\t\t\t? priceAmount / priceBaseQuantity\n\t\t\t\t: priceAmount;\n\n\t\treturn {\n\t\t\tid: requiredCbcText(line, \"ID\", `${lineTag} identifier`),\n\t\t\tdescription: item ? cbcText(item, \"Description\") : undefined,\n\t\t\tquantity: cbcNumber(line, qtyTag),\n\t\t\tunitCode: attribute(qtyEl, \"unitCode\"),\n\t\t\tunitPrice,\n\t\t\tlineExtensionAmount,\n\t\t\tbaseQuantity: priceBaseQuantity,\n\t\t\ttaxCategory,\n\t\t\ttaxAmount:\n\t\t\t\ttaxAmountFromLineTotal ??\n\t\t\t\t(lineTaxSubtotals.length > 0\n\t\t\t\t\t? taxAmountFromSubtotals\n\t\t\t\t\t: computedTaxAmount),\n\t\t\ttaxSubtotals: lineTaxSubtotals.length > 0 ? lineTaxSubtotals : undefined,\n\t\t\tallowanceCharges:\n\t\t\t\tallowanceCharges.length > 0 ? allowanceCharges : undefined,\n\t\t\tdiscountAmount: discountAmount > 0 ? discountAmount : undefined,\n\t\t\tchargeAmount: chargeAmount > 0 ? chargeAmount : undefined,\n\t\t\titemName: item ? cbcText(item, \"Name\") : undefined,\n\t\t\tsellersItemId: sellersId ? cbcText(sellersId, \"ID\") : undefined,\n\t\t\tbuyersItemId: buyersId ? cbcText(buyersId, \"ID\") : undefined,\n\t\t\tadditionalItemProperties:\n\t\t\t\tadditionalItemProperties.length > 0\n\t\t\t\t\t? additionalItemProperties\n\t\t\t\t\t: undefined,\n\t\t\tinvoicePeriod: parseInvoicePeriod(line),\n\t\t};\n\t});\n}\n\nfunction parseMonetaryTotal(root: Element): UblMonetaryTotal {\n\tconst total = cacDirectElement(root, \"LegalMonetaryTotal\");\n\tif (!total) return {};\n\treturn {\n\t\tlineExtensionAmount: cbcNumber(total, \"LineExtensionAmount\"),\n\t\ttaxExclusiveAmount: cbcNumber(total, \"TaxExclusiveAmount\"),\n\t\ttaxInclusiveAmount: cbcNumber(total, \"TaxInclusiveAmount\"),\n\t\tallowanceTotalAmount: cbcNumber(total, \"AllowanceTotalAmount\"),\n\t\tchargeTotalAmount: cbcNumber(total, \"ChargeTotalAmount\"),\n\t\tprepaidAmount: cbcNumber(total, \"PrepaidAmount\"),\n\t\tpayableRoundingAmount: cbcNumber(total, \"PayableRoundingAmount\"),\n\t\tpayableAmount: cbcNumber(total, \"PayableAmount\"),\n\t};\n}\n\nfunction parsePaymentMeansElement(pm: Element): UblPaymentMeans {\n\tconst account = cacElement(pm, \"PayeeFinancialAccount\");\n\tconst branch = account ? cacElement(account, \"FinancialInstitutionBranch\") : null;\n\tconst paymentMeansCodeEl = pm.getElementsByTagNameNS(CBC_NS, \"PaymentMeansCode\")[0];\n\tconst mandate = cacElement(pm, \"PaymentMandate\");\n\n\treturn {\n\t\tcode: cbcText(pm, \"PaymentMeansCode\"),\n\t\tcodeName: attribute(paymentMeansCodeEl, \"name\"),\n\t\tpaymentId: cbcText(pm, \"PaymentID\"),\n\t\tiban: account ? cbcText(account, \"ID\") : undefined,\n\t\tbic: branch ? cbcText(branch, \"ID\") : undefined,\n\t\taccountName: account ? cbcText(account, \"Name\") : undefined,\n\t\tmandateId: mandate ? cbcText(mandate, \"ID\") : undefined,\n\t};\n}\n\nfunction parsePaymentMeansList(root: Element): UblPaymentMeans[] | undefined {\n\tconst list = cacElements(root, \"PaymentMeans\").map(parsePaymentMeansElement);\n\treturn list.length > 0 ? list : undefined;\n}\n\n/**\n * BT-73/BT-74 on a document, BT-134/BT-135 on a line. Direct children only:\n * a descendant search on the document root would report the first line's\n * period as the document's whenever the document states none of its own.\n */\nfunction parseInvoicePeriod(parent: Element): UblInvoicePeriod | undefined {\n\tconst period = cacDirectElement(parent, \"InvoicePeriod\");\n\tif (!period) return undefined;\n\n\tconst start = cbcText(period, \"StartDate\");\n\tconst end = cbcText(period, \"EndDate\");\n\tif (!start && !end) return undefined;\n\n\treturn {\n\t\tstartDate: start,\n\t\tendDate: end,\n\t\tdescriptionCode: cbcText(period, \"DescriptionCode\"),\n\t};\n}\n\nfunction parseDelivery(root: Element): UblDelivery | undefined {\n\tconst delivery = cacElement(root, \"Delivery\");\n\tif (!delivery) return undefined;\n\tconst actualDeliveryDate = cbcText(delivery, \"ActualDeliveryDate\");\n\tconst deliveryLocation = cacElement(delivery, \"DeliveryLocation\");\n\tconst address = parseAddressFromElement(\n\t\tdeliveryLocation ? cacElement(deliveryLocation, \"Address\") : null,\n\t);\n\tif (!actualDeliveryDate && !address) return undefined;\n\treturn {\n\t\tactualDeliveryDate,\n\t\taddress,\n\t};\n}\n\nfunction parsePaymentTermsNote(root: Element): string | undefined {\n\tconst paymentTerms = cacElement(root, \"PaymentTerms\");\n\tif (!paymentTerms) return undefined;\n\treturn cbcText(paymentTerms, \"Note\");\n}\n\nfunction parseNotes(root: Element): string | undefined {\n\tconst noteEls = root.getElementsByTagNameNS(CBC_NS, \"Note\");\n\tconst notes: string[] = [];\n\tfor (let i = 0; i < noteEls.length; i++) {\n\t\tconst el = noteEls[i];\n\t\tif (!el) continue;\n\t\tif (el.parentElement === root || el.parentNode === root) {\n\t\t\tconst text = el.textContent?.trim();\n\t\t\tif (text) notes.push(text);\n\t\t}\n\t}\n\treturn notes.length > 0 ? notes.join(\"\\n\") : undefined;\n}\n\nfunction parseAttachments(root: Element): {\n\tattachments: UblAttachment[] | undefined;\n\tdocumentReferences: UblDocumentReference[] | undefined;\n} {\n\tconst refs = cacElements(root, \"AdditionalDocumentReference\");\n\tconst attachments: UblAttachment[] = [];\n\tconst documentReferences: UblDocumentReference[] = [];\n\n\tfor (const ref of refs) {\n\t\tconst attachment = cacElement(ref, \"Attachment\");\n\t\tconst refId = cbcText(ref, \"ID\");\n\t\tconst description = cbcText(ref, \"DocumentDescription\");\n\n\t\tif (!attachment) {\n\t\t\t// Text-only document reference (e.g. terms & conditions, notices)\n\t\t\tif (refId || description) {\n\t\t\t\tdocumentReferences.push({ id: refId, description });\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst binaryEl = attachment.getElementsByTagNameNS(\n\t\t\tCBC_NS,\n\t\t\t\"EmbeddedDocumentBinaryObject\",\n\t\t)[0];\n\t\tconst externalRef = cacElement(attachment, \"ExternalReference\");\n\n\t\tif (binaryEl) {\n\t\t\tconst content = binaryEl.textContent?.trim();\n\t\t\tif (content) {\n\t\t\t\tattachments.push({\n\t\t\t\t\tid: refId,\n\t\t\t\t\tfilename: attribute(binaryEl, \"filename\"),\n\t\t\t\t\tmimeCode: attribute(binaryEl, \"mimeCode\"),\n\t\t\t\t\tdescription,\n\t\t\t\t\tbase64Content: content,\n\t\t\t\t});\n\t\t\t}\n\t\t} else if (externalRef) {\n\t\t\tconst uri = cbcText(externalRef, \"URI\");\n\t\t\tif (uri) {\n\t\t\t\tattachments.push({\n\t\t\t\t\tid: refId,\n\t\t\t\t\tdescription,\n\t\t\t\t\texternalUri: uri,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\n\treturn {\n\t\tattachments: attachments.length > 0 ? attachments : undefined,\n\t\tdocumentReferences:\n\t\t\tdocumentReferences.length > 0 ? documentReferences : undefined,\n\t};\n}\n\nfunction parseBillingReference(root: Element): UblBillingReference | undefined {\n\tconst billingRef = cacElement(root, \"BillingReference\");\n\tif (!billingRef) return undefined;\n\tconst invoiceRef = cacElement(billingRef, \"InvoiceDocumentReference\");\n\tif (!invoiceRef) return undefined;\n\tconst invoiceId = cbcText(invoiceRef, \"ID\");\n\tconst invoiceIssueDate = cbcText(invoiceRef, \"IssueDate\");\n\tif (!invoiceId && !invoiceIssueDate) return undefined;\n\treturn { invoiceId, invoiceIssueDate };\n}\n\n// --- Main parser ---\n\n/**\n * Drop `undefined`-valued keys recursively so an absent field is an absent\n * key, not a key holding `undefined`. Arrays keep their order and length.\n */\nfunction omitUndefined<T>(value: T): T {\n\tif (Array.isArray(value)) {\n\t\treturn value.map(omitUndefined) as T;\n\t}\n\tif (value !== null && typeof value === \"object\") {\n\t\tconst out: Record<string, unknown> = {};\n\t\tfor (const [key, entry] of Object.entries(value as Record<string, unknown>)) {\n\t\t\tif (entry !== undefined) out[key] = omitUndefined(entry);\n\t\t}\n\t\treturn out as T;\n\t}\n\treturn value;\n}\n\nconst INVOICE_NS = \"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2\";\nconst CREDIT_NOTE_NS = \"urn:oasis:names:specification:ubl:schema:xsd:CreditNote-2\";\n\n/**\n * Parse a UBL 2.1 Invoice or CreditNote.\n *\n * Returns `null` when the XML is well-formed but its root is not a UBL\n * `Invoice`/`CreditNote`. Throws {@link UblParseError} when the XML is\n * malformed or the document lacks an element EN 16931 makes mandatory\n * (document id, issue date, currency, line id).\n */\nexport function parseUblInvoice(xml: string): UblInvoice | null {\n\tconst doc = parseXmlDocument(xml);\n\tconst root = doc.documentElement;\n\tif (!root) return null;\n\n\tlet documentType: \"Invoice\" | \"CreditNote\";\n\tif (root.localName === \"Invoice\" && root.namespaceURI === INVOICE_NS) {\n\t\tdocumentType = \"Invoice\";\n\t} else if (\n\t\troot.localName === \"CreditNote\" &&\n\t\troot.namespaceURI === CREDIT_NOTE_NS\n\t) {\n\t\tdocumentType = \"CreditNote\";\n\t} else {\n\t\treturn null;\n\t}\n\n\tconst isCreditNote = documentType === \"CreditNote\";\n\tconst id = requiredCbcText(root, \"ID\", \"document identifier\");\n\tconst issueDate = requiredCbcText(root, \"IssueDate\", \"issue date\");\n\tconst currency = requiredCbcText(root, \"DocumentCurrencyCode\", \"currency code\");\n\tconst paymentMeansList = parsePaymentMeansList(root);\n\tconst orderReference = cacElement(root, \"OrderReference\");\n\tconst contractReference = cacElement(root, \"ContractDocumentReference\");\n\tconst projectReference = cacElement(root, \"ProjectReference\");\n\tconst { attachments, documentReferences } = parseAttachments(root);\n\n\treturn omitUndefined<UblInvoice>({\n\t\tdocumentType,\n\t\tcustomizationId: cbcText(root, \"CustomizationID\"),\n\t\tprofileId: cbcText(root, \"ProfileID\"),\n\t\tid,\n\t\tinvoiceTypeCode:\n\t\t\tcbcText(root, \"InvoiceTypeCode\") ?? cbcText(root, \"CreditNoteTypeCode\"),\n\t\tissueDate,\n\t\tdueDate: cbcText(root, \"DueDate\"),\n\t\ttaxPointDate: cbcText(root, \"TaxPointDate\"),\n\t\tcurrency,\n\t\tbuyerReference: cbcText(root, \"BuyerReference\"),\n\t\torderReference: orderReference ? cbcText(orderReference, \"ID\") : undefined,\n\t\tsalesOrderId: orderReference\n\t\t\t? cbcText(orderReference, \"SalesOrderID\")\n\t\t\t: undefined,\n\t\tcontractReference: contractReference\n\t\t\t? cbcText(contractReference, \"ID\")\n\t\t\t: undefined,\n\t\tprojectReference: projectReference\n\t\t\t? cbcText(projectReference, \"ID\")\n\t\t\t: undefined,\n\t\tbillingReference: parseBillingReference(root),\n\t\tseller: parseParty(root, \"AccountingSupplierParty\"),\n\t\tbuyer: parseParty(root, \"AccountingCustomerParty\"),\n\t\tdelivery: parseDelivery(root),\n\t\tlines: parseLines(root, isCreditNote),\n\t\ttaxTotal: parseTaxTotal(root),\n\t\tmonetaryTotal: parseMonetaryTotal(root),\n\t\tpaymentMeansList,\n\t\tpaymentMeans: paymentMeansList?.[0],\n\t\tinvoicePeriod: parseInvoicePeriod(root),\n\t\tnote: parseNotes(root),\n\t\tpaymentTermsNote: parsePaymentTermsNote(root),\n\t\tattachments,\n\t\tdocumentReferences,\n\t\tallowanceCharges: parseAllowanceCharges(root),\n\t});\n}\n","import { UblParseError } from \"./errors.js\";\nimport { parseUblInvoice } from \"./parser.js\";\nimport type { UblAttachment } from \"./types.js\";\n\n/**\n * An embedded attachment extracted from a UBL document's\n * `AdditionalDocumentReference` entries, with its binary content still\n * base64-encoded. `sizeBytes` is the decoded size.\n */\nexport interface UblEmbeddedAttachment {\n\tid?: string | undefined;\n\tfilename: string;\n\tmimeCode: string;\n\tsizeBytes: number;\n\t/** Zero-based position among the document's embedded attachments. */\n\tlineOrder: number;\n\tbase64Content: string;\n}\n\n/** Decoded byte length of a base64 string, accounting for `=` padding. */\nexport const base64DecodedSize = (base64: string): number => {\n\tconst sanitized = base64.replace(/\\s+/g, \"\");\n\tif (!sanitized) return 0;\n\tconst padding = sanitized.endsWith(\"==\") ? 2 : sanitized.endsWith(\"=\") ? 1 : 0;\n\treturn Math.floor((sanitized.length * 3) / 4) - padding;\n};\n\n/**\n * Extract the embedded attachments (typically the human-readable PDF) from a\n * UBL invoice or credit note XML. Attachments referenced only by external URI\n * (no `EmbeddedDocumentBinaryObject`) are skipped; use {@link parseUblInvoice}\n * directly when those matter.\n *\n * @throws {UblParseError} when the XML is malformed or not a UBL invoice.\n */\nexport const extractUblEmbeddedAttachments = (xml: string): UblEmbeddedAttachment[] => {\n\tconst parsed = parseUblInvoice(xml);\n\tif (!parsed) throw new UblParseError(\"Document is not a UBL Invoice or CreditNote\");\n\tif (!parsed.attachments || parsed.attachments.length === 0) return [];\n\n\treturn parsed.attachments\n\t\t.map((attachment, index): UblEmbeddedAttachment | null => {\n\t\t\tconst base64Content = attachment.base64Content?.trim();\n\t\t\tif (!base64Content) return null;\n\t\t\treturn {\n\t\t\t\tid: attachment.id,\n\t\t\t\tfilename: attachment.filename ?? `attachment-${index + 1}`,\n\t\t\t\tmimeCode: attachment.mimeCode ?? \"application/octet-stream\",\n\t\t\t\tsizeBytes: base64DecodedSize(base64Content),\n\t\t\t\tlineOrder: index,\n\t\t\t\tbase64Content,\n\t\t\t};\n\t\t})\n\t\t.filter((entry): entry is UblEmbeddedAttachment => entry !== null);\n};\n\n/**\n * Whether an attachment looks like a PDF, by MIME type first and filename\n * extension as a fallback.\n */\nexport const isPdfLikeAttachment = (\n\tattachment: Pick<UblAttachment, \"filename\" | \"mimeCode\">,\n): boolean => {\n\tconst mimeCode = attachment.mimeCode?.toLowerCase() ?? \"\";\n\tif (mimeCode === \"application/pdf\" || mimeCode.endsWith(\"/pdf\")) return true;\n\treturn attachment.filename?.toLowerCase().endsWith(\".pdf\") ?? false;\n};\n","import type { Element } from \"@xmldom/xmldom\";\nimport { UblParseError } from \"./errors.js\";\nimport { CAC_NS, CBC_NS, parseXmlDocument } from \"./xml-dom.js\";\n\n/**\n * Peppol BIS MLR (Message Level Response) document-type identifier value\n * (Peppol `busdox-docid-qns` scheme).\n */\nexport const PEPPOL_MLR_DOCUMENT_TYPE_VALUE =\n\t\"urn:oasis:names:specification:ubl:schema:xsd:ApplicationResponse-2::ApplicationResponse##urn:fdc:peppol.eu:poacc:trns:mlr:3::2.1\";\n\n/** Peppol BIS MLR process identifier value. */\nexport const PEPPOL_MLR_PROCESS_VALUE = \"urn:fdc:peppol.eu:poacc:bis:mlr:3\";\n\n/**\n * A parsed Peppol Message Level Response (a UBL `ApplicationResponse`). Every\n * field is optional: a given MLR may omit any of them, and an omitted field is\n * an absent key.\n */\nexport interface PeppolMessageLevelResponse {\n\tcustomizationId?: string | undefined;\n\tprofileId?: string | undefined;\n\tresponseId?: string | undefined;\n\tissueDate?: string | undefined;\n\tissueTime?: string | undefined;\n\treferencedDocumentId?: string | undefined;\n\tresponseCode?: string | undefined;\n\tdescription?: string | undefined;\n\t/** Sender participant id as `schemeID:value` (e.g. `0208:0793904121`). */\n\tsenderIdentifier?: string | undefined;\n\t/** Receiver participant id as `schemeID:value`. */\n\treceiverIdentifier?: string | undefined;\n}\n\nconst trimmed = (value: string | null | undefined): string | undefined => {\n\tconst text = value?.trim();\n\treturn text ? text : undefined;\n};\n\n/** First descendant CBC element's trimmed text, or undefined. */\nconst cbcText = (parent: Element, tag: string): string | undefined =>\n\ttrimmed(parent.getElementsByTagNameNS(CBC_NS, tag)[0]?.textContent);\n\n/**\n * First direct-child CBC element's trimmed text, or null. Used for the\n * top-level scalars so a nested `cbc:ID` (e.g. inside DocumentReference) cannot\n * shadow the ApplicationResponse's own id.\n */\nconst cbcDirectText = (parent: Element, tag: string): string | undefined => {\n\tfor (let i = 0; i < parent.childNodes.length; i++) {\n\t\tconst node = parent.childNodes[i];\n\t\tif (!node || node.nodeType !== 1) continue;\n\t\tconst el = node as Element;\n\t\tif (el.namespaceURI === CBC_NS && el.localName === tag) {\n\t\t\treturn trimmed(el.textContent);\n\t\t}\n\t}\n\treturn undefined;\n};\n\n/** First descendant CAC element, or null. */\nconst cacElement = (parent: Element, tag: string): Element | null =>\n\tparent.getElementsByTagNameNS(CAC_NS, tag)[0] ?? null;\n\n/**\n * The Peppol participant identifier of a SenderParty / ReceiverParty, rendered\n * as `schemeID:value` when the EndpointID carries a scheme and the value does\n * not already include one, otherwise the raw value.\n */\nconst endpointIdentifier = (party: Element | null): string | undefined => {\n\tif (!party) return undefined;\n\tconst endpoint = party.getElementsByTagNameNS(CBC_NS, \"EndpointID\")[0];\n\tif (!endpoint) return undefined;\n\tconst id = trimmed(endpoint.textContent);\n\tconst scheme = endpoint.getAttribute(\"schemeID\");\n\tif (scheme && id && !id.includes(\":\")) return `${scheme}:${id}`;\n\treturn id;\n};\n\n/**\n * Locate the `ApplicationResponse` element, unwrapping a Standard Business\n * Document (SBDH) envelope when present. Returns null when the XML contains no\n * ApplicationResponse; throws {@link UblParseError} when it is malformed.\n */\nconst findApplicationResponse = (xml: string): Element | null => {\n\tconst doc = parseXmlDocument(xml);\n\tconst root = doc.documentElement;\n\tif (!root) return null;\n\tif (root.localName === \"ApplicationResponse\") return root;\n\tconst candidates = root.getElementsByTagName(\"*\");\n\tfor (let i = 0; i < candidates.length; i++) {\n\t\tconst el = candidates[i];\n\t\tif (el?.localName === \"ApplicationResponse\") return el;\n\t}\n\treturn null;\n};\n\n/**\n * Whether an inbound document is a Peppol Message Level Response, identified by\n * its document-type value, its process value, or by parsing the XML and finding\n * an `ApplicationResponse` root (SBDH-wrapped or not).\n */\nexport const isPeppolMessageLevelResponse = (params: {\n\tdocumentTypeValue?: string | null;\n\tprocessValue?: string | null;\n\txml?: string | null;\n}): boolean => {\n\tif (trimmed(params.documentTypeValue) === PEPPOL_MLR_DOCUMENT_TYPE_VALUE) {\n\t\treturn true;\n\t}\n\tif (trimmed(params.processValue) === PEPPOL_MLR_PROCESS_VALUE) return true;\n\tconst xml = trimmed(params.xml);\n\tif (!xml) return false;\n\ttry {\n\t\treturn findApplicationResponse(xml) !== null;\n\t} catch (error) {\n\t\t// A sniff answers \"is this an MLR?\"; malformed XML is simply \"no\".\n\t\tif (error instanceof UblParseError) return false;\n\t\tthrow error;\n\t}\n};\n\n/**\n * Parse a Peppol Message Level Response (UBL `ApplicationResponse`), unwrapping\n * an SBDH envelope when present. Throws {@link UblParseError} when the XML is\n * malformed or is not an ApplicationResponse.\n */\nexport const parsePeppolMessageLevelResponse = (\n\txml: string,\n): PeppolMessageLevelResponse => {\n\tconst root = findApplicationResponse(xml);\n\tif (!root) {\n\t\tthrow new UblParseError(\"Document is not a Peppol Message Level Response\");\n\t}\n\n\tconst documentResponse = cacElement(root, \"DocumentResponse\");\n\tconst response = documentResponse ? cacElement(documentResponse, \"Response\") : null;\n\tconst documentReference = documentResponse\n\t\t? cacElement(documentResponse, \"DocumentReference\")\n\t\t: null;\n\n\treturn {\n\t\tcustomizationId: cbcDirectText(root, \"CustomizationID\"),\n\t\tprofileId: cbcDirectText(root, \"ProfileID\"),\n\t\tresponseId: cbcDirectText(root, \"ID\"),\n\t\tissueDate: cbcDirectText(root, \"IssueDate\"),\n\t\tissueTime: cbcDirectText(root, \"IssueTime\"),\n\t\treferencedDocumentId: documentReference\n\t\t\t? cbcText(documentReference, \"ID\")\n\t\t\t: undefined,\n\t\tresponseCode: response ? cbcText(response, \"ResponseCode\") : undefined,\n\t\tdescription: response ? cbcText(response, \"Description\") : undefined,\n\t\tsenderIdentifier: endpointIdentifier(cacElement(root, \"SenderParty\")),\n\t\treceiverIdentifier: endpointIdentifier(cacElement(root, \"ReceiverParty\")),\n\t};\n};\n","import { base64DecodedSize } from \"./attachments.js\";\nimport { UblParseError } from \"./errors.js\";\nimport { parseUblInvoice } from \"./parser.js\";\nimport type {\n\tInvoiceExtractionDTO,\n\tUblAddress,\n\tUblAllowanceCharge,\n\tUblAttachment,\n\tUblInvoice,\n\tUblPaymentMeans,\n} from \"./types.js\";\n\n// --- Utility helpers ---\n\nconst UTF8_BOM = 0xfeff;\n\n/** `null` for an absent value or an \"N/A\" placeholder written by the sender. */\nconst normalizeText = (value: string | undefined): string | null => {\n\tif (value === undefined) return null;\n\tconst upper = value.toUpperCase();\n\tif (upper === \"NA\" || upper === \"N/A\") return null;\n\treturn value;\n};\n\nconst toNumberOrNull = (value: number | undefined): number | null =>\n\tvalue !== undefined && Number.isFinite(value) ? value : null;\n\nconst roundToCents = (value: number): number => Math.round(value * 100) / 100;\n\nexport const normalizeCurrency = (value?: string | null): string | null => {\n\tif (!value) return null;\n\tconst trimmed = value.trim();\n\tif (!trimmed) return null;\n\treturn trimmed.toUpperCase();\n};\n\nexport const parseDate = (value?: string | null): string | null => {\n\tif (!value) return null;\n\tconst trimmed = value.trim();\n\tif (!trimmed) return null;\n\tconst timestamp = Date.parse(trimmed);\n\tif (Number.isNaN(timestamp)) return null;\n\tconst iso = new Date(timestamp).toISOString();\n\treturn iso.slice(0, 10);\n};\n\nconst sanitizePaymentMeans = (pm: UblPaymentMeans) => ({\n\tcode: normalizeText(pm.code),\n\tcode_name: normalizeText(pm.codeName),\n\tpayment_id: normalizeText(pm.paymentId),\n\tiban: normalizeText(pm.iban),\n\tbic: normalizeText(pm.bic),\n\taccount_name: normalizeText(pm.accountName),\n\tmandate_id: normalizeText(pm.mandateId),\n});\n\n// --- Address helpers ---\n\nconst present = (part: string | undefined): part is string => part !== undefined;\n\nconst joinStreet = (address: UblAddress): string =>\n\t[address.street, address.additionalStreet].filter(present).join(\" \");\n\nconst addressToString = (address?: UblAddress): string | null => {\n\tif (!address) return null;\n\tconst street = joinStreet(address);\n\tconst cityLine = [address.postalZone, address.city].filter(present).join(\" \");\n\tconst countryLine = [address.countrySubentity, address.countryCode]\n\t\t.filter(present)\n\t\t.join(\" \");\n\tconst lines = [street, cityLine, countryLine].filter((line) => line.length > 0);\n\treturn lines.length > 0 ? lines.join(\"\\n\") : null;\n};\n\nconst addressToStructured = (address?: UblAddress) => {\n\tif (!address) return null;\n\tconst line1 = joinStreet(address);\n\tconst result = {\n\t\tline1: line1 ? normalizeText(line1) : null,\n\t\tline2: null as string | null,\n\t\tcity: normalizeText(address.city),\n\t\tstate: normalizeText(address.countrySubentity),\n\t\tpostal_code: normalizeText(address.postalZone),\n\t\tcountry: normalizeText(address.countryCode),\n\t};\n\tconst hasValue = Object.values(result).some((value) => value);\n\treturn hasValue ? result : null;\n};\n\n// --- Attachment & charge sanitizers ---\n\nconst sanitizeAttachments = (attachments?: UblAttachment[]) =>\n\t(attachments ?? []).map((attachment) => ({\n\t\tid: normalizeText(attachment.id),\n\t\tfilename: normalizeText(attachment.filename),\n\t\tmime_code: normalizeText(attachment.mimeCode),\n\t\tdescription: normalizeText(attachment.description),\n\t\tsize_bytes:\n\t\t\tattachment.base64Content !== undefined\n\t\t\t\t? base64DecodedSize(attachment.base64Content)\n\t\t\t\t: null,\n\t\texternal_uri: normalizeText(attachment.externalUri),\n\t}));\n\nconst sanitizeAllowanceCharges = (charges?: UblAllowanceCharge[]) =>\n\t(charges ?? []).map((charge) => ({\n\t\tcharge_indicator: charge.chargeIndicator,\n\t\tamount: toNumberOrNull(charge.amount),\n\t\tbase_amount: toNumberOrNull(charge.baseAmount),\n\t\tmultiplier_factor_numeric: toNumberOrNull(charge.multiplierFactorNumeric),\n\t\treason: normalizeText(charge.reason),\n\t\treason_code: normalizeText(charge.reasonCode),\n\t\ttax_percent: toNumberOrNull(charge.taxCategory?.percent),\n\t\ttax_category_id: normalizeText(charge.taxCategory?.id),\n\t\ttax_scheme_id: normalizeText(charge.taxCategory?.schemeId),\n\t}));\n\nconst sanitizeRawUbl = (ubl: UblInvoice) => ({\n\t...ubl,\n\tattachments: sanitizeAttachments(ubl.attachments),\n\tdocumentReferences: ubl.documentReferences ?? [],\n});\n\n// --- Summation helpers ---\n\nconst sumTaxTotal = (ubl: UblInvoice): number | null => {\n\tconst { subtotals } = ubl.taxTotal;\n\tconst subtotalSum = subtotals.reduce(\n\t\t(sum, subtotal) => sum + (subtotal.taxAmount ?? 0),\n\t\t0,\n\t);\n\tif (subtotals.length > 0 && Number.isFinite(subtotalSum)) {\n\t\treturn subtotalSum;\n\t}\n\tconst { taxInclusiveAmount, taxExclusiveAmount } = ubl.monetaryTotal;\n\tif (taxInclusiveAmount === undefined || taxExclusiveAmount === undefined) {\n\t\treturn null;\n\t}\n\treturn taxInclusiveAmount - taxExclusiveAmount;\n};\n\nconst sumAllowanceChargesByType = (\n\tcharges: UblAllowanceCharge[] | undefined,\n\tchargeIndicator: boolean,\n) =>\n\t(charges ?? []).reduce((sum, charge) => {\n\t\tif (charge.chargeIndicator !== chargeIndicator) return sum;\n\t\treturn sum + Math.abs(charge.amount ?? 0);\n\t}, 0);\n\n// --- Public API ---\n\n/**\n * Decode raw XML bytes, stripping an optional UTF-8 BOM.\n */\nexport const decodeXmlBytes = (bytes: Uint8Array): string => {\n\tconst text = new TextDecoder(\"utf-8\").decode(bytes);\n\treturn text.charCodeAt(0) === UTF8_BOM ? text.slice(1) : text;\n};\n\n/**\n * Parse a UBL XML string and normalize it into a flat DTO suitable for\n * database storage or API responses.\n *\n * @throws {UblParseError} when the XML is malformed, not a UBL invoice, or\n * lacks a mandatory element.\n */\nexport const normalizeUblResponse = (\n\txml: string,\n\tdocumentId: string,\n): {\n\textracted: InvoiceExtractionDTO;\n\trawPayload: Record<string, unknown>;\n} => {\n\tconst ubl = parseUblInvoice(xml);\n\tif (!ubl) {\n\t\tthrow new UblParseError(\"Document is not a UBL Invoice or CreditNote\");\n\t}\n\n\tconst subtotal =\n\t\ttoNumberOrNull(ubl.monetaryTotal.taxExclusiveAmount) ??\n\t\ttoNumberOrNull(ubl.monetaryTotal.lineExtensionAmount);\n\tconst total =\n\t\ttoNumberOrNull(ubl.monetaryTotal.taxInclusiveAmount) ??\n\t\ttoNumberOrNull(ubl.monetaryTotal.payableAmount);\n\tconst amountDue = toNumberOrNull(ubl.monetaryTotal.payableAmount);\n\tconst prepaidAmount = toNumberOrNull(ubl.monetaryTotal.prepaidAmount);\n\tconst roundingAmount = toNumberOrNull(ubl.monetaryTotal.payableRoundingAmount) ?? 0;\n\t// BR-CO-16: payable = total - prepaid + rounding. With no declared\n\t// PrepaidAmount we invert that to infer what was paid, but the rounding\n\t// term has to come out first — a cash-rounded payable (BT-114) is a\n\t// total-vs-payable gap by design, and reading it as a prepayment reports\n\t// an unpaid invoice as partially settled. Rounded before the sign test so\n\t// the float residue of undoing it cannot pass as a sub-cent prepayment.\n\tconst inferredPaid =\n\t\ttotal !== null && amountDue !== null\n\t\t\t? roundToCents(total - (amountDue - roundingAmount))\n\t\t\t: null;\n\tconst amountPaid =\n\t\tprepaidAmount ??\n\t\t(inferredPaid !== null && inferredPaid > 0 ? inferredPaid : null);\n\tconst taxTotal = toNumberOrNull(sumTaxTotal(ubl) ?? undefined);\n\tconst hasHeaderAllowanceCharges = (ubl.allowanceCharges?.length ?? 0) > 0;\n\tconst headerDiscountTotal = sumAllowanceChargesByType(ubl.allowanceCharges, false);\n\tconst headerChargeTotal = sumAllowanceChargesByType(ubl.allowanceCharges, true);\n\tconst currency = normalizeCurrency(ubl.currency);\n\tconst paymentTerms = normalizeText(ubl.paymentTermsNote);\n\tconst poNumber =\n\t\tnormalizeText(ubl.orderReference) ?? normalizeText(ubl.salesOrderId);\n\n\tconst lineItems = ubl.lines.map((line) => ({\n\t\tdescription:\n\t\t\tnormalizeText(line.description) ??\n\t\t\tnormalizeText(line.itemName) ??\n\t\t\t\"Line item\",\n\t\tquantity: toNumberOrNull(line.quantity),\n\t\tunit: normalizeText(line.unitCode),\n\t\tunit_price: toNumberOrNull(line.unitPrice),\n\t\tamount: toNumberOrNull(line.lineExtensionAmount),\n\t\ttax_amount: toNumberOrNull(line.taxAmount),\n\t\ttax_rate: toNumberOrNull(line.taxCategory?.percent),\n\t\tproduct_code:\n\t\t\tnormalizeText(line.sellersItemId) ?? normalizeText(line.buyersItemId),\n\t\tdiscount_amount: toNumberOrNull(line.discountAmount),\n\t\tperiod_start: parseDate(line.invoicePeriod?.startDate),\n\t\tperiod_end: parseDate(line.invoicePeriod?.endDate),\n\t\textra: {\n\t\t\tubl_line_id: normalizeText(line.id),\n\t\t\titem_name: normalizeText(line.itemName),\n\t\t\tsellers_item_id: normalizeText(line.sellersItemId),\n\t\t\tbuyers_item_id: normalizeText(line.buyersItemId),\n\t\t\ttax_category_id: normalizeText(line.taxCategory?.id),\n\t\t\ttax_scheme_id: normalizeText(line.taxCategory?.schemeId),\n\t\t\ttax_subtotals: line.taxSubtotals ?? [],\n\t\t\tallowance_charges: sanitizeAllowanceCharges(line.allowanceCharges),\n\t\t\tcharge_amount: toNumberOrNull(line.chargeAmount),\n\t\t\tmetadata: line.additionalItemProperties\n\t\t\t\t? Object.fromEntries(\n\t\t\t\t\t\tline.additionalItemProperties.map((p) => [p.name, p.value]),\n\t\t\t\t\t)\n\t\t\t\t: null,\n\t\t},\n\t}));\n\n\tconst supplierAddress = addressToString(ubl.seller.address);\n\tconst receiverAddress = addressToString(ubl.buyer.address);\n\tconst supplierAddressStructured = addressToStructured(ubl.seller.address);\n\tconst receiverAddressStructured = addressToStructured(ubl.buyer.address);\n\tconst attachmentMetadata = sanitizeAttachments(ubl.attachments);\n\tconst paymentMeansList =\n\t\tubl.paymentMeansList && ubl.paymentMeansList.length > 0\n\t\t\t? ubl.paymentMeansList\n\t\t\t: ubl.paymentMeans\n\t\t\t\t? [ubl.paymentMeans]\n\t\t\t\t: [];\n\n\tconst extracted: InvoiceExtractionDTO = {\n\t\tprovider: \"ubl_xml\",\n\t\tdocument_id: documentId,\n\t\tinvoice: {\n\t\t\tinvoice_number: normalizeText(ubl.id),\n\t\t\tinvoice_date: parseDate(ubl.issueDate),\n\t\t\tdue_date: parseDate(ubl.dueDate),\n\t\t\tperiod_start: parseDate(ubl.invoicePeriod?.startDate),\n\t\t\tperiod_end: parseDate(ubl.invoicePeriod?.endDate),\n\t\t\tcurrency,\n\t\t\tsubtotal,\n\t\t\ttax_total: taxTotal,\n\t\t\ttotal,\n\t\t\tamount_due: amountDue,\n\t\t\tamount_paid: amountPaid,\n\t\t\tdiscount_total:\n\t\t\t\ttoNumberOrNull(ubl.monetaryTotal.allowanceTotalAmount) ??\n\t\t\t\t(hasHeaderAllowanceCharges\n\t\t\t\t\t? toNumberOrNull(headerDiscountTotal)\n\t\t\t\t\t: null),\n\t\t\tshipping_total:\n\t\t\t\ttoNumberOrNull(ubl.monetaryTotal.chargeTotalAmount) ??\n\t\t\t\t(hasHeaderAllowanceCharges ? toNumberOrNull(headerChargeTotal) : null),\n\t\t\trounding_total: toNumberOrNull(ubl.monetaryTotal.payableRoundingAmount),\n\t\t\tpayment_terms: paymentTerms,\n\t\t\tpo_number: poNumber,\n\t\t\tsupplier: {\n\t\t\t\tname:\n\t\t\t\t\tnormalizeText(ubl.seller.name) ??\n\t\t\t\t\tnormalizeText(ubl.seller.registrationName),\n\t\t\t\taddress: supplierAddress,\n\t\t\t\ttax_id:\n\t\t\t\t\tnormalizeText(ubl.seller.vatId) ??\n\t\t\t\t\tnormalizeText(ubl.seller.companyId?.value),\n\t\t\t\tiban: normalizeText(ubl.paymentMeans?.iban),\n\t\t\t\tbic: normalizeText(ubl.paymentMeans?.bic),\n\t\t\t},\n\t\t\treceiver: {\n\t\t\t\tname:\n\t\t\t\t\tnormalizeText(ubl.buyer.name) ??\n\t\t\t\t\tnormalizeText(ubl.buyer.registrationName),\n\t\t\t\taddress: receiverAddress,\n\t\t\t\ttax_id:\n\t\t\t\t\tnormalizeText(ubl.buyer.vatId) ??\n\t\t\t\t\tnormalizeText(ubl.buyer.companyId?.value),\n\t\t\t},\n\t\t\textra: {\n\t\t\t\tdocument_type: ubl.documentType,\n\t\t\t\tcustomization_id: normalizeText(ubl.customizationId),\n\t\t\t\tprofile_id: normalizeText(ubl.profileId),\n\t\t\t\tinvoice_type_code: normalizeText(ubl.invoiceTypeCode),\n\t\t\t\tbuyer_reference: normalizeText(ubl.buyerReference),\n\t\t\t\torder_reference_id: normalizeText(ubl.orderReference),\n\t\t\t\tsales_order_id: normalizeText(ubl.salesOrderId),\n\t\t\t\tcontract_reference: normalizeText(ubl.contractReference),\n\t\t\t\tproject_reference: normalizeText(ubl.projectReference),\n\t\t\t\tbilling_reference: ubl.billingReference\n\t\t\t\t\t? {\n\t\t\t\t\t\t\tinvoice_id: normalizeText(ubl.billingReference.invoiceId),\n\t\t\t\t\t\t\tinvoice_issue_date: parseDate(\n\t\t\t\t\t\t\t\tubl.billingReference.invoiceIssueDate,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t}\n\t\t\t\t\t: null,\n\t\t\t\ttax_point_date: parseDate(ubl.taxPointDate),\n\t\t\t\tinvoice_period: ubl.invoicePeriod ?? null,\n\t\t\t\tnote: normalizeText(ubl.note),\n\t\t\t\tpayment_means: ubl.paymentMeans\n\t\t\t\t\t? sanitizePaymentMeans(ubl.paymentMeans)\n\t\t\t\t\t: null,\n\t\t\t\tpayment_means_list: paymentMeansList.map(sanitizePaymentMeans),\n\t\t\t\tdelivery: ubl.delivery\n\t\t\t\t\t? {\n\t\t\t\t\t\t\tactual_delivery_date: parseDate(\n\t\t\t\t\t\t\t\tubl.delivery.actualDeliveryDate,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\taddress: addressToStructured(ubl.delivery.address),\n\t\t\t\t\t\t}\n\t\t\t\t\t: null,\n\t\t\t\tsupplier: {\n\t\t\t\t\tendpoint_id: normalizeText(ubl.seller.endpoint?.value),\n\t\t\t\t\tendpoint_scheme_id: normalizeText(ubl.seller.endpoint?.scheme),\n\t\t\t\t\tregistration_name: normalizeText(ubl.seller.registrationName),\n\t\t\t\t\tcompany_legal_form: normalizeText(ubl.seller.companyLegalForm),\n\t\t\t\t\tcompany_id_scheme_id: normalizeText(ubl.seller.companyId?.scheme),\n\t\t\t\t\ttax_scheme_id: normalizeText(ubl.seller.taxSchemeId),\n\t\t\t\t\tparty_identifications: ubl.seller.partyIdentifications ?? [],\n\t\t\t\t\tcontact_name: normalizeText(ubl.seller.contact?.name),\n\t\t\t\t\tcontact_phone: normalizeText(ubl.seller.contact?.phone),\n\t\t\t\t\tcontact_email: normalizeText(ubl.seller.contact?.email),\n\t\t\t\t},\n\t\t\t\treceiver: {\n\t\t\t\t\tendpoint_id: normalizeText(ubl.buyer.endpoint?.value),\n\t\t\t\t\tendpoint_scheme_id: normalizeText(ubl.buyer.endpoint?.scheme),\n\t\t\t\t\tregistration_name: normalizeText(ubl.buyer.registrationName),\n\t\t\t\t\tcompany_legal_form: normalizeText(ubl.buyer.companyLegalForm),\n\t\t\t\t\tcompany_id_scheme_id: normalizeText(ubl.buyer.companyId?.scheme),\n\t\t\t\t\ttax_scheme_id: normalizeText(ubl.buyer.taxSchemeId),\n\t\t\t\t\tparty_identifications: ubl.buyer.partyIdentifications ?? [],\n\t\t\t\t\tcontact_name: normalizeText(ubl.buyer.contact?.name),\n\t\t\t\t\tcontact_phone: normalizeText(ubl.buyer.contact?.phone),\n\t\t\t\t\tcontact_email: normalizeText(ubl.buyer.contact?.email),\n\t\t\t\t},\n\t\t\t\tsupplier_address_structured: supplierAddressStructured,\n\t\t\t\treceiver_address_structured: receiverAddressStructured,\n\t\t\t\ttax_subtotals: ubl.taxTotal.subtotals,\n\t\t\t\tallowance_charges: sanitizeAllowanceCharges(ubl.allowanceCharges),\n\t\t\t\tattachments: attachmentMetadata,\n\t\t\t\tdocument_references: ubl.documentReferences ?? [],\n\t\t\t},\n\t\t},\n\t\tline_items: lineItems,\n\t\tconfidence: {\n\t\t\toverall: 1,\n\t\t\tfields: {\n\t\t\t\tinvoice_id: 1,\n\t\t\t\tinvoice_date: 1,\n\t\t\t\tdue_date: 1,\n\t\t\t\ttotal_amount: 1,\n\t\t\t\tsupplier_name: 1,\n\t\t\t},\n\t\t},\n\t};\n\n\treturn {\n\t\textracted,\n\t\trawPayload: {\n\t\t\tformat: \"ubl_xml\",\n\t\t\tinvoice: sanitizeRawUbl(ubl),\n\t\t},\n\t};\n};\n\n/**\n * Parse a UBL invoice from raw bytes and normalize it into a DTO.\n */\nexport const parseUblInvoiceDocument = (params: {\n\tbytes: Uint8Array;\n\tdocumentId: string;\n\tmimeType: string;\n}) => {\n\tconst xml = decodeXmlBytes(params.bytes);\n\tconst { extracted, rawPayload } = normalizeUblResponse(xml, params.documentId);\n\treturn {\n\t\trawPayload: {\n\t\t\t...rawPayload,\n\t\t\tmime_type: params.mimeType,\n\t\t},\n\t\textracted,\n\t\tproviderJobId: null as string | null,\n\t};\n};\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.js","names":["XmlDomParser","trimmed","cbcText","cacElement","cbcDirectText"],"sources":["../src/xml-dom.ts","../src/parser.ts","../src/attachments.ts","../src/mlr.ts","../src/normalize.ts"],"sourcesContent":["import { type Document, DOMParser as XmlDomParser } from \"@xmldom/xmldom\";\nimport { UblParseError } from \"./errors.js\";\n\nexport const CBC_NS =\n\t\"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2\";\nexport const CAC_NS =\n\t\"urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2\";\n\n/**\n * Strip DOCTYPE declarations to prevent XXE (XML External Entity) attacks.\n * @xmldom/xmldom resolves external entities by default, so we remove DOCTYPE\n * blocks (including inline DTD subsets) before parsing.\n */\nexport const stripDoctype = (xml: string): string =>\n\txml.replace(/<!DOCTYPE\\s[^>[]*(?:\\[[^\\]]*\\])?>/gi, \"\");\n\n/**\n * Parse XML into a DOM, preferring the host's `DOMParser` (browsers) and\n * falling back to @xmldom/xmldom. Throws {@link UblParseError} when the XML\n * is malformed.\n */\nexport const parseXmlDocument = (xml: string): Document => {\n\tconst safeXml = stripDoctype(xml);\n\tconst BrowserDomParser = (globalThis as { DOMParser?: typeof XmlDomParser })\n\t\t.DOMParser;\n\tconst parser = BrowserDomParser ? new BrowserDomParser() : new XmlDomParser();\n\tlet doc: Document;\n\ttry {\n\t\tdoc = parser.parseFromString(safeXml, \"text/xml\");\n\t} catch (cause) {\n\t\tthrow new UblParseError(\"Malformed XML\", { cause });\n\t}\n\tif (doc.getElementsByTagName(\"parsererror\").length > 0 || !doc.documentElement) {\n\t\tthrow new UblParseError(\"Malformed XML\");\n\t}\n\treturn doc;\n};\n","import type { Element } from \"@xmldom/xmldom\";\nimport type {\n\tUblAddress,\n\tUblAllowanceCharge,\n\tUblAttachment,\n\tUblBillingReference,\n\tUblCommodityClassification,\n\tUblContact,\n\tUblDelivery,\n\tUblDocumentReference,\n\tUblInvoice,\n\tUblInvoicePeriod,\n\tUblItemProperty,\n\tUblLine,\n\tUblMonetaryTotal,\n\tUblParty,\n\tUblPartyIdentification,\n\tUblPaymentMeans,\n\tUblSchemedId,\n\tUblTaxCategory,\n\tUblTaxSubtotal,\n\tUblTaxTotal,\n} from \"./types.js\";\nimport { UblParseError } from \"./errors.js\";\nimport { CAC_NS, CBC_NS, parseXmlDocument } from \"./xml-dom.js\";\n\n// --- DOM helpers ---\n\nconst trimmed = (value: string | null | undefined): string | undefined => {\n\tconst text = value?.trim();\n\treturn text ? text : undefined;\n};\n\n/** First descendant CBC element's trimmed text; absent or blank is `undefined`. */\nfunction cbcText(parent: Element, tag: string): string | undefined {\n\treturn trimmed(parent.getElementsByTagNameNS(CBC_NS, tag)[0]?.textContent);\n}\n\n/** Like {@link cbcText} but throws: the element is mandatory in EN 16931. */\nfunction requiredCbcText(parent: Element, tag: string, what: string): string {\n\tconst value = cbcText(parent, tag);\n\tif (value === undefined) throw new UblParseError(`Missing ${what} (cbc:${tag})`);\n\treturn value;\n}\n\nconst toNumber = (value: string | undefined): number | undefined => {\n\tif (value === undefined) return undefined;\n\tconst parsed = Number.parseFloat(value);\n\treturn Number.isNaN(parsed) ? undefined : parsed;\n};\n\nfunction cacElement(parent: Element, tag: string): Element | null {\n\treturn parent.getElementsByTagNameNS(CAC_NS, tag)[0] ?? null;\n}\n\nfunction cacElements(parent: Element, tag: string): Element[] {\n\treturn Array.from(parent.getElementsByTagNameNS(CAC_NS, tag));\n}\n\n/** First descendant CBC element as a number; absent or non-numeric is `undefined`. */\nfunction cbcNumber(parent: Element, tag: string): number | undefined {\n\treturn toNumber(cbcText(parent, tag));\n}\n\nfunction childElementsByTagNs(\n\tparent: Element,\n\tnamespace: string,\n\ttag: string,\n): Element[] {\n\tconst elements: Element[] = [];\n\tfor (let i = 0; i < parent.childNodes.length; i++) {\n\t\tconst node = parent.childNodes[i];\n\t\tif (!node || node.nodeType !== 1) continue;\n\t\tconst element = node as Element;\n\t\tif (element.namespaceURI === namespace && element.localName === tag) {\n\t\t\telements.push(element);\n\t\t}\n\t}\n\treturn elements;\n}\n\nfunction cbcDirectText(parent: Element, tag: string): string | undefined {\n\treturn trimmed(childElementsByTagNs(parent, CBC_NS, tag)[0]?.textContent);\n}\n\nfunction cbcDirectNumber(parent: Element, tag: string): number | undefined {\n\treturn toNumber(cbcDirectText(parent, tag));\n}\n\nconst attribute = (el: Element | null | undefined, name: string): string | undefined =>\n\ttrimmed(el?.getAttribute(name));\n\n/** A direct `cbc:<tag>` child with its `@schemeID`. */\nfunction cbcDirectSchemedId(parent: Element, tag: string): UblSchemedId | undefined {\n\tconst element = childElementsByTagNs(parent, CBC_NS, tag)[0];\n\tconst value = trimmed(element?.textContent);\n\treturn value !== undefined\n\t\t? { value, scheme: attribute(element, \"schemeID\") }\n\t\t: undefined;\n}\n\nfunction cacDirectElement(parent: Element, tag: string): Element | null {\n\treturn childElementsByTagNs(parent, CAC_NS, tag)[0] ?? null;\n}\n\nfunction cacDirectElements(parent: Element, tag: string): Element[] {\n\treturn childElementsByTagNs(parent, CAC_NS, tag);\n}\n\n// --- Section parsers ---\n\nfunction parseAddressFromElement(address: Element | null): UblAddress | undefined {\n\tif (!address) return undefined;\n\tconst country = cacElement(address, \"Country\");\n\treturn {\n\t\tstreet: cbcText(address, \"StreetName\"),\n\t\tadditionalStreet: cbcText(address, \"AdditionalStreetName\"),\n\t\tcity: cbcText(address, \"CityName\"),\n\t\tpostalZone: cbcText(address, \"PostalZone\"),\n\t\tcountrySubentity: cbcText(address, \"CountrySubentity\"),\n\t\tcountryCode: country ? cbcText(country, \"IdentificationCode\") : undefined,\n\t};\n}\n\nfunction parseAddress(party: Element): UblAddress | undefined {\n\tconst postal = cacElement(party, \"PostalAddress\");\n\treturn parseAddressFromElement(postal);\n}\n\nfunction parseTaxSchemeId(parent: Element | null): string | undefined {\n\tif (!parent) return undefined;\n\tconst taxScheme = cacElement(parent, \"TaxScheme\");\n\tif (!taxScheme) return undefined;\n\treturn cbcText(taxScheme, \"ID\");\n}\n\nfunction parseContact(party: Element): UblContact | undefined {\n\tconst contact = cacElement(party, \"Contact\");\n\tif (!contact) return undefined;\n\tconst name = cbcText(contact, \"Name\");\n\tconst phone = cbcText(contact, \"Telephone\");\n\tconst email = cbcText(contact, \"ElectronicMail\");\n\tif (!name && !phone && !email) return undefined;\n\treturn { name, phone, email };\n}\n\nfunction parsePartyIdentifications(party: Element): UblPartyIdentification[] {\n\tconst ids = cacElements(party, \"PartyIdentification\");\n\tconst result: UblPartyIdentification[] = [];\n\tfor (const idEl of ids) {\n\t\tconst idValue = cbcText(idEl, \"ID\");\n\t\tif (!idValue) continue;\n\t\tresult.push({\n\t\t\tid: idValue,\n\t\t\tschemeId: attribute(\n\t\t\t\tidEl.getElementsByTagNameNS(CBC_NS, \"ID\")[0],\n\t\t\t\t\"schemeID\",\n\t\t\t),\n\t\t});\n\t}\n\treturn result;\n}\n\nfunction parseParty(root: Element, role: string): UblParty {\n\tconst wrapper = cacDirectElement(root, role);\n\tconst party = wrapper ? cacElement(wrapper, \"Party\") : null;\n\treturn party ? parsePartyElement(party) : {};\n}\n\n/**\n * `cac:PayeeParty` (BG-10) and `cac:TaxRepresentativeParty` (BG-11) carry the\n * party children directly, without a `cac:Party` wrapper.\n */\nfunction parseUnwrappedParty(root: Element, tag: string): UblParty | undefined {\n\tconst party = cacDirectElement(root, tag);\n\tif (!party) return undefined;\n\tconst parsed = parsePartyElement(party);\n\treturn Object.values(parsed).some((value) => value !== undefined)\n\t\t? parsed\n\t\t: undefined;\n}\n\nfunction parsePartyElement(party: Element): UblParty {\n\tconst partyName = cacElement(party, \"PartyName\");\n\tconst legalEntity = cacElement(party, \"PartyLegalEntity\");\n\tconst taxScheme = cacElement(party, \"PartyTaxScheme\");\n\tconst partyId = cacElement(party, \"PartyIdentification\");\n\tconst endpointEl = party.getElementsByTagNameNS(CBC_NS, \"EndpointID\")[0];\n\tconst partyIdentifications = parsePartyIdentifications(party);\n\tconst companyIdEl = legalEntity\n\t\t? legalEntity.getElementsByTagNameNS(CBC_NS, \"CompanyID\")[0]\n\t\t: null;\n\n\tconst endpointValue = trimmed(endpointEl?.textContent);\n\tconst companyIdValue = companyIdEl\n\t\t? trimmed(companyIdEl.textContent)\n\t\t: partyId\n\t\t\t? cbcText(partyId, \"ID\")\n\t\t\t: undefined;\n\n\treturn {\n\t\tname: partyName ? cbcText(partyName, \"Name\") : undefined,\n\t\tregistrationName: legalEntity\n\t\t\t? cbcText(legalEntity, \"RegistrationName\")\n\t\t\t: undefined,\n\t\tcompanyLegalForm: legalEntity\n\t\t\t? cbcText(legalEntity, \"CompanyLegalForm\")\n\t\t\t: undefined,\n\t\tvatId: taxScheme ? cbcText(taxScheme, \"CompanyID\") : undefined,\n\t\ttaxSchemeId: parseTaxSchemeId(taxScheme),\n\t\tcompanyId:\n\t\t\tcompanyIdValue !== undefined\n\t\t\t\t? { value: companyIdValue, scheme: attribute(companyIdEl, \"schemeID\") }\n\t\t\t\t: undefined,\n\t\tendpoint:\n\t\t\tendpointValue !== undefined\n\t\t\t\t? { value: endpointValue, scheme: attribute(endpointEl, \"schemeID\") }\n\t\t\t\t: undefined,\n\t\tpartyIdentifications:\n\t\t\tpartyIdentifications.length > 0 ? partyIdentifications : undefined,\n\t\taddress: parseAddress(party),\n\t\tcontact: parseContact(party),\n\t};\n}\n\n/**\n * `cac:TaxCategory` / `cac:ClassifiedTaxCategory`. Emitted whenever the\n * element states anything; `percentFallback` covers the E-FFF habit of putting\n * `cbc:Percent` on the subtotal instead of inside the category.\n */\nfunction parseTaxCategory(\n\tcat: Element | null,\n\tpercentFallback?: Element,\n): UblTaxCategory | undefined {\n\tconst percentFromParent = percentFallback\n\t\t? cbcDirectNumber(percentFallback, \"Percent\")\n\t\t: undefined;\n\tif (!cat) {\n\t\treturn percentFromParent !== undefined\n\t\t\t? { percent: percentFromParent }\n\t\t\t: undefined;\n\t}\n\tconst category: UblTaxCategory = {\n\t\tid: cbcText(cat, \"ID\"),\n\t\tpercent: cbcNumber(cat, \"Percent\") ?? percentFromParent,\n\t\tschemeId: parseTaxSchemeId(cat),\n\t\texemptionReason: cbcText(cat, \"TaxExemptionReason\"),\n\t\texemptionReasonCode: cbcText(cat, \"TaxExemptionReasonCode\"),\n\t};\n\treturn Object.values(category).some((value) => value !== undefined)\n\t\t? category\n\t\t: undefined;\n}\n\nfunction parseTaxSubtotal(sub: Element): UblTaxSubtotal {\n\treturn {\n\t\ttaxableAmount: cbcNumber(sub, \"TaxableAmount\"),\n\t\ttaxAmount: cbcNumber(sub, \"TaxAmount\"),\n\t\tcategory: parseTaxCategory(cacElement(sub, \"TaxCategory\"), sub),\n\t};\n}\n\nfunction parseTaxSubtotalsFromTaxTotal(taxTotal: Element): UblTaxSubtotal[] {\n\treturn cacDirectElements(taxTotal, \"TaxSubtotal\").map(parseTaxSubtotal);\n}\n\n/**\n * `cac:TaxTotal` (BG-22). BT-110 is read from the first `cac:TaxTotal` as\n * stated, never summed from the subtotals; the subtotals of every `TaxTotal`\n * (a second one carries the accounting-currency figure) are concatenated.\n */\nfunction parseTaxTotal(root: Element): UblTaxTotal {\n\tconst taxTotals = cacDirectElements(root, \"TaxTotal\");\n\tconst first = taxTotals[0];\n\tconst second = taxTotals[1];\n\treturn {\n\t\ttaxAmount: first ? cbcDirectNumber(first, \"TaxAmount\") : undefined,\n\t\tsubtotals: taxTotals.flatMap(parseTaxSubtotalsFromTaxTotal),\n\t\ttaxAmountInTaxCurrency: second\n\t\t\t? cbcDirectNumber(second, \"TaxAmount\")\n\t\t\t: undefined,\n\t};\n}\n\nfunction parseAllowanceCharge(charge: Element): UblAllowanceCharge {\n\tconst taxCategory = cacElement(charge, \"TaxCategory\");\n\tconst indicatorRaw = cbcDirectText(charge, \"ChargeIndicator\")?.toLowerCase();\n\tconst chargeIndicator = indicatorRaw === \"true\" || indicatorRaw === \"1\";\n\treturn {\n\t\tchargeIndicator,\n\t\tamount: cbcNumber(charge, \"Amount\"),\n\t\tbaseAmount: cbcDirectNumber(charge, \"BaseAmount\"),\n\t\tmultiplierFactorNumeric: cbcDirectNumber(charge, \"MultiplierFactorNumeric\"),\n\t\treason: cbcText(charge, \"AllowanceChargeReason\"),\n\t\treasonCode: cbcText(charge, \"AllowanceChargeReasonCode\"),\n\t\ttaxCategory: parseTaxCategory(taxCategory),\n\t};\n}\n\nfunction parseAllowanceCharges(parent: Element): UblAllowanceCharge[] {\n\treturn cacDirectElements(parent, \"AllowanceCharge\").map(parseAllowanceCharge);\n}\n\nfunction mergeTaxCategories(\n\tpreferred: UblTaxCategory | undefined,\n\tfallback: UblTaxCategory | undefined,\n): UblTaxCategory | undefined {\n\tif (!preferred) return fallback;\n\tif (!fallback) return preferred;\n\treturn {\n\t\tid: preferred.id ?? fallback.id,\n\t\tpercent: preferred.percent ?? fallback.percent,\n\t\tschemeId: preferred.schemeId ?? fallback.schemeId,\n\t\texemptionReason: preferred.exemptionReason ?? fallback.exemptionReason,\n\t\texemptionReasonCode:\n\t\t\tpreferred.exemptionReasonCode ?? fallback.exemptionReasonCode,\n\t};\n}\n\nfunction parseLines(root: Element, isCreditNote: boolean): UblLine[] {\n\tconst qtyTag = isCreditNote ? \"CreditedQuantity\" : \"InvoicedQuantity\";\n\tconst lineTag = isCreditNote ? \"CreditNoteLine\" : \"InvoiceLine\";\n\n\treturn cacElements(root, lineTag).map((line) => {\n\t\tconst item = cacElement(line, \"Item\");\n\t\tconst price = cacElement(line, \"Price\");\n\t\tconst classifiedCategory = parseTaxCategory(\n\t\t\titem ? cacElement(item, \"ClassifiedTaxCategory\") : null,\n\t\t);\n\t\tconst sellersId = item ? cacElement(item, \"SellersItemIdentification\") : null;\n\t\tconst buyersId = item ? cacElement(item, \"BuyersItemIdentification\") : null;\n\t\tconst qtyEl = line.getElementsByTagNameNS(CBC_NS, qtyTag)[0];\n\t\tconst lineExtensionAmount = cbcNumber(line, \"LineExtensionAmount\");\n\t\tconst lineTaxTotal = cacDirectElement(line, \"TaxTotal\");\n\t\tconst lineTaxSubtotals = lineTaxTotal\n\t\t\t? parseTaxSubtotalsFromTaxTotal(lineTaxTotal)\n\t\t\t: [];\n\t\tconst taxAmountFromSubtotals = lineTaxSubtotals.reduce(\n\t\t\t(sum, subtotal) => sum + (subtotal.taxAmount ?? 0),\n\t\t\t0,\n\t\t);\n\t\tconst taxAmountFromLineTotal = lineTaxTotal\n\t\t\t? cbcDirectNumber(lineTaxTotal, \"TaxAmount\")\n\t\t\t: undefined;\n\t\t// A line-level TaxSubtotal (E-FFF) wins over the classified category,\n\t\t// field by field.\n\t\tconst subtotalCategory = lineTaxSubtotals[0]?.category;\n\t\tconst taxCategory = mergeTaxCategories(subtotalCategory, classifiedCategory);\n\t\tconst taxPercent = taxCategory?.percent;\n\t\tconst computedTaxAmount =\n\t\t\ttaxPercent !== undefined && lineExtensionAmount !== undefined\n\t\t\t\t? Number(((lineExtensionAmount * taxPercent) / 100).toFixed(2))\n\t\t\t\t: undefined;\n\t\tconst allowanceCharges = parseAllowanceCharges(line);\n\t\t// BT-147/BT-148: the one allowance UBL permits under cac:Price.\n\t\tconst priceAllowanceElement = price\n\t\t\t? parseAllowanceCharges(price).find((charge) => !charge.chargeIndicator)\n\t\t\t: undefined;\n\t\tconst priceAllowance = priceAllowanceElement\n\t\t\t? {\n\t\t\t\t\tamount: priceAllowanceElement.amount,\n\t\t\t\t\tbaseAmount: priceAllowanceElement.baseAmount,\n\t\t\t\t\treason: priceAllowanceElement.reason,\n\t\t\t\t}\n\t\t\t: undefined;\n\t\tconst discountAmount =\n\t\t\tallowanceCharges.reduce(\n\t\t\t\t(sum, charge) =>\n\t\t\t\t\tcharge.chargeIndicator ? sum : sum + Math.abs(charge.amount ?? 0),\n\t\t\t\t0,\n\t\t\t) + Math.abs(priceAllowance?.amount ?? 0);\n\t\tconst chargeAmount = allowanceCharges.reduce(\n\t\t\t(sum, charge) =>\n\t\t\t\tcharge.chargeIndicator ? sum + Math.abs(charge.amount ?? 0) : sum,\n\t\t\t0,\n\t\t);\n\n\t\tconst additionalItemProperties: UblItemProperty[] = [];\n\t\tif (item) {\n\t\t\tfor (const prop of cacElements(item, \"AdditionalItemProperty\")) {\n\t\t\t\tconst propName = cbcText(prop, \"Name\");\n\t\t\t\tconst propValue = cbcText(prop, \"Value\");\n\t\t\t\tif (propName) {\n\t\t\t\t\tadditionalItemProperties.push({\n\t\t\t\t\t\tname: propName,\n\t\t\t\t\t\tvalue: propValue,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// EN16931 BT-146 (PriceAmount) is the price for BT-149 (BaseQuantity) units\n\t\t// of the item, not necessarily for one unit. Effective unit price is\n\t\t// PriceAmount / BaseQuantity, with BaseQuantity defaulting to 1 when absent.\n\t\tconst priceAmount = price ? cbcNumber(price, \"PriceAmount\") : undefined;\n\t\tconst priceBaseQuantity = price\n\t\t\t? cbcDirectNumber(price, \"BaseQuantity\")\n\t\t\t: undefined;\n\t\tconst unitPrice =\n\t\t\tpriceAmount !== undefined && priceBaseQuantity && priceBaseQuantity > 0\n\t\t\t\t? priceAmount / priceBaseQuantity\n\t\t\t\t: priceAmount;\n\n\t\tconst orderLineReference = cacDirectElement(line, \"OrderLineReference\");\n\t\tconst lineDocumentReference = cacDirectElements(line, \"DocumentReference\").find(\n\t\t\t(reference) => cbcDirectText(reference, \"DocumentTypeCode\") === \"130\",\n\t\t);\n\t\tconst standardId = item\n\t\t\t? cacDirectElement(item, \"StandardItemIdentification\")\n\t\t\t: null;\n\t\tconst originCountry = item ? cacDirectElement(item, \"OriginCountry\") : null;\n\t\tconst commodityClassifications: UblCommodityClassification[] = [];\n\t\tfor (const classification of item\n\t\t\t? cacDirectElements(item, \"CommodityClassification\")\n\t\t\t: []) {\n\t\t\tconst codeElement = childElementsByTagNs(\n\t\t\t\tclassification,\n\t\t\t\tCBC_NS,\n\t\t\t\t\"ItemClassificationCode\",\n\t\t\t)[0];\n\t\t\tconst value = trimmed(codeElement?.textContent);\n\t\t\tif (value === undefined) continue;\n\t\t\tcommodityClassifications.push({\n\t\t\t\tvalue,\n\t\t\t\tlistId: attribute(codeElement, \"listID\"),\n\t\t\t\tlistVersionId: attribute(codeElement, \"listVersionID\"),\n\t\t\t});\n\t\t}\n\n\t\treturn {\n\t\t\tid: requiredCbcText(line, \"ID\", `${lineTag} identifier`),\n\t\t\tnote: cbcDirectText(line, \"Note\"),\n\t\t\tobjectIdentifier: lineDocumentReference\n\t\t\t\t? cbcDirectSchemedId(lineDocumentReference, \"ID\")\n\t\t\t\t: undefined,\n\t\t\torderLineReference: orderLineReference\n\t\t\t\t? cbcDirectText(orderLineReference, \"LineID\")\n\t\t\t\t: undefined,\n\t\t\taccountingCost: cbcDirectText(line, \"AccountingCost\"),\n\t\t\tdescription: item ? cbcText(item, \"Description\") : undefined,\n\t\t\tquantity: cbcNumber(line, qtyTag),\n\t\t\tunitCode: attribute(qtyEl, \"unitCode\"),\n\t\t\tunitPrice,\n\t\t\tlineExtensionAmount,\n\t\t\tbaseQuantity: priceBaseQuantity,\n\t\t\ttaxCategory,\n\t\t\ttaxAmount:\n\t\t\t\ttaxAmountFromLineTotal ??\n\t\t\t\t(lineTaxSubtotals.length > 0\n\t\t\t\t\t? taxAmountFromSubtotals\n\t\t\t\t\t: computedTaxAmount),\n\t\t\ttaxSubtotals: lineTaxSubtotals.length > 0 ? lineTaxSubtotals : undefined,\n\t\t\tallowanceCharges:\n\t\t\t\tallowanceCharges.length > 0 ? allowanceCharges : undefined,\n\t\t\tpriceAllowance,\n\t\t\tdiscountAmount: discountAmount > 0 ? discountAmount : undefined,\n\t\t\tchargeAmount: chargeAmount > 0 ? chargeAmount : undefined,\n\t\t\titemName: item ? cbcText(item, \"Name\") : undefined,\n\t\t\tsellersItemId: sellersId ? cbcText(sellersId, \"ID\") : undefined,\n\t\t\tbuyersItemId: buyersId ? cbcText(buyersId, \"ID\") : undefined,\n\t\t\tstandardItemId: standardId\n\t\t\t\t? cbcDirectSchemedId(standardId, \"ID\")\n\t\t\t\t: undefined,\n\t\t\tcommodityClassifications:\n\t\t\t\tcommodityClassifications.length > 0\n\t\t\t\t\t? commodityClassifications\n\t\t\t\t\t: undefined,\n\t\t\toriginCountryCode: originCountry\n\t\t\t\t? cbcDirectText(originCountry, \"IdentificationCode\")\n\t\t\t\t: undefined,\n\t\t\tadditionalItemProperties:\n\t\t\t\tadditionalItemProperties.length > 0\n\t\t\t\t\t? additionalItemProperties\n\t\t\t\t\t: undefined,\n\t\t\tinvoicePeriod: parseInvoicePeriod(line),\n\t\t};\n\t});\n}\n\nfunction parseMonetaryTotal(root: Element): UblMonetaryTotal {\n\tconst total = cacDirectElement(root, \"LegalMonetaryTotal\");\n\tif (!total) return {};\n\treturn {\n\t\tlineExtensionAmount: cbcNumber(total, \"LineExtensionAmount\"),\n\t\ttaxExclusiveAmount: cbcNumber(total, \"TaxExclusiveAmount\"),\n\t\ttaxInclusiveAmount: cbcNumber(total, \"TaxInclusiveAmount\"),\n\t\tallowanceTotalAmount: cbcNumber(total, \"AllowanceTotalAmount\"),\n\t\tchargeTotalAmount: cbcNumber(total, \"ChargeTotalAmount\"),\n\t\tprepaidAmount: cbcNumber(total, \"PrepaidAmount\"),\n\t\tpayableRoundingAmount: cbcNumber(total, \"PayableRoundingAmount\"),\n\t\tpayableAmount: cbcNumber(total, \"PayableAmount\"),\n\t};\n}\n\nfunction parsePaymentMeansElement(pm: Element): UblPaymentMeans {\n\tconst account = cacElement(pm, \"PayeeFinancialAccount\");\n\tconst branch = account ? cacElement(account, \"FinancialInstitutionBranch\") : null;\n\tconst paymentMeansCodeEl = pm.getElementsByTagNameNS(CBC_NS, \"PaymentMeansCode\")[0];\n\tconst mandate = cacElement(pm, \"PaymentMandate\");\n\tconst debitedAccount = mandate\n\t\t? cacElement(mandate, \"PayerFinancialAccount\")\n\t\t: null;\n\tconst card = cacElement(pm, \"CardAccount\");\n\n\treturn {\n\t\tcode: cbcText(pm, \"PaymentMeansCode\"),\n\t\tcodeName: attribute(paymentMeansCodeEl, \"name\"),\n\t\tpaymentId: cbcText(pm, \"PaymentID\"),\n\t\tiban: account ? cbcText(account, \"ID\") : undefined,\n\t\tbic: branch ? cbcText(branch, \"ID\") : undefined,\n\t\taccountName: account ? cbcText(account, \"Name\") : undefined,\n\t\tmandateId: mandate ? cbcDirectText(mandate, \"ID\") : undefined,\n\t\tdebitedAccount: debitedAccount ? cbcText(debitedAccount, \"ID\") : undefined,\n\t\tcardNumber: card ? cbcText(card, \"PrimaryAccountNumberID\") : undefined,\n\t\tcardHolder: card ? cbcText(card, \"HolderName\") : undefined,\n\t};\n}\n\nfunction parsePaymentMeansList(root: Element): UblPaymentMeans[] | undefined {\n\tconst list = cacElements(root, \"PaymentMeans\").map(parsePaymentMeansElement);\n\treturn list.length > 0 ? list : undefined;\n}\n\n/**\n * BT-73/BT-74 on a document, BT-134/BT-135 on a line. Direct children only:\n * a descendant search on the document root would report the first line's\n * period as the document's whenever the document states none of its own.\n */\nfunction parseInvoicePeriod(parent: Element): UblInvoicePeriod | undefined {\n\tconst period = cacDirectElement(parent, \"InvoicePeriod\");\n\tif (!period) return undefined;\n\n\tconst start = cbcText(period, \"StartDate\");\n\tconst end = cbcText(period, \"EndDate\");\n\tif (!start && !end) return undefined;\n\n\treturn {\n\t\tstartDate: start,\n\t\tendDate: end,\n\t\tdescriptionCode: cbcText(period, \"DescriptionCode\"),\n\t};\n}\n\nfunction parseDelivery(root: Element): UblDelivery | undefined {\n\tconst delivery = cacElement(root, \"Delivery\");\n\tif (!delivery) return undefined;\n\tconst actualDeliveryDate = cbcText(delivery, \"ActualDeliveryDate\");\n\tconst deliveryLocation = cacElement(delivery, \"DeliveryLocation\");\n\tconst locationId = deliveryLocation\n\t\t? cbcDirectSchemedId(deliveryLocation, \"ID\")\n\t\t: undefined;\n\tconst address = parseAddressFromElement(\n\t\tdeliveryLocation ? cacElement(deliveryLocation, \"Address\") : null,\n\t);\n\tconst deliveryParty = cacElement(delivery, \"DeliveryParty\");\n\tconst partyName = deliveryParty ? cbcText(deliveryParty, \"Name\") : undefined;\n\tif (!actualDeliveryDate && !locationId && !address && !partyName) return undefined;\n\treturn {\n\t\tactualDeliveryDate,\n\t\tlocationId,\n\t\taddress,\n\t\tpartyName,\n\t};\n}\n\nfunction parsePaymentTermsNote(root: Element): string | undefined {\n\tconst paymentTerms = cacElement(root, \"PaymentTerms\");\n\tif (!paymentTerms) return undefined;\n\treturn cbcText(paymentTerms, \"Note\");\n}\n\nfunction parseNotes(root: Element): string | undefined {\n\tconst noteEls = root.getElementsByTagNameNS(CBC_NS, \"Note\");\n\tconst notes: string[] = [];\n\tfor (let i = 0; i < noteEls.length; i++) {\n\t\tconst el = noteEls[i];\n\t\tif (!el) continue;\n\t\tif (el.parentElement === root || el.parentNode === root) {\n\t\t\tconst text = el.textContent?.trim();\n\t\t\tif (text) notes.push(text);\n\t\t}\n\t}\n\treturn notes.length > 0 ? notes.join(\"\\n\") : undefined;\n}\n\n/**\n * `cac:AdditionalDocumentReference` (BG-24), plus the two references EN 16931\n * types by `cbc:DocumentTypeCode`: 130 is the invoiced object (BT-18) and 50\n * is the tender or lot (BT-17), which on a credit note stands in for the\n * project reference (BT-11) UBL's CreditNote has no element for.\n */\nfunction parseAttachments(root: Element): {\n\tattachments: UblAttachment[] | undefined;\n\tdocumentReferences: UblDocumentReference[] | undefined;\n\tinvoicedObjectId: UblSchemedId | undefined;\n\ttypeCode50Reference: string | undefined;\n} {\n\tconst refs = cacDirectElements(root, \"AdditionalDocumentReference\");\n\tconst attachments: UblAttachment[] = [];\n\tconst documentReferences: UblDocumentReference[] = [];\n\tlet invoicedObjectId: UblSchemedId | undefined;\n\tlet typeCode50Reference: string | undefined;\n\n\tfor (const ref of refs) {\n\t\tconst attachment = cacElement(ref, \"Attachment\");\n\t\tconst refId = cbcText(ref, \"ID\");\n\t\tconst description = cbcText(ref, \"DocumentDescription\");\n\t\tconst typeCode = cbcDirectText(ref, \"DocumentTypeCode\");\n\n\t\tif (typeCode === \"130\" && !attachment) {\n\t\t\tinvoicedObjectId ??= cbcDirectSchemedId(ref, \"ID\");\n\t\t\tcontinue;\n\t\t}\n\t\tif (typeCode === \"50\" && !attachment) {\n\t\t\ttypeCode50Reference ??= refId;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (!attachment) {\n\t\t\t// Text-only document reference (e.g. terms & conditions, notices)\n\t\t\tif (refId || description) {\n\t\t\t\tdocumentReferences.push({ id: refId, description });\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst binaryEl = attachment.getElementsByTagNameNS(\n\t\t\tCBC_NS,\n\t\t\t\"EmbeddedDocumentBinaryObject\",\n\t\t)[0];\n\t\tconst externalRef = cacElement(attachment, \"ExternalReference\");\n\n\t\tif (binaryEl) {\n\t\t\tconst content = binaryEl.textContent?.trim();\n\t\t\tif (content) {\n\t\t\t\tattachments.push({\n\t\t\t\t\tid: refId,\n\t\t\t\t\tfilename: attribute(binaryEl, \"filename\"),\n\t\t\t\t\tmimeCode: attribute(binaryEl, \"mimeCode\"),\n\t\t\t\t\tdescription,\n\t\t\t\t\tbase64Content: content,\n\t\t\t\t});\n\t\t\t}\n\t\t} else if (externalRef) {\n\t\t\tconst uri = cbcText(externalRef, \"URI\");\n\t\t\tif (uri) {\n\t\t\t\tattachments.push({\n\t\t\t\t\tid: refId,\n\t\t\t\t\tdescription,\n\t\t\t\t\texternalUri: uri,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\n\treturn {\n\t\tattachments: attachments.length > 0 ? attachments : undefined,\n\t\tdocumentReferences:\n\t\t\tdocumentReferences.length > 0 ? documentReferences : undefined,\n\t\tinvoicedObjectId,\n\t\ttypeCode50Reference,\n\t};\n}\n\nfunction parseBillingReference(root: Element): UblBillingReference | undefined {\n\tconst billingRef = cacElement(root, \"BillingReference\");\n\tif (!billingRef) return undefined;\n\tconst invoiceRef = cacElement(billingRef, \"InvoiceDocumentReference\");\n\tif (!invoiceRef) return undefined;\n\tconst invoiceId = cbcText(invoiceRef, \"ID\");\n\tconst invoiceIssueDate = cbcText(invoiceRef, \"IssueDate\");\n\tif (!invoiceId && !invoiceIssueDate) return undefined;\n\treturn { invoiceId, invoiceIssueDate };\n}\n\n// --- Main parser ---\n\n/**\n * Drop `undefined`-valued keys recursively so an absent field is an absent\n * key, not a key holding `undefined`. Arrays keep their order and length.\n */\nfunction omitUndefined<T>(value: T): T {\n\tif (Array.isArray(value)) {\n\t\treturn value.map(omitUndefined) as T;\n\t}\n\tif (value !== null && typeof value === \"object\") {\n\t\tconst out: Record<string, unknown> = {};\n\t\tfor (const [key, entry] of Object.entries(value as Record<string, unknown>)) {\n\t\t\tif (entry !== undefined) out[key] = omitUndefined(entry);\n\t\t}\n\t\treturn out as T;\n\t}\n\treturn value;\n}\n\nconst INVOICE_NS = \"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2\";\nconst CREDIT_NOTE_NS = \"urn:oasis:names:specification:ubl:schema:xsd:CreditNote-2\";\n\n/**\n * Parse a UBL 2.1 Invoice or CreditNote.\n *\n * Returns `null` when the XML is well-formed but its root is not a UBL\n * `Invoice`/`CreditNote`. Throws {@link UblParseError} when the XML is\n * malformed or the document lacks an element EN 16931 makes mandatory\n * (document id, issue date, currency, line id).\n */\nexport function parseUblInvoice(xml: string): UblInvoice | null {\n\tconst doc = parseXmlDocument(xml);\n\tconst root = doc.documentElement;\n\tif (!root) return null;\n\n\tlet documentType: \"Invoice\" | \"CreditNote\";\n\tif (root.localName === \"Invoice\" && root.namespaceURI === INVOICE_NS) {\n\t\tdocumentType = \"Invoice\";\n\t} else if (\n\t\troot.localName === \"CreditNote\" &&\n\t\troot.namespaceURI === CREDIT_NOTE_NS\n\t) {\n\t\tdocumentType = \"CreditNote\";\n\t} else {\n\t\treturn null;\n\t}\n\n\tconst isCreditNote = documentType === \"CreditNote\";\n\tconst id = requiredCbcText(root, \"ID\", \"document identifier\");\n\tconst issueDate = requiredCbcText(root, \"IssueDate\", \"issue date\");\n\tconst currency = requiredCbcText(root, \"DocumentCurrencyCode\", \"currency code\");\n\tconst paymentMeansList = parsePaymentMeansList(root);\n\tconst orderReference = cacElement(root, \"OrderReference\");\n\tconst contractReference = cacDirectElement(root, \"ContractDocumentReference\");\n\tconst projectReference = cacDirectElement(root, \"ProjectReference\");\n\tconst despatchReference = cacDirectElement(root, \"DespatchDocumentReference\");\n\tconst receiptReference = cacDirectElement(root, \"ReceiptDocumentReference\");\n\tconst { attachments, documentReferences, invoicedObjectId, typeCode50Reference } =\n\t\tparseAttachments(root);\n\t// A credit note has no cbc:DueDate; BT-9 travels in the first PaymentMeans.\n\tconst paymentDueDate = (() => {\n\t\tconst first = cacDirectElements(root, \"PaymentMeans\")[0];\n\t\treturn first ? cbcDirectText(first, \"PaymentDueDate\") : undefined;\n\t})();\n\n\treturn omitUndefined<UblInvoice>({\n\t\tdocumentType,\n\t\tcustomizationId: cbcText(root, \"CustomizationID\"),\n\t\tprofileId: cbcText(root, \"ProfileID\"),\n\t\tid,\n\t\tinvoiceTypeCode:\n\t\t\tcbcText(root, \"InvoiceTypeCode\") ?? cbcText(root, \"CreditNoteTypeCode\"),\n\t\tissueDate,\n\t\tdueDate: cbcDirectText(root, \"DueDate\") ?? paymentDueDate,\n\t\ttaxPointDate: cbcDirectText(root, \"TaxPointDate\"),\n\t\tcurrency,\n\t\ttaxCurrency: cbcDirectText(root, \"TaxCurrencyCode\"),\n\t\taccountingCost: cbcDirectText(root, \"AccountingCost\"),\n\t\tbuyerReference: cbcText(root, \"BuyerReference\"),\n\t\torderReference: orderReference ? cbcText(orderReference, \"ID\") : undefined,\n\t\tsalesOrderId: orderReference\n\t\t\t? cbcText(orderReference, \"SalesOrderID\")\n\t\t\t: undefined,\n\t\tcontractReference: contractReference\n\t\t\t? cbcText(contractReference, \"ID\")\n\t\t\t: undefined,\n\t\tprojectReference: projectReference\n\t\t\t? cbcText(projectReference, \"ID\")\n\t\t\t: isCreditNote\n\t\t\t\t? typeCode50Reference\n\t\t\t\t: undefined,\n\t\treceivingAdviceReference: receiptReference\n\t\t\t? cbcDirectText(receiptReference, \"ID\")\n\t\t\t: undefined,\n\t\tdespatchReference: despatchReference\n\t\t\t? cbcDirectText(despatchReference, \"ID\")\n\t\t\t: undefined,\n\t\ttenderReference: isCreditNote ? undefined : typeCode50Reference,\n\t\tinvoicedObjectId,\n\t\tbillingReference: parseBillingReference(root),\n\t\tseller: parseParty(root, \"AccountingSupplierParty\"),\n\t\tbuyer: parseParty(root, \"AccountingCustomerParty\"),\n\t\tpayee: parseUnwrappedParty(root, \"PayeeParty\"),\n\t\ttaxRepresentative: parseUnwrappedParty(root, \"TaxRepresentativeParty\"),\n\t\tdelivery: parseDelivery(root),\n\t\tlines: parseLines(root, isCreditNote),\n\t\ttaxTotal: parseTaxTotal(root),\n\t\tmonetaryTotal: parseMonetaryTotal(root),\n\t\tpaymentMeansList,\n\t\tpaymentMeans: paymentMeansList?.[0],\n\t\tinvoicePeriod: parseInvoicePeriod(root),\n\t\tnote: parseNotes(root),\n\t\tpaymentTermsNote: parsePaymentTermsNote(root),\n\t\tattachments,\n\t\tdocumentReferences,\n\t\tallowanceCharges: parseAllowanceCharges(root),\n\t});\n}\n","import { UblParseError } from \"./errors.js\";\nimport { parseUblInvoice } from \"./parser.js\";\nimport type { UblAttachment } from \"./types.js\";\n\n/**\n * An embedded attachment extracted from a UBL document's\n * `AdditionalDocumentReference` entries, with its binary content still\n * base64-encoded. `sizeBytes` is the decoded size.\n */\nexport interface UblEmbeddedAttachment {\n\tid?: string | undefined;\n\tfilename: string;\n\tmimeCode: string;\n\tsizeBytes: number;\n\t/** Zero-based position among the document's embedded attachments. */\n\tlineOrder: number;\n\tbase64Content: string;\n}\n\n/** Decoded byte length of a base64 string, accounting for `=` padding. */\nexport const base64DecodedSize = (base64: string): number => {\n\tconst sanitized = base64.replace(/\\s+/g, \"\");\n\tif (!sanitized) return 0;\n\tconst padding = sanitized.endsWith(\"==\") ? 2 : sanitized.endsWith(\"=\") ? 1 : 0;\n\treturn Math.floor((sanitized.length * 3) / 4) - padding;\n};\n\n/**\n * Extract the embedded attachments (typically the human-readable PDF) from a\n * UBL invoice or credit note XML. Attachments referenced only by external URI\n * (no `EmbeddedDocumentBinaryObject`) are skipped; use {@link parseUblInvoice}\n * directly when those matter.\n *\n * @throws {UblParseError} when the XML is malformed or not a UBL invoice.\n */\nexport const extractUblEmbeddedAttachments = (xml: string): UblEmbeddedAttachment[] => {\n\tconst parsed = parseUblInvoice(xml);\n\tif (!parsed) throw new UblParseError(\"Document is not a UBL Invoice or CreditNote\");\n\tif (!parsed.attachments || parsed.attachments.length === 0) return [];\n\n\treturn parsed.attachments\n\t\t.map((attachment, index): UblEmbeddedAttachment | null => {\n\t\t\tconst base64Content = attachment.base64Content?.trim();\n\t\t\tif (!base64Content) return null;\n\t\t\treturn {\n\t\t\t\tid: attachment.id,\n\t\t\t\tfilename: attachment.filename ?? `attachment-${index + 1}`,\n\t\t\t\tmimeCode: attachment.mimeCode ?? \"application/octet-stream\",\n\t\t\t\tsizeBytes: base64DecodedSize(base64Content),\n\t\t\t\tlineOrder: index,\n\t\t\t\tbase64Content,\n\t\t\t};\n\t\t})\n\t\t.filter((entry): entry is UblEmbeddedAttachment => entry !== null);\n};\n\n/**\n * Whether an attachment looks like a PDF, by MIME type first and filename\n * extension as a fallback.\n */\nexport const isPdfLikeAttachment = (\n\tattachment: Pick<UblAttachment, \"filename\" | \"mimeCode\">,\n): boolean => {\n\tconst mimeCode = attachment.mimeCode?.toLowerCase() ?? \"\";\n\tif (mimeCode === \"application/pdf\" || mimeCode.endsWith(\"/pdf\")) return true;\n\treturn attachment.filename?.toLowerCase().endsWith(\".pdf\") ?? false;\n};\n","import type { Element } from \"@xmldom/xmldom\";\nimport { UblParseError } from \"./errors.js\";\nimport { CAC_NS, CBC_NS, parseXmlDocument } from \"./xml-dom.js\";\n\n/**\n * Peppol BIS MLR (Message Level Response) document-type identifier value\n * (Peppol `busdox-docid-qns` scheme).\n */\nexport const PEPPOL_MLR_DOCUMENT_TYPE_VALUE =\n\t\"urn:oasis:names:specification:ubl:schema:xsd:ApplicationResponse-2::ApplicationResponse##urn:fdc:peppol.eu:poacc:trns:mlr:3::2.1\";\n\n/** Peppol BIS MLR process identifier value. */\nexport const PEPPOL_MLR_PROCESS_VALUE = \"urn:fdc:peppol.eu:poacc:bis:mlr:3\";\n\n/**\n * A parsed Peppol Message Level Response (a UBL `ApplicationResponse`). Every\n * field is optional: a given MLR may omit any of them, and an omitted field is\n * an absent key.\n */\nexport interface PeppolMessageLevelResponse {\n\tcustomizationId?: string | undefined;\n\tprofileId?: string | undefined;\n\tresponseId?: string | undefined;\n\tissueDate?: string | undefined;\n\tissueTime?: string | undefined;\n\treferencedDocumentId?: string | undefined;\n\tresponseCode?: string | undefined;\n\tdescription?: string | undefined;\n\t/** Sender participant id as `schemeID:value` (e.g. `0208:0793904121`). */\n\tsenderIdentifier?: string | undefined;\n\t/** Receiver participant id as `schemeID:value`. */\n\treceiverIdentifier?: string | undefined;\n}\n\nconst trimmed = (value: string | null | undefined): string | undefined => {\n\tconst text = value?.trim();\n\treturn text ? text : undefined;\n};\n\n/** First descendant CBC element's trimmed text, or undefined. */\nconst cbcText = (parent: Element, tag: string): string | undefined =>\n\ttrimmed(parent.getElementsByTagNameNS(CBC_NS, tag)[0]?.textContent);\n\n/**\n * First direct-child CBC element's trimmed text, or null. Used for the\n * top-level scalars so a nested `cbc:ID` (e.g. inside DocumentReference) cannot\n * shadow the ApplicationResponse's own id.\n */\nconst cbcDirectText = (parent: Element, tag: string): string | undefined => {\n\tfor (let i = 0; i < parent.childNodes.length; i++) {\n\t\tconst node = parent.childNodes[i];\n\t\tif (!node || node.nodeType !== 1) continue;\n\t\tconst el = node as Element;\n\t\tif (el.namespaceURI === CBC_NS && el.localName === tag) {\n\t\t\treturn trimmed(el.textContent);\n\t\t}\n\t}\n\treturn undefined;\n};\n\n/** First descendant CAC element, or null. */\nconst cacElement = (parent: Element, tag: string): Element | null =>\n\tparent.getElementsByTagNameNS(CAC_NS, tag)[0] ?? null;\n\n/**\n * The Peppol participant identifier of a SenderParty / ReceiverParty, rendered\n * as `schemeID:value` when the EndpointID carries a scheme and the value does\n * not already include one, otherwise the raw value.\n */\nconst endpointIdentifier = (party: Element | null): string | undefined => {\n\tif (!party) return undefined;\n\tconst endpoint = party.getElementsByTagNameNS(CBC_NS, \"EndpointID\")[0];\n\tif (!endpoint) return undefined;\n\tconst id = trimmed(endpoint.textContent);\n\tconst scheme = endpoint.getAttribute(\"schemeID\");\n\tif (scheme && id && !id.includes(\":\")) return `${scheme}:${id}`;\n\treturn id;\n};\n\n/**\n * Locate the `ApplicationResponse` element, unwrapping a Standard Business\n * Document (SBDH) envelope when present. Returns null when the XML contains no\n * ApplicationResponse; throws {@link UblParseError} when it is malformed.\n */\nconst findApplicationResponse = (xml: string): Element | null => {\n\tconst doc = parseXmlDocument(xml);\n\tconst root = doc.documentElement;\n\tif (!root) return null;\n\tif (root.localName === \"ApplicationResponse\") return root;\n\tconst candidates = root.getElementsByTagName(\"*\");\n\tfor (let i = 0; i < candidates.length; i++) {\n\t\tconst el = candidates[i];\n\t\tif (el?.localName === \"ApplicationResponse\") return el;\n\t}\n\treturn null;\n};\n\n/**\n * Whether an inbound document is a Peppol Message Level Response, identified by\n * its document-type value, its process value, or by parsing the XML and finding\n * an `ApplicationResponse` root (SBDH-wrapped or not).\n */\nexport const isPeppolMessageLevelResponse = (params: {\n\tdocumentTypeValue?: string | null;\n\tprocessValue?: string | null;\n\txml?: string | null;\n}): boolean => {\n\tif (trimmed(params.documentTypeValue) === PEPPOL_MLR_DOCUMENT_TYPE_VALUE) {\n\t\treturn true;\n\t}\n\tif (trimmed(params.processValue) === PEPPOL_MLR_PROCESS_VALUE) return true;\n\tconst xml = trimmed(params.xml);\n\tif (!xml) return false;\n\ttry {\n\t\treturn findApplicationResponse(xml) !== null;\n\t} catch (error) {\n\t\t// A sniff answers \"is this an MLR?\"; malformed XML is simply \"no\".\n\t\tif (error instanceof UblParseError) return false;\n\t\tthrow error;\n\t}\n};\n\n/**\n * Parse a Peppol Message Level Response (UBL `ApplicationResponse`), unwrapping\n * an SBDH envelope when present. Throws {@link UblParseError} when the XML is\n * malformed or is not an ApplicationResponse.\n */\nexport const parsePeppolMessageLevelResponse = (\n\txml: string,\n): PeppolMessageLevelResponse => {\n\tconst root = findApplicationResponse(xml);\n\tif (!root) {\n\t\tthrow new UblParseError(\"Document is not a Peppol Message Level Response\");\n\t}\n\n\tconst documentResponse = cacElement(root, \"DocumentResponse\");\n\tconst response = documentResponse ? cacElement(documentResponse, \"Response\") : null;\n\tconst documentReference = documentResponse\n\t\t? cacElement(documentResponse, \"DocumentReference\")\n\t\t: null;\n\n\treturn {\n\t\tcustomizationId: cbcDirectText(root, \"CustomizationID\"),\n\t\tprofileId: cbcDirectText(root, \"ProfileID\"),\n\t\tresponseId: cbcDirectText(root, \"ID\"),\n\t\tissueDate: cbcDirectText(root, \"IssueDate\"),\n\t\tissueTime: cbcDirectText(root, \"IssueTime\"),\n\t\treferencedDocumentId: documentReference\n\t\t\t? cbcText(documentReference, \"ID\")\n\t\t\t: undefined,\n\t\tresponseCode: response ? cbcText(response, \"ResponseCode\") : undefined,\n\t\tdescription: response ? cbcText(response, \"Description\") : undefined,\n\t\tsenderIdentifier: endpointIdentifier(cacElement(root, \"SenderParty\")),\n\t\treceiverIdentifier: endpointIdentifier(cacElement(root, \"ReceiverParty\")),\n\t};\n};\n","import { base64DecodedSize } from \"./attachments.js\";\nimport { UblParseError } from \"./errors.js\";\nimport { parseUblInvoice } from \"./parser.js\";\nimport type {\n\tInvoiceExtractionDTO,\n\tUblAddress,\n\tUblAllowanceCharge,\n\tUblAttachment,\n\tUblInvoice,\n\tUblPaymentMeans,\n} from \"./types.js\";\n\n// --- Utility helpers ---\n\nconst UTF8_BOM = 0xfeff;\n\n/** `null` for an absent value or an \"N/A\" placeholder written by the sender. */\nconst normalizeText = (value: string | undefined): string | null => {\n\tif (value === undefined) return null;\n\tconst upper = value.toUpperCase();\n\tif (upper === \"NA\" || upper === \"N/A\") return null;\n\treturn value;\n};\n\nconst toNumberOrNull = (value: number | undefined): number | null =>\n\tvalue !== undefined && Number.isFinite(value) ? value : null;\n\nconst roundToCents = (value: number): number => Math.round(value * 100) / 100;\n\nexport const normalizeCurrency = (value?: string | null): string | null => {\n\tif (!value) return null;\n\tconst trimmed = value.trim();\n\tif (!trimmed) return null;\n\treturn trimmed.toUpperCase();\n};\n\nexport const parseDate = (value?: string | null): string | null => {\n\tif (!value) return null;\n\tconst trimmed = value.trim();\n\tif (!trimmed) return null;\n\tconst timestamp = Date.parse(trimmed);\n\tif (Number.isNaN(timestamp)) return null;\n\tconst iso = new Date(timestamp).toISOString();\n\treturn iso.slice(0, 10);\n};\n\nconst sanitizePaymentMeans = (pm: UblPaymentMeans) => ({\n\tcode: normalizeText(pm.code),\n\tcode_name: normalizeText(pm.codeName),\n\tpayment_id: normalizeText(pm.paymentId),\n\tiban: normalizeText(pm.iban),\n\tbic: normalizeText(pm.bic),\n\taccount_name: normalizeText(pm.accountName),\n\tmandate_id: normalizeText(pm.mandateId),\n});\n\n// --- Address helpers ---\n\nconst present = (part: string | undefined): part is string => part !== undefined;\n\nconst joinStreet = (address: UblAddress): string =>\n\t[address.street, address.additionalStreet].filter(present).join(\" \");\n\nconst addressToString = (address?: UblAddress): string | null => {\n\tif (!address) return null;\n\tconst street = joinStreet(address);\n\tconst cityLine = [address.postalZone, address.city].filter(present).join(\" \");\n\tconst countryLine = [address.countrySubentity, address.countryCode]\n\t\t.filter(present)\n\t\t.join(\" \");\n\tconst lines = [street, cityLine, countryLine].filter((line) => line.length > 0);\n\treturn lines.length > 0 ? lines.join(\"\\n\") : null;\n};\n\nconst addressToStructured = (address?: UblAddress) => {\n\tif (!address) return null;\n\tconst line1 = joinStreet(address);\n\tconst result = {\n\t\tline1: line1 ? normalizeText(line1) : null,\n\t\tline2: null as string | null,\n\t\tcity: normalizeText(address.city),\n\t\tstate: normalizeText(address.countrySubentity),\n\t\tpostal_code: normalizeText(address.postalZone),\n\t\tcountry: normalizeText(address.countryCode),\n\t};\n\tconst hasValue = Object.values(result).some((value) => value);\n\treturn hasValue ? result : null;\n};\n\n// --- Attachment & charge sanitizers ---\n\nconst sanitizeAttachments = (attachments?: UblAttachment[]) =>\n\t(attachments ?? []).map((attachment) => ({\n\t\tid: normalizeText(attachment.id),\n\t\tfilename: normalizeText(attachment.filename),\n\t\tmime_code: normalizeText(attachment.mimeCode),\n\t\tdescription: normalizeText(attachment.description),\n\t\tsize_bytes:\n\t\t\tattachment.base64Content !== undefined\n\t\t\t\t? base64DecodedSize(attachment.base64Content)\n\t\t\t\t: null,\n\t\texternal_uri: normalizeText(attachment.externalUri),\n\t}));\n\nconst sanitizeAllowanceCharges = (charges?: UblAllowanceCharge[]) =>\n\t(charges ?? []).map((charge) => ({\n\t\tcharge_indicator: charge.chargeIndicator,\n\t\tamount: toNumberOrNull(charge.amount),\n\t\tbase_amount: toNumberOrNull(charge.baseAmount),\n\t\tmultiplier_factor_numeric: toNumberOrNull(charge.multiplierFactorNumeric),\n\t\treason: normalizeText(charge.reason),\n\t\treason_code: normalizeText(charge.reasonCode),\n\t\ttax_percent: toNumberOrNull(charge.taxCategory?.percent),\n\t\ttax_category_id: normalizeText(charge.taxCategory?.id),\n\t\ttax_scheme_id: normalizeText(charge.taxCategory?.schemeId),\n\t}));\n\nconst sanitizeRawUbl = (ubl: UblInvoice) => ({\n\t...ubl,\n\tattachments: sanitizeAttachments(ubl.attachments),\n\tdocumentReferences: ubl.documentReferences ?? [],\n});\n\n// --- Summation helpers ---\n\nconst sumTaxTotal = (ubl: UblInvoice): number | null => {\n\tconst { subtotals } = ubl.taxTotal;\n\tconst subtotalSum = subtotals.reduce(\n\t\t(sum, subtotal) => sum + (subtotal.taxAmount ?? 0),\n\t\t0,\n\t);\n\tif (subtotals.length > 0 && Number.isFinite(subtotalSum)) {\n\t\treturn subtotalSum;\n\t}\n\tconst { taxInclusiveAmount, taxExclusiveAmount } = ubl.monetaryTotal;\n\tif (taxInclusiveAmount === undefined || taxExclusiveAmount === undefined) {\n\t\treturn null;\n\t}\n\treturn taxInclusiveAmount - taxExclusiveAmount;\n};\n\nconst sumAllowanceChargesByType = (\n\tcharges: UblAllowanceCharge[] | undefined,\n\tchargeIndicator: boolean,\n) =>\n\t(charges ?? []).reduce((sum, charge) => {\n\t\tif (charge.chargeIndicator !== chargeIndicator) return sum;\n\t\treturn sum + Math.abs(charge.amount ?? 0);\n\t}, 0);\n\n// --- Public API ---\n\n/**\n * Decode raw XML bytes, stripping an optional UTF-8 BOM.\n */\nexport const decodeXmlBytes = (bytes: Uint8Array): string => {\n\tconst text = new TextDecoder(\"utf-8\").decode(bytes);\n\treturn text.charCodeAt(0) === UTF8_BOM ? text.slice(1) : text;\n};\n\n/**\n * Parse a UBL XML string and normalize it into a flat DTO suitable for\n * database storage or API responses.\n *\n * @throws {UblParseError} when the XML is malformed, not a UBL invoice, or\n * lacks a mandatory element.\n */\nexport const normalizeUblResponse = (\n\txml: string,\n\tdocumentId: string,\n): {\n\textracted: InvoiceExtractionDTO;\n\trawPayload: Record<string, unknown>;\n} => {\n\tconst ubl = parseUblInvoice(xml);\n\tif (!ubl) {\n\t\tthrow new UblParseError(\"Document is not a UBL Invoice or CreditNote\");\n\t}\n\n\tconst subtotal =\n\t\ttoNumberOrNull(ubl.monetaryTotal.taxExclusiveAmount) ??\n\t\ttoNumberOrNull(ubl.monetaryTotal.lineExtensionAmount);\n\tconst total =\n\t\ttoNumberOrNull(ubl.monetaryTotal.taxInclusiveAmount) ??\n\t\ttoNumberOrNull(ubl.monetaryTotal.payableAmount);\n\tconst amountDue = toNumberOrNull(ubl.monetaryTotal.payableAmount);\n\tconst prepaidAmount = toNumberOrNull(ubl.monetaryTotal.prepaidAmount);\n\tconst roundingAmount = toNumberOrNull(ubl.monetaryTotal.payableRoundingAmount) ?? 0;\n\t// BR-CO-16: payable = total - prepaid + rounding. With no declared\n\t// PrepaidAmount we invert that to infer what was paid, but the rounding\n\t// term has to come out first — a cash-rounded payable (BT-114) is a\n\t// total-vs-payable gap by design, and reading it as a prepayment reports\n\t// an unpaid invoice as partially settled. Rounded before the sign test so\n\t// the float residue of undoing it cannot pass as a sub-cent prepayment.\n\tconst inferredPaid =\n\t\ttotal !== null && amountDue !== null\n\t\t\t? roundToCents(total - (amountDue - roundingAmount))\n\t\t\t: null;\n\tconst amountPaid =\n\t\tprepaidAmount ??\n\t\t(inferredPaid !== null && inferredPaid > 0 ? inferredPaid : null);\n\tconst taxTotal = toNumberOrNull(sumTaxTotal(ubl) ?? undefined);\n\tconst hasHeaderAllowanceCharges = (ubl.allowanceCharges?.length ?? 0) > 0;\n\tconst headerDiscountTotal = sumAllowanceChargesByType(ubl.allowanceCharges, false);\n\tconst headerChargeTotal = sumAllowanceChargesByType(ubl.allowanceCharges, true);\n\tconst currency = normalizeCurrency(ubl.currency);\n\tconst paymentTerms = normalizeText(ubl.paymentTermsNote);\n\tconst poNumber =\n\t\tnormalizeText(ubl.orderReference) ?? normalizeText(ubl.salesOrderId);\n\n\tconst lineItems = ubl.lines.map((line) => ({\n\t\tdescription:\n\t\t\tnormalizeText(line.description) ??\n\t\t\tnormalizeText(line.itemName) ??\n\t\t\t\"Line item\",\n\t\tquantity: toNumberOrNull(line.quantity),\n\t\tunit: normalizeText(line.unitCode),\n\t\tunit_price: toNumberOrNull(line.unitPrice),\n\t\tamount: toNumberOrNull(line.lineExtensionAmount),\n\t\ttax_amount: toNumberOrNull(line.taxAmount),\n\t\ttax_rate: toNumberOrNull(line.taxCategory?.percent),\n\t\tproduct_code:\n\t\t\tnormalizeText(line.sellersItemId) ?? normalizeText(line.buyersItemId),\n\t\tdiscount_amount: toNumberOrNull(line.discountAmount),\n\t\tperiod_start: parseDate(line.invoicePeriod?.startDate),\n\t\tperiod_end: parseDate(line.invoicePeriod?.endDate),\n\t\textra: {\n\t\t\tubl_line_id: normalizeText(line.id),\n\t\t\titem_name: normalizeText(line.itemName),\n\t\t\tsellers_item_id: normalizeText(line.sellersItemId),\n\t\t\tbuyers_item_id: normalizeText(line.buyersItemId),\n\t\t\ttax_category_id: normalizeText(line.taxCategory?.id),\n\t\t\ttax_scheme_id: normalizeText(line.taxCategory?.schemeId),\n\t\t\ttax_subtotals: line.taxSubtotals ?? [],\n\t\t\tallowance_charges: sanitizeAllowanceCharges([\n\t\t\t\t...(line.allowanceCharges ?? []),\n\t\t\t\t...(line.priceAllowance\n\t\t\t\t\t? [{ chargeIndicator: false, ...line.priceAllowance }]\n\t\t\t\t\t: []),\n\t\t\t]),\n\t\t\tcharge_amount: toNumberOrNull(line.chargeAmount),\n\t\t\tmetadata: line.additionalItemProperties\n\t\t\t\t? Object.fromEntries(\n\t\t\t\t\t\tline.additionalItemProperties.map((p) => [p.name, p.value]),\n\t\t\t\t\t)\n\t\t\t\t: null,\n\t\t},\n\t}));\n\n\tconst supplierAddress = addressToString(ubl.seller.address);\n\tconst receiverAddress = addressToString(ubl.buyer.address);\n\tconst supplierAddressStructured = addressToStructured(ubl.seller.address);\n\tconst receiverAddressStructured = addressToStructured(ubl.buyer.address);\n\tconst attachmentMetadata = sanitizeAttachments(ubl.attachments);\n\tconst paymentMeansList =\n\t\tubl.paymentMeansList && ubl.paymentMeansList.length > 0\n\t\t\t? ubl.paymentMeansList\n\t\t\t: ubl.paymentMeans\n\t\t\t\t? [ubl.paymentMeans]\n\t\t\t\t: [];\n\n\tconst extracted: InvoiceExtractionDTO = {\n\t\tprovider: \"ubl_xml\",\n\t\tdocument_id: documentId,\n\t\tinvoice: {\n\t\t\tinvoice_number: normalizeText(ubl.id),\n\t\t\tinvoice_date: parseDate(ubl.issueDate),\n\t\t\tdue_date: parseDate(ubl.dueDate),\n\t\t\tperiod_start: parseDate(ubl.invoicePeriod?.startDate),\n\t\t\tperiod_end: parseDate(ubl.invoicePeriod?.endDate),\n\t\t\tcurrency,\n\t\t\tsubtotal,\n\t\t\ttax_total: taxTotal,\n\t\t\ttotal,\n\t\t\tamount_due: amountDue,\n\t\t\tamount_paid: amountPaid,\n\t\t\tdiscount_total:\n\t\t\t\ttoNumberOrNull(ubl.monetaryTotal.allowanceTotalAmount) ??\n\t\t\t\t(hasHeaderAllowanceCharges\n\t\t\t\t\t? toNumberOrNull(headerDiscountTotal)\n\t\t\t\t\t: null),\n\t\t\tshipping_total:\n\t\t\t\ttoNumberOrNull(ubl.monetaryTotal.chargeTotalAmount) ??\n\t\t\t\t(hasHeaderAllowanceCharges ? toNumberOrNull(headerChargeTotal) : null),\n\t\t\trounding_total: toNumberOrNull(ubl.monetaryTotal.payableRoundingAmount),\n\t\t\tpayment_terms: paymentTerms,\n\t\t\tpo_number: poNumber,\n\t\t\tsupplier: {\n\t\t\t\tname:\n\t\t\t\t\tnormalizeText(ubl.seller.name) ??\n\t\t\t\t\tnormalizeText(ubl.seller.registrationName),\n\t\t\t\taddress: supplierAddress,\n\t\t\t\ttax_id:\n\t\t\t\t\tnormalizeText(ubl.seller.vatId) ??\n\t\t\t\t\tnormalizeText(ubl.seller.companyId?.value),\n\t\t\t\tiban: normalizeText(ubl.paymentMeans?.iban),\n\t\t\t\tbic: normalizeText(ubl.paymentMeans?.bic),\n\t\t\t},\n\t\t\treceiver: {\n\t\t\t\tname:\n\t\t\t\t\tnormalizeText(ubl.buyer.name) ??\n\t\t\t\t\tnormalizeText(ubl.buyer.registrationName),\n\t\t\t\taddress: receiverAddress,\n\t\t\t\ttax_id:\n\t\t\t\t\tnormalizeText(ubl.buyer.vatId) ??\n\t\t\t\t\tnormalizeText(ubl.buyer.companyId?.value),\n\t\t\t},\n\t\t\textra: {\n\t\t\t\tdocument_type: ubl.documentType,\n\t\t\t\tcustomization_id: normalizeText(ubl.customizationId),\n\t\t\t\tprofile_id: normalizeText(ubl.profileId),\n\t\t\t\tinvoice_type_code: normalizeText(ubl.invoiceTypeCode),\n\t\t\t\tbuyer_reference: normalizeText(ubl.buyerReference),\n\t\t\t\torder_reference_id: normalizeText(ubl.orderReference),\n\t\t\t\tsales_order_id: normalizeText(ubl.salesOrderId),\n\t\t\t\tcontract_reference: normalizeText(ubl.contractReference),\n\t\t\t\tproject_reference: normalizeText(ubl.projectReference),\n\t\t\t\tbilling_reference: ubl.billingReference\n\t\t\t\t\t? {\n\t\t\t\t\t\t\tinvoice_id: normalizeText(ubl.billingReference.invoiceId),\n\t\t\t\t\t\t\tinvoice_issue_date: parseDate(\n\t\t\t\t\t\t\t\tubl.billingReference.invoiceIssueDate,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t}\n\t\t\t\t\t: null,\n\t\t\t\ttax_point_date: parseDate(ubl.taxPointDate),\n\t\t\t\tinvoice_period: ubl.invoicePeriod ?? null,\n\t\t\t\tnote: normalizeText(ubl.note),\n\t\t\t\tpayment_means: ubl.paymentMeans\n\t\t\t\t\t? sanitizePaymentMeans(ubl.paymentMeans)\n\t\t\t\t\t: null,\n\t\t\t\tpayment_means_list: paymentMeansList.map(sanitizePaymentMeans),\n\t\t\t\tdelivery: ubl.delivery\n\t\t\t\t\t? {\n\t\t\t\t\t\t\tactual_delivery_date: parseDate(\n\t\t\t\t\t\t\t\tubl.delivery.actualDeliveryDate,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\taddress: addressToStructured(ubl.delivery.address),\n\t\t\t\t\t\t}\n\t\t\t\t\t: null,\n\t\t\t\tsupplier: {\n\t\t\t\t\tendpoint_id: normalizeText(ubl.seller.endpoint?.value),\n\t\t\t\t\tendpoint_scheme_id: normalizeText(ubl.seller.endpoint?.scheme),\n\t\t\t\t\tregistration_name: normalizeText(ubl.seller.registrationName),\n\t\t\t\t\tcompany_legal_form: normalizeText(ubl.seller.companyLegalForm),\n\t\t\t\t\tcompany_id_scheme_id: normalizeText(ubl.seller.companyId?.scheme),\n\t\t\t\t\ttax_scheme_id: normalizeText(ubl.seller.taxSchemeId),\n\t\t\t\t\tparty_identifications: ubl.seller.partyIdentifications ?? [],\n\t\t\t\t\tcontact_name: normalizeText(ubl.seller.contact?.name),\n\t\t\t\t\tcontact_phone: normalizeText(ubl.seller.contact?.phone),\n\t\t\t\t\tcontact_email: normalizeText(ubl.seller.contact?.email),\n\t\t\t\t},\n\t\t\t\treceiver: {\n\t\t\t\t\tendpoint_id: normalizeText(ubl.buyer.endpoint?.value),\n\t\t\t\t\tendpoint_scheme_id: normalizeText(ubl.buyer.endpoint?.scheme),\n\t\t\t\t\tregistration_name: normalizeText(ubl.buyer.registrationName),\n\t\t\t\t\tcompany_legal_form: normalizeText(ubl.buyer.companyLegalForm),\n\t\t\t\t\tcompany_id_scheme_id: normalizeText(ubl.buyer.companyId?.scheme),\n\t\t\t\t\ttax_scheme_id: normalizeText(ubl.buyer.taxSchemeId),\n\t\t\t\t\tparty_identifications: ubl.buyer.partyIdentifications ?? [],\n\t\t\t\t\tcontact_name: normalizeText(ubl.buyer.contact?.name),\n\t\t\t\t\tcontact_phone: normalizeText(ubl.buyer.contact?.phone),\n\t\t\t\t\tcontact_email: normalizeText(ubl.buyer.contact?.email),\n\t\t\t\t},\n\t\t\t\tsupplier_address_structured: supplierAddressStructured,\n\t\t\t\treceiver_address_structured: receiverAddressStructured,\n\t\t\t\ttax_subtotals: ubl.taxTotal.subtotals,\n\t\t\t\tallowance_charges: sanitizeAllowanceCharges(ubl.allowanceCharges),\n\t\t\t\tattachments: attachmentMetadata,\n\t\t\t\tdocument_references: ubl.documentReferences ?? [],\n\t\t\t},\n\t\t},\n\t\tline_items: lineItems,\n\t\tconfidence: {\n\t\t\toverall: 1,\n\t\t\tfields: {\n\t\t\t\tinvoice_id: 1,\n\t\t\t\tinvoice_date: 1,\n\t\t\t\tdue_date: 1,\n\t\t\t\ttotal_amount: 1,\n\t\t\t\tsupplier_name: 1,\n\t\t\t},\n\t\t},\n\t};\n\n\treturn {\n\t\textracted,\n\t\trawPayload: {\n\t\t\tformat: \"ubl_xml\",\n\t\t\tinvoice: sanitizeRawUbl(ubl),\n\t\t},\n\t};\n};\n\n/**\n * Parse a UBL invoice from raw bytes and normalize it into a DTO.\n */\nexport const parseUblInvoiceDocument = (params: {\n\tbytes: Uint8Array;\n\tdocumentId: string;\n\tmimeType: string;\n}) => {\n\tconst xml = decodeXmlBytes(params.bytes);\n\tconst { extracted, rawPayload } = normalizeUblResponse(xml, params.documentId);\n\treturn {\n\t\trawPayload: {\n\t\t\t...rawPayload,\n\t\t\tmime_type: params.mimeType,\n\t\t},\n\t\textracted,\n\t\tproviderJobId: null as string | null,\n\t};\n};\n"],"mappings":"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"}
@@ -66,6 +66,11 @@ interface UblCompanyId {
66
66
  /** ISO 6523 ICD scheme (`@schemeID`, e.g. `0208` for the Belgian CBE), when known. */
67
67
  scheme?: string | undefined;
68
68
  }
69
+ /** An identifier with an optional `@schemeID`: BT-18, BT-71, BT-128, BT-157. */
70
+ interface UblSchemedId {
71
+ value: string;
72
+ scheme?: string | undefined;
73
+ }
69
74
  /** `cac:PartyIdentification/cbc:ID` (BT-29/BT-46) with its `@schemeID`. */
70
75
  interface UblPartyIdentification {
71
76
  id: string;
@@ -122,6 +127,14 @@ interface UblItemProperty {
122
127
  interface UblLine {
123
128
  /** `cbc:ID` (BT-126) — line identifier. */
124
129
  id: string;
130
+ /** `cbc:Note` (BT-127). */
131
+ note?: string | undefined;
132
+ /** `cac:DocumentReference/cbc:ID` with `cbc:DocumentTypeCode` 130 (BT-128). */
133
+ objectIdentifier?: UblSchemedId | undefined;
134
+ /** `cac:OrderLineReference/cbc:LineID` (BT-132). */
135
+ orderLineReference?: string | undefined;
136
+ /** `cbc:AccountingCost` (BT-133). */
137
+ accountingCost?: string | undefined;
125
138
  /** `cac:Item/cbc:Description` (BT-154). */
126
139
  description?: string | undefined;
127
140
  /** `cbc:InvoicedQuantity` / `cbc:CreditedQuantity` (BT-129). */
@@ -149,8 +162,14 @@ interface UblLine {
149
162
  taxAmount?: number | undefined;
150
163
  /** Line-level `cac:TaxTotal/cac:TaxSubtotal` (not used by BIS Billing, seen in the wild). */
151
164
  taxSubtotals?: UblTaxSubtotal[] | undefined;
165
+ /** Line-level allowances and charges (BG-27/BG-28); the price discount is `priceAllowance`. */
152
166
  allowanceCharges?: UblAllowanceCharge[] | undefined;
153
- /** Sum of line-level allowances (absolute). */
167
+ /**
168
+ * `cac:Price/cac:AllowanceCharge` (BT-147/BT-148): the discount between
169
+ * the gross unit price (`baseAmount`) and the net one (BT-146).
170
+ */
171
+ priceAllowance?: UblPriceAllowance | undefined;
172
+ /** Sum of line-level allowances plus the price allowance (absolute). */
154
173
  discountAmount?: number | undefined;
155
174
  /** Sum of line-level charges (absolute). */
156
175
  chargeAmount?: number | undefined;
@@ -160,10 +179,32 @@ interface UblLine {
160
179
  sellersItemId?: string | undefined;
161
180
  /** `cac:Item/cac:BuyersItemIdentification/cbc:ID` (BT-156). */
162
181
  buyersItemId?: string | undefined;
182
+ /** `cac:Item/cac:StandardItemIdentification/cbc:ID` (BT-157), `@schemeID` an ICD. */
183
+ standardItemId?: UblSchemedId | undefined;
184
+ /** `cac:Item/cac:CommodityClassification` (BT-158). */
185
+ commodityClassifications?: UblCommodityClassification[] | undefined;
186
+ /** `cac:Item/cac:OriginCountry/cbc:IdentificationCode` (BT-159). */
187
+ originCountryCode?: string | undefined;
163
188
  additionalItemProperties?: UblItemProperty[] | undefined;
164
189
  /** `cac:InvoicePeriod` (BT-134/BT-135) — the line's own service period. */
165
190
  invoicePeriod?: UblInvoicePeriod | undefined;
166
191
  }
192
+ interface UblPriceAllowance {
193
+ /** `cbc:Amount` (BT-147) — the discount per BT-149 units. */
194
+ amount?: number | undefined;
195
+ /** `cbc:BaseAmount` (BT-148) — the gross price per BT-149 units. */
196
+ baseAmount?: number | undefined;
197
+ /** `cbc:AllowanceChargeReason`, read when a document states one; not part of BIS and not written. */
198
+ reason?: string | undefined;
199
+ }
200
+ /** `cac:CommodityClassification/cbc:ItemClassificationCode` (BT-158) and its list. */
201
+ interface UblCommodityClassification {
202
+ value: string;
203
+ /** `@listID` (BT-158-1), a UNTDID 7143 code. */
204
+ listId?: string | undefined;
205
+ /** `@listVersionID` (BT-158-2). */
206
+ listVersionId?: string | undefined;
207
+ }
167
208
  interface UblAllowanceCharge {
168
209
  /** `cbc:ChargeIndicator` — `true` for a charge, `false` for an allowance. */
169
210
  chargeIndicator: boolean;
@@ -193,6 +234,8 @@ interface UblTaxTotal {
193
234
  taxAmount?: number | undefined;
194
235
  /** `cac:TaxSubtotal` (BG-23) — the VAT breakdown. */
195
236
  subtotals: UblTaxSubtotal[];
237
+ /** BT-111 — the VAT total in the VAT accounting currency (`UblInvoice.taxCurrency`). */
238
+ taxAmountInTaxCurrency?: number | undefined;
196
239
  }
197
240
  interface UblMonetaryTotal {
198
241
  /** BT-106 — sum of line net amounts. */
@@ -233,6 +276,12 @@ interface UblPaymentMeans {
233
276
  accountName?: string | undefined;
234
277
  /** `cac:PaymentMandate/cbc:ID` (BT-89). */
235
278
  mandateId?: string | undefined;
279
+ /** `cac:PaymentMandate/cac:PayerFinancialAccount/cbc:ID` (BT-91). */
280
+ debitedAccount?: string | undefined;
281
+ /** `cac:CardAccount/cbc:PrimaryAccountNumberID` (BT-87). */
282
+ cardNumber?: string | undefined;
283
+ /** `cac:CardAccount/cbc:HolderName` (BT-88). */
284
+ cardHolder?: string | undefined;
236
285
  }
237
286
  /**
238
287
  * A service period: BT-73/BT-74 on the document, BT-134/BT-135 on a line.
@@ -270,8 +319,12 @@ interface UblDocumentReference {
270
319
  interface UblDelivery {
271
320
  /** `cbc:ActualDeliveryDate` (BT-72). */
272
321
  actualDeliveryDate?: string | undefined;
322
+ /** `cac:DeliveryLocation/cbc:ID` (BT-71). */
323
+ locationId?: UblSchemedId | undefined;
273
324
  /** `cac:DeliveryLocation/cac:Address` (BG-15). */
274
325
  address?: UblAddress | undefined;
326
+ /** `cac:DeliveryParty/cac:PartyName/cbc:Name` (BT-70). */
327
+ partyName?: string | undefined;
275
328
  }
276
329
  /** `cac:BillingReference/cac:InvoiceDocumentReference` (BT-25/BT-26). */
277
330
  interface UblBillingReference {
@@ -296,6 +349,10 @@ interface UblInvoice {
296
349
  taxPointDate?: string | undefined;
297
350
  /** Document currency (BT-5). */
298
351
  currency: string;
352
+ /** `cbc:TaxCurrencyCode` (BT-6); requires `taxTotal.taxAmountInTaxCurrency` (BR-53). */
353
+ taxCurrency?: string | undefined;
354
+ /** `cbc:AccountingCost` (BT-19). */
355
+ accountingCost?: string | undefined;
299
356
  /** Buyer reference (BT-10). */
300
357
  buyerReference?: string | undefined;
301
358
  /** `cac:OrderReference/cbc:ID` (BT-13). */
@@ -304,12 +361,28 @@ interface UblInvoice {
304
361
  salesOrderId?: string | undefined;
305
362
  /** `cac:ContractDocumentReference/cbc:ID` (BT-12). */
306
363
  contractReference?: string | undefined;
307
- /** `cac:ProjectReference/cbc:ID` (BT-11). */
364
+ /**
365
+ * BT-11. `cac:ProjectReference/cbc:ID` on an invoice; a credit note has no
366
+ * such element, so there it is an additional document reference with
367
+ * `cbc:DocumentTypeCode` 50.
368
+ */
308
369
  projectReference?: string | undefined;
370
+ /** `cac:ReceiptDocumentReference/cbc:ID` (BT-15). */
371
+ receivingAdviceReference?: string | undefined;
372
+ /** `cac:DespatchDocumentReference/cbc:ID` (BT-16). */
373
+ despatchReference?: string | undefined;
374
+ /** BT-17, an additional document reference with `cbc:DocumentTypeCode` 50. Invoices only. */
375
+ tenderReference?: string | undefined;
376
+ /** BT-18, an additional document reference with `cbc:DocumentTypeCode` 130. */
377
+ invoicedObjectId?: UblSchemedId | undefined;
309
378
  /** For credit notes: the referenced original invoice (BT-25). */
310
379
  billingReference?: UblBillingReference | undefined;
311
380
  seller: UblParty;
312
381
  buyer: UblParty;
382
+ /** `cac:PayeeParty` (BG-10): name, identification and legal entity id only. */
383
+ payee?: UblParty | undefined;
384
+ /** `cac:TaxRepresentativeParty` (BG-11): name, VAT id and address only. */
385
+ taxRepresentative?: UblParty | undefined;
313
386
  delivery?: UblDelivery | undefined;
314
387
  lines: UblLine[];
315
388
  taxTotal: UblTaxTotal;
@@ -385,5 +458,5 @@ interface InvoiceExtractionDTO {
385
458
  };
386
459
  }
387
460
  //#endregion
388
- export { UblParseError as C, UblBuildError as S, UblPartyIdentification as _, UblBillingReference as a, UblTaxSubtotal as b, UblDelivery as c, UblInvoice as d, UblInvoicePeriod as f, UblParty as g, UblMonetaryTotal as h, UblAttachment as i, UblDocumentReference as l, UblLine as m, UblAddress as n, UblCompanyId as o, UblItemProperty as p, UblAllowanceCharge as r, UblContact as s, InvoiceExtractionDTO as t, UblEndpoint as u, UblPaymentMeans as v, UblTaxTotal as x, UblTaxCategory as y };
389
- //# sourceMappingURL=types-DossV2at.d.ts.map
461
+ export { UblTaxSubtotal as C, UblParseError as E, UblTaxCategory as S, UblBuildError as T, UblParty as _, UblBillingReference as a, UblPriceAllowance as b, UblContact as c, UblEndpoint as d, UblInvoice as f, UblMonetaryTotal as g, UblLine as h, UblAttachment as i, UblDelivery as l, UblItemProperty as m, UblAddress as n, UblCommodityClassification as o, UblInvoicePeriod as p, UblAllowanceCharge as r, UblCompanyId as s, InvoiceExtractionDTO as t, UblDocumentReference as u, UblPartyIdentification as v, UblTaxTotal as w, UblSchemedId as x, UblPaymentMeans as y };
462
+ //# sourceMappingURL=types-DpwX8-Ix.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types-DpwX8-Ix.d.ts","names":[],"sources":["../src/errors.ts","../src/types.ts"],"mappings":";;;;;;;cAMa,sBAAsB;WAChB;EAElB,YAAY,iBAAiB;IAAY;;;;;;;;;cAa7B,sBAAsB;WAChB;EAElB,YAAY,iBAAiB;IAAY;;;;;UCRzB;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;UAGgB;;EAEhB;;EAEA;;EAEA;;;;;;;UAQgB;EAChB;;EAEA;;;;;;UAOgB;EAChB;;EAEA;;;UAIgB;EAChB;EACA;;;UAIgB;EAChB;EACA;;UAGgB;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,YAAY;;EAEZ,WAAW;EACX,uBAAuB;EACvB,UAAU;EACV,UAAU;;;;;;;;;;;;;UAcM;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA;;UAGgB;;EAEhB;;EAEA;;UAGgB;;EAEhB;;EAEA;;EAEA,mBAAmB;;EAEnB;;EAEA;;EAEA;;EAEA;;EAEA;;;;;EAKA;;EAEA;;;;;;;;EAQA;;EAEA,cAAc;;EAEd;;EAEA,eAAe;;EAEf,mBAAmB;;;;;EAKnB,iBAAiB;;EAEjB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,iBAAiB;;EAEjB,2BAA2B;;EAE3B;EACA,2BAA2B;;EAE3B,gBAAgB;;UAGA;;EAEhB;;EAEA;;EAEA;;;UAIgB;EAChB;;EAEA;;EAEA;;UAGgB;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,cAAc;;UAGE;;EAEhB;;EAEA;;EAEA,WAAW;;UAGK;;EAEhB;;EAEA,WAAW;;EAEX;;UAGgB;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA;;;;;EAKA;;EAEA;;;;;EAKA;;UAGgB;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;;UAQgB;;EAEhB;;EAEA;;EAEA;;;UAIgB;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;;UAIgB;EAChB;EACA;;UAGgB;;EAEhB;;EAEA,aAAa;;EAEb,UAAU;;EAEV;;;UAIgB;EAChB;EACA;;UAGgB;EAChB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;EAMA;;EAEA;;EAEA;;EAEA;;EAEA,mBAAmB;;EAEnB,mBAAmB;EACnB,QAAQ;EACR,OAAO;;EAEP,QAAQ;;EAER,oBAAoB;EACpB,WAAW;EACX,OAAO;EACP,UAAU;EACV,eAAe;;EAEf,eAAe;EACf,mBAAmB;;EAEnB,gBAAgB;;EAEhB;;EAEA;EACA,cAAc;EACd,qBAAqB;;EAErB,mBAAmB;;UAKH;EAChB;EACA;EACA;IACC;IACA;IACA;;IAEA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;;IAEA;IACA;IACA;IACA;MACC;MACA;MACA;MACA;MACA;;IAED;MACC;MACA;MACA;;IAED,OAAO;;EAER,YAAY;IACX;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;;IAEA;IACA;IACA,OAAO;;EAER;IACC;IACA,QAAQ"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@financica/ubl",
3
- "version": "0.17.0",
3
+ "version": "0.18.0",
4
4
  "description": "UBL (Universal Business Language) invoice toolkit for TypeScript: parse, build, and serialize Peppol BIS Billing 3.0 documents.",
5
5
  "homepage": "https://github.com/financica/ts-libs/tree/main/packages/ubl#readme",
6
6
  "bugs": "https://github.com/financica/ts-libs/issues",
@@ -10,15 +10,25 @@ export { UblBuildError } from "../errors";
10
10
  export { serializeUblDocument, serializeUblInvoice } from "./ubl/serialize";
11
11
  export type {
12
12
  UblAddress,
13
+ UblAllowanceCharge,
13
14
  UblAttachment,
14
15
  UblBillingReference,
16
+ UblCommodityClassification,
15
17
  UblCompanyId,
18
+ UblContact,
19
+ UblDelivery,
20
+ UblDocumentReference,
16
21
  UblEndpoint,
17
22
  UblInvoice,
18
23
  UblInvoicePeriod,
24
+ UblItemProperty,
19
25
  UblLine,
20
26
  UblMonetaryTotal,
21
27
  UblParty,
28
+ UblPartyIdentification,
29
+ UblPaymentMeans,
30
+ UblPriceAllowance,
31
+ UblSchemedId,
22
32
  UblTaxCategory,
23
33
  UblTaxSubtotal,
24
34
  UblTaxTotal,
@@ -69,6 +79,7 @@ export {
69
79
  taxCategoryFromReasonOrRate,
70
80
  } from "./tax-category";
71
81
  export {
82
+ allocateAcrossTaxCategories,
72
83
  type BuildTaxTotalsOptions,
73
84
  type BuildTaxTotalsResult,
74
85
  buildTaxTotals,