evo360-types 1.3.651 → 1.3.654

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

@@ -14785,6 +14785,21 @@ export declare const zNexFinopsBillingCardChargeSchema: z.ZodObject<{
     taker_id?: string | undefined;
     allow_early?: boolean | undefined;
 }>;
+/**
+ * Portal (`evo_billing`) `POST /me/payment-methods/capture` (feat-253 fatia 9).
+ * O cliente confirma a cobrança e o valor que viu na prévia (`capture_target`);
+ * provider/ambiente/tomador são resolvidos no backend. `.strip()`: nada de cartão entra aqui.
+ */
+export declare const zEvoBillingPortalCardCaptureSchema: z.ZodObject<{
+    billing_id: z.ZodString;
+    expected_value: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    expected_value: number;
+    billing_id: string;
+}, {
+    expected_value: number;
+    billing_id: string;
+}>;
 /** `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.zNexFinopsPaymentMethodsDiscoverSchema = 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.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 ----
@@ -984,6 +984,17 @@ exports.zNexFinopsBillingCardChargeSchema = zod_1.z
     allow_early: zod_1.z.boolean().optional(),
 })
     .strip();
+/**
+ * Portal (`evo_billing`) `POST /me/payment-methods/capture` (feat-253 fatia 9).
+ * O cliente confirma a cobrança e o valor que viu na prévia (`capture_target`);
+ * provider/ambiente/tomador são resolvidos no backend. `.strip()`: nada de cartão entra aqui.
+ */
+exports.zEvoBillingPortalCardCaptureSchema = zod_1.z
+    .object({
+    billing_id: zod_1.z.string().min(1).max(128),
+    expected_value: zod_1.z.number(),
+})
+    .strip();
 /** `POST /payment-methods/discover` — sem `confirm` é dry-run. */
 exports.zNexFinopsPaymentMethodsDiscoverSchema = zod_1.z
     .object({

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

@@ -1080,6 +1080,18 @@ export const zNexFinopsBillingCardChargeSchema = z
   })
   .strip();
 
+/**
+ * Portal (`evo_billing`) `POST /me/payment-methods/capture` (feat-253 fatia 9).
+ * O cliente confirma a cobrança e o valor que viu na prévia (`capture_target`);
+ * provider/ambiente/tomador são resolvidos no backend. `.strip()`: nada de cartão entra aqui.
+ */
+export const zEvoBillingPortalCardCaptureSchema = z
+  .object({
+    billing_id: z.string().min(1).max(128),
+    expected_value: z.number(),
+  })
+  .strip();
+
 /** `POST /payment-methods/discover` — sem `confirm` é dry-run. */
 export const zNexFinopsPaymentMethodsDiscoverSchema = z
   .object({

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

@@ -5,3 +5,45 @@ export declare const EvoBillingPermissions: {
     readonly Admin: "evo_billing_admin";
 };
 export type EvoBillingPermissions = (typeof EvoBillingPermissions)[keyof typeof EvoBillingPermissions];
+export type EvoBillingPortalPaymentMethodKind = 'asaas_card_token' | 'asaas_subscription';
+export type EvoBillingPortalPaymentMethodStatus = 'active' | 'failing' | 'inactive' | 'revoked';
+export interface IEvoBillingPortalPaymentMethodContract {
+    contract_id: string;
+    name: string | null;
+    /** O contrato cobra neste método por padrão. */
+    is_default: boolean;
+}
+export interface IEvoBillingPortalPaymentMethod {
+    /** Chave opaca só para a lista (não é o id do método). */
+    key: string;
+    kind: EvoBillingPortalPaymentMethodKind;
+    status: EvoBillingPortalPaymentMethodStatus;
+    brand: string | null;
+    last4: string | null;
+    /** Contratos do cliente que usam este método. */
+    contracts: IEvoBillingPortalPaymentMethodContract[];
+}
+/** Cobrança que o "Cadastrar/trocar cartão" usaria agora (ou null: aguarda a próxima). */
+export interface IEvoBillingPortalCardCaptureTarget {
+    billing_id: string;
+    contract_id: string | null;
+    competency_key: string | null;
+    value: number;
+    due_date: string | null;
+}
+export interface IEvoBillingPortalPaymentMethodsResponse {
+    ok: true;
+    items: IEvoBillingPortalPaymentMethod[];
+    /** O cadastro de cartão pelo portal está ligado no ambiente atual. */
+    capture_enabled: boolean;
+    capture_target: IEvoBillingPortalCardCaptureTarget | null;
+}
+export interface IEvoBillingPortalCardCaptureResponse {
+    ok: true;
+    billing_id: string;
+    invoice_url: string;
+    value: number;
+    due_date: string;
+    reused: boolean;
+}
+export type EvoBillingPortalCardCaptureErrorCode = 'no_open_billing' | 'card_capture_unavailable' | 'customer_document_missing' | 'taker_without_remote_customer' | 'preview_changed' | 'already_paid' | 'internal';

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

@@ -8,3 +8,64 @@ export const EvoBillingPermissions = {
 
 export type EvoBillingPermissions =
   (typeof EvoBillingPermissions)[keyof typeof EvoBillingPermissions];
+
+// ── Métodos de pagamento no portal (feat-253 fatia 9) ──
+//
+// Projeção do `payment_methods` para o cliente. PCI/escopo: só bandeira + últimos 4.
+// Sem id do método, `cus_`, `pay_`/`sub_` ou token.
+
+export type EvoBillingPortalPaymentMethodKind = 'asaas_card_token' | 'asaas_subscription';
+export type EvoBillingPortalPaymentMethodStatus = 'active' | 'failing' | 'inactive' | 'revoked';
+
+export interface IEvoBillingPortalPaymentMethodContract {
+  contract_id: string;
+  name: string | null;
+  /** O contrato cobra neste método por padrão. */
+  is_default: boolean;
+}
+
+export interface IEvoBillingPortalPaymentMethod {
+  /** Chave opaca só para a lista (não é o id do método). */
+  key: string;
+  kind: EvoBillingPortalPaymentMethodKind;
+  status: EvoBillingPortalPaymentMethodStatus;
+  brand: string | null;
+  last4: string | null;
+  /** Contratos do cliente que usam este método. */
+  contracts: IEvoBillingPortalPaymentMethodContract[];
+}
+
+/** Cobrança que o "Cadastrar/trocar cartão" usaria agora (ou null: aguarda a próxima). */
+export interface IEvoBillingPortalCardCaptureTarget {
+  billing_id: string;
+  contract_id: string | null;
+  competency_key: string | null;
+  value: number;
+  due_date: string | null;
+}
+
+export interface IEvoBillingPortalPaymentMethodsResponse {
+  ok: true;
+  items: IEvoBillingPortalPaymentMethod[];
+  /** O cadastro de cartão pelo portal está ligado no ambiente atual. */
+  capture_enabled: boolean;
+  capture_target: IEvoBillingPortalCardCaptureTarget | null;
+}
+
+export interface IEvoBillingPortalCardCaptureResponse {
+  ok: true;
+  billing_id: string;
+  invoice_url: string;
+  value: number;
+  due_date: string;
+  reused: boolean;
+}
+
+export type EvoBillingPortalCardCaptureErrorCode =
+  | 'no_open_billing'
+  | 'card_capture_unavailable'
+  | 'customer_document_missing'
+  | 'taker_without_remote_customer'
+  | 'preview_changed'
+  | 'already_paid'
+  | 'internal';

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

@@ -137,6 +137,12 @@ export interface INexFinopsBillingCardCharge {
     /** Provider/ambiente onde o `pay_` foi criado. */
     provider_id?: string | null;
     env?: 'sandbox' | 'production' | null;
+    /**
+     * feat-253 fatia 9: quem gerou a fatura de captura. `portal` = o próprio cliente pediu
+     * "Cadastrar/trocar cartão" → o cartão capturado vira o padrão do contrato. Ausente/`nexus`
+     * = regra da F2b (habilita só em contrato sem método; senão fica como sugestão).
+     */
+    capture_origin?: 'nexus' | 'portal' | null;
 }
 export type NexFinopsBillingCardCaptureStatus = 'captured' | 'no_token' | 'skipped';
 export interface INexFinopsBilling extends IFireGlobalDoc {

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

@@ -168,6 +168,12 @@ export interface INexFinopsBillingCardCharge {
   /** Provider/ambiente onde o `pay_` foi criado. */
   provider_id?: string | null;
   env?: 'sandbox' | 'production' | null;
+  /**
+   * feat-253 fatia 9: quem gerou a fatura de captura. `portal` = o próprio cliente pediu
+   * "Cadastrar/trocar cartão" → o cartão capturado vira o padrão do contrato. Ausente/`nexus`
+   * = regra da F2b (habilita só em contrato sem método; senão fica como sugestão).
+   */
+  capture_origin?: 'nexus' | 'portal' | null;
 }
 
 export type NexFinopsBillingCardCaptureStatus = 'captured' | 'no_token' | 'skipped';

package/package.json

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