Skip to main content

​
Visão Geral

Confirma a entrada física dos materiais no armazém geral, validando os dados da nota fiscal e registrando a movimentação de estoque no sistema MGN SYSTEM - AG CONTROL. Essa API é utilizada após o recebimento físico dos produtos no AG, normalmente via integração automática ou processo interno do WMS. A confirmação é feita por item e por lote, associando o número da nota fiscal do cliente e a nota fiscal do armazém (NF-AG). Método HTTP: POST /v1/confirmar_recebimento

​
Headers

NomeValor
Content-Typeapplication/json
AuthorizationBearer <token>

​
Campos

NomeTipoDescrição
armazem_documentostringCNPJ do armazém geral responsável pelo recebimento
codigostringCódigo do produto conforme cadastro na base da empresa
lotestringLote do produto a ser confirmado
nf_entradastringNúmero da nota fiscal de entrada do cliente (empresa contratante do AG)
nf_agstringNúmero da nota fiscal emitida pelo armazém geral (prestação de serviço)
data_entradastringData efetiva do recebimento físico no armazém (formato: YYYY-MM-DD)

​
Exemplo

[
  {
    "armazem_documento": "00163083000130",
    "codigo": "5001007003456",
    "lote": "LT-6286",
    "nf_entrada": "266549",
    "nf_ag": "8335",
    "data_entrada": "2025-07-24"
  }
]

{
	"mensagem": "Entradas confirmadas com sucesso"
}

​
Erros comuns

CódigoMensagemCausa Provável
400Campos obrigatórios ausentesCampos como nf_entrada, lote ou armazem_documento ausente
403Usuário sem acesso ao armazémPolíticas RLS impedem a operação
404Movimentação não encontradaNão existe entrada para os dados informados
409Movimentação já confirmadaJá existe confirmação para esse item/lote
500Erro internoErro de banco, RLS ou inconsistência de dados
  • A confirmação será realizada apenas se a movimentação original de ENTRADA já estiver registrada para o mesmo produto, lote, nf_entrada, empresa e armazem.
  • A nf_ag e a data_entrada serão associadas ao registro original.