evo360-types 1.3.662 → 1.3.667

package/dist/apps/evo-finops/zod-schemas.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.zServiceTaxInfoSchema = exports.zServiceLineItemSchema = exports.zServiceInvoiceStateSchema = exports.zProviderServiceInvoiceStatusSchema = exports.zExternalLinkSchema = exports.zExternalObjectTypeSchema = exports.zInvoiceSourceRefSchema = exports.zInvoiceSourceTypeSchema = exports.zInvoiceTakerRefSchema = exports.zInvoiceTakerSnapshotSchema = exports.zInvoiceTakerSnapshotAddressSchema = exports.zTakerDocumentSchema = exports.zTakerTaxProfileSchema = exports.zTakerProviderRefsSchema = exports.zTakerAddressSchema = exports.zInvoiceTakerTypeSchema = exports.zServiceSchema = exports.zCustomerServiceTaxInfoSchema = exports.zIssuerTaxProfileSchema = exports.zIssuerNfseConfigSchema = exports.zIssuerMunicipalCredentialsRefSchema = exports.zIssuerTaxRegimeSchema = exports.zIssuerCompanyIdentitySchema = exports.zIssuerCompanyAddressSchema = exports.zTaxProfileSyncStateSchema = exports.zAsaasProviderSchema = exports.zAsaasProviderAsaasBlockSchema = exports.zAsaasProviderCapabilitiesSchema = exports.zAsaasPaymentsCapabilitiesSchema = exports.zAsaasEnvFlagSchema = exports.zAsaasNfseCapabilitiesSchema = exports.zAsaasEnvAuthConfigSchema = exports.zAsaasSubaccountInputSchema = exports.zAsaasAccountScopeSchema = exports.zAsaasWebhookConfigSchema = exports.zRetryPolicySchema = exports.zAsaasWebhookEventSchema = exports.zAsaasAccountScopeModeSchema = exports.zProviderRemoteRefsSchema = exports.zProviderFiscalInfoPayloadSchema = exports.zProviderCredentialsInputSchema = exports.zProviderCredentialsSecretRefsSchema = exports.zProviderMunicipalOptionsSnapshotSchema = exports.zProviderOptionItemSchema = exports.zProviderMunicipalAuthTypeSchema = exports.zFinopsProviderBaseSchema = exports.zProviderStatusSchema = exports.zFinopsActionSchema = exports.zFinopsProviderTypeSchema = exports.zProviderEnvSchema = void 0;
-exports.zNexFinopsPaymentMethodsDiscoverSchema = exports.zEvoBillingPortalCardCaptureSchema = exports.zNexFinopsBillingCardChargeSchema = exports.zNexFinopsContractPaymentMethodsWriteSchema = exports.zNexFinopsPaymentMethodPatchSchema = exports.zNexFinopsPaymentMethodStatusSchema = exports.zNexFinopsPaymentMethodKindSchema = exports.zNexFinopsContractAllowancesWriteSchema = exports.zNexFinopsUsageAlertDefaultsSchema = exports.zNexFinopsAlertThresholdSchema = exports.zNexFinopsContractAllowancesSchema = exports.zNexFinopsContractAllowanceSchema = exports.zNexVendasJourneyPaymentSchema = exports.zNexVendasJourneyPaymentSupersededSchema = exports.zNexVendasJourneyPaymentWebhookEventSchema = exports.zNexVendasJourneyBoletoSchema = exports.zNexVendasJourneyPaymentChooseSchema = exports.zNexVendasJourneyPaymentStateSchema = exports.zNexVendasJourneyPaymentKindSchema = exports.zNexVendasJourneyPaymentMethodSchema = exports.zNexFinopsContractAsaasInfoSchema = exports.zNexFinopsAsaasSubscriptionStatusSchema = exports.zNexFinopsPaymentMethodSchema = exports.zNexFinopsProposalSchema = exports.zNexFinopsProposalWriteSchema = exports.zNexFinopsProposalPrefillSchema = exports.zNexFinopsProposalLoyaltyPeriodSchema = exports.zNexFinopsProposalPaymentMethodSchema = exports.zNexFinopsProposalStatusSchema = exports.zServiceInvoiceSchema = exports.zPaymentLinkSchema = exports.zPaymentLinkDocumentStateSchema = exports.zAsaasPaymentLinkSubscriptionCycleSchema = exports.zAsaasPaymentLinkChargeTypeSchema = exports.zAsaasPaymentLinkBillingTypeSchema = exports.zProviderPayloadSnapshotSchema = exports.zProviderTraceSchema = exports.zProviderInvoiceErrorSchema = exports.zProviderInvoiceIdentifiersSchema = exports.zProviderInvoiceLinksSchema = void 0;
+exports.zNfseFeeReimbursementExecuteSchema = exports.zNfseFeeReimbursementCompetenciaSchema = exports.zNexFinopsPaymentMethodsDiscoverSchema = exports.zEvoBillingPortalCardCaptureSchema = exports.zNexFinopsBillingCardChargeSchema = exports.zNexFinopsContractPaymentMethodsWriteSchema = exports.zNexFinopsPaymentMethodPatchSchema = exports.zNexFinopsPaymentMethodStatusSchema = exports.zNexFinopsPaymentMethodKindSchema = exports.zNexFinopsContractAllowancesWriteSchema = exports.zNexFinopsUsageAlertDefaultsSchema = exports.zNexFinopsAlertThresholdSchema = exports.zNexFinopsContractAllowancesSchema = exports.zNexFinopsContractAllowanceSchema = exports.zNexVendasJourneyPaymentSchema = exports.zNexVendasJourneyPaymentSupersededSchema = exports.zNexVendasJourneyPaymentWebhookEventSchema = exports.zNexVendasJourneyBoletoSchema = exports.zNexVendasJourneyPaymentChooseSchema = exports.zNexVendasJourneyPaymentStateSchema = exports.zNexVendasJourneyPaymentKindSchema = exports.zNexVendasJourneyPaymentMethodSchema = exports.zNexFinopsContractAsaasInfoSchema = exports.zNexFinopsAsaasSubscriptionStatusSchema = exports.zNexFinopsPaymentMethodSchema = exports.zNexFinopsProposalSchema = exports.zNexFinopsProposalWriteSchema = exports.zNexFinopsProposalPrefillSchema = exports.zNexFinopsProposalLoyaltyPeriodSchema = exports.zNexFinopsProposalPaymentMethodSchema = exports.zNexFinopsProposalStatusSchema = exports.zServiceInvoiceSchema = exports.zPaymentLinkSchema = exports.zPaymentLinkDocumentStateSchema = exports.zAsaasPaymentLinkSubscriptionCycleSchema = exports.zAsaasPaymentLinkChargeTypeSchema = exports.zAsaasPaymentLinkBillingTypeSchema = exports.zProviderPayloadSnapshotSchema = exports.zProviderTraceSchema = exports.zProviderInvoiceErrorSchema = exports.zProviderInvoiceIdentifiersSchema = exports.zProviderInvoiceLinksSchema = void 0;
 const zod_1 = require("zod");
 const zod_schemas_1 = require("../shared/zod-schemas");
 // ---- Provider enums and base ----
@@ -932,6 +932,8 @@ exports.zNexFinopsContractAllowancesWriteSchema = zod_1.z
     allowances: exports.zNexFinopsContractAllowancesSchema.optional().nullable(),
     alerts_enabled: zod_1.z.boolean().optional().nullable(),
     alert_thresholds: zod_1.z.array(exports.zNexFinopsAlertThresholdSchema).optional().nullable(),
+    /** feat-264 D4 — ausente/null = TRUE (reembolsa). */
+    nfse_fee_reimbursement: zod_1.z.boolean().optional().nullable(),
 })
     .strip();
 // ---- Nexus FinOps — métodos de pagamento do cliente (feat-253) ----
@@ -1007,3 +1009,25 @@ exports.zNexFinopsPaymentMethodsDiscoverSchema = zod_1.z
         .optional(),
 })
     .strip();
+// ---- Nexus FinOps — reembolso da taxa de NFS-e (feat-264) ----
+/** Competência `"YYYY-MM"`. */
+exports.zNfseFeeReimbursementCompetenciaSchema = zod_1.z
+    .string()
+    .regex(/^\d{4}-(0[1-9]|1[0-2])$/);
+/**
+ * `POST /nfse-fee-reimbursements/execute`. `expected` é o que o operador viu
+ * na prévia; o backend recalcula e recusa se divergir.
+ */
+exports.zNfseFeeReimbursementExecuteSchema = zod_1.z
+    .object({
+    tenant: zod_1.z.string().min(1),
+    competencia: exports.zNfseFeeReimbursementCompetenciaSchema,
+    expected: zod_1.z.object({
+        invoice_count: zod_1.z.number().int().positive(),
+        fee_value: zod_1.z.number().positive(),
+        amount: zod_1.z.number().positive(),
+        /** Adendo D1: `wallet_id` da linha da prévia; divergiu no execute => `preview_drift`. */
+        wallet_id: zod_1.z.string().min(1),
+    }),
+})
+    .strict();

package/dist/apps/evo-finops/zod-schemas.ts

@@ -1021,6 +1021,8 @@ export const zNexFinopsContractAllowancesWriteSchema = z
     allowances: zNexFinopsContractAllowancesSchema.optional().nullable(),
     alerts_enabled: z.boolean().optional().nullable(),
     alert_thresholds: z.array(zNexFinopsAlertThresholdSchema).optional().nullable(),
+    /** feat-264 D4 — ausente/null = TRUE (reembolsa). */
+    nfse_fee_reimbursement: z.boolean().optional().nullable(),
   })
   .strip();
 
@@ -1104,3 +1106,28 @@ export const zNexFinopsPaymentMethodsDiscoverSchema = z
       .optional(),
   })
   .strip();
+
+// ---- Nexus FinOps — reembolso da taxa de NFS-e (feat-264) ----
+
+/** Competência `"YYYY-MM"`. */
+export const zNfseFeeReimbursementCompetenciaSchema = z
+  .string()
+  .regex(/^\d{4}-(0[1-9]|1[0-2])$/);
+
+/**
+ * `POST /nfse-fee-reimbursements/execute`. `expected` é o que o operador viu
+ * na prévia; o backend recalcula e recusa se divergir.
+ */
+export const zNfseFeeReimbursementExecuteSchema = z
+  .object({
+    tenant: z.string().min(1),
+    competencia: zNfseFeeReimbursementCompetenciaSchema,
+    expected: z.object({
+      invoice_count: z.number().int().positive(),
+      fee_value: z.number().positive(),
+      amount: z.number().positive(),
+      /** Adendo D1: `wallet_id` da linha da prévia; divergiu no execute => `preview_drift`. */
+      wallet_id: z.string().min(1),
+    }),
+  })
+  .strict();

package/dist/apps/evo-med/insurance/zod-schemas.d.ts

@@ -129,6 +129,7 @@ export declare const zInsuranceCompanySchema: z.ZodObject<{
         name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         line1: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        number: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>>;
         line2: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         neighborhood: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         city: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -137,22 +138,24 @@ export declare const zInsuranceCompanySchema: z.ZodObject<{
         country: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         geo: z.ZodOptional<z.ZodAny>;
     }, "strip", z.ZodTypeAny, {
+        number: string;
         name: string;
         kind: string;
         country: string;
-        city: string;
         state: string;
+        city: string;
         line1: string;
         line2: string;
         neighborhood: string;
         zip: string;
         geo?: any;
     }, {
+        number?: unknown;
         name?: string | undefined;
         kind?: string | undefined;
         country?: string | undefined;
-        city?: string | undefined;
         state?: string | undefined;
+        city?: string | undefined;
         line1?: string | undefined;
         line2?: string | undefined;
         neighborhood?: string | undefined;
@@ -268,6 +271,7 @@ export declare const zInsuranceCompanySchema: z.ZodObject<{
         name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         line1: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        number: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>>;
         line2: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         neighborhood: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         city: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -276,22 +280,24 @@ export declare const zInsuranceCompanySchema: z.ZodObject<{
         country: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         geo: z.ZodOptional<z.ZodAny>;
     }, "strip", z.ZodTypeAny, {
+        number: string;
         name: string;
         kind: string;
         country: string;
-        city: string;
         state: string;
+        city: string;
         line1: string;
         line2: string;
         neighborhood: string;
         zip: string;
         geo?: any;
     }, {
+        number?: unknown;
         name?: string | undefined;
         kind?: string | undefined;
         country?: string | undefined;
-        city?: string | undefined;
         state?: string | undefined;
+        city?: string | undefined;
         line1?: string | undefined;
         line2?: string | undefined;
         neighborhood?: string | undefined;
@@ -407,6 +413,7 @@ export declare const zInsuranceCompanySchema: z.ZodObject<{
         name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         line1: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        number: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>>;
         line2: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         neighborhood: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         city: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -415,22 +422,24 @@ export declare const zInsuranceCompanySchema: z.ZodObject<{
         country: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         geo: z.ZodOptional<z.ZodAny>;
     }, "strip", z.ZodTypeAny, {
+        number: string;
         name: string;
         kind: string;
         country: string;
-        city: string;
         state: string;
+        city: string;
         line1: string;
         line2: string;
         neighborhood: string;
         zip: string;
         geo?: any;
     }, {
+        number?: unknown;
         name?: string | undefined;
         kind?: string | undefined;
         country?: string | undefined;
-        city?: string | undefined;
         state?: string | undefined;
+        city?: string | undefined;
         line1?: string | undefined;
         line2?: string | undefined;
         neighborhood?: string | undefined;

package/dist/apps/evo-med/people/zod-schemas.d.ts

@@ -124,6 +124,7 @@ export declare const zProfessionalSchema: z.ZodObject<{
         name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         line1: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        number: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>>;
         line2: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         neighborhood: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         city: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -132,22 +133,24 @@ export declare const zProfessionalSchema: z.ZodObject<{
         country: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         geo: z.ZodOptional<z.ZodAny>;
     }, "strip", z.ZodTypeAny, {
+        number: string;
         name: string;
         kind: string;
         country: string;
-        city: string;
         state: string;
+        city: string;
         line1: string;
         line2: string;
         neighborhood: string;
         zip: string;
         geo?: any;
     }, {
+        number?: unknown;
         name?: string | undefined;
         kind?: string | undefined;
         country?: string | undefined;
-        city?: string | undefined;
         state?: string | undefined;
+        city?: string | undefined;
         line1?: string | undefined;
         line2?: string | undefined;
         neighborhood?: string | undefined;
@@ -278,6 +281,7 @@ export declare const zProfessionalSchema: z.ZodObject<{
         name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         line1: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        number: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>>;
         line2: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         neighborhood: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         city: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -286,22 +290,24 @@ export declare const zProfessionalSchema: z.ZodObject<{
         country: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         geo: z.ZodOptional<z.ZodAny>;
     }, "strip", z.ZodTypeAny, {
+        number: string;
         name: string;
         kind: string;
         country: string;
-        city: string;
         state: string;
+        city: string;
         line1: string;
         line2: string;
         neighborhood: string;
         zip: string;
         geo?: any;
     }, {
+        number?: unknown;
         name?: string | undefined;
         kind?: string | undefined;
         country?: string | undefined;
-        city?: string | undefined;
         state?: string | undefined;
+        city?: string | undefined;
         line1?: string | undefined;
         line2?: string | undefined;
         neighborhood?: string | undefined;
@@ -432,6 +438,7 @@ export declare const zProfessionalSchema: z.ZodObject<{
         name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         line1: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        number: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>>;
         line2: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         neighborhood: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         city: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -440,22 +447,24 @@ export declare const zProfessionalSchema: z.ZodObject<{
         country: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         geo: z.ZodOptional<z.ZodAny>;
     }, "strip", z.ZodTypeAny, {
+        number: string;
         name: string;
         kind: string;
         country: string;
-        city: string;
         state: string;
+        city: string;
         line1: string;
         line2: string;
         neighborhood: string;
         zip: string;
         geo?: any;
     }, {
+        number?: unknown;
         name?: string | undefined;
         kind?: string | undefined;
         country?: string | undefined;
-        city?: string | undefined;
         state?: string | undefined;
+        city?: string | undefined;
         line1?: string | undefined;
         line2?: string | undefined;
         neighborhood?: string | undefined;
@@ -973,6 +982,7 @@ export declare const zPatientSchema: z.ZodObject<{
         name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         line1: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        number: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>>;
         line2: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         neighborhood: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         city: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -981,22 +991,24 @@ export declare const zPatientSchema: z.ZodObject<{
         country: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         geo: z.ZodOptional<z.ZodAny>;
     }, "strip", z.ZodTypeAny, {
+        number: string;
         name: string;
         kind: string;
         country: string;
-        city: string;
         state: string;
+        city: string;
         line1: string;
         line2: string;
         neighborhood: string;
         zip: string;
         geo?: any;
     }, {
+        number?: unknown;
         name?: string | undefined;
         kind?: string | undefined;
         country?: string | undefined;
-        city?: string | undefined;
         state?: string | undefined;
+        city?: string | undefined;
         line1?: string | undefined;
         line2?: string | undefined;
         neighborhood?: string | undefined;
@@ -1621,6 +1633,7 @@ export declare const zPatientSchema: z.ZodObject<{
         name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         line1: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        number: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>>;
         line2: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         neighborhood: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         city: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -1629,22 +1642,24 @@ export declare const zPatientSchema: z.ZodObject<{
         country: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         geo: z.ZodOptional<z.ZodAny>;
     }, "strip", z.ZodTypeAny, {
+        number: string;
         name: string;
         kind: string;
         country: string;
-        city: string;
         state: string;
+        city: string;
         line1: string;
         line2: string;
         neighborhood: string;
         zip: string;
         geo?: any;
     }, {
+        number?: unknown;
         name?: string | undefined;
         kind?: string | undefined;
         country?: string | undefined;
-        city?: string | undefined;
         state?: string | undefined;
+        city?: string | undefined;
         line1?: string | undefined;
         line2?: string | undefined;
         neighborhood?: string | undefined;
@@ -2269,6 +2284,7 @@ export declare const zPatientSchema: z.ZodObject<{
         name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         line1: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        number: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>>;
         line2: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         neighborhood: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         city: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -2277,22 +2293,24 @@ export declare const zPatientSchema: z.ZodObject<{
         country: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         geo: z.ZodOptional<z.ZodAny>;
     }, "strip", z.ZodTypeAny, {
+        number: string;
         name: string;
         kind: string;
         country: string;
-        city: string;
         state: string;
+        city: string;
         line1: string;
         line2: string;
         neighborhood: string;
         zip: string;
         geo?: any;
     }, {
+        number?: unknown;
         name?: string | undefined;
         kind?: string | undefined;
         country?: string | undefined;
-        city?: string | undefined;
         state?: string | undefined;
+        city?: string | undefined;
         line1?: string | undefined;
         line2?: string | undefined;
         neighborhood?: string | undefined;

package/dist/apps/shared/zod-schemas.d.ts

@@ -53,6 +53,7 @@ export declare const zAddressSchema: z.ZodObject<{
     name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     line1: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    number: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>>;
     line2: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     neighborhood: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     city: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -61,22 +62,24 @@ export declare const zAddressSchema: z.ZodObject<{
     country: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     geo: z.ZodOptional<z.ZodAny>;
 }, "strip", z.ZodTypeAny, {
+    number: string;
     name: string;
     kind: string;
     country: string;
-    city: string;
     state: string;
+    city: string;
     line1: string;
     line2: string;
     neighborhood: string;
     zip: string;
     geo?: any;
 }, {
+    number?: unknown;
     name?: string | undefined;
     kind?: string | undefined;
     country?: string | undefined;
-    city?: string | undefined;
     state?: string | undefined;
+    city?: string | undefined;
     line1?: string | undefined;
     line2?: string | undefined;
     neighborhood?: string | undefined;

package/dist/apps/shared/zod-schemas.js

@@ -73,6 +73,10 @@ exports.zAddressSchema = zod_1.z.object({
     name: zod_1.z.string().max(255).optional().default(""),
     kind: zod_1.z.string().max(255).optional().default(""),
     line1: zod_1.z.string().max(255).optional().default(""),
+    number: zod_1.z
+        .preprocess((v) => (v === null || v === undefined ? "" : String(v)), zod_1.z.string().max(255))
+        .optional()
+        .default(""),
     line2: zod_1.z.string().max(255).optional().default(""),
     neighborhood: zod_1.z.string().max(255).optional().default(""),
     city: zod_1.z.string().max(255).optional().default(""),

package/dist/apps/shared/zod-schemas.ts

@@ -87,6 +87,10 @@ export const zAddressSchema = z.object({
   name: z.string().max(255).optional().default(""),
   kind: z.string().max(255).optional().default(""),
   line1: z.string().max(255).optional().default(""),
+  number: z
+    .preprocess((v) => (v === null || v === undefined ? "" : String(v)), z.string().max(255))
+    .optional()
+    .default(""),
   line2: z.string().max(255).optional().default(""),
   neighborhood: z.string().max(255).optional().default(""),
   city: z.string().max(255).optional().default(""),

package/dist/types/evo-core/index.d.ts

@@ -54,14 +54,26 @@ export interface INexusModuleChatPermissions {
 }
 export interface INexusReports {
 }
+/**
+ * Sub-claims do módulo financeiro do Nexus. `finance === true` é o formato
+ * legado; não herda `reimbursements` (feat-264: movimenta dinheiro, exige TOTP).
+ */
+export interface INexusModuleFinancePermissions {
+    customers?: boolean;
+    contracts?: boolean;
+    billing?: boolean;
+    reports?: boolean;
+    /** feat-264 — reembolso da taxa de NFS-e. Sem bypass de admin. */
+    reimbursements?: boolean;
+}
 export interface INexusModules {
     chat?: INexusModuleChatPermissions | boolean;
     tenants?: boolean;
-    finance?: boolean;
+    finance?: INexusModuleFinancePermissions | boolean;
     notifications?: boolean;
     waba?: boolean;
     reports?: INexusReports | boolean;
-    [key: string]: INexusModuleChatPermissions | INexusReports | boolean | undefined;
+    [key: string]: INexusModuleChatPermissions | INexusModuleFinancePermissions | INexusReports | boolean | undefined;
 }
 export interface INexusClaims {
     nexus_access: boolean;

package/dist/types/evo-core/index.ts

@@ -66,14 +66,32 @@ export interface INexusModuleChatPermissions {
 
 export interface INexusReports {}
 
+/**
+ * Sub-claims do módulo financeiro do Nexus. `finance === true` é o formato
+ * legado; não herda `reimbursements` (feat-264: movimenta dinheiro, exige TOTP).
+ */
+export interface INexusModuleFinancePermissions {
+  customers?: boolean;
+  contracts?: boolean;
+  billing?: boolean;
+  reports?: boolean;
+  /** feat-264 — reembolso da taxa de NFS-e. Sem bypass de admin. */
+  reimbursements?: boolean;
+}
+
 export interface INexusModules {
   chat?: INexusModuleChatPermissions | boolean;
   tenants?: boolean;
-  finance?: boolean;
+  finance?: INexusModuleFinancePermissions | boolean;
   notifications?: boolean;
   waba?: boolean;
   reports?: INexusReports | boolean;
-  [key: string]: INexusModuleChatPermissions | INexusReports | boolean | undefined;
+  [key: string]:
+    | INexusModuleChatPermissions
+    | INexusModuleFinancePermissions
+    | INexusReports
+    | boolean
+    | undefined;
 }
 
 export interface INexusClaims {

package/dist/types/evo-finops/common/contract.d.ts

@@ -179,6 +179,8 @@ export interface INexFinopsContract extends IFireGlobalDoc {
      * `INexFinopsUsageAlertDefaults.thresholds`.
      */
     alert_thresholds?: number[] | null;
+    /** feat-264 D4 — reembolsar a taxa de NFS-e ao cliente. ⚠️ Ausente/null = TRUE (reembolsa). */
+    nfse_fee_reimbursement?: boolean | null;
 }
 export declare const NEX_FINOPS_CONTRACT_STATUS_TRANSITIONS: Record<NexFinopsContractStatus, NexFinopsContractStatus[]>;
 /**

package/dist/types/evo-finops/common/contract.ts

@@ -219,6 +219,9 @@ export interface INexFinopsContract extends IFireGlobalDoc {
    * `INexFinopsUsageAlertDefaults.thresholds`.
    */
   alert_thresholds?: number[] | null;
+
+  /** feat-264 D4 — reembolsar a taxa de NFS-e ao cliente. ⚠️ Ausente/null = TRUE (reembolsa). */
+  nfse_fee_reimbursement?: boolean | null;
 }
 
 // ── Status transitions ──

package/dist/types/evo-finops/common/nfse-fee-reimbursement.d.ts

@@ -0,0 +1,112 @@
+/** Coleção dos registros de reembolso. */
+export declare const NEX_FINOPS_NFSE_FEE_REIMBURSEMENTS_COLLECTION = "nfse_fee_reimbursements";
+/** `externalReference` da transferência Asaas = `"nexnfr:{id}"`. */
+export declare const NFSE_FEE_REIMBURSEMENT_EXTERNAL_REF_PREFIX = "nexnfr:";
+export type NfseFeeReimbursementState = 'awaiting_authorization' | 'pending' | 'done' | 'failed' | 'canceled' | 'refused';
+/**
+ * `failed`/`canceled`/`refused` -> `done` existe só para a REALIDADE do Asaas: um
+ * `TRANSFER_DONE` do `transfer_id` vinculado significa que o dinheiro saiu; o
+ * registro vira `done` (as notas passam a ser consumidas e nunca são pagas duas
+ * vezes) e gera alerta CRITICAL. Nenhum fluxo nosso faz essa transição.
+ */
+export declare const NFSE_FEE_REIMBURSEMENT_TRANSITIONS: Record<NfseFeeReimbursementState, NfseFeeReimbursementState[]>;
+/** Estados que consomem as notas do snapshot (não podem ser reembolsadas de novo). */
+export declare const NFSE_FEE_REIMBURSEMENT_CONSUMING_STATES: readonly string[];
+/** Estados em voo: bloqueiam nova execução para o mesmo tenant/competência. */
+export declare const NFSE_FEE_REIMBURSEMENT_IN_FLIGHT_STATES: readonly string[];
+/** De onde veio o `wallet_id` do destino (Adendo D1). */
+export type NfseFeeReimbursementWalletSource = 'account_scope' | 'asaas_wallets_api';
+/** D1: plugável. Só `asaas_internal_transfer` é implementado; `pix` fica para depois. */
+export type NfseFeeReimbursementPayoutMethod = 'asaas_internal_transfer';
+export interface INfseFeeReimbursement {
+    /** `{tenant}_{YYYY-MM}[_{seq}]` */
+    id: string;
+    tenant: string;
+    /** `"YYYY-MM"` (mês de `authorized_at` em America/Sao_Paulo). */
+    competencia: string;
+    /** 1, 2, … */
+    seq: number;
+    state: NfseFeeReimbursementState;
+    state_reason?: string | null;
+    provider: {
+        id: string;
+        /** Adendo D1: `asaas` = conta própria do tenant; `asaas_subaccount` = subconta da master. */
+        type: 'asaas' | 'asaas_subaccount';
+        env: 'production';
+        /** Só a subconta tem; conta própria => `null`. */
+        asaas_account_id?: string | null;
+        wallet_id: string;
+        /** `account_scope` (subconta, persistido) | `asaas_wallets_api` (conta própria, `GET /v3/wallets/` com a chave do tenant; só snapshot). */
+        wallet_source: NfseFeeReimbursementWalletSource;
+    };
+    /** Snapshot do que foi reembolsado. */
+    invoices: {
+        count: number;
+        ids: string[];
+    };
+    fee: {
+        value: number;
+        source: 'asaas_myaccount_fees';
+        fetched_at: string;
+    };
+    /** `round2(count * fee.value)` */
+    amount: number;
+    currency: 'BRL';
+    contract: {
+        customer_id: string | null;
+        contract_ids: string[];
+    };
+    payout: {
+        method: NfseFeeReimbursementPayoutMethod;
+        /** `"nexnfr:{id}"` */
+        external_reference: string;
+        /** Ex.: `"Reembolso taxa NFS-e 09/2026 - 10 notas"` */
+        description: string;
+        /** Id Asaas — vinculado SÓ pela resposta do nosso POST /v3/transfers/ (validação e eventos nunca vinculam). */
+        transfer_id?: string | null;
+        /** PENDING | BANK_PROCESSING | DONE | CANCELLED | FAILED | BLOCKED */
+        asaas_status?: string | null;
+        transfer_fee?: number | null;
+        effective_date?: string | null;
+        fail_reason?: string | null;
+    };
+    validation: {
+        decision: 'APPROVED' | 'REFUSED' | null;
+        decided_at?: string | null;
+        attempts: number;
+        last_reason?: string | null;
+    };
+    last_event?: string | null;
+    last_event_at?: string | null;
+    requested_by: {
+        login_id: string;
+        email?: string | null;
+        second_factor: 'totp';
+        auth_time: string;
+    };
+    created_at: string;
+    updated_at: string;
+    done_at?: string | null;
+}
+export type NfseFeeReimbursementEligibility = 'eligible' | 'nothing_to_reimburse' | 'in_flight' | 'open_competencia' | 'not_eligible_contract_flag' | 'no_contract' | 'subaccount_not_ready' | 'wallet_unavailable' | 'ambiguous_provider' | 'fee_unavailable';
+export interface INfseFeeReimbursementPreviewRow {
+    tenant: string;
+    tenant_name?: string | null;
+    competencia: string;
+    eligibility: NfseFeeReimbursementEligibility;
+    reason?: string | null;
+    provider_id?: string | null;
+    provider_type?: string | null;
+    wallet_id?: string | null;
+    wallet_source?: NfseFeeReimbursementWalletSource | null;
+    /** Autorizadas na competência, do provider. */
+    invoice_count_total: number;
+    invoice_count_already_reimbursed: number;
+    invoice_count_to_reimburse: number;
+    fee_value: number | null;
+    amount: number | null;
+    next_record_id?: string | null;
+    records: Array<Pick<INfseFeeReimbursement, 'id' | 'state' | 'amount' | 'seq'> & {
+        invoice_count: number;
+    }>;
+}