@taxora/sdk 1.6.0 → 1.7.0

package/dist/index.d.cts

@@ -1166,6 +1166,8 @@ interface SmartEnrichmentRejectedCandidate {
     vatNumber: string;
     reason: SmartEnrichmentRejectionReason;
 }
+/** Where a Smart Enrichment `taxNumber` comes from. */
+type SmartEnrichmentTaxNumberSource = 'vat_id' | 'company_website';
 /** The registered address the official VAT check returned, field by field. */
 interface SmartEnrichmentOfficialAddress {
     street?: string;
@@ -1219,8 +1221,12 @@ declare class SmartEnrichmentResource {
      */
     readonly sourceUrls: string[];
     /**
-     * A domestic tax number (e.g. a German Steuernummer, digits only) the company's own page shows
-     * INSTEAD of a VAT ID — often under the VAT ID heading by mistake. Not a VAT ID.
+     * The company's LOCAL tax / business number, national notation without spaces — what domestic
+     * e-invoicing asks for. On `found` it is read off the confirmed VAT ID where that country's VAT ID
+     * contains it (`taxNumberSource` 'vat_id': FR SIREN, IT Partita IVA, ES NIF, PL NIP, BE enterprise
+     * number, DK CVR, PT, RO, CZ IČO, SK DIČ, SE/NO orgnr, FI Y-tunnus, SI, HR OIB, BG EIK, GR AFM).
+     * Otherwise a domestic number the company itself published ('company_website', e.g. a DE/AT
+     * Steuernummer) — that one is not a VAT ID.
      */
     readonly taxNumber: string | undefined;
     /** Only on `found`: the tax authority's verdict on the number; undefined when no official check ran. */
@@ -1236,6 +1242,15 @@ declare class SmartEnrichmentResource {
     readonly officialName: string | undefined;
     /** Only on `found`: the registered address, field by field. */
     readonly officialAddress: SmartEnrichmentOfficialAddress | undefined;
+    /** What `taxNumber` is, e.g. 'pl_nip', 'fr_siren', 'de_steuernummer'. Undefined when there is none. */
+    readonly taxNumberType: string | undefined;
+    /** The number's name in its country (SIREN, NIP, Steuernummer …), for display. */
+    readonly taxNumberLabel: string | undefined;
+    /**
+     * Where `taxNumber` comes from: 'vat_id' (read off the VAT ID the tax authority confirmed — exact)
+     * or 'company_website' (published by the company itself, not officially confirmable).
+     */
+    readonly taxNumberSource: SmartEnrichmentTaxNumberSource | undefined;
     constructor(status: SmartEnrichmentStatus, vatNumber: string | undefined, vatType: string | undefined, confidence: number | undefined, matchedCompanyName: string | undefined, 
     /** Official/registered address of the matched company, when available. */
     matchedAddress: string | undefined, country: string | undefined, source: string | undefined, 
@@ -1270,8 +1285,12 @@ declare class SmartEnrichmentResource {
      */
     sourceUrls?: string[], 
     /**
-     * A domestic tax number (e.g. a German Steuernummer, digits only) the company's own page shows
-     * INSTEAD of a VAT ID — often under the VAT ID heading by mistake. Not a VAT ID.
+     * The company's LOCAL tax / business number, national notation without spaces — what domestic
+     * e-invoicing asks for. On `found` it is read off the confirmed VAT ID where that country's VAT ID
+     * contains it (`taxNumberSource` 'vat_id': FR SIREN, IT Partita IVA, ES NIF, PL NIP, BE enterprise
+     * number, DK CVR, PT, RO, CZ IČO, SK DIČ, SE/NO orgnr, FI Y-tunnus, SI, HR OIB, BG EIK, GR AFM).
+     * Otherwise a domestic number the company itself published ('company_website', e.g. a DE/AT
+     * Steuernummer) — that one is not a VAT ID.
      */
     taxNumber?: string | undefined, 
     /** Only on `found`: the tax authority's verdict on the number; undefined when no official check ran. */
@@ -1286,7 +1305,16 @@ declare class SmartEnrichmentResource {
     /** Only on `found`: the name the register has the number under. */
     officialName?: string | undefined, 
     /** Only on `found`: the registered address, field by field. */
-    officialAddress?: SmartEnrichmentOfficialAddress | undefined);
+    officialAddress?: SmartEnrichmentOfficialAddress | undefined, 
+    /** What `taxNumber` is, e.g. 'pl_nip', 'fr_siren', 'de_steuernummer'. Undefined when there is none. */
+    taxNumberType?: string | undefined, 
+    /** The number's name in its country (SIREN, NIP, Steuernummer …), for display. */
+    taxNumberLabel?: string | undefined, 
+    /**
+     * Where `taxNumber` comes from: 'vat_id' (read off the VAT ID the tax authority confirmed — exact)
+     * or 'company_website' (published by the company itself, not officially confirmable).
+     */
+    taxNumberSource?: SmartEnrichmentTaxNumberSource | undefined);
     /** True when the register knows the number under a different name than the one requested. */
     nameMismatch(): boolean;
     /** True when a VAT number was found but rejected by the official check. */
@@ -1718,6 +1746,72 @@ declare class VatValidationAddressInput {
     toArray(): Record<string, string>;
 }
 
+/** Columns of the local tax numbers report. */
+type Column = 'companyName' | 'requestedName' | 'country' | 'vatNumber' | 'vatStatus' | 'taxNumber' | 'taxNumberName' | 'taxNumberSource' | 'source' | 'checkedAt' | 'checkId';
+/**
+ * One company of the local tax numbers report: every company checked (VAT checks and Smart
+ * Enrichment) once, with its local tax number. Empty cells come back as null.
+ */
+declare class LocalTaxNumberRow {
+    readonly companyName: string | null;
+    /** The name you submitted, when it differs from the registered one. */
+    readonly requestedName: string | null;
+    readonly country: string | null;
+    readonly vatNumber: string | null;
+    /** 'valid' | 'invalid' | 'unconfirmed' | 'wrong_company' | 'no_vat_id' | 'not_found' */
+    readonly vatStatus: string | null;
+    /** The company's local tax / business number (NIP, SIREN, Partita IVA, Steuernummer …). */
+    readonly taxNumber: string | null;
+    /** The number's national name, e.g. 'NIP', 'SIREN', 'Steuernummer'. */
+    readonly taxNumberName: string | null;
+    /** 'vat_id' (read off the confirmed VAT ID) | 'company_website' (published by the company). */
+    readonly taxNumberSource: string | null;
+    /** 'vat_check' | 'smart_enrichment' */
+    readonly source: string | null;
+    readonly checkedAt: string | null;
+    /** The VAT check uuid or the Smart Enrichment job id. */
+    readonly checkId: string | null;
+    constructor(companyName: string | null, 
+    /** The name you submitted, when it differs from the registered one. */
+    requestedName: string | null, country: string | null, vatNumber: string | null, 
+    /** 'valid' | 'invalid' | 'unconfirmed' | 'wrong_company' | 'no_vat_id' | 'not_found' */
+    vatStatus: string | null, 
+    /** The company's local tax / business number (NIP, SIREN, Partita IVA, Steuernummer …). */
+    taxNumber: string | null, 
+    /** The number's national name, e.g. 'NIP', 'SIREN', 'Steuernummer'. */
+    taxNumberName: string | null, 
+    /** 'vat_id' (read off the confirmed VAT ID) | 'company_website' (published by the company). */
+    taxNumberSource: string | null, 
+    /** 'vat_check' | 'smart_enrichment' */
+    source: string | null, checkedAt: string | null, 
+    /** The VAT check uuid or the Smart Enrichment job id. */
+    checkId: string | null);
+    /** One CSV row keyed by column name. */
+    static fromArray(data: Record<string, unknown>): LocalTaxNumberRow;
+    toArray(): Record<Column, string | null>;
+}
+/** How many companies the local tax numbers report would list, and how many have a tax number. */
+interface LocalTaxNumberSummary {
+    companies: number;
+    withTaxNumber: number;
+}
+/** Filters of the local tax numbers report. All optional. */
+interface LocalTaxNumberReportOptions {
+    /** Y-m-d string or Date. */
+    dateFrom?: Date | string;
+    /** Y-m-d string or Date. */
+    dateTo?: Date | string;
+    /** ISO 3166-1 alpha-2 codes. */
+    countries?: string[];
+    /** Skip companies without a local tax number (report only; the summary counts both). */
+    onlyWithTaxNumber?: boolean;
+}
+/**
+ * Parses a local tax numbers CSV (as returned by `localTaxNumbersCsv()`) into rows: BOM dropped,
+ * cells trimmed (incl. the Excel TAB guard), empty cells null.
+ */
+declare function parseLocalTaxNumbersCsv(csv: string): LocalTaxNumberRow[];
+
 declare const Language: {
     readonly ENGLISH: "en";
     readonly GERMAN: "de";
@@ -1742,6 +1836,19 @@ declare class VatEndpoint {
     certificatesListExport(fromDate: Date | string, toDate: Date | string, countries?: string[], lang?: Language): Promise<VatCertificateExport>;
     private exportRequest;
     downloadBulkExport(exportId: string): Promise<Uint8Array>;
+    /**
+     * Local tax numbers report as raw CSV (UTF-8 with BOM, comma-separated): every company checked —
+     * single and bulk VAT checks and Smart Enrichment lookups — once, with its local tax number
+     * (taxNumber, taxNumberName, taxNumberSource). Digit-only taxNumber cells carry a leading TAB so
+     * Excel keeps them as text; `localTaxNumbers()` strips it for you.
+     */
+    localTaxNumbersCsv(options?: LocalTaxNumberReportOptions): Promise<string>;
+    /** The local tax numbers report, parsed: one row per company (same filters as `localTaxNumbersCsv()`). */
+    localTaxNumbers(options?: LocalTaxNumberReportOptions): Promise<LocalTaxNumberRow[]>;
+    /** How many companies the report would list for the filters, and how many have a tax number. */
+    localTaxNumbersSummary(options?: Omit<LocalTaxNumberReportOptions, 'onlyWithTaxNumber'>): Promise<LocalTaxNumberSummary>;
+    private localTaxNumbersParams;
+    private withQuery;
     private buildHeaders;
     private sendRequest;
     private sendBinaryRequest;
@@ -2019,4 +2126,4 @@ declare class AuthRetryHttpClient implements HttpClientInterface {
     private injectAuthHeader;
 }
 
-export { ApiVersion, AuthEndpoint, AuthRetryHttpClient, AuthenticationException, CompanyAddress, CompanyEndpoint, type CompanyResource, ComplianceDocumentType, ComplianceEnrollment, ComplianceEnrollmentPage, ComplianceEnrollmentStatus, type ComplianceEnterpriseSize, type ComplianceInvoiceLineInput, type ComplianceInvoiceTaxInput, type ComplianceLedgerStateChangedEvent, type ComplianceLedgerWebhookObject, type ComplianceRequestService, ComplianceService, ComplianceTaxReport, ComplianceTaxReportPage, type ComplianceTaxReportRequestState, ComplianceTaxReportState, ComplianceTransaction, type ComplianceTransactionBuyerInput, type ComplianceTransactionFilters, type ComplianceTransactionInvoiceLine, type ComplianceTransactionInvoiceLineTax, ComplianceTransactionPage, type ComplianceTransactionRequestState, type ComplianceTransactionRequestType, ComplianceTransactionState, type ComplianceTransactionStateChangedEvent, ComplianceTransactionType, type ComplianceTransactionWebhookObject, type ComplianceTypeOperation, type CreateComplianceEnrollmentInput, type CreateComplianceTransactionInput, type CreateNorwayEnrollmentInput, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, type EReportingAccessRequestInput, EReportingEndpoint, type EReportingInterval, type EnrichmentCompletedEvent, type EnrichmentCompletedWebhookObject, type EnrichmentUpdatedEvent, type EnrichmentUpdatedWebhookObject, Environment, Environment as EnvironmentType, FetchHttpClient, type HttpClientInterface, HttpException, ImportResult, InMemoryTokenStorage, Language, LoginIdentifier, type NorwayEnrollmentInput, NorwegianOrgNumber, type ParsedWebhookSignatureHeader, PeppolLookupResult, PeppolLookupStatus, ProviderDocument, ProviderDocumentLine, RegistryCompany, RetryPolicy, type RetryPolicyOptions, type RevenueCountryBreakdown, type RevenueCurrencyBreakdown, type RevenueStateBreakdown, RevenueStatistics, type RevenueStatisticsFilters, type RevenueTimeBucket, type RevenueTotals, type RevenueTypeBreakdown, ScoreBreakdown, SireneLookupResult, type SmartEnrichmentAddressQuality, type SmartEnrichmentConfidenceBucket, SmartEnrichmentEndpoint, type SmartEnrichmentExportOptions, type SmartEnrichmentHistoryInput, SmartEnrichmentHistoryPage, SmartEnrichmentHistoryRow, type SmartEnrichmentHistoryStats, type SmartEnrichmentInput, SmartEnrichmentJob, SmartEnrichmentMode, type SmartEnrichmentOfficialAddress, type SmartEnrichmentOutcomeBreakdown, type SmartEnrichmentProviderVerdict, type SmartEnrichmentRejectedCandidate, SmartEnrichmentRejectionReason, SmartEnrichmentResource, type SmartEnrichmentSourceBreakdown, SmartEnrichmentStatistics, type SmartEnrichmentStatisticsInterval, type SmartEnrichmentStatisticsOptions, type SmartEnrichmentStatisticsRange, type SmartEnrichmentStatisticsTotals, SmartEnrichmentStatus, type SmartEnrichmentTimeBucket, type SmartEnrichmentUsage, type SmartEnrichmentUsageHistoryEntry, type SmartEnrichmentWaitOptions, TaxoraClient, TaxoraClientFactory, type TaxoraClientOptions, TaxoraException, type TaxoraWebhookEvent, type TestWebhookObject, Token, type TokenStorageInterface, type UpdateComplianceTransactionInput, ValidationException, VatCertificateExport, VatCollection, VatEndpoint, type VatRate, VatRates, VatResource, VatState, type VatStateChangedEvent, type VatValidatedEvent, VatValidationAddressInput, type VatWebhookObject, WEBHOOK_ID_HEADER, WEBHOOK_SIGNATURE_HEADER, type WebhookEventEnvelope, type WebhookEventType, type WebhookRawBody, type WebhookSignatureErrorReason, type WebhookSignatureHeaderInput, WebhookSignatureVerificationError, type WebhookTestEvent, type WebhookVerifyOptions, computeWebhookSignature, constructWebhookEvent, describeApiError, describeComplianceDocumentType, describeComplianceEnrollmentStatus, describeComplianceService, describeComplianceTaxReportState, describeComplianceTransactionState, describeComplianceTransactionType, describePeppolLookupStatus, describeSmartEnrichmentMode, describeSmartEnrichmentRejectionReason, describeSmartEnrichmentStatus, describeVatState, generateWebhookSignatureHeader, getBaseUrl, getFailedVatStates, parseWebhookSignatureHeader, toComplianceDocumentType, toComplianceEnrollmentStatus, toComplianceService, toComplianceTaxReportState, toComplianceTransactionState, toComplianceTransactionType, toPeppolLookupStatus, toSmartEnrichmentMode, toSmartEnrichmentRejectionReason, toSmartEnrichmentStatus, verifyWebhookSignature };
+export { ApiVersion, AuthEndpoint, AuthRetryHttpClient, AuthenticationException, CompanyAddress, CompanyEndpoint, type CompanyResource, ComplianceDocumentType, ComplianceEnrollment, ComplianceEnrollmentPage, ComplianceEnrollmentStatus, type ComplianceEnterpriseSize, type ComplianceInvoiceLineInput, type ComplianceInvoiceTaxInput, type ComplianceLedgerStateChangedEvent, type ComplianceLedgerWebhookObject, type ComplianceRequestService, ComplianceService, ComplianceTaxReport, ComplianceTaxReportPage, type ComplianceTaxReportRequestState, ComplianceTaxReportState, ComplianceTransaction, type ComplianceTransactionBuyerInput, type ComplianceTransactionFilters, type ComplianceTransactionInvoiceLine, type ComplianceTransactionInvoiceLineTax, ComplianceTransactionPage, type ComplianceTransactionRequestState, type ComplianceTransactionRequestType, ComplianceTransactionState, type ComplianceTransactionStateChangedEvent, ComplianceTransactionType, type ComplianceTransactionWebhookObject, type ComplianceTypeOperation, type CreateComplianceEnrollmentInput, type CreateComplianceTransactionInput, type CreateNorwayEnrollmentInput, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, type EReportingAccessRequestInput, EReportingEndpoint, type EReportingInterval, type EnrichmentCompletedEvent, type EnrichmentCompletedWebhookObject, type EnrichmentUpdatedEvent, type EnrichmentUpdatedWebhookObject, Environment, Environment as EnvironmentType, FetchHttpClient, type HttpClientInterface, HttpException, ImportResult, InMemoryTokenStorage, Language, type LocalTaxNumberReportOptions, LocalTaxNumberRow, type LocalTaxNumberSummary, LoginIdentifier, type NorwayEnrollmentInput, NorwegianOrgNumber, type ParsedWebhookSignatureHeader, PeppolLookupResult, PeppolLookupStatus, ProviderDocument, ProviderDocumentLine, RegistryCompany, RetryPolicy, type RetryPolicyOptions, type RevenueCountryBreakdown, type RevenueCurrencyBreakdown, type RevenueStateBreakdown, RevenueStatistics, type RevenueStatisticsFilters, type RevenueTimeBucket, type RevenueTotals, type RevenueTypeBreakdown, ScoreBreakdown, SireneLookupResult, type SmartEnrichmentAddressQuality, type SmartEnrichmentConfidenceBucket, SmartEnrichmentEndpoint, type SmartEnrichmentExportOptions, type SmartEnrichmentHistoryInput, SmartEnrichmentHistoryPage, SmartEnrichmentHistoryRow, type SmartEnrichmentHistoryStats, type SmartEnrichmentInput, SmartEnrichmentJob, SmartEnrichmentMode, type SmartEnrichmentOfficialAddress, type SmartEnrichmentOutcomeBreakdown, type SmartEnrichmentProviderVerdict, type SmartEnrichmentRejectedCandidate, SmartEnrichmentRejectionReason, SmartEnrichmentResource, type SmartEnrichmentSourceBreakdown, SmartEnrichmentStatistics, type SmartEnrichmentStatisticsInterval, type SmartEnrichmentStatisticsOptions, type SmartEnrichmentStatisticsRange, type SmartEnrichmentStatisticsTotals, SmartEnrichmentStatus, type SmartEnrichmentTaxNumberSource, type SmartEnrichmentTimeBucket, type SmartEnrichmentUsage, type SmartEnrichmentUsageHistoryEntry, type SmartEnrichmentWaitOptions, TaxoraClient, TaxoraClientFactory, type TaxoraClientOptions, TaxoraException, type TaxoraWebhookEvent, type TestWebhookObject, Token, type TokenStorageInterface, type UpdateComplianceTransactionInput, ValidationException, VatCertificateExport, VatCollection, VatEndpoint, type VatRate, VatRates, VatResource, VatState, type VatStateChangedEvent, type VatValidatedEvent, VatValidationAddressInput, type VatWebhookObject, WEBHOOK_ID_HEADER, WEBHOOK_SIGNATURE_HEADER, type WebhookEventEnvelope, type WebhookEventType, type WebhookRawBody, type WebhookSignatureErrorReason, type WebhookSignatureHeaderInput, WebhookSignatureVerificationError, type WebhookTestEvent, type WebhookVerifyOptions, computeWebhookSignature, constructWebhookEvent, describeApiError, describeComplianceDocumentType, describeComplianceEnrollmentStatus, describeComplianceService, describeComplianceTaxReportState, describeComplianceTransactionState, describeComplianceTransactionType, describePeppolLookupStatus, describeSmartEnrichmentMode, describeSmartEnrichmentRejectionReason, describeSmartEnrichmentStatus, describeVatState, generateWebhookSignatureHeader, getBaseUrl, getFailedVatStates, parseLocalTaxNumbersCsv, parseWebhookSignatureHeader, toComplianceDocumentType, toComplianceEnrollmentStatus, toComplianceService, toComplianceTaxReportState, toComplianceTransactionState, toComplianceTransactionType, toPeppolLookupStatus, toSmartEnrichmentMode, toSmartEnrichmentRejectionReason, toSmartEnrichmentStatus, verifyWebhookSignature };

package/dist/index.d.ts

@@ -1166,6 +1166,8 @@ interface SmartEnrichmentRejectedCandidate {
     vatNumber: string;
     reason: SmartEnrichmentRejectionReason;
 }
+/** Where a Smart Enrichment `taxNumber` comes from. */
+type SmartEnrichmentTaxNumberSource = 'vat_id' | 'company_website';
 /** The registered address the official VAT check returned, field by field. */
 interface SmartEnrichmentOfficialAddress {
     street?: string;
@@ -1219,8 +1221,12 @@ declare class SmartEnrichmentResource {
      */
     readonly sourceUrls: string[];
     /**
-     * A domestic tax number (e.g. a German Steuernummer, digits only) the company's own page shows
-     * INSTEAD of a VAT ID — often under the VAT ID heading by mistake. Not a VAT ID.
+     * The company's LOCAL tax / business number, national notation without spaces — what domestic
+     * e-invoicing asks for. On `found` it is read off the confirmed VAT ID where that country's VAT ID
+     * contains it (`taxNumberSource` 'vat_id': FR SIREN, IT Partita IVA, ES NIF, PL NIP, BE enterprise
+     * number, DK CVR, PT, RO, CZ IČO, SK DIČ, SE/NO orgnr, FI Y-tunnus, SI, HR OIB, BG EIK, GR AFM).
+     * Otherwise a domestic number the company itself published ('company_website', e.g. a DE/AT
+     * Steuernummer) — that one is not a VAT ID.
      */
     readonly taxNumber: string | undefined;
     /** Only on `found`: the tax authority's verdict on the number; undefined when no official check ran. */
@@ -1236,6 +1242,15 @@ declare class SmartEnrichmentResource {
     readonly officialName: string | undefined;
     /** Only on `found`: the registered address, field by field. */
     readonly officialAddress: SmartEnrichmentOfficialAddress | undefined;
+    /** What `taxNumber` is, e.g. 'pl_nip', 'fr_siren', 'de_steuernummer'. Undefined when there is none. */
+    readonly taxNumberType: string | undefined;
+    /** The number's name in its country (SIREN, NIP, Steuernummer …), for display. */
+    readonly taxNumberLabel: string | undefined;
+    /**
+     * Where `taxNumber` comes from: 'vat_id' (read off the VAT ID the tax authority confirmed — exact)
+     * or 'company_website' (published by the company itself, not officially confirmable).
+     */
+    readonly taxNumberSource: SmartEnrichmentTaxNumberSource | undefined;
     constructor(status: SmartEnrichmentStatus, vatNumber: string | undefined, vatType: string | undefined, confidence: number | undefined, matchedCompanyName: string | undefined, 
     /** Official/registered address of the matched company, when available. */
     matchedAddress: string | undefined, country: string | undefined, source: string | undefined, 
@@ -1270,8 +1285,12 @@ declare class SmartEnrichmentResource {
      */
     sourceUrls?: string[], 
     /**
-     * A domestic tax number (e.g. a German Steuernummer, digits only) the company's own page shows
-     * INSTEAD of a VAT ID — often under the VAT ID heading by mistake. Not a VAT ID.
+     * The company's LOCAL tax / business number, national notation without spaces — what domestic
+     * e-invoicing asks for. On `found` it is read off the confirmed VAT ID where that country's VAT ID
+     * contains it (`taxNumberSource` 'vat_id': FR SIREN, IT Partita IVA, ES NIF, PL NIP, BE enterprise
+     * number, DK CVR, PT, RO, CZ IČO, SK DIČ, SE/NO orgnr, FI Y-tunnus, SI, HR OIB, BG EIK, GR AFM).
+     * Otherwise a domestic number the company itself published ('company_website', e.g. a DE/AT
+     * Steuernummer) — that one is not a VAT ID.
      */
     taxNumber?: string | undefined, 
     /** Only on `found`: the tax authority's verdict on the number; undefined when no official check ran. */
@@ -1286,7 +1305,16 @@ declare class SmartEnrichmentResource {
     /** Only on `found`: the name the register has the number under. */
     officialName?: string | undefined, 
     /** Only on `found`: the registered address, field by field. */
-    officialAddress?: SmartEnrichmentOfficialAddress | undefined);
+    officialAddress?: SmartEnrichmentOfficialAddress | undefined, 
+    /** What `taxNumber` is, e.g. 'pl_nip', 'fr_siren', 'de_steuernummer'. Undefined when there is none. */
+    taxNumberType?: string | undefined, 
+    /** The number's name in its country (SIREN, NIP, Steuernummer …), for display. */
+    taxNumberLabel?: string | undefined, 
+    /**
+     * Where `taxNumber` comes from: 'vat_id' (read off the VAT ID the tax authority confirmed — exact)
+     * or 'company_website' (published by the company itself, not officially confirmable).
+     */
+    taxNumberSource?: SmartEnrichmentTaxNumberSource | undefined);
     /** True when the register knows the number under a different name than the one requested. */
     nameMismatch(): boolean;
     /** True when a VAT number was found but rejected by the official check. */
@@ -1718,6 +1746,72 @@ declare class VatValidationAddressInput {
     toArray(): Record<string, string>;
 }
 
+/** Columns of the local tax numbers report. */
+type Column = 'companyName' | 'requestedName' | 'country' | 'vatNumber' | 'vatStatus' | 'taxNumber' | 'taxNumberName' | 'taxNumberSource' | 'source' | 'checkedAt' | 'checkId';
+/**
+ * One company of the local tax numbers report: every company checked (VAT checks and Smart
+ * Enrichment) once, with its local tax number. Empty cells come back as null.
+ */
+declare class LocalTaxNumberRow {
+    readonly companyName: string | null;
+    /** The name you submitted, when it differs from the registered one. */
+    readonly requestedName: string | null;
+    readonly country: string | null;
+    readonly vatNumber: string | null;
+    /** 'valid' | 'invalid' | 'unconfirmed' | 'wrong_company' | 'no_vat_id' | 'not_found' */
+    readonly vatStatus: string | null;
+    /** The company's local tax / business number (NIP, SIREN, Partita IVA, Steuernummer …). */
+    readonly taxNumber: string | null;
+    /** The number's national name, e.g. 'NIP', 'SIREN', 'Steuernummer'. */
+    readonly taxNumberName: string | null;
+    /** 'vat_id' (read off the confirmed VAT ID) | 'company_website' (published by the company). */
+    readonly taxNumberSource: string | null;
+    /** 'vat_check' | 'smart_enrichment' */
+    readonly source: string | null;
+    readonly checkedAt: string | null;
+    /** The VAT check uuid or the Smart Enrichment job id. */
+    readonly checkId: string | null;
+    constructor(companyName: string | null, 
+    /** The name you submitted, when it differs from the registered one. */
+    requestedName: string | null, country: string | null, vatNumber: string | null, 
+    /** 'valid' | 'invalid' | 'unconfirmed' | 'wrong_company' | 'no_vat_id' | 'not_found' */
+    vatStatus: string | null, 
+    /** The company's local tax / business number (NIP, SIREN, Partita IVA, Steuernummer …). */
+    taxNumber: string | null, 
+    /** The number's national name, e.g. 'NIP', 'SIREN', 'Steuernummer'. */
+    taxNumberName: string | null, 
+    /** 'vat_id' (read off the confirmed VAT ID) | 'company_website' (published by the company). */
+    taxNumberSource: string | null, 
+    /** 'vat_check' | 'smart_enrichment' */
+    source: string | null, checkedAt: string | null, 
+    /** The VAT check uuid or the Smart Enrichment job id. */
+    checkId: string | null);
+    /** One CSV row keyed by column name. */
+    static fromArray(data: Record<string, unknown>): LocalTaxNumberRow;
+    toArray(): Record<Column, string | null>;
+}
+/** How many companies the local tax numbers report would list, and how many have a tax number. */
+interface LocalTaxNumberSummary {
+    companies: number;
+    withTaxNumber: number;
+}
+/** Filters of the local tax numbers report. All optional. */
+interface LocalTaxNumberReportOptions {
+    /** Y-m-d string or Date. */
+    dateFrom?: Date | string;
+    /** Y-m-d string or Date. */
+    dateTo?: Date | string;
+    /** ISO 3166-1 alpha-2 codes. */
+    countries?: string[];
+    /** Skip companies without a local tax number (report only; the summary counts both). */
+    onlyWithTaxNumber?: boolean;
+}
+/**
+ * Parses a local tax numbers CSV (as returned by `localTaxNumbersCsv()`) into rows: BOM dropped,
+ * cells trimmed (incl. the Excel TAB guard), empty cells null.
+ */
+declare function parseLocalTaxNumbersCsv(csv: string): LocalTaxNumberRow[];
+
 declare const Language: {
     readonly ENGLISH: "en";
     readonly GERMAN: "de";
@@ -1742,6 +1836,19 @@ declare class VatEndpoint {
     certificatesListExport(fromDate: Date | string, toDate: Date | string, countries?: string[], lang?: Language): Promise<VatCertificateExport>;
     private exportRequest;
     downloadBulkExport(exportId: string): Promise<Uint8Array>;
+    /**
+     * Local tax numbers report as raw CSV (UTF-8 with BOM, comma-separated): every company checked —
+     * single and bulk VAT checks and Smart Enrichment lookups — once, with its local tax number
+     * (taxNumber, taxNumberName, taxNumberSource). Digit-only taxNumber cells carry a leading TAB so
+     * Excel keeps them as text; `localTaxNumbers()` strips it for you.
+     */
+    localTaxNumbersCsv(options?: LocalTaxNumberReportOptions): Promise<string>;
+    /** The local tax numbers report, parsed: one row per company (same filters as `localTaxNumbersCsv()`). */
+    localTaxNumbers(options?: LocalTaxNumberReportOptions): Promise<LocalTaxNumberRow[]>;
+    /** How many companies the report would list for the filters, and how many have a tax number. */
+    localTaxNumbersSummary(options?: Omit<LocalTaxNumberReportOptions, 'onlyWithTaxNumber'>): Promise<LocalTaxNumberSummary>;
+    private localTaxNumbersParams;
+    private withQuery;
     private buildHeaders;
     private sendRequest;
     private sendBinaryRequest;
@@ -2019,4 +2126,4 @@ declare class AuthRetryHttpClient implements HttpClientInterface {
     private injectAuthHeader;
 }
 
-export { ApiVersion, AuthEndpoint, AuthRetryHttpClient, AuthenticationException, CompanyAddress, CompanyEndpoint, type CompanyResource, ComplianceDocumentType, ComplianceEnrollment, ComplianceEnrollmentPage, ComplianceEnrollmentStatus, type ComplianceEnterpriseSize, type ComplianceInvoiceLineInput, type ComplianceInvoiceTaxInput, type ComplianceLedgerStateChangedEvent, type ComplianceLedgerWebhookObject, type ComplianceRequestService, ComplianceService, ComplianceTaxReport, ComplianceTaxReportPage, type ComplianceTaxReportRequestState, ComplianceTaxReportState, ComplianceTransaction, type ComplianceTransactionBuyerInput, type ComplianceTransactionFilters, type ComplianceTransactionInvoiceLine, type ComplianceTransactionInvoiceLineTax, ComplianceTransactionPage, type ComplianceTransactionRequestState, type ComplianceTransactionRequestType, ComplianceTransactionState, type ComplianceTransactionStateChangedEvent, ComplianceTransactionType, type ComplianceTransactionWebhookObject, type ComplianceTypeOperation, type CreateComplianceEnrollmentInput, type CreateComplianceTransactionInput, type CreateNorwayEnrollmentInput, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, type EReportingAccessRequestInput, EReportingEndpoint, type EReportingInterval, type EnrichmentCompletedEvent, type EnrichmentCompletedWebhookObject, type EnrichmentUpdatedEvent, type EnrichmentUpdatedWebhookObject, Environment, Environment as EnvironmentType, FetchHttpClient, type HttpClientInterface, HttpException, ImportResult, InMemoryTokenStorage, Language, LoginIdentifier, type NorwayEnrollmentInput, NorwegianOrgNumber, type ParsedWebhookSignatureHeader, PeppolLookupResult, PeppolLookupStatus, ProviderDocument, ProviderDocumentLine, RegistryCompany, RetryPolicy, type RetryPolicyOptions, type RevenueCountryBreakdown, type RevenueCurrencyBreakdown, type RevenueStateBreakdown, RevenueStatistics, type RevenueStatisticsFilters, type RevenueTimeBucket, type RevenueTotals, type RevenueTypeBreakdown, ScoreBreakdown, SireneLookupResult, type SmartEnrichmentAddressQuality, type SmartEnrichmentConfidenceBucket, SmartEnrichmentEndpoint, type SmartEnrichmentExportOptions, type SmartEnrichmentHistoryInput, SmartEnrichmentHistoryPage, SmartEnrichmentHistoryRow, type SmartEnrichmentHistoryStats, type SmartEnrichmentInput, SmartEnrichmentJob, SmartEnrichmentMode, type SmartEnrichmentOfficialAddress, type SmartEnrichmentOutcomeBreakdown, type SmartEnrichmentProviderVerdict, type SmartEnrichmentRejectedCandidate, SmartEnrichmentRejectionReason, SmartEnrichmentResource, type SmartEnrichmentSourceBreakdown, SmartEnrichmentStatistics, type SmartEnrichmentStatisticsInterval, type SmartEnrichmentStatisticsOptions, type SmartEnrichmentStatisticsRange, type SmartEnrichmentStatisticsTotals, SmartEnrichmentStatus, type SmartEnrichmentTimeBucket, type SmartEnrichmentUsage, type SmartEnrichmentUsageHistoryEntry, type SmartEnrichmentWaitOptions, TaxoraClient, TaxoraClientFactory, type TaxoraClientOptions, TaxoraException, type TaxoraWebhookEvent, type TestWebhookObject, Token, type TokenStorageInterface, type UpdateComplianceTransactionInput, ValidationException, VatCertificateExport, VatCollection, VatEndpoint, type VatRate, VatRates, VatResource, VatState, type VatStateChangedEvent, type VatValidatedEvent, VatValidationAddressInput, type VatWebhookObject, WEBHOOK_ID_HEADER, WEBHOOK_SIGNATURE_HEADER, type WebhookEventEnvelope, type WebhookEventType, type WebhookRawBody, type WebhookSignatureErrorReason, type WebhookSignatureHeaderInput, WebhookSignatureVerificationError, type WebhookTestEvent, type WebhookVerifyOptions, computeWebhookSignature, constructWebhookEvent, describeApiError, describeComplianceDocumentType, describeComplianceEnrollmentStatus, describeComplianceService, describeComplianceTaxReportState, describeComplianceTransactionState, describeComplianceTransactionType, describePeppolLookupStatus, describeSmartEnrichmentMode, describeSmartEnrichmentRejectionReason, describeSmartEnrichmentStatus, describeVatState, generateWebhookSignatureHeader, getBaseUrl, getFailedVatStates, parseWebhookSignatureHeader, toComplianceDocumentType, toComplianceEnrollmentStatus, toComplianceService, toComplianceTaxReportState, toComplianceTransactionState, toComplianceTransactionType, toPeppolLookupStatus, toSmartEnrichmentMode, toSmartEnrichmentRejectionReason, toSmartEnrichmentStatus, verifyWebhookSignature };
+export { ApiVersion, AuthEndpoint, AuthRetryHttpClient, AuthenticationException, CompanyAddress, CompanyEndpoint, type CompanyResource, ComplianceDocumentType, ComplianceEnrollment, ComplianceEnrollmentPage, ComplianceEnrollmentStatus, type ComplianceEnterpriseSize, type ComplianceInvoiceLineInput, type ComplianceInvoiceTaxInput, type ComplianceLedgerStateChangedEvent, type ComplianceLedgerWebhookObject, type ComplianceRequestService, ComplianceService, ComplianceTaxReport, ComplianceTaxReportPage, type ComplianceTaxReportRequestState, ComplianceTaxReportState, ComplianceTransaction, type ComplianceTransactionBuyerInput, type ComplianceTransactionFilters, type ComplianceTransactionInvoiceLine, type ComplianceTransactionInvoiceLineTax, ComplianceTransactionPage, type ComplianceTransactionRequestState, type ComplianceTransactionRequestType, ComplianceTransactionState, type ComplianceTransactionStateChangedEvent, ComplianceTransactionType, type ComplianceTransactionWebhookObject, type ComplianceTypeOperation, type CreateComplianceEnrollmentInput, type CreateComplianceTransactionInput, type CreateNorwayEnrollmentInput, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, type EReportingAccessRequestInput, EReportingEndpoint, type EReportingInterval, type EnrichmentCompletedEvent, type EnrichmentCompletedWebhookObject, type EnrichmentUpdatedEvent, type EnrichmentUpdatedWebhookObject, Environment, Environment as EnvironmentType, FetchHttpClient, type HttpClientInterface, HttpException, ImportResult, InMemoryTokenStorage, Language, type LocalTaxNumberReportOptions, LocalTaxNumberRow, type LocalTaxNumberSummary, LoginIdentifier, type NorwayEnrollmentInput, NorwegianOrgNumber, type ParsedWebhookSignatureHeader, PeppolLookupResult, PeppolLookupStatus, ProviderDocument, ProviderDocumentLine, RegistryCompany, RetryPolicy, type RetryPolicyOptions, type RevenueCountryBreakdown, type RevenueCurrencyBreakdown, type RevenueStateBreakdown, RevenueStatistics, type RevenueStatisticsFilters, type RevenueTimeBucket, type RevenueTotals, type RevenueTypeBreakdown, ScoreBreakdown, SireneLookupResult, type SmartEnrichmentAddressQuality, type SmartEnrichmentConfidenceBucket, SmartEnrichmentEndpoint, type SmartEnrichmentExportOptions, type SmartEnrichmentHistoryInput, SmartEnrichmentHistoryPage, SmartEnrichmentHistoryRow, type SmartEnrichmentHistoryStats, type SmartEnrichmentInput, SmartEnrichmentJob, SmartEnrichmentMode, type SmartEnrichmentOfficialAddress, type SmartEnrichmentOutcomeBreakdown, type SmartEnrichmentProviderVerdict, type SmartEnrichmentRejectedCandidate, SmartEnrichmentRejectionReason, SmartEnrichmentResource, type SmartEnrichmentSourceBreakdown, SmartEnrichmentStatistics, type SmartEnrichmentStatisticsInterval, type SmartEnrichmentStatisticsOptions, type SmartEnrichmentStatisticsRange, type SmartEnrichmentStatisticsTotals, SmartEnrichmentStatus, type SmartEnrichmentTaxNumberSource, type SmartEnrichmentTimeBucket, type SmartEnrichmentUsage, type SmartEnrichmentUsageHistoryEntry, type SmartEnrichmentWaitOptions, TaxoraClient, TaxoraClientFactory, type TaxoraClientOptions, TaxoraException, type TaxoraWebhookEvent, type TestWebhookObject, Token, type TokenStorageInterface, type UpdateComplianceTransactionInput, ValidationException, VatCertificateExport, VatCollection, VatEndpoint, type VatRate, VatRates, VatResource, VatState, type VatStateChangedEvent, type VatValidatedEvent, VatValidationAddressInput, type VatWebhookObject, WEBHOOK_ID_HEADER, WEBHOOK_SIGNATURE_HEADER, type WebhookEventEnvelope, type WebhookEventType, type WebhookRawBody, type WebhookSignatureErrorReason, type WebhookSignatureHeaderInput, WebhookSignatureVerificationError, type WebhookTestEvent, type WebhookVerifyOptions, computeWebhookSignature, constructWebhookEvent, describeApiError, describeComplianceDocumentType, describeComplianceEnrollmentStatus, describeComplianceService, describeComplianceTaxReportState, describeComplianceTransactionState, describeComplianceTransactionType, describePeppolLookupStatus, describeSmartEnrichmentMode, describeSmartEnrichmentRejectionReason, describeSmartEnrichmentStatus, describeVatState, generateWebhookSignatureHeader, getBaseUrl, getFailedVatStates, parseLocalTaxNumbersCsv, parseWebhookSignatureHeader, toComplianceDocumentType, toComplianceEnrollmentStatus, toComplianceService, toComplianceTaxReportState, toComplianceTransactionState, toComplianceTransactionType, toPeppolLookupStatus, toSmartEnrichmentMode, toSmartEnrichmentRejectionReason, toSmartEnrichmentStatus, verifyWebhookSignature };

package/dist/index.js

@@ -2330,7 +2330,7 @@ function toOfficialAddress(value) {
   return Object.keys(address).length > 0 ? address : void 0;
 }
 var SmartEnrichmentResource = class _SmartEnrichmentResource {
-  constructor(status, vatNumber, vatType, confidence, matchedCompanyName, matchedAddress, country, source, mode = void 0, providerVerdicts = [], addressQuality = void 0, rejectedCandidates = [], sourceUrl = void 0, registeredOwner = void 0, sourceUrls = [], taxNumber = void 0, vatValid = void 0, aiScore = void 0, nameMatch = void 0, officialName = void 0, officialAddress = void 0) {
+  constructor(status, vatNumber, vatType, confidence, matchedCompanyName, matchedAddress, country, source, mode = void 0, providerVerdicts = [], addressQuality = void 0, rejectedCandidates = [], sourceUrl = void 0, registeredOwner = void 0, sourceUrls = [], taxNumber = void 0, vatValid = void 0, aiScore = void 0, nameMatch = void 0, officialName = void 0, officialAddress = void 0, taxNumberType = void 0, taxNumberLabel = void 0, taxNumberSource = void 0) {
     this.status = status;
     this.vatNumber = vatNumber;
     this.vatType = vatType;
@@ -2352,6 +2352,9 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
     this.nameMatch = nameMatch;
     this.officialName = officialName;
     this.officialAddress = officialAddress;
+    this.taxNumberType = taxNumberType;
+    this.taxNumberLabel = taxNumberLabel;
+    this.taxNumberSource = taxNumberSource;
   }
   status;
   vatNumber;
@@ -2374,6 +2377,9 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
   nameMatch;
   officialName;
   officialAddress;
+  taxNumberType;
+  taxNumberLabel;
+  taxNumberSource;
   /** True when the register knows the number under a different name than the one requested. */
   nameMismatch() {
     return this.nameMatch === "mismatch";
@@ -2421,7 +2427,10 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
       num("aiScore"),
       data["nameMatch"] === "ok" || data["nameMatch"] === "mismatch" ? data["nameMatch"] : void 0,
       text("officialName"),
-      toOfficialAddress(data["officialAddress"])
+      toOfficialAddress(data["officialAddress"]),
+      text("taxNumberType"),
+      text("taxNumberLabel"),
+      data["taxNumberSource"] === "vat_id" || data["taxNumberSource"] === "company_website" ? data["taxNumberSource"] : void 0
     );
   }
   toArray() {
@@ -2446,7 +2455,10 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
       aiScore: this.aiScore ?? null,
       nameMatch: this.nameMatch ?? null,
       officialName: this.officialName ?? null,
-      officialAddress: this.officialAddress ?? null
+      officialAddress: this.officialAddress ?? null,
+      taxNumberType: this.taxNumberType ?? null,
+      taxNumberLabel: this.taxNumberLabel ?? null,
+      taxNumberSource: this.taxNumberSource ?? null
     };
   }
 };
@@ -3454,6 +3466,123 @@ var VatValidationAddressInput = class _VatValidationAddressInput {
   }
 };
 
+// src/dto/LocalTaxNumberReport.ts
+var LocalTaxNumberRow = class _LocalTaxNumberRow {
+  constructor(companyName, requestedName, country, vatNumber, vatStatus, taxNumber, taxNumberName, taxNumberSource, source, checkedAt, checkId) {
+    this.companyName = companyName;
+    this.requestedName = requestedName;
+    this.country = country;
+    this.vatNumber = vatNumber;
+    this.vatStatus = vatStatus;
+    this.taxNumber = taxNumber;
+    this.taxNumberName = taxNumberName;
+    this.taxNumberSource = taxNumberSource;
+    this.source = source;
+    this.checkedAt = checkedAt;
+    this.checkId = checkId;
+  }
+  companyName;
+  requestedName;
+  country;
+  vatNumber;
+  vatStatus;
+  taxNumber;
+  taxNumberName;
+  taxNumberSource;
+  source;
+  checkedAt;
+  checkId;
+  /** One CSV row keyed by column name. */
+  static fromArray(data) {
+    const cell = (key) => {
+      const value = data[key];
+      const trimmed = typeof value === "string" ? value.trim() : "";
+      return trimmed === "" ? null : trimmed;
+    };
+    return new _LocalTaxNumberRow(
+      cell("companyName"),
+      cell("requestedName"),
+      cell("country"),
+      cell("vatNumber"),
+      cell("vatStatus"),
+      cell("taxNumber"),
+      cell("taxNumberName"),
+      cell("taxNumberSource"),
+      cell("source"),
+      cell("checkedAt"),
+      cell("checkId")
+    );
+  }
+  toArray() {
+    return {
+      companyName: this.companyName,
+      requestedName: this.requestedName,
+      country: this.country,
+      vatNumber: this.vatNumber,
+      vatStatus: this.vatStatus,
+      taxNumber: this.taxNumber,
+      taxNumberName: this.taxNumberName,
+      taxNumberSource: this.taxNumberSource,
+      source: this.source,
+      checkedAt: this.checkedAt,
+      checkId: this.checkId
+    };
+  }
+};
+function parseCsvRecords(csv) {
+  const records = [];
+  let record = [];
+  let cell = "";
+  let quoted = false;
+  for (let i = 0; i < csv.length; i++) {
+    const ch = csv[i];
+    if (quoted) {
+      if (ch === '"') {
+        if (csv[i + 1] === '"') {
+          cell += '"';
+          i++;
+        } else {
+          quoted = false;
+        }
+      } else {
+        cell += ch;
+      }
+    } else if (ch === '"') {
+      quoted = true;
+    } else if (ch === ",") {
+      record.push(cell);
+      cell = "";
+    } else if (ch === "\n" || ch === "\r") {
+      if (ch === "\r" && csv[i + 1] === "\n") i++;
+      record.push(cell);
+      records.push(record);
+      record = [];
+      cell = "";
+    } else {
+      cell += ch;
+    }
+  }
+  if (cell !== "" || record.length > 0) {
+    record.push(cell);
+    records.push(record);
+  }
+  return records.filter((r) => !(r.length === 1 && r[0] === ""));
+}
+function parseLocalTaxNumbersCsv(csv) {
+  const [header, ...records] = parseCsvRecords(csv.replace(/^\uFEFF/, ""));
+  if (!header) {
+    return [];
+  }
+  const names = header.map((name) => name.trim());
+  return records.map((cells) => {
+    const row = {};
+    names.forEach((name, i) => {
+      row[name] = cells[i];
+    });
+    return LocalTaxNumberRow.fromArray(row);
+  });
+}
+
 // src/endpoints/VatEndpoint.ts
 var DATE_REGEX2 = /^\d{4}-\d{2}-\d{2}$/;
 var VatEndpoint = class {
@@ -3564,6 +3693,69 @@ var VatEndpoint = class {
       return new Uint8Array(buffer);
     });
   }
+  /**
+   * Local tax numbers report as raw CSV (UTF-8 with BOM, comma-separated): every company checked —
+   * single and bulk VAT checks and Smart Enrichment lookups — once, with its local tax number
+   * (taxNumber, taxNumberName, taxNumberSource). Digit-only taxNumber cells carry a leading TAB so
+   * Excel keeps them as text; `localTaxNumbers()` strips it for you.
+   */
+  async localTaxNumbersCsv(options = {}) {
+    const params = this.localTaxNumbersParams(options);
+    if (options.onlyWithTaxNumber !== void 0) {
+      params.set("only_with_tax_number", options.onlyWithTaxNumber ? "1" : "0");
+    }
+    const url = this.withQuery(`${this.baseUrl}/reports/local-tax-numbers`, params);
+    return withRetries(this.retryPolicy, "Local tax numbers report", async () => {
+      const headers = this.buildHeaders();
+      delete headers["Content-Type"];
+      headers["Accept"] = "text/csv, application/json";
+      const response = await this.httpClient.request("GET", url, { headers });
+      if (response.status === 422) {
+        await this.parseJsonResponse(response);
+      }
+      const text = new TextDecoder("utf-8", { ignoreBOM: true }).decode(await response.arrayBuffer());
+      if (!response.ok) {
+        throw new HttpException(
+          describeApiError(text, response.status),
+          response.status,
+          text,
+          {},
+          response.headers.get("retry-after")
+        );
+      }
+      return text;
+    });
+  }
+  /** The local tax numbers report, parsed: one row per company (same filters as `localTaxNumbersCsv()`). */
+  async localTaxNumbers(options = {}) {
+    return parseLocalTaxNumbersCsv(await this.localTaxNumbersCsv(options));
+  }
+  /** How many companies the report would list for the filters, and how many have a tax number. */
+  async localTaxNumbersSummary(options = {}) {
+    const url = this.withQuery(
+      `${this.baseUrl}/reports/local-tax-numbers/summary`,
+      this.localTaxNumbersParams(options)
+    );
+    return withRetries(this.retryPolicy, "Local tax numbers summary", async () => {
+      const response = await this.sendRequest("GET", url);
+      const data = await this.parseJsonResponse(response);
+      const count = (key) => typeof data[key] === "number" ? data[key] : 0;
+      return { companies: count("companies"), withTaxNumber: count("withTaxNumber") };
+    });
+  }
+  localTaxNumbersParams(options) {
+    const params = new URLSearchParams();
+    if (options.dateFrom !== void 0) params.set("date_from", this.formatDate(options.dateFrom));
+    if (options.dateTo !== void 0) params.set("date_to", this.formatDate(options.dateTo));
+    for (const country of options.countries ?? []) {
+      params.append("countries[]", country.trim().toUpperCase());
+    }
+    return params;
+  }
+  withQuery(url, params) {
+    const queryString = params.toString();
+    return queryString ? `${url}?${queryString}` : url;
+  }
   buildHeaders() {
     const headers = {
       "Content-Type": "application/json",
@@ -3724,7 +3916,7 @@ var AuthRetryHttpClient = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "1.6.0";
+var SDK_VERSION = "1.7.0";
 
 // src/http/SdkVersionHttpClient.ts
 var SDK_VERSION_HEADER = "X-Taxora-SDK-Version";
@@ -3937,6 +4129,7 @@ export {
   ImportResult,
   InMemoryTokenStorage,
   Language,
+  LocalTaxNumberRow,
   LoginIdentifier,
   NorwegianOrgNumber,
   PeppolLookupResult,
@@ -3989,6 +4182,7 @@ export {
   generateWebhookSignatureHeader,
   getBaseUrl,
   getFailedVatStates,
+  parseLocalTaxNumbersCsv,
   parseWebhookSignatureHeader,
   toComplianceDocumentType,
   toComplianceEnrollmentStatus,