Inventory
  1. Docs
Inventory
  • Docs
    • 00. Autenticação
    • 01. Incluir Movimentação Especial
    • 02. Incluir Nota Fiscal de Entrada
    • 03. Cancelar Nota Fiscal de Entrada
    • 04. Gerar Lote de Garantia para Item da Nota Fiscal
    • 05. Incluir Fornecedor
    • 06. Consultar Materiais/Itens
    • 07. Incluir Material/Item
    • 08. Consultar Tipos de Item
    • 09. Incluir Tipo de Item
    • 10. Vincular Tipo de Item a Centro de Estoque
    • 11. Consultar Famílias
    • 12. Incluir Família de Itens
    • 13. Consultar Centros de Estoque
    • 14. Incluir Centro de Estoque
    • 15. Atualizar Centro de Estoque
    • 16. Consultar Centros Financeiros
    • 17. Incluir Centros Financeiros
  • RM
    • Incluir movimentação especial
      POST
    • Incluir nota fiscal de entrada
      POST
    • Cancelar nota fiscal de entrada
      POST
    • Gerar lote de garantia para item da nota fiscal
      POST
    • Incluir fornecedor
      POST
    • Consultar materiais
      GET
    • Incluir material
      POST
    • Consultar tipos de item
      GET
    • Incluir tipo de item
      POST
    • Vincular tipo de item a centro de estoque
      POST
    • Consultar famílias
      GET
    • Incluir família
      POST
    • Consultar centros de estoque
      GET
    • Incluir centro de estoque
      POST
    • Atualizar centro de estoque
      PATCH
    • Consultar centros financeiros
      GET
    • Incluir centros financeiros
      POST
  1. Docs

02. Incluir Nota Fiscal de Entrada

Este método insere uma nota fiscal de entrada no sistema vinculada a uma ordem de compra e aos itens adquiridos. Os itens serão acrescentados ao centro de estoque especificado. Pode-se especificar centros de estoque diferentes para cada “tipo de item”, entretanto, itens de um mesmo “tipo de item” devem ser agrupados em um mesmo centro de estoque.
Para realizar o rastreamento da garantia de fabricante dos itens, basta incluir o lote do produto na requisição. Também é possível utilizar o endpoint descrito adiante.
Para o sucesso da operação, é necessário que outras entidades estejam previamente cadastradas como: fornecedor, item e centro de estoque. Endpoints para o cadastro destas entidades estão descritos na sequência.
Observação: dentro do array "ITENS", é possível incluir um item mais de uma vez (com o mesmo código). Nesse caso, suas quantidades serão somadas, desde que os demais dados do item sejam idênticos. Caso contrário, a nota registrará entradas separadas para cada item. O campo "LOTE_PRODUTO", no entanto, deve ser passado apenas uma vez para cada item de mesmo código e, caso o item se repita, todos eles ficarão associados ao mesmo “LOTE_PRODUTO”.
Exemplo 1:
{
    "NOME_FORNECEDOR": "Jules",
    "CNPJ_FORNECEDOR": "13791529000137",
    "LOGIN_RESPONSAVEL": "admin_user",
    "DATA_EMISSAO": "2024-03-02",
    "PRAZO_ENTREGA": "2024-05-02",
    "FORMA_PGTO": "BOL",
    "ITENS": [
   	 {
   		 "COD_ITEM": "1.473",
   		 "QUANT_ITEM": 3.0,
   		 "PRECO_ITEM": 4.47,
   		 "ID_CENTRO_ESTOQUE": 1,
   		 "LOTE_PRODUTO": "A107",
   		 "DATA_VENCIMENTO": "2024-07-26"
   	 },
   	 {
   		 "COD_ITEM": "00.568.4510",
   		 "QUANT_ITEM": 5.0,
   		 "PRECO_ITEM": 23.0,
   		 "ID_CENTRO_ESTOQUE": 1
   	 }
    ],
    "NUM_NOTA": "52332",
    "SERIE_NOTA": 1,
    "DATA_ENTRADA": "2024-04-02"
}
Exemplo 2:
{
    "NOME_FORNECEDOR": "Amy",
    "CNPJ_FORNECEDOR": "13791529000137",
    "LOGIN_RESPONSAVEL": "user.user",
    "DATA_EMISSAO": "2024-03-02",
    "PRAZO_ENTREGA": "2024-05-02",
    "FORMA_PGTO": "DIN",
    "ITENS": [
   	 {
   		 "COD_ITEM": "1.473",
   		 "QUANT_ITEM": 2.0,
   		 "PRECO_ITEM": 6.47,
   		 "ID_CENTRO_ESTOQUE": 1,
   		 "LOTE_PRODUTO": "240321",
   		 "DATA_VENCIMENTO": "2025-03-21"
   	 }
    ],
    "NUM_NOTA": "52332",
    "SERIE_NOTA": 1,
    "DATA_ENTRADA": "2024-04-02"
}

Retorno da requisição#

Um json com o status da requisição: sucesso ou erro. No caso de erro, é retornada uma mensagem descritiva do erro.
Exemplo 1: Sucesso 200 OK
{
   "status": "success",
   "data": {
       "ID_NF_ENTRADA": 12196
   }
}
Exemplo 2: Erro 400 Bad Request
{
    "status": "error",
    "message": "Centro de Estoque não existente."
}
Exemplo 3: Erro 400 Bad Request
{
    "status": "error",
    "message": "Preço não pode ser menor nem igual a 0."
}
Previous
01. Incluir Movimentação Especial
Next
03. Cancelar Nota Fiscal de Entrada