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
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_saidastringNúmero da nota fiscal de saída vinculada à operação logística
nf_agstringNúmero da nota fiscal emitida pelo armazém (prestação de serviço)
data_saidastringData da saída física do material do armazém (formato: YYYY-MM-DD)
armazem_documentostringCNPJ do armazém responsável pela armazenagem e expedição
obsstringObservações adicionais sobre a operação de saída (opcional)

​
Exemplo

[
  {
    "codigo": "4001005001234",
    "lote": "LT-9421",
    "nf_ag": "9586",
    "quantidade": 206,
    "nf_saida": "556680",
    "data_saida": "2025-07-25",
    "armazem_documento": "00163083000130",
    "obs": "Saída parcial para devolução"
  }
]

{
	"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.