evo360-types 1.3.283 → 1.3.288

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

@@ -0,0 +1,42 @@
+import type { IFireGlobalDoc } from '../../shared';
+export type NexFinopsBillingStatus = 'draft' | 'issued' | 'paid' | 'overdue' | 'canceled';
+export interface INexFinopsBillingServiceItem {
+    category: string;
+    description: string;
+    amount: number;
+}
+export interface INexFinopsBillingPaymentOption {
+    type: 'pix' | 'boleto' | 'payment_link';
+    provider_id?: string | null;
+    external_id?: string | null;
+    url?: string | null;
+    digitable_line?: string | null;
+    qr_code_payload?: string | null;
+    expires_at?: string | null;
+    status?: string | null;
+}
+export interface INexFinopsBillingCompetency {
+    year: number;
+    month: number;
+    key: string;
+}
+export interface INexFinopsBilling extends IFireGlobalDoc {
+    customer_id: string;
+    customer_ref?: string | null;
+    contract_id: string;
+    contract_ref?: string | null;
+    status: NexFinopsBillingStatus;
+    services: INexFinopsBillingServiceItem[];
+    amount: number;
+    discount: number;
+    total: number;
+    currency: 'BRL';
+    due_at: string;
+    paid_at?: string | null;
+    payment_method?: string | null;
+    payment_options?: INexFinopsBillingPaymentOption[];
+    competency?: INexFinopsBillingCompetency | null;
+    contract_snapshot?: Record<string, unknown> | null;
+    notes?: string | null;
+}
+export declare const NEX_FINOPS_BILLING_STATUS_TRANSITIONS: Record<NexFinopsBillingStatus, NexFinopsBillingStatus[]>;

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

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NEX_FINOPS_BILLING_STATUS_TRANSITIONS = void 0;
+// ── Status transitions ──
+exports.NEX_FINOPS_BILLING_STATUS_TRANSITIONS = {
+    draft: ['issued', 'canceled'],
+    issued: ['paid', 'overdue', 'canceled'],
+    overdue: ['paid'],
+    paid: [],
+    canceled: [],
+};

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

@@ -0,0 +1,86 @@
+import type { IFireGlobalDoc } from '../../shared';
+
+// ── Status ──
+
+export type NexFinopsBillingStatus =
+  | 'draft'
+  | 'issued'
+  | 'paid'
+  | 'overdue'
+  | 'canceled';
+
+// ── Sub-interfaces ──
+
+export interface INexFinopsBillingServiceItem {
+  category: string;
+  description: string;
+  amount: number;
+}
+
+export interface INexFinopsBillingPaymentOption {
+  type: 'pix' | 'boleto' | 'payment_link';
+  provider_id?: string | null;
+  external_id?: string | null;
+  url?: string | null;
+  digitable_line?: string | null;
+  qr_code_payload?: string | null;
+  expires_at?: string | null;
+  status?: string | null;
+}
+
+export interface INexFinopsBillingCompetency {
+  year: number;
+  month: number;
+  key: string;
+}
+
+// ── Main Document ──
+
+export interface INexFinopsBilling extends IFireGlobalDoc {
+  // Vínculos
+  customer_id: string;
+  customer_ref?: string | null;
+  contract_id: string;
+  contract_ref?: string | null;
+
+  // Status
+  status: NexFinopsBillingStatus;
+
+  // Serviços (snapshot do contrato)
+  services: INexFinopsBillingServiceItem[];
+
+  // Valores
+  amount: number;
+  discount: number;
+  total: number;
+  currency: 'BRL';
+
+  // Vencimento
+  due_at: string;
+
+  // Pagamento
+  paid_at?: string | null;
+  payment_method?: string | null;
+
+  // Formas de pagamento emitidas
+  payment_options?: INexFinopsBillingPaymentOption[];
+
+  // Competência
+  competency?: INexFinopsBillingCompetency | null;
+
+  // Snapshot do contrato
+  contract_snapshot?: Record<string, unknown> | null;
+
+  // Observações
+  notes?: string | null;
+}
+
+// ── Status transitions ──
+
+export const NEX_FINOPS_BILLING_STATUS_TRANSITIONS: Record<NexFinopsBillingStatus, NexFinopsBillingStatus[]> = {
+  draft: ['issued', 'canceled'],
+  issued: ['paid', 'overdue', 'canceled'],
+  overdue: ['paid'],
+  paid: [],
+  canceled: [],
+};

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

@@ -0,0 +1,27 @@
+import type { IFireGlobalDoc } from '../../shared';
+export type NexFinopsContractStatus = 'draft' | 'active' | 'inactive' | 'ended' | 'canceled';
+export type NexFinopsContractRecurrence = 'one_time' | 'monthly';
+export type NexFinopsPaymentMethod = 'pix' | 'boleto' | 'payment_link';
+export interface INexFinopsContractServiceItem {
+    category: string;
+    description: string;
+    /** Valor unitário (decimal, BRL). */
+    amount: number;
+}
+export interface INexFinopsContract extends IFireGlobalDoc {
+    customer_id: string;
+    customer_ref?: string | null;
+    code?: string | null;
+    name: string;
+    status: NexFinopsContractStatus;
+    starts_at: string;
+    ends_at?: string | null;
+    recurrence: NexFinopsContractRecurrence;
+    due_day: number;
+    accepted_payment_methods: NexFinopsPaymentMethod[];
+    services: INexFinopsContractServiceItem[];
+    total_amount: number;
+    currency: 'BRL';
+    notes?: string | null;
+}
+export declare const NEX_FINOPS_CONTRACT_STATUS_TRANSITIONS: Record<NexFinopsContractStatus, NexFinopsContractStatus[]>;

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

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NEX_FINOPS_CONTRACT_STATUS_TRANSITIONS = void 0;
+// ── Status transitions ──
+exports.NEX_FINOPS_CONTRACT_STATUS_TRANSITIONS = {
+    draft: ['active', 'canceled'],
+    active: ['inactive', 'ended', 'canceled'],
+    inactive: ['active'],
+    ended: [],
+    canceled: [],
+};

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

@@ -0,0 +1,62 @@
+import type { IFireGlobalDoc } from '../../shared';
+
+// ── Status & Recurrence ──
+
+export type NexFinopsContractStatus = 'draft' | 'active' | 'inactive' | 'ended' | 'canceled';
+export type NexFinopsContractRecurrence = 'one_time' | 'monthly';
+export type NexFinopsPaymentMethod = 'pix' | 'boleto' | 'payment_link';
+
+// ── Service Item ──
+
+export interface INexFinopsContractServiceItem {
+  category: string;
+  description: string;
+  /** Valor unitário (decimal, BRL). */
+  amount: number;
+}
+
+// ── Main Document ──
+
+export interface INexFinopsContract extends IFireGlobalDoc {
+  // Vínculos
+  customer_id: string;
+  customer_ref?: string | null;
+
+  // Identificação
+  code?: string | null;
+  name: string;
+  status: NexFinopsContractStatus;
+
+  // Vigência
+  starts_at: string;
+  ends_at?: string | null;
+
+  // Recorrência e vencimento
+  recurrence: NexFinopsContractRecurrence;
+  due_day: number;
+
+  // Formas de pagamento aceitas
+  accepted_payment_methods: NexFinopsPaymentMethod[];
+
+  // Serviços
+  services: INexFinopsContractServiceItem[];
+
+  // Valor total (calculado = soma dos services[].amount)
+  total_amount: number;
+
+  // Moeda
+  currency: 'BRL';
+
+  // Observações
+  notes?: string | null;
+}
+
+// ── Status transitions ──
+
+export const NEX_FINOPS_CONTRACT_STATUS_TRANSITIONS: Record<NexFinopsContractStatus, NexFinopsContractStatus[]> = {
+  draft: ['active', 'canceled'],
+  active: ['inactive', 'ended', 'canceled'],
+  inactive: ['active'],
+  ended: [],
+  canceled: [],
+};

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

@@ -1,6 +1,8 @@
 export * from "./fb_collections";
 export * from "./common";
 export * from "./common/taker";
+export * from "./common/contract";
+export * from "./common/billing";
 export * from "./providers";
 export * from "./providers/provider_fiscal_types";
 export * from "./providers/asaas/asaas_provider";

package/dist/types/evo-finops/index.js

@@ -18,6 +18,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./fb_collections"), exports);
 __exportStar(require("./common"), exports);
 __exportStar(require("./common/taker"), exports);
+__exportStar(require("./common/contract"), exports);
+__exportStar(require("./common/billing"), exports);
 __exportStar(require("./providers"), exports);
 __exportStar(require("./providers/provider_fiscal_types"), exports);
 __exportStar(require("./providers/asaas/asaas_provider"), exports);

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

@@ -3,6 +3,8 @@
 export * from "./fb_collections";
 export * from "./common";
 export * from "./common/taker";
+export * from "./common/contract";
+export * from "./common/billing";
 export * from "./providers";
 export * from "./providers/provider_fiscal_types";
 export * from "./providers/asaas/asaas_provider";

package/package.json

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