@taxora/sdk 1.3.0 → 1.5.0

package/dist/index.d.cts

@@ -1092,6 +1092,32 @@ type SmartEnrichmentMode = (typeof SmartEnrichmentMode)[keyof typeof SmartEnrich
 declare function toSmartEnrichmentMode(value: unknown): SmartEnrichmentMode | undefined;
 declare function describeSmartEnrichmentMode(mode: SmartEnrichmentMode): string;
 
+/**
+ * Why a VAT number the research DID find was not returned as the result.
+ *
+ * Only appears on `not_found` results (see `SmartEnrichmentResource.rejectedCandidates`), so
+ * "a number was found, but the tax authority calls it invalid" can be told apart from "nothing
+ * was found at all".
+ */
+declare const SmartEnrichmentRejectionReason: {
+    /** The tax authority reports the number as not (or no longer) valid. */
+    readonly VAT_INVALID: "vat_invalid";
+    /** The number is valid, but registered to a different company. */
+    readonly NAME_MISMATCH: "name_mismatch";
+    /** The number could not be tied to the requested company. */
+    readonly UNBOUND: "unbound";
+    /** The number could not be checked against the tax authority. */
+    readonly UNVERIFIED: "unverified";
+    /** Rejected for another reason. */
+    readonly REJECTED: "rejected";
+    /** A reason this SDK version does not know yet. */
+    readonly UNKNOWN: "unknown";
+};
+type SmartEnrichmentRejectionReason = (typeof SmartEnrichmentRejectionReason)[keyof typeof SmartEnrichmentRejectionReason];
+/** Tolerant coercion: unrecognized values become `unknown` instead of throwing. */
+declare function toSmartEnrichmentRejectionReason(value: unknown): SmartEnrichmentRejectionReason;
+declare function describeSmartEnrichmentRejectionReason(reason: SmartEnrichmentRejectionReason): string;
+
 declare const SmartEnrichmentStatus: {
     readonly FOUND: "found";
     readonly NO_VAT_EXISTS: "no_vat_exists";
@@ -1135,6 +1161,11 @@ interface SmartEnrichmentAddressQuality {
     cityMatchesPostalCode: boolean | null;
     warnings: string[];
 }
+/** A VAT number the research named, but the official check threw out. */
+interface SmartEnrichmentRejectedCandidate {
+    vatNumber: string;
+    reason: SmartEnrichmentRejectionReason;
+}
 /**
  * Result of resolving one reverse-VAT lookup (company name + address → VAT + confidence).
  * Mirrors the API response item shape (camelCase keys).
@@ -1158,6 +1189,28 @@ declare class SmartEnrichmentResource {
      */
     readonly providerVerdicts: SmartEnrichmentProviderVerdict[];
     readonly addressQuality: SmartEnrichmentAddressQuality | undefined;
+    /**
+     * Only on `not_found`: VAT numbers the research DID find but the official check threw out —
+     * e.g. one the tax authority reports as invalid. Lets you tell "found one, it is invalid"
+     * apart from "found nothing". Empty for every other status.
+     */
+    readonly rejectedCandidates: SmartEnrichmentRejectedCandidate[];
+    /**
+     * Only on `found`: the web page the VAT number was read from — usually the company's own
+     * Impressum / legal notice. Undefined when it came from Taxora's own data or a register.
+     */
+    readonly sourceUrl: string | undefined;
+    /**
+     * Only on `found`: the PERSON the tax authority has the VAT ID under, when that is not the
+     * trading name — typical for a German sole proprietorship (e.K.). `matchedCompanyName` stays
+     * the trading name.
+     */
+    readonly registeredOwner: string | undefined;
+    /**
+     * 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.
+     */
+    readonly sourceUrls: string[];
     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, 
@@ -1168,7 +1221,31 @@ declare class SmartEnrichmentResource {
      * (complex mode, or a fallback). Two entries reporting the same vatNumber is the strongest
      * confirmation this layer produces.
      */
-    providerVerdicts?: SmartEnrichmentProviderVerdict[], addressQuality?: SmartEnrichmentAddressQuality | undefined);
+    providerVerdicts?: SmartEnrichmentProviderVerdict[], addressQuality?: SmartEnrichmentAddressQuality | undefined, 
+    /**
+     * Only on `not_found`: VAT numbers the research DID find but the official check threw out —
+     * e.g. one the tax authority reports as invalid. Lets you tell "found one, it is invalid"
+     * apart from "found nothing". Empty for every other status.
+     */
+    rejectedCandidates?: SmartEnrichmentRejectedCandidate[], 
+    /**
+     * Only on `found`: the web page the VAT number was read from — usually the company's own
+     * Impressum / legal notice. Undefined when it came from Taxora's own data or a register.
+     */
+    sourceUrl?: string | undefined, 
+    /**
+     * Only on `found`: the PERSON the tax authority has the VAT ID under, when that is not the
+     * trading name — typical for a German sole proprietorship (e.K.). `matchedCompanyName` stays
+     * the trading name.
+     */
+    registeredOwner?: string | undefined, 
+    /**
+     * 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[]);
+    /** True when a VAT number was found but rejected by the official check. */
+    hasRejectedCandidates(): boolean;
     static fromArray(data: Record<string, unknown>): SmartEnrichmentResource;
     toArray(): Record<string, unknown>;
 }
@@ -1897,4 +1974,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, 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, describeSmartEnrichmentStatus, describeVatState, generateWebhookSignatureHeader, getBaseUrl, getFailedVatStates, parseWebhookSignatureHeader, toComplianceDocumentType, toComplianceEnrollmentStatus, toComplianceService, toComplianceTaxReportState, toComplianceTransactionState, toComplianceTransactionType, toPeppolLookupStatus, toSmartEnrichmentMode, 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, 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 };

package/dist/index.d.ts

@@ -1092,6 +1092,32 @@ type SmartEnrichmentMode = (typeof SmartEnrichmentMode)[keyof typeof SmartEnrich
 declare function toSmartEnrichmentMode(value: unknown): SmartEnrichmentMode | undefined;
 declare function describeSmartEnrichmentMode(mode: SmartEnrichmentMode): string;
 
+/**
+ * Why a VAT number the research DID find was not returned as the result.
+ *
+ * Only appears on `not_found` results (see `SmartEnrichmentResource.rejectedCandidates`), so
+ * "a number was found, but the tax authority calls it invalid" can be told apart from "nothing
+ * was found at all".
+ */
+declare const SmartEnrichmentRejectionReason: {
+    /** The tax authority reports the number as not (or no longer) valid. */
+    readonly VAT_INVALID: "vat_invalid";
+    /** The number is valid, but registered to a different company. */
+    readonly NAME_MISMATCH: "name_mismatch";
+    /** The number could not be tied to the requested company. */
+    readonly UNBOUND: "unbound";
+    /** The number could not be checked against the tax authority. */
+    readonly UNVERIFIED: "unverified";
+    /** Rejected for another reason. */
+    readonly REJECTED: "rejected";
+    /** A reason this SDK version does not know yet. */
+    readonly UNKNOWN: "unknown";
+};
+type SmartEnrichmentRejectionReason = (typeof SmartEnrichmentRejectionReason)[keyof typeof SmartEnrichmentRejectionReason];
+/** Tolerant coercion: unrecognized values become `unknown` instead of throwing. */
+declare function toSmartEnrichmentRejectionReason(value: unknown): SmartEnrichmentRejectionReason;
+declare function describeSmartEnrichmentRejectionReason(reason: SmartEnrichmentRejectionReason): string;
+
 declare const SmartEnrichmentStatus: {
     readonly FOUND: "found";
     readonly NO_VAT_EXISTS: "no_vat_exists";
@@ -1135,6 +1161,11 @@ interface SmartEnrichmentAddressQuality {
     cityMatchesPostalCode: boolean | null;
     warnings: string[];
 }
+/** A VAT number the research named, but the official check threw out. */
+interface SmartEnrichmentRejectedCandidate {
+    vatNumber: string;
+    reason: SmartEnrichmentRejectionReason;
+}
 /**
  * Result of resolving one reverse-VAT lookup (company name + address → VAT + confidence).
  * Mirrors the API response item shape (camelCase keys).
@@ -1158,6 +1189,28 @@ declare class SmartEnrichmentResource {
      */
     readonly providerVerdicts: SmartEnrichmentProviderVerdict[];
     readonly addressQuality: SmartEnrichmentAddressQuality | undefined;
+    /**
+     * Only on `not_found`: VAT numbers the research DID find but the official check threw out —
+     * e.g. one the tax authority reports as invalid. Lets you tell "found one, it is invalid"
+     * apart from "found nothing". Empty for every other status.
+     */
+    readonly rejectedCandidates: SmartEnrichmentRejectedCandidate[];
+    /**
+     * Only on `found`: the web page the VAT number was read from — usually the company's own
+     * Impressum / legal notice. Undefined when it came from Taxora's own data or a register.
+     */
+    readonly sourceUrl: string | undefined;
+    /**
+     * Only on `found`: the PERSON the tax authority has the VAT ID under, when that is not the
+     * trading name — typical for a German sole proprietorship (e.K.). `matchedCompanyName` stays
+     * the trading name.
+     */
+    readonly registeredOwner: string | undefined;
+    /**
+     * 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.
+     */
+    readonly sourceUrls: string[];
     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, 
@@ -1168,7 +1221,31 @@ declare class SmartEnrichmentResource {
      * (complex mode, or a fallback). Two entries reporting the same vatNumber is the strongest
      * confirmation this layer produces.
      */
-    providerVerdicts?: SmartEnrichmentProviderVerdict[], addressQuality?: SmartEnrichmentAddressQuality | undefined);
+    providerVerdicts?: SmartEnrichmentProviderVerdict[], addressQuality?: SmartEnrichmentAddressQuality | undefined, 
+    /**
+     * Only on `not_found`: VAT numbers the research DID find but the official check threw out —
+     * e.g. one the tax authority reports as invalid. Lets you tell "found one, it is invalid"
+     * apart from "found nothing". Empty for every other status.
+     */
+    rejectedCandidates?: SmartEnrichmentRejectedCandidate[], 
+    /**
+     * Only on `found`: the web page the VAT number was read from — usually the company's own
+     * Impressum / legal notice. Undefined when it came from Taxora's own data or a register.
+     */
+    sourceUrl?: string | undefined, 
+    /**
+     * Only on `found`: the PERSON the tax authority has the VAT ID under, when that is not the
+     * trading name — typical for a German sole proprietorship (e.K.). `matchedCompanyName` stays
+     * the trading name.
+     */
+    registeredOwner?: string | undefined, 
+    /**
+     * 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[]);
+    /** True when a VAT number was found but rejected by the official check. */
+    hasRejectedCandidates(): boolean;
     static fromArray(data: Record<string, unknown>): SmartEnrichmentResource;
     toArray(): Record<string, unknown>;
 }
@@ -1897,4 +1974,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, 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, describeSmartEnrichmentStatus, describeVatState, generateWebhookSignatureHeader, getBaseUrl, getFailedVatStates, parseWebhookSignatureHeader, toComplianceDocumentType, toComplianceEnrollmentStatus, toComplianceService, toComplianceTaxReportState, toComplianceTransactionState, toComplianceTransactionType, toPeppolLookupStatus, toSmartEnrichmentMode, 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, 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 };

package/dist/index.js

@@ -2224,6 +2224,43 @@ function describeSmartEnrichmentMode(mode) {
   return DESCRIPTIONS8[mode];
 }
 
+// src/enums/SmartEnrichmentRejectionReason.ts
+var SmartEnrichmentRejectionReason = {
+  /** The tax authority reports the number as not (or no longer) valid. */
+  VAT_INVALID: "vat_invalid",
+  /** The number is valid, but registered to a different company. */
+  NAME_MISMATCH: "name_mismatch",
+  /** The number could not be tied to the requested company. */
+  UNBOUND: "unbound",
+  /** The number could not be checked against the tax authority. */
+  UNVERIFIED: "unverified",
+  /** Rejected for another reason. */
+  REJECTED: "rejected",
+  /** A reason this SDK version does not know yet. */
+  UNKNOWN: "unknown"
+};
+var VALUES9 = Object.values(SmartEnrichmentRejectionReason);
+function toSmartEnrichmentRejectionReason(value) {
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (VALUES9.includes(normalized)) {
+      return normalized;
+    }
+  }
+  return SmartEnrichmentRejectionReason.UNKNOWN;
+}
+var DESCRIPTIONS9 = {
+  [SmartEnrichmentRejectionReason.VAT_INVALID]: "The tax authority reports the VAT number as invalid.",
+  [SmartEnrichmentRejectionReason.NAME_MISMATCH]: "The VAT number is registered to a different company.",
+  [SmartEnrichmentRejectionReason.UNBOUND]: "The VAT number could not be tied to the requested company.",
+  [SmartEnrichmentRejectionReason.UNVERIFIED]: "The VAT number could not be verified with the tax authority.",
+  [SmartEnrichmentRejectionReason.REJECTED]: "The VAT number was not confirmed.",
+  [SmartEnrichmentRejectionReason.UNKNOWN]: "Unknown rejection reason."
+};
+function describeSmartEnrichmentRejectionReason(reason) {
+  return DESCRIPTIONS9[reason];
+}
+
 // src/enums/SmartEnrichmentStatus.ts
 var SmartEnrichmentStatus = {
   FOUND: "found",
@@ -2235,17 +2272,17 @@ var SmartEnrichmentStatus = {
   FAILED: "failed",
   UNKNOWN: "unknown"
 };
-var VALUES9 = Object.values(SmartEnrichmentStatus);
+var VALUES10 = Object.values(SmartEnrichmentStatus);
 function toSmartEnrichmentStatus(value) {
   if (typeof value === "string") {
     const normalized = value.trim().toLowerCase();
-    if (VALUES9.includes(normalized)) {
+    if (VALUES10.includes(normalized)) {
       return normalized;
     }
   }
   return SmartEnrichmentStatus.UNKNOWN;
 }
-var DESCRIPTIONS9 = {
+var DESCRIPTIONS10 = {
   [SmartEnrichmentStatus.FOUND]: "A VAT number was resolved and confirmed.",
   [SmartEnrichmentStatus.NO_VAT_EXISTS]: "The company was identified but has no VAT number.",
   [SmartEnrichmentStatus.NOT_FOUND]: "No sufficiently-confident match could be resolved.",
@@ -2256,12 +2293,30 @@ var DESCRIPTIONS9 = {
   [SmartEnrichmentStatus.UNKNOWN]: "Unknown status."
 };
 function describeSmartEnrichmentStatus(status) {
-  return DESCRIPTIONS9[status];
+  return DESCRIPTIONS10[status];
 }
 
 // src/dto/SmartEnrichmentResource.ts
+function toRejectedCandidates(value) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  const candidates = [];
+  for (const entry of value) {
+    if (typeof entry !== "object" || entry === null) {
+      continue;
+    }
+    const record = entry;
+    const vatNumber = typeof record["vatNumber"] === "string" ? record["vatNumber"].trim() : "";
+    if (vatNumber === "") {
+      continue;
+    }
+    candidates.push({ vatNumber, reason: toSmartEnrichmentRejectionReason(record["reason"]) });
+  }
+  return candidates;
+}
 var SmartEnrichmentResource = class _SmartEnrichmentResource {
-  constructor(status, vatNumber, vatType, confidence, matchedCompanyName, matchedAddress, country, source, mode = void 0, providerVerdicts = [], addressQuality = 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 = []) {
     this.status = status;
     this.vatNumber = vatNumber;
     this.vatType = vatType;
@@ -2273,6 +2328,10 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
     this.mode = mode;
     this.providerVerdicts = providerVerdicts;
     this.addressQuality = addressQuality;
+    this.rejectedCandidates = rejectedCandidates;
+    this.sourceUrl = sourceUrl;
+    this.registeredOwner = registeredOwner;
+    this.sourceUrls = sourceUrls;
   }
   status;
   vatNumber;
@@ -2285,11 +2344,26 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
   mode;
   providerVerdicts;
   addressQuality;
+  rejectedCandidates;
+  sourceUrl;
+  registeredOwner;
+  sourceUrls;
+  /** True when a VAT number was found but rejected by the official check. */
+  hasRejectedCandidates() {
+    return this.rejectedCandidates.length > 0;
+  }
   static fromArray(data) {
     const str = (key) => {
       const v = data[key];
       return typeof v === "string" ? v : void 0;
     };
+    const text = (key) => {
+      const v = str(key)?.trim();
+      return v ? v : void 0;
+    };
+    const isWebUrl = (value) => typeof value === "string" && /^https?:\/\/\S+$/i.test(value.trim());
+    const url = text("sourceUrl");
+    const urls = data["sourceUrls"];
     const num = (key) => {
       const v = data[key];
       return typeof v === "number" ? v : void 0;
@@ -2307,7 +2381,11 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
       str("source"),
       toSmartEnrichmentMode(data["mode"]),
       Array.isArray(verdicts) ? verdicts.filter((v) => typeof v === "object" && v !== null) : [],
-      typeof quality === "object" && quality !== null ? quality : void 0
+      typeof quality === "object" && quality !== null ? quality : void 0,
+      toRejectedCandidates(data["rejectedCandidates"]),
+      url && isWebUrl(url) ? url : void 0,
+      text("registeredOwner"),
+      Array.isArray(urls) ? [...new Set(urls.filter(isWebUrl).map((u) => u.trim()))] : []
     );
   }
   toArray() {
@@ -2322,7 +2400,11 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
       source: this.source ?? null,
       mode: this.mode ?? null,
       providerVerdicts: this.providerVerdicts,
-      addressQuality: this.addressQuality ?? null
+      addressQuality: this.addressQuality ?? null,
+      rejectedCandidates: this.rejectedCandidates.map((c) => ({ vatNumber: c.vatNumber, reason: c.reason })),
+      sourceUrl: this.sourceUrl ?? null,
+      registeredOwner: this.registeredOwner ?? null,
+      sourceUrls: this.sourceUrls
     };
   }
 };
@@ -2861,14 +2943,14 @@ var VatState = {
 function getFailedVatStates() {
   return [VatState.INVALID, VatState.FRAUD];
 }
-var DESCRIPTIONS10 = {
+var DESCRIPTIONS11 = {
   [VatState.VALID]: "The VAT number is valid and active.",
   [VatState.INVALID]: "The VAT number is invalid or not registered.",
   [VatState.FRAUD]: "The VAT number has been flagged as potentially fraudulent.",
   [VatState.UNKNOWN]: "The VAT number state could not be determined."
 };
 function describeVatState(state) {
-  return DESCRIPTIONS10[state];
+  return DESCRIPTIONS11[state];
 }
 
 // src/dto/CompanyAddress.ts
@@ -3600,7 +3682,7 @@ var AuthRetryHttpClient = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "1.3.0";
+var SDK_VERSION = "1.5.0";
 
 // src/http/SdkVersionHttpClient.ts
 var SDK_VERSION_HEADER = "X-Taxora-SDK-Version";
@@ -3829,6 +3911,7 @@ export {
   SmartEnrichmentHistoryRow,
   SmartEnrichmentJob,
   SmartEnrichmentMode,
+  SmartEnrichmentRejectionReason,
   SmartEnrichmentResource,
   SmartEnrichmentStatistics,
   SmartEnrichmentStatus,
@@ -3858,6 +3941,7 @@ export {
   describeComplianceTransactionType,
   describePeppolLookupStatus,
   describeSmartEnrichmentMode,
+  describeSmartEnrichmentRejectionReason,
   describeSmartEnrichmentStatus,
   describeVatState,
   generateWebhookSignatureHeader,
@@ -3872,6 +3956,7 @@ export {
   toComplianceTransactionType,
   toPeppolLookupStatus,
   toSmartEnrichmentMode,
+  toSmartEnrichmentRejectionReason,
   toSmartEnrichmentStatus,
   verifyWebhookSignature
 };