evo360-types 1.3.734 → 1.3.736

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/package.json

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