@timbro/invoices 0.12.0 → 0.14.0-next.0

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

@@ -102,6 +102,19 @@ export const zBuyerDeliveryTerminalResultCode = z.enum([
  * Exporter classification retained as a caller declaration, not authority confirmation.
  */
 export const zCertificateCustodySignatureAlgorithm = z.enum(["rsa_sha256"]);
+export const zCertificationTestSetKind = z.enum(["ecf"]);
+export const zCertificationTestSetObject = z.enum(["certification_test_set"]);
+export const zCertificationTestSetRequirement = z.enum(["case_mapping_pending"]);
+export const zCertificationWorksheetName = z.enum(["ECF", "RFCE"]);
+export const zCertificationWorksheetSummary = z.object({
+    caseCount: z.int().gte(1).lte(1000),
+    name: zCertificationWorksheetName,
+});
+export const zCertificationTestSetReview = z.object({
+    requirements: z.array(zCertificationTestSetRequirement),
+    status: z.enum(["review_required"]),
+    worksheets: z.array(zCertificationWorksheetSummary),
+});
 /**
  * The wire family a Collection page announces.
  */
@@ -506,7 +519,7 @@ export const zFiscalLifecycleResultCode = z.enum([
     "fiscal_signing_retry_requested",
 ]);
 /**
- * One fiscal line admitted by sales and adjustment document profiles.
+ * Deterministic totals calculated for one fiscal line.
  */
 export const zFiscalLineTotal = z.object({
     net: z.string().regex(/^-?[0-9]+\.[0-9]{2}$/),
@@ -517,7 +530,7 @@ 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 zFiscalNumberAuthorizationKnowledge = z.enum(["verified", "reported", "disputed"]);
 /**
  * Origin of a fiscal-number authorization fact.
  */
@@ -525,6 +538,7 @@ export const zFiscalNumberAuthorizationSourceKind = z.enum([
     "official_source_manifest",
     "operator_attested",
     "caller_reported",
+    "dgii_response",
 ]);
 /**
  * Lifecycle state of a fiscal-number authorization fact.
@@ -753,6 +767,10 @@ export const zInvoiceBuyerIdentity = lenientUnion([
         kind: z.enum(["anonymous"]),
     }),
     z.object({
+        deliveryPhone: z
+            .string()
+            .regex(/^[0-9]{3}-[0-9]{3}-[0-9]{4}$/)
+            .optional(),
         kind: z.enum(["domestic"]),
         legalName: z
             .string()
@@ -762,6 +780,10 @@ export const zInvoiceBuyerIdentity = lenientUnion([
         taxId: z.string().regex(/^[0-9]{9}([0-9]{2})?$/),
     }),
     z.object({
+        deliveryPhone: z
+            .string()
+            .regex(/^[0-9]{3}-[0-9]{3}-[0-9]{4}$/)
+            .optional(),
         foreignId: z
             .string()
             .refine((text) => Array.from(text).length >= 1)
@@ -946,6 +968,34 @@ export const zInvoiceLatestEvent = z.object({
     occurredAt: z.iso.datetime(),
     sequence: z.string().regex(/^[1-9][0-9]*$/),
 });
+export const zInvoiceLinePriceAdjustmentResource = lenientUnion([
+    z.object({
+        amount: z.string().regex(/^[0-9]{1,16}(\.[0-9]{1,2})?$/),
+        kind: z.enum(["fixed_amount"]),
+    }),
+    z.object({
+        kind: z.enum(["percentage"]),
+        percentage: z.string().regex(/^(?=[0-9.]*[1-9])[0-9]{1,3}(\.[0-9]{1,2})?$/),
+    }),
+]);
+export const zInvoiceLinePriceAdjustmentsResource = z.object({
+    discounts: z.array(zInvoiceLinePriceAdjustmentResource),
+    surcharges: z.array(zInvoiceLinePriceAdjustmentResource),
+});
+export const zInvoicePaymentAccountResource = z.object({
+    accountNumber: z
+        .string()
+        .refine((text) => Array.from(text).length >= 1)
+        .refine((text) => Array.from(text).length <= 28)
+        .regex(/^(?=.*[^\p{White_Space}])[\s\S]+$/u)
+        .nullable(),
+    bankName: z
+        .string()
+        .refine((text) => Array.from(text).length >= 1)
+        .refine((text) => Array.from(text).length <= 75)
+        .regex(/^(?=.*[^\p{White_Space}])[\s\S]+$/u)
+        .nullable(),
+});
 export const zInvoicePdfLayout = z.enum(["a4", "receipt80mm"]);
 export const zInvoicePdfStage = z.enum([
     "awaitingSignedSource",
@@ -971,6 +1021,131 @@ export const zInvoiceReceiptAccess = z.object({
 });
 export const zInvoiceReceiptCurrency = z.enum(["DOP"]);
 export const zInvoiceReceiptStatus = z.enum(["accepted", "acceptedWithObservations"]);
+export const zInvoiceReferenceAttributionResource = lenientUnion([
+    z.object({
+        fiscalOperationId: z
+            .string()
+            .regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/),
+        kind: z.enum(["internal_operation"]),
+    }),
+    z.object({
+        environment: zFiscalEnvironment,
+        issuerTaxId: z.string().regex(/^[0-9]{9}([0-9]{2})?$/),
+        kind: z.enum(["external_document"]),
+        sourceReference: z
+            .string()
+            .refine((text) => Array.from(text).length >= 1)
+            .refine((text) => Array.from(text).length <= 250)
+            .regex(/^(?=.*[^\p{White_Space}])[\s\S]+$/u),
+    }),
+]);
+export const zInvoiceReferenceInformationResource = z.object({
+    attribution: zInvoiceReferenceAttributionResource,
+    fiscalNumber: z.string().regex(/^(B[0-9]{10}|E[0-9]{12}|[AP][0-9]{18})$/),
+    issuedOn: z
+        .string()
+        .regex(/^(?:(?:31-(?:0?[13578]|1[02])|(?:29|30)-(?:0?[13-9]|1[0-2])|(?:0?[1-9]|1[0-9]|2[0-8])-(?:0?[1-9]|1[0-2]))-(?:19|20)[0-9]{2}|29-0?2-(?:(?:19|20)(?:0[48]|[2468][048]|[13579][26])|2000))$/),
+    modificationCode: z.enum(["4", "5"]),
+});
+export const zInvoiceShipmentInformationResource = z.object({
+    containerNumber: z
+        .string()
+        .refine((text) => Array.from(text).length >= 1)
+        .refine((text) => Array.from(text).length <= 100)
+        .regex(/^(?=.*[^\p{White_Space}])[\s\S]+$/u)
+        .nullable(),
+    deliveryNoteNumber: z
+        .string()
+        .refine((text) => Array.from(text).length >= 1)
+        .refine((text) => Array.from(text).length <= 20)
+        .regex(/^(?=.*[^\p{White_Space}])[\s\S]+$/u)
+        .nullable(),
+    driver: z
+        .string()
+        .refine((text) => Array.from(text).length >= 1)
+        .refine((text) => Array.from(text).length <= 20)
+        .regex(/^(?=.*[^\p{White_Space}])[\s\S]+$/u)
+        .nullable(),
+    grossWeight: z
+        .string()
+        .regex(/^[0-9]{1,16}(\.[0-9]{1,2})?$/)
+        .nullable(),
+    grossWeightUnit: z
+        .string()
+        .regex(/^([1-9]|[1-5][0-9]|6[0-2])$/)
+        .nullable(),
+    netWeight: z
+        .string()
+        .regex(/^[0-9]{1,16}(\.[0-9]{1,2})?$/)
+        .nullable(),
+    netWeightUnit: z
+        .string()
+        .regex(/^([1-9]|[1-5][0-9]|6[0-2])$/)
+        .nullable(),
+    packageCount: z
+        .string()
+        .regex(/^[0-9]{1,16}(\.[0-9]{1,2})?$/)
+        .nullable(),
+    packageUnit: z
+        .string()
+        .regex(/^([1-9]|[1-5][0-9]|6[0-2])$/)
+        .nullable(),
+    packageVolume: z
+        .string()
+        .regex(/^(?=[0-9.]*[1-9])[0-9]{1,16}(\.[0-9]{1,2})?$/)
+        .nullable(),
+    route: z
+        .string()
+        .refine((text) => Array.from(text).length >= 1)
+        .refine((text) => Array.from(text).length <= 20)
+        .regex(/^(?=.*[^\p{White_Space}])[\s\S]+$/u)
+        .nullable(),
+    shipmentDate: z
+        .string()
+        .regex(/^(?:(?:31-(?:0?[13578]|1[02])|(?:29|30)-(?:0?[13-9]|1[0-2])|(?:0?[1-9]|1[0-9]|2[0-8])-(?:0?[1-9]|1[0-2]))-(?:19|20)[0-9]{2}|29-0?2-(?:(?:19|20)(?:0[48]|[2468][048]|[13579][26])|2000))$/)
+        .nullable(),
+    shipmentNumber: z
+        .string()
+        .refine((text) => Array.from(text).length >= 1)
+        .refine((text) => Array.from(text).length <= 25)
+        .regex(/^(?=.*[^\p{White_Space}])[\s\S]+$/u)
+        .nullable(),
+    transportDocumentNumber: z
+        .string()
+        .refine((text) => Array.from(text).length >= 1)
+        .refine((text) => Array.from(text).length <= 20)
+        .regex(/^[0-9]+$/)
+        .nullable(),
+    transportZone: z
+        .string()
+        .refine((text) => Array.from(text).length >= 1)
+        .refine((text) => Array.from(text).length <= 20)
+        .regex(/^(?=.*[^\p{White_Space}])[\s\S]+$/u)
+        .nullable(),
+    vehicleFiche: z
+        .string()
+        .refine((text) => Array.from(text).length >= 1)
+        .refine((text) => Array.from(text).length <= 10)
+        .regex(/^(?=.*[^\p{White_Space}])[\s\S]+$/u)
+        .nullable(),
+    vehiclePlate: z
+        .string()
+        .refine((text) => Array.from(text).length >= 1)
+        .refine((text) => Array.from(text).length <= 7)
+        .regex(/^(?=.*[^\p{White_Space}])[\s\S]+$/u)
+        .nullable(),
+    volumeUnit: z
+        .string()
+        .regex(/^([1-9]|[1-5][0-9]|6[0-2])$/)
+        .nullable(),
+});
+export const zInvoiceAdditionalInformationResource = z.object({
+    referenceNumber: z
+        .string()
+        .refine((text) => Array.from(text).length <= 20)
+        .nullable(),
+    shipment: zInvoiceShipmentInformationResource.nullable(),
+});
 /**
  * The signature facts DGII requires on every printed e-CF, read from the signed document.
  *
@@ -2322,7 +2497,7 @@ export const zIssuanceBlocker = z.enum([
     "authorization_exhausted",
     "authorization_conflicting",
     "authorization_document_type_mismatch",
-    "central_assignment_requires_verified_authorization",
+    "sequence_rejected_by_dgii",
     "authorization_expired",
     "authorization_range_overlap",
     "fiscal_number_capacity_exhausted",
@@ -2338,7 +2513,7 @@ export const zIssuanceReadinessReason = z.enum([
     "signing_certificate_not_yet_valid",
     "authorization_missing",
     "authorization_not_active",
-    "authorization_not_verified",
+    "sequence_rejected_by_dgii",
     "authorization_not_observed",
     "range_exhausted",
     "authorization_expiration_invalid",
@@ -2494,6 +2669,9 @@ export const zLegalIssuerPage = z.object({
 export const zLegalIssuerResource = z.object({
     legal_issuer: zLegalIssuer,
 });
+/**
+ * One fixed-amount or percentage discount or surcharge on a fiscal line.
+ */
 export const zMembershipRole = z.enum(["administrator", "operator"]);
 export const zAcceptedMembership = z.object({
     organization_id: z.uuid(),
@@ -2552,7 +2730,12 @@ export const zNotReceivedReason = z.enum([
 /**
  * Numbering values resolved before deterministic fiscal-document construction.
  */
+export const zNumberingConfirmation = z.enum(["confirmed", "not_yet_confirmed"]);
+/**
+ * The range Timbro assigns the next fiscal number of this type from.
+ */
 export const zNumberingRange = z.object({
+    confirmation: zNumberingConfirmation,
     expiresOn: z.iso.date().nullable(),
     remaining: z.int().gte(1).lte(9999999999),
 });
@@ -2633,7 +2816,7 @@ export const zOrganizationResource = z.object({
     organization: zOrganizationIdentity,
 });
 /**
- * One authoritative payment-method and amount pair from `TablaFormasPago`.
+ * Bank details that accompany an optional payment method table.
  */
 export const zPrintedRepresentationA4ProfileVersion = z.enum(["a4.v1"]);
 /**
@@ -2945,6 +3128,24 @@ export const zRequirementId = z.enum([
     "first_fiscal_operation",
 ]);
 export const zRequirementStatus = z.enum(["complete", "pending", "blocked", "action_required"]);
+export const zRetainedCertificationWorkbook = z.object({
+    name: z.string(),
+    sha256: z.string().regex(/^[0-9a-f]{64}$/),
+    sizeBytes: z.int().gte(1).lte(3145728),
+});
+export const zCertificationTestSetResource = z.object({
+    attemptReference: z.string(),
+    createdAt: z.iso.datetime(),
+    file: zRetainedCertificationWorkbook,
+    generation: z.string().regex(/^[1-9][0-9]*$/),
+    id: z.uuid(),
+    kind: zCertificationTestSetKind,
+    object: zCertificationTestSetObject,
+    review: zCertificationTestSetReview,
+});
+export const zCurrentCertificationTestSet = z.object({
+    current: zCertificationTestSetResource.nullable(),
+});
 export const zSchemaValidationDiagnosticCode = z.enum([
     "document_xml_unreadable",
     "document_schema_rejected",
@@ -2957,6 +3158,9 @@ export const zSchemaValidationOutcome = z.enum(["succeeded", "failed"]);
  * Stage at which a fiscal XML artifact was validated.
  */
 export const zSchemaValidationStage = z.enum(["unsigned", "signed"]);
+/**
+ * Typed shipping and transport facts admitted by the official `InformacionesAdicionales` area.
+ */
 export const zSignedDocumentReadinessResource = lenientUnion([
     z.object({
         status: z.enum(["not_applicable"]),
@@ -3128,6 +3332,7 @@ export const zSourceFiscalOperationPage = z.object({
 export const zSourceItemKind = z.enum(["good", "service"]);
 export const zInvoiceItemResource = z.object({
     additionalTaxCodes: z.array(z.string()),
+    adjustments: zInvoiceLinePriceAdjustmentsResource.nullable(),
     description: z.string(),
     id: z.string(),
     itemCodes: z.array(zInvoiceItemCodeResource),
@@ -3159,6 +3364,7 @@ export const zInvoicePaymentAllocation = z.object({
 export const zInvoicePaymentTermsResource = lenientUnion([
     z.object({
         allocations: z.array(zInvoicePaymentAllocation).max(7),
+        paymentAccount: zInvoicePaymentAccountResource.optional(),
         type: z.enum(["immediate"]),
     }),
     z.object({
@@ -3194,6 +3400,7 @@ export const zInvoiceReceipt = z.object({
 export const zInvoiceResource = lenientUnion([
     z.object({
         acceptedAt: z.iso.datetime().nullable(),
+        additionalInformation: zInvoiceAdditionalInformationResource.nullable(),
         buyer: zInvoiceBuyerIdentity.nullable(),
         buyerDeliveryReadiness: zInvoiceBuyerDeliveryReadiness,
         corrections: z.array(zInvoiceCorrection),
@@ -3212,6 +3419,7 @@ export const zInvoiceResource = lenientUnion([
         latestEvent: zInvoiceLatestEvent.nullable(),
         originalInvoiceId: z.uuid().nullable(),
         paymentTerms: zInvoicePaymentTermsResource.nullable(),
+        referenceInformation: zInvoiceReferenceInformationResource.nullable(),
         replacesInvoiceId: z.uuid().nullable(),
         source: zInvoiceSource,
         status: z.enum(["rejected"]),
@@ -3222,6 +3430,7 @@ export const zInvoiceResource = lenientUnion([
     }),
     z.object({
         acceptedAt: z.iso.datetime().nullable(),
+        additionalInformation: zInvoiceAdditionalInformationResource.nullable(),
         buyer: zInvoiceBuyerIdentity.nullable(),
         buyerDeliveryReadiness: zInvoiceBuyerDeliveryReadiness,
         corrections: z.array(zInvoiceCorrection),
@@ -3241,6 +3450,7 @@ export const zInvoiceResource = lenientUnion([
         latestEvent: zInvoiceLatestEvent.nullable(),
         originalInvoiceId: z.uuid().nullable(),
         paymentTerms: zInvoicePaymentTermsResource.nullable(),
+        referenceInformation: zInvoiceReferenceInformationResource.nullable(),
         replacesInvoiceId: z.uuid().nullable(),
         source: zInvoiceSource,
         stage: zInvoiceProcessingStage,
@@ -3252,6 +3462,7 @@ export const zInvoiceResource = lenientUnion([
     }),
     z.object({
         acceptedAt: z.iso.datetime().nullable(),
+        additionalInformation: zInvoiceAdditionalInformationResource.nullable(),
         buyer: zInvoiceBuyerIdentity.nullable(),
         buyerDeliveryReadiness: zInvoiceBuyerDeliveryReadiness,
         corrections: z.array(zInvoiceCorrection),
@@ -3271,6 +3482,7 @@ export const zInvoiceResource = lenientUnion([
         latestEvent: zInvoiceLatestEvent.nullable(),
         originalInvoiceId: z.uuid().nullable(),
         paymentTerms: zInvoicePaymentTermsResource.nullable(),
+        referenceInformation: zInvoiceReferenceInformationResource.nullable(),
         replacesInvoiceId: z.uuid().nullable(),
         source: zInvoiceSource,
         status: z.enum(["verifying"]),
@@ -3281,6 +3493,7 @@ export const zInvoiceResource = lenientUnion([
     }),
     z.object({
         acceptedAt: z.iso.datetime().nullable(),
+        additionalInformation: zInvoiceAdditionalInformationResource.nullable(),
         buyer: zInvoiceBuyerIdentity.nullable(),
         buyerDeliveryReadiness: zInvoiceBuyerDeliveryReadiness,
         corrections: z.array(zInvoiceCorrection),
@@ -3300,6 +3513,7 @@ export const zInvoiceResource = lenientUnion([
         latestEvent: zInvoiceLatestEvent.nullable(),
         originalInvoiceId: z.uuid().nullable(),
         paymentTerms: zInvoicePaymentTermsResource.nullable(),
+        referenceInformation: zInvoiceReferenceInformationResource.nullable(),
         replacesInvoiceId: z.uuid().nullable(),
         source: zInvoiceSource,
         status: z.enum(["accepted"]),
@@ -3310,6 +3524,7 @@ export const zInvoiceResource = lenientUnion([
     }),
     z.object({
         acceptedAt: z.iso.datetime().nullable(),
+        additionalInformation: zInvoiceAdditionalInformationResource.nullable(),
         buyer: zInvoiceBuyerIdentity.nullable(),
         buyerDeliveryReadiness: zInvoiceBuyerDeliveryReadiness,
         corrections: z.array(zInvoiceCorrection),
@@ -3329,6 +3544,7 @@ export const zInvoiceResource = lenientUnion([
         latestEvent: zInvoiceLatestEvent.nullable(),
         originalInvoiceId: z.uuid().nullable(),
         paymentTerms: zInvoicePaymentTermsResource.nullable(),
+        referenceInformation: zInvoiceReferenceInformationResource.nullable(),
         replacesInvoiceId: z.uuid().nullable(),
         source: zInvoiceSource,
         status: z.enum(["acceptedWithObservations"]),
@@ -3339,6 +3555,7 @@ export const zInvoiceResource = lenientUnion([
     }),
     z.object({
         acceptedAt: z.iso.datetime().nullable(),
+        additionalInformation: zInvoiceAdditionalInformationResource.nullable(),
         buyer: zInvoiceBuyerIdentity.nullable(),
         buyerDeliveryReadiness: zInvoiceBuyerDeliveryReadiness,
         corrections: z.array(zInvoiceCorrection),
@@ -3358,6 +3575,7 @@ export const zInvoiceResource = lenientUnion([
         latestEvent: zInvoiceLatestEvent.nullable(),
         originalInvoiceId: z.uuid().nullable(),
         paymentTerms: zInvoicePaymentTermsResource.nullable(),
+        referenceInformation: zInvoiceReferenceInformationResource.nullable(),
         replacesInvoiceId: z.uuid().nullable(),
         source: zInvoiceSource,
         status: z.enum(["authorityRejected"]),
@@ -3368,6 +3586,7 @@ export const zInvoiceResource = lenientUnion([
     }),
     z.object({
         acceptedAt: z.iso.datetime().nullable(),
+        additionalInformation: zInvoiceAdditionalInformationResource.nullable(),
         buyer: zInvoiceBuyerIdentity.nullable(),
         buyerDeliveryReadiness: zInvoiceBuyerDeliveryReadiness,
         corrections: z.array(zInvoiceCorrection),
@@ -3387,6 +3606,7 @@ export const zInvoiceResource = lenientUnion([
         latestEvent: zInvoiceLatestEvent.nullable(),
         originalInvoiceId: z.uuid().nullable(),
         paymentTerms: zInvoicePaymentTermsResource.nullable(),
+        referenceInformation: zInvoiceReferenceInformationResource.nullable(),
         replacesInvoiceId: z.uuid().nullable(),
         source: zInvoiceSource,
         status: z.enum(["operatorRequired"]),
@@ -4181,7 +4401,7 @@ export const zTimingWork = z.object({
     work_id: z.string().regex(/^[0-9a-f]{64}$/),
 });
 /**
- * Factura de Crédito Fiscal Electrónica, code 31.
+ * A Type 31 line with its profile-permitted line-level discounts and surcharges.
  */
 export const zUserAccountIdentity = z.object({
     created_at: z.iso.datetime(),
@@ -4949,6 +5169,8 @@ export const zWorkspaceFiscalOperationResource = z.object({
 export const zCreateHostedTenantResponse = zHostedTenantResource;
 export const zReleaseHostedTenantResponse = zReleasedHostedTenant;
 export const zCreateHostedTenantWebhookSecretRotationResponse = zHostedWebhookSecretRotation;
+export const zUploadHostedCertificationTestSetResponse = zCertificationTestSetResource;
+export const zRetrieveHostedCertificationTestSetResponse = zCurrentCertificationTestSet;
 export const zListHostedInvoicesResponse = zInvoicePage;
 export const zCreateHostedInvoiceResponse = zInvoiceResource;
 export const zPreviewHostedInvoiceResponse = zInvoicePreview;