@timbro/invoices 0.12.0 → 0.13.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}$/),
@@ -753,6 +766,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 +779,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 +967,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 +1020,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.
  *
@@ -2494,6 +2668,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(),
@@ -2633,7 +2810,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 +3122,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 +3152,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 +3326,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 +3358,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 +3394,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 +3413,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 +3424,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 +3444,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 +3456,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 +3476,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 +3487,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 +3507,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 +3518,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 +3538,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 +3549,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 +3569,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 +3580,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 +3600,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 +4395,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 +5163,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;