evo360-types 1.3.501 → 1.3.503

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

@@ -6,6 +6,27 @@ export interface INexFinopsBillingServiceItem {
     description: string;
     amount: number;
 }
+/**
+ * Termos efetivamente enviados ao emissor do boleto.
+ *
+ * Todos os campos são obrigatórios de propósito: a distinção entre "multa 0, não
+ * cobra" e "não sabemos os termos deste boleto" é a PRESENÇA do objeto, nunca um
+ * campo interno ausente. Snapshot presente é sempre completo; ausente significa
+ * boleto emitido antes do snapshot existir, e o frontend mostra "—", nunca um
+ * valor estimado.
+ */
+export interface INexFinopsBillingBoletoTerms {
+    /** Vencimento enviado ao Inter, data civil YYYY-MM-DD. */
+    due_date: string;
+    /** O numDiasAgenda efetivamente enviado. */
+    num_dias_agenda: number;
+    /** Data limite de pagamento (YYYY-MM-DD) = due_date + num_dias_agenda. */
+    payment_deadline: string;
+    /** Multa efetiva em % sobre o nominal. `0` = campo omitido do payload, não cobra. */
+    multa_taxa: number;
+    /** Mora efetiva em % ao mês. `0` = campo omitido do payload, não cobra. */
+    mora_taxa: number;
+}
 export interface INexFinopsBillingPaymentOption {
     type: 'pix' | 'boleto' | 'payment_link';
     provider_id?: string | null;
@@ -15,6 +36,12 @@ export interface INexFinopsBillingPaymentOption {
     qr_code_payload?: string | null;
     expires_at?: string | null;
     status?: string | null;
+    boleto_terms?: INexFinopsBillingBoletoTerms | null;
+    /**
+     * Liga a option ao seu PDF (`boleto-inter-{nossoNumero}.pdf`). Sem ele, uma
+     * cobrança com dois boletos casa a linha digitável de um com o PDF do outro.
+     */
+    nosso_numero?: string | null;
 }
 export interface INexFinopsBillingCompetency {
     year: number;

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

@@ -19,6 +19,28 @@ export interface INexFinopsBillingServiceItem {
   amount: number;
 }
 
+/**
+ * Termos efetivamente enviados ao emissor do boleto.
+ *
+ * Todos os campos são obrigatórios de propósito: a distinção entre "multa 0, não
+ * cobra" e "não sabemos os termos deste boleto" é a PRESENÇA do objeto, nunca um
+ * campo interno ausente. Snapshot presente é sempre completo; ausente significa
+ * boleto emitido antes do snapshot existir, e o frontend mostra "—", nunca um
+ * valor estimado.
+ */
+export interface INexFinopsBillingBoletoTerms {
+  /** Vencimento enviado ao Inter, data civil YYYY-MM-DD. */
+  due_date: string;
+  /** O numDiasAgenda efetivamente enviado. */
+  num_dias_agenda: number;
+  /** Data limite de pagamento (YYYY-MM-DD) = due_date + num_dias_agenda. */
+  payment_deadline: string;
+  /** Multa efetiva em % sobre o nominal. `0` = campo omitido do payload, não cobra. */
+  multa_taxa: number;
+  /** Mora efetiva em % ao mês. `0` = campo omitido do payload, não cobra. */
+  mora_taxa: number;
+}
+
 export interface INexFinopsBillingPaymentOption {
   type: 'pix' | 'boleto' | 'payment_link';
   provider_id?: string | null;
@@ -28,6 +50,12 @@ export interface INexFinopsBillingPaymentOption {
   qr_code_payload?: string | null;
   expires_at?: string | null;
   status?: string | null;
+  boleto_terms?: INexFinopsBillingBoletoTerms | null;
+  /**
+   * Liga a option ao seu PDF (`boleto-inter-{nossoNumero}.pdf`). Sem ele, uma
+   * cobrança com dois boletos casa a linha digitável de um com o PDF do outro.
+   */
+  nosso_numero?: string | null;
 }
 
 export interface INexFinopsBillingCompetency {

package/dist/types/evo-finops/providers/inter/inter_provider.d.ts

@@ -5,6 +5,23 @@ export interface IInterWebhookConfig {
     enabled: boolean;
     secret_hash?: string;
 }
+/**
+ * Parâmetros comerciais do boleto. Ficam no Firestore de propósito: são
+ * parâmetro de negócio e mudam sem envolver engenharia nem deploy.
+ *
+ * Campo ausente cai no default do backend.
+ */
+export interface IInterBoletoDefaults {
+    /**
+     * Dias corridos após o vencimento até o cancelamento automático no Inter —
+     * na prática, o prazo limite para pagar. O máximo aceito pela API é 60.
+     */
+    num_dias_agenda?: number;
+    /** Multa por atraso, em % sobre o valor nominal. `0` desliga (campo omitido do payload ao Inter). */
+    multa_taxa?: number;
+    /** Juros de mora, em % ao mês. `0` desliga (campo omitido do payload ao Inter). */
+    mora_taxa?: number;
+}
 export interface IInterEnvAuthConfig {
     enabled: boolean;
     base_url?: string;
@@ -14,6 +31,7 @@ export interface IInterEnvAuthConfig {
     key_pem_secret_ref: GoogleSecretRef;
     conta_corrente?: string;
     timeout_ms?: number;
+    boleto_defaults?: IInterBoletoDefaults;
     webhook?: IInterWebhookConfig;
 }
 export interface IInterBoletoPIXCapabilities {

package/dist/types/evo-finops/providers/inter/inter_provider.ts

@@ -10,6 +10,26 @@ export interface IInterWebhookConfig {
   secret_hash?: string;
 }
 
+// ── Boleto defaults ──
+
+/**
+ * Parâmetros comerciais do boleto. Ficam no Firestore de propósito: são
+ * parâmetro de negócio e mudam sem envolver engenharia nem deploy.
+ *
+ * Campo ausente cai no default do backend.
+ */
+export interface IInterBoletoDefaults {
+  /**
+   * Dias corridos após o vencimento até o cancelamento automático no Inter —
+   * na prática, o prazo limite para pagar. O máximo aceito pela API é 60.
+   */
+  num_dias_agenda?: number;
+  /** Multa por atraso, em % sobre o valor nominal. `0` desliga (campo omitido do payload ao Inter). */
+  multa_taxa?: number;
+  /** Juros de mora, em % ao mês. `0` desliga (campo omitido do payload ao Inter). */
+  mora_taxa?: number;
+}
+
 // ── Auth ──
 
 export interface IInterEnvAuthConfig {
@@ -26,6 +46,8 @@ export interface IInterEnvAuthConfig {
 
   timeout_ms?: number;
 
+  boleto_defaults?: IInterBoletoDefaults;
+
   webhook?: IInterWebhookConfig;
 }
 

package/package.json

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