@timbro/invoices 0.10.3 → 0.12.0

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

@@ -48,6 +48,10 @@ export type MerchantBusinessFiscalSetupAvailable = {
         id: string;
         documentType: "31" | "32" | "33" | "34" | "41" | "43" | "44" | "45" | "46" | "47";
     };
+    /**
+     * Whether each e-CF type can be issued now in this environment, in type order, as Timbro reports it. Empty while the environment has no connected hosted binding; once bound, Timbro lists every e-CF type. `null` when Timbro's readiness could not be read; read the business again.
+     */
+    documentTypes: Array<DocumentTypeIssuanceReadiness> | null;
 };
 /**
  * MerchantBusinessFiscalBinding
@@ -92,6 +96,36 @@ export type MerchantBusinessSigningCertificate = {
     notBefore: string;
     notAfter: string;
 };
+/**
+ * DocumentTypeIssuanceReadiness
+ *
+ * Whether Timbro can issue one e-CF type now, as Timbro reports it.
+ */
+export type DocumentTypeIssuanceReadiness = {
+    type: "E31" | "E32" | "E33" | "E34" | "E41" | "E43" | "E44" | "E45" | "E46" | "E47";
+    status: "ready";
+    numbering: NumberingRange;
+} | {
+    type: "E31" | "E32" | "E33" | "E34" | "E41" | "E43" | "E44" | "E45" | "E46" | "E47";
+    status: "actionRequired";
+    /**
+     * Every condition that blocks this type: issuer, then certificate, then numbering.
+     */
+    reasons: Array<"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">;
+    numbering: NumberingRange | null;
+};
+/**
+ * NumberingRange
+ *
+ * The range Timbro assigns the next fiscal number of this type from.
+ */
+export type NumberingRange = {
+    /**
+     * Fiscal numbers left in the selected range.
+     */
+    remaining: number;
+    expiresOn: string | null;
+};
 /**
  * MerchantBusinessLiveFiscalSetup
  *
@@ -106,6 +140,10 @@ export type MerchantBusinessLiveFiscalSetupAvailable = {
     binding: MerchantBusinessFiscalBinding;
     legalIssuer: MerchantBusinessLegalIssuer;
     signingCertificate: MerchantBusinessSigningCertificate;
+    /**
+     * Whether each e-CF type can be issued now in this environment, in type order, as Timbro reports it. Empty while the environment has no connected hosted binding; once bound, Timbro lists every e-CF type. `null` when Timbro's readiness could not be read; read the business again.
+     */
+    documentTypes: Array<DocumentTypeIssuanceReadiness> | null;
 };
 /**
  * Problem
@@ -116,7 +154,7 @@ export type Problem = {
     /**
      * Stable machine-readable code. Branch on this, never on `title`.
      */
-    code: "merchant_authentication_unavailable" | "platform_test_profile_unavailable" | "merchant_fiscal_binding_unavailable" | "merchant_fiscal_setup_unavailable" | "merchant_contact_email_confirmation_required" | "merchant_service_scope_required" | "merchant_business_address_required" | "merchant_business_contact_required" | "merchant_business_location_official_codes_required" | "merchant_business_details_invalid" | "merchant_current_payment_methods_required" | "merchant_current_sales_channels_required" | "merchant_existing_card_service_not_applicable" | "merchant_existing_card_service_other_provider_name_invalid" | "merchant_existing_card_service_other_provider_name_not_allowed" | "merchant_existing_card_service_other_provider_name_required" | "merchant_existing_card_service_providers_exclusive_choice" | "merchant_existing_card_service_providers_required" | "merchant_existing_card_service_required" | "merchant_location_catalog_changed" | "merchant_location_catalog_unavailable" | "merchant_location_selection_invalid" | "merchant_payment_methods_not_applicable" | "merchant_sales_channels_exclusive_choice" | "merchant_sales_channels_not_applicable" | "merchant_business_type_not_applicable" | "merchant_charge_timing_not_applicable" | "merchant_charge_timing_required" | "merchant_payment_methods_exclusive_choice" | "merchant_session_missing" | "merchant_guest_notice_acceptance_required" | "merchant_workspace_organization_required" | "merchant_onboarding_revision_conflict" | "merchant_checkout_policy_revision_conflict" | "merchant_business_already_claimed" | "merchant_business_attachment_conflict" | "merchant_business_identity_required" | "merchant_business_not_member" | "merchant_business_revision_conflict" | "merchant_business_capabilities_required" | "merchant_fiscal_setup_incomplete" | "merchant_payment_setup_assessment_incomplete" | "merchant_certificate_conflict" | "merchant_test_fiscal_document_blocked" | "merchant_dgii_assistance_not_applicable" | "merchant_dgii_assistance_notes_invalid" | "parameter_missing" | "parameter_invalid" | "provider_not_available" | "currency_not_supported" | "amount_below_minimum" | "amount_above_maximum" | "checkout_reference_invalid" | "checkout_reference_expired" | "fiscal_buyer_tax_id_invalid" | "fiscal_lines_required" | "payment_split_invalid" | "submission_token_invalid" | "submission_token_expired" | "request_body_malformed" | "collection_cursor_invalid" | "webhook_replay_scope_invalid" | "api_key_missing" | "api_key_invalid" | "checkout_token_invalid" | "checkout_token_expired" | "payer_session_missing" | "operation_not_permitted" | "invoice_delivery_not_permitted" | "journey_scope_mismatch" | "journey_report_timeout" | "merchant_fiscal_binding_conflict" | "live_mode_not_enabled" | "origin_not_allowed" | "payer_step_up_required" | "certificate_handoff_person_mismatch" | "route_not_found" | "api_key_not_found" | "payment_not_found" | "payment_reference_conflict" | "refund_reference_conflict" | "payment_reference_invalid" | "refund_reference_invalid" | "payment_tax_required" | "payment_tax_invalid" | "payment_items_invalid" | "payment_totals_mismatch" | "payment_invoice_item_fields_required" | "payments_contract_migration_required" | "merchant_payments_api_paused" | "refund_not_found" | "refund_invoice_not_ready" | "refund_invoice_not_accepted" | "refund_invoice_mismatch" | "refund_invoice_conflict" | "payment_part_not_found" | "payment_split_not_found" | "fiscal_document_not_found" | "merchant_account_not_found" | "merchant_account_card_capability_not_found" | "merchant_business_not_found" | "agent_client_not_found" | "connected_agent_not_found" | "certificate_handoff_not_found" | "webhook_endpoint_not_found" | "webhook_event_not_found" | "three_ds_not_found" | "payer_not_found" | "saved_card_not_found" | "payer_credential_not_found" | "payer_purchase_not_found" | "payer_fiscal_profile_not_found" | "idempotency_key_reused" | "idempotency_request_in_progress" | "idempotency_key_expired" | "api_key_retired" | "payment_method_already_in_progress" | "payment_not_payable" | "refund_not_allowed" | "refund_already_exists" | "payment_awaiting_verification" | "payment_attempt_invalid" | "payment_attempt_mismatch" | "payment_attempt_stale" | "payment_method_mismatch" | "provider_response_invalid" | "decline_not_retryable" | "checkout_window_closed" | "payment_not_editable" | "payment_cancel_not_allowed" | "payment_cancellation_pending" | "invoicing_locked" | "source_identity_conflict" | "refund_source_identity_conflict" | "refund_payment_not_captured" | "refund_exceeds_captured" | "refund_allocation_not_found" | "refund_allocation_conflict" | "refund_allocation_ledger_unavailable" | "fiscal_buyer_required" | "fiscal_artifact_not_ready" | "payment_invoice_not_ready" | "payment_invoice_not_allowed" | "invoice_reference_stale" | "fiscal_delivery_not_ready" | "payment_split_not_allowed" | "payment_split_exists" | "payment_split_locked" | "payment_split_not_capturable" | "payment_split_not_expired" | "payment_split_not_renewable" | "payment_split_complete" | "payment_split_part_required" | "payment_part_not_payable" | "webhook_endpoint_deleted" | "webhook_endpoint_suspended" | "three_ds_binding_mismatch" | "payer_enrollment_unavailable" | "payer_claim_unavailable" | "payer_claim_conflict" | "payer_claim_proof_invalid" | "payer_delivery_address_unavailable" | "payer_fiscal_profile_unavailable" | "certificate_handoff_used" | "receipt_retention_elapsed" | "certificate_handoff_expired" | "request_body_too_large" | "unsupported_media_type" | "merchant_account_not_ready" | "merchant_checkout_policy_invalid" | "merchant_account_provider_mismatch" | "merchant_account_identity_mismatch" | "merchant_profile_incomplete" | "payment_description_required" | "sale_amount_invalid" | "credential_storage_unavailable" | "refund_credentials_unavailable" | "refund_provider_unavailable" | "refund_provider_reference_unavailable" | "provider_not_eligible" | "no_eligible_provider" | "currency_not_supported_by_provider" | "currency_not_supported_for_fiscal_document" | "fiscal_total_mismatch" | "fiscal_line_total_invalid" | "fiscal_line_legal_tip_invalid" | "fiscal_document_kind_not_allowed" | "fiscal_document_kind_unsupported" | "fiscal_government_eligibility_required" | "fiscal_government_eligibility_not_allowed" | "certificate_p12_password_invalid" | "certificate_pkcs12_invalid" | "certificate_expired" | "certificate_not_yet_valid" | "certificate_archive_not_supported" | "certificate_not_supported" | "taxpayer_unregistered" | "taxpayer_inactive" | "voluntary_tip_currency_mismatch" | "voluntary_tip_not_allowed_for_split" | "voluntary_tip_not_available" | "voluntary_tip_exceeds_maximum" | "refund_tip_amount_invalid" | "refund_tip_allocation_unknown" | "refund_amount_invalid" | "refund_currency_mismatch" | "payer_fiscal_profile_invalid" | "rate_limit_exceeded" | "internal_error" | "provider_unavailable" | "provider_rejected_request" | "taxpayer_directory_unavailable" | "fiscal_artifact_retrieval_unavailable" | "fiscal_delivery_unavailable" | "journey_marks_unavailable" | "contact_request_delivery_unavailable" | "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" | "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" | "request_too_large" | "request_body_timeout" | "malformed_json" | "invalid_request" | "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_outcome_conflict" | "webhook_endpoint_registration_conflict" | "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" | "method_not_allowed";
+    code: "authorization_not_found" | "authorization_checkout_reference_invalid" | "authorization_reference_conflict" | "authorization_capture_conflict" | "authorization_capture_exceeds_hold" | "authorization_not_capturable" | "authorization_not_cancelable" | "authorization_not_editable" | "authorization_submission_invalid" | "authorization_authentication_pending" | "authorization_credentials_unavailable" | "authorization_dispatch_refused" | "authorization_hold_evidence_missing" | "provider_qualification_required" | "merchant_authentication_unavailable" | "platform_test_profile_unavailable" | "merchant_fiscal_binding_unavailable" | "merchant_fiscal_setup_unavailable" | "merchant_contact_email_confirmation_required" | "merchant_service_scope_required" | "merchant_business_address_required" | "merchant_business_contact_required" | "merchant_business_location_official_codes_required" | "merchant_business_details_invalid" | "merchant_current_payment_methods_required" | "merchant_current_sales_channels_required" | "merchant_existing_card_service_not_applicable" | "merchant_existing_card_service_other_provider_name_invalid" | "merchant_existing_card_service_other_provider_name_not_allowed" | "merchant_existing_card_service_other_provider_name_required" | "merchant_existing_card_service_providers_exclusive_choice" | "merchant_existing_card_service_providers_required" | "merchant_existing_card_service_required" | "merchant_location_catalog_changed" | "merchant_location_catalog_unavailable" | "merchant_location_selection_invalid" | "merchant_payment_methods_not_applicable" | "merchant_sales_channels_exclusive_choice" | "merchant_sales_channels_not_applicable" | "merchant_business_type_not_applicable" | "merchant_charge_timing_not_applicable" | "merchant_charge_timing_required" | "merchant_payment_methods_exclusive_choice" | "merchant_session_missing" | "merchant_guest_notice_acceptance_required" | "merchant_workspace_organization_required" | "merchant_onboarding_revision_conflict" | "merchant_checkout_policy_revision_conflict" | "merchant_business_already_claimed" | "merchant_business_attachment_conflict" | "merchant_business_identity_required" | "merchant_business_not_member" | "merchant_business_revision_conflict" | "merchant_business_capabilities_required" | "merchant_business_certification_path_unavailable" | "merchant_business_certification_requirements_unmet" | "merchant_business_certification_revision_conflict" | "merchant_business_certification_evidence_not_found" | "merchant_fiscal_setup_incomplete" | "merchant_payment_setup_assessment_incomplete" | "merchant_certificate_conflict" | "merchant_test_fiscal_document_blocked" | "merchant_dgii_assistance_not_applicable" | "merchant_dgii_assistance_notes_invalid" | "parameter_missing" | "parameter_invalid" | "provider_not_available" | "currency_not_supported" | "amount_below_minimum" | "amount_above_maximum" | "checkout_reference_invalid" | "checkout_reference_expired" | "fiscal_buyer_tax_id_invalid" | "fiscal_lines_required" | "payment_split_invalid" | "submission_token_invalid" | "submission_token_expired" | "request_body_malformed" | "collection_cursor_invalid" | "webhook_replay_scope_invalid" | "api_key_missing" | "api_key_invalid" | "checkout_token_invalid" | "checkout_token_expired" | "payer_session_missing" | "operation_not_permitted" | "invoice_delivery_not_permitted" | "journey_scope_mismatch" | "journey_report_timeout" | "merchant_fiscal_binding_conflict" | "live_mode_not_enabled" | "origin_not_allowed" | "payer_step_up_required" | "certificate_handoff_person_mismatch" | "route_not_found" | "api_key_not_found" | "payment_not_found" | "payment_reference_conflict" | "refund_reference_conflict" | "payment_reference_invalid" | "refund_reference_invalid" | "payment_tax_required" | "payment_tax_invalid" | "payment_items_invalid" | "payment_totals_mismatch" | "payment_invoice_item_fields_required" | "payments_contract_migration_required" | "merchant_payments_api_paused" | "refund_not_found" | "refund_invoice_not_ready" | "refund_invoice_not_accepted" | "refund_invoice_mismatch" | "refund_invoice_conflict" | "payment_part_not_found" | "payment_split_not_found" | "fiscal_document_not_found" | "merchant_account_not_found" | "merchant_account_card_capability_not_found" | "merchant_business_not_found" | "agent_client_not_found" | "connected_agent_not_found" | "certificate_handoff_not_found" | "webhook_endpoint_not_found" | "webhook_event_not_found" | "three_ds_not_found" | "payer_not_found" | "saved_card_not_found" | "payer_credential_not_found" | "payer_purchase_not_found" | "payer_fiscal_profile_not_found" | "idempotency_key_reused" | "idempotency_request_in_progress" | "idempotency_key_expired" | "api_key_retired" | "payment_method_already_in_progress" | "payment_not_payable" | "payment_awaiting_verification" | "payment_attempt_invalid" | "payment_attempt_mismatch" | "payment_attempt_stale" | "payment_method_mismatch" | "provider_response_invalid" | "checkout_window_closed" | "payment_not_editable" | "payment_cancel_not_allowed" | "payment_cancellation_pending" | "invoicing_locked" | "source_identity_conflict" | "refund_source_identity_conflict" | "refund_payment_not_captured" | "refund_exceeds_captured" | "refund_allocation_not_found" | "refund_allocation_conflict" | "refund_allocation_ledger_unavailable" | "fiscal_buyer_required" | "fiscal_artifact_not_ready" | "payment_invoice_not_ready" | "payment_invoice_not_allowed" | "invoice_reference_stale" | "fiscal_delivery_not_ready" | "payment_split_not_allowed" | "payment_split_exists" | "payment_split_locked" | "payment_split_not_capturable" | "payment_split_not_expired" | "payment_split_not_renewable" | "payment_split_complete" | "payment_split_part_required" | "payment_part_not_payable" | "webhook_endpoint_deleted" | "webhook_endpoint_suspended" | "three_ds_binding_mismatch" | "payer_enrollment_unavailable" | "payer_claim_unavailable" | "payer_claim_conflict" | "payer_claim_proof_invalid" | "payer_delivery_address_unavailable" | "payer_fiscal_profile_unavailable" | "certificate_handoff_used" | "receipt_retention_elapsed" | "certificate_handoff_expired" | "request_body_too_large" | "unsupported_media_type" | "merchant_account_not_ready" | "merchant_checkout_policy_invalid" | "merchant_account_provider_mismatch" | "merchant_account_identity_mismatch" | "merchant_profile_incomplete" | "payment_description_required" | "sale_amount_invalid" | "credential_storage_unavailable" | "provider_not_eligible" | "no_eligible_provider" | "currency_not_supported_by_provider" | "currency_not_supported_for_fiscal_document" | "fiscal_total_mismatch" | "fiscal_line_total_invalid" | "fiscal_line_legal_tip_invalid" | "fiscal_document_kind_not_allowed" | "fiscal_document_kind_unsupported" | "fiscal_government_eligibility_required" | "fiscal_government_eligibility_not_allowed" | "certificate_p12_password_invalid" | "certificate_pkcs12_invalid" | "certificate_expired" | "certificate_not_yet_valid" | "certificate_archive_not_supported" | "certificate_not_supported" | "taxpayer_unregistered" | "taxpayer_inactive" | "voluntary_tip_currency_mismatch" | "voluntary_tip_not_allowed_for_split" | "voluntary_tip_not_available" | "voluntary_tip_exceeds_maximum" | "refund_tip_amount_invalid" | "refund_tip_allocation_unknown" | "refund_amount_invalid" | "refund_tax_amount_invalid" | "refund_tax_amount_required" | "refund_tax_allocation_unknown" | "refund_currency_mismatch" | "payer_fiscal_profile_invalid" | "rate_limit_exceeded" | "internal_error" | "provider_unavailable" | "provider_rejected_request" | "taxpayer_directory_unavailable" | "fiscal_artifact_retrieval_unavailable" | "fiscal_delivery_unavailable" | "journey_marks_unavailable" | "contact_request_delivery_unavailable" | "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" | "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" | "request_too_large" | "request_body_timeout" | "malformed_json" | "invalid_request" | "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_outcome_conflict" | "webhook_endpoint_registration_conflict" | "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" | "method_not_allowed";
     detail?: string;
     /**
      * Present only when the rejected request produced a Fiscal operation.
@@ -142,6 +180,40 @@ export type Problem = {
      */
     type: "about:blank";
 };
+/**
+ * MerchantBusinessCertificationRequirement
+ */
+export type MerchantBusinessCertificationRequirement = {
+    code: "invoices_not_requested" | "fiscal_details_incomplete" | "certification_binding_required" | "certification_certificate_required" | "provider_eligibility_unverified" | "certification_receiver_urls_pending" | "certification_test_set_processing_unavailable";
+    owner: "merchant" | "dgii" | "timbro" | "operator";
+    blocks: Array<"start" | "step_1" | "step_2" | "step_7">;
+    field?: string;
+};
+/**
+ * MerchantBusinessCertificationStep
+ */
+export type MerchantBusinessCertificationStep = {
+    number: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15;
+    code: string;
+    title: string;
+    actor: "merchant" | "dgii" | "timbro";
+    status: "blocked" | "action_required" | "awaiting_dgii" | "reported" | "verified";
+    evidence: Array<MerchantBusinessCertificationEvidence>;
+};
+/**
+ * MerchantBusinessCertificationEvidence
+ *
+ * A business-reported DGII outcome. It remains unverified until an authorized evidence review confirms it.
+ */
+export type MerchantBusinessCertificationEvidence = {
+    id: string;
+    outcome: "submitted" | "approved" | "rejected" | "needs_correction";
+    verification: "user_reported" | "operator_verified" | "operator_rejected";
+    reference: string | null;
+    createdAt: string;
+    reviewedAt?: string;
+    reviewReference?: string;
+};
 export type RetrieveBusinessData = {
     body?: never;
     path?: never;
@@ -629,6 +701,469 @@ export type UpdateBusinessResponses = {
     };
 };
 export type UpdateBusinessResponse = UpdateBusinessResponses[keyof UpdateBusinessResponses];
+export type RetrieveMerchantBusinessCertificationData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: "/v1/business/certification";
+};
+export type RetrieveMerchantBusinessCertificationErrors = {
+    /**
+     * The request could not be understood.
+     */
+    400: Problem & {
+        status: 400;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "parameter_invalid";
+    };
+    /**
+     * The credential is missing, malformed, or no longer valid.
+     */
+    401: Problem & {
+        status: 401;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "api_key_missing" | "api_key_invalid" | "checkout_token_invalid" | "checkout_token_expired" | "merchant_session_missing";
+    };
+    /**
+     * The credential is valid but not permitted to perform this operation.
+     */
+    403: Problem & {
+        status: 403;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "operation_not_permitted";
+    };
+    /**
+     * No endpoint serves this method and path, or no resource with this identifier exists within the caller's scope.
+     */
+    404: Problem & {
+        status: 404;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "merchant_business_not_found";
+    };
+    /**
+     * The request could not complete. Recover by the retained resource reference or retry with the same command identity.
+     */
+    500: Problem & {
+        status: 500;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "internal_error";
+    };
+};
+export type RetrieveMerchantBusinessCertificationError = RetrieveMerchantBusinessCertificationErrors[keyof RetrieveMerchantBusinessCertificationErrors];
+export type RetrieveMerchantBusinessCertificationResponses = {
+    /**
+     * MerchantBusinessCertification
+     *
+     * Durable certification preparation and user-reported DGII progress for the authenticated business.
+     */
+    200: {
+        object: "merchant_business_certification";
+        status: "not_started";
+        requirements: Array<MerchantBusinessCertificationRequirement>;
+        availablePaths: Array<"own_software" | "external_software">;
+        recommendedPath: "own_software" | "external_software";
+        actions: Array<"start">;
+    } | {
+        object: "merchant_business_certification";
+        id: string;
+        revision: number;
+        status: "in_progress";
+        path: "own_software" | "external_software";
+        software: {
+            name: string;
+            version: string;
+        };
+        phase: "preparation" | "application" | "tests" | "authorization";
+        serviceUrls: {
+            reception: string;
+            commercialApproval: string;
+        } | null;
+        requirements: Array<MerchantBusinessCertificationRequirement>;
+        actions: Array<"report_evidence" | "import_certificate">;
+        steps: [
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep
+        ];
+    };
+};
+export type RetrieveMerchantBusinessCertificationResponse = RetrieveMerchantBusinessCertificationResponses[keyof RetrieveMerchantBusinessCertificationResponses];
+export type StartMerchantBusinessCertificationData = {
+    /**
+     * MerchantBusinessCertificationStartRequest
+     */
+    body: {
+        path: "own_software" | "external_software";
+    };
+    headers: {
+        "idempotency-key": string;
+    };
+    path?: never;
+    query?: never;
+    url: "/v1/business/certification";
+};
+export type StartMerchantBusinessCertificationErrors = {
+    /**
+     * The request could not be understood.
+     */
+    400: Problem & {
+        status: 400;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "parameter_invalid" | "parameter_missing" | "request_body_malformed";
+    };
+    /**
+     * The credential is missing, malformed, or no longer valid.
+     */
+    401: Problem & {
+        status: 401;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "api_key_missing" | "api_key_invalid" | "checkout_token_invalid" | "checkout_token_expired" | "merchant_session_missing";
+    };
+    /**
+     * The credential is valid but not permitted to perform this operation.
+     */
+    403: Problem & {
+        status: 403;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "operation_not_permitted";
+    };
+    /**
+     * No endpoint serves this method and path, or no resource with this identifier exists within the caller's scope.
+     */
+    404: Problem & {
+        status: 404;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "merchant_business_not_found";
+    };
+    /**
+     * The request conflicts with the current state of the resource or with a previous request using the same Idempotency-Key.
+     */
+    409: Problem & {
+        status: 409;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "idempotency_key_reused" | "idempotency_request_in_progress" | "idempotency_key_expired" | "merchant_business_certification_path_unavailable" | "merchant_business_certification_requirements_unmet";
+    };
+    /**
+     * The request body is larger than this endpoint accepts.
+     */
+    413: Problem & {
+        status: 413;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "request_body_too_large";
+    };
+    /**
+     * The request body carries a content type this endpoint does not accept.
+     */
+    415: Problem & {
+        status: 415;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "unsupported_media_type";
+    };
+    /**
+     * The request could not complete. Recover by the retained resource reference or retry with the same command identity.
+     */
+    500: Problem & {
+        status: 500;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "internal_error";
+    };
+    /**
+     * A required service is temporarily unavailable. Retry with the same reference or command identity.
+     */
+    503: Problem & {
+        status: 503;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "merchant_fiscal_setup_unavailable";
+    };
+};
+export type StartMerchantBusinessCertificationError = StartMerchantBusinessCertificationErrors[keyof StartMerchantBusinessCertificationErrors];
+export type StartMerchantBusinessCertificationResponses = {
+    /**
+     * MerchantBusinessCertification
+     *
+     * Durable certification preparation and user-reported DGII progress for the authenticated business.
+     */
+    200: {
+        object: "merchant_business_certification";
+        status: "not_started";
+        requirements: Array<MerchantBusinessCertificationRequirement>;
+        availablePaths: Array<"own_software" | "external_software">;
+        recommendedPath: "own_software" | "external_software";
+        actions: Array<"start">;
+    } | {
+        object: "merchant_business_certification";
+        id: string;
+        revision: number;
+        status: "in_progress";
+        path: "own_software" | "external_software";
+        software: {
+            name: string;
+            version: string;
+        };
+        phase: "preparation" | "application" | "tests" | "authorization";
+        serviceUrls: {
+            reception: string;
+            commercialApproval: string;
+        } | null;
+        requirements: Array<MerchantBusinessCertificationRequirement>;
+        actions: Array<"report_evidence" | "import_certificate">;
+        steps: [
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep
+        ];
+    };
+    /**
+     * MerchantBusinessCertification
+     *
+     * Durable certification preparation and user-reported DGII progress for the authenticated business.
+     */
+    201: {
+        object: "merchant_business_certification";
+        status: "not_started";
+        requirements: Array<MerchantBusinessCertificationRequirement>;
+        availablePaths: Array<"own_software" | "external_software">;
+        recommendedPath: "own_software" | "external_software";
+        actions: Array<"start">;
+    } | {
+        object: "merchant_business_certification";
+        id: string;
+        revision: number;
+        status: "in_progress";
+        path: "own_software" | "external_software";
+        software: {
+            name: string;
+            version: string;
+        };
+        phase: "preparation" | "application" | "tests" | "authorization";
+        serviceUrls: {
+            reception: string;
+            commercialApproval: string;
+        } | null;
+        requirements: Array<MerchantBusinessCertificationRequirement>;
+        actions: Array<"report_evidence" | "import_certificate">;
+        steps: [
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep
+        ];
+    };
+};
+export type StartMerchantBusinessCertificationResponse = StartMerchantBusinessCertificationResponses[keyof StartMerchantBusinessCertificationResponses];
+export type SubmitMerchantBusinessCertificationEvidenceData = {
+    /**
+     * MerchantBusinessCertificationEvidenceRequest
+     */
+    body: {
+        expectedRevision: number;
+        step: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15;
+        outcome: "submitted" | "approved" | "rejected" | "needs_correction";
+        reference?: string;
+    };
+    headers: {
+        "idempotency-key": string;
+    };
+    path?: never;
+    query?: never;
+    url: "/v1/business/certification/evidence";
+};
+export type SubmitMerchantBusinessCertificationEvidenceErrors = {
+    /**
+     * The request could not be understood.
+     */
+    400: Problem & {
+        status: 400;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "parameter_invalid" | "parameter_missing" | "request_body_malformed";
+    };
+    /**
+     * The credential is missing, malformed, or no longer valid.
+     */
+    401: Problem & {
+        status: 401;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "api_key_missing" | "api_key_invalid" | "checkout_token_invalid" | "checkout_token_expired" | "merchant_session_missing";
+    };
+    /**
+     * The credential is valid but not permitted to perform this operation.
+     */
+    403: Problem & {
+        status: 403;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "operation_not_permitted";
+    };
+    /**
+     * No endpoint serves this method and path, or no resource with this identifier exists within the caller's scope.
+     */
+    404: Problem & {
+        status: 404;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "merchant_business_not_found";
+    };
+    /**
+     * The request conflicts with the current state of the resource or with a previous request using the same Idempotency-Key.
+     */
+    409: Problem & {
+        status: 409;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "idempotency_key_reused" | "idempotency_request_in_progress" | "idempotency_key_expired" | "merchant_business_certification_requirements_unmet" | "merchant_business_certification_revision_conflict";
+    };
+    /**
+     * The request body is larger than this endpoint accepts.
+     */
+    413: Problem & {
+        status: 413;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "request_body_too_large";
+    };
+    /**
+     * The request body carries a content type this endpoint does not accept.
+     */
+    415: Problem & {
+        status: 415;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "unsupported_media_type";
+    };
+    /**
+     * The request could not complete. Recover by the retained resource reference or retry with the same command identity.
+     */
+    500: Problem & {
+        status: 500;
+        /**
+         * Stable machine-readable code. Branch on this, never on `title`.
+         */
+        code: "internal_error";
+    };
+};
+export type SubmitMerchantBusinessCertificationEvidenceError = SubmitMerchantBusinessCertificationEvidenceErrors[keyof SubmitMerchantBusinessCertificationEvidenceErrors];
+export type SubmitMerchantBusinessCertificationEvidenceResponses = {
+    /**
+     * MerchantBusinessCertification
+     *
+     * Durable certification preparation and user-reported DGII progress for the authenticated business.
+     */
+    200: {
+        object: "merchant_business_certification";
+        status: "not_started";
+        requirements: Array<MerchantBusinessCertificationRequirement>;
+        availablePaths: Array<"own_software" | "external_software">;
+        recommendedPath: "own_software" | "external_software";
+        actions: Array<"start">;
+    } | {
+        object: "merchant_business_certification";
+        id: string;
+        revision: number;
+        status: "in_progress";
+        path: "own_software" | "external_software";
+        software: {
+            name: string;
+            version: string;
+        };
+        phase: "preparation" | "application" | "tests" | "authorization";
+        serviceUrls: {
+            reception: string;
+            commercialApproval: string;
+        } | null;
+        requirements: Array<MerchantBusinessCertificationRequirement>;
+        actions: Array<"report_evidence" | "import_certificate">;
+        steps: [
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep
+        ];
+    };
+};
+export type SubmitMerchantBusinessCertificationEvidenceResponse = SubmitMerchantBusinessCertificationEvidenceResponses[keyof SubmitMerchantBusinessCertificationEvidenceResponses];
 export type ConfigureInvoicingData = {
     /**
      * MerchantBusinessConfigureInvoicingRequest
@@ -756,6 +1291,10 @@ export type ImportSigningCertificateData = {
         mode: "test" | "live";
         certificateP12Base64: string;
         password: string;
+    } | {
+        purpose: "certification";
+        certificateP12Base64: string;
+        password: string;
     };
     path?: never;
     query?: never;
@@ -866,9 +1405,7 @@ export type ImportSigningCertificateErrors = {
 export type ImportSigningCertificateError = ImportSigningCertificateErrors[keyof ImportSigningCertificateErrors];
 export type ImportSigningCertificateResponses = {
     /**
-     * MerchantBusiness
-     *
-     * The business the credential selects, its capabilities, and the requirements that remain.
+     * Default Response
      */
     200: {
         object: "merchant_business";
@@ -988,6 +1525,47 @@ export type ImportSigningCertificateResponses = {
             }>;
         }>;
         onboardingUrl: string;
+    } | {
+        object: "merchant_business_certification";
+        status: "not_started";
+        requirements: Array<MerchantBusinessCertificationRequirement>;
+        availablePaths: Array<"own_software" | "external_software">;
+        recommendedPath: "own_software" | "external_software";
+        actions: Array<"start">;
+    } | {
+        object: "merchant_business_certification";
+        id: string;
+        revision: number;
+        status: "in_progress";
+        path: "own_software" | "external_software";
+        software: {
+            name: string;
+            version: string;
+        };
+        phase: "preparation" | "application" | "tests" | "authorization";
+        serviceUrls: {
+            reception: string;
+            commercialApproval: string;
+        } | null;
+        requirements: Array<MerchantBusinessCertificationRequirement>;
+        actions: Array<"report_evidence" | "import_certificate">;
+        steps: [
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep,
+            MerchantBusinessCertificationStep
+        ];
     };
 };
 export type ImportSigningCertificateResponse = ImportSigningCertificateResponses[keyof ImportSigningCertificateResponses];
@@ -1594,7 +2172,7 @@ export type CreateWebhookEndpointData = {
          *
          * Domain events that the gateway can deliver to a merchant endpoint.
          */
-        enabledEvents: Array<"payment.succeeded" | "payment.canceled" | "payment.expired" | "payment.operator_required" | "refund.succeeded" | "refund.declined" | "refund.operator_required" | "refund.invoiceAttached" | "invoice.accepted" | "invoice.rejected" | "invoice.operatorRequired" | "invoice.ready">;
+        enabledEvents: Array<"payment.succeeded" | "payment.declined" | "payment.canceled" | "payment.expired" | "payment.operator_required" | "refund.succeeded" | "refund.declined" | "refund.operator_required" | "refund.invoiceAttached" | "invoice.accepted" | "invoice.rejected" | "invoice.operatorRequired" | "invoice.ready" | "invoice.deliverySent" | "invoice.deliveryFailed">;
     };
     headers: {
         "idempotency-key": string;