Evento: Movimentação de Estoque

Disparado sempre que um produto é movimentado no estoque do estabelecimento, com foco no consumo de produtos pelo profissional: baixa automática dos produtos usados nos serviços, o estorno dessa baixa e os lançamentos manuais da tela de movimentação de estoque.

É enviado um evento por operação e um item por movimentação. Exemplo: finalizar um atendimento que usou 3 produtos gera 1 evento com 3 itens.

Este evento vai para todas as integrações com webhook cadastrado, sem necessidade de ativação. Integrações que não usam movimentação de estoque devem ignorar TipoDeEvento = 14.

Para conferir um período ou recuperar eventos não recebidos, use o endpoint Listar movimentações de estoque. O IdDaMovimentacao do webhook é o mesmo id do endpoint.


Quando o evento é enviado

Origem (Origem)Quando aconteceTipos de movimentação
BaixaAutomaticaNoAgendamentoAtendimento finalizado (no fechamento de conta ou direto na agenda); atendimento que sai do status finalizado; troca de serviço em atendimento finalizado; edição dos produtos usados em atendimento finalizado; entrega de pedido de produto para o atendimento.28 - Saída automática
27 - Estorno automático
MovimentacaoManualLançamentos feitos na tela de movimentação de estoque.8 - Uso interno
16 - Uso interno com cliente
3 - Compra do fornecedor e demais lançamentos manuais

Não geram este evento:

  • Venda e estorno de venda. Já são enviados nos eventos Fechamento de Conta (1) e Estorno de Conta (2).
  • Estorno do fechamento de conta. O atendimento continua finalizado e os produtos usados no serviço não voltam ao estoque. O estorno automático (27) só acontece quando o atendimento sai do status finalizado.
  • Pré-venda, inventário, estoque inicial e entrada de transferência no estabelecimento de destino.

Esses tipos aparecem no endpoint de ressincronização.


Estrutura do Evento

Atributos Enviados

AtributoTipoDescrição
ActionInteiroSempre 1 (inclusão). O estorno é indicado pelo tipo da movimentação (27).
TipoDeEventoInteiroSempre 14.
IdEventoStringUUID único do evento. Use para descartar duplicidades.
VersaoStringVersão do contrato (1.0). Campos existentes não são removidos; campos novos podem ser acrescentados.
DataHoraEventoGeradoStringData e hora em que o evento foi gerado (yyyy-MM-dd HH:mm:ss, horário de Brasília).
OrigemStringBaixaAutomaticaNoAgendamento ou MovimentacaoManual.
IdDoEstabelecimentoInteiroId do estabelecimento.
AgendamentoObjetoAtendimento que originou a baixa. Vem vazio ("") nas movimentações manuais.
Agendamento.IdDoAgendamentoInteiroId do agendamento.
Agendamento.IdDoServicoNoEstabelecimentoInteiroId do serviço no estabelecimento.
Agendamento.NomeDoServicoNoEstabelecimentoStringNome do serviço.
Agendamento.IdDoClienteNoEstabelecimentoInteiroCliente do atendimento.
ItensListaUma entrada por movimentação da operação.
Itens[].IdDaMovimentacaoInteiroId único da movimentação. Não se repete entre eventos. Igual ao id do endpoint de ressincronização.
Itens[].TipoDeMovimentacaoInteiroTipo da movimentação (ver tabela abaixo).
Itens[].DescricaoTipoDeMovimentacaoStringDescrição do tipo (ex.: "Saída Automática do Estoque").
Itens[].IdDoProdutoInteiroId do produto, o mesmo de GET /v1/produtos.
Itens[].NomeDoProdutoStringNome do produto.
Itens[].CodigoDeBarrasStringCódigo de barras do produto.
Itens[].SKUStringSKU do produto.
Itens[].UnidadeDeMedidaStringUnidade de medida do produto (ex.: ml).
Itens[].QuantidadeInteiroNegativa nas saídas e positiva nas entradas, na unidade de medida do produto.
Itens[].TipoDeQuantidadeStringPorFracao (fração da embalagem, ex.: ml) ou PorUnidade (embalagem inteira).
Itens[].CustoMedioStringCusto médio do produto no momento da movimentação.
Itens[].CustoTotalDaMovimentacaoStringCusto da operação, sempre positivo (o sinal está em Quantidade).
Itens[].CustoParaOProfissionalStringValor que o profissional paga pelo uso do produto, considerado no cálculo da comissão. Zera no estorno.
Itens[].CustoParaOClienteStringValor do produto repassado ao cliente.
Itens[].EstoqueDoProdutoAposAOperacaoInteiroSaldo do produto depois de todas as movimentações da operação (o mesmo valor em todos os itens do mesmo produto), na unidade de medida do produto.
Itens[].DataMovimentacaoStringData e hora da movimentação (yyyy-MM-dd HH:mm:ss).
Itens[].ProfissionalResponsavelObjetoProfissional que consumiu o produto. Na baixa automática é o profissional do atendimento; no uso interno, o informado no lançamento. Vem vazio ("") quando não há profissional.
Itens[].ProfissionalResponsavel.IdDoProfissionalInteiroId do cadastro geral do profissional (mesmo dos eventos 5 e 6).
Itens[].ProfissionalResponsavel.IdDoProfissionalNoEstabelecimentoInteiroId do profissional no estabelecimento (mesmo id de GET /v1/profissionais).
Itens[].ProfissionalResponsavel.CodigoDeIntegracaoStringCódigo de integração do profissional.
Itens[].ProfissionalResponsavel.NomeStringNome do profissional.
Itens[].IdDoClienteNoEstabelecimentoInteiroCliente ligado à movimentação, quando houver. Mesmo id dos eventos de cliente e de agendamento.
Itens[].ObservacaoStringObservação do lançamento.

Formatos: valores em reais são texto no padrão brasileiro ("13,50", vírgula decimal). Como nos demais eventos, todo campo sem valor chega como texto vazio (""), inclusive ids e objetos (Agendamento, ProfissionalResponsavel).

Tipos de movimentação mais comuns

TipoDescriçãoSinal da quantidade
3Compra do fornecedor-
8Uso interno−
16Uso interno com registro de cliente−
27Estorno automático para o estoque (desfaz uma saída 28)-
28Saída automática do estoque (produto usado no atendimento)−

Exemplo de Payload

{
  "Action": 1,
  "TipoDeEvento": 14,
  "IdEvento": "8b0c2f0e-6c1a-4c3e-9a51-2f0d8f1f3b7a",
  "Versao": "1.0",
  "DataHoraEventoGerado": "2026-10-05 14:32:10",
  "Origem": "BaixaAutomaticaNoAgendamento",
  "IdDoEstabelecimento": 123,
  "Agendamento": {
    "IdDoAgendamento": 456,
    "IdDoServicoNoEstabelecimento": 789,
    "NomeDoServicoNoEstabelecimento": "Coloração",
    "IdDoClienteNoEstabelecimento": 30
  },
  "Itens": [
    {
      "IdDaMovimentacao": 999,
      "TipoDeMovimentacao": 28,
      "DescricaoTipoDeMovimentacao": "Saída Automática do Estoque",
      "IdDoProduto": 555,
      "NomeDoProduto": "Tinta X",
      "CodigoDeBarras": "7891234567890",
      "SKU": "TX-01",
      "UnidadeDeMedida": "ml",
      "Quantidade": -30,
      "TipoDeQuantidade": "PorFracao",
      "CustoMedio": "0,45",
      "CustoTotalDaMovimentacao": "13,50",
      "CustoParaOProfissional": "13,50",
      "CustoParaOCliente": "0,00",
      "EstoqueDoProdutoAposAOperacao": 1470,
      "DataMovimentacao": "2026-10-05 14:32:09",
      "ProfissionalResponsavel": {
        "IdDoProfissional": 10,
        "IdDoProfissionalNoEstabelecimento": 20,
        "CodigoDeIntegracao": "COL-10",
        "Nome": "Ana Colorista"
      },
      "IdDoClienteNoEstabelecimento": 30,
      "Observacao": ""
    }
  ]
}

Boas práticas no receptor

  • Descartar duplicidades: o SNS pode reenviar o mesmo evento. Guarde o IdEvento e descarte os repetidos; no nível do item, use IdDaMovimentacao.
  • Não depender da ordem: a ordem de chegada não é garantida. Para ordenar, use DataMovimentacao e IdDaMovimentacao.
  • Reconciliar periodicamente: use Listar movimentações de estoque (por exemplo, uma vez por dia) para conferir o período e recuperar eventos não recebidos.