@ekwo-ai/factur-x 0.8.0 → 0.10.0

package/README.md

@@ -60,8 +60,8 @@ const back = await extractFacturX(pdf);                    // { filename: 'factu
 ### VAT categories
 
 Each line carries a `vatRate`. The category (BT-151) is derived when you do not state it:
-positive rate → `S`; zero rate at home → `Z`; zero rate to an EU business with a VAT id → `K`
-(intra-community); to an EU buyer without one → `E`; outside the EU → `G`. Set `vatCategory`
+positive rate → `S`; zero rate at home → `Z`; zero rate to a business in another Member State of the European Union with a VAT id → `K`
+(supply between Member States); to a buyer there without one → `E`; outside the European Union → `G`. Set `vatCategory`
 on the line to override (`AE` reverse charge, `O` not subject to VAT…). Exempt groups get a
 reason text (BT-120, override with `invoice.exemptionReasons`) and the VATEX code where one
 exists.

package/dist/types.d.ts

@@ -13,8 +13,8 @@ export type CurrencyCode = string;
  * - `Z` zero rated
  * - `E` exempt
  * - `AE` reverse charge
- * - `K` intra-community supply
- * - `G` export outside the EU
+ * - `K` supply between Member States of the European Union
+ * - `G` export outside the European Union
  * - `O` not subject to VAT
  */
 export type VatCategory = 'S' | 'Z' | 'E' | 'AE' | 'K' | 'G' | 'O';

package/dist/vat.d.ts

@@ -1,12 +1,12 @@
 import type { VatCategory } from './types.js';
-/** EU member states, ISO 3166-1 alpha-2. */
+/** Member States of the European Union, ISO 3166-1 alpha-2. */
 export declare const EU_COUNTRIES: ReadonlySet<string>;
 export declare function isEuCountry(code: string): boolean;
 /**
  * Picks the VAT category of a line when the caller does not state it.
- * Positive rate → standard. Zero rate: domestic → zero-rated; EU buyer with a
- * VAT identifier → intra-community supply; EU buyer without → exempt;
- * non-EU buyer → export.
+ * Positive rate → standard. Zero rate: domestic → zero-rated; buyer in the European Union with a
+ * VAT identifier → supply between Member States; such a buyer without → exempt;
+ * buyer outside the European Union → export.
  */
 export declare function defaultVatCategory(input: {
     rate: number;

package/dist/vat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vat.d.ts","sourceRoot":"","sources":["../src/vat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,4CAA4C;AAC5C,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAG3C,CAAC;AAEH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;CACxB,GAAG,WAAW,CAOd;AAED,mGAAmG;AACnG,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,WAAW,CAAuC,CAAC;AAE/F,8DAA8D;AAC9D,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAKjF,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,GAAG,GAAG,CAAC,EAAE,MAAM,CAAC,CAM/F,CAAC"}
+{"version":3,"file":"vat.d.ts","sourceRoot":"","sources":["../src/vat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,+DAA+D;AAC/D,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAG3C,CAAC;AAEH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;CACxB,GAAG,WAAW,CAOd;AAED,mGAAmG;AACnG,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,WAAW,CAAuC,CAAC;AAE/F,8DAA8D;AAC9D,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAKjF,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,GAAG,GAAG,CAAC,EAAE,MAAM,CAAC,CAM/F,CAAC"}

package/dist/vat.js

@@ -1,4 +1,4 @@
-/** EU member states, ISO 3166-1 alpha-2. */
+/** Member States of the European Union, ISO 3166-1 alpha-2. */
 export const EU_COUNTRIES = new Set([
     'AT', 'BE', 'BG', 'CY', 'CZ', 'DE', 'DK', 'EE', 'ES', 'FI', 'FR', 'GR', 'HR', 'HU',
     'IE', 'IT', 'LT', 'LU', 'LV', 'MT', 'NL', 'PL', 'PT', 'RO', 'SE', 'SI', 'SK',
@@ -8,9 +8,9 @@ export function isEuCountry(code) {
 }
 /**
  * Picks the VAT category of a line when the caller does not state it.
- * Positive rate → standard. Zero rate: domestic → zero-rated; EU buyer with a
- * VAT identifier → intra-community supply; EU buyer without → exempt;
- * non-EU buyer → export.
+ * Positive rate → standard. Zero rate: domestic → zero-rated; buyer in the European Union with a
+ * VAT identifier → supply between Member States; such a buyer without → exempt;
+ * buyer outside the European Union → export.
  */
 export function defaultVatCategory(input) {
     if (input.rate > 0)
@@ -36,7 +36,7 @@ export const EXEMPTION_REASON_CODES = {
 export const DEFAULT_EXEMPTION_REASONS = {
     E: 'Exempt from VAT',
     AE: 'Reverse charge: VAT to be accounted for by the recipient',
-    K: 'Intra-community supply, exempt from VAT',
+    K: 'Supply between Member States of the European Union, exempt from VAT',
     G: 'Export outside the European Union, exempt from VAT',
     O: 'Not subject to VAT',
 };

package/dist/vat.js.map

@@ -1 +1 @@
-{"version":3,"file":"vat.js","sourceRoot":"","sources":["../src/vat.ts"],"names":[],"mappings":"AAEA,4CAA4C;AAC5C,MAAM,CAAC,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC;IACvD,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CAC7E,CAAC,CAAC;AAEH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAKlC;IACC,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IAC/C,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,GAAG,CAAC;IACjC,IAAI,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC/D,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mGAAmG;AACnG,MAAM,CAAC,MAAM,iBAAiB,GAA6B,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAE/F,8DAA8D;AAC9D,MAAM,CAAC,MAAM,sBAAsB,GAAmD;IACpF,CAAC,EAAE,aAAa;IAChB,EAAE,EAAE,aAAa;IACjB,CAAC,EAAE,YAAY;IACf,CAAC,EAAE,YAAY;CAChB,CAAC;AAEF,2FAA2F;AAC3F,MAAM,CAAC,MAAM,yBAAyB,GAA8D;IAClG,CAAC,EAAE,iBAAiB;IACpB,EAAE,EAAE,0DAA0D;IAC9D,CAAC,EAAE,yCAAyC;IAC5C,CAAC,EAAE,oDAAoD;IACvD,CAAC,EAAE,oBAAoB;CACxB,CAAC"}
+{"version":3,"file":"vat.js","sourceRoot":"","sources":["../src/vat.ts"],"names":[],"mappings":"AAEA,+DAA+D;AAC/D,MAAM,CAAC,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC;IACvD,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CAC7E,CAAC,CAAC;AAEH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAKlC;IACC,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IAC/C,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,GAAG,CAAC;IACjC,IAAI,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC/D,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mGAAmG;AACnG,MAAM,CAAC,MAAM,iBAAiB,GAA6B,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAE/F,8DAA8D;AAC9D,MAAM,CAAC,MAAM,sBAAsB,GAAmD;IACpF,CAAC,EAAE,aAAa;IAChB,EAAE,EAAE,aAAa;IACjB,CAAC,EAAE,YAAY;IACf,CAAC,EAAE,YAAY;CAChB,CAAC;AAEF,2FAA2F;AAC3F,MAAM,CAAC,MAAM,yBAAyB,GAA8D;IAClG,CAAC,EAAE,iBAAiB;IACpB,EAAE,EAAE,0DAA0D;IAC9D,CAAC,EAAE,qEAAqE;IACxE,CAAC,EAAE,oDAAoD;IACvD,CAAC,EAAE,oBAAoB;CACxB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ekwo-ai/factur-x",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Factur-X / ZUGFeRD e-invoices in TypeScript: EN 16931 CII XML from a plain invoice object, PDF/A-3 embedding and extraction.",
   "keywords": [
     "factur-x",