@timbro/invoices 0.10.3 → 0.12.0

package/dist/generated/hosted/zod-response.gen.js

@@ -88,6 +88,70 @@ export const zMerchantBusinessSigningCertificate = lenientUnion([
         notAfter: z.iso.datetime(),
     }),
 ]);
+/**
+ * NumberingRange
+ *
+ * The range Timbro assigns the next fiscal number of this type from.
+ */
+export const zNumberingRange = z.object({
+    remaining: z.int().gte(1).lte(9999999999),
+    expiresOn: z.iso.date().nullable(),
+});
+/**
+ * DocumentTypeIssuanceReadiness
+ *
+ * Whether Timbro can issue one e-CF type now, as Timbro reports it.
+ */
+export const zDocumentTypeIssuanceReadiness = lenientUnion([
+    z.object({
+        type: lenientUnion([
+            z.literal("E31"),
+            z.literal("E32"),
+            z.literal("E33"),
+            z.literal("E34"),
+            z.literal("E41"),
+            z.literal("E43"),
+            z.literal("E44"),
+            z.literal("E45"),
+            z.literal("E46"),
+            z.literal("E47"),
+        ]),
+        status: z.literal("ready"),
+        numbering: zNumberingRange,
+    }),
+    z.object({
+        type: lenientUnion([
+            z.literal("E31"),
+            z.literal("E32"),
+            z.literal("E33"),
+            z.literal("E34"),
+            z.literal("E41"),
+            z.literal("E43"),
+            z.literal("E44"),
+            z.literal("E45"),
+            z.literal("E46"),
+            z.literal("E47"),
+        ]),
+        status: z.literal("actionRequired"),
+        reasons: z
+            .array(lenientUnion([
+            z.literal("legal_issuer_profile_incomplete"),
+            z.literal("signing_certificate_missing"),
+            z.literal("signing_certificate_expired"),
+            z.literal("signing_certificate_not_yet_valid"),
+            z.literal("authorization_missing"),
+            z.literal("authorization_not_active"),
+            z.literal("authorization_not_verified"),
+            z.literal("authorization_not_observed"),
+            z.literal("range_exhausted"),
+            z.literal("authorization_expiration_invalid"),
+            z.literal("authorization_expired"),
+            z.literal("authorization_range_overlap"),
+        ]))
+            .min(1),
+        numbering: zNumberingRange.nullable(),
+    }),
+]);
 /**
  * MerchantBusinessFiscalSetupAvailable
  */
@@ -167,6 +231,7 @@ export const zMerchantBusinessFiscalSetupAvailable = z.object({
             ]),
         }),
     ]),
+    documentTypes: z.array(zDocumentTypeIssuanceReadiness).nullable(),
 });
 /**
  * MerchantBusinessFiscalSetup
@@ -185,6 +250,7 @@ export const zMerchantBusinessLiveFiscalSetupAvailable = z.object({
     binding: zMerchantBusinessFiscalBinding,
     legalIssuer: zMerchantBusinessLegalIssuer,
     signingCertificate: zMerchantBusinessSigningCertificate,
+    documentTypes: z.array(zDocumentTypeIssuanceReadiness).nullable(),
 });
 /**
  * MerchantBusinessLiveFiscalSetup
@@ -202,6 +268,20 @@ export const zMerchantBusinessLiveFiscalSetup = lenientUnion([
  */
 export const zProblem = z.object({
     code: z.enum([
+        "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",
@@ -242,6 +322,10 @@ export const zProblem = z.object({
         "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",
@@ -320,15 +404,12 @@ export const zProblem = z.object({
         "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",
@@ -378,9 +459,6 @@ export const zProblem = z.object({
         "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",
@@ -407,6 +485,9 @@ export const zProblem = z.object({
         "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",
@@ -562,6 +643,97 @@ export const zProblem = z.object({
     title: z.string(),
     type: z.enum(["about:blank"]),
 });
+/**
+ * MerchantBusinessCertificationRequirement
+ */
+export const zMerchantBusinessCertificationRequirement = z.object({
+    code: lenientUnion([
+        z.literal("invoices_not_requested"),
+        z.literal("fiscal_details_incomplete"),
+        z.literal("certification_binding_required"),
+        z.literal("certification_certificate_required"),
+        z.literal("provider_eligibility_unverified"),
+        z.literal("certification_receiver_urls_pending"),
+        z.literal("certification_test_set_processing_unavailable"),
+    ]),
+    owner: lenientUnion([
+        z.literal("merchant"),
+        z.literal("dgii"),
+        z.literal("timbro"),
+        z.literal("operator"),
+    ]),
+    blocks: z
+        .array(lenientUnion([
+        z.literal("start"),
+        z.literal("step_1"),
+        z.literal("step_2"),
+        z.literal("step_7"),
+    ]))
+        .max(4),
+    field: z.string().optional(),
+});
+/**
+ * MerchantBusinessCertificationEvidence
+ *
+ * A business-reported DGII outcome. It remains unverified until an authorized evidence review confirms it.
+ */
+export const zMerchantBusinessCertificationEvidence = z.object({
+    id: z.string().refine((text) => Array.from(text).length >= 1),
+    outcome: lenientUnion([
+        z.literal("submitted"),
+        z.literal("approved"),
+        z.literal("rejected"),
+        z.literal("needs_correction"),
+    ]),
+    verification: lenientUnion([
+        z.literal("user_reported"),
+        z.literal("operator_verified"),
+        z.literal("operator_rejected"),
+    ]),
+    reference: z
+        .string()
+        .refine((text) => Array.from(text).length <= 255)
+        .nullable(),
+    createdAt: z.iso.datetime(),
+    reviewedAt: z.iso.datetime().optional(),
+    reviewReference: z
+        .string()
+        .refine((text) => Array.from(text).length <= 512)
+        .optional(),
+});
+/**
+ * MerchantBusinessCertificationStep
+ */
+export const zMerchantBusinessCertificationStep = z.object({
+    number: lenientUnion([
+        z.literal(1),
+        z.literal(2),
+        z.literal(3),
+        z.literal(4),
+        z.literal(5),
+        z.literal(6),
+        z.literal(7),
+        z.literal(8),
+        z.literal(9),
+        z.literal(10),
+        z.literal(11),
+        z.literal(12),
+        z.literal(13),
+        z.literal(14),
+        z.literal(15),
+    ]),
+    code: z.string().refine((text) => Array.from(text).length >= 1),
+    title: z.string().refine((text) => Array.from(text).length >= 1),
+    actor: lenientUnion([z.literal("merchant"), z.literal("dgii"), z.literal("timbro")]),
+    status: lenientUnion([
+        z.literal("blocked"),
+        z.literal("action_required"),
+        z.literal("awaiting_dgii"),
+        z.literal("reported"),
+        z.literal("verified"),
+    ]),
+    evidence: z.array(zMerchantBusinessCertificationEvidence),
+});
 /**
  * MerchantBusiness
  *
@@ -1056,6 +1228,259 @@ export const zUpdateBusinessResponse = z.object({
     })),
     onboardingUrl: z.url(),
 });
+/**
+ * MerchantBusinessCertification
+ *
+ * Durable certification preparation and user-reported DGII progress for the authenticated business.
+ */
+export const zRetrieveMerchantBusinessCertificationResponse = lenientUnion([
+    z.object({
+        object: z.literal("merchant_business_certification"),
+        status: z.literal("not_started"),
+        requirements: z.array(zMerchantBusinessCertificationRequirement),
+        availablePaths: z
+            .array(lenientUnion([z.literal("own_software"), z.literal("external_software")]))
+            .min(1),
+        recommendedPath: lenientUnion([z.literal("own_software"), z.literal("external_software")]),
+        actions: z.array(z.literal("start")).max(1),
+    }),
+    z.object({
+        object: z.literal("merchant_business_certification"),
+        id: z.string().regex(/^cert_[a-z0-9]{24,}$/),
+        revision: z.int().gte(1),
+        status: z.literal("in_progress"),
+        path: lenientUnion([z.literal("own_software"), z.literal("external_software")]),
+        software: z.object({
+            name: z
+                .string()
+                .refine((text) => Array.from(text).length >= 1)
+                .refine((text) => Array.from(text).length <= 128),
+            version: z
+                .string()
+                .refine((text) => Array.from(text).length >= 1)
+                .refine((text) => Array.from(text).length <= 64),
+        }),
+        phase: lenientUnion([
+            z.literal("preparation"),
+            z.literal("application"),
+            z.literal("tests"),
+            z.literal("authorization"),
+        ]),
+        serviceUrls: z
+            .object({
+            reception: z.url(),
+            commercialApproval: z.url(),
+        })
+            .nullable(),
+        requirements: z.array(zMerchantBusinessCertificationRequirement),
+        actions: z.array(lenientUnion([z.literal("report_evidence"), z.literal("import_certificate")])),
+        steps: z.tuple([
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+        ]),
+    }),
+]);
+/**
+ * MerchantBusinessCertificationStartRequest
+ */
+export const zStartMerchantBusinessCertificationResponse = lenientUnion([
+    lenientUnion([
+        z.object({
+            object: z.literal("merchant_business_certification"),
+            status: z.literal("not_started"),
+            requirements: z.array(zMerchantBusinessCertificationRequirement),
+            availablePaths: z
+                .array(lenientUnion([z.literal("own_software"), z.literal("external_software")]))
+                .min(1),
+            recommendedPath: lenientUnion([z.literal("own_software"), z.literal("external_software")]),
+            actions: z.array(z.literal("start")).max(1),
+        }),
+        z.object({
+            object: z.literal("merchant_business_certification"),
+            id: z.string().regex(/^cert_[a-z0-9]{24,}$/),
+            revision: z.int().gte(1),
+            status: z.literal("in_progress"),
+            path: lenientUnion([z.literal("own_software"), z.literal("external_software")]),
+            software: z.object({
+                name: z
+                    .string()
+                    .refine((text) => Array.from(text).length >= 1)
+                    .refine((text) => Array.from(text).length <= 128),
+                version: z
+                    .string()
+                    .refine((text) => Array.from(text).length >= 1)
+                    .refine((text) => Array.from(text).length <= 64),
+            }),
+            phase: lenientUnion([
+                z.literal("preparation"),
+                z.literal("application"),
+                z.literal("tests"),
+                z.literal("authorization"),
+            ]),
+            serviceUrls: z
+                .object({
+                reception: z.url(),
+                commercialApproval: z.url(),
+            })
+                .nullable(),
+            requirements: z.array(zMerchantBusinessCertificationRequirement),
+            actions: z.array(lenientUnion([z.literal("report_evidence"), z.literal("import_certificate")])),
+            steps: z.tuple([
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+            ]),
+        }),
+    ]),
+    lenientUnion([
+        z.object({
+            object: z.literal("merchant_business_certification"),
+            status: z.literal("not_started"),
+            requirements: z.array(zMerchantBusinessCertificationRequirement),
+            availablePaths: z
+                .array(lenientUnion([z.literal("own_software"), z.literal("external_software")]))
+                .min(1),
+            recommendedPath: lenientUnion([z.literal("own_software"), z.literal("external_software")]),
+            actions: z.array(z.literal("start")).max(1),
+        }),
+        z.object({
+            object: z.literal("merchant_business_certification"),
+            id: z.string().regex(/^cert_[a-z0-9]{24,}$/),
+            revision: z.int().gte(1),
+            status: z.literal("in_progress"),
+            path: lenientUnion([z.literal("own_software"), z.literal("external_software")]),
+            software: z.object({
+                name: z
+                    .string()
+                    .refine((text) => Array.from(text).length >= 1)
+                    .refine((text) => Array.from(text).length <= 128),
+                version: z
+                    .string()
+                    .refine((text) => Array.from(text).length >= 1)
+                    .refine((text) => Array.from(text).length <= 64),
+            }),
+            phase: lenientUnion([
+                z.literal("preparation"),
+                z.literal("application"),
+                z.literal("tests"),
+                z.literal("authorization"),
+            ]),
+            serviceUrls: z
+                .object({
+                reception: z.url(),
+                commercialApproval: z.url(),
+            })
+                .nullable(),
+            requirements: z.array(zMerchantBusinessCertificationRequirement),
+            actions: z.array(lenientUnion([z.literal("report_evidence"), z.literal("import_certificate")])),
+            steps: z.tuple([
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+            ]),
+        }),
+    ]),
+]);
+/**
+ * MerchantBusinessCertificationEvidenceRequest
+ */
+export const zSubmitMerchantBusinessCertificationEvidenceResponse = lenientUnion([
+    z.object({
+        object: z.literal("merchant_business_certification"),
+        status: z.literal("not_started"),
+        requirements: z.array(zMerchantBusinessCertificationRequirement),
+        availablePaths: z
+            .array(lenientUnion([z.literal("own_software"), z.literal("external_software")]))
+            .min(1),
+        recommendedPath: lenientUnion([z.literal("own_software"), z.literal("external_software")]),
+        actions: z.array(z.literal("start")).max(1),
+    }),
+    z.object({
+        object: z.literal("merchant_business_certification"),
+        id: z.string().regex(/^cert_[a-z0-9]{24,}$/),
+        revision: z.int().gte(1),
+        status: z.literal("in_progress"),
+        path: lenientUnion([z.literal("own_software"), z.literal("external_software")]),
+        software: z.object({
+            name: z
+                .string()
+                .refine((text) => Array.from(text).length >= 1)
+                .refine((text) => Array.from(text).length <= 128),
+            version: z
+                .string()
+                .refine((text) => Array.from(text).length >= 1)
+                .refine((text) => Array.from(text).length <= 64),
+        }),
+        phase: lenientUnion([
+            z.literal("preparation"),
+            z.literal("application"),
+            z.literal("tests"),
+            z.literal("authorization"),
+        ]),
+        serviceUrls: z
+            .object({
+            reception: z.url(),
+            commercialApproval: z.url(),
+        })
+            .nullable(),
+        requirements: z.array(zMerchantBusinessCertificationRequirement),
+        actions: z.array(lenientUnion([z.literal("report_evidence"), z.literal("import_certificate")])),
+        steps: z.tuple([
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+            zMerchantBusinessCertificationStep,
+        ]),
+    }),
+]);
 /**
  * MerchantBusinessConfigureInvoicingRequest
  */
@@ -1066,92 +1491,66 @@ export const zConfigureInvoicingResponse = z.object({
 /**
  * MerchantBusinessSigningCertificateRequest
  */
-export const zImportSigningCertificateResponse = z.object({
-    object: z.literal("merchant_business"),
-    id: z.string().regex(/^mbiz_[0-9a-hjkmnp-tv-z]{24,}$/),
-    rnc: z.string().regex(/^[0-9]{9}$/),
-    legalName: z.string().refine((text) => Array.from(text).length >= 1),
-    revision: z.int().gte(0),
-    capabilities: z.object({
-        payments: z.object({
-            requested: z.boolean(),
-            test: z.object({
-                status: lenientUnion([
-                    z.literal("active"),
-                    z.literal("pending"),
-                    z.literal("inactive"),
-                    z.literal("unavailable"),
-                ]),
-            }),
-            live: z.object({
-                status: lenientUnion([
-                    z.literal("active"),
-                    z.literal("pending"),
-                    z.literal("inactive"),
-                    z.literal("unavailable"),
-                ]),
-            }),
-        }),
-        invoices: z.object({
-            requested: z.boolean(),
-            test: z.object({
-                status: lenientUnion([
-                    z.literal("active"),
-                    z.literal("pending"),
-                    z.literal("inactive"),
-                    z.literal("unavailable"),
-                ]),
+export const zImportSigningCertificateResponse = lenientUnion([
+    z.object({
+        object: z.literal("merchant_business"),
+        id: z.string().regex(/^mbiz_[0-9a-hjkmnp-tv-z]{24,}$/),
+        rnc: z.string().regex(/^[0-9]{9}$/),
+        legalName: z.string().refine((text) => Array.from(text).length >= 1),
+        revision: z.int().gte(0),
+        capabilities: z.object({
+            payments: z.object({
+                requested: z.boolean(),
+                test: z.object({
+                    status: lenientUnion([
+                        z.literal("active"),
+                        z.literal("pending"),
+                        z.literal("inactive"),
+                        z.literal("unavailable"),
+                    ]),
+                }),
+                live: z.object({
+                    status: lenientUnion([
+                        z.literal("active"),
+                        z.literal("pending"),
+                        z.literal("inactive"),
+                        z.literal("unavailable"),
+                    ]),
+                }),
             }),
-            live: z.object({
-                status: lenientUnion([
-                    z.literal("active"),
-                    z.literal("pending"),
-                    z.literal("inactive"),
-                    z.literal("unavailable"),
-                ]),
+            invoices: z.object({
+                requested: z.boolean(),
+                test: z.object({
+                    status: lenientUnion([
+                        z.literal("active"),
+                        z.literal("pending"),
+                        z.literal("inactive"),
+                        z.literal("unavailable"),
+                    ]),
+                }),
+                live: z.object({
+                    status: lenientUnion([
+                        z.literal("active"),
+                        z.literal("pending"),
+                        z.literal("inactive"),
+                        z.literal("unavailable"),
+                    ]),
+                }),
             }),
         }),
-    }),
-    fiscalDetails: z.object({
-        commercialName: z.string().nullable(),
-        address: z.string().nullable(),
-        location: z
-            .object({
-            placeId: z
-                .string()
-                .regex(/^place_[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/),
-            catalogReleaseId: z.string().regex(/^dr_[A-Za-z0-9._-]+$/),
-            municipalityCode: z
-                .string()
-                .regex(/^[0-9]{6}$/)
-                .nullable(),
-            name: z
-                .string()
-                .refine((text) => Array.from(text).length >= 1)
-                .refine((text) => Array.from(text).length <= 160),
-            kind: lenientUnion([
-                z.literal("country"),
-                z.literal("region"),
-                z.literal("national_district"),
-                z.literal("province"),
-                z.literal("municipality"),
-                z.literal("municipal_district"),
-                z.literal("urban_zone"),
-                z.literal("section"),
-                z.literal("barrio"),
-                z.literal("paraje"),
-                z.literal("subbarrio"),
-            ]),
-            qualityStatus: lenientUnion([
-                z.literal("verified"),
-                z.literal("provisional"),
-                z.literal("conflicted"),
-            ]),
-            ancestors: z
-                .array(z.object({
+        fiscalDetails: z.object({
+            commercialName: z.string().nullable(),
+            address: z.string().nullable(),
+            location: z
+                .object({
                 placeId: z
                     .string()
                     .regex(/^place_[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/),
+                catalogReleaseId: z.string().regex(/^dr_[A-Za-z0-9._-]+$/),
+                municipalityCode: z
+                    .string()
+                    .regex(/^[0-9]{6}$/)
+                    .nullable(),
                 name: z
                     .string()
                     .refine((text) => Array.from(text).length >= 1)
@@ -1174,140 +1573,228 @@ export const zImportSigningCertificateResponse = z.object({
                     z.literal("provisional"),
                     z.literal("conflicted"),
                 ]),
-            }))
-                .max(32),
-        })
-            .nullable(),
-        phone: z.string().nullable(),
-        email: z.string().nullable(),
-        defaultIncomeType: z.string().nullable(),
-    }),
-    paymentsProfile: z
-        .object({
-        displayName: z
-            .string()
-            .refine((text) => Array.from(text).length >= 1)
-            .refine((text) => Array.from(text).length <= 80)
-            .regex(/\S/),
-        statementDescriptor: z
-            .string()
-            .refine((text) => Array.from(text).length >= 1)
-            .refine((text) => Array.from(text).length <= 22)
-            .regex(/\S/),
-        permanentAddress: z.object({
-            line1: z
-                .string()
-                .refine((text) => Array.from(text).length >= 1)
-                .refine((text) => Array.from(text).length <= 160)
-                .regex(/\S/),
-            line2: z
-                .string()
-                .refine((text) => Array.from(text).length >= 1)
-                .refine((text) => Array.from(text).length <= 160)
-                .regex(/\S/)
-                .optional(),
-            city: z
+                ancestors: z
+                    .array(z.object({
+                    placeId: z
+                        .string()
+                        .regex(/^place_[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/),
+                    name: z
+                        .string()
+                        .refine((text) => Array.from(text).length >= 1)
+                        .refine((text) => Array.from(text).length <= 160),
+                    kind: lenientUnion([
+                        z.literal("country"),
+                        z.literal("region"),
+                        z.literal("national_district"),
+                        z.literal("province"),
+                        z.literal("municipality"),
+                        z.literal("municipal_district"),
+                        z.literal("urban_zone"),
+                        z.literal("section"),
+                        z.literal("barrio"),
+                        z.literal("paraje"),
+                        z.literal("subbarrio"),
+                    ]),
+                    qualityStatus: lenientUnion([
+                        z.literal("verified"),
+                        z.literal("provisional"),
+                        z.literal("conflicted"),
+                    ]),
+                }))
+                    .max(32),
+            })
+                .nullable(),
+            phone: z.string().nullable(),
+            email: z.string().nullable(),
+            defaultIncomeType: z.string().nullable(),
+        }),
+        paymentsProfile: z
+            .object({
+            displayName: z
                 .string()
                 .refine((text) => Array.from(text).length >= 1)
                 .refine((text) => Array.from(text).length <= 80)
                 .regex(/\S/),
-            province: z
-                .string()
-                .refine((text) => Array.from(text).length >= 1)
-                .refine((text) => Array.from(text).length <= 80)
-                .regex(/\S/)
-                .optional(),
-            postalCode: z
+            statementDescriptor: z
                 .string()
                 .refine((text) => Array.from(text).length >= 1)
-                .refine((text) => Array.from(text).length <= 20)
-                .regex(/\S/)
-                .optional(),
-            countryCode: z.string().regex(/^[A-Z]{2}$/),
-        }),
-        supportEmail: z.email().refine((text) => Array.from(text).length <= 254),
-        supportPhone: z.string().regex(/^\+[1-9][0-9]{7,14}$/),
-        deliveryPolicy: lenientUnion([
-            z.object({
-                kind: z.literal("not_offered"),
-            }),
-            z.object({
-                kind: z.literal("merchant_managed"),
-                summary: z
+                .refine((text) => Array.from(text).length <= 22)
+                .regex(/\S/),
+            permanentAddress: z.object({
+                line1: z
                     .string()
                     .refine((text) => Array.from(text).length >= 1)
                     .refine((text) => Array.from(text).length <= 160)
                     .regex(/\S/),
-                url: z
-                    .url()
-                    .refine((text) => Array.from(text).length <= 2048)
-                    .regex(/^https?:\/\//)
+                line2: z
+                    .string()
+                    .refine((text) => Array.from(text).length >= 1)
+                    .refine((text) => Array.from(text).length <= 160)
+                    .regex(/\S/)
+                    .optional(),
+                city: z
+                    .string()
+                    .refine((text) => Array.from(text).length >= 1)
+                    .refine((text) => Array.from(text).length <= 80)
+                    .regex(/\S/),
+                province: z
+                    .string()
+                    .refine((text) => Array.from(text).length >= 1)
+                    .refine((text) => Array.from(text).length <= 80)
+                    .regex(/\S/)
                     .optional(),
+                postalCode: z
+                    .string()
+                    .refine((text) => Array.from(text).length >= 1)
+                    .refine((text) => Array.from(text).length <= 20)
+                    .regex(/\S/)
+                    .optional(),
+                countryCode: z.string().regex(/^[A-Z]{2}$/),
             }),
-        ]),
-    })
-        .nullable(),
-    invoicing: z.object({
-        test: zMerchantBusinessFiscalSetup,
-        live: zMerchantBusinessLiveFiscalSetup,
+            supportEmail: z.email().refine((text) => Array.from(text).length <= 254),
+            supportPhone: z.string().regex(/^\+[1-9][0-9]{7,14}$/),
+            deliveryPolicy: lenientUnion([
+                z.object({
+                    kind: z.literal("not_offered"),
+                }),
+                z.object({
+                    kind: z.literal("merchant_managed"),
+                    summary: z
+                        .string()
+                        .refine((text) => Array.from(text).length >= 1)
+                        .refine((text) => Array.from(text).length <= 160)
+                        .regex(/\S/),
+                    url: z
+                        .url()
+                        .refine((text) => Array.from(text).length <= 2048)
+                        .regex(/^https?:\/\//)
+                        .optional(),
+                }),
+            ]),
+        })
+            .nullable(),
+        invoicing: z.object({
+            test: zMerchantBusinessFiscalSetup,
+            live: zMerchantBusinessLiveFiscalSetup,
+        }),
+        requirements: z.array(z.object({
+            code: lenientUnion([
+                z.literal("capabilities_required"),
+                z.literal("commercial_name_required"),
+                z.literal("address_required"),
+                z.literal("location_required"),
+                z.literal("phone_required"),
+                z.literal("default_income_type_required"),
+                z.literal("contact_email_verification_required"),
+                z.literal("fiscal_details_rejected"),
+                z.literal("taxpayer_registration_required"),
+                z.literal("signing_certificate_required"),
+                z.literal("signing_certificate_expiring"),
+                z.literal("test_fiscal_document_rejected"),
+                z.literal("test_fiscal_document_pending"),
+                z.literal("test_fiscal_document_send_pending"),
+                z.literal("fiscal_binding_pending"),
+                z.literal("legal_issuer_sync_pending"),
+                z.literal("fiscal_setup_unavailable"),
+                z.literal("fiscal_binding_conflict"),
+                z.literal("fiscal_issuer_rejected"),
+                z.literal("test_fiscal_document_operator_required"),
+                z.literal("payments_profile_required"),
+                z.literal("test_payments_unavailable"),
+                z.literal("merchant_account_required"),
+                z.literal("merchant_account_disabled"),
+                z.literal("active_credential_required"),
+                z.literal("credential_material_invalid"),
+                z.literal("test_live_mode_mismatch"),
+                z.literal("callback_configuration_failed"),
+                z.literal("callback_configuration_required"),
+                z.literal("connectivity_check_failed"),
+                z.literal("connectivity_check_required"),
+                z.literal("provider_qualification_failed"),
+                z.literal("provider_qualification_required"),
+                z.literal("provider_adapter_unavailable"),
+            ]),
+            owner: lenientUnion([
+                z.literal("merchant"),
+                z.literal("dgii"),
+                z.literal("timbro"),
+                z.literal("provider"),
+                z.literal("operator"),
+            ]),
+            blocks: z.array(lenientUnion([z.literal("payments"), z.literal("invoices")])).max(2),
+            mode: lenientUnion([z.literal("test"), z.literal("live")]).optional(),
+            field: z.string().optional(),
+            errors: z
+                .array(z.object({
+                code: z.string(),
+                message: z.string(),
+            }))
+                .min(1)
+                .optional(),
+        })),
+        onboardingUrl: z.url(),
     }),
-    requirements: z.array(z.object({
-        code: lenientUnion([
-            z.literal("capabilities_required"),
-            z.literal("commercial_name_required"),
-            z.literal("address_required"),
-            z.literal("location_required"),
-            z.literal("phone_required"),
-            z.literal("default_income_type_required"),
-            z.literal("contact_email_verification_required"),
-            z.literal("fiscal_details_rejected"),
-            z.literal("taxpayer_registration_required"),
-            z.literal("signing_certificate_required"),
-            z.literal("signing_certificate_expiring"),
-            z.literal("test_fiscal_document_rejected"),
-            z.literal("test_fiscal_document_pending"),
-            z.literal("test_fiscal_document_send_pending"),
-            z.literal("fiscal_binding_pending"),
-            z.literal("legal_issuer_sync_pending"),
-            z.literal("fiscal_setup_unavailable"),
-            z.literal("fiscal_binding_conflict"),
-            z.literal("fiscal_issuer_rejected"),
-            z.literal("test_fiscal_document_operator_required"),
-            z.literal("payments_profile_required"),
-            z.literal("test_payments_unavailable"),
-            z.literal("merchant_account_required"),
-            z.literal("merchant_account_disabled"),
-            z.literal("active_credential_required"),
-            z.literal("credential_material_invalid"),
-            z.literal("test_live_mode_mismatch"),
-            z.literal("callback_configuration_failed"),
-            z.literal("callback_configuration_required"),
-            z.literal("connectivity_check_failed"),
-            z.literal("connectivity_check_required"),
-            z.literal("provider_qualification_failed"),
-            z.literal("provider_qualification_required"),
-            z.literal("provider_adapter_unavailable"),
-        ]),
-        owner: lenientUnion([
-            z.literal("merchant"),
-            z.literal("dgii"),
-            z.literal("timbro"),
-            z.literal("provider"),
-            z.literal("operator"),
-        ]),
-        blocks: z.array(lenientUnion([z.literal("payments"), z.literal("invoices")])).max(2),
-        mode: lenientUnion([z.literal("test"), z.literal("live")]).optional(),
-        field: z.string().optional(),
-        errors: z
-            .array(z.object({
-            code: z.string(),
-            message: z.string(),
-        }))
-            .min(1)
-            .optional(),
-    })),
-    onboardingUrl: z.url(),
-});
+    lenientUnion([
+        z.object({
+            object: z.literal("merchant_business_certification"),
+            status: z.literal("not_started"),
+            requirements: z.array(zMerchantBusinessCertificationRequirement),
+            availablePaths: z
+                .array(lenientUnion([z.literal("own_software"), z.literal("external_software")]))
+                .min(1),
+            recommendedPath: lenientUnion([z.literal("own_software"), z.literal("external_software")]),
+            actions: z.array(z.literal("start")).max(1),
+        }),
+        z.object({
+            object: z.literal("merchant_business_certification"),
+            id: z.string().regex(/^cert_[a-z0-9]{24,}$/),
+            revision: z.int().gte(1),
+            status: z.literal("in_progress"),
+            path: lenientUnion([z.literal("own_software"), z.literal("external_software")]),
+            software: z.object({
+                name: z
+                    .string()
+                    .refine((text) => Array.from(text).length >= 1)
+                    .refine((text) => Array.from(text).length <= 128),
+                version: z
+                    .string()
+                    .refine((text) => Array.from(text).length >= 1)
+                    .refine((text) => Array.from(text).length <= 64),
+            }),
+            phase: lenientUnion([
+                z.literal("preparation"),
+                z.literal("application"),
+                z.literal("tests"),
+                z.literal("authorization"),
+            ]),
+            serviceUrls: z
+                .object({
+                reception: z.url(),
+                commercialApproval: z.url(),
+            })
+                .nullable(),
+            requirements: z.array(zMerchantBusinessCertificationRequirement),
+            actions: z.array(lenientUnion([z.literal("report_evidence"), z.literal("import_certificate")])),
+            steps: z.tuple([
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+                zMerchantBusinessCertificationStep,
+            ]),
+        }),
+    ]),
+]);
 /**
  * MerchantBusinessTestFiscalDocumentRequest
  */