Skip to main content

​
Visão Geral

Registra movimentações de saída de estoque no sistema MGN SYSTEM - AG CONTROL, com base na baixa dos itens armazenados em armazéns gerais (AGs). Essa API é utilizada quando o material deixa fisicamente o AG, seja por expedição, transferência, devolução, consumo ou outro motivo logístico. Método HTTP: POST /v1/saida

​
Headers

NomeValor
Content-Typeapplication/json
AuthorizationBearer <token>

​
Campos

NomeTipoDescrição
ag_documentostringCNPJ do armazém responsável pela armazenagem e expedição
codigostringCódigo do produto conforme cadastro na empresa
lotestringLote do produto a ser baixado
quantidadestringQuantidade a ser baixada do estoque (pode ser parcial ou total)
nf_entradastringNúmero da nota fiscal de entrada vinculada à operação logística
nf_saidastringNúmero da nota fiscal de saída vinculada à operação logística
data_saidastringData da saída física do material do armazém (formato: YYYY-MM-DD)
obsstringObservações adicionais sobre a operação de saída (opcional)

​
Exemplo

[
    {
      "ag_documento": "98.765.432/0001-11",
      "codigo": "PROD-001",
      "lote": "L20260201A",
      "quantidade": "10",
      "nf_entrada": "NF123456",
      "nf_saida": "RET0001",
      "data_saida": "2026-02-06",
      "obs": "Retorno parcial"
    }
  ]

{
	"mensagem": "Saídas confirmadas com sucesso"
}

​
Erros comuns

CódigoMensagemCausa Provável
400Campos obrigatórios ausentesFalta de lote, codigo ou nf_entrada
403Usuário sem acesso ao armazémSem vínculo com empresa ou armazém
404Entrada correspondente não encontradaLote ou NF de entrada inválidos
409Quantidade excede o saldo disponívelTentativa de saída maior do que a entrada confirmada
500Erro internoViolação de política RLS, chave duplicada etc
  • A API busca automaticamente a movimentação de ENTRADA correspondente ao produto, lote, empresa, armazem e nf_entrada, e aplica a saída com o saldo disponível.
  • O campo obs pode ser utilizado para indicar o motivo da baixa (ex: devolução, consumo, transferência).
  • Se a quantidade informada exceder o saldo disponível, o sistema retornará erro de saldo insuficiente.