@taxora/sdk 1.5.0 → 1.7.0

package/dist/index.d.cts

@@ -1166,6 +1166,15 @@ 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;
+    postal_code?: string;
+    city?: string;
+    country?: string;
+}
 /**
  * Result of resolving one reverse-VAT lookup (company name + address → VAT + confidence).
  * Mirrors the API response item shape (camelCase keys).
@@ -1211,6 +1220,37 @@ declare class SmartEnrichmentResource {
      * pass that found the same number contributes its page. At most 5.
      */
     readonly sourceUrls: string[];
+    /**
+     * 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. */
+    readonly vatValid: boolean | undefined;
+    /** Only on `found`: 0–100, the requested name against the register's; undefined when no name was disclosed. */
+    readonly aiScore: number | undefined;
+    /**
+     * Only on `found`: 'ok' (name matches the register) or 'mismatch' (it does not — another company,
+     * unless `registeredOwner` is set: then update your record).
+     */
+    readonly nameMatch: 'ok' | 'mismatch' | undefined;
+    /** Only on `found`: the name the register has the number under. */
+    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, 
@@ -1243,7 +1283,40 @@ declare class SmartEnrichmentResource {
      * Only on `found`: every page the VAT number was read from, `sourceUrl` first — each research
      * pass that found the same number contributes its page. At most 5.
      */
-    sourceUrls?: string[]);
+    sourceUrls?: string[], 
+    /**
+     * 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. */
+    vatValid?: boolean | undefined, 
+    /** Only on `found`: 0–100, the requested name against the register's; undefined when no name was disclosed. */
+    aiScore?: number | undefined, 
+    /**
+     * Only on `found`: 'ok' (name matches the register) or 'mismatch' (it does not — another company,
+     * unless `registeredOwner` is set: then update your record).
+     */
+    nameMatch?: 'ok' | 'mismatch' | undefined, 
+    /** 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, 
+    /** 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. */
     hasRejectedCandidates(): boolean;
     static fromArray(data: Record<string, unknown>): SmartEnrichmentResource;
@@ -1673,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";
@@ -1697,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;
@@ -1974,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 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,15 @@ 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;
+    postal_code?: string;
+    city?: string;
+    country?: string;
+}
 /**
  * Result of resolving one reverse-VAT lookup (company name + address → VAT + confidence).
  * Mirrors the API response item shape (camelCase keys).
@@ -1211,6 +1220,37 @@ declare class SmartEnrichmentResource {
      * pass that found the same number contributes its page. At most 5.
      */
     readonly sourceUrls: string[];
+    /**
+     * 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. */
+    readonly vatValid: boolean | undefined;
+    /** Only on `found`: 0–100, the requested name against the register's; undefined when no name was disclosed. */
+    readonly aiScore: number | undefined;
+    /**
+     * Only on `found`: 'ok' (name matches the register) or 'mismatch' (it does not — another company,
+     * unless `registeredOwner` is set: then update your record).
+     */
+    readonly nameMatch: 'ok' | 'mismatch' | undefined;
+    /** Only on `found`: the name the register has the number under. */
+    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, 
@@ -1243,7 +1283,40 @@ declare class SmartEnrichmentResource {
      * Only on `found`: every page the VAT number was read from, `sourceUrl` first — each research
      * pass that found the same number contributes its page. At most 5.
      */
-    sourceUrls?: string[]);
+    sourceUrls?: string[], 
+    /**
+     * 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. */
+    vatValid?: boolean | undefined, 
+    /** Only on `found`: 0–100, the requested name against the register's; undefined when no name was disclosed. */
+    aiScore?: number | undefined, 
+    /**
+     * Only on `found`: 'ok' (name matches the register) or 'mismatch' (it does not — another company,
+     * unless `registeredOwner` is set: then update your record).
+     */
+    nameMatch?: 'ok' | 'mismatch' | undefined, 
+    /** 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, 
+    /** 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. */
     hasRejectedCandidates(): boolean;
     static fromArray(data: Record<string, unknown>): SmartEnrichmentResource;
@@ -1673,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";
@@ -1697,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;
@@ -1974,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 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 };