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 acontece | Tipos de movimentação |
|---|---|---|
BaixaAutomaticaNoAgendamento | Atendimento 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 |
MovimentacaoManual | Lanç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
| Atributo | Tipo | Descrição |
|---|---|---|
Action | Inteiro | Sempre 1 (inclusão). O estorno é indicado pelo tipo da movimentação (27). |
TipoDeEvento | Inteiro | Sempre 14. |
IdEvento | String | UUID único do evento. Use para descartar duplicidades. |
Versao | String | Versão do contrato (1.0). Campos existentes não são removidos; campos novos podem ser acrescentados. |
DataHoraEventoGerado | String | Data e hora em que o evento foi gerado (yyyy-MM-dd HH:mm:ss, horário de Brasília). |
Origem | String | BaixaAutomaticaNoAgendamento ou MovimentacaoManual. |
IdDoEstabelecimento | Inteiro | Id do estabelecimento. |
Agendamento | Objeto | Atendimento que originou a baixa. Vem vazio ("") nas movimentações manuais. |
Agendamento.IdDoAgendamento | Inteiro | Id do agendamento. |
Agendamento.IdDoServicoNoEstabelecimento | Inteiro | Id do serviço no estabelecimento. |
Agendamento.NomeDoServicoNoEstabelecimento | String | Nome do serviço. |
Agendamento.IdDoClienteNoEstabelecimento | Inteiro | Cliente do atendimento. |
Itens | Lista | Uma entrada por movimentação da operação. |
Itens[].IdDaMovimentacao | Inteiro | Id único da movimentação. Não se repete entre eventos. Igual ao id do endpoint de ressincronização. |
Itens[].TipoDeMovimentacao | Inteiro | Tipo da movimentação (ver tabela abaixo). |
Itens[].DescricaoTipoDeMovimentacao | String | Descrição do tipo (ex.: "Saída Automática do Estoque"). |
Itens[].IdDoProduto | Inteiro | Id do produto, o mesmo de GET /v1/produtos. |
Itens[].NomeDoProduto | String | Nome do produto. |
Itens[].CodigoDeBarras | String | Código de barras do produto. |
Itens[].SKU | String | SKU do produto. |
Itens[].UnidadeDeMedida | String | Unidade de medida do produto (ex.: ml). |
Itens[].Quantidade | Inteiro | Negativa nas saídas e positiva nas entradas, na unidade de medida do produto. |
Itens[].TipoDeQuantidade | String | PorFracao (fração da embalagem, ex.: ml) ou PorUnidade (embalagem inteira). |
Itens[].CustoMedio | String | Custo médio do produto no momento da movimentação. |
Itens[].CustoTotalDaMovimentacao | String | Custo da operação, sempre positivo (o sinal está em Quantidade). |
Itens[].CustoParaOProfissional | String | Valor que o profissional paga pelo uso do produto, considerado no cálculo da comissão. Zera no estorno. |
Itens[].CustoParaOCliente | String | Valor do produto repassado ao cliente. |
Itens[].EstoqueDoProdutoAposAOperacao | Inteiro | Saldo 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[].DataMovimentacao | String | Data e hora da movimentação (yyyy-MM-dd HH:mm:ss). |
Itens[].ProfissionalResponsavel | Objeto | Profissional 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.IdDoProfissional | Inteiro | Id do cadastro geral do profissional (mesmo dos eventos 5 e 6). |
Itens[].ProfissionalResponsavel.IdDoProfissionalNoEstabelecimento | Inteiro | Id do profissional no estabelecimento (mesmo id de GET /v1/profissionais). |
Itens[].ProfissionalResponsavel.CodigoDeIntegracao | String | Código de integração do profissional. |
Itens[].ProfissionalResponsavel.Nome | String | Nome do profissional. |
Itens[].IdDoClienteNoEstabelecimento | Inteiro | Cliente ligado à movimentação, quando houver. Mesmo id dos eventos de cliente e de agendamento. |
Itens[].Observacao | String | Observaçã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
| Tipo | Descrição | Sinal da quantidade |
|---|---|---|
| 3 | Compra do fornecedor | - |
| 8 | Uso interno | − |
| 16 | Uso interno com registro de cliente | − |
| 27 | Estorno automático para o estoque (desfaz uma saída 28) | - |
| 28 | Saí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
IdEventoe descarte os repetidos; no nível do item, useIdDaMovimentacao. - Não depender da ordem: a ordem de chegada não é garantida. Para ordenar, use
DataMovimentacaoeIdDaMovimentacao. - 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.

