evo360-types 1.3.670 → 1.3.673

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

@@ -14753,10 +14753,11 @@ export declare const zNexFinopsContractPaymentMethodsWriteSchema: z.ZodObject<{
  * - `charge_now`: cobra no cartão salvo (`confirm` + `expected_value`).
  * - `send_invoice`: fatura hospedada do Asaas (`billing_type` CREDIT_CARD captura o cartão; UNDEFINED = cliente escolhe).
  * - `cancel_invoice`: cancela a fatura aberta (`asaas_payment_id`).
+ * - `schedule` / `unschedule`: liga/desliga "cobrar no cartão no vencimento" (fatia 8).
  * `.strip()`: dados de cartão/token nunca entram por aqui.
  */
 export declare const zNexFinopsBillingCardChargeSchema: z.ZodObject<{
-    action: z.ZodEnum<["preview", "charge_now", "send_invoice", "cancel_invoice"]>;
+    action: z.ZodEnum<["preview", "charge_now", "send_invoice", "cancel_invoice", "schedule", "unschedule"]>;
     expected_value: z.ZodOptional<z.ZodNumber>;
     asaas_payment_id: z.ZodOptional<z.ZodString>;
     confirm: z.ZodOptional<z.ZodBoolean>;
@@ -14767,7 +14768,7 @@ export declare const zNexFinopsBillingCardChargeSchema: z.ZodObject<{
     taker_id: z.ZodOptional<z.ZodString>;
     allow_early: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    action: "send_invoice" | "cancel_invoice" | "preview" | "charge_now";
+    action: "schedule" | "send_invoice" | "cancel_invoice" | "preview" | "charge_now" | "unschedule";
     confirm?: boolean | undefined;
     provider_id?: string | undefined;
     billing_type?: "CREDIT_CARD" | "UNDEFINED" | undefined;
@@ -14778,7 +14779,7 @@ export declare const zNexFinopsBillingCardChargeSchema: z.ZodObject<{
     taker_id?: string | undefined;
     allow_early?: boolean | undefined;
 }, {
-    action: "send_invoice" | "cancel_invoice" | "preview" | "charge_now";
+    action: "schedule" | "send_invoice" | "cancel_invoice" | "preview" | "charge_now" | "unschedule";
     confirm?: boolean | undefined;
     provider_id?: string | undefined;
     billing_type?: "CREDIT_CARD" | "UNDEFINED" | undefined;
@@ -14804,6 +14805,24 @@ export declare const zEvoBillingPortalCardCaptureSchema: z.ZodObject<{
     expected_value: number;
     billing_id: string;
 }>;
+/**
+ * `POST /billings/card-charge-sweep` (feat-253 fatia 8) — rotina diária disparada pelo n8n:
+ * avisa e cobra as cobranças marcadas "cobrar no cartão no vencimento".
+ * `today` (YYYY-MM-DD, BRT) só para reprocessar/testar; `dry_run` não cobra nem avisa.
+ */
+export declare const zNexFinopsBillingCardChargeSweepSchema: z.ZodObject<{
+    today: z.ZodOptional<z.ZodString>;
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    notify_days_before: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    dry_run?: boolean | undefined;
+    today?: string | undefined;
+    notify_days_before?: number | undefined;
+}, {
+    dry_run?: boolean | undefined;
+    today?: string | undefined;
+    notify_days_before?: number | undefined;
+}>;
 /** `POST /payment-methods/discover` — sem `confirm` é dry-run. */
 export declare const zNexFinopsPaymentMethodsDiscoverSchema: z.ZodObject<{
     customer_id: z.ZodOptional<z.ZodString>;

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.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;
+exports.zNfseFeeReimbursementExecuteSchema = exports.zNfseFeeReimbursementCompetenciaSchema = exports.zNexFinopsPaymentMethodsDiscoverSchema = exports.zNexFinopsBillingCardChargeSweepSchema = 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 ----
@@ -970,11 +970,12 @@ exports.zNexFinopsContractPaymentMethodsWriteSchema = zod_1.z
  * - `charge_now`: cobra no cartão salvo (`confirm` + `expected_value`).
  * - `send_invoice`: fatura hospedada do Asaas (`billing_type` CREDIT_CARD captura o cartão; UNDEFINED = cliente escolhe).
  * - `cancel_invoice`: cancela a fatura aberta (`asaas_payment_id`).
+ * - `schedule` / `unschedule`: liga/desliga "cobrar no cartão no vencimento" (fatia 8).
  * `.strip()`: dados de cartão/token nunca entram por aqui.
  */
 exports.zNexFinopsBillingCardChargeSchema = zod_1.z
     .object({
-    action: zod_1.z.enum(["preview", "charge_now", "send_invoice", "cancel_invoice"]),
+    action: zod_1.z.enum(["preview", "charge_now", "send_invoice", "cancel_invoice", "schedule", "unschedule"]),
     expected_value: zod_1.z.number().optional(),
     asaas_payment_id: zod_1.z.string().min(1).max(128).optional(),
     confirm: zod_1.z.boolean().optional(),
@@ -997,6 +998,18 @@ exports.zEvoBillingPortalCardCaptureSchema = zod_1.z
     expected_value: zod_1.z.number(),
 })
     .strip();
+/**
+ * `POST /billings/card-charge-sweep` (feat-253 fatia 8) — rotina diária disparada pelo n8n:
+ * avisa e cobra as cobranças marcadas "cobrar no cartão no vencimento".
+ * `today` (YYYY-MM-DD, BRT) só para reprocessar/testar; `dry_run` não cobra nem avisa.
+ */
+exports.zNexFinopsBillingCardChargeSweepSchema = zod_1.z
+    .object({
+    today: zod_1.z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+    dry_run: zod_1.z.boolean().optional(),
+    notify_days_before: zod_1.z.number().int().min(0).max(10).optional(),
+})
+    .strip();
 /** `POST /payment-methods/discover` — sem `confirm` é dry-run. */
 exports.zNexFinopsPaymentMethodsDiscoverSchema = zod_1.z
     .object({

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

@@ -1065,11 +1065,12 @@ export const zNexFinopsContractPaymentMethodsWriteSchema = z
  * - `charge_now`: cobra no cartão salvo (`confirm` + `expected_value`).
  * - `send_invoice`: fatura hospedada do Asaas (`billing_type` CREDIT_CARD captura o cartão; UNDEFINED = cliente escolhe).
  * - `cancel_invoice`: cancela a fatura aberta (`asaas_payment_id`).
+ * - `schedule` / `unschedule`: liga/desliga "cobrar no cartão no vencimento" (fatia 8).
  * `.strip()`: dados de cartão/token nunca entram por aqui.
  */
 export const zNexFinopsBillingCardChargeSchema = z
   .object({
-    action: z.enum(["preview", "charge_now", "send_invoice", "cancel_invoice"]),
+    action: z.enum(["preview", "charge_now", "send_invoice", "cancel_invoice", "schedule", "unschedule"]),
     expected_value: z.number().optional(),
     asaas_payment_id: z.string().min(1).max(128).optional(),
     confirm: z.boolean().optional(),
@@ -1094,6 +1095,19 @@ export const zEvoBillingPortalCardCaptureSchema = z
   })
   .strip();
 
+/**
+ * `POST /billings/card-charge-sweep` (feat-253 fatia 8) — rotina diária disparada pelo n8n:
+ * avisa e cobra as cobranças marcadas "cobrar no cartão no vencimento".
+ * `today` (YYYY-MM-DD, BRT) só para reprocessar/testar; `dry_run` não cobra nem avisa.
+ */
+export const zNexFinopsBillingCardChargeSweepSchema = z
+  .object({
+    today: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+    dry_run: z.boolean().optional(),
+    notify_days_before: z.number().int().min(0).max(10).optional(),
+  })
+  .strip();
+
 /** `POST /payment-methods/discover` — sem `confirm` é dry-run. */
 export const zNexFinopsPaymentMethodsDiscoverSchema = z
   .object({

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

@@ -145,6 +145,38 @@ export interface INexFinopsBillingCardCharge {
     capture_origin?: 'nexus' | 'portal' | null;
 }
 export type NexFinopsBillingCardCaptureStatus = 'captured' | 'no_token' | 'skipped';
+/**
+ * feat-253 fatia 8 — "Cobrar no cartão no vencimento". O operador marca a cobrança;
+ * a rotina diária (`POST /billings/card-charge-sweep`, disparada pelo n8n) avisa o
+ * cliente alguns dias antes e cobra o cartão salvo no dia do vencimento.
+ *
+ * - `scheduled`: aguardando o vencimento;
+ * - `processing`: cobrança criada no Asaas e em análise (aguarda o webhook);
+ * - `charged`: cobrada e paga;
+ * - `failed`: recusada (ou erro repetido) — o operador decide o próximo passo;
+ * - `canceled`: desmarcada, ou a cobrança foi paga/cancelada por outro caminho.
+ */
+export type NexFinopsBillingCardChargeScheduleStatus = 'scheduled' | 'processing' | 'charged' | 'failed' | 'canceled';
+export interface INexFinopsBillingCardChargeSchedule {
+    status: NexFinopsBillingCardChargeScheduleStatus;
+    /** Método `atok_` que será cobrado (o da cobrança no momento da marcação). */
+    payment_method_id: string;
+    scheduled_at: string;
+    scheduled_by: {
+        kind: 'user' | 'system';
+        id: string | null;
+    };
+    /** Aviso "será cobrado no cartão em DD/MM" já disparado. */
+    notified_upcoming_at?: string | null;
+    last_attempt_at?: string | null;
+    attempts?: number;
+    /** `pay_` da cobrança feita pela rotina. */
+    asaas_payment_id?: string | null;
+    last_error?: string | null;
+    /** Por que saiu de `scheduled` sem cobrar (desmarcada, paga por outro meio...). */
+    closed_reason?: string | null;
+    updated_at?: string | null;
+}
 export interface INexFinopsBilling extends IFireGlobalDoc {
     customer_id: string;
     customer_ref?: string | null;
@@ -176,6 +208,8 @@ export interface INexFinopsBilling extends IFireGlobalDoc {
     /** Todos os `pay_` do Asaas já associados (A e B) — chave do roteamento do webhook. Interno. */
     card_payment_ids?: string[];
     card_charge?: INexFinopsBillingCardCharge | null;
+    /** feat-253 fatia 8 — cobrar no cartão salvo no vencimento. */
+    card_charge_schedule?: INexFinopsBillingCardChargeSchedule | null;
     /** Trava curta da cobrança no cartão (`charge_now`). Interno (fora das projeções). */
     card_charge_lock?: {
         by: string | null;

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

@@ -178,6 +178,37 @@ export interface INexFinopsBillingCardCharge {
 
 export type NexFinopsBillingCardCaptureStatus = 'captured' | 'no_token' | 'skipped';
 
+/**
+ * feat-253 fatia 8 — "Cobrar no cartão no vencimento". O operador marca a cobrança;
+ * a rotina diária (`POST /billings/card-charge-sweep`, disparada pelo n8n) avisa o
+ * cliente alguns dias antes e cobra o cartão salvo no dia do vencimento.
+ *
+ * - `scheduled`: aguardando o vencimento;
+ * - `processing`: cobrança criada no Asaas e em análise (aguarda o webhook);
+ * - `charged`: cobrada e paga;
+ * - `failed`: recusada (ou erro repetido) — o operador decide o próximo passo;
+ * - `canceled`: desmarcada, ou a cobrança foi paga/cancelada por outro caminho.
+ */
+export type NexFinopsBillingCardChargeScheduleStatus = 'scheduled' | 'processing' | 'charged' | 'failed' | 'canceled';
+
+export interface INexFinopsBillingCardChargeSchedule {
+  status: NexFinopsBillingCardChargeScheduleStatus;
+  /** Método `atok_` que será cobrado (o da cobrança no momento da marcação). */
+  payment_method_id: string;
+  scheduled_at: string;
+  scheduled_by: { kind: 'user' | 'system'; id: string | null };
+  /** Aviso "será cobrado no cartão em DD/MM" já disparado. */
+  notified_upcoming_at?: string | null;
+  last_attempt_at?: string | null;
+  attempts?: number;
+  /** `pay_` da cobrança feita pela rotina. */
+  asaas_payment_id?: string | null;
+  last_error?: string | null;
+  /** Por que saiu de `scheduled` sem cobrar (desmarcada, paga por outro meio...). */
+  closed_reason?: string | null;
+  updated_at?: string | null;
+}
+
 // ── Main Document ──
 
 export interface INexFinopsBilling extends IFireGlobalDoc {
@@ -243,6 +274,8 @@ export interface INexFinopsBilling extends IFireGlobalDoc {
   /** Todos os `pay_` do Asaas já associados (A e B) — chave do roteamento do webhook. Interno. */
   card_payment_ids?: string[];
   card_charge?: INexFinopsBillingCardCharge | null;
+  /** feat-253 fatia 8 — cobrar no cartão salvo no vencimento. */
+  card_charge_schedule?: INexFinopsBillingCardChargeSchedule | null;
   /** Trava curta da cobrança no cartão (`charge_now`). Interno (fora das projeções). */
   card_charge_lock?: { by: string | null; until: string } | null;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evo360-types",
-  "version": "1.3.670",
+  "version": "1.3.673",
   "description": "HREVO360 Shared Types",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",