@stackforge-eu/factur-x 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [1.4.0] — 2026-09-03
+
+- **Added the item price discount (BT-147).** A new optional `priceDiscount`
+  field on `InvoiceLineInput` emits `ram:AppliedTradeAllowanceCharge` inside
+  the gross price element, so a line can state the discount that connects the
+  gross unit price (BT-148) to the net unit price (BT-146) instead of leaving
+  it implied by their difference. Requires `grossUnitPrice` to be set; the
+  amount keeps up to four decimals for sub-cent discounts. Omitting the field
+  keeps the output byte-for-byte identical (#15).
+
+## [1.3.1] — 2026-09-01
+
+- **Dropped the unused `schema/cii-d22b/` code-list XSDs from the npm and JSR
+  packages** (~100 files, ~800 KB). Nothing references them at runtime — the
+  per-profile schema directories are self-contained. One of these files also
+  has a path longer than 100 characters, which a JSR server-side tar
+  regression truncated, breaking the 1.3.0 JSR publish.
+- The release workflow now dry-runs `npm pack` and `deno publish` before
+  tagging, and publishes to npm only after JSR has succeeded — npm versions
+  are effectively immutable, so the unretractable registry ships last.
+
 ## [1.3.0] — 2026-09-01
 
 - **Added item price base quantity (BT-149/BT-150).** New optional
@@ -224,6 +245,8 @@ This element is not expected`. Reordered the three blocks in
 - Deno compatibility test suite
 
 [Unreleased]: https://github.com/StackForge-EU/factur-x/commits/main
+[1.4.0]: https://github.com/StackForge-EU/factur-x/compare/v1.3.1...v1.4.0
+[1.3.1]: https://github.com/StackForge-EU/factur-x/compare/v1.3.0...v1.3.1
 [1.3.0]: https://github.com/StackForge-EU/factur-x/compare/v1.2.1...v1.3.0
 [1.2.1]: https://github.com/StackForge-EU/factur-x/compare/v1.2.0...v1.2.1
 [1.2.0]: https://github.com/StackForge-EU/factur-x/compare/v1.1.0...v1.2.0

package/dist/index.cjs

@@ -307,6 +307,12 @@ function fmtAmt(n) {
   }
   return n.toFixed(2);
 }
+function fmtPrice(n) {
+  if (!Number.isFinite(n)) {
+    throw new Error(`Invalid amount value: ${n}. Expected a finite number.`);
+  }
+  return n.toFixed(4).replace(/(\.\d{2}\d*?)0+$/, "$1");
+}
 function tag(name, content, attrs) {
   const a = attrs ? Object.entries(attrs).map(([k, v]) => ` ${k}="${escapeXml(v)}"`).join("") : "";
   return `<${name}${a}>${content}</${name}>`;
@@ -406,11 +412,21 @@ function buildLineItem(line, profile) {
   const basisQuantity = line.basisQuantity !== void 0 ? tag("ram:BasisQuantity", line.basisQuantity.toString(), {
     unitCode: line.basisQuantityUnitCode ?? unitCode
   }) : "";
-  if (line.grossUnitPrice !== void 0)
+  if (line.priceDiscount !== void 0 && line.grossUnitPrice === void 0) {
+    throw new Error(
+      `buildXml: line "${line.id}" sets "priceDiscount" (BT-147) without "grossUnitPrice" (BT-148).`
+    );
+  }
+  if (line.grossUnitPrice !== void 0) {
+    const discount = line.priceDiscount !== void 0 ? tag(
+      "ram:AppliedTradeAllowanceCharge",
+      tag("ram:ChargeIndicator", tag("udt:Indicator", "false")) + tag("ram:ActualAmount", fmtPrice(line.priceDiscount))
+    ) : "";
     agree += tag(
       "ram:GrossPriceProductTradePrice",
-      tag("ram:ChargeAmount", fmtAmt(line.grossUnitPrice)) + basisQuantity
+      tag("ram:ChargeAmount", fmtAmt(line.grossUnitPrice)) + basisQuantity + discount
     );
+  }
   agree += tag(
     "ram:NetPriceProductTradePrice",
     tag("ram:ChargeAmount", fmtAmt(line.unitPrice)) + basisQuantity

package/dist/index.d.cts

@@ -573,6 +573,14 @@ interface InvoiceLineInput {
      * @see EN 16931 BT-148
      */
     grossUnitPrice?: number;
+    /**
+     * Item price discount — the amount subtracted from `grossUnitPrice`
+     * (BT-148) to arrive at `unitPrice` (BT-146). Emitted as
+     * `ram:AppliedTradeAllowanceCharge` inside the gross price element,
+     * so `grossUnitPrice` must be set alongside it.
+     * @see EN 16931 BT-147
+     */
+    priceDiscount?: number;
     /**
      * Item price base quantity — the quantity the unit price (BT-146)
      * applies to, e.g. a price per 10 square metres or per 1000 prints.

package/dist/index.d.ts

@@ -573,6 +573,14 @@ interface InvoiceLineInput {
      * @see EN 16931 BT-148
      */
     grossUnitPrice?: number;
+    /**
+     * Item price discount — the amount subtracted from `grossUnitPrice`
+     * (BT-148) to arrive at `unitPrice` (BT-146). Emitted as
+     * `ram:AppliedTradeAllowanceCharge` inside the gross price element,
+     * so `grossUnitPrice` must be set alongside it.
+     * @see EN 16931 BT-147
+     */
+    priceDiscount?: number;
     /**
      * Item price base quantity — the quantity the unit price (BT-146)
      * applies to, e.g. a price per 10 square metres or per 1000 prints.

package/dist/index.js

@@ -277,6 +277,12 @@ function fmtAmt(n) {
   }
   return n.toFixed(2);
 }
+function fmtPrice(n) {
+  if (!Number.isFinite(n)) {
+    throw new Error(`Invalid amount value: ${n}. Expected a finite number.`);
+  }
+  return n.toFixed(4).replace(/(\.\d{2}\d*?)0+$/, "$1");
+}
 function tag(name, content, attrs) {
   const a = attrs ? Object.entries(attrs).map(([k, v]) => ` ${k}="${escapeXml(v)}"`).join("") : "";
   return `<${name}${a}>${content}</${name}>`;
@@ -376,11 +382,21 @@ function buildLineItem(line, profile) {
   const basisQuantity = line.basisQuantity !== void 0 ? tag("ram:BasisQuantity", line.basisQuantity.toString(), {
     unitCode: line.basisQuantityUnitCode ?? unitCode
   }) : "";
-  if (line.grossUnitPrice !== void 0)
+  if (line.priceDiscount !== void 0 && line.grossUnitPrice === void 0) {
+    throw new Error(
+      `buildXml: line "${line.id}" sets "priceDiscount" (BT-147) without "grossUnitPrice" (BT-148).`
+    );
+  }
+  if (line.grossUnitPrice !== void 0) {
+    const discount = line.priceDiscount !== void 0 ? tag(
+      "ram:AppliedTradeAllowanceCharge",
+      tag("ram:ChargeIndicator", tag("udt:Indicator", "false")) + tag("ram:ActualAmount", fmtPrice(line.priceDiscount))
+    ) : "";
     agree += tag(
       "ram:GrossPriceProductTradePrice",
-      tag("ram:ChargeAmount", fmtAmt(line.grossUnitPrice)) + basisQuantity
+      tag("ram:ChargeAmount", fmtAmt(line.grossUnitPrice)) + basisQuantity + discount
     );
+  }
   agree += tag(
     "ram:NetPriceProductTradePrice",
     tag("ram:ChargeAmount", fmtAmt(line.unitPrice)) + basisQuantity

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackforge-eu/factur-x",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "type": "module",
   "description": "Embed Factur-X, ZUGFeRD, and XRechnung structured invoice XML into PDF/A-3 documents",
   "keywords": [
@@ -64,6 +64,7 @@
   "files": [
     "dist",
     "schema/**/*.xsd",
+    "!schema/cii-d22b",
     "schema/README.md",
     "README.md",
     "LICENSE",

package/schema/cii-d22b/CrossIndustryInvoice_100pD22B.xsd

@@ -1,25 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<xsd:schema xmlns:rsm="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100"
-    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
-    xmlns:qdt="urn:un:unece:uncefact:data:standard:QualifiedDataType:100"
-    xmlns:ram="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100"
-    xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100"
-    targetNamespace="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100"
-    elementFormDefault="qualified"
-    version="100.D22B">
-  <xsd:import namespace="urn:un:unece:uncefact:data:standard:QualifiedDataType:100" schemaLocation="CrossIndustryInvoice_100pD22B_QualifiedDataType_100.xsd"/>
-  <xsd:import namespace="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100" schemaLocation="CrossIndustryInvoice_100pD22B_ReusableAggregateBusinessInformationEntity_100.xsd"/>
-  <xsd:import namespace="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100" schemaLocation="CrossIndustryInvoice_100pD22B_UnqualifiedDataType_100.xsd"/>
-  <xsd:element name="CrossIndustryInvoice" type="rsm:CrossIndustryInvoiceType"/>
-  <xsd:complexType name="CrossIndustryInvoiceType">
-    <xsd:annotation>
-      <xsd:documentation source="BN/BN">Cross Industry Invoice</xsd:documentation>
-    </xsd:annotation>
-    <xsd:sequence>
-      <xsd:element name="ExchangedDocumentContext" type="ram:ExchangedDocumentContextType"/>
-      <xsd:element name="ExchangedDocument" type="ram:ExchangedDocumentType"/>
-      <xsd:element name="SupplyChainTradeTransaction" type="ram:SupplyChainTradeTransactionType"/>
-      <xsd:element name="ValuationBreakdownStatement" type="ram:ValuationBreakdownStatementType" minOccurs="0"/>
-    </xsd:sequence>
-  </xsd:complexType>
-</xsd:schema>

package/schema/cii-d22b/CrossIndustryInvoice_100pD22B_EDIFICAS-EU_AccountingAccountType_D11A.xsd

@@ -1,18 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<xsd:schema xmlns:clm210AccountingE501="urn:un:unece:uncefact:codelist:standard:EDIFICAS-EU:AccountingAccountType:D11A"
-    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
-    targetNamespace="urn:un:unece:uncefact:codelist:standard:EDIFICAS-EU:AccountingAccountType:D11A"
-    elementFormDefault="qualified"
-    version="1.0">
-  <xsd:simpleType name="AccountingAccountTypeContentType">
-    <xsd:restriction base="xsd:token">
-      <xsd:enumeration value="1"/>
-      <xsd:enumeration value="2"/>
-      <xsd:enumeration value="3"/>
-      <xsd:enumeration value="4"/>
-      <xsd:enumeration value="5"/>
-      <xsd:enumeration value="6"/>
-      <xsd:enumeration value="7"/>
-    </xsd:restriction>
-  </xsd:simpleType>
-</xsd:schema>

package/schema/cii-d22b/CrossIndustryInvoice_100pD22B_EDIFICAS-EU_AccountingAmountType_D11A.xsd

@@ -1,17 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<xsd:schema xmlns:clm210AccountingE601="urn:un:unece:uncefact:codelist:standard:EDIFICAS-EU:AccountingAmountType:D11A"
-    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
-    targetNamespace="urn:un:unece:uncefact:codelist:standard:EDIFICAS-EU:AccountingAmountType:D11A"
-    elementFormDefault="qualified"
-    version="1.0">
-  <xsd:simpleType name="AccountingAmountTypeContentType">
-    <xsd:restriction base="xsd:token">
-      <xsd:enumeration value="1"/>
-      <xsd:enumeration value="2"/>
-      <xsd:enumeration value="3"/>
-      <xsd:enumeration value="4"/>
-      <xsd:enumeration value="5"/>
-      <xsd:enumeration value="6"/>
-    </xsd:restriction>
-  </xsd:simpleType>
-</xsd:schema>

package/schema/cii-d22b/CrossIndustryInvoice_100pD22B_ISO_ISO3AlphaCurrencyCode_2012-08-31.xsd

@@ -1,191 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<xsd:schema xmlns:clm5ISO42173A="urn:un:unece:uncefact:codelist:standard:ISO:ISO3AlphaCurrencyCode:2012-08-31"
-    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
-    targetNamespace="urn:un:unece:uncefact:codelist:standard:ISO:ISO3AlphaCurrencyCode:2012-08-31"
-    elementFormDefault="qualified"
-    version="11.11">
-  <xsd:simpleType name="ISO3AlphaCurrencyCodeContentType">
-    <xsd:restriction base="xsd:token">
-      <xsd:enumeration value="AED"/>
-      <xsd:enumeration value="AFN"/>
-      <xsd:enumeration value="ALL"/>
-      <xsd:enumeration value="AMD"/>
-      <xsd:enumeration value="ANG"/>
-      <xsd:enumeration value="AOA"/>
-      <xsd:enumeration value="ARS"/>
-      <xsd:enumeration value="AUD"/>
-      <xsd:enumeration value="AWG"/>
-      <xsd:enumeration value="AZN"/>
-      <xsd:enumeration value="BAM"/>
-      <xsd:enumeration value="BBD"/>
-      <xsd:enumeration value="BDT"/>
-      <xsd:enumeration value="BGN"/>
-      <xsd:enumeration value="BHD"/>
-      <xsd:enumeration value="BIF"/>
-      <xsd:enumeration value="BMD"/>
-      <xsd:enumeration value="BND"/>
-      <xsd:enumeration value="BOB"/>
-      <xsd:enumeration value="BOV"/>
-      <xsd:enumeration value="BRL"/>
-      <xsd:enumeration value="BSD"/>
-      <xsd:enumeration value="BTN"/>
-      <xsd:enumeration value="BWP"/>
-      <xsd:enumeration value="BYN"/>
-      <xsd:enumeration value="BZD"/>
-      <xsd:enumeration value="CAD"/>
-      <xsd:enumeration value="CDF"/>
-      <xsd:enumeration value="CHE"/>
-      <xsd:enumeration value="CHF"/>
-      <xsd:enumeration value="CHW"/>
-      <xsd:enumeration value="CLF"/>
-      <xsd:enumeration value="CLP"/>
-      <xsd:enumeration value="CNY"/>
-      <xsd:enumeration value="COP"/>
-      <xsd:enumeration value="COU"/>
-      <xsd:enumeration value="CRC"/>
-      <xsd:enumeration value="CUC"/>
-      <xsd:enumeration value="CUP"/>
-      <xsd:enumeration value="CVE"/>
-      <xsd:enumeration value="CZK"/>
-      <xsd:enumeration value="DJF"/>
-      <xsd:enumeration value="DKK"/>
-      <xsd:enumeration value="DOP"/>
-      <xsd:enumeration value="DZD"/>
-      <xsd:enumeration value="EGP"/>
-      <xsd:enumeration value="ERN"/>
-      <xsd:enumeration value="ETB"/>
-      <xsd:enumeration value="EUR"/>
-      <xsd:enumeration value="FJD"/>
-      <xsd:enumeration value="FKP"/>
-      <xsd:enumeration value="GBP"/>
-      <xsd:enumeration value="GEL"/>
-      <xsd:enumeration value="GHS"/>
-      <xsd:enumeration value="GIP"/>
-      <xsd:enumeration value="GMD"/>
-      <xsd:enumeration value="GNF"/>
-      <xsd:enumeration value="GTQ"/>
-      <xsd:enumeration value="GYD"/>
-      <xsd:enumeration value="HKD"/>
-      <xsd:enumeration value="HNL"/>
-      <xsd:enumeration value="HRK"/>
-      <xsd:enumeration value="HTG"/>
-      <xsd:enumeration value="HUF"/>
-      <xsd:enumeration value="IDR"/>
-      <xsd:enumeration value="ILS"/>
-      <xsd:enumeration value="INR"/>
-      <xsd:enumeration value="IQD"/>
-      <xsd:enumeration value="IRR"/>
-      <xsd:enumeration value="ISK"/>
-      <xsd:enumeration value="JMD"/>
-      <xsd:enumeration value="JOD"/>
-      <xsd:enumeration value="JPY"/>
-      <xsd:enumeration value="KES"/>
-      <xsd:enumeration value="KGS"/>
-      <xsd:enumeration value="KHR"/>
-      <xsd:enumeration value="KMF"/>
-      <xsd:enumeration value="KPW"/>
-      <xsd:enumeration value="KRW"/>
-      <xsd:enumeration value="KWD"/>
-      <xsd:enumeration value="KYD"/>
-      <xsd:enumeration value="KZT"/>
-      <xsd:enumeration value="LAK"/>
-      <xsd:enumeration value="LBP"/>
-      <xsd:enumeration value="LKR"/>
-      <xsd:enumeration value="LRD"/>
-      <xsd:enumeration value="LSL"/>
-      <xsd:enumeration value="LYD"/>
-      <xsd:enumeration value="MAD"/>
-      <xsd:enumeration value="MDL"/>
-      <xsd:enumeration value="MGA"/>
-      <xsd:enumeration value="MKD"/>
-      <xsd:enumeration value="MMK"/>
-      <xsd:enumeration value="MNT"/>
-      <xsd:enumeration value="MOP"/>
-      <xsd:enumeration value="MRU"/>
-      <xsd:enumeration value="MUR"/>
-      <xsd:enumeration value="MVR"/>
-      <xsd:enumeration value="MWK"/>
-      <xsd:enumeration value="MXN"/>
-      <xsd:enumeration value="MXV"/>
-      <xsd:enumeration value="MYR"/>
-      <xsd:enumeration value="MZN"/>
-      <xsd:enumeration value="NAD"/>
-      <xsd:enumeration value="NGN"/>
-      <xsd:enumeration value="NIO"/>
-      <xsd:enumeration value="NOK"/>
-      <xsd:enumeration value="NPR"/>
-      <xsd:enumeration value="NZD"/>
-      <xsd:enumeration value="OMR"/>
-      <xsd:enumeration value="PAB"/>
-      <xsd:enumeration value="PEN"/>
-      <xsd:enumeration value="PGK"/>
-      <xsd:enumeration value="PHP"/>
-      <xsd:enumeration value="PKR"/>
-      <xsd:enumeration value="PLN"/>
-      <xsd:enumeration value="PYG"/>
-      <xsd:enumeration value="QAR"/>
-      <xsd:enumeration value="RON"/>
-      <xsd:enumeration value="RSD"/>
-      <xsd:enumeration value="RUB"/>
-      <xsd:enumeration value="RWF"/>
-      <xsd:enumeration value="SAR"/>
-      <xsd:enumeration value="SBD"/>
-      <xsd:enumeration value="SCR"/>
-      <xsd:enumeration value="SDG"/>
-      <xsd:enumeration value="SEK"/>
-      <xsd:enumeration value="SGD"/>
-      <xsd:enumeration value="SHP"/>
-      <xsd:enumeration value="SLE"/>
-      <xsd:enumeration value="SOS"/>
-      <xsd:enumeration value="SRD"/>
-      <xsd:enumeration value="SSP"/>
-      <xsd:enumeration value="STN"/>
-      <xsd:enumeration value="SVC"/>
-      <xsd:enumeration value="SYP"/>
-      <xsd:enumeration value="SZL"/>
-      <xsd:enumeration value="THB"/>
-      <xsd:enumeration value="TJS"/>
-      <xsd:enumeration value="TMT"/>
-      <xsd:enumeration value="TND"/>
-      <xsd:enumeration value="TOP"/>
-      <xsd:enumeration value="TRY"/>
-      <xsd:enumeration value="TTD"/>
-      <xsd:enumeration value="TWD"/>
-      <xsd:enumeration value="TZS"/>
-      <xsd:enumeration value="UAH"/>
-      <xsd:enumeration value="UGX"/>
-      <xsd:enumeration value="USD"/>
-      <xsd:enumeration value="USN"/>
-      <xsd:enumeration value="UYI"/>
-      <xsd:enumeration value="UYU"/>
-      <xsd:enumeration value="UYW"/>
-      <xsd:enumeration value="UZS"/>
-      <xsd:enumeration value="VED"/>
-      <xsd:enumeration value="VES"/>
-      <xsd:enumeration value="VND"/>
-      <xsd:enumeration value="VUV"/>
-      <xsd:enumeration value="WST"/>
-      <xsd:enumeration value="XAF"/>
-      <xsd:enumeration value="XAG"/>
-      <xsd:enumeration value="XAU"/>
-      <xsd:enumeration value="XBA"/>
-      <xsd:enumeration value="XBB"/>
-      <xsd:enumeration value="XBC"/>
-      <xsd:enumeration value="XBD"/>
-      <xsd:enumeration value="XCD"/>
-      <xsd:enumeration value="XDR"/>
-      <xsd:enumeration value="XOF"/>
-      <xsd:enumeration value="XPD"/>
-      <xsd:enumeration value="XPF"/>
-      <xsd:enumeration value="XPT"/>
-      <xsd:enumeration value="XSU"/>
-      <xsd:enumeration value="XTS"/>
-      <xsd:enumeration value="XUA"/>
-      <xsd:enumeration value="XXX"/>
-      <xsd:enumeration value="YER"/>
-      <xsd:enumeration value="ZAR"/>
-      <xsd:enumeration value="ZMW"/>
-      <xsd:enumeration value="ZWL"/>
-    </xsd:restriction>
-  </xsd:simpleType>
-</xsd:schema>