@timbro/invoices 0.10.3 → 0.12.0

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

@@ -25,14 +25,6 @@ function lenientUnion(options) {
         return rest.reduce((best, match) => (propertyCount(match) > propertyCount(best) ? match : best), first);
     });
 }
-export const zActiveCertificateCustodyBindingResource = z.object({
-    binding_id: z.uuid(),
-    certificate_version: z.string().regex(/^[1-9][0-9]*$/),
-    expected_certificate_sha256: z.string().regex(/^[0-9a-f]{64}$/),
-});
-/**
- * Buyer identity alternatives admitted by official conditional Type 33 and Type 34 `Comprador`.
- */
 export const zAffectedFiscalDocumentAttributionResource = lenientUnion([
     z.object({
         fiscal_operation_id: z.uuid(),
@@ -109,20 +101,6 @@ export const zBuyerDeliveryTerminalResultCode = z.enum([
 /**
  * Exporter classification retained as a caller declaration, not authority confirmation.
  */
-export const zCertificateCustodyCertificateResource = z.object({
-    certificate_expires_at: z.iso.datetime(),
-    certificate_sha256: z.string().regex(/^[0-9a-f]{64}$/),
-    certificate_subject_serial_number: z
-        .string()
-        .regex(/^(?:[0-9]{9}|[0-9]{11}|IDCDO-(?:[0-9]{9}|[0-9]{11})|PAS[A-Z]{2}-[A-Za-z0-9]{5,20})$/),
-    effect_replay_retention_seconds: z
-        .int()
-        .gte(1)
-        .max(2147483647, { error: "Invalid value: Expected int32 to be <= 2147483647" }),
-});
-/**
- * Signature algorithm pinned with a certificate-custody binding.
- */
 export const zCertificateCustodySignatureAlgorithm = z.enum(["rsa_sha256"]);
 /**
  * The wire family a Collection page announces.
@@ -246,9 +224,6 @@ export const zEngineProblem = z.object({
     path: z.string(),
 });
 export const zEngineProtocol = z.enum(["timbro.fiscal-engine.v3"]);
-export const zEnrolledCertificateCustodyBindingResource = z.object({
-    binding_id: z.uuid(),
-});
 /**
  * One e-CF document type implemented by this engine protocol revision.
  */
@@ -319,7 +294,8 @@ export const zFiscalAuthorityRoute = z.enum([
     "consumer_summary_reception",
 ]);
 /**
- * Actor-facing buyer-delivery milestone projected from the immutable lifecycle event ledger.
+ * Whether the buyer may receive the e-CF: ready once DGII received it and answered `Aceptado` or
+ * `Aceptado Condicional`, projected from the immutable lifecycle event ledger.
  */
 export const zBuyerDeliveryReadinessResource = lenientUnion([
     z.object({
@@ -407,29 +383,6 @@ export const zAffectedFiscalDocumentResource = z.object({
     issued_on: z.string().regex(/^[0-9]{2}-[0-9]{2}-[0-9]{4}$/),
     issuer_tax_id: z.string().regex(/^[0-9]{9}([0-9]{2})?$/),
 });
-export const zCertificateCustodyReadiness = lenientUnion([
-    z.object({
-        environment: zFiscalEnvironment,
-        legal_issuer_id: z.uuid(),
-        organization_id: z.uuid(),
-        status: z.enum(["not_configured"]),
-    }),
-    z.object({
-        binding: zEnrolledCertificateCustodyBindingResource,
-        environment: zFiscalEnvironment,
-        legal_issuer_id: z.uuid(),
-        organization_id: z.uuid(),
-        status: z.enum(["awaiting_certificate_registration"]),
-    }),
-    z.object({
-        binding: zActiveCertificateCustodyBindingResource,
-        certificate: zCertificateCustodyCertificateResource,
-        environment: zFiscalEnvironment,
-        legal_issuer_id: z.uuid(),
-        organization_id: z.uuid(),
-        status: z.enum(["ready"]),
-    }),
-]);
 export const zDirectConnectionPreviewResource = z.object({
     company_id: z.string(),
     company_name: z.string(),
@@ -565,7 +518,6 @@ export const zFiscalLineTotal = z.object({
  * One ordinary fiscal line whose profile admits only the legal-tip code.
  */
 export const zFiscalNumberAuthorizationKnowledge = z.enum(["verified", "reported"]);
-export const zFiscalNumberAuthorizationReadinessStatus = z.enum(["ready", "action_required"]);
 /**
  * Origin of a fiscal-number authorization fact.
  */
@@ -585,16 +537,6 @@ export const zFiscalNumberAuthorizationState = z.enum([
     "exhausted",
     "conflicting",
 ]);
-export const zFiscalNumberAuthorizationUnavailableReason = z.enum([
-    "authorization_missing",
-    "authorization_not_active",
-    "authorization_not_verified",
-    "authorization_not_observed",
-    "range_exhausted",
-    "authorization_expiration_invalid",
-    "authorization_expired",
-    "authorization_range_overlap",
-]);
 /**
  * Caller instruction that selects how a Fiscal operation obtains its e-NCF.
  *
@@ -736,17 +678,27 @@ export const zHostedImportResponse = z.object({
     object: z.string(),
     signer_subject_serial_number: z.string(),
 });
-export const zHostedInvoiceCredentialEnvironment = z.enum(["sandbox", "production"]);
+export const zHostedInvoiceCredentialEnvironment = z.enum([
+    "sandbox",
+    "certification",
+    "production",
+]);
 export const zHostedInvoiceCredentialResponse = z.object({
     credential: z.string(),
     environment: zHostedInvoiceCredentialEnvironment,
     object: z.string(),
     source_connection_id: z.uuid(),
 });
+export const zHostedReceiverUrls = z.object({
+    base_url: z.string(),
+    commercial_approval_url: z.string(),
+    reception_url: z.string(),
+});
 export const zHostedTenantResource = z.object({
     hosted_tenant_binding_id: z.uuid(),
     legal_issuer_id: z.uuid(),
     organization_id: z.uuid(),
+    receiver_urls: zHostedReceiverUrls,
     source_connection_id: z.uuid(),
     webhook_endpoint_id: z.uuid(),
     webhook_signing_secret: z.string().nullable(),
@@ -830,7 +782,12 @@ export const zInvoiceCorrection = z.object({
     reason: z.string(),
     relationshipKind: zFiscalDocumentRelationshipKind,
 });
+export const zInvoiceDeliveryAttachments = z.object({
+    pdf: z.boolean(),
+    xml: z.boolean(),
+});
 export const zInvoiceDeliveryResource = z.object({
+    attachments: zInvoiceDeliveryAttachments,
     createdAt: z.iso.datetime(),
     id: z.uuid(),
     invoiceId: z.uuid(),
@@ -1014,6 +971,17 @@ export const zInvoiceReceiptAccess = z.object({
 });
 export const zInvoiceReceiptCurrency = z.enum(["DOP"]);
 export const zInvoiceReceiptStatus = z.enum(["accepted", "acceptedWithObservations"]);
+/**
+ * The signature facts DGII requires on every printed e-CF, read from the signed document.
+ *
+ * Print the buyer's copy after DGII accepts the Invoice; DGII sequences the printed e-CF after
+ * its validation result, including the Type 32 below DOP 250,000 it validates by RFCE summary.
+ */
+export const zInvoiceSignature = z.object({
+    securityCode: z.string().regex(/^[A-Za-z0-9+/]{6}$/),
+    signedAt: z.string().regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}-04:00$/),
+    verificationUrl: z.url().regex(/^https:\/\/(ecf|fc)\.dgii\.gov\.do\//),
+});
 export const zInvoiceSource = z.object({
     contentSha256: z.string().regex(/^[0-9a-f]{64}$/),
     id: z.string(),
@@ -2268,6 +2236,7 @@ export const zInvoiceType = z.enum([
 ]);
 export const zInvoiceFiscalIdentity = z.object({
     eNcf: z.string().regex(/^E(31|32|33|34|41|43|44|45|46|47)[0-9]{10}$/),
+    signature: zInvoiceSignature.nullable(),
     type: zInvoiceType,
 });
 export const zInvoiceWebhookEvent = lenientUnion([
@@ -2299,6 +2268,22 @@ export const zInvoiceWebhookEvent = lenientUnion([
         }),
         type: z.enum(["invoice.ready"]),
     }),
+    z.object({
+        data: z.object({
+            deliveryId: z.uuid(),
+            id: z.uuid(),
+            sourceConnectionId: z.uuid(),
+        }),
+        type: z.enum(["invoice.deliverySent"]),
+    }),
+    z.object({
+        data: z.object({
+            deliveryId: z.uuid(),
+            id: z.uuid(),
+            sourceConnectionId: z.uuid(),
+        }),
+        type: z.enum(["invoice.deliveryFailed"]),
+    }),
 ]);
 export const zInvoiceXmlReadiness = lenientUnion([
     z.object({
@@ -2346,6 +2331,20 @@ export const zIssuanceBlocker = z.enum([
     "fiscal_number_before_verified_floor",
     "sequence_expiration_mismatch",
 ]);
+export const zIssuanceReadinessReason = z.enum([
+    "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 const zLedgerCounter = z.string().regex(/^(0|[1-9][0-9]*)$/);
 export const zCertificateCustodyCertificateVersionResource = z.object({
     certificate_custody_certificate_version: zLedgerCounter,
@@ -2428,46 +2427,6 @@ export const zFiscalNumberAuthorizationHistoryResource = z.object({
     environment: zFiscalEnvironment,
     legal_issuer_id: z.uuid(),
 });
-export const zFiscalNumberAuthorizationSelection = z.object({
-    authorization_id: z.uuid(),
-    ends_at: zLedgerCounter,
-    expires_on: z
-        .string()
-        .regex(/^\d{2}-\d{2}-\d{4}$/)
-        .nullable(),
-    next_available_sequence: zLedgerCounter,
-    remaining_capacity: z.number().gte(0),
-    starts_at: zLedgerCounter,
-    state: zFiscalNumberAuthorizationState,
-    verified_next_unused: zFiscalNumberAuthorizationNextUnused,
-});
-export const zFiscalNumberAuthorizationTypeReadiness = z.object({
-    document_type: zElectronicFiscalDocumentType,
-    selected: zFiscalNumberAuthorizationSelection.nullable(),
-    status: zFiscalNumberAuthorizationReadinessStatus,
-    unavailable_reason: zFiscalNumberAuthorizationUnavailableReason.nullable(),
-});
-export const zFiscalNumberAuthorizationDocumentReadiness = z.object({
-    e31: zFiscalNumberAuthorizationTypeReadiness,
-    e32: zFiscalNumberAuthorizationTypeReadiness,
-    e33: zFiscalNumberAuthorizationTypeReadiness,
-    e34: zFiscalNumberAuthorizationTypeReadiness,
-    e41: zFiscalNumberAuthorizationTypeReadiness,
-    e43: zFiscalNumberAuthorizationTypeReadiness,
-    e44: zFiscalNumberAuthorizationTypeReadiness,
-    e45: zFiscalNumberAuthorizationTypeReadiness,
-    e46: zFiscalNumberAuthorizationTypeReadiness,
-    e47: zFiscalNumberAuthorizationTypeReadiness,
-});
-export const zFiscalNumberAuthorizationReadiness = z.object({
-    documents: zFiscalNumberAuthorizationDocumentReadiness,
-    effective_on: z.iso.date(),
-    environment: zFiscalEnvironment,
-    issuer_tax_id: z.string().regex(/^[0-9]{9}([0-9]{2})?$/),
-    legal_issuer_id: z.uuid(),
-    object: z.string(),
-    source_connection_id: z.uuid(),
-});
 export const zLegalIssuerVerification = z.enum(["verified", "unverified"]);
 export const zLegalIssuer = z.object({
     address: z
@@ -2593,6 +2552,23 @@ export const zNotReceivedReason = z.enum([
 /**
  * Numbering values resolved before deterministic fiscal-document construction.
  */
+export const zNumberingRange = z.object({
+    expiresOn: z.iso.date().nullable(),
+    remaining: z.int().gte(1).lte(9999999999),
+});
+export const zDocumentTypeIssuanceReadiness = lenientUnion([
+    z.object({
+        numbering: zNumberingRange,
+        status: z.enum(["ready"]),
+        type: zInvoiceType,
+    }),
+    z.object({
+        numbering: zNumberingRange.nullable(),
+        reasons: z.array(zIssuanceReadinessReason).min(1),
+        status: z.enum(["actionRequired"]),
+        type: zInvoiceType,
+    }),
+]);
 export const zOnboardingLegalIssuerIdentityOutcome = lenientUnion([
     z.object({
         status: z.enum(["not_started"]),
@@ -3001,6 +2977,41 @@ export const zSignedDocumentReadinessResource = lenientUnion([
         status: z.enum(["ready"]),
     }),
 ]);
+/**
+ * The active signing certificate, judged at the moment of the read.
+ */
+export const zSigningCertificateReadiness = lenientUnion([
+    z.object({
+        notAfter: z.iso.datetime(),
+        notBefore: z.iso.datetime(),
+        sha256: z.string().regex(/^[0-9a-f]{64}$/),
+        status: z.enum(["ready"]),
+    }),
+    z.object({
+        notAfter: z.iso.datetime(),
+        notBefore: z.iso.datetime(),
+        sha256: z.string().regex(/^[0-9a-f]{64}$/),
+        status: z.enum(["expired"]),
+    }),
+    z.object({
+        notAfter: z.iso.datetime(),
+        notBefore: z.iso.datetime(),
+        sha256: z.string().regex(/^[0-9a-f]{64}$/),
+        status: z.enum(["notYetValid"]),
+    }),
+    z.object({
+        status: z.enum(["missing"]),
+    }),
+]);
+/**
+ * Whether the issuer can issue each e-CF type now in this environment.
+ */
+export const zIssuanceReadiness = z.object({
+    certificate: zSigningCertificateReadiness,
+    documentTypes: z.array(zDocumentTypeIssuanceReadiness),
+    environment: zFiscalEnvironment,
+    issuerTaxId: z.string().regex(/^[0-9]{9}([0-9]{2})?$/),
+});
 /**
  * Named additional taxes supported by the common Source contract.
  */
@@ -4484,6 +4495,36 @@ export const zInvoiceWebhookEventEnvelope = lenientUnion([
         sequence: z.string().regex(/^[1-9][0-9]*$/),
         type: z.enum(["invoice.ready"]),
     }),
+    z.object({
+        apiVersion: z.string().refine((text) => Array.from(text).length >= 1),
+        data: z.object({
+            deliveryId: z.uuid(),
+            id: z.uuid(),
+            sourceConnectionId: z.uuid(),
+        }),
+        environment: zFiscalEnvironment,
+        id: z.uuid(),
+        object: zWebhookEventObject,
+        occurredAt: z.iso.datetime(),
+        organizationId: z.uuid(),
+        sequence: z.string().regex(/^[1-9][0-9]*$/),
+        type: z.enum(["invoice.deliverySent"]),
+    }),
+    z.object({
+        apiVersion: z.string().refine((text) => Array.from(text).length >= 1),
+        data: z.object({
+            deliveryId: z.uuid(),
+            id: z.uuid(),
+            sourceConnectionId: z.uuid(),
+        }),
+        environment: zFiscalEnvironment,
+        id: z.uuid(),
+        object: zWebhookEventObject,
+        occurredAt: z.iso.datetime(),
+        organizationId: z.uuid(),
+        sequence: z.string().regex(/^[1-9][0-9]*$/),
+        type: z.enum(["invoice.deliveryFailed"]),
+    }),
 ]);
 export const zReceptionWebhookEventEnvelope = lenientUnion([
     z.object({
@@ -4617,6 +4658,36 @@ export const zWebhookEventEnvelope = lenientUnion([
         sequence: z.string().regex(/^[1-9][0-9]*$/),
         type: z.enum(["invoice.ready"]),
     }),
+    z.object({
+        apiVersion: z.string().refine((text) => Array.from(text).length >= 1),
+        data: z.object({
+            deliveryId: z.uuid(),
+            id: z.uuid(),
+            sourceConnectionId: z.uuid(),
+        }),
+        environment: zFiscalEnvironment,
+        id: z.uuid(),
+        object: zWebhookEventObject,
+        occurredAt: z.iso.datetime(),
+        organizationId: z.uuid(),
+        sequence: z.string().regex(/^[1-9][0-9]*$/),
+        type: z.enum(["invoice.deliverySent"]),
+    }),
+    z.object({
+        apiVersion: z.string().refine((text) => Array.from(text).length >= 1),
+        data: z.object({
+            deliveryId: z.uuid(),
+            id: z.uuid(),
+            sourceConnectionId: z.uuid(),
+        }),
+        environment: zFiscalEnvironment,
+        id: z.uuid(),
+        object: zWebhookEventObject,
+        occurredAt: z.iso.datetime(),
+        organizationId: z.uuid(),
+        sequence: z.string().regex(/^[1-9][0-9]*$/),
+        type: z.enum(["invoice.deliveryFailed"]),
+    }),
     z.object({
         apiVersion: z.string().refine((text) => Array.from(text).length >= 1),
         data: z.object({
@@ -4886,6 +4957,7 @@ export const zDownloadHostedInvoicePdfResponse = zFiscalArtifactBytes;
 export const zDownloadHostedInvoiceXmlResponse = zFiscalArtifactBytes;
 export const zShareHostedInvoiceReceiptResponse = zInvoiceReceiptAccess;
 export const zReplaceHostedInvoiceResponse = zInvoiceResource;
+export const zRetrieveHostedIssuanceReadinessResponse = zIssuanceReadiness;
 export const zListFiscalOperationsResponse = zSourceFiscalOperationPage;
 /**
  * One immutable Source sales or correction command. A Source connection credential sends the command alone. A trusted first-party service sends it inside request beside checkout_tenant_id and environment, which name the hosted binding selecting the Source connection.
@@ -4895,19 +4967,11 @@ export const zFindFiscalOperationBySourceResponse = zFiscalOperationResource;
 export const zFindFiscalOperationResponse = zFiscalOperationResource;
 export const zFindFiscalArtifactResponse = zFiscalArtifactBytes;
 export const zReadFiscalOperationTimingResponse = zFiscalOperationTimingReport;
-/**
- * The authenticated tenant's certificate-custody readiness resource.
- */
-export const zReadCertificateCustodyReadinessResponse = zCertificateCustodyReadiness;
 export const zCreateDirectConnectionRequestResponse = zDirectConnectionRequestResource;
 export const zCancelDirectConnectionRequestResponse = z.void();
 export const zPollDirectConnectionRequestResponse = zDirectConnectionPollResource;
 export const zReadElectronicFiscalDocumentEligibilityResponse = zElectronicFiscalDocumentEligibilityResource;
 export const zRetrieveFiscalDeliveryPrintedRepresentationResponse = z.instanceof(Uint8Array);
-/**
- * Current central fiscal-number ranges and actionable availability for the authenticated Source connection's issuer and environment.
- */
-export const zReadFiscalNumberAuthorizationReadinessResponse = zFiscalNumberAuthorizationReadiness;
 export const zImportHostedCertificateCustodyResponse = zHostedImportResponse;
 export const zIssueHostedInvoiceCredentialResponse = zHostedInvoiceCredentialResponse;
 export const zAcceptInvitationResponse = zMembershipAcceptance;
@@ -4923,6 +4987,10 @@ export const zDownloadInvoicePdfResponse = zFiscalArtifactBytes;
 export const zDownloadInvoiceXmlResponse = zFiscalArtifactBytes;
 export const zShareInvoiceReceiptResponse = zInvoiceReceiptAccess;
 export const zReplaceInvoiceResponse = zInvoiceResource;
+/**
+ * Whether the Source connection's issuer can issue each e-CF type now, with every blocking reason.
+ */
+export const zRetrieveIssuanceReadinessResponse = zIssuanceReadiness;
 export const zCreateOrganizationResponse = zOrganizationResource;
 export const zReadAuditEventsResponse = zAuditEventPage;
 export const zListCertificateCustodyBindingsResponse = zCertificateCustodyBindingPage;
@@ -4985,6 +5053,8 @@ export const recognizedWebhookEventTypes = [
     "fiscal_reception.not_received",
     "fiscal_reception.received",
     "invoice.accepted",
+    "invoice.deliveryFailed",
+    "invoice.deliverySent",
     "invoice.operatorRequired",
     "invoice.ready",
     "invoice.rejected",