O Core avisa depois do commit. O handler não aborta a operação que já gravou.

Assine com SdkEvent / ctx.events.on. Nomes com ponto são o contrato da SDK. Aliases SCREAMING_SNAKE são o tipo interno do event store.

Vendas

SDK	Alias interno	Quando
`sales.order.created`	`SALES_ORDER_CREATED`	create do pedido
`sales.order.updated`	`SALES_ORDER_UPDATED`	edição
`sales.order.cancelled`	`SALES_ORDER_CANCELLED`	cancelamento
`sales.order.approved`	`SALES_ORDER_APPROVED`	aprovação
`sales.order.fulfilled`	`SALES_ORDER_FULFILLED`	depois do fulfill
`sales.quote.converted`	`SALES_ES_QUOTE_CONVERTED`	orçamento → pedido
`sales.order.convertedToQuote`	`SALES_ES_ORDER_TO_QUOTE`	pedido → orçamento
`sales.pdv.completed`	`PDV_SALE_COMPLETED`	fechamento PDV

Fiscal

SDK	Alias interno
`fiscal.calculation.completed`	`FISCAL_CALCULATION_COMPLETED`
`fiscal.lancamento.created`	`FISCAL_LANCAMENTO_CREATED`
`fiscal.lancamento.status_changed`	`FISCAL_LANCAMENTO_STATUS_CHANGED`
`fiscal.apuracao.closed`	`FISCAL_APURACAO_CLOSED`
`fiscal.apuracao.reopened`	`FISCAL_APURACAO_REOPENED`
`fiscal.nfe.authorized`	`FISCAL_NFE_AUTHORIZED`
`fiscal.nfe.rejected`	`FISCAL_NFE_REJECTED`
`fiscal.nfe.cancelled`	`FISCAL_NFE_CANCELLED`
`fiscal.nfe.inutilized`	`FISCAL_NFE_INUTILIZED`
`fiscal.nfse.authorized`	`NFSE_AUTHORIZED`
`fiscal.nfse.rejected`	`NFSE_REJECTED`
`fiscal.nfse.cancelled`	`NFSE_CANCELLED`

Outros eventos do Core (não estão no `SdkEvent`)

Compras emite PURCHASE_ORDER_CREATED / PURCHASE_ORDER_APPROVED. Financeiro enfileira FINANCIAL_EVENTS.PAYMENT_REGISTERED na TX da baixa. Industrial emite PRODUCT_BOM_CHANGED ao ativar/inativar BOM. Não declare esses nomes no m3r.json events[] — o validate só aceita o catálogo SDK.

Para reagir a compra/estoque/financeiro na extensão hoje: API + job, ou esperar o código entrar em SdkEvent.

Exemplo

import { SdkEvent } from "@m3r/sdk";

ctx.subscriptions.add(
  ctx.events.on(SdkEvent.SalesOrderFulfilled, async (evt) => {
    ctx.logger.info("pedido faturado", { code: evt.payload?.code });
  })
);

Detalhe de payload e ctx.events: ctx.events.

Eventos de domínio

Vendas

Fiscal

Outros eventos do Core (não estão no SdkEvent)

Exemplo

Outros eventos do Core (não estão no `SdkEvent`)