@taxora/sdk 1.8.0 → 1.10.0

package/dist/index.js

@@ -440,6 +440,356 @@ var AuthEndpoint = class {
   }
 };
 
+// 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) => asRecord2(row) !== null) : [];
+}
+function asString2(value, fallback = "") {
+  return typeof value === "string" ? value : fallback;
+}
+function asNullableString2(value) {
+  return typeof value === "string" ? value : null;
+}
+function asNumber(value) {
+  return typeof value === "number" ? value : Number(value ?? 0) || 0;
+}
+function asNullableNumber(value) {
+  if (value === null || value === void 0 || value === "") return null;
+  const num = Number(value);
+  return Number.isFinite(num) ? num : null;
+}
+var UsageSummary = class _UsageSummary {
+  constructor(id, companyId, feature, country, regime, billingPeriod, eventCount, billableAmount, state, stateLabel, periodClosedAt, billingTriggeredAt, billedAt, stripeInvoiceId, stripeSubscriptionItemId, billingNotes, events, createdAt, updatedAt) {
+    this.id = id;
+    this.companyId = companyId;
+    this.feature = feature;
+    this.country = country;
+    this.regime = regime;
+    this.billingPeriod = billingPeriod;
+    this.eventCount = eventCount;
+    this.billableAmount = billableAmount;
+    this.state = state;
+    this.stateLabel = stateLabel;
+    this.periodClosedAt = periodClosedAt;
+    this.billingTriggeredAt = billingTriggeredAt;
+    this.billedAt = billedAt;
+    this.stripeInvoiceId = stripeInvoiceId;
+    this.stripeSubscriptionItemId = stripeSubscriptionItemId;
+    this.billingNotes = billingNotes;
+    this.events = events;
+    this.createdAt = createdAt;
+    this.updatedAt = updatedAt;
+  }
+  id;
+  companyId;
+  feature;
+  country;
+  regime;
+  billingPeriod;
+  eventCount;
+  billableAmount;
+  state;
+  stateLabel;
+  periodClosedAt;
+  billingTriggeredAt;
+  billedAt;
+  stripeInvoiceId;
+  stripeSubscriptionItemId;
+  billingNotes;
+  events;
+  createdAt;
+  updatedAt;
+  static fromArray(data) {
+    const amount = data["billable_amount"];
+    return new _UsageSummary(
+      asNumber(data["id"]),
+      asNumber(data["company_id"]),
+      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,
+      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: 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: asNullableString2(event["stripe_usage_record_id"]),
+        stripeReportedAt: asNullableString2(event["stripe_reported_at"]),
+        createdAt: asNullableString2(event["created_at"])
+      })),
+      asNullableString2(data["created_at"]),
+      asNullableString2(data["updated_at"])
+    );
+  }
+};
+var UsageSummaryPage = class _UsageSummaryPage {
+  constructor(rows, currentPage, perPage, total, lastPage) {
+    this.rows = rows;
+    this.currentPage = currentPage;
+    this.perPage = perPage;
+    this.total = total;
+    this.lastPage = lastPage;
+  }
+  rows;
+  currentPage;
+  perPage;
+  total;
+  lastPage;
+  static fromResponse(payload) {
+    const obj = asRecord2(payload) ?? {};
+    const rows = asRecordList(obj["data"]).map(UsageSummary.fromArray);
+    const meta = asRecord2(obj["meta"]) ?? {};
+    const num = (value, fallback) => typeof value === "number" ? value : fallback;
+    return new _UsageSummaryPage(
+      rows,
+      num(meta["current_page"], 1),
+      num(meta["per_page"], rows.length),
+      num(meta["total"], rows.length),
+      num(meta["last_page"], 1)
+    );
+  }
+  [Symbol.iterator]() {
+    return this.rows[Symbol.iterator]();
+  }
+  get length() {
+    return this.rows.length;
+  }
+};
+
+// src/endpoints/BillingEndpoint.ts
+var PERIOD_REGEX = /^\d{4}-(0[1-9]|1[0-2])$/;
+var BillingEndpoint = class {
+  constructor(baseUrl, apiKey, tokenStorage, httpClient, retryPolicy = new RetryPolicy()) {
+    this.baseUrl = baseUrl;
+    this.apiKey = apiKey;
+    this.tokenStorage = tokenStorage;
+    this.httpClient = httpClient;
+    this.retryPolicy = retryPolicy;
+  }
+  baseUrl;
+  apiKey;
+  tokenStorage;
+  httpClient;
+  retryPolicy;
+  /** Paginated usage summaries, newest billing period first. `perPage` is clamped to 1-100 server-side. */
+  async listUsageSummaries(page = 1, perPage = 25) {
+    const params = new URLSearchParams();
+    params.set("page", String(page));
+    params.set("per_page", String(perPage));
+    const data = await this.getJson(`${this.baseUrl}/billing/usage-summaries?${params.toString()}`);
+    return UsageSummaryPage.fromResponse(data);
+  }
+  /**
+   * The usage summaries of one billing period (YYYY-MM), one per feature,
+   * each with its usage events. A period without usage yields a 404 (HttpException).
+   */
+  async getUsageSummaries(period) {
+    if (!PERIOD_REGEX.test(period)) {
+      throw new TaxoraException(`Invalid billing period "${period}". Expected YYYY-MM, e.g. "2026-09".`);
+    }
+    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",
+      "x-api-key": this.apiKey
+    };
+    const token = this.tokenStorage.get();
+    if (token) {
+      headers["Authorization"] = `Bearer ${token.accessToken}`;
+    }
+    return headers;
+  }
+  /** GET + envelope unwrap (`{success, data}` → data, which may be an object or an array). */
+  async getJson(url) {
+    return withRetries(this.retryPolicy, "billing request", async () => {
+      const response = await this.httpClient.request("GET", url, { headers: this.buildHeaders() });
+      const responseText = await response.text();
+      if (!response.ok) {
+        throw new HttpException(
+          describeApiError(responseText, response.status),
+          response.status,
+          responseText,
+          {},
+          response.headers.get("retry-after")
+        );
+      }
+      let parsed;
+      try {
+        parsed = JSON.parse(responseText);
+      } catch {
+        throw new HttpException("Invalid JSON response", response.status, responseText);
+      }
+      if (typeof parsed !== "object" || parsed === null) {
+        throw new HttpException("Unexpected response format", response.status, responseText);
+      }
+      const obj = parsed;
+      return obj["data"] !== void 0 && obj["data"] !== null ? obj["data"] : obj;
+    });
+  }
+};
+
 // src/dto/CompanyResource.ts
 function normalizeCompanyResource(data) {
   const apiRateLimit = typeof data["api_rate_limit"] === "number" ? data["api_rate_limit"] : void 0;
@@ -505,6 +855,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",
@@ -516,17 +927,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.",
@@ -537,7 +948,7 @@ var DESCRIPTIONS = {
   [ComplianceEnrollmentStatus.UNKNOWN]: "Unknown status."
 };
 function describeComplianceEnrollmentStatus(status) {
-  return DESCRIPTIONS[status];
+  return DESCRIPTIONS2[status];
 }
 
 // src/enums/ComplianceService.ts
@@ -546,33 +957,33 @@ 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 asString(value, fallback = "") {
+function asString3(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString(value) {
+function asNullableString3(value) {
   return typeof value === "string" ? value : null;
 }
-function asNumber(value) {
+function asNumber2(value) {
   return typeof value === "number" ? value : Number(value ?? 0) || 0;
 }
 var ComplianceEnrollment = class _ComplianceEnrollment {
@@ -619,29 +1030,114 @@ var ComplianceEnrollment = class _ComplianceEnrollment {
   static fromArray(data) {
     const regimeConfig = typeof data["regime_config"] === "object" && data["regime_config"] !== null && !Array.isArray(data["regime_config"]) ? data["regime_config"] : null;
     return new _ComplianceEnrollment(
-      asNumber(data["id"]),
-      asNumber(data["company_id"]),
-      asString(data["country"]),
-      asString(data["regime"]),
-      asString(data["provider"]),
+      asNumber2(data["id"]),
+      asNumber2(data["company_id"]),
+      asString3(data["country"]),
+      asString3(data["regime"]),
+      asString3(data["provider"]),
       toComplianceEnrollmentStatus(data["status"]),
-      asString(data["status_label"]),
-      asNullableString(data["status_error"]),
-      asNullableString(data["provider_account_id"]),
-      asNullableString(data["tax_id"]),
-      asNullableString(data["company_register_id"]),
-      asNullableString(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,
-      asNullableString(data["reporting_start_date"]),
-      asNullableString(data["notification_email"]),
+      asNullableString3(data["reporting_start_date"]),
+      asNullableString3(data["notification_email"]),
       data["auto_send"] === true,
-      asNullableString(data["created_at"]),
-      asNullableString(data["updated_at"]),
+      asNullableString3(data["created_at"]),
+      asNullableString3(data["updated_at"]),
       toComplianceService(data["service"])
     );
   }
 };
 
+// src/dto/ComplianceOfferings.ts
+function asRecord3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+}
+function asRecordList2(value) {
+  return Array.isArray(value) ? value.filter((row) => asRecord3(row) !== null) : [];
+}
+function asString4(value, fallback = "") {
+  return typeof value === "string" ? value : fallback;
+}
+function asNullableString4(value) {
+  return typeof value === "string" ? value : null;
+}
+function asNullableNumber2(value) {
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  if (typeof value === "string" && value.trim() !== "" && Number.isFinite(Number(value))) return Number(value);
+  return null;
+}
+function asStringList(value) {
+  return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function toRequires(value) {
+  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) {
+    this.offerings = offerings;
+    this.coverage = coverage;
+    this.access = access;
+    this.accessByCountry = accessByCountry;
+  }
+  offerings;
+  coverage;
+  access;
+  accessByCountry;
+  static fromArray(data) {
+    const offerings = asRecordList2(data["data"]).map((row) => ({
+      country: asString4(row["country"]),
+      service: asString4(row["service"]),
+      currency: asString4(row["currency"], "EUR"),
+      active: row["active"] === true,
+      viaStripe: row["via_stripe"] === true,
+      plan: asNullableString4(row["plan"]),
+      status: asNullableString4(row["status"]),
+      enrolled: row["enrolled"] === true,
+      plans: asRecordList2(row["plans"]).map((plan) => ({
+        key: asString4(plan["key"]),
+        monthlyFee: asNullableNumber2(plan["monthly_fee"]),
+        setupFee: asNullableNumber2(plan["setup_fee"]),
+        usageTiers: Array.isArray(plan["usage_tiers"]) ? plan["usage_tiers"] : [],
+        volumeLimit: plan["volume_limit"] ?? null,
+        contactOnly: plan["contact_only"] === true,
+        checkoutAvailable: plan["checkout_available"] === true,
+        requires: toRequires(plan["requires"]),
+        eligible: plan["eligible"] === true
+      }))
+    }));
+    const coverage = asRecordList2(data["coverage"]).map((row) => ({
+      country: asString4(row["country"]),
+      availability: asString4(row["availability"]),
+      services: asStringList(row["services"]),
+      network: asNullableString4(row["network"]),
+      format: asNullableString4(row["format"]),
+      mandate: asNullableString4(row["mandate"]),
+      support: asString4(row["support"], "yes")
+    }));
+    const access = asRecord3(data["access"]) ?? {};
+    const accessByCountry = {};
+    for (const [country, services] of Object.entries(asRecord3(data["access_by_country"]) ?? {})) {
+      const flags = {};
+      for (const [service, value] of Object.entries(asRecord3(services) ?? {})) {
+        flags[service] = value === true;
+      }
+      accessByCountry[country] = flags;
+    }
+    return new _ComplianceOfferings(
+      offerings,
+      coverage,
+      { eReporting: access["e_reporting"] === true, eInvoicing: access["e_invoicing"] === true },
+      accessByCountry
+    );
+  }
+};
+
 // src/dto/ComplianceEnrollmentPage.ts
 var ComplianceEnrollmentPage = class _ComplianceEnrollmentPage {
   constructor(rows, currentPage, perPage, total, lastPage) {
@@ -687,17 +1183,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.",
@@ -707,20 +1203,20 @@ var DESCRIPTIONS3 = {
   [ComplianceTaxReportState.UNKNOWN]: "Unknown state."
 };
 function describeComplianceTaxReportState(state) {
-  return DESCRIPTIONS3[state];
+  return DESCRIPTIONS4[state];
 }
 
 // src/dto/ComplianceTaxReport.ts
-function asString2(value, fallback = "") {
+function asString5(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString2(value) {
+function asNullableString5(value) {
   return typeof value === "string" ? value : null;
 }
-function asNumber2(value) {
+function asNumber3(value) {
   return typeof value === "number" ? value : Number(value ?? 0) || 0;
 }
-function asNullableNumber(value) {
+function asNullableNumber3(value) {
   return typeof value === "number" ? value : null;
 }
 function asMoney(value) {
@@ -771,25 +1267,25 @@ var ComplianceTaxReport = class _ComplianceTaxReport {
   updatedAt;
   static fromArray(data) {
     return new _ComplianceTaxReport(
-      asNumber2(data["id"]),
-      asNumber2(data["company_id"]),
-      asNullableNumber(data["compliance_transaction_id"]),
-      asNullableNumber(data["ledger_id"]),
-      asString2(data["country"]),
-      asString2(data["regime"]),
+      asNumber3(data["id"]),
+      asNumber3(data["company_id"]),
+      asNullableNumber3(data["compliance_transaction_id"]),
+      asNullableNumber3(data["ledger_id"]),
+      asString5(data["country"]),
+      asString5(data["regime"]),
       toComplianceTaxReportState(data["state"]),
-      asString2(data["state_label"]),
+      asString5(data["state_label"]),
       data["is_terminal"] === true,
-      asNullableString2(data["provider_tax_report_id"]),
-      asNullableString2(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"]),
-      asNullableString2(data["refusal_reason"]),
-      asNullableString2(data["registered_at"]),
-      asNullableString2(data["refused_at"]),
-      asNullableString2(data["created_at"]),
-      asNullableString2(data["updated_at"])
+      asNullableString5(data["refusal_reason"]),
+      asNullableString5(data["registered_at"]),
+      asNullableString5(data["refused_at"]),
+      asNullableString5(data["created_at"]),
+      asNullableString5(data["updated_at"])
     );
   }
 };
@@ -835,23 +1331,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
@@ -860,27 +1356,30 @@ var ComplianceTransactionState = {
   SENDING: "sending",
   SUBMITTED: "submitted",
   ERROR: "error",
+  /** E-invoicing only: the buyer cannot receive e-invoices — nothing was sent or billed; send your regular invoice. */
+  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.",
   [ComplianceTransactionState.ERROR]: "Submission failed. See submissionError.",
+  [ComplianceTransactionState.NOT_REQUIRED]: "The buyer cannot receive e-invoices, so none was sent or billed. Send your regular invoice instead.",
   [ComplianceTransactionState.UNKNOWN]: "Unknown state."
 };
 function describeComplianceTransactionState(state) {
-  return DESCRIPTIONS5[state];
+  return DESCRIPTIONS6[state];
 }
 
 // src/enums/ComplianceTransactionType.ts
@@ -892,17 +1391,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).",
@@ -911,17 +1410,17 @@ var DESCRIPTIONS6 = {
   [ComplianceTransactionType.UNKNOWN]: "Unknown transaction type."
 };
 function describeComplianceTransactionType(type) {
-  return DESCRIPTIONS6[type];
+  return DESCRIPTIONS7[type];
 }
 
 // src/dto/ComplianceTransaction.ts
-function asString3(value, fallback = "") {
+function asString6(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString3(value) {
+function asNullableString6(value) {
   return typeof value === "string" ? value : null;
 }
-function asNumber3(value) {
+function asNumber4(value) {
   return typeof value === "number" ? value : Number(value ?? 0) || 0;
 }
 function asMoney2(value) {
@@ -929,34 +1428,55 @@ function asMoney2(value) {
   if (typeof value === "number" && Number.isFinite(value)) return String(value);
   return "0.00";
 }
-function asNullableNumber2(value) {
+function asNullableNumber4(value) {
   if (typeof value === "number" && Number.isFinite(value)) return value;
   if (typeof value === "string" && value.trim() !== "" && Number.isFinite(Number(value))) return Number(value);
   return null;
 }
-function asRecord(value) {
+function asRecord4(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) : [];
+function asRecordList3(value) {
+  return Array.isArray(value) ? value.filter((row) => asRecord4(row) !== null) : [];
+}
+function toInvoicePdf(value) {
+  const pdf = asRecord4(value);
+  if (pdf === null) return null;
+  return {
+    filename: asNullableString6(pdf["filename"]),
+    size: asNullableNumber4(pdf["size"]),
+    attached: pdf["attached"] === true
+  };
+}
+function toEurEquivalent(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: asString6(eur["rate"]),
+    rateDate: asNullableString6(eur["rate_date"]),
+    source: asString6(eur["source"], "ECB")
+  };
 }
 function toInvoiceLines(providerPayload) {
-  const invoice = asRecord(asRecord(providerPayload)?.["invoice"]);
-  return asRecordList(invoice?.["invoice_lines_attributes"]).map((line) => ({
-    description: asString3(line["description"]),
-    quantity: asNullableNumber2(line["quantity"]),
+  const invoice = asRecord4(asRecord4(providerPayload)?.["invoice"]);
+  return asRecordList3(invoice?.["invoice_lines_attributes"]).map((line) => ({
+    description: asString6(line["description"]),
+    quantity: asNullableNumber4(line["quantity"]),
     price: asMoney2(line["price"]),
-    unit: asNullableNumber2(line["unit"]),
-    taxes: asRecordList(line["taxes_attributes"]).map((tax) => ({
-      name: asString3(tax["name"]),
-      percent: asNullableNumber2(tax["percent"]),
-      category: asNullableString3(tax["category"]),
-      comment: asNullableString3(tax["comment"])
+    unit: asNullableNumber4(line["unit"]),
+    taxes: asRecordList3(line["taxes_attributes"]).map((tax) => ({
+      name: asString6(tax["name"]),
+      percent: asNullableNumber4(tax["percent"]),
+      category: asNullableString6(tax["category"]),
+      comment: asNullableString6(tax["comment"])
     }))
   }));
 }
 var ComplianceTransaction = class _ComplianceTransaction {
-  constructor(id, companyId, complianceEnrollmentId, country, regime, transactionType, transactionTypeLabel, state, stateLabel, invoiceNumber, invoiceDate, dueDate, currency, subtotal, taxAmount, total, counterpartyName, counterpartyCountry, counterpartyVatNumber, isPaid, paidAt, providerInvoiceId, submissionError, reportedAt, taxReport, createdAt, updatedAt, counterpartyRegisterId = null, counterpartyAddress = null, counterpartyCity = null, counterpartyPostalcode = null, counterpartyEmail = null, buyerReference = null, documentType = ComplianceDocumentType.INVOICE, amendedNumber = null, amendedDate = null, providerState = null, invoiceLines = []) {
+  constructor(id, companyId, complianceEnrollmentId, country, regime, transactionType, transactionTypeLabel, state, stateLabel, invoiceNumber, invoiceDate, dueDate, currency, subtotal, taxAmount, total, counterpartyName, counterpartyCountry, counterpartyVatNumber, isPaid, paidAt, providerInvoiceId, submissionError, reportedAt, taxReport, createdAt, updatedAt, counterpartyRegisterId = null, counterpartyAddress = null, counterpartyCity = null, counterpartyPostalcode = null, counterpartyEmail = null, buyerReference = null, documentType = ComplianceDocumentType.INVOICE, amendedNumber = null, amendedDate = null, providerState = null, invoiceLines = [], documentUrl = null, deliveryCheck = null, invoicePdf = null, internalReference = null, pdfUrl = null, buyerRejected = false, rejectionReason = null, eurEquivalent = null) {
     this.id = id;
     this.companyId = companyId;
     this.complianceEnrollmentId = complianceEnrollmentId;
@@ -995,6 +1515,14 @@ var ComplianceTransaction = class _ComplianceTransaction {
     this.amendedDate = amendedDate;
     this.providerState = providerState;
     this.invoiceLines = invoiceLines;
+    this.documentUrl = documentUrl;
+    this.deliveryCheck = deliveryCheck;
+    this.invoicePdf = invoicePdf;
+    this.internalReference = internalReference;
+    this.pdfUrl = pdfUrl;
+    this.buyerRejected = buyerRejected;
+    this.rejectionReason = rejectionReason;
+    this.eurEquivalent = eurEquivalent;
   }
   id;
   companyId;
@@ -1034,50 +1562,66 @@ var ComplianceTransaction = class _ComplianceTransaction {
   amendedDate;
   providerState;
   invoiceLines;
+  documentUrl;
+  deliveryCheck;
+  invoicePdf;
+  internalReference;
+  pdfUrl;
+  buyerRejected;
+  rejectionReason;
+  eurEquivalent;
   get isCreditNote() {
     return this.documentType === ComplianceDocumentType.CREDIT_NOTE;
   }
   static fromArray(data) {
     const taxReport = typeof data["tax_report"] === "object" && data["tax_report"] !== null && !Array.isArray(data["tax_report"]) ? ComplianceTaxReport.fromArray(data["tax_report"]) : void 0;
     return new _ComplianceTransaction(
-      asNumber3(data["id"]),
-      asNumber3(data["company_id"]),
-      asNumber3(data["compliance_enrollment_id"]),
-      asString3(data["country"]),
-      asString3(data["regime"]),
+      asNumber4(data["id"]),
+      asNumber4(data["company_id"]),
+      asNumber4(data["compliance_enrollment_id"]),
+      asString6(data["country"]),
+      asString6(data["regime"]),
       toComplianceTransactionType(data["transaction_type"]),
-      asString3(data["transaction_type_label"]),
+      asString6(data["transaction_type_label"]),
       toComplianceTransactionState(data["state"]),
-      asString3(data["state_label"]),
-      asString3(data["invoice_number"]),
-      asNullableString3(data["invoice_date"]),
-      asNullableString3(data["due_date"]),
-      asString3(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"]),
-      asNullableString3(data["counterparty_name"]),
-      asNullableString3(data["counterparty_country"]),
-      asNullableString3(data["counterparty_vat_number"]),
+      asNullableString6(data["counterparty_name"]),
+      asNullableString6(data["counterparty_country"]),
+      asNullableString6(data["counterparty_vat_number"]),
       data["is_paid"] === true,
-      asNullableString3(data["paid_at"]),
-      asNullableString3(data["provider_invoice_id"]),
-      asNullableString3(data["submission_error"]),
-      asNullableString3(data["reported_at"]),
+      asNullableString6(data["paid_at"]),
+      asNullableString6(data["provider_invoice_id"]),
+      asNullableString6(data["submission_error"]),
+      asNullableString6(data["reported_at"]),
       taxReport,
-      asNullableString3(data["created_at"]),
-      asNullableString3(data["updated_at"]),
-      asNullableString3(data["counterparty_register_id"]),
-      asNullableString3(data["counterparty_address"]),
-      asNullableString3(data["counterparty_city"]),
-      asNullableString3(data["counterparty_postalcode"]),
-      asNullableString3(data["counterparty_email"]),
-      asNullableString3(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"]),
-      asNullableString3(data["amended_number"]),
-      asNullableString3(data["amended_date"]),
-      asNullableString3(data["provider_state"]),
-      toInvoiceLines(data["provider_payload"])
+      asNullableString6(data["amended_number"]),
+      asNullableString6(data["amended_date"]),
+      asNullableString6(data["provider_state"]),
+      toInvoiceLines(data["provider_payload"]),
+      asNullableString6(data["document_url"]),
+      asRecord4(data["delivery_check"]),
+      toInvoicePdf(data["invoice_pdf"]),
+      asNullableString6(data["internal_reference"]),
+      asNullableString6(data["pdf_url"]),
+      data["buyer_rejected"] === true,
+      asNullableString6(data["rejection_reason"]),
+      toEurEquivalent(data["eur_equivalent"])
     );
   }
 };
@@ -1126,48 +1670,21 @@ var ImportResult = class _ImportResult {
   }
   created;
   skippedDuplicates;
-  errors;
-  static fromArray(data) {
-    const errors = (Array.isArray(data["errors"]) ? data["errors"] : []).filter(
-      (row) => typeof row === "string"
-    );
-    const num = (value) => typeof value === "number" ? value : 0;
-    return new _ImportResult(num(data["created"]), num(data["skipped_duplicates"]), errors);
-  }
-};
-
-// 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;
-    }
+  errors;
+  static fromArray(data) {
+    const errors = (Array.isArray(data["errors"]) ? data["errors"] : []).filter(
+      (row) => typeof row === "string"
+    );
+    const num = (value) => typeof value === "number" ? value : 0;
+    return new _ImportResult(num(data["created"]), num(data["skipped_duplicates"]), errors);
   }
-  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 asString4(value, fallback = "") {
+function asString7(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString4(value) {
+function asNullableString7(value) {
   return typeof value === "string" ? value : null;
 }
 var PeppolLookupResult = class _PeppolLookupResult {
@@ -1198,21 +1715,21 @@ var PeppolLookupResult = class _PeppolLookupResult {
     return new _PeppolLookupResult(
       toPeppolLookupStatus(data["status"]),
       typeof data["reachable"] === "boolean" ? data["reachable"] : null,
-      asString4(data["country"]),
-      asString4(data["scheme"]),
-      asString4(data["id"]),
+      asString7(data["country"]),
+      asString7(data["scheme"]),
+      asString7(data["id"]),
       documentTypes,
-      asNullableString4(data["transport_type_code"]),
-      asNullableString4(data["checked_at"])
+      asNullableString7(data["transport_type_code"]),
+      asNullableString7(data["checked_at"])
     );
   }
 };
 
 // src/dto/RegistryCompany.ts
-function asString5(value, fallback = "") {
+function asString8(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString5(value) {
+function asNullableString8(value) {
   return typeof value === "string" ? value : null;
 }
 var RegistryCompany = class _RegistryCompany {
@@ -1244,27 +1761,27 @@ var RegistryCompany = class _RegistryCompany {
   country;
   static fromArray(data) {
     return new _RegistryCompany(
-      asString5(data["org_number"]),
-      asString5(data["company_name"]),
-      asNullableString5(data["organisation_form"]),
+      asString8(data["org_number"]),
+      asString8(data["company_name"]),
+      asNullableString8(data["organisation_form"]),
       data["vat_registered"] === true,
-      asNullableString5(data["vat_number"]),
+      asNullableString8(data["vat_number"]),
       data["enterprise_register"] === true,
       data["bankrupt"] === true,
       data["under_liquidation"] === true,
-      asNullableString5(data["address"]),
-      asNullableString5(data["postalcode"]),
-      asNullableString5(data["city"]),
-      asString5(data["country"])
+      asNullableString8(data["address"]),
+      asNullableString8(data["postalcode"]),
+      asNullableString8(data["city"]),
+      asString8(data["country"])
     );
   }
 };
 
 // src/dto/RevenueStatistics.ts
-function asString6(value, fallback = "") {
+function asString9(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNumber4(value) {
+function asNumber5(value) {
   return typeof value === "number" ? value : Number(value ?? 0) || 0;
 }
 function asMoney3(value) {
@@ -1276,7 +1793,7 @@ function asRecords(value) {
 }
 function toTotals(data) {
   return {
-    count: asNumber4(data["count"]),
+    count: asNumber5(data["count"]),
     subtotal: asMoney3(data["subtotal"]),
     taxAmount: asMoney3(data["tax_amount"]),
     total: asMoney3(data["total"])
@@ -1313,35 +1830,35 @@ var RevenueStatistics = class _RevenueStatistics {
       typeof data["totals"] === "object" && data["totals"] !== null ? data["totals"] : {}
     );
     const timeSeries = asRecords(data["time_series"]).map((row) => ({
-      bucket: asString6(row["bucket"]),
+      bucket: asString9(row["bucket"]),
       ...toTotals(row)
     }));
     const byType = asRecords(data["by_type"]).map((row) => ({
-      type: asString6(row["type"]),
-      typeLabel: asString6(row["type_label"]),
-      count: asNumber4(row["count"]),
+      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: asString6(row["country"], "unknown"),
-      count: asNumber4(row["count"]),
+      country: asString9(row["country"], "unknown"),
+      count: asNumber5(row["count"]),
       total: asMoney3(row["total"])
     }));
     const byState = asRecords(data["by_state"]).map((row) => ({
-      state: asString6(row["state"]),
-      stateLabel: asString6(row["state_label"]),
-      count: asNumber4(row["count"]),
+      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: asString6(row["currency"]),
+      currency: asString9(row["currency"]),
       ...toTotals(row)
     }));
     return new _RevenueStatistics(
-      asString6(range["date_from"]) || void 0,
-      asString6(range["date_to"]) || void 0,
-      asString6(range["interval"]) || void 0,
-      asString6(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,
@@ -1354,10 +1871,10 @@ var RevenueStatistics = class _RevenueStatistics {
 };
 
 // src/dto/SireneLookupResult.ts
-function asString7(value, fallback = "") {
+function asString10(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString6(value) {
+function asNullableString9(value) {
   return typeof value === "string" ? value : null;
 }
 var SireneLookupResult = class _SireneLookupResult {
@@ -1383,24 +1900,24 @@ var SireneLookupResult = class _SireneLookupResult {
   postalcode;
   static fromArray(data) {
     return new _SireneLookupResult(
-      asString7(data["company_name"]),
-      asString7(data["siren"]),
-      asNullableString6(data["siret"]),
-      asNullableString6(data["naf_code"]),
-      asNullableString6(data["naf_full"]),
-      asNullableString6(data["enterprise_size"]),
-      asNullableString6(data["address"]),
-      asNullableString6(data["city"]),
-      asNullableString6(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 asString8(value, fallback = "") {
+function asString11(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNumber5(value) {
+function asNumber6(value) {
   return typeof value === "number" ? value : Number(value ?? 0) || 0;
 }
 var VatRates = class _VatRates {
@@ -1414,13 +1931,13 @@ var VatRates = class _VatRates {
   rates;
   static fromArray(data) {
     const rates = (Array.isArray(data["rates"]) ? data["rates"] : []).filter((row) => typeof row === "object" && row !== null).map((row) => ({
-      percent: asNumber5(row["percent"]),
-      category: asString8(row["category"]),
-      labelKey: asString8(row["label_key"]),
-      taxName: asString8(row["tax_name"]),
+      percent: asNumber6(row["percent"]),
+      category: asString11(row["category"]),
+      labelKey: asString11(row["label_key"]),
+      taxName: asString11(row["tax_name"]),
       requiresVatex: row["requires_vatex"] === true
     }));
-    return new _VatRates(asString8(data["country"]), asString8(data["currency"], "EUR"), rates);
+    return new _VatRates(asString11(data["country"]), asString11(data["currency"], "EUR"), rates);
   }
 };
 
@@ -1474,15 +1991,39 @@ 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}$/;
 var COUNTRY_REGEX = /^[A-Za-z]{2}$/;
 var PEPPOL_SCHEME_REGEX = /^\d{4}$/;
+var INVOICE_PDF_MAX_BYTES = 10 * 1024 * 1024;
+var INVOICE_PDF_MAGIC = [37, 80, 68, 70, 45];
 var INTERVALS = ["day", "week", "month"];
 var SERVICES = ["e_reporting", "e_invoicing"];
 var ENTERPRISE_SIZES = ["micro", "pme", "eti", "ge"];
 var TYPE_OPERATIONS = ["services", "goods", "mixed"];
+var NOTIFICATION_LANGUAGES = ["de", "en"];
+var NOTIFICATION_DIGESTS = ["off", "daily", "weekly"];
+var NOTIFICATION_MAX_RECIPIENTS = 5;
 var TRANSACTION_TYPES = [
   "b2c_outbound",
   "b2b_domestic_outbound",
@@ -1653,6 +2194,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
   // ---------------------------------------------------------------------
@@ -1677,6 +2231,9 @@ var EReportingEndpoint = class {
     this.validateInvoiceLines(input.invoiceLines);
     this.validateOptionalCodes(input);
     this.validateBuyerFields(input);
+    this.validateInternalReference(input.internalReference);
+    this.validateInvoicePdfFilename(input);
+    this.validateDocument(input);
     const body = {
       compliance_enrollment_id: input.complianceEnrollmentId,
       transaction_type: input.transactionType,
@@ -1692,23 +2249,104 @@ var EReportingEndpoint = class {
     const data = await this.parseJsonResponse(response);
     return ComplianceTransaction.fromArray(data);
   }
-  /** Paginated list of the company's transactions (newest invoice date first), filterable by date / state / type / enrollment / country. */
-  async listTransactions(filters = {}) {
-    if (filters.complianceEnrollmentId !== void 0) {
-      this.validateId(filters.complianceEnrollmentId, "complianceEnrollmentId");
+  /**
+   * 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 (filters.country !== void 0 && !COUNTRY_REGEX.test(filters.country)) {
-      throw new TaxoraException("country must be a 2-character ISO 3166-1 alpha-2 code.");
+    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."
+      );
     }
-    const params = new URLSearchParams();
-    if (filters.dateFrom !== void 0) params.set("date_from", this.formatDate(filters.dateFrom));
-    if (filters.dateTo !== void 0) params.set("date_to", this.formatDate(filters.dateTo));
-    if (filters.state !== void 0) params.set("state", filters.state);
-    if (filters.transactionType !== void 0) params.set("transaction_type", filters.transactionType);
-    if (filters.complianceEnrollmentId !== void 0) {
-      params.set("compliance_enrollment_id", String(filters.complianceEnrollmentId));
+    if (original.invoiceNumber === "") {
+      throw new TaxoraException("The original transaction has no invoice number.");
     }
-    if (filters.country !== void 0) params.set("country", filters.country.toUpperCase());
+    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);
     if (filters.page !== void 0) params.set("page", String(filters.page));
     if (filters.perPage !== void 0) params.set("per_page", String(filters.perPage));
     const queryString = params.toString();
@@ -1716,6 +2354,27 @@ var EReportingEndpoint = class {
     const response = await this.sendRequest("GET", url);
     return ComplianceTransactionPage.fromResponse(await this.parseJsonResponse(response));
   }
+  /**
+   * All transactions matching the filters as raw CSV for bookkeeping
+   * (semicolon-separated) — the same filters as listTransactions() without
+   * pagination. Columns: invoice_number, internal_reference, invoice_date,
+   * due_date, country, transaction_type, document_type, state, delivery_state,
+   * buyer_rejected, rejection_reason, counterparty_name, counterparty_country,
+   * counterparty_vat_number, currency, subtotal, tax_amount, total, eur_rate,
+   * eur_rate_date, eur_subtotal, eur_tax_amount, eur_total, provider_invoice_id,
+   * created_at. The eur_* columns hold the ECB reference conversion for non-EUR
+   * invoices (empty for EUR). Max 50,000 rows server-side. The body is returned
+   * verbatim, a UTF-8 BOM included when the API sends one.
+   */
+  async exportTransactionsCsv(filters = {}) {
+    const queryString = this.buildTransactionFilterParams(filters).toString();
+    const url = `${this.baseUrl}/compliance/transactions/export.csv${queryString ? `?${queryString}` : ""}`;
+    const response = await this.sendDownloadRequest(url, "text/csv, application/json");
+    if (!response.ok) {
+      await this.parseJsonResponse(response);
+    }
+    return new TextDecoder("utf-8", { ignoreBOM: true }).decode(await response.arrayBuffer());
+  }
   /** Get a single transaction by id (includes its tax report when one exists). */
   async getTransaction(id) {
     this.validateId(id, "id");
@@ -1731,6 +2390,8 @@ var EReportingEndpoint = class {
     if (input.invoiceLines !== void 0) this.validateInvoiceLines(input.invoiceLines);
     this.validateOptionalCodes(input);
     this.validateBuyerFields(input);
+    this.validateInternalReference(input.internalReference);
+    this.validateInvoicePdfFilename(input);
     const body = {};
     if (input.transactionType !== void 0) body["transaction_type"] = input.transactionType;
     if (input.invoiceNumber !== void 0) body["invoice_number"] = input.invoiceNumber;
@@ -1765,6 +2426,47 @@ var EReportingEndpoint = class {
     const data = await this.parseJsonResponse(response);
     return ComplianceTransaction.fromArray(data);
   }
+  /**
+   * Download the legal e-invoice document of a sent transaction (e-invoicing,
+   * e.g. the EHF/UBL XML for Norway). Available once `documentUrl` on the
+   * transaction is set.
+   *
+   * Errors: 404 (HttpException) for an unknown transaction; 409 (HttpException)
+   * when no document exists (yet) — e.g. e-reporting, not sent, or the network
+   * has not produced it yet (try again in a few minutes); 502 on provider failure.
+   */
+  async getTransactionDocument(id) {
+    this.validateId(id, "id");
+    const response = await this.sendDownloadRequest(`${this.baseUrl}/compliance/transactions/${id}/document`, "*/*");
+    if (!response.ok) {
+      await this.parseJsonResponse(response);
+    }
+    return {
+      content: new Uint8Array(await response.arrayBuffer()),
+      contentType: response.headers.get("content-type") ?? "application/octet-stream",
+      filename: this.filenameFromDisposition(response.headers.get("content-disposition"))
+    };
+  }
+  /**
+   * Download the invoice as a readable PDF — the seller's attached PDF, or the
+   * provider's rendering of the e-invoice. Available once `pdfUrl` on the
+   * transaction is set.
+   *
+   * Errors: 404 (HttpException) for an unknown transaction; 409 (HttpException)
+   * when no PDF exists (yet); 502 on provider failure.
+   */
+  async getTransactionPdf(id) {
+    this.validateId(id, "id");
+    const response = await this.sendDownloadRequest(`${this.baseUrl}/compliance/transactions/${id}/pdf`, "*/*");
+    if (!response.ok) {
+      await this.parseJsonResponse(response);
+    }
+    return {
+      content: new Uint8Array(await response.arrayBuffer()),
+      contentType: response.headers.get("content-type") ?? "application/octet-stream",
+      filename: this.filenameFromDisposition(response.headers.get("content-disposition"))
+    };
+  }
   /**
    * Bulk-import transactions from a semicolon-separated CSV (one row per invoice
    * line; rows sharing an invoice_number are grouped into one transaction).
@@ -1796,6 +2498,9 @@ var EReportingEndpoint = class {
    * months and a monthly interval.
    */
   async getRevenueStatistics(filters = {}) {
+    if (filters.complianceEnrollmentId !== void 0) {
+      this.validateId(filters.complianceEnrollmentId, "complianceEnrollmentId");
+    }
     if (filters.interval !== void 0 && !INTERVALS.includes(filters.interval)) {
       throw new TaxoraException(
         `Invalid statistics interval "${String(filters.interval)}". Expected one of: ${INTERVALS.join(", ")}.`
@@ -1807,12 +2512,42 @@ var EReportingEndpoint = class {
     if (filters.interval !== void 0) params.set("interval", filters.interval);
     if (filters.transactionType !== void 0) params.set("transaction_type", filters.transactionType);
     if (filters.state !== void 0) params.set("state", filters.state);
+    if (filters.complianceEnrollmentId !== void 0) {
+      params.set("compliance_enrollment_id", String(filters.complianceEnrollmentId));
+    }
     const queryString = params.toString();
     const url = `${this.baseUrl}/compliance/revenue-statistics${queryString ? `?${queryString}` : ""}`;
     const response = await this.sendRequest("GET", url);
     const data = await this.parseJsonResponse(response);
     return RevenueStatistics.fromArray(data);
   }
+  /**
+   * Net and VAT per month, currency and tax rate as raw CSV (semicolon-separated,
+   * computed from the invoice lines) — for reconciling the reported figures with
+   * your VAT return. Same filters as getRevenueStatistics() (without
+   * `interval`); defaults to the last 12 months. The body is returned verbatim,
+   * a UTF-8 BOM included when the API sends one.
+   */
+  async exportRevenueTaxRatesCsv(filters = {}) {
+    if (filters.complianceEnrollmentId !== void 0) {
+      this.validateId(filters.complianceEnrollmentId, "complianceEnrollmentId");
+    }
+    const params = new URLSearchParams();
+    if (filters.dateFrom !== void 0) params.set("date_from", this.formatDate(filters.dateFrom));
+    if (filters.dateTo !== void 0) params.set("date_to", this.formatDate(filters.dateTo));
+    if (filters.transactionType !== void 0) params.set("transaction_type", filters.transactionType);
+    if (filters.state !== void 0) params.set("state", filters.state);
+    if (filters.complianceEnrollmentId !== void 0) {
+      params.set("compliance_enrollment_id", String(filters.complianceEnrollmentId));
+    }
+    const queryString = params.toString();
+    const url = `${this.baseUrl}/compliance/revenue-statistics/tax-rates.csv${queryString ? `?${queryString}` : ""}`;
+    const response = await this.sendDownloadRequest(url, "text/csv, application/json");
+    if (!response.ok) {
+      await this.parseJsonResponse(response);
+    }
+    return new TextDecoder("utf-8", { ignoreBOM: true }).decode(await response.arrayBuffer());
+  }
   /**
    * The canonical VAT rates & DGFiP tax categories for a reporting country
    * (the seller's reporting-country rates, not the counterparty's). Falls back
@@ -1827,12 +2562,19 @@ var EReportingEndpoint = class {
     const data = await this.parseJsonResponse(response);
     return VatRates.fromArray(data);
   }
-  /** Paginated list of the company's tax reports (newest first), optionally filtered by state. */
-  async listTaxReports(page = 1, perPage = 25, state) {
+  /**
+   * Paginated list of the company's tax reports (newest first), optionally
+   * filtered by state and by country (2-letter ISO code, case-insensitive).
+   */
+  async listTaxReports(page = 1, perPage = 25, state, country) {
+    if (country !== void 0 && !COUNTRY_REGEX.test(country)) {
+      throw new TaxoraException("country must be a 2-character ISO 3166-1 alpha-2 code.");
+    }
     const params = new URLSearchParams();
     params.set("page", String(page));
     params.set("per_page", String(perPage));
     if (state !== void 0) params.set("state", state);
+    if (country !== void 0) params.set("country", country.toUpperCase());
     const response = await this.sendRequest("GET", `${this.baseUrl}/compliance/tax-reports?${params.toString()}`);
     return ComplianceTaxReportPage.fromResponse(await this.parseJsonResponse(response));
   }
@@ -1874,8 +2616,177 @@ var EReportingEndpoint = class {
     await this.parseJsonResponse(response);
   }
   // ---------------------------------------------------------------------
+  // Self-service plans (Stripe) — not gated by compliance access
+  // ---------------------------------------------------------------------
+  /**
+   * Bookable compliance plans per country (net EUR prices), every country
+   * Taxora reaches, and which services the company has unlocked. Works for
+   * companies without compliance access.
+   */
+  async getOfferings() {
+    const response = await this.sendRequest("GET", `${this.baseUrl}/compliance/offerings`);
+    return ComplianceOfferings.fromArray(await this.parseJsonResponse(response));
+  }
+  /**
+   * Start a Stripe Checkout for a plan (see getOfferings() — `checkoutAvailable`).
+   * Open the returned `url` in the browser. After payment Stripe redirects to
+   * the Taxora portal, which activates the plan; call confirmCheckout() with the
+   * session id to activate it from your side (idempotent).
+   *
+   * Errors: 422 (ValidationException) for an unknown or contact-only plan or a
+   * plan that is already active; 502 (HttpException) on a Stripe error.
+   */
+  async createCheckout(country, plan) {
+    if (!COUNTRY_REGEX.test(country)) {
+      throw new TaxoraException("country must be a 2-character ISO 3166-1 alpha-2 code.");
+    }
+    if (plan.trim() === "" || plan.length > 30) {
+      throw new TaxoraException("plan must be a non-empty plan key of at most 30 characters.");
+    }
+    const response = await this.sendRequest("POST", `${this.baseUrl}/compliance/checkout`, {
+      country: country.toUpperCase(),
+      plan
+    });
+    const data = await this.parseJsonResponse(response);
+    return { id: String(data["id"] ?? ""), url: String(data["url"] ?? "") };
+  }
+  /** Confirm a finished Stripe Checkout and activate its plan. Idempotent. */
+  async confirmCheckout(sessionId) {
+    if (sessionId.trim() === "" || sessionId.length > 255) {
+      throw new TaxoraException("sessionId must be a non-empty string of at most 255 characters.");
+    }
+    const response = await this.sendRequest("POST", `${this.baseUrl}/compliance/checkout/confirm`, {
+      session_id: sessionId
+    });
+    const data = await this.parseJsonResponse(response);
+    const str = (value) => typeof value === "string" ? value : null;
+    return {
+      active: data["active"] === true,
+      country: str(data["country"]),
+      service: str(data["service"]),
+      plan: str(data["plan"]),
+      status: str(data["status"])
+    };
+  }
+  /**
+   * URL of the Stripe billing portal for the company's compliance plans
+   * (invoices, payment method, cancellation). The portal returns to the Taxora
+   * portal. 404 (HttpException) when no plan was bought via Stripe.
+   */
+  async createBillingPortalSession() {
+    const response = await this.sendRequest("POST", `${this.baseUrl}/compliance/billing-portal`);
+    const data = await this.parseJsonResponse(response);
+    return String(data["url"] ?? "");
+  }
+  // ---------------------------------------------------------------------
+  // Notification emails
+  // ---------------------------------------------------------------------
+  /**
+   * The company's opt-in e-reporting / e-invoicing emails: recipients, language,
+   * the "buyer not on Peppol" email and the digest. Readable by every member.
+   */
+  async getNotificationSettings() {
+    const response = await this.sendRequest("GET", `${this.baseUrl}/compliance/notification-settings`);
+    return this.toNotificationSettings(await this.parseJsonResponse(response));
+  }
+  /**
+   * Change the company's e-reporting / e-invoicing emails; only the provided
+   * fields change. `notOnPeppol` only reports invoices held back after it was
+   * switched on.
+   *
+   * Errors: 422 (ValidationException) when an email is switched on without any
+   * recipient; 403 (HttpException, body code `admin_only` or `read_only_role`)
+   * for users who are not company admins.
+   */
+  async updateNotificationSettings(input) {
+    const body = {};
+    if (input.recipients !== void 0) {
+      if (!Array.isArray(input.recipients)) {
+        throw new TaxoraException("recipients must be an array of email addresses.");
+      }
+      if (input.recipients.length > NOTIFICATION_MAX_RECIPIENTS) {
+        throw new TaxoraException(`recipients must not contain more than ${NOTIFICATION_MAX_RECIPIENTS} entries.`);
+      }
+      body["recipients"] = input.recipients.map((recipient, index) => {
+        const email = typeof recipient === "string" ? recipient.trim() : recipient;
+        this.validateEmail(email, `recipients[${index}]`);
+        if (email.length > 191) {
+          throw new TaxoraException(`recipients[${index}] must not exceed 191 characters.`);
+        }
+        return email;
+      });
+    }
+    if (input.language !== void 0) {
+      if (!NOTIFICATION_LANGUAGES.includes(input.language)) {
+        throw new TaxoraException(
+          `Invalid language "${String(input.language)}". Expected one of: ${NOTIFICATION_LANGUAGES.join(", ")}.`
+        );
+      }
+      body["language"] = input.language;
+    }
+    if (input.notOnPeppol !== void 0) {
+      if (typeof input.notOnPeppol !== "boolean") {
+        throw new TaxoraException("notOnPeppol must be a boolean.");
+      }
+      body["not_on_peppol"] = input.notOnPeppol;
+    }
+    if (input.digest !== void 0) {
+      if (!NOTIFICATION_DIGESTS.includes(input.digest)) {
+        throw new TaxoraException(
+          `Invalid digest "${String(input.digest)}". Expected one of: ${NOTIFICATION_DIGESTS.join(", ")}.`
+        );
+      }
+      body["digest"] = input.digest;
+    }
+    if (Object.keys(body).length === 0) {
+      throw new TaxoraException("updateNotificationSettings requires at least one field to update.");
+    }
+    const response = await this.sendRequest("PUT", `${this.baseUrl}/compliance/notification-settings`, body);
+    return this.toNotificationSettings(await this.parseJsonResponse(response));
+  }
+  toNotificationSettings(data) {
+    const recipients = Array.isArray(data["recipients"]) ? data["recipients"].filter((r) => typeof r === "string" && r !== "") : [];
+    const digest = data["digest"];
+    return {
+      recipients,
+      language: data["language"] === "en" ? "en" : "de",
+      notOnPeppol: data["not_on_peppol"] === true,
+      digest: digest === "daily" || digest === "weekly" ? digest : "off",
+      digestSentAt: typeof data["digest_sent_at"] === "string" ? data["digest_sent_at"] : null
+    };
+  }
+  // ---------------------------------------------------------------------
   // Input validation (fail fast, before any request is sent)
   // ---------------------------------------------------------------------
+  /** Validated transaction-list filters as query params (shared by listTransactions and exportTransactionsCsv). */
+  buildTransactionFilterParams(filters) {
+    if (filters.complianceEnrollmentId !== void 0) {
+      this.validateId(filters.complianceEnrollmentId, "complianceEnrollmentId");
+    }
+    if (filters.country !== void 0 && !COUNTRY_REGEX.test(filters.country)) {
+      throw new TaxoraException("country must be a 2-character ISO 3166-1 alpha-2 code.");
+    }
+    if (filters.search !== void 0 && filters.search.length > 100) {
+      throw new TaxoraException("search must not exceed 100 characters.");
+    }
+    this.validateInternalReference(filters.internalReference);
+    if (filters.providerState !== void 0 && !/^[a-z_]{1,30}$/.test(filters.providerState)) {
+      throw new TaxoraException('providerState must be 1-30 lowercase letters or underscores (e.g. "refused").');
+    }
+    const params = new URLSearchParams();
+    if (filters.dateFrom !== void 0) params.set("date_from", this.formatDate(filters.dateFrom));
+    if (filters.dateTo !== void 0) params.set("date_to", this.formatDate(filters.dateTo));
+    if (filters.state !== void 0) params.set("state", filters.state);
+    if (filters.transactionType !== void 0) params.set("transaction_type", filters.transactionType);
+    if (filters.complianceEnrollmentId !== void 0) {
+      params.set("compliance_enrollment_id", String(filters.complianceEnrollmentId));
+    }
+    if (filters.country !== void 0) params.set("country", filters.country.toUpperCase());
+    if (filters.search !== void 0) params.set("search", filters.search);
+    if (filters.internalReference !== void 0) params.set("internal_reference", filters.internalReference);
+    if (filters.providerState !== void 0) params.set("provider_state", filters.providerState);
+    return params;
+  }
   validateEnrollmentInput(input) {
     if (input.siret === void 0 && input.siren === void 0) {
       throw new TaxoraException("Either siret or siren is required.");
@@ -2001,14 +2912,101 @@ 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) {
+    if (input.invoicePdfFilename === void 0) return;
+    if (input.invoicePdfFilename.length > 120) {
+      throw new TaxoraException("invoicePdfFilename must not exceed 120 characters.");
+    }
+    if (input.invoicePdf === void 0) {
+      throw new TaxoraException("invoicePdfFilename requires invoicePdf.");
+    }
+  }
+  validateInternalReference(internalReference) {
+    if (internalReference !== void 0 && internalReference.length > 100) {
+      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).");
     }
   }
   /**
@@ -2051,7 +3049,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;
@@ -2064,10 +3062,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;
@@ -2084,6 +3082,29 @@ var EReportingEndpoint = class {
     if (input.amendedNumber !== void 0) body["amended_number"] = input.amendedNumber;
     if (input.amendedDate !== void 0) body["amended_date"] = this.formatDate(input.amendedDate);
     if (input.extraInfo !== void 0) body["extra_info"] = input.extraInfo;
+    if (input.internalReference !== void 0) body["internal_reference"] = input.internalReference;
+    if (input.invoicePdf !== void 0) body["invoice_pdf"] = this.encodeInvoicePdf(input.invoicePdf);
+    if (input.invoicePdfFilename !== void 0) body["invoice_pdf_filename"] = input.invoicePdfFilename;
+  }
+  /** Bytes → base64 (validated as a PDF of at most 10 MB); strings are taken as already base64. */
+  encodeInvoicePdf(pdf) {
+    if (typeof pdf === "string") {
+      if (pdf.trim() === "") {
+        throw new TaxoraException("invoicePdf must not be empty.");
+      }
+      return pdf;
+    }
+    const bytes = pdf instanceof Uint8Array ? pdf : new Uint8Array(pdf);
+    if (bytes.byteLength === 0) {
+      throw new TaxoraException("invoicePdf must not be empty.");
+    }
+    if (bytes.byteLength > INVOICE_PDF_MAX_BYTES) {
+      throw new TaxoraException("invoicePdf must not exceed 10 MB.");
+    }
+    if (!INVOICE_PDF_MAGIC.every((byte, index) => bytes[index] === byte)) {
+      throw new TaxoraException('invoicePdf must be a PDF file (content must start with "%PDF-").');
+    }
+    return Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength).toString("base64");
   }
   // ---------------------------------------------------------------------
   // HTTP plumbing (kept in sync with SmartEnrichmentEndpoint)
@@ -2107,6 +3128,30 @@ var EReportingEndpoint = class {
     const send = () => this.httpClient.request(method, url, options);
     return method === "GET" ? withResponseRetries(this.retryPolicy, "e-reporting request", send) : send();
   }
+  /** GET for a non-JSON download (CSV / document): no JSON Content-Type, retried like other GETs. */
+  async sendDownloadRequest(url, accept) {
+    const headers = this.buildHeaders(false);
+    headers["Accept"] = accept;
+    return withResponseRetries(
+      this.retryPolicy,
+      "e-reporting download",
+      () => this.httpClient.request("GET", url, { headers })
+    );
+  }
+  /** `attachment; filename="x.xml"` (or RFC 5987 `filename*=UTF-8''x.xml`) → "x.xml". */
+  filenameFromDisposition(header) {
+    if (header === null) return null;
+    const extended = /filename\*\s*=\s*(?:UTF-8|utf-8)''([^;]+)/.exec(header);
+    if (extended?.[1] !== void 0) {
+      try {
+        return decodeURIComponent(extended[1].trim());
+      } catch {
+      }
+    }
+    const plain = /filename\s*=\s*"([^"]*)"|filename\s*=\s*([^;]+)/.exec(header);
+    const name = (plain?.[1] ?? plain?.[2])?.trim();
+    return name !== void 0 && name !== "" ? name : null;
+  }
   /** Multipart upload: Content-Type is left to fetch so the boundary is set correctly. */
   async sendMultipartRequest(method, url, form) {
     return this.httpClient.request(method, url, { headers: this.buildHeaders(false), body: form });
@@ -2688,13 +3733,13 @@ var SmartEnrichmentHistoryPage = class _SmartEnrichmentHistoryPage {
 };
 
 // src/dto/SmartEnrichmentStatistics.ts
-function asString9(value, fallback = "") {
+function asString12(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNumber6(value) {
+function asNumber7(value) {
   return typeof value === "number" ? value : Number(value ?? 0) || 0;
 }
-function asRecord2(value) {
+function asRecord5(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
 function asRecords2(value) {
@@ -2717,39 +3762,39 @@ var SmartEnrichmentStatistics = class _SmartEnrichmentStatistics {
   byOutcome;
   confidenceBuckets;
   static fromArray(data) {
-    const range = asRecord2(data["range"]);
-    const totals = asRecord2(data["totals"]);
+    const range = asRecord5(data["range"]);
+    const totals = asRecord5(data["totals"]);
     const timeSeries = asRecords2(data["time_series"]).map((row) => ({
-      bucket: asString9(row["bucket"]),
-      jobs: asNumber6(row["jobs"]),
-      items: asNumber6(row["items"]),
-      found: asNumber6(row["found"])
+      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: asString9(row["source"]),
-      jobs: asNumber6(row["jobs"]),
-      found: asNumber6(row["found"])
+      source: asString12(row["source"]),
+      jobs: asNumber7(row["jobs"]),
+      found: asNumber7(row["found"])
     }));
     const byOutcome = asRecords2(data["by_outcome"]).map((row) => ({
-      outcome: asString9(row["outcome"]),
-      count: asNumber6(row["count"])
+      outcome: asString12(row["outcome"]),
+      count: asNumber7(row["count"])
     }));
     const confidenceBuckets = asRecords2(data["confidence_buckets"]).map((row) => ({
-      bucket: asString9(row["bucket"]),
-      count: asNumber6(row["count"])
+      bucket: asString12(row["bucket"]),
+      count: asNumber7(row["count"])
     }));
     return new _SmartEnrichmentStatistics(
       {
-        dateFrom: asString9(range["date_from"]),
-        dateTo: asString9(range["date_to"]),
-        interval: asString9(range["interval"])
+        dateFrom: asString12(range["date_from"]),
+        dateTo: asString12(range["date_to"]),
+        interval: asString12(range["interval"])
       },
       {
-        jobs: asNumber6(totals["jobs"]),
-        items: asNumber6(totals["items"]),
-        found: asNumber6(totals["found"]),
-        foundRate: asNumber6(totals["found_rate"]),
-        avgConfidence: asNumber6(totals["avg_confidence"])
+        jobs: asNumber7(totals["jobs"]),
+        items: asNumber7(totals["items"]),
+        found: asNumber7(totals["found"]),
+        foundRate: asNumber7(totals["found_rate"]),
+        avgConfidence: asNumber7(totals["avg_confidence"])
       },
       timeSeries,
       bySource,
@@ -4029,7 +5074,7 @@ var AuthRetryHttpClient = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "1.8.0";
+var SDK_VERSION = "1.9.0";
 
 // src/http/SdkVersionHttpClient.ts
 var SDK_VERSION_HEADER = "X-Taxora-SDK-Version";
@@ -4056,6 +5101,7 @@ var TaxoraClient = class {
   company;
   smartEnrichment;
   eReporting;
+  billing;
   baseUrl;
   constructor(options) {
     const environment = options.environment ?? Environment.SANDBOX;
@@ -4076,6 +5122,7 @@ var TaxoraClient = class {
       retryPolicy
     );
     this.eReporting = new EReportingEndpoint(this.baseUrl, options.apiKey, tokenStorage, retryClient, retryPolicy);
+    this.billing = new BillingEndpoint(this.baseUrl, options.apiKey, tokenStorage, retryClient, retryPolicy);
   }
 };
 
@@ -4097,6 +5144,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
 import { createHmac, timingSafeEqual } from "crypto";
 var WEBHOOK_SIGNATURE_HEADER = "Taxora-Signature";
@@ -4215,18 +5324,29 @@ function toBytes(rawBody) {
     "invalid_body"
   );
 }
+
+// src/webhooks/WebhookEvent.ts
+function isTransactionBuyerRejected(object) {
+  return object.buyer_rejected === true;
+}
 export {
   ApiVersion,
   AuthEndpoint,
   AuthRetryHttpClient,
   AuthenticationException,
+  BillingEndpoint,
   CompanyAddress,
   CompanyEndpoint,
+  ComplianceDeliveryAction,
+  ComplianceDeliveryDecision,
   ComplianceDocumentType,
   ComplianceEnrollment,
   ComplianceEnrollmentPage,
   ComplianceEnrollmentStatus,
+  ComplianceOfferings,
   ComplianceService,
+  ComplianceTax,
+  ComplianceTaxCategory,
   ComplianceTaxReport,
   ComplianceTaxReportPage,
   ComplianceTaxReportState,
@@ -4235,6 +5355,8 @@ export {
   ComplianceTransactionState,
   ComplianceTransactionType,
   DEFAULT_WEBHOOK_TOLERANCE_SECONDS,
+  EInvoicingQuota,
+  EInvoicingQuotaPeriod,
   EReportingEndpoint,
   Environment,
   FetchHttpClient,
@@ -4269,6 +5391,8 @@ export {
   TaxoraClientFactory,
   TaxoraException,
   Token,
+  UsageSummary,
+  UsageSummaryPage,
   ValidationException,
   VatCertificateExport,
   VatCollection,
@@ -4280,6 +5404,7 @@ export {
   WEBHOOK_ID_HEADER,
   WEBHOOK_SIGNATURE_HEADER,
   WebhookSignatureVerificationError,
+  calculateInvoiceTotals,
   computeWebhookSignature,
   constructWebhookEvent,
   describeApiError,
@@ -4297,6 +5422,8 @@ export {
   generateWebhookSignatureHeader,
   getBaseUrl,
   getFailedVatStates,
+  isTransactionBuyerRejected,
+  parseComplianceTaxCategory,
   parseLocalTaxNumbersCsv,
   parseWebhookSignatureHeader,
   toComplianceDocumentType,