Skip to main content

​
Visão Geral

Registra movimentações de entrada de estoque, integrando dados de NF-e e armazenagem no sistema MGN SYSTEM - AG CONTROL. Essa API é normalmente utilizada por sistemas externos como o ERP, que envia os dados da nota fiscal eletrônica e dos itens armazenados para controle logístico. Método HTTP: POST /v1/entrada

​
Headers

NomeValor
Content-Typeapplication/json
AuthorizationBearer <token>

​
Campos

​
Emitente

NomeTipoDescrição
tipo_parceirostringCOMPANHIA / CLIENTE
nomestringNome ou razão social do destinatário
documentostringCNPJ ou CPF do destinatário
endereco.logradourostringNome da rua / avenida
endereco.numerostringNúmero do endereço
endereco.complementostringComplemento (opcional)
endereco.bairrostringBairro
endereco.cepstringCEP no formato 00000-000
endereco.cidadestringCidade
endereco.ufstringUF (sigla do estado)
endereco.paisstringPaís
endereco.latitudestringLatitude geográfica
endereco.longitudestringLongitude geográfica

​
Destinatário

NomeTipoDescrição
nomestringNome ou razão social do destinatário
documentostringCNPJ ou CPF do destinatário
tipo_parceirostringCLIENTE / ARMAZEM
endereco.logradourostringNome da rua / avenida
endereco.numerostringNúmero do endereço
endereco.complementostringComplemento (opcional)
endereco.bairrostringBairro
endereco.cepstringCEP no formato 00000-000
endereco.cidadestringCidade
endereco.ufstringUF (sigla do estado)
endereco.paisstringPaís
endereco.latitudestringLatitude geográfica
endereco.longitudestringLongitude geográfica

​
Embarque

NomeTipoDescrição
nf_entradastringNúmero da Nota Fiscal de Entrada
data_emissaostring (YYYY-MM-DD)Data de emissão da nota fiscal
itensarray de objetosLista de itens recebidos

​
Embarque (array dentro de **embarque.itens)

NomeTipoDescrição
codigostringCódigo do produto
descricaostringDescrição do produto
unidadestringUnidade de medida (ex: KG, L, CX)
quantidadenumberQuantidade recebida
lotestringCódigo do lote
data_fabricacaostring (YYYY-MM-DD)Data de fabricação
data_vencimentostring (YYYY-MM-DD)Data de vencimento
valor_unitarionumberValor unitário do produto

​
Exemplo

[
    {
      "emitente": {
        "tipo_parceiro": "COMPANHIA",
        "nome": "EMPRESA EMBARCADORA LTDA",
        "documento": "55.444.333/0001-22",
        "endereco": {
          "cep": "80010-000",
          "logradouro": "Av. Central",
          "numero": "500",
          "bairro": "Centro",
          "cidade": "Curitiba",
          "uf": "PR",
          "pais": "Brasil"
        }
      },
      "destinatario": {
        "tipo_parceiro": "ARMAZEM",
        "nome": "AG LOGISTICA SUL",
        "documento": "98.765.432/0001-11",
        "endereco": {
          "cep": "95010-000",
          "logradouro": "Rodovia BR-116",
          "numero": "KM 150",
          "bairro": "Zona Rural",
          "cidade": "Caxias do Sul",
          "uf": "RS",
          "pais": "Brasil",
          "latitude": "-29.167839",
          "longitude": "-51.179385"
        }
      },
      "embarque": {
        "nf_entrada": "NF987654",
        "data_emissao": "2026-02-02",
        "itens": [
          {
            "codigo": "PROD-COMPANHIA-01",
            "descricao": "Produto COMPANHIA",
            "unidade": "UN",
            "quantidade": "200",
            "lote": "CL20260202",
            "data_fabricacao": "2026-01-20",
            "data_vencimento": "2026-06-20",
            "valor_unitario": "5.30"
          }
        ]
      }
    }
  ]

{
	"status": "ok",
	"mensagem": "Entradas processadas com sucesso"
}

​
Erros comuns

CódigoMensagemCausa Provável
400Campos obrigatórios ausentesCampo como nf_entrada ou itens nulo
403Usuário sem vínculo com a empresaToken não corresponde à empresa enviada
422Documento do destinatário inválido ou mal formatadoCPF/CNPJ incorreto
500Erro interno ao processar entradaDados inconsistentes ou duplicados
  • A movimentação registrada tem tipo_movimentacao = ‘ENTRADA’.
  • Se o produto, armazém ou parceiro ainda não existir, será criado automaticamente vinculado à empresa.
  • A função respeita as RLS policies para garantir que o usuário só altere dados da empresa à qual está vinculado.