@timbro/invoices 0.13.0 → 0.14.0

package/dist/generated/sdk.gen.js

@@ -1,5 +1,5 @@
 // This file is auto-generated by @hey-api/openapi-ts
-import { zAcceptInvitationResponse, zApproveDirectConnectionRequestResponse, zAuthorizeAuthorityRejectedReplacementResponse, zBeginVercelSourceProviderInstallationResponse, zCancelDirectConnectionRequestResponse, zCloseWorkspaceSessionResponse, zCompleteLegalIssuerProfileResponse, zCompleteSourceConnectionActivationVerificationResponse, zCompleteVercelSourceProviderInstallationResponse, zConfirmDirectConnectionResponse, zCreateCertificateCustodyBindingResponse, zCreateDirectConnectionRequestResponse, zCreateFiscalOperationResponse, zCreateHostedInvoiceResponse, zCreateHostedTenantResponse, zCreateHostedTenantWebhookSecretRotationResponse, zCreateInvoiceDeliveryResponse, zCreateInvoiceResponse, zCreateOrganizationResponse, zCreateSourceConnectionResponse, zDeclareReceptionMountResponse, zDownloadHostedInvoicePdfResponse, zDownloadHostedInvoiceXmlResponse, zDownloadInvoicePdfResponse, zDownloadInvoiceReceiptPdfResponse, zDownloadInvoiceXmlResponse, zFindFiscalArtifactResponse, zFindFiscalOperationBySourceResponse, zFindFiscalOperationResponse, zGetSourceReceivedDocumentResponse, zHealthLiveResponse, zHealthReadyResponse, zImportHostedCertificateCustodyResponse, zInspectFiscalNumberAuthorizationHistoryResponse, zInviteMemberResponse, zIssueHostedInvoiceCredentialResponse, zListAuthorizedVercelProjectsResponse, zListCertificateCustodyBindingsResponse, zListFiscalOperationsResponse, zListHostedInvoicesResponse, zListInvitationsResponse, zListInvoicesResponse, zListLegalIssuersResponse, zListOrganizationFiscalOperationsResponse, zListReceivedDocumentsResponse, zListSourceConnectionsResponse, zListSourceProviderAuthorizationsResponse, zListSourceReceivedDocumentsResponse, zListWebhookDeliveriesResponse, zOpenWorkspaceSessionResponse, zPollDirectConnectionRequestResponse, zPreviewDirectConnectionRequestResponse, zPreviewHostedInvoiceResponse, zPreviewInvoiceResponse, zProblemBody, zReadAuditEventsResponse, zReadAuthorizedVercelProjectQualificationResponse, zReadCertificateCustodyBindingResponse, zReadCurrentUserAccountResponse, zReadElectronicFiscalDocumentEligibilityResponse, zReadFiscalOperationTimingResponse, zReadOnboardingLegalIssuerIdentityResponse, zReadOnboardingReadinessResponse, zReadOnboardingServiceScopeResponse, zReadOrganizationFiscalOperationResponse, zReadReceivedDocumentResponse, zReadSourceConnectionResponse, zReadSourceProviderAuthorizationResponse, zRecordCommercialResponseResponse, zRecoverSourceConnectionActivationResponse, zRegisterFiscalNumberAuthorizationResponse, zRegisterLegalIssuerResponse, zRegisterUserAccountResponse, zRegisterWebhookEndpointResponse, zReleaseHostedTenantResponse, zReplaceHostedInvoiceResponse, zReplaceInvoiceResponse, zReplayWebhookEventsResponse, zRespondToReceivedDocumentResponse, zRetrieveFiscalDeliveryPrintedRepresentationResponse, zRetrieveHostedCertificationTestSetResponse, zRetrieveHostedInvoiceResponse, zRetrieveHostedIssuanceReadinessResponse, zRetrieveInvoiceDeliveryResponse, zRetrieveInvoiceReceiptResponse, zRetrieveInvoiceResponse, zRetrieveIssuanceReadinessResponse, zRetrieveWorkspaceFiscalArtifactResponse, zRevokeCertificateCustodyCertificateVersionResponse, zShareHostedInvoiceReceiptResponse, zShareInvoiceReceiptResponse, zUpdateOnboardingLegalIssuerIdentityResponse, zUpdateOnboardingServiceScopeResponse, zUploadHostedCertificationTestSetResponse, } from "./zod-response.gen.js";
+import { zAcceptInvitationResponse, zApproveDirectConnectionRequestResponse, zAuthorizeAuthorityRejectedReplacementResponse, zBeginVercelSourceProviderInstallationResponse, zCancelDirectConnectionRequestResponse, zCloseWorkspaceSessionResponse, zCompleteLegalIssuerProfileResponse, zCompleteSourceConnectionActivationVerificationResponse, zCompleteVercelSourceProviderInstallationResponse, zConfirmDirectConnectionResponse, zCreateCertificateCustodyBindingResponse, zCreateDirectConnectionRequestResponse, zCreateFiscalOperationResponse, zCreateHostedInvoiceResponse, zCreateHostedTenantResponse, zCreateHostedTenantWebhookSecretRotationResponse, zCreateInvoiceDeliveryResponse, zCreateInvoiceResponse, zCreateOrganizationResponse, zCreateSourceConnectionResponse, zDeclareReceptionMountResponse, zDownloadHostedInvoicePdfResponse, zDownloadHostedInvoiceXmlResponse, zDownloadInvoicePdfResponse, zDownloadInvoiceReceiptPdfResponse, zDownloadInvoiceXmlResponse, zFindFiscalArtifactResponse, zFindFiscalOperationBySourceResponse, zFindFiscalOperationResponse, zGetSourceReceivedDocumentResponse, zHealthLiveResponse, zHealthReadyResponse, zImportHostedCertificateCustodyResponse, zInspectFiscalNumberAuthorizationHistoryResponse, zInviteMemberResponse, zIssueHostedInvoiceCredentialResponse, zListAuthorizedVercelProjectsResponse, zListCertificateCustodyBindingsResponse, zListFiscalOperationsResponse, zListHostedInvoicesResponse, zListInvitationsResponse, zListInvoicesResponse, zListLegalIssuersResponse, zListOrganizationFiscalOperationsResponse, zListReceivedDocumentsResponse, zListSourceConnectionsResponse, zListSourceProviderAuthorizationsResponse, zListSourceReceivedDocumentsResponse, zListWebhookDeliveriesResponse, zOpenWorkspaceSessionResponse, zPollDirectConnectionRequestResponse, zPreviewDirectConnectionRequestResponse, zPreviewHostedInvoiceResponse, zPreviewInvoiceResponse, zProblemBody, zReadAuditEventsResponse, zReadAuthorizedVercelProjectQualificationResponse, zReadCertificateCustodyBindingResponse, zReadCurrentUserAccountResponse, zReadElectronicFiscalDocumentEligibilityResponse, zReadFiscalOperationTimingResponse, zReadOnboardingLegalIssuerIdentityResponse, zReadOnboardingReadinessResponse, zReadOnboardingServiceScopeResponse, zReadOrganizationFiscalOperationResponse, zReadReceivedDocumentResponse, zReadSourceConnectionResponse, zReadSourceProviderAuthorizationResponse, zRecordCommercialResponseResponse, zRecoverSourceConnectionActivationResponse, zRegisterFiscalNumberAuthorizationResponse, zRegisterLegalIssuerResponse, zRegisterUserAccountResponse, zRegisterWebhookEndpointResponse, zReleaseHostedTenantResponse, zRepairHostedTenantSourceConnectionResponse, zReplaceHostedInvoiceResponse, zReplaceInvoiceResponse, zReplayWebhookEventsResponse, zRespondToReceivedDocumentResponse, zRetrieveFiscalDeliveryPrintedRepresentationResponse, zRetrieveHostedCertificationTestSetResponse, zRetrieveHostedInvoiceResponse, zRetrieveHostedIssuanceReadinessResponse, zRetrieveInvoiceDeliveryResponse, zRetrieveInvoiceReceiptResponse, zRetrieveInvoiceResponse, zRetrieveIssuanceReadinessResponse, zRetrieveWorkspaceFiscalArtifactResponse, zRevokeCertificateCustodyCertificateVersionResponse, zShareHostedInvoiceReceiptResponse, zShareInvoiceReceiptResponse, zUpdateOnboardingLegalIssuerIdentityResponse, zUpdateOnboardingServiceScopeResponse, zUploadHostedCertificationTestSetResponse, } from "./zod-response.gen.js";
 export const healthLive = (options) => options.client.get({
     response_decoder: (response) => {
         switch (response.status) {
@@ -194,6 +194,73 @@ export const releaseHostedTenant = (options) => options.client.post({
         ...options.headers,
     },
 });
+export const repairHostedTenantSourceConnection = (options) => options.client.post({
+    response_decoder: (response) => {
+        switch (response.status) {
+            case 200:
+                return {
+                    status: 200,
+                    headers: response.headers,
+                    body: zRepairHostedTenantSourceConnectionResponse.parse(response.body),
+                };
+            case 400:
+                return {
+                    status: 400,
+                    headers: response.headers,
+                    body: zProblemBody.parse(response.body),
+                };
+            case 401:
+                return {
+                    status: 401,
+                    headers: response.headers,
+                    body: zProblemBody.parse(response.body),
+                };
+            case 403:
+                return {
+                    status: 403,
+                    headers: response.headers,
+                    body: zProblemBody.parse(response.body),
+                };
+            case 404:
+                return {
+                    status: 404,
+                    headers: response.headers,
+                    body: zProblemBody.parse(response.body),
+                };
+            case 413:
+                return {
+                    status: 413,
+                    headers: response.headers,
+                    body: zProblemBody.parse(response.body),
+                };
+            case 415:
+                return {
+                    status: 415,
+                    headers: response.headers,
+                    body: zProblemBody.parse(response.body),
+                };
+            case 500:
+                return {
+                    status: 500,
+                    headers: response.headers,
+                    body: zProblemBody.parse(response.body),
+                };
+            default:
+                return {
+                    status: "unexpected",
+                    status_code: response.status,
+                    headers: response.headers,
+                    body: response.body,
+                };
+        }
+    },
+    url: "/hosted/tenants/source-connection-repairs",
+    ...options,
+    headers: {
+        "Content-Type": "application/json",
+        ...options.headers,
+    },
+});
 export const createHostedTenantWebhookSecretRotation = (options) => options.client.post({
     response_decoder: (response) => {
         switch (response.status) {
@@ -1497,7 +1564,7 @@ export const retrieveFiscalDeliveryPrintedRepresentation = (options) => options.
     ...options,
 });
 /**
- * Imports a hosted tenant's P12 into certificate custody for its exact environment binding. The environment defaults to sandbox; production is available when that tenant has a production binding. Timbro verifies the certificate identity, trust, validity, signer proof, and custody envelope.
+ * Imports a hosted tenant's P12 into certificate custody once for its Legal issuer. The named environment (default sandbox) is the binding the import is made from, and the certificate then serves every environment the issuer is bound in. An environment bound later adopts it without another upload. Timbro verifies the certificate identity, trust, validity, signer proof, and custody envelope, and refuses the whole import with the environment that cannot use the certificate: it already uses a different certificate, its certificate was revoked, or it enrolled another signer.
  */
 export const importHostedCertificateCustody = (options) => options.client.post({
     response_decoder: (response) => {
@@ -5453,6 +5520,7 @@ export const healthLivePathTemplate = "/health/live";
 export const healthReadyPathTemplate = "/health/ready";
 export const createHostedTenantPathTemplate = "/hosted/tenants";
 export const releaseHostedTenantPathTemplate = "/hosted/tenants/releases";
+export const repairHostedTenantSourceConnectionPathTemplate = "/hosted/tenants/source-connection-repairs";
 export const createHostedTenantWebhookSecretRotationPathTemplate = "/hosted/tenants/{source_connection_id}/webhook-secret-rotations";
 export const uploadHostedCertificationTestSetPathTemplate = "/internal/hosted/certification/{attemptReference}/test-sets";
 export const retrieveHostedCertificationTestSetPathTemplate = "/internal/hosted/certification/{attemptReference}/test-sets/current";

package/dist/generated/types.gen.d.ts

@@ -681,7 +681,7 @@ export type FiscalNumberAuthorizationHistoryResource = {
 /**
  * Provenance strength of a fiscal-number authorization fact.
  */
-export type FiscalNumberAuthorizationKnowledge = "verified" | "reported";
+export type FiscalNumberAuthorizationKnowledge = "verified" | "reported" | "disputed";
 export type FiscalNumberAuthorizationLineage = {
     current: FiscalNumberAuthorizationResource;
     generations: Array<FiscalNumberAuthorizationResource>;
@@ -721,7 +721,7 @@ export type FiscalNumberAuthorizationResource = {
 /**
  * Origin of a fiscal-number authorization fact.
  */
-export type FiscalNumberAuthorizationSourceKind = "official_source_manifest" | "operator_attested" | "caller_reported";
+export type FiscalNumberAuthorizationSourceKind = "official_source_manifest" | "operator_attested" | "caller_reported" | "dgii_response";
 /**
  * Lifecycle state of a fiscal-number authorization fact.
  */
@@ -930,6 +930,11 @@ export type HostedImportRequest = {
 };
 export type HostedImportResponse = {
     certificate_subject_common_name: string | null;
+    /**
+     * The environments the Legal issuer's certificate now serves, in sandbox, certification, then
+     * production order. An environment bound later adopts the certificate when it is bound.
+     */
+    environments: Array<HostedCertificateImportEnvironment>;
     object: string;
     signer_subject_serial_number: string;
 };
@@ -959,6 +964,10 @@ export type HostedReceiverUrls = {
     commercial_approval_url: string;
     reception_url: string;
 };
+/**
+ * What the repair did to the binding's Source connection.
+ */
+export type HostedSourceConnectionRepairOutcome = "reconnected" | "already_connected";
 export type HostedTenantResource = {
     /**
      * The binding identity the Checkout host uses for an exact release request.
@@ -1132,6 +1141,10 @@ export type InvoiceCreditNotePaymentTerms = {
 } | {
     type: "free";
 };
+/**
+ * A calendar date in the public API's ISO 8601 date form.
+ */
+export type InvoiceDate = string;
 export type InvoiceDebitNoteModificationCode = "2" | "3";
 export type InvoiceDeliveryAttachmentSelection = {
     /**
@@ -1199,6 +1212,24 @@ export type InvoiceExportItem = {
     unit: SourceMeasurementUnit;
     unitPrice: string;
 };
+/**
+ * A document issued outside Timbro that a legal note modifies.
+ *
+ * `fiscalNumber` is the original e-NCF (`E`, the two type digits, and ten digits) or paper NCF
+ * (`B` and ten digits, or `A` or `P` and eighteen digits). `issuerTaxId` is DGII's RNC Otro
+ * Contribuyente and applies only when the original was issued under a different RNC than the
+ * note, for example after a merger or split. `buyer` is the original's buyer and may be omitted
+ * for an anonymous consumer document. `total` is the original's total and is required when the
+ * original is an e-CF type 32, because DGII requires the buyer's identity on a note against a
+ * type 32 of DOP 250,000.00 or more.
+ */
+export type InvoiceExternalOriginal = {
+    buyer?: null | InvoiceConsumerBuyer | undefined;
+    fiscalNumber: string;
+    issuedOn: InvoiceDate;
+    issuerTaxId?: null | string | undefined;
+    total?: null | string | undefined;
+};
 export type InvoiceFiles = {
     pdf: InvoicePdfReadiness;
     xml: InvoiceXmlReadiness;
@@ -1319,10 +1350,7 @@ export type InvoiceItemResource = {
     legalTip: boolean;
     quantity: string;
     tax: InvoiceTax;
-    /**
-     * A named common unit, or the retained DGII code for another official unit.
-     */
-    unit: string;
+    unit: SourceMeasurementUnit;
     unitPrice: string;
     withholding: null | InvoiceItemWithholding;
 };
@@ -1705,12 +1733,33 @@ export type InvoiceRequest = {
     items: Array<InvoiceItem>;
     modificationCode: InvoiceDebitNoteModificationCode;
     numbering?: null | InvoiceNumbering | undefined;
+    /**
+     * The Invoice Timbro issued that this note modifies. The note takes its buyer from that Invoice.
+     */
     originalInvoiceId: string;
     paymentTerms: InvoicePaymentTerms;
     pdfLayout?: null | InvoicePdfLayout | undefined;
     reason: string;
     source?: null | InvoiceSourceInput | undefined;
     type: "E33";
+} | {
+    additionalInformation?: null | InvoiceAdditionalInformation | undefined;
+    currency: "DOP";
+    expectedTotals?: null | InvoiceExpectedTotals | undefined;
+    externalOriginal: InvoiceExternalOriginal;
+    incomeType?: null | "01" | "02" | "03" | "04" | "05" | "06" | undefined;
+    /**
+     * The only field a source-system reference travels in, bounded at 128 characters.
+     */
+    invoiceReference: string;
+    items: Array<InvoiceItem>;
+    modificationCode: InvoiceDebitNoteModificationCode;
+    numbering?: null | InvoiceNumbering | undefined;
+    paymentTerms: InvoicePaymentTerms;
+    pdfLayout?: null | InvoicePdfLayout | undefined;
+    reason: string;
+    source?: null | InvoiceSourceInput | undefined;
+    type: "E33";
 } | {
     additionalInformation?: null | InvoiceAdditionalInformation | undefined;
     currency: "DOP";
@@ -1723,12 +1772,33 @@ export type InvoiceRequest = {
     items: Array<InvoiceItem>;
     modificationCode: InvoiceCreditNoteModificationCode;
     numbering?: null | InvoiceNumbering | undefined;
+    /**
+     * The Invoice Timbro issued that this note modifies. The note takes its buyer from that Invoice.
+     */
     originalInvoiceId: string;
     paymentTerms: InvoiceCreditNotePaymentTerms;
     pdfLayout?: null | InvoicePdfLayout | undefined;
     reason: string;
     source?: null | InvoiceSourceInput | undefined;
     type: "E34";
+} | {
+    additionalInformation?: null | InvoiceAdditionalInformation | undefined;
+    currency: "DOP";
+    expectedTotals?: null | InvoiceExpectedTotals | undefined;
+    externalOriginal: InvoiceExternalOriginal;
+    incomeType?: null | "01" | "02" | "03" | "04" | "05" | "06" | undefined;
+    /**
+     * The only field a source-system reference travels in, bounded at 128 characters.
+     */
+    invoiceReference: string;
+    items: Array<InvoiceItem>;
+    modificationCode: InvoiceCreditNoteModificationCode;
+    numbering?: null | InvoiceNumbering | undefined;
+    paymentTerms: InvoiceCreditNotePaymentTerms;
+    pdfLayout?: null | InvoicePdfLayout | undefined;
+    reason: string;
+    source?: null | InvoiceSourceInput | undefined;
+    type: "E34";
 };
 export type InvoiceResource = {
     acceptedAt: string | null;
@@ -2254,7 +2324,7 @@ export type InvoiceXmlReadiness = {
 /**
  * One stable reason the authoritative rules refuse to issue.
  */
-export type IssuanceBlocker = "invalid_request" | "unsupported_protocol" | "unsupported_rules_version" | "invalid_resolved_facts" | "numbering_verifier_missing" | "numbering_mode_not_enabled" | "document_type_not_recognized" | "authorization_missing" | "authorization_not_observed_on_effective_date" | "authorization_suspended" | "authorization_cancelled" | "authorization_superseded" | "authorization_exhausted" | "authorization_conflicting" | "authorization_document_type_mismatch" | "central_assignment_requires_verified_authorization" | "authorization_expired" | "authorization_range_overlap" | "fiscal_number_capacity_exhausted" | "invalid_fiscal_number" | "fiscal_number_outside_authorized_range" | "fiscal_number_before_verified_floor" | "sequence_expiration_mismatch";
+export type IssuanceBlocker = "invalid_request" | "unsupported_protocol" | "unsupported_rules_version" | "invalid_resolved_facts" | "numbering_verifier_missing" | "numbering_mode_not_enabled" | "document_type_not_recognized" | "authorization_missing" | "authorization_not_observed_on_effective_date" | "authorization_suspended" | "authorization_cancelled" | "authorization_superseded" | "authorization_exhausted" | "authorization_conflicting" | "authorization_document_type_mismatch" | "sequence_rejected_by_dgii" | "authorization_expired" | "authorization_range_overlap" | "fiscal_number_capacity_exhausted" | "invalid_fiscal_number" | "fiscal_number_outside_authorized_range" | "fiscal_number_before_verified_floor" | "sequence_expiration_mismatch";
 /**
  * Whether the issuer can issue each e-CF type now in this environment.
  */
@@ -2267,7 +2337,7 @@ export type IssuanceReadiness = {
     environment: FiscalEnvironment;
     issuerTaxId: string;
 };
-export type IssuanceReadinessReason = "legal_issuer_profile_incomplete" | "signing_certificate_missing" | "signing_certificate_expired" | "signing_certificate_not_yet_valid" | "authorization_missing" | "authorization_not_active" | "authorization_not_verified" | "authorization_not_observed" | "range_exhausted" | "authorization_expiration_invalid" | "authorization_expired" | "authorization_range_overlap";
+export type IssuanceReadinessReason = "legal_issuer_profile_incomplete" | "signing_certificate_missing" | "signing_certificate_expired" | "signing_certificate_not_yet_valid" | "authorization_missing" | "authorization_not_active" | "sequence_rejected_by_dgii" | "authorization_not_observed" | "range_exhausted" | "authorization_expiration_invalid" | "authorization_expired" | "authorization_range_overlap";
 export type LedgerCounter = string;
 export type LegalIssuer = {
     address: string | null;
@@ -2354,10 +2424,20 @@ export type NumberedFiscalDocument = {
     fiscal_number: string;
     sequence_expires_on: string | null;
 };
+/**
+ * Whether DGII has accepted an e-CF numbered from the range Timbro would assign from. Either way
+ * the range is issuable.
+ */
+export type NumberingConfirmation = "confirmed" | "not_yet_confirmed";
 /**
  * The range Timbro assigns the next fiscal number of this type from.
  */
 export type NumberingRange = {
+    /**
+     * Whether DGII has accepted an e-CF numbered from this range. A range that is not yet
+     * confirmed still issues; a range DGII rejected is blocked with `sequence_rejected_by_dgii`.
+     */
+    confirmation: NumberingConfirmation;
     /**
      * The sequence expiry, or `null` for a type without one (E32 and E34).
      */
@@ -2553,7 +2633,7 @@ export type ProblemType = "about:blank";
 /**
  * One stable public problem code returned on the `/v1` surface.
  */
-export type PublicProblemCode = "unauthenticated" | "invalid_login" | "email_already_registered" | "organization_slug_taken" | "organization_not_found" | "hosted_tenant_conflict" | "insufficient_role" | "service_role_not_permitted" | "invalid_fiscal_identity" | "invalid_certificate_custody_signer_identity" | "certificate_p12_password_invalid" | "custody_certificate_malformed" | "custody_certificate_not_yet_valid" | "custody_certificate_expired" | "custody_p12_work_limit_exceeded" | "custody_signature_algorithm_unsupported" | "custody_certificate_trust_profile_unsupported" | "custody_certificate_chain_untrusted" | "custody_certificate_purpose_unsupported" | "legal_issuer_already_registered" | "onboarding_legal_issuer_identity_conflict" | "legal_issuer_profile_incomplete" | "legal_issuer_not_found" | "invitation_invalid" | "invitation_expired" | "already_a_member" | "environment_not_active" | "certificate_custody_binding_not_found" | "certificate_custody_binding_conflict" | "certificate_custody_certificate_version_not_active" | "source_connection_not_found" | "source_connection_not_connected" | "source_provider_unavailable" | "source_provider_authorization_required" | "source_provider_installation_disabled" | "source_provider_installation_removed" | "source_provider_scope_insufficient" | "source_provider_target_access_removed" | "source_provider_throttled" | "source_provider_outcome_unknown" | "source_provider_authorization_not_found" | "source_provider_authorization_conflict" | "source_provider_installation_request_invalid" | "source_provider_installation_request_expired" | "source_provider_installation_callback_replayed" | "source_connection_creation_conflict" | "source_connection_activation_conflict" | "source_connection_activation_verification_rejected" | "delegated_authorization_verifier_forbidden" | "invalid_credential" | "credential_revoked" | "issuer_not_authorized" | "missing_idempotency_key" | "invalid_idempotency_key" | "unsupported_media_type" | "request_too_large" | "request_body_timeout" | "malformed_json" | "invalid_request" | "certification_environment_required" | "certification_test_set_invalid" | "invalid_collection_query" | "invalid_collection_cursor" | "document_type_not_enabled" | "fiscal_intent_rejected" | "idempotency_key_conflict" | "fiscal_number_already_used" | "fiscal_number_authorization_changed" | "fiscal_number_authorization_source_record_conflict" | "source_version_stale" | "source_predecessor_conflict" | "source_history_requires_reconciliation" | "source_content_conflict" | "source_action_conflict" | "source_command_conflict" | "invoice_reference_conflict" | "invoice_totals_mismatch" | "printed_representation_profile_conflict" | "source_record_already_fiscalized" | "source_operation_pending" | "source_outcome_unknown" | "authority_rejected_replacement" | "correction_target_unsettled" | "unsupported_printed_representation_profile" | "affected_fiscal_operation_unsupported" | "fiscal_issuance_blocked" | "fiscal_operation_not_found" | "invoice_not_found" | "fiscal_artifact_not_found" | "fiscal_artifact_unverified" | "fiscal_artifact_unavailable" | "invoice_receipt_not_found" | "invoice_receipt_not_ready" | "invoice_receipt_unavailable" | "fiscal_delivery_not_found" | "fiscal_delivery_unavailable" | "fiscal_delivery_outcome_conflict" | "webhook_endpoint_not_found" | "webhook_endpoint_registration_conflict" | "webhook_endpoint_suspended" | "webhook_endpoint_deleted" | "webhook_event_not_found" | "invalid_replay_scope" | "webhook_destination_not_allowed" | "unsigned_document_schema_invalid" | "signed_document_schema_invalid" | "custody_unavailable" | "received_document_not_found" | "commercial_response_motive_invalid" | "commercial_response_decision_conflict" | "route_not_found" | "method_not_allowed" | "internal_error";
+export type PublicProblemCode = "unauthenticated" | "invalid_login" | "email_already_registered" | "organization_slug_taken" | "organization_not_found" | "hosted_tenant_conflict" | "insufficient_role" | "service_role_not_permitted" | "invalid_fiscal_identity" | "invalid_certificate_custody_signer_identity" | "certificate_p12_password_invalid" | "custody_certificate_malformed" | "custody_certificate_not_yet_valid" | "custody_certificate_expired" | "custody_p12_work_limit_exceeded" | "custody_signature_algorithm_unsupported" | "custody_certificate_trust_profile_unsupported" | "custody_certificate_chain_untrusted" | "custody_certificate_purpose_unsupported" | "legal_issuer_already_registered" | "onboarding_legal_issuer_identity_conflict" | "legal_issuer_profile_incomplete" | "legal_issuer_not_found" | "invitation_invalid" | "invitation_expired" | "already_a_member" | "environment_not_active" | "certificate_custody_binding_not_found" | "certificate_custody_binding_conflict" | "certificate_custody_environment_occupied" | "certificate_custody_environment_revoked" | "certificate_custody_environment_signer_mismatch" | "certificate_custody_certificate_version_not_active" | "source_connection_not_found" | "source_connection_not_connected" | "source_provider_unavailable" | "source_provider_authorization_required" | "source_provider_installation_disabled" | "source_provider_installation_removed" | "source_provider_scope_insufficient" | "source_provider_target_access_removed" | "source_provider_throttled" | "source_provider_outcome_unknown" | "source_provider_authorization_not_found" | "source_provider_authorization_conflict" | "source_provider_installation_request_invalid" | "source_provider_installation_request_expired" | "source_provider_installation_callback_replayed" | "source_connection_creation_conflict" | "source_connection_activation_conflict" | "source_connection_activation_verification_rejected" | "delegated_authorization_verifier_forbidden" | "invalid_credential" | "credential_revoked" | "issuer_not_authorized" | "missing_idempotency_key" | "invalid_idempotency_key" | "unsupported_media_type" | "request_too_large" | "request_body_timeout" | "malformed_json" | "invalid_request" | "invoice_original_invalid" | "certification_environment_required" | "certification_test_set_invalid" | "invalid_collection_query" | "invalid_collection_cursor" | "document_type_not_enabled" | "fiscal_intent_rejected" | "idempotency_key_conflict" | "fiscal_number_already_used" | "fiscal_number_authorization_changed" | "fiscal_number_authorization_source_record_conflict" | "source_version_stale" | "source_predecessor_conflict" | "source_history_requires_reconciliation" | "source_content_conflict" | "source_action_conflict" | "source_command_conflict" | "invoice_reference_conflict" | "invoice_totals_mismatch" | "printed_representation_profile_conflict" | "source_record_already_fiscalized" | "source_operation_pending" | "source_outcome_unknown" | "authority_rejected_replacement" | "correction_target_unsettled" | "unsupported_printed_representation_profile" | "affected_fiscal_operation_unsupported" | "fiscal_issuance_blocked" | "fiscal_operation_not_found" | "invoice_not_found" | "fiscal_artifact_not_found" | "fiscal_artifact_unverified" | "fiscal_artifact_unavailable" | "invoice_receipt_not_found" | "invoice_receipt_not_ready" | "invoice_receipt_unavailable" | "fiscal_delivery_not_found" | "fiscal_delivery_unavailable" | "fiscal_delivery_outcome_conflict" | "webhook_endpoint_not_found" | "webhook_endpoint_registration_conflict" | "webhook_endpoint_suspended" | "webhook_endpoint_deleted" | "webhook_event_not_found" | "invalid_replay_scope" | "webhook_destination_not_allowed" | "unsigned_document_schema_invalid" | "signed_document_schema_invalid" | "custody_unavailable" | "received_document_not_found" | "commercial_response_motive_invalid" | "commercial_response_decision_conflict" | "route_not_found" | "method_not_allowed" | "internal_error";
 export type QualifiedProductionOrigin = {
     domain: string;
     origin: string;
@@ -2669,19 +2749,24 @@ export type ReferenceInformation = {
     issued_on: string;
     modification_code: "4" | "5";
 };
+/**
+ * The sequence a business records. Timbro, not the caller, decides how far DGII has confirmed it:
+ * a recorded sequence is reported until DGII accepts an e-CF numbered from it. `knowledge` and
+ * `source_kind` are deprecated, accepted so an older caller keeps working, and never trusted.
+ */
 export type RegisterFiscalNumberAuthorizationRequest = {
     document_type: ElectronicFiscalDocumentType;
     ends_at: LedgerCounter;
     environment: FiscalEnvironment;
     expected_head: ExpectedAuthorizationHead;
     expires_on: string | null;
-    knowledge: FiscalNumberAuthorizationKnowledge;
+    knowledge?: null | FiscalNumberAuthorizationKnowledge | undefined;
     legal_issuer_id: string;
     observed_at: string;
     provenance_sha256: string;
     series: ElectronicFiscalDocumentSeries;
     source_id: string;
-    source_kind: FiscalNumberAuthorizationSourceKind;
+    source_kind?: null | FiscalNumberAuthorizationSourceKind | undefined;
     source_reference: string;
     starts_at: LedgerCounter;
     state: FiscalNumberAuthorizationState;
@@ -2751,6 +2836,26 @@ export type ReleasedHostedTenant = {
     release_id: string;
     state: string;
 };
+export type RepairHostedTenantSourceConnectionRequest = {
+    /**
+     * The Checkout tenant whose binding is repaired. It must match the tenant the token proves.
+     */
+    checkout_tenant_id: string;
+    /**
+     * The Fiscal environment of the binding.
+     */
+    environment: FiscalEnvironment;
+};
+export type RepairedHostedTenantSourceConnection = {
+    environment: FiscalEnvironment;
+    hosted_tenant_binding_id: string;
+    outcome: HostedSourceConnectionRepairOutcome;
+    /**
+     * The binding's Source connection. Repair keeps its identity, so webhook addresses and Fiscal
+     * operations that name it stay valid.
+     */
+    source_connection_id: string;
+};
 export type ReplayEventIdsScope = {
     eventIds: Array<string>;
 };
@@ -3021,6 +3126,40 @@ export type SourceFiscalActionCommand = {
         version: string;
     };
     reason: string;
+} | {
+    /**
+     * Document issued outside Timbro that a common-path note modifies.
+     *
+     * The original e-NCF or NCF is not in Timbro's ledger, so the caller states the facts DGII
+     * validates on the note: the number, its issue date, and the other taxpayer's RNC when the
+     * original was issued under a different RNC than the note.
+     */
+    affected_document: {
+        consumer_invoice_total?: string | undefined;
+        fiscal_number: string;
+        issued_on: string;
+        issuer_tax_id?: string | undefined;
+    };
+    correction: SourceCreditNoteCorrection;
+    kind: "credit_note_of_external_document";
+    reason: string;
+} | {
+    /**
+     * Document issued outside Timbro that a common-path note modifies.
+     *
+     * The original e-NCF or NCF is not in Timbro's ledger, so the caller states the facts DGII
+     * validates on the note: the number, its issue date, and the other taxpayer's RNC when the
+     * original was issued under a different RNC than the note.
+     */
+    affected_document: {
+        consumer_invoice_total?: string | undefined;
+        fiscal_number: string;
+        issued_on: string;
+        issuer_tax_id?: string | undefined;
+    };
+    correction: SourceDebitNoteCorrection;
+    kind: "debit_note_of_external_document";
+    reason: string;
 };
 export type SourceFiscalOperationPage = {
     data: Array<FiscalOperationResource>;
@@ -3070,9 +3209,10 @@ export type SourceGovernmentEligibility = {
  */
 export type SourceItemKind = "good" | "service";
 /**
- * Common semantic measurement units mapped to official DGII catalog codes by fiscal-document.
+ * A DGII e-CF unit of measure: a readable lowercase name on the Source and Invoice wire,
+ * the official numeric catalog code in fiscal documents.
  */
-export type SourceMeasurementUnit = "unit" | "kilogram" | "litre" | "metre" | "piece";
+export type SourceMeasurementUnit = "barrel" | "bag" | "jar" | "bundle" | "bottle" | "box" | "cigarette_pack" | "centimetre" | "cylinder" | "set" | "container" | "day" | "dozen" | "bale" | "gallon" | "degree" | "gram" | "bulk" | "hour" | "crate" | "kilogram" | "kilowatt_hour" | "pound" | "litre" | "lot" | "metre" | "square_metre" | "cubic_metre" | "million_btu" | "minute" | "package" | "pair" | "foot" | "piece" | "roll" | "envelope" | "second" | "tank" | "ton" | "tube" | "yard" | "square_yard" | "unit" | "element" | "thousand" | "sack" | "tin" | "display" | "drum" | "ration" | "quintal" | "gross_register_tonnage" | "square_foot" | "passenger" | "inch" | "boat_berth_stay" | "tray" | "hectare" | "millilitre" | "milligram" | "ounce" | "troy_ounce";
 /**
  * One exact decimal payment allocation declared by the Source system.
  */
@@ -3198,9 +3338,10 @@ export type SourceSalesLine = {
     item_codes?: Array<FiscalItemCode> | undefined;
     item_kind: SourceItemKind;
     /**
-     * Common semantic measurement units mapped to official DGII catalog codes by fiscal-document.
+     * A DGII e-CF unit of measure: a readable lowercase name on the Source and Invoice wire,
+     * the official numeric catalog code in fiscal documents.
      */
-    measurement_unit: "unit" | "kilogram" | "litre" | "metre" | "piece";
+    measurement_unit: "barrel" | "bag" | "jar" | "bundle" | "bottle" | "box" | "cigarette_pack" | "centimetre" | "cylinder" | "set" | "container" | "day" | "dozen" | "bale" | "gallon" | "degree" | "gram" | "bulk" | "hour" | "crate" | "kilogram" | "kilowatt_hour" | "pound" | "litre" | "lot" | "metre" | "square_metre" | "cubic_metre" | "million_btu" | "minute" | "package" | "pair" | "foot" | "piece" | "roll" | "envelope" | "second" | "tank" | "ton" | "tube" | "yard" | "square_yard" | "unit" | "element" | "thousand" | "sack" | "tin" | "display" | "drum" | "ration" | "quintal" | "gross_register_tonnage" | "square_foot" | "passenger" | "inch" | "boat_berth_stay" | "tray" | "hectare" | "millilitre" | "milligram" | "ounce" | "troy_ounce";
     quantity: string;
     source_line_id: string;
     tax_treatment: SourceTaxTreatment;
@@ -5074,6 +5215,50 @@ export type ReleaseHostedTenantResponses = {
     200: ReleasedHostedTenant;
 };
 export type ReleaseHostedTenantResponse = ReleaseHostedTenantResponses[keyof ReleaseHostedTenantResponses];
+export type RepairHostedTenantSourceConnectionData = {
+    body: RepairHostedTenantSourceConnectionRequest;
+    path?: never | undefined;
+    query?: never | undefined;
+    url: "/hosted/tenants/source-connection-repairs";
+};
+export type RepairHostedTenantSourceConnectionErrors = {
+    /**
+     * The request body failed the contract.
+     */
+    400: ProblemBody;
+    /**
+     * The bearer token is missing, expired, or not from a trusted issuer.
+     */
+    401: ProblemBody;
+    /**
+     * The hosted user does not hold the owner role.
+     */
+    403: ProblemBody;
+    /**
+     * The tenant in the body is not the tenant the token proves, or that tenant holds no active binding in the environment.
+     */
+    404: ProblemBody;
+    /**
+     * The native stamp server returned a typed Problem.
+     */
+    413: ProblemBody;
+    /**
+     * The native stamp server returned a typed Problem.
+     */
+    415: ProblemBody;
+    /**
+     * The native stamp server returned a typed Problem.
+     */
+    500: ProblemBody;
+};
+export type RepairHostedTenantSourceConnectionError = RepairHostedTenantSourceConnectionErrors[keyof RepairHostedTenantSourceConnectionErrors];
+export type RepairHostedTenantSourceConnectionResponses = {
+    /**
+     * The binding's Source connection is connected. A repeat on a connected Source connection answers `already_connected` and changes nothing.
+     */
+    200: RepairedHostedTenantSourceConnection;
+};
+export type RepairHostedTenantSourceConnectionResponse = RepairHostedTenantSourceConnectionResponses[keyof RepairHostedTenantSourceConnectionResponses];
 export type CreateHostedTenantWebhookSecretRotationData = {
     body?: never | undefined;
     headers?: {