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

02. Incluir Nota Fiscal de Entrada

Retorno da requisição#

Retorno da requisição