@taxora/sdk 1.9.0 → 1.10.0

package/dist/index.cjs

@@ -27,12 +27,16 @@ __export(index_exports, {
   BillingEndpoint: () => BillingEndpoint,
   CompanyAddress: () => CompanyAddress,
   CompanyEndpoint: () => CompanyEndpoint,
+  ComplianceDeliveryAction: () => ComplianceDeliveryAction,
+  ComplianceDeliveryDecision: () => ComplianceDeliveryDecision,
   ComplianceDocumentType: () => ComplianceDocumentType,
   ComplianceEnrollment: () => ComplianceEnrollment,
   ComplianceEnrollmentPage: () => ComplianceEnrollmentPage,
   ComplianceEnrollmentStatus: () => ComplianceEnrollmentStatus,
   ComplianceOfferings: () => ComplianceOfferings,
   ComplianceService: () => ComplianceService,
+  ComplianceTax: () => ComplianceTax,
+  ComplianceTaxCategory: () => ComplianceTaxCategory,
   ComplianceTaxReport: () => ComplianceTaxReport,
   ComplianceTaxReportPage: () => ComplianceTaxReportPage,
   ComplianceTaxReportState: () => ComplianceTaxReportState,
@@ -41,6 +45,8 @@ __export(index_exports, {
   ComplianceTransactionState: () => ComplianceTransactionState,
   ComplianceTransactionType: () => ComplianceTransactionType,
   DEFAULT_WEBHOOK_TOLERANCE_SECONDS: () => DEFAULT_WEBHOOK_TOLERANCE_SECONDS,
+  EInvoicingQuota: () => EInvoicingQuota,
+  EInvoicingQuotaPeriod: () => EInvoicingQuotaPeriod,
   EReportingEndpoint: () => EReportingEndpoint,
   Environment: () => Environment,
   FetchHttpClient: () => FetchHttpClient,
@@ -88,6 +94,7 @@ __export(index_exports, {
   WEBHOOK_ID_HEADER: () => WEBHOOK_ID_HEADER,
   WEBHOOK_SIGNATURE_HEADER: () => WEBHOOK_SIGNATURE_HEADER,
   WebhookSignatureVerificationError: () => WebhookSignatureVerificationError,
+  calculateInvoiceTotals: () => calculateInvoiceTotals,
   computeWebhookSignature: () => computeWebhookSignature,
   constructWebhookEvent: () => constructWebhookEvent,
   describeApiError: () => describeApiError,
@@ -106,6 +113,7 @@ __export(index_exports, {
   getBaseUrl: () => getBaseUrl,
   getFailedVatStates: () => getFailedVatStates,
   isTransactionBuyerRejected: () => isTransactionBuyerRejected,
+  parseComplianceTaxCategory: () => parseComplianceTaxCategory,
   parseLocalTaxNumbersCsv: () => parseLocalTaxNumbersCsv,
   parseWebhookSignatureHeader: () => parseWebhookSignatureHeader,
   toComplianceDocumentType: () => toComplianceDocumentType,
@@ -564,17 +572,144 @@ var AuthEndpoint = class {
   }
 };
 
-// src/dto/UsageSummary.ts
+// src/dto/EInvoicingQuota.ts
+function asString(value, fallback = "") {
+  return typeof value === "string" ? value : fallback;
+}
+function asNullableString(value) {
+  return typeof value === "string" ? value : null;
+}
+function asInt(value) {
+  return typeof value === "number" ? Math.trunc(value) : Number(value ?? 0) || 0;
+}
 function asRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
 }
+var EInvoicingQuotaPeriod = class _EInvoicingQuotaPeriod {
+  constructor(period, used, included, freeUsed, freeRemaining, billableUnits, amount, monthlyFee, total, state, byCountry, billedAt, manualReference, monthlyFeeReference) {
+    this.period = period;
+    this.used = used;
+    this.included = included;
+    this.freeUsed = freeUsed;
+    this.freeRemaining = freeRemaining;
+    this.billableUnits = billableUnits;
+    this.amount = amount;
+    this.monthlyFee = monthlyFee;
+    this.total = total;
+    this.state = state;
+    this.byCountry = byCountry;
+    this.billedAt = billedAt;
+    this.manualReference = manualReference;
+    this.monthlyFeeReference = monthlyFeeReference;
+  }
+  period;
+  used;
+  included;
+  freeUsed;
+  freeRemaining;
+  billableUnits;
+  amount;
+  monthlyFee;
+  total;
+  state;
+  byCountry;
+  billedAt;
+  manualReference;
+  monthlyFeeReference;
+  static fromArray(data) {
+    const byCountry = {};
+    if (Array.isArray(data["by_country"])) {
+      for (const row of data["by_country"]) {
+        const entry = asRecord(row);
+        if (entry && typeof entry["country"] === "string") {
+          byCountry[entry["country"]] = asInt(entry["used"]);
+        }
+      }
+    }
+    return new _EInvoicingQuotaPeriod(
+      asString(data["period"]),
+      asInt(data["used"]),
+      asInt(data["included"]),
+      asInt(data["free_used"]),
+      asInt(data["free_remaining"]),
+      asInt(data["billable_units"]),
+      asString(data["amount"], "0.00"),
+      asNullableString(data["monthly_fee"]),
+      asString(data["total"], "0.00"),
+      asString(data["state"], "open"),
+      byCountry,
+      asNullableString(data["billed_at"]),
+      asNullableString(data["manual_reference"]),
+      asNullableString(data["monthly_fee_reference"])
+    );
+  }
+};
+var EInvoicingQuota = class _EInvoicingQuota {
+  constructor(billing, plan, currency, included, tiers, countries, monthlyFee, current, history) {
+    this.billing = billing;
+    this.plan = plan;
+    this.currency = currency;
+    this.included = included;
+    this.tiers = tiers;
+    this.countries = countries;
+    this.monthlyFee = monthlyFee;
+    this.current = current;
+    this.history = history;
+  }
+  billing;
+  plan;
+  currency;
+  included;
+  tiers;
+  countries;
+  monthlyFee;
+  current;
+  history;
+  static fromArray(data) {
+    const tiers = [];
+    if (Array.isArray(data["tiers"])) {
+      for (const row of data["tiers"]) {
+        const tier = asRecord(row);
+        if (tier) {
+          tiers.push({
+            upTo: tier["up_to"] === null || tier["up_to"] === void 0 ? null : asInt(tier["up_to"]),
+            unitPrice: asString(tier["unit_price"], "0")
+          });
+        }
+      }
+    }
+    const history = [];
+    if (Array.isArray(data["history"])) {
+      for (const row of data["history"]) {
+        const period = asRecord(row);
+        if (period) history.push(EInvoicingQuotaPeriod.fromArray(period));
+      }
+    }
+    return new _EInvoicingQuota(
+      asString(data["billing"], "invoice"),
+      asNullableString(data["plan"]),
+      asString(data["currency"], "EUR"),
+      asInt(data["included"]),
+      tiers,
+      Array.isArray(data["countries"]) ? data["countries"].map(String) : [],
+      asNullableString(data["monthly_fee"]),
+      EInvoicingQuotaPeriod.fromArray(asRecord(data["current"]) ?? {}),
+      history
+    );
+  }
+};
+
+// src/dto/UsageSummary.ts
+function asRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+}
 function asRecordList(value) {
-  return Array.isArray(value) ? value.filter((row) => asRecord(row) !== null) : [];
+  return Array.isArray(value) ? value.filter((row) => asRecord2(row) !== null) : [];
 }
-function asString(value, fallback = "") {
+function asString2(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString(value) {
+function asNullableString2(value) {
   return typeof value === "string" ? value : null;
 }
 function asNumber(value) {
@@ -631,35 +766,35 @@ var UsageSummary = class _UsageSummary {
     return new _UsageSummary(
       asNumber(data["id"]),
       asNumber(data["company_id"]),
-      asString(data["feature"]),
-      asNullableString(data["country"]),
-      asNullableString(data["regime"]),
-      asString(data["billing_period"]),
+      asString2(data["feature"]),
+      asNullableString2(data["country"]),
+      asNullableString2(data["regime"]),
+      asString2(data["billing_period"]),
       asNumber(data["event_count"]),
       typeof amount === "string" ? amount : typeof amount === "number" ? String(amount) : null,
-      asNullableString(data["state"]),
-      asNullableString(data["state_label"]),
-      asNullableString(data["period_closed_at"]),
-      asNullableString(data["billing_triggered_at"]),
-      asNullableString(data["billed_at"]),
-      asNullableString(data["stripe_invoice_id"]),
-      asNullableString(data["stripe_subscription_item_id"]),
-      asNullableString(data["billing_notes"]),
+      asNullableString2(data["state"]),
+      asNullableString2(data["state_label"]),
+      asNullableString2(data["period_closed_at"]),
+      asNullableString2(data["billing_triggered_at"]),
+      asNullableString2(data["billed_at"]),
+      asNullableString2(data["stripe_invoice_id"]),
+      asNullableString2(data["stripe_subscription_item_id"]),
+      asNullableString2(data["billing_notes"]),
       asRecordList(data["events"]).map((event) => ({
         id: asNumber(event["id"]),
         usageSummaryId: asNullableNumber(event["usage_summary_id"]),
-        feature: asString(event["feature"]),
-        country: asNullableString(event["country"]),
-        regime: asNullableString(event["regime"]),
-        billingPeriod: asString(event["billing_period"]),
-        resourceType: asNullableString(event["resource_type"]),
+        feature: asString2(event["feature"]),
+        country: asNullableString2(event["country"]),
+        regime: asNullableString2(event["regime"]),
+        billingPeriod: asString2(event["billing_period"]),
+        resourceType: asNullableString2(event["resource_type"]),
         resourceId: asNullableNumber(event["resource_id"]),
-        stripeUsageRecordId: asNullableString(event["stripe_usage_record_id"]),
-        stripeReportedAt: asNullableString(event["stripe_reported_at"]),
-        createdAt: asNullableString(event["created_at"])
+        stripeUsageRecordId: asNullableString2(event["stripe_usage_record_id"]),
+        stripeReportedAt: asNullableString2(event["stripe_reported_at"]),
+        createdAt: asNullableString2(event["created_at"])
       })),
-      asNullableString(data["created_at"]),
-      asNullableString(data["updated_at"])
+      asNullableString2(data["created_at"]),
+      asNullableString2(data["updated_at"])
     );
   }
 };
@@ -677,9 +812,9 @@ var UsageSummaryPage = class _UsageSummaryPage {
   total;
   lastPage;
   static fromResponse(payload) {
-    const obj = asRecord(payload) ?? {};
+    const obj = asRecord2(payload) ?? {};
     const rows = asRecordList(obj["data"]).map(UsageSummary.fromArray);
-    const meta = asRecord(obj["meta"]) ?? {};
+    const meta = asRecord2(obj["meta"]) ?? {};
     const num = (value, fallback) => typeof value === "number" ? value : fallback;
     return new _UsageSummaryPage(
       rows,
@@ -731,6 +866,22 @@ var BillingEndpoint = class {
     const data = await this.getJson(`${this.baseUrl}/billing/usage-summaries/${period}`);
     return Array.isArray(data) ? data.filter((row) => typeof row === "object" && row !== null).map(UsageSummary.fromArray) : [];
   }
+  /**
+   * The e-invoicing allowance: documents included per month, used, still free and
+   * what is due for the documents beyond it — one pool over all e-invoicing
+   * countries, current month first, then up to `months - 1` earlier months (1-24).
+   * Resolves to null when the company has no e-invoicing.
+   */
+  async getEInvoicingQuota(months = 6) {
+    if (!Number.isInteger(months) || months < 1 || months > 24) {
+      throw new TaxoraException("months must be an integer between 1 and 24.");
+    }
+    const data = await this.getJson(`${this.baseUrl}/billing/einvoicing-quota?months=${months}`);
+    if (typeof data !== "object" || data === null || Array.isArray(data) || !("billing" in data)) {
+      return null;
+    }
+    return EInvoicingQuota.fromArray(data);
+  }
   buildHeaders() {
     const headers = {
       "Content-Type": "application/json",
@@ -836,6 +987,67 @@ var CompanyEndpoint = class {
   }
 };
 
+// src/enums/ComplianceDeliveryAction.ts
+var ComplianceDeliveryAction = {
+  /** The buyer can receive e-invoices: create the transaction, Taxora sends it. */
+  EINVOICE: "einvoice",
+  /** The buyer is not on the network: send your regular invoice yourself (a transaction would end as not_required and is not billed). */
+  REGULAR_INVOICE: "regular_invoice",
+  /** No definite directory answer yet: create the transaction anyway, Taxora asks again before sending. */
+  EINVOICE_PENDING: "einvoice_pending"
+};
+
+// src/enums/PeppolLookupStatus.ts
+var PeppolLookupStatus = {
+  REACHABLE: "reachable",
+  NOT_REACHABLE: "not_reachable",
+  PENDING: "pending",
+  UNKNOWN: "unknown"
+};
+var VALUES = Object.values(PeppolLookupStatus);
+function toPeppolLookupStatus(value) {
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (VALUES.includes(normalized)) {
+      return normalized;
+    }
+  }
+  return PeppolLookupStatus.UNKNOWN;
+}
+var DESCRIPTIONS = {
+  [PeppolLookupStatus.REACHABLE]: "The participant is registered on Peppol and can receive e-invoices.",
+  [PeppolLookupStatus.NOT_REACHABLE]: "The participant is not registered on Peppol.",
+  [PeppolLookupStatus.PENDING]: "The directory lookup is still resolving \u2014 ask again in a few seconds.",
+  [PeppolLookupStatus.UNKNOWN]: "Unknown lookup status."
+};
+function describePeppolLookupStatus(status) {
+  return DESCRIPTIONS[status];
+}
+
+// src/dto/ComplianceDeliveryDecision.ts
+var ComplianceDeliveryDecision = class _ComplianceDeliveryDecision {
+  constructor(action, lookup) {
+    this.action = action;
+    this.lookup = lookup;
+  }
+  action;
+  lookup;
+  /** True unless the buyer is not on the network. */
+  get sendsEInvoice() {
+    return this.action !== ComplianceDeliveryAction.REGULAR_INVOICE;
+  }
+  static fromLookup(lookup) {
+    switch (lookup.status) {
+      case PeppolLookupStatus.REACHABLE:
+        return new _ComplianceDeliveryDecision(ComplianceDeliveryAction.EINVOICE, lookup);
+      case PeppolLookupStatus.NOT_REACHABLE:
+        return new _ComplianceDeliveryDecision(ComplianceDeliveryAction.REGULAR_INVOICE, lookup);
+      default:
+        return new _ComplianceDeliveryDecision(ComplianceDeliveryAction.EINVOICE_PENDING, lookup);
+    }
+  }
+};
+
 // src/enums/ComplianceEnrollmentStatus.ts
 var ComplianceEnrollmentStatus = {
   PENDING_DATA: "pending_data",
@@ -847,17 +1059,17 @@ var ComplianceEnrollmentStatus = {
   ERROR_ACTIVATION: "error_activation",
   UNKNOWN: "unknown"
 };
-var VALUES = Object.values(ComplianceEnrollmentStatus);
+var VALUES2 = Object.values(ComplianceEnrollmentStatus);
 function toComplianceEnrollmentStatus(value) {
   if (typeof value === "string") {
     const normalized = value.trim().toLowerCase();
-    if (VALUES.includes(normalized)) {
+    if (VALUES2.includes(normalized)) {
       return normalized;
     }
   }
   return ComplianceEnrollmentStatus.UNKNOWN;
 }
-var DESCRIPTIONS = {
+var DESCRIPTIONS2 = {
   [ComplianceEnrollmentStatus.PENDING_DATA]: "Awaiting merchant data before provisioning can start.",
   [ComplianceEnrollmentStatus.ACCOUNT_CREATED]: "Provider account exists. Regime not yet activated.",
   [ComplianceEnrollmentStatus.REGIME_ACTIVATED]: "Compliance regime activated at provider. Ready to submit transactions.",
@@ -868,7 +1080,7 @@ var DESCRIPTIONS = {
   [ComplianceEnrollmentStatus.UNKNOWN]: "Unknown status."
 };
 function describeComplianceEnrollmentStatus(status) {
-  return DESCRIPTIONS[status];
+  return DESCRIPTIONS2[status];
 }
 
 // src/enums/ComplianceService.ts
@@ -877,30 +1089,30 @@ var ComplianceService = {
   E_INVOICING: "e_invoicing",
   UNKNOWN: "unknown"
 };
-var VALUES2 = Object.values(ComplianceService);
+var VALUES3 = Object.values(ComplianceService);
 function toComplianceService(value) {
   if (typeof value === "string") {
     const normalized = value.trim().toLowerCase();
-    if (VALUES2.includes(normalized)) {
+    if (VALUES3.includes(normalized)) {
       return normalized;
     }
   }
   return ComplianceService.UNKNOWN;
 }
-var DESCRIPTIONS2 = {
+var DESCRIPTIONS3 = {
   [ComplianceService.E_REPORTING]: "E-reporting of transaction data to the tax authority (France: DGFiP Flux 10).",
   [ComplianceService.E_INVOICING]: "Structured e-invoices delivered to the buyer (Norway: EHF / Peppol BIS 3.0).",
   [ComplianceService.UNKNOWN]: "Unknown service."
 };
 function describeComplianceService(service) {
-  return DESCRIPTIONS2[service];
+  return DESCRIPTIONS3[service];
 }
 
 // src/dto/ComplianceEnrollment.ts
-function asString2(value, fallback = "") {
+function asString3(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString2(value) {
+function asNullableString3(value) {
   return typeof value === "string" ? value : null;
 }
 function asNumber2(value) {
@@ -952,38 +1164,38 @@ var ComplianceEnrollment = class _ComplianceEnrollment {
     return new _ComplianceEnrollment(
       asNumber2(data["id"]),
       asNumber2(data["company_id"]),
-      asString2(data["country"]),
-      asString2(data["regime"]),
-      asString2(data["provider"]),
+      asString3(data["country"]),
+      asString3(data["regime"]),
+      asString3(data["provider"]),
       toComplianceEnrollmentStatus(data["status"]),
-      asString2(data["status_label"]),
-      asNullableString2(data["status_error"]),
-      asNullableString2(data["provider_account_id"]),
-      asNullableString2(data["tax_id"]),
-      asNullableString2(data["company_register_id"]),
-      asNullableString2(data["company_register_scheme"]),
+      asString3(data["status_label"]),
+      asNullableString3(data["status_error"]),
+      asNullableString3(data["provider_account_id"]),
+      asNullableString3(data["tax_id"]),
+      asNullableString3(data["company_register_id"]),
+      asNullableString3(data["company_register_scheme"]),
       regimeConfig,
-      asNullableString2(data["reporting_start_date"]),
-      asNullableString2(data["notification_email"]),
+      asNullableString3(data["reporting_start_date"]),
+      asNullableString3(data["notification_email"]),
       data["auto_send"] === true,
-      asNullableString2(data["created_at"]),
-      asNullableString2(data["updated_at"]),
+      asNullableString3(data["created_at"]),
+      asNullableString3(data["updated_at"]),
       toComplianceService(data["service"])
     );
   }
 };
 
 // src/dto/ComplianceOfferings.ts
-function asRecord2(value) {
+function asRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
 }
 function asRecordList2(value) {
-  return Array.isArray(value) ? value.filter((row) => asRecord2(row) !== null) : [];
+  return Array.isArray(value) ? value.filter((row) => asRecord3(row) !== null) : [];
 }
-function asString3(value, fallback = "") {
+function asString4(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString3(value) {
+function asNullableString4(value) {
   return typeof value === "string" ? value : null;
 }
 function asNullableNumber2(value) {
@@ -995,8 +1207,8 @@ function asStringList(value) {
   return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
 }
 function toRequires(value) {
-  const record = asRecord2(value);
-  return record === null ? null : { country: asString3(record["country"]), service: asString3(record["service"]) };
+  const record = asRecord3(value);
+  return record === null ? null : { country: asString4(record["country"]), service: asString4(record["service"]) };
 }
 var ComplianceOfferings = class _ComplianceOfferings {
   constructor(offerings, coverage, access, accessByCountry) {
@@ -1011,16 +1223,16 @@ var ComplianceOfferings = class _ComplianceOfferings {
   accessByCountry;
   static fromArray(data) {
     const offerings = asRecordList2(data["data"]).map((row) => ({
-      country: asString3(row["country"]),
-      service: asString3(row["service"]),
-      currency: asString3(row["currency"], "EUR"),
+      country: asString4(row["country"]),
+      service: asString4(row["service"]),
+      currency: asString4(row["currency"], "EUR"),
       active: row["active"] === true,
       viaStripe: row["via_stripe"] === true,
-      plan: asNullableString3(row["plan"]),
-      status: asNullableString3(row["status"]),
+      plan: asNullableString4(row["plan"]),
+      status: asNullableString4(row["status"]),
       enrolled: row["enrolled"] === true,
       plans: asRecordList2(row["plans"]).map((plan) => ({
-        key: asString3(plan["key"]),
+        key: asString4(plan["key"]),
         monthlyFee: asNullableNumber2(plan["monthly_fee"]),
         setupFee: asNullableNumber2(plan["setup_fee"]),
         usageTiers: Array.isArray(plan["usage_tiers"]) ? plan["usage_tiers"] : [],
@@ -1032,19 +1244,19 @@ var ComplianceOfferings = class _ComplianceOfferings {
       }))
     }));
     const coverage = asRecordList2(data["coverage"]).map((row) => ({
-      country: asString3(row["country"]),
-      availability: asString3(row["availability"]),
+      country: asString4(row["country"]),
+      availability: asString4(row["availability"]),
       services: asStringList(row["services"]),
-      network: asNullableString3(row["network"]),
-      format: asNullableString3(row["format"]),
-      mandate: asNullableString3(row["mandate"]),
-      support: asString3(row["support"], "yes")
+      network: asNullableString4(row["network"]),
+      format: asNullableString4(row["format"]),
+      mandate: asNullableString4(row["mandate"]),
+      support: asString4(row["support"], "yes")
     }));
-    const access = asRecord2(data["access"]) ?? {};
+    const access = asRecord3(data["access"]) ?? {};
     const accessByCountry = {};
-    for (const [country, services] of Object.entries(asRecord2(data["access_by_country"]) ?? {})) {
+    for (const [country, services] of Object.entries(asRecord3(data["access_by_country"]) ?? {})) {
       const flags = {};
-      for (const [service, value] of Object.entries(asRecord2(services) ?? {})) {
+      for (const [service, value] of Object.entries(asRecord3(services) ?? {})) {
         flags[service] = value === true;
       }
       accessByCountry[country] = flags;
@@ -1103,17 +1315,17 @@ var ComplianceTaxReportState = {
   ERROR: "error",
   UNKNOWN: "unknown"
 };
-var VALUES3 = Object.values(ComplianceTaxReportState);
+var VALUES4 = Object.values(ComplianceTaxReportState);
 function toComplianceTaxReportState(value) {
   if (typeof value === "string") {
     const normalized = value.trim().toLowerCase();
-    if (VALUES3.includes(normalized)) {
+    if (VALUES4.includes(normalized)) {
       return normalized;
     }
   }
   return ComplianceTaxReportState.UNKNOWN;
 }
-var DESCRIPTIONS3 = {
+var DESCRIPTIONS4 = {
   [ComplianceTaxReportState.NEW]: "Created at provider, waiting for the daily ledger batch.",
   [ComplianceTaxReportState.SENT]: "Ledger transmitted to PPF.",
   [ComplianceTaxReportState.ACKNOWLEDGED]: "PPF acknowledged receipt of the ledger.",
@@ -1123,14 +1335,14 @@ var DESCRIPTIONS3 = {
   [ComplianceTaxReportState.UNKNOWN]: "Unknown state."
 };
 function describeComplianceTaxReportState(state) {
-  return DESCRIPTIONS3[state];
+  return DESCRIPTIONS4[state];
 }
 
 // src/dto/ComplianceTaxReport.ts
-function asString4(value, fallback = "") {
+function asString5(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString4(value) {
+function asNullableString5(value) {
   return typeof value === "string" ? value : null;
 }
 function asNumber3(value) {
@@ -1191,21 +1403,21 @@ var ComplianceTaxReport = class _ComplianceTaxReport {
       asNumber3(data["company_id"]),
       asNullableNumber3(data["compliance_transaction_id"]),
       asNullableNumber3(data["ledger_id"]),
-      asString4(data["country"]),
-      asString4(data["regime"]),
+      asString5(data["country"]),
+      asString5(data["regime"]),
       toComplianceTaxReportState(data["state"]),
-      asString4(data["state_label"]),
+      asString5(data["state_label"]),
       data["is_terminal"] === true,
-      asNullableString4(data["provider_tax_report_id"]),
-      asNullableString4(data["provider_ledger_id"]),
+      asNullableString5(data["provider_tax_report_id"]),
+      asNullableString5(data["provider_ledger_id"]),
       asMoney(data["base_amount"]),
       asMoney(data["tax_amount"]),
       asMoney(data["total_amount"]),
-      asNullableString4(data["refusal_reason"]),
-      asNullableString4(data["registered_at"]),
-      asNullableString4(data["refused_at"]),
-      asNullableString4(data["created_at"]),
-      asNullableString4(data["updated_at"])
+      asNullableString5(data["refusal_reason"]),
+      asNullableString5(data["registered_at"]),
+      asNullableString5(data["refused_at"]),
+      asNullableString5(data["created_at"]),
+      asNullableString5(data["updated_at"])
     );
   }
 };
@@ -1251,23 +1463,23 @@ var ComplianceDocumentType = {
   CREDIT_NOTE: "credit_note",
   UNKNOWN: "unknown"
 };
-var VALUES4 = Object.values(ComplianceDocumentType);
+var VALUES5 = Object.values(ComplianceDocumentType);
 function toComplianceDocumentType(value) {
   if (typeof value === "string") {
     const normalized = value.trim().toLowerCase();
-    if (VALUES4.includes(normalized)) {
+    if (VALUES5.includes(normalized)) {
       return normalized;
     }
   }
   return ComplianceDocumentType.UNKNOWN;
 }
-var DESCRIPTIONS4 = {
+var DESCRIPTIONS5 = {
   [ComplianceDocumentType.INVOICE]: "Commercial invoice.",
   [ComplianceDocumentType.CREDIT_NOTE]: "Credit note correcting a previously issued invoice.",
   [ComplianceDocumentType.UNKNOWN]: "Unknown document type."
 };
 function describeComplianceDocumentType(type) {
-  return DESCRIPTIONS4[type];
+  return DESCRIPTIONS5[type];
 }
 
 // src/enums/ComplianceTransactionState.ts
@@ -1280,17 +1492,17 @@ var ComplianceTransactionState = {
   NOT_REQUIRED: "not_required",
   UNKNOWN: "unknown"
 };
-var VALUES5 = Object.values(ComplianceTransactionState);
+var VALUES6 = Object.values(ComplianceTransactionState);
 function toComplianceTransactionState(value) {
   if (typeof value === "string") {
     const normalized = value.trim().toLowerCase();
-    if (VALUES5.includes(normalized)) {
+    if (VALUES6.includes(normalized)) {
       return normalized;
     }
   }
   return ComplianceTransactionState.UNKNOWN;
 }
-var DESCRIPTIONS5 = {
+var DESCRIPTIONS6 = {
   [ComplianceTransactionState.PENDING]: "Recorded locally, not yet submitted to the provider.",
   [ComplianceTransactionState.SENDING]: "Submission to the provider in progress.",
   [ComplianceTransactionState.SUBMITTED]: "Successfully submitted to the provider.",
@@ -1299,7 +1511,7 @@ var DESCRIPTIONS5 = {
   [ComplianceTransactionState.UNKNOWN]: "Unknown state."
 };
 function describeComplianceTransactionState(state) {
-  return DESCRIPTIONS5[state];
+  return DESCRIPTIONS6[state];
 }
 
 // src/enums/ComplianceTransactionType.ts
@@ -1311,17 +1523,17 @@ var ComplianceTransactionType = {
   CROSSBORDER_INBOUND: "crossborder_inbound",
   UNKNOWN: "unknown"
 };
-var VALUES6 = Object.values(ComplianceTransactionType);
+var VALUES7 = Object.values(ComplianceTransactionType);
 function toComplianceTransactionType(value) {
   if (typeof value === "string") {
     const normalized = value.trim().toLowerCase();
-    if (VALUES6.includes(normalized)) {
+    if (VALUES7.includes(normalized)) {
       return normalized;
     }
   }
   return ComplianceTransactionType.UNKNOWN;
 }
-var DESCRIPTIONS6 = {
+var DESCRIPTIONS7 = {
   [ComplianceTransactionType.B2C_OUTBOUND]: "Sale to a private person in the merchant country (DGFiP Flux 10.3).",
   [ComplianceTransactionType.B2B_DOMESTIC_OUTBOUND]: "Sale to a domestic business (DGFiP Flux 1, Phase 2).",
   [ComplianceTransactionType.B2B_DOMESTIC_INBOUND]: "Purchase from a domestic business (DGFiP Flux 1, Phase 2).",
@@ -1330,14 +1542,14 @@ var DESCRIPTIONS6 = {
   [ComplianceTransactionType.UNKNOWN]: "Unknown transaction type."
 };
 function describeComplianceTransactionType(type) {
-  return DESCRIPTIONS6[type];
+  return DESCRIPTIONS7[type];
 }
 
 // src/dto/ComplianceTransaction.ts
-function asString5(value, fallback = "") {
+function asString6(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString5(value) {
+function asNullableString6(value) {
   return typeof value === "string" ? value : null;
 }
 function asNumber4(value) {
@@ -1353,45 +1565,45 @@ function asNullableNumber4(value) {
   if (typeof value === "string" && value.trim() !== "" && Number.isFinite(Number(value))) return Number(value);
   return null;
 }
-function asRecord3(value) {
+function asRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
 }
 function asRecordList3(value) {
-  return Array.isArray(value) ? value.filter((row) => asRecord3(row) !== null) : [];
+  return Array.isArray(value) ? value.filter((row) => asRecord4(row) !== null) : [];
 }
 function toInvoicePdf(value) {
-  const pdf = asRecord3(value);
+  const pdf = asRecord4(value);
   if (pdf === null) return null;
   return {
-    filename: asNullableString5(pdf["filename"]),
+    filename: asNullableString6(pdf["filename"]),
     size: asNullableNumber4(pdf["size"]),
     attached: pdf["attached"] === true
   };
 }
 function toEurEquivalent(value) {
-  const eur = asRecord3(value);
+  const eur = asRecord4(value);
   if (eur === null) return null;
   return {
     subtotal: asMoney2(eur["subtotal"]),
     taxAmount: asMoney2(eur["tax_amount"]),
     total: asMoney2(eur["total"]),
-    rate: asString5(eur["rate"]),
-    rateDate: asNullableString5(eur["rate_date"]),
-    source: asString5(eur["source"], "ECB")
+    rate: asString6(eur["rate"]),
+    rateDate: asNullableString6(eur["rate_date"]),
+    source: asString6(eur["source"], "ECB")
   };
 }
 function toInvoiceLines(providerPayload) {
-  const invoice = asRecord3(asRecord3(providerPayload)?.["invoice"]);
+  const invoice = asRecord4(asRecord4(providerPayload)?.["invoice"]);
   return asRecordList3(invoice?.["invoice_lines_attributes"]).map((line) => ({
-    description: asString5(line["description"]),
+    description: asString6(line["description"]),
     quantity: asNullableNumber4(line["quantity"]),
     price: asMoney2(line["price"]),
     unit: asNullableNumber4(line["unit"]),
     taxes: asRecordList3(line["taxes_attributes"]).map((tax) => ({
-      name: asString5(tax["name"]),
+      name: asString6(tax["name"]),
       percent: asNullableNumber4(tax["percent"]),
-      category: asNullableString5(tax["category"]),
-      comment: asNullableString5(tax["comment"])
+      category: asNullableString6(tax["category"]),
+      comment: asNullableString6(tax["comment"])
     }))
   }));
 }
@@ -1499,48 +1711,48 @@ var ComplianceTransaction = class _ComplianceTransaction {
       asNumber4(data["id"]),
       asNumber4(data["company_id"]),
       asNumber4(data["compliance_enrollment_id"]),
-      asString5(data["country"]),
-      asString5(data["regime"]),
+      asString6(data["country"]),
+      asString6(data["regime"]),
       toComplianceTransactionType(data["transaction_type"]),
-      asString5(data["transaction_type_label"]),
+      asString6(data["transaction_type_label"]),
       toComplianceTransactionState(data["state"]),
-      asString5(data["state_label"]),
-      asString5(data["invoice_number"]),
-      asNullableString5(data["invoice_date"]),
-      asNullableString5(data["due_date"]),
-      asString5(data["currency"], "EUR"),
+      asString6(data["state_label"]),
+      asString6(data["invoice_number"]),
+      asNullableString6(data["invoice_date"]),
+      asNullableString6(data["due_date"]),
+      asString6(data["currency"], "EUR"),
       asMoney2(data["subtotal"]),
       asMoney2(data["tax_amount"]),
       asMoney2(data["total"]),
-      asNullableString5(data["counterparty_name"]),
-      asNullableString5(data["counterparty_country"]),
-      asNullableString5(data["counterparty_vat_number"]),
+      asNullableString6(data["counterparty_name"]),
+      asNullableString6(data["counterparty_country"]),
+      asNullableString6(data["counterparty_vat_number"]),
       data["is_paid"] === true,
-      asNullableString5(data["paid_at"]),
-      asNullableString5(data["provider_invoice_id"]),
-      asNullableString5(data["submission_error"]),
-      asNullableString5(data["reported_at"]),
+      asNullableString6(data["paid_at"]),
+      asNullableString6(data["provider_invoice_id"]),
+      asNullableString6(data["submission_error"]),
+      asNullableString6(data["reported_at"]),
       taxReport,
-      asNullableString5(data["created_at"]),
-      asNullableString5(data["updated_at"]),
-      asNullableString5(data["counterparty_register_id"]),
-      asNullableString5(data["counterparty_address"]),
-      asNullableString5(data["counterparty_city"]),
-      asNullableString5(data["counterparty_postalcode"]),
-      asNullableString5(data["counterparty_email"]),
-      asNullableString5(data["buyer_reference"]),
+      asNullableString6(data["created_at"]),
+      asNullableString6(data["updated_at"]),
+      asNullableString6(data["counterparty_register_id"]),
+      asNullableString6(data["counterparty_address"]),
+      asNullableString6(data["counterparty_city"]),
+      asNullableString6(data["counterparty_postalcode"]),
+      asNullableString6(data["counterparty_email"]),
+      asNullableString6(data["buyer_reference"]),
       data["document_type"] === void 0 || data["document_type"] === null ? ComplianceDocumentType.INVOICE : toComplianceDocumentType(data["document_type"]),
-      asNullableString5(data["amended_number"]),
-      asNullableString5(data["amended_date"]),
-      asNullableString5(data["provider_state"]),
+      asNullableString6(data["amended_number"]),
+      asNullableString6(data["amended_date"]),
+      asNullableString6(data["provider_state"]),
       toInvoiceLines(data["provider_payload"]),
-      asNullableString5(data["document_url"]),
-      asRecord3(data["delivery_check"]),
+      asNullableString6(data["document_url"]),
+      asRecord4(data["delivery_check"]),
       toInvoicePdf(data["invoice_pdf"]),
-      asNullableString5(data["internal_reference"]),
-      asNullableString5(data["pdf_url"]),
+      asNullableString6(data["internal_reference"]),
+      asNullableString6(data["pdf_url"]),
       data["buyer_rejected"] === true,
-      asNullableString5(data["rejection_reason"]),
+      asNullableString6(data["rejection_reason"]),
       toEurEquivalent(data["eur_equivalent"])
     );
   }
@@ -1600,38 +1812,11 @@ var ImportResult = class _ImportResult {
   }
 };
 
-// src/enums/PeppolLookupStatus.ts
-var PeppolLookupStatus = {
-  REACHABLE: "reachable",
-  NOT_REACHABLE: "not_reachable",
-  PENDING: "pending",
-  UNKNOWN: "unknown"
-};
-var VALUES7 = Object.values(PeppolLookupStatus);
-function toPeppolLookupStatus(value) {
-  if (typeof value === "string") {
-    const normalized = value.trim().toLowerCase();
-    if (VALUES7.includes(normalized)) {
-      return normalized;
-    }
-  }
-  return PeppolLookupStatus.UNKNOWN;
-}
-var DESCRIPTIONS7 = {
-  [PeppolLookupStatus.REACHABLE]: "The participant is registered on Peppol and can receive e-invoices.",
-  [PeppolLookupStatus.NOT_REACHABLE]: "The participant is not registered on Peppol.",
-  [PeppolLookupStatus.PENDING]: "The directory lookup is still resolving \u2014 ask again in a few seconds.",
-  [PeppolLookupStatus.UNKNOWN]: "Unknown lookup status."
-};
-function describePeppolLookupStatus(status) {
-  return DESCRIPTIONS7[status];
-}
-
 // src/dto/PeppolLookupResult.ts
-function asString6(value, fallback = "") {
+function asString7(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString6(value) {
+function asNullableString7(value) {
   return typeof value === "string" ? value : null;
 }
 var PeppolLookupResult = class _PeppolLookupResult {
@@ -1662,21 +1847,21 @@ var PeppolLookupResult = class _PeppolLookupResult {
     return new _PeppolLookupResult(
       toPeppolLookupStatus(data["status"]),
       typeof data["reachable"] === "boolean" ? data["reachable"] : null,
-      asString6(data["country"]),
-      asString6(data["scheme"]),
-      asString6(data["id"]),
+      asString7(data["country"]),
+      asString7(data["scheme"]),
+      asString7(data["id"]),
       documentTypes,
-      asNullableString6(data["transport_type_code"]),
-      asNullableString6(data["checked_at"])
+      asNullableString7(data["transport_type_code"]),
+      asNullableString7(data["checked_at"])
     );
   }
 };
 
 // src/dto/RegistryCompany.ts
-function asString7(value, fallback = "") {
+function asString8(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString7(value) {
+function asNullableString8(value) {
   return typeof value === "string" ? value : null;
 }
 var RegistryCompany = class _RegistryCompany {
@@ -1708,24 +1893,24 @@ var RegistryCompany = class _RegistryCompany {
   country;
   static fromArray(data) {
     return new _RegistryCompany(
-      asString7(data["org_number"]),
-      asString7(data["company_name"]),
-      asNullableString7(data["organisation_form"]),
+      asString8(data["org_number"]),
+      asString8(data["company_name"]),
+      asNullableString8(data["organisation_form"]),
       data["vat_registered"] === true,
-      asNullableString7(data["vat_number"]),
+      asNullableString8(data["vat_number"]),
       data["enterprise_register"] === true,
       data["bankrupt"] === true,
       data["under_liquidation"] === true,
-      asNullableString7(data["address"]),
-      asNullableString7(data["postalcode"]),
-      asNullableString7(data["city"]),
-      asString7(data["country"])
+      asNullableString8(data["address"]),
+      asNullableString8(data["postalcode"]),
+      asNullableString8(data["city"]),
+      asString8(data["country"])
     );
   }
 };
 
 // src/dto/RevenueStatistics.ts
-function asString8(value, fallback = "") {
+function asString9(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
 function asNumber5(value) {
@@ -1777,35 +1962,35 @@ var RevenueStatistics = class _RevenueStatistics {
       typeof data["totals"] === "object" && data["totals"] !== null ? data["totals"] : {}
     );
     const timeSeries = asRecords(data["time_series"]).map((row) => ({
-      bucket: asString8(row["bucket"]),
+      bucket: asString9(row["bucket"]),
       ...toTotals(row)
     }));
     const byType = asRecords(data["by_type"]).map((row) => ({
-      type: asString8(row["type"]),
-      typeLabel: asString8(row["type_label"]),
+      type: asString9(row["type"]),
+      typeLabel: asString9(row["type_label"]),
       count: asNumber5(row["count"]),
       total: asMoney3(row["total"])
     }));
     const byCountry = asRecords(data["by_country"]).map((row) => ({
-      country: asString8(row["country"], "unknown"),
+      country: asString9(row["country"], "unknown"),
       count: asNumber5(row["count"]),
       total: asMoney3(row["total"])
     }));
     const byState = asRecords(data["by_state"]).map((row) => ({
-      state: asString8(row["state"]),
-      stateLabel: asString8(row["state_label"]),
+      state: asString9(row["state"]),
+      stateLabel: asString9(row["state_label"]),
       count: asNumber5(row["count"]),
       total: asMoney3(row["total"])
     }));
     const byCurrency = asRecords(data["by_currency"]).map((row) => ({
-      currency: asString8(row["currency"]),
+      currency: asString9(row["currency"]),
       ...toTotals(row)
     }));
     return new _RevenueStatistics(
-      asString8(range["date_from"]) || void 0,
-      asString8(range["date_to"]) || void 0,
-      asString8(range["interval"]) || void 0,
-      asString8(data["primary_currency"], "EUR"),
+      asString9(range["date_from"]) || void 0,
+      asString9(range["date_to"]) || void 0,
+      asString9(range["interval"]) || void 0,
+      asString9(data["primary_currency"], "EUR"),
       data["is_multi_currency"] === true,
       totals,
       timeSeries,
@@ -1818,10 +2003,10 @@ var RevenueStatistics = class _RevenueStatistics {
 };
 
 // src/dto/SireneLookupResult.ts
-function asString9(value, fallback = "") {
+function asString10(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString8(value) {
+function asNullableString9(value) {
   return typeof value === "string" ? value : null;
 }
 var SireneLookupResult = class _SireneLookupResult {
@@ -1847,21 +2032,21 @@ var SireneLookupResult = class _SireneLookupResult {
   postalcode;
   static fromArray(data) {
     return new _SireneLookupResult(
-      asString9(data["company_name"]),
-      asString9(data["siren"]),
-      asNullableString8(data["siret"]),
-      asNullableString8(data["naf_code"]),
-      asNullableString8(data["naf_full"]),
-      asNullableString8(data["enterprise_size"]),
-      asNullableString8(data["address"]),
-      asNullableString8(data["city"]),
-      asNullableString8(data["postalcode"])
+      asString10(data["company_name"]),
+      asString10(data["siren"]),
+      asNullableString9(data["siret"]),
+      asNullableString9(data["naf_code"]),
+      asNullableString9(data["naf_full"]),
+      asNullableString9(data["enterprise_size"]),
+      asNullableString9(data["address"]),
+      asNullableString9(data["city"]),
+      asNullableString9(data["postalcode"])
     );
   }
 };
 
 // src/dto/VatRates.ts
-function asString10(value, fallback = "") {
+function asString11(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
 function asNumber6(value) {
@@ -1879,12 +2064,12 @@ var VatRates = class _VatRates {
   static fromArray(data) {
     const rates = (Array.isArray(data["rates"]) ? data["rates"] : []).filter((row) => typeof row === "object" && row !== null).map((row) => ({
       percent: asNumber6(row["percent"]),
-      category: asString10(row["category"]),
-      labelKey: asString10(row["label_key"]),
-      taxName: asString10(row["tax_name"]),
+      category: asString11(row["category"]),
+      labelKey: asString11(row["label_key"]),
+      taxName: asString11(row["tax_name"]),
       requiresVatex: row["requires_vatex"] === true
     }));
-    return new _VatRates(asString10(data["country"]), asString10(data["currency"], "EUR"), rates);
+    return new _VatRates(asString11(data["country"]), asString11(data["currency"], "EUR"), rates);
   }
 };
 
@@ -1938,6 +2123,25 @@ var NorwegianOrgNumber = {
   }
 };
 
+// src/enums/ComplianceTaxCategory.ts
+var ComplianceTaxCategory = {
+  STANDARD: "S",
+  REDUCED: "AA",
+  SUPER_REDUCED: "AAA",
+  INTRA_COMMUNITY: "K",
+  EXPORT: "G",
+  REVERSE_CHARGE: "AE",
+  EXEMPT: "E",
+  ZERO: "Z"
+};
+var CODES = Object.values(ComplianceTaxCategory);
+function parseComplianceTaxCategory(value) {
+  if (typeof value !== "string") return null;
+  const code = value.trim().toUpperCase();
+  return CODES.includes(code) ? code : null;
+}
+var COMPLIANCE_TAX_CATEGORY_CODES = CODES;
+
 // src/endpoints/EReportingEndpoint.ts
 var DATE_REGEX = /^\d{4}-\d{2}-\d{2}$/;
 var NAF_CODE_REGEX = /^\d{2}$/;
@@ -2122,6 +2326,19 @@ var EReportingEndpoint = class {
     const data = await this.parseJsonResponse(response);
     return PeppolLookupResult.fromArray(data);
   }
+  /**
+   * What to do with an invoice to this buyer: peppolLookup() turned into an action,
+   * e.g. in a shop checkout when a business buyer enters its number.
+   *
+   * - `einvoice`: create the transaction, Taxora sends the e-invoice;
+   * - `regular_invoice`: the buyer is not on the network — send your regular invoice
+   *   yourself (a transaction would end as not_required and is not billed);
+   * - `einvoice_pending`: no definite answer yet — create the transaction anyway,
+   *   Taxora asks the directory again before sending.
+   */
+  async decideDelivery(country, id, scheme) {
+    return ComplianceDeliveryDecision.fromLookup(await this.peppolLookup(country, id, scheme));
+  }
   // ---------------------------------------------------------------------
   // Transactions
   // ---------------------------------------------------------------------
@@ -2148,6 +2365,7 @@ var EReportingEndpoint = class {
     this.validateBuyerFields(input);
     this.validateInternalReference(input.internalReference);
     this.validateInvoicePdfFilename(input);
+    this.validateDocument(input);
     const body = {
       compliance_enrollment_id: input.complianceEnrollmentId,
       transaction_type: input.transactionType,
@@ -2163,6 +2381,101 @@ var EReportingEndpoint = class {
     const data = await this.parseJsonResponse(response);
     return ComplianceTransaction.fromArray(data);
   }
+  /**
+   * Issue a credit note for an invoice you sent through Taxora. Everything that must
+   * match the corrected invoice is taken from `original`: enrollment, transaction type,
+   * currency, buyer (name, register id, address, e-mail, VAT number, buyer reference) —
+   * and the reference to the corrected invoice (number and date) is set for you.
+   *
+   * Without invoiceLines and amounts it credits the whole invoice: lines and amounts are
+   * taken over as they are (the document type, not the sign, makes it a credit note).
+   * For a partial credit pass invoiceLines, subtotal, taxAmount and total together.
+   *
+   * Not possible for an invoice that was never sent to the buyer (state not_required)
+   * or for a credit note. A buyer rejected the invoice? Correct it with a credit note and
+   * send a new invoice (`original.buyerRejected`).
+   */
+  async createCreditNote(original, input) {
+    if (original.documentType === ComplianceDocumentType.CREDIT_NOTE) {
+      throw new TaxoraException("A credit note cannot be credited again; issue a new invoice instead.");
+    }
+    if (original.state === ComplianceTransactionState.NOT_REQUIRED) {
+      throw new TaxoraException(
+        "The invoice was never sent as an e-invoice (the buyer is not on the network), so there is nothing to credit; correct your regular invoice instead."
+      );
+    }
+    if (original.invoiceNumber === "") {
+      throw new TaxoraException("The original transaction has no invoice number.");
+    }
+    if (original.transactionType === "unknown") {
+      throw new TaxoraException("The original transaction has an unknown transaction type.");
+    }
+    const partial = [input.invoiceLines, input.subtotal, input.taxAmount, input.total];
+    if (![0, 4].includes(partial.filter((value) => value !== void 0).length)) {
+      throw new TaxoraException("For a partial credit pass invoiceLines, subtotal, taxAmount and total together.");
+    }
+    let invoiceLines;
+    let subtotal = input.subtotal;
+    let taxAmount = input.taxAmount;
+    let total = input.total;
+    if (input.invoiceLines !== void 0) {
+      invoiceLines = input.invoiceLines;
+    } else {
+      invoiceLines = original.invoiceLines.map((line) => ({
+        description: line.description,
+        quantity: line.quantity ?? 0,
+        price: Number(line.price),
+        ...line.unit !== null ? { unit: line.unit } : {},
+        taxes: line.taxes.map((tax) => ({
+          name: tax.name,
+          percent: tax.percent ?? 0,
+          category: this.storedTaxCategory(tax.category),
+          ...tax.comment !== null ? { comment: tax.comment } : {}
+        }))
+      }));
+      if (invoiceLines.length === 0) {
+        throw new TaxoraException(
+          "The original transaction carries no invoice lines; pass invoiceLines and the amounts explicitly."
+        );
+      }
+      subtotal = Number(original.subtotal);
+      taxAmount = Number(original.taxAmount);
+      total = Number(original.total);
+    }
+    const buyer = Object.fromEntries(
+      Object.entries({
+        counterpartyName: original.counterpartyName,
+        counterpartyCountry: original.counterpartyCountry,
+        counterpartyVatNumber: original.counterpartyVatNumber,
+        counterpartyRegisterId: original.counterpartyRegisterId,
+        counterpartyAddress: original.counterpartyAddress,
+        counterpartyCity: original.counterpartyCity,
+        counterpartyPostalcode: original.counterpartyPostalcode,
+        counterpartyEmail: original.counterpartyEmail,
+        buyerReference: original.buyerReference
+      }).filter(([, value]) => value !== null && value !== "")
+    );
+    return this.createTransaction({
+      complianceEnrollmentId: original.complianceEnrollmentId,
+      transactionType: original.transactionType,
+      invoiceNumber: input.creditNoteNumber,
+      invoiceDate: input.invoiceDate ?? /* @__PURE__ */ new Date(),
+      subtotal: subtotal ?? 0,
+      total: total ?? 0,
+      invoiceLines,
+      currency: original.currency,
+      ...taxAmount !== void 0 ? { taxAmount } : {},
+      ...buyer,
+      isCreditNote: true,
+      amendedNumber: original.invoiceNumber,
+      ...original.invoiceDate !== null ? { amendedDate: original.invoiceDate } : {},
+      ...input.extraInfo !== void 0 ? { extraInfo: input.extraInfo } : {},
+      ...input.internalReference !== void 0 ? { internalReference: input.internalReference } : {},
+      ...input.submitNow !== void 0 ? { submitNow: input.submitNow } : {},
+      ...input.invoicePdf !== void 0 ? { invoicePdf: input.invoicePdf } : {},
+      ...input.invoicePdfFilename !== void 0 ? { invoicePdfFilename: input.invoicePdfFilename } : {}
+    });
+  }
   /** Paginated list of the company's transactions (newest invoice date first), filterable by date / state / type / enrollment / country / search / internal reference / provider state. */
   async listTransactions(filters = {}) {
     const params = this.buildTransactionFilterParams(filters);
@@ -2731,6 +3044,26 @@ var EReportingEndpoint = class {
       if (line.taxes.length === 0) {
         throw new TaxoraException(`invoiceLines[${index}].taxes must contain at least one tax.`);
       }
+      line.taxes.forEach((tax, taxIndex) => {
+        const where = `invoiceLines[${index}].taxes[${taxIndex}]`;
+        const category = parseComplianceTaxCategory(tax.category);
+        if (category === null) {
+          throw new TaxoraException(
+            `${where}.category "${String(tax.category)}" is unknown. Valid: ${COMPLIANCE_TAX_CATEGORY_CODES.join(", ")}.`
+          );
+        }
+        if (!Number.isFinite(tax.percent) || tax.percent < 0 || tax.percent > 100) {
+          throw new TaxoraException(`${where}.percent must be between 0 and 100.`);
+        }
+        if (category === "E" && (tax.comment === void 0 || tax.comment.trim() === "")) {
+          throw new TaxoraException(
+            `${where}: an exempt (category E) tax needs the exemption code (VATEX) as comment.`
+          );
+        }
+        if (tax.comment !== void 0 && tax.comment.length > 255) {
+          throw new TaxoraException(`${where}.comment must not exceed 255 characters.`);
+        }
+      });
     });
   }
   validateInvoicePdfFilename(input) {
@@ -2747,12 +3080,65 @@ var EReportingEndpoint = class {
       throw new TaxoraException("internalReference must not exceed 100 characters.");
     }
   }
+  /**
+   * Relations that cannot be right: a due date before the invoice date, a credit note without (or an
+   * invoice with) a corrected invoice, a credit note that reuses the number it corrects, a corrected
+   * invoice dated after the credit note.
+   */
+  validateDocument(input) {
+    for (const [field, value] of [
+      ["subtotal", input.subtotal],
+      ["taxAmount", input.taxAmount],
+      ["total", input.total]
+    ]) {
+      if (value !== void 0 && !Number.isFinite(Number(value))) {
+        throw new TaxoraException(`${field} must be a finite number.`);
+      }
+    }
+    for (const line of input.invoiceLines ?? []) {
+      if (!Number.isFinite(line.quantity) || !Number.isFinite(line.price)) {
+        throw new TaxoraException("Every invoice line needs a numeric quantity and price.");
+      }
+    }
+    const invoiceDate = this.formatDate(input.invoiceDate);
+    if (input.dueDate !== void 0 && this.formatDate(input.dueDate) < invoiceDate) {
+      throw new TaxoraException("dueDate must not be before invoiceDate.");
+    }
+    if (input.counterpartyVatNumber !== void 0 && input.counterpartyVatNumber.length > 50) {
+      throw new TaxoraException("counterpartyVatNumber must not exceed 50 characters.");
+    }
+    const amended = input.amendedNumber?.trim() ?? "";
+    if (input.isCreditNote === true && amended === "") {
+      throw new TaxoraException("A credit note needs amendedNumber, the number of the invoice it corrects.");
+    }
+    if (input.isCreditNote !== true && amended !== "") {
+      throw new TaxoraException("amendedNumber is only for credit notes; set isCreditNote to issue one.");
+    }
+    if (amended !== "" && amended === input.invoiceNumber.trim()) {
+      throw new TaxoraException(
+        "A credit note needs its own number; it cannot reuse the number of the invoice it corrects."
+      );
+    }
+    if (input.amendedDate !== void 0 && this.formatDate(input.amendedDate) > invoiceDate) {
+      throw new TaxoraException("amendedDate (the corrected invoice) must not be after the credit note date.");
+    }
+  }
+  /** A category read back from a stored invoice; one that is not a known code cannot be re-sent. */
+  storedTaxCategory(category) {
+    const parsed = parseComplianceTaxCategory(category);
+    if (parsed === null) {
+      throw new TaxoraException(
+        `The original invoice has an unknown tax category "${String(category)}"; pass invoiceLines and the amounts explicitly.`
+      );
+    }
+    return parsed;
+  }
   validateOptionalCodes(input) {
-    if (input.currency !== void 0 && input.currency.length !== 3) {
-      throw new TaxoraException("currency must be a 3-character ISO 4217 code.");
+    if (input.currency !== void 0 && !/^[A-Za-z]{3}$/.test(input.currency)) {
+      throw new TaxoraException("currency must be an ISO 4217 code, three letters (e.g. NOK, EUR).");
     }
-    if (input.counterpartyCountry !== void 0 && input.counterpartyCountry.length !== 2) {
-      throw new TaxoraException("counterpartyCountry must be a 2-character ISO 3166-1 alpha-2 code.");
+    if (input.counterpartyCountry !== void 0 && !/^[A-Za-z]{2}$/.test(input.counterpartyCountry)) {
+      throw new TaxoraException("counterpartyCountry must be an ISO 3166-1 alpha-2 code, two letters (e.g. NO).");
     }
   }
   /**
@@ -2795,7 +3181,7 @@ var EReportingEndpoint = class {
           const taxBuilt = {
             name: tax.name,
             percent: tax.percent,
-            category: tax.category
+            category: parseComplianceTaxCategory(tax.category) ?? tax.category
           };
           if (tax.comment !== void 0) taxBuilt["comment"] = tax.comment;
           return taxBuilt;
@@ -2808,10 +3194,10 @@ var EReportingEndpoint = class {
   /** Applies the optional scalar fields shared by create and update. */
   applyOptionalTransactionFields(body, input) {
     if (input.dueDate !== void 0) body["due_date"] = this.formatDate(input.dueDate);
-    if (input.currency !== void 0) body["currency"] = input.currency;
+    if (input.currency !== void 0) body["currency"] = input.currency.toUpperCase();
     if (input.taxAmount !== void 0) body["tax_amount"] = input.taxAmount;
     if (input.counterpartyName !== void 0) body["counterparty_name"] = input.counterpartyName;
-    if (input.counterpartyCountry !== void 0) body["counterparty_country"] = input.counterpartyCountry;
+    if (input.counterpartyCountry !== void 0) body["counterparty_country"] = input.counterpartyCountry.toUpperCase();
     if (input.counterpartyVatNumber !== void 0) body["counterparty_vat_number"] = input.counterpartyVatNumber;
     if (input.providerContactId !== void 0) body["provider_contact_id"] = input.providerContactId;
     if (input.paymentMethod !== void 0) body["payment_method"] = input.paymentMethod;
@@ -3479,13 +3865,13 @@ var SmartEnrichmentHistoryPage = class _SmartEnrichmentHistoryPage {
 };
 
 // src/dto/SmartEnrichmentStatistics.ts
-function asString11(value, fallback = "") {
+function asString12(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
 function asNumber7(value) {
   return typeof value === "number" ? value : Number(value ?? 0) || 0;
 }
-function asRecord4(value) {
+function asRecord5(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
 function asRecords2(value) {
@@ -3508,32 +3894,32 @@ var SmartEnrichmentStatistics = class _SmartEnrichmentStatistics {
   byOutcome;
   confidenceBuckets;
   static fromArray(data) {
-    const range = asRecord4(data["range"]);
-    const totals = asRecord4(data["totals"]);
+    const range = asRecord5(data["range"]);
+    const totals = asRecord5(data["totals"]);
     const timeSeries = asRecords2(data["time_series"]).map((row) => ({
-      bucket: asString11(row["bucket"]),
+      bucket: asString12(row["bucket"]),
       jobs: asNumber7(row["jobs"]),
       items: asNumber7(row["items"]),
       found: asNumber7(row["found"])
     }));
     const bySource = asRecords2(data["by_source"]).map((row) => ({
-      source: asString11(row["source"]),
+      source: asString12(row["source"]),
       jobs: asNumber7(row["jobs"]),
       found: asNumber7(row["found"])
     }));
     const byOutcome = asRecords2(data["by_outcome"]).map((row) => ({
-      outcome: asString11(row["outcome"]),
+      outcome: asString12(row["outcome"]),
       count: asNumber7(row["count"])
     }));
     const confidenceBuckets = asRecords2(data["confidence_buckets"]).map((row) => ({
-      bucket: asString11(row["bucket"]),
+      bucket: asString12(row["bucket"]),
       count: asNumber7(row["count"])
     }));
     return new _SmartEnrichmentStatistics(
       {
-        dateFrom: asString11(range["date_from"]),
-        dateTo: asString11(range["date_to"]),
-        interval: asString11(range["interval"])
+        dateFrom: asString12(range["date_from"]),
+        dateTo: asString12(range["date_to"]),
+        interval: asString12(range["interval"])
       },
       {
         jobs: asNumber7(totals["jobs"]),
@@ -4890,6 +5276,68 @@ var Language = {
   GERMAN: "de"
 };
 
+// src/support/calculateInvoiceTotals.ts
+function round2(value) {
+  const magnitude = Math.round(Number((Math.abs(value) * 100).toPrecision(15)));
+  return (value < 0 ? -magnitude : magnitude) / 100;
+}
+function calculateInvoiceTotals(lines, options = {}) {
+  let net = 0;
+  let tax = 0;
+  for (const line of lines) {
+    const lineNet = round2(line.quantity * line.price);
+    const percent = line.taxes.reduce((sum, t) => sum + t.percent, 0);
+    net += lineNet;
+    tax += round2(lineNet * percent / 100);
+  }
+  const subtotal = round2(net);
+  const taxAmount = round2(tax);
+  const total = round2(subtotal + taxAmount);
+  let roundingDifference = 0;
+  if (options.expectedTotal !== void 0) {
+    if (!Number.isFinite(options.expectedTotal)) {
+      throw new Error("The expected total must be numeric.");
+    }
+    const tolerance = options.tolerance ?? 0.05;
+    roundingDifference = round2(options.expectedTotal - total);
+    if (Math.abs(roundingDifference) > tolerance) {
+      throw new Error(
+        `The expected total ${options.expectedTotal.toFixed(2)} differs from the invoice lines (${total.toFixed(2)}) by ${roundingDifference.toFixed(2)}, more than the rounding tolerance of ${tolerance.toFixed(2)}. Check quantities, prices and tax rates.`
+      );
+    }
+  }
+  return { subtotal, taxAmount, total, roundingDifference };
+}
+
+// src/support/complianceTax.ts
+var ComplianceTax = {
+  /**
+   * A taxed rate above 0 %, category S (Norway: 25 / 15 / 12 % are all S). Where a country files reduced rates
+   * under their own category (France: AA / AAA), pass it as `category`.
+   */
+  rate(percent, name = "VAT", category = ComplianceTaxCategory.STANDARD) {
+    if (!Number.isFinite(percent) || percent <= 0) {
+      throw new Error("rate() needs a percent above 0; for 0 % use zeroRated(), exempt() or reverseCharge().");
+    }
+    return { name, percent, category };
+  },
+  /** 0 % but taxable (category Z). */
+  zeroRated(name = "VAT") {
+    return { name, percent: 0, category: ComplianceTaxCategory.ZERO };
+  },
+  /** Exempt from VAT (category E); the VATEX exemption code is mandatory. */
+  exempt(exemptionCode, name = "VAT") {
+    if (exemptionCode.trim() === "") {
+      throw new Error("An exempt (category E) tax needs the exemption code (VATEX).");
+    }
+    return { name, percent: 0, category: ComplianceTaxCategory.EXEMPT, comment: exemptionCode };
+  },
+  /** Reverse charge (category AE); the mandatory legal text is added by Taxora. */
+  reverseCharge(name = "VAT") {
+    return { name, percent: 0, category: ComplianceTaxCategory.REVERSE_CHARGE };
+  }
+};
+
 // src/webhooks/WebhookSignature.ts
 var import_node_crypto = require("crypto");
 var WEBHOOK_SIGNATURE_HEADER = "Taxora-Signature";
@@ -5022,12 +5470,16 @@ function isTransactionBuyerRejected(object) {
   BillingEndpoint,
   CompanyAddress,
   CompanyEndpoint,
+  ComplianceDeliveryAction,
+  ComplianceDeliveryDecision,
   ComplianceDocumentType,
   ComplianceEnrollment,
   ComplianceEnrollmentPage,
   ComplianceEnrollmentStatus,
   ComplianceOfferings,
   ComplianceService,
+  ComplianceTax,
+  ComplianceTaxCategory,
   ComplianceTaxReport,
   ComplianceTaxReportPage,
   ComplianceTaxReportState,
@@ -5036,6 +5488,8 @@ function isTransactionBuyerRejected(object) {
   ComplianceTransactionState,
   ComplianceTransactionType,
   DEFAULT_WEBHOOK_TOLERANCE_SECONDS,
+  EInvoicingQuota,
+  EInvoicingQuotaPeriod,
   EReportingEndpoint,
   Environment,
   FetchHttpClient,
@@ -5083,6 +5537,7 @@ function isTransactionBuyerRejected(object) {
   WEBHOOK_ID_HEADER,
   WEBHOOK_SIGNATURE_HEADER,
   WebhookSignatureVerificationError,
+  calculateInvoiceTotals,
   computeWebhookSignature,
   constructWebhookEvent,
   describeApiError,
@@ -5101,6 +5556,7 @@ function isTransactionBuyerRejected(object) {
   getBaseUrl,
   getFailedVatStates,
   isTransactionBuyerRejected,
+  parseComplianceTaxCategory,
   parseLocalTaxNumbersCsv,
   parseWebhookSignatureHeader,
   toComplianceDocumentType,