evo360-types 1.3.734 → 1.3.746

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

@@ -1,7 +1,8 @@
 "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.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.zServiceInvoiceCancellationSchema = exports.zNfseCancellationStatusSchema = exports.zPaymentLinkSchema = exports.zPaymentLinkDocumentStateSchema = exports.zAsaasPaymentLinkSubscriptionCycleSchema = exports.zAsaasPaymentLinkChargeTypeSchema = exports.zAsaasPaymentLinkBillingTypeSchema = exports.zProviderPayloadSnapshotSchema = exports.zProviderTraceSchema = exports.zProviderInvoiceErrorSchema = exports.zProviderInvoiceIdentifiersSchema = exports.zProviderInvoiceLinksSchema = void 0;
+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.zServiceInvoiceReplacedBySchema = exports.zServiceInvoiceReissuedFromSchema = exports.zServiceInvoiceReissueSchema = exports.zNfseReissueStageSchema = exports.zNfseReissueFieldSchema = exports.zNfseReissueStatusSchema = exports.zServiceInvoiceCancellationSchema = exports.zNfseCancellationStatusSchema = exports.zPaymentLinkSchema = exports.zPaymentLinkDocumentStateSchema = exports.zAsaasPaymentLinkSubscriptionCycleSchema = exports.zAsaasPaymentLinkChargeTypeSchema = exports.zAsaasPaymentLinkBillingTypeSchema = exports.zProviderPayloadSnapshotSchema = exports.zProviderTraceSchema = exports.zProviderInvoiceErrorSchema = exports.zProviderInvoiceIdentifiersSchema = exports.zProviderInvoiceLinksSchema = void 0;
+exports.zNfseFeeReimbursementExecuteSchema = void 0;
 const zod_1 = require("zod");
 const zod_schemas_1 = require("../shared/zod-schemas");
 // ---- Provider enums and base ----
@@ -671,6 +672,75 @@ exports.zServiceInvoiceCancellationSchema = zod_1.z
     attempts: zod_1.z.number().int().nonnegative(),
 })
     .passthrough();
+// ---- Reemissão de NFS-e (feat-292) ----
+exports.zNfseReissueStatusSchema = zod_1.z.enum([
+    "requesting",
+    "requested",
+    "failed",
+]);
+exports.zNfseReissueFieldSchema = zod_1.z.enum([
+    "value",
+    "service_description",
+    "observations",
+    "deductions",
+    "taxes",
+]);
+exports.zNfseReissueStageSchema = zod_1.z.enum(["get", "put", "authorize"]);
+const zNfseReissueActorSchema = zod_1.z
+    .object({
+    user_id: zod_1.z.string(),
+    login_id: zod_1.z.string().optional(),
+    name: zod_1.z.string().optional(),
+})
+    .passthrough();
+exports.zServiceInvoiceReissueSchema = zod_1.z
+    .object({
+    status: exports.zNfseReissueStatusSchema,
+    attempts: zod_1.z.number().int().nonnegative(),
+    last_at: zod_schemas_1.zFirestoreDateSchema,
+    last_by: zNfseReissueActorSchema,
+    previous_state: exports.zServiceInvoiceStateSchema,
+    previous_error: exports.zProviderInvoiceErrorSchema.nullable().optional(),
+    changes: zod_1.z.array(zod_1.z
+        .object({
+        field: exports.zNfseReissueFieldSchema,
+        from: zod_1.z.unknown().optional(),
+        to: zod_1.z.unknown().optional(),
+    })
+        .passthrough()),
+    stage: exports.zNfseReissueStageSchema.optional(),
+    provider_status_at_response: exports.zProviderServiceInvoiceStatusSchema.optional(),
+    responded_at: zod_schemas_1.zFirestoreDateSchema.optional(),
+    error: zod_1.z
+        .object({
+        http_status: zod_1.z.number().optional(),
+        code: zod_1.z.string().optional(),
+        description: zod_1.z.string().optional(),
+    })
+        .passthrough()
+        .optional(),
+})
+    .passthrough();
+exports.zServiceInvoiceReissuedFromSchema = zod_1.z
+    .object({
+    invoiceId: zod_1.z.string(),
+    provider_invoice_id: zod_1.z.string().optional(),
+    number: zod_1.z.string().optional(),
+    state_at_reissue: exports.zServiceInvoiceStateSchema,
+    at: zod_schemas_1.zFirestoreDateSchema,
+    by: zNfseReissueActorSchema,
+})
+    .passthrough();
+exports.zServiceInvoiceReplacedBySchema = zod_1.z
+    .object({
+    status: zod_1.z.enum(["pending", "done"]),
+    invoiceId: zod_1.z.string().optional(),
+    provider_invoice_id: zod_1.z.string().optional(),
+    requested_at: zod_schemas_1.zFirestoreDateSchema,
+    requested_by: zNfseReissueActorSchema,
+    done_at: zod_schemas_1.zFirestoreDateSchema.optional(),
+})
+    .passthrough();
 exports.zServiceInvoiceSchema = zod_schemas_1.zFireDocSchema
     .extend({
     providerId: zod_1.z.string(),
@@ -730,6 +800,15 @@ exports.zServiceInvoiceSchema = zod_schemas_1.zFireDocSchema
     canceled_at: zod_schemas_1.zFirestoreDateSchema.optional(),
     error: exports.zProviderInvoiceErrorSchema.nullable().optional(),
     cancellation: exports.zServiceInvoiceCancellationSchema.optional(),
+    reissue: exports.zServiceInvoiceReissueSchema.optional(),
+    reissued_from: exports.zServiceInvoiceReissuedFromSchema.optional(),
+    replaced_by: exports.zServiceInvoiceReplacedBySchema.optional(),
+    observations: zod_1.z.string().optional(),
+    deductions: zod_1.z.number().optional(),
+    effective_date: zod_1.z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/)
+        .optional(),
     trace: exports.zProviderTraceSchema.optional(),
     snapshots: zod_1.z.array(exports.zProviderPayloadSnapshotSchema).optional(),
 })

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

@@ -733,6 +733,85 @@ export const zServiceInvoiceCancellationSchema = z
   })
   .passthrough();
 
+// ---- Reemissão de NFS-e (feat-292) ----
+
+export const zNfseReissueStatusSchema = z.enum([
+  "requesting",
+  "requested",
+  "failed",
+]);
+
+export const zNfseReissueFieldSchema = z.enum([
+  "value",
+  "service_description",
+  "observations",
+  "deductions",
+  "taxes",
+]);
+
+export const zNfseReissueStageSchema = z.enum(["get", "put", "authorize"]);
+
+const zNfseReissueActorSchema = z
+  .object({
+    user_id: z.string(),
+    login_id: z.string().optional(),
+    name: z.string().optional(),
+  })
+  .passthrough();
+
+export const zServiceInvoiceReissueSchema = z
+  .object({
+    status: zNfseReissueStatusSchema,
+    attempts: z.number().int().nonnegative(),
+    last_at: zFirestoreDateSchema,
+    last_by: zNfseReissueActorSchema,
+    previous_state: zServiceInvoiceStateSchema,
+    previous_error: zProviderInvoiceErrorSchema.nullable().optional(),
+    changes: z.array(
+      z
+        .object({
+          field: zNfseReissueFieldSchema,
+          from: z.unknown().optional(),
+          to: z.unknown().optional(),
+        })
+        .passthrough(),
+    ),
+    stage: zNfseReissueStageSchema.optional(),
+    provider_status_at_response: zProviderServiceInvoiceStatusSchema.optional(),
+    responded_at: zFirestoreDateSchema.optional(),
+    error: z
+      .object({
+        http_status: z.number().optional(),
+        code: z.string().optional(),
+        description: z.string().optional(),
+      })
+      .passthrough()
+      .optional(),
+  })
+  .passthrough();
+
+export const zServiceInvoiceReissuedFromSchema = z
+  .object({
+    invoiceId: z.string(),
+    provider_invoice_id: z.string().optional(),
+    number: z.string().optional(),
+    state_at_reissue: zServiceInvoiceStateSchema,
+    at: zFirestoreDateSchema,
+    by: zNfseReissueActorSchema,
+  })
+  .passthrough();
+
+export const zServiceInvoiceReplacedBySchema = z
+  .object({
+    status: z.enum(["pending", "done"]),
+    invoiceId: z.string().optional(),
+    provider_invoice_id: z.string().optional(),
+    requested_at: zFirestoreDateSchema,
+    requested_by: zNfseReissueActorSchema,
+    done_at: zFirestoreDateSchema.optional(),
+  })
+  .passthrough();
+
 export const zServiceInvoiceSchema = zFireDocSchema
   .extend({
     providerId: z.string(),
@@ -794,6 +873,15 @@ export const zServiceInvoiceSchema = zFireDocSchema
     canceled_at: zFirestoreDateSchema.optional(),
     error: zProviderInvoiceErrorSchema.nullable().optional(),
     cancellation: zServiceInvoiceCancellationSchema.optional(),
+    reissue: zServiceInvoiceReissueSchema.optional(),
+    reissued_from: zServiceInvoiceReissuedFromSchema.optional(),
+    replaced_by: zServiceInvoiceReplacedBySchema.optional(),
+    observations: z.string().optional(),
+    deductions: z.number().optional(),
+    effective_date: z
+      .string()
+      .regex(/^\d{4}-\d{2}-\d{2}$/)
+      .optional(),
     trace: zProviderTraceSchema.optional(),
     snapshots: z.array(zProviderPayloadSnapshotSchema).optional(),
   })

package/dist/index.d.ts

@@ -74,6 +74,7 @@ export * from "./apps/evo-task/zod-schemas";
 export * from "./apps/evo-survey/zod-schemas";
 export * from "./apps/evo-finops/zod-schemas";
 export * from "./apps/evo-finops/nfse-cancel";
+export * from "./apps/evo-finops/nfse-reissue";
 export * from "./apps/evo-notif-user/zod-schemas";
 export * from "./apps/evo-notifications/zod-schemas";
 export * from "./apps/evo-notifications/quick-reply-action/zod-schemas";

package/dist/index.js

@@ -92,6 +92,7 @@ __exportStar(require("./apps/evo-task/zod-schemas"), exports);
 __exportStar(require("./apps/evo-survey/zod-schemas"), exports);
 __exportStar(require("./apps/evo-finops/zod-schemas"), exports);
 __exportStar(require("./apps/evo-finops/nfse-cancel"), exports);
+__exportStar(require("./apps/evo-finops/nfse-reissue"), exports);
 __exportStar(require("./apps/evo-notif-user/zod-schemas"), exports);
 __exportStar(require("./apps/evo-notifications/zod-schemas"), exports);
 __exportStar(require("./apps/evo-notifications/quick-reply-action/zod-schemas"), exports);

package/dist/index.ts

@@ -77,6 +77,7 @@ export * from "./apps/evo-task/zod-schemas";
 export * from "./apps/evo-survey/zod-schemas";
 export * from "./apps/evo-finops/zod-schemas";
 export * from "./apps/evo-finops/nfse-cancel";
+export * from "./apps/evo-finops/nfse-reissue";
 export * from "./apps/evo-notif-user/zod-schemas";
 export * from "./apps/evo-notifications/zod-schemas";
 export * from "./apps/evo-notifications/quick-reply-action/zod-schemas";

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

@@ -151,6 +151,116 @@ export interface INfseCancelResult {
     providerStatus?: ProviderServiceInvoiceStatus;
     message: string;
 }
+/**
+ * Situação da correção no lugar ("Corrigir e reemitir") de uma nota em ERROR.
+ * - `requesting`: trava gravada, chamadas ao provedor (GET → PUT → authorize) em andamento.
+ * - `requested`: provedor aceitou a correção e a reemissão (o estado final chega pelo webhook).
+ * - `failed`: provedor recusou ou a chamada falhou; ver `stage` e `error`.
+ */
+export type NfseReissueStatus = "requesting" | "requested" | "failed";
+/** Campos que a correção no lugar pode alterar (o PUT do Asaas não muda tomador nem serviço municipal). */
+export type NfseReissueField = "value" | "service_description" | "observations" | "deductions" | "taxes";
+/** Etapa da correção no lugar em que a falha ocorreu. */
+export type NfseReissueStage = "get" | "put" | "authorize";
+/**
+ * Impostos enviados ao provedor (formato do Asaas). O PUT exige o objeto completo;
+ * o backend monta a partir do GET + `tax` local + edição, nunca zerando com defaults.
+ */
+export interface INfseReissueTaxes {
+    retainIss?: boolean;
+    iss?: number;
+    pis?: number;
+    cofins?: number;
+    csll?: number;
+    inss?: number;
+    ir?: number;
+}
+/** Uma alteração aplicada na correção (auditoria). */
+export interface INfseReissueChange {
+    field: NfseReissueField;
+    from?: unknown;
+    to?: unknown;
+}
+/** Registro da última correção no lugar ("Corrigir e reemitir") de uma nota em ERROR. */
+export interface IServiceInvoiceReissue {
+    status: NfseReissueStatus;
+    /** Quantas vezes a correção foi pedida (inclui a tentativa atual). */
+    attempts: number;
+    last_at: Date;
+    last_by: {
+        user_id: string;
+        login_id?: string;
+        name?: string;
+    };
+    /** Estado da nota no momento do pedido (normalmente ERROR). */
+    previous_state: ServiceInvoiceState;
+    /** Erro da prefeitura que motivou a correção (o `error` da nota é apagado no sucesso). */
+    previous_error?: IProviderInvoiceError;
+    changes: INfseReissueChange[];
+    /** Etapa em que a falha ocorreu (só quando `status = failed`). */
+    stage?: NfseReissueStage;
+    provider_status_at_response?: ProviderServiceInvoiceStatus;
+    responded_at?: Date;
+    error?: {
+        http_status?: number;
+        code?: string;
+        description?: string;
+    };
+}
+/** Na nota NOVA: de qual nota ela é a reemissão ("Reemitir como nova"). */
+export interface IServiceInvoiceReissuedFrom {
+    invoiceId: string;
+    provider_invoice_id?: string;
+    number?: string;
+    /** Estado da nota de origem no momento da reemissão (CANCELED ou ERROR). */
+    state_at_reissue: ServiceInvoiceState;
+    at: Date;
+    by: {
+        user_id: string;
+        login_id?: string;
+        name?: string;
+    };
+}
+/** Na nota de ORIGEM: qual nota a substituiu (uma substituição por origem). */
+export interface IServiceInvoiceReplacedBy {
+    /** `pending` = trava gravada, emissão da nova em andamento; `done` = nova emitida. */
+    status: "pending" | "done";
+    invoiceId?: string;
+    provider_invoice_id?: string;
+    requested_at: Date;
+    requested_by: {
+        user_id: string;
+        login_id?: string;
+        name?: string;
+    };
+    done_at?: Date;
+}
+/** Alterações pedidas na correção no lugar (todas opcionais; ausente = mantém). */
+export interface INfseReissueChanges {
+    value?: number;
+    service_description?: string;
+    observations?: string;
+    deductions?: number;
+    taxes?: INfseReissueTaxes;
+}
+/** Entrada do callable `finops_nfse-reissue`. */
+export interface INfseReissueRequest {
+    tenant: string;
+    invoiceId: string;
+    changes: INfseReissueChanges;
+}
+/** Saída do callable `finops_nfse-reissue`. */
+export interface INfseReissueResult {
+    invoiceId: string;
+    previousState: ServiceInvoiceState;
+    state: ServiceInvoiceState;
+    providerStatus?: ProviderServiceInvoiceStatus;
+    /** Campos efetivamente alterados (vazio = reenvio sem mudanças). */
+    changedFields?: NfseReissueField[];
+    message: string;
+    /** Presente quando o Asaas aceitou mas a gravação local falhou (o webhook reconcilia). */
+    warning?: string;
+}
 export interface IServiceInvoice extends IFireDoc {
     providerId: string;
     provider_name?: string;
@@ -189,6 +299,18 @@ export interface IServiceInvoice extends IFireDoc {
     canceled_at?: Date;
     error?: IProviderInvoiceError;
     cancellation?: IServiceInvoiceCancellation;
+    /** Última correção no lugar ("Corrigir e reemitir") de nota em ERROR. */
+    reissue?: IServiceInvoiceReissue;
+    /** Nesta nota (nova): de qual nota ela é a reemissão. */
+    reissued_from?: IServiceInvoiceReissuedFrom;
+    /** Nesta nota (origem): qual nota a substituiu. */
+    replaced_by?: IServiceInvoiceReplacedBy;
+    /** Observações enviadas ao provedor (persistidas a partir da feat-292). */
+    observations?: string;
+    /** Deduções enviadas ao provedor (persistidas a partir da feat-292). */
+    deductions?: number;
+    /** Data de emissão enviada ao provedor, YYYY-MM-DD (fuso de Brasília). */
+    effective_date?: string;
     trace?: ProviderTrace;
     snapshots?: ProviderPayloadSnapshot[];
     [key: string]: unknown;

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

@@ -191,6 +191,134 @@ export interface INfseCancelResult {
   message: string;
 }
 
+// ---- Reemissão de NFS-e (feat-292) ----
+
+/**
+ * Situação da correção no lugar ("Corrigir e reemitir") de uma nota em ERROR.
+ * - `requesting`: trava gravada, chamadas ao provedor (GET → PUT → authorize) em andamento.
+ * - `requested`: provedor aceitou a correção e a reemissão (o estado final chega pelo webhook).
+ * - `failed`: provedor recusou ou a chamada falhou; ver `stage` e `error`.
+ */
+export type NfseReissueStatus = "requesting" | "requested" | "failed";
+
+/** Campos que a correção no lugar pode alterar (o PUT do Asaas não muda tomador nem serviço municipal). */
+export type NfseReissueField =
+  | "value"
+  | "service_description"
+  | "observations"
+  | "deductions"
+  | "taxes";
+
+/** Etapa da correção no lugar em que a falha ocorreu. */
+export type NfseReissueStage = "get" | "put" | "authorize";
+
+/**
+ * Impostos enviados ao provedor (formato do Asaas). O PUT exige o objeto completo;
+ * o backend monta a partir do GET + `tax` local + edição, nunca zerando com defaults.
+ */
+export interface INfseReissueTaxes {
+  retainIss?: boolean;
+  iss?: number;
+  pis?: number;
+  cofins?: number;
+  csll?: number;
+  inss?: number;
+  ir?: number;
+}
+
+/** Uma alteração aplicada na correção (auditoria). */
+export interface INfseReissueChange {
+  field: NfseReissueField;
+  from?: unknown;
+  to?: unknown;
+}
+
+/** Registro da última correção no lugar ("Corrigir e reemitir") de uma nota em ERROR. */
+export interface IServiceInvoiceReissue {
+  status: NfseReissueStatus;
+  /** Quantas vezes a correção foi pedida (inclui a tentativa atual). */
+  attempts: number;
+  last_at: Date;
+  last_by: {
+    user_id: string;
+    login_id?: string;
+    name?: string;
+  };
+  /** Estado da nota no momento do pedido (normalmente ERROR). */
+  previous_state: ServiceInvoiceState;
+  /** Erro da prefeitura que motivou a correção (o `error` da nota é apagado no sucesso). */
+  previous_error?: IProviderInvoiceError;
+  changes: INfseReissueChange[];
+  /** Etapa em que a falha ocorreu (só quando `status = failed`). */
+  stage?: NfseReissueStage;
+  provider_status_at_response?: ProviderServiceInvoiceStatus;
+  responded_at?: Date;
+  error?: {
+    http_status?: number;
+    code?: string;
+    description?: string;
+  };
+}
+
+/** Na nota NOVA: de qual nota ela é a reemissão ("Reemitir como nova"). */
+export interface IServiceInvoiceReissuedFrom {
+  invoiceId: string;
+  provider_invoice_id?: string;
+  number?: string;
+  /** Estado da nota de origem no momento da reemissão (CANCELED ou ERROR). */
+  state_at_reissue: ServiceInvoiceState;
+  at: Date;
+  by: {
+    user_id: string;
+    login_id?: string;
+    name?: string;
+  };
+}
+
+/** Na nota de ORIGEM: qual nota a substituiu (uma substituição por origem). */
+export interface IServiceInvoiceReplacedBy {
+  /** `pending` = trava gravada, emissão da nova em andamento; `done` = nova emitida. */
+  status: "pending" | "done";
+  invoiceId?: string;
+  provider_invoice_id?: string;
+  requested_at: Date;
+  requested_by: {
+    user_id: string;
+    login_id?: string;
+    name?: string;
+  };
+  done_at?: Date;
+}
+
+/** Alterações pedidas na correção no lugar (todas opcionais; ausente = mantém). */
+export interface INfseReissueChanges {
+  value?: number;
+  service_description?: string;
+  observations?: string;
+  deductions?: number;
+  taxes?: INfseReissueTaxes;
+}
+
+/** Entrada do callable `finops_nfse-reissue`. */
+export interface INfseReissueRequest {
+  tenant: string;
+  invoiceId: string;
+  changes: INfseReissueChanges;
+}
+
+/** Saída do callable `finops_nfse-reissue`. */
+export interface INfseReissueResult {
+  invoiceId: string;
+  previousState: ServiceInvoiceState;
+  state: ServiceInvoiceState;
+  providerStatus?: ProviderServiceInvoiceStatus;
+  /** Campos efetivamente alterados (vazio = reenvio sem mudanças). */
+  changedFields?: NfseReissueField[];
+  message: string;
+  /** Presente quando o Asaas aceitou mas a gravação local falhou (o webhook reconcilia). */
+  warning?: string;
+}
+
 export interface IServiceInvoice extends IFireDoc {
   providerId: string;
   provider_name?: string;
@@ -257,6 +385,20 @@ export interface IServiceInvoice extends IFireDoc {
   // Último pedido de cancelamento feito pela plataforma (feat-291)
   cancellation?: IServiceInvoiceCancellation;
 
+  // Reemissão (feat-292)
+  /** Última correção no lugar ("Corrigir e reemitir") de nota em ERROR. */
+  reissue?: IServiceInvoiceReissue;
+  /** Nesta nota (nova): de qual nota ela é a reemissão. */
+  reissued_from?: IServiceInvoiceReissuedFrom;
+  /** Nesta nota (origem): qual nota a substituiu. */
+  replaced_by?: IServiceInvoiceReplacedBy;
+  /** Observações enviadas ao provedor (persistidas a partir da feat-292). */
+  observations?: string;
+  /** Deduções enviadas ao provedor (persistidas a partir da feat-292). */
+  deductions?: number;
+  /** Data de emissão enviada ao provedor, YYYY-MM-DD (fuso de Brasília). */
+  effective_date?: string;
+
   // Debug/audit
   trace?: ProviderTrace;
   snapshots?: ProviderPayloadSnapshot[]; // store last N snapshots (or store separately)

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

@@ -32,6 +32,16 @@ export interface IUsageCapabilities {
      * desenhada antes dessa data, porque ausência de medição não é consumo zero.
      */
     telemedicine_since: string | null;
+    /**
+     * feat-302 F2 — transcrição de áudio medida (evento `media.transcription`).
+     * Opcional: produtor antigo não envia; ausente = série não desenhada.
+     */
+    transcription?: boolean;
+    /**
+     * Data (`YYYY-MM-DD`) do primeiro evento de transcrição medido (sem
+     * backfill). `null`/ausente antes do deploy do emissor.
+     */
+    transcription_since?: string | null;
 }
 /**
  * Uma linha da abertura por departamento dentro de um mês.
@@ -94,6 +104,46 @@ export interface IUsageLlm {
     tokens_output: number;
     tokens_cache_write: number;
     tokens_cache_read: number;
+    /**
+     * feat-302 F2 — custo ESTIMADO em US$ (preço de lista, `cost_usd_est` dos
+     * eventos). Informativo, não é fatura. `null` quando nenhum evento do mês tem
+     * preço conhecido. Opcional: produtor antigo não envia.
+     */
+    cost_usd_est?: number | null;
+    /**
+     * feat-302 F2 — quebra por categoria de produto (visão de custo por tenant).
+     * Só categorias com uso no mês aparecem. A soma bate com o total do bloco.
+     * Opcional: produtor antigo não envia.
+     */
+    por_categoria?: Partial<Record<UsageAiCategory, IUsageLlmCategory>>;
+}
+/**
+ * feat-302 F2 — categorias de uso de IA do TENANT (espelho de
+ * `AiUsageCategory` do `@evo/hubia`, sem as internas como `csq_judge`).
+ * - `hubia`: atendimento (turnos do LLM, reativação, busca de família).
+ * - `attachment_analysis`: leitura de foto/PDF pelo classificador de anexos.
+ * - `audio_synthesis`: resposta em áudio (reservada; ainda sem emissor).
+ */
+export type UsageAiCategory = "hubia" | "attachment_analysis" | "audio_synthesis";
+export interface IUsageLlmCategory {
+    /** Chamadas ao LLM nesta categoria (execuções/análises, dedup por evento). */
+    turnos: number;
+    tokens_total: number;
+    /** US$ estimado (preço de lista); `null` sem preço conhecido. */
+    cost_usd_est: number | null;
+}
+/**
+ * feat-302 F2 — transcrição de áudio no mês (Whisper; evento
+ * `media.transcription`, 1 por áudio, dedup por mensagem). Informativo: não é
+ * cobrado. Bloco `null` = capability desligada (não é consumo zero).
+ */
+export interface IUsageTranscription {
+    audios: number;
+    segundos: number;
+    /** `segundos / 60`, 2 casas. */
+    minutos: number;
+    /** US$ estimado (preço de lista); `null` sem duração/preço. */
+    cost_usd_est: number | null;
 }
 /**
  * Teleconsultas REALIZADAS no mês (feat-160 F18 / D33). Realizada = a consulta
@@ -119,6 +169,8 @@ export interface IMonthlyUsageRow {
     notificacoes: IUsageNotifications;
     ia: IUsageLlm | null;
     telemedicina: IUsageTelemedicine | null;
+    /** feat-302 F2 — opcional: produtor antigo não envia; `null` = capability desligada. */
+    transcricao?: IUsageTranscription | null;
 }
 export interface IMonthlyUsageResponse {
     ok: true;

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

@@ -48,6 +48,16 @@ export interface IUsageCapabilities {
    * desenhada antes dessa data, porque ausência de medição não é consumo zero.
    */
   telemedicine_since: string | null;
+  /**
+   * feat-302 F2 — transcrição de áudio medida (evento `media.transcription`).
+   * Opcional: produtor antigo não envia; ausente = série não desenhada.
+   */
+  transcription?: boolean;
+  /**
+   * Data (`YYYY-MM-DD`) do primeiro evento de transcrição medido (sem
+   * backfill). `null`/ausente antes do deploy do emissor.
+   */
+  transcription_since?: string | null;
 }
 
 /**
@@ -114,6 +124,49 @@ export interface IUsageLlm {
   tokens_output: number;
   tokens_cache_write: number;
   tokens_cache_read: number;
+  /**
+   * feat-302 F2 — custo ESTIMADO em US$ (preço de lista, `cost_usd_est` dos
+   * eventos). Informativo, não é fatura. `null` quando nenhum evento do mês tem
+   * preço conhecido. Opcional: produtor antigo não envia.
+   */
+  cost_usd_est?: number | null;
+  /**
+   * feat-302 F2 — quebra por categoria de produto (visão de custo por tenant).
+   * Só categorias com uso no mês aparecem. A soma bate com o total do bloco.
+   * Opcional: produtor antigo não envia.
+   */
+  por_categoria?: Partial<Record<UsageAiCategory, IUsageLlmCategory>>;
+}
+
+/**
+ * feat-302 F2 — categorias de uso de IA do TENANT (espelho de
+ * `AiUsageCategory` do `@evo/hubia`, sem as internas como `csq_judge`).
+ * - `hubia`: atendimento (turnos do LLM, reativação, busca de família).
+ * - `attachment_analysis`: leitura de foto/PDF pelo classificador de anexos.
+ * - `audio_synthesis`: resposta em áudio (reservada; ainda sem emissor).
+ */
+export type UsageAiCategory = "hubia" | "attachment_analysis" | "audio_synthesis";
+
+export interface IUsageLlmCategory {
+  /** Chamadas ao LLM nesta categoria (execuções/análises, dedup por evento). */
+  turnos: number;
+  tokens_total: number;
+  /** US$ estimado (preço de lista); `null` sem preço conhecido. */
+  cost_usd_est: number | null;
+}
+
+/**
+ * feat-302 F2 — transcrição de áudio no mês (Whisper; evento
+ * `media.transcription`, 1 por áudio, dedup por mensagem). Informativo: não é
+ * cobrado. Bloco `null` = capability desligada (não é consumo zero).
+ */
+export interface IUsageTranscription {
+  audios: number;
+  segundos: number;
+  /** `segundos / 60`, 2 casas. */
+  minutos: number;
+  /** US$ estimado (preço de lista); `null` sem duração/preço. */
+  cost_usd_est: number | null;
 }
 
 /**
@@ -141,6 +194,8 @@ export interface IMonthlyUsageRow {
   notificacoes: IUsageNotifications;
   ia: IUsageLlm | null;
   telemedicina: IUsageTelemedicine | null;
+  /** feat-302 F2 — opcional: produtor antigo não envia; `null` = capability desligada. */
+  transcricao?: IUsageTranscription | null;
 }
 
 export interface IMonthlyUsageResponse {

package/package.json

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