04. 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 o cadastro das identificações dos materiais, é necessário especificar o lote e os números de série do material. Por exemplo, quando se inclui 4 lâmpadas de código “1030001” e se deseja identificar duas delas, deve-se passar a construção abaixo dentro do array ITENS. As outras duas unidades da lâmpada ficariam sem identificação neste caso.

{
   "COD_ITEM": "1030001",
   "QUANT_ITEM": 4,
   "PRECO_ITEM": 23.0,
   "ID_CENTRO_ESTOQUE": 1,
   "LOTE_PRODUTO": "LOTE1",
   "DATA_VENCIMENTO": "2026-02-27",
   "IDENTIFICACOES": [
       {
           "COD_MATERIAL_IDENT": "SERIAL001"
       },
       {
           "COD_MATERIAL_IDENT": "SERIAL002"
       }
   ]
}

O código de identificação do material ficará salvo no Exati composto pela concatenação do código do material, do lote e do número de série, separados por um underline ( _ ), por exemplo, “1030001_LOTE01_SERIAL001”. Mais informações em “2.5 Processo de Identificação dos Materiais”.

Com o recebimento dessas informações, as identificações serão cadastradas no sistema Exati e poderão ser rastreadas em todas as movimentações do material, inclusive no momento de sua aplicação, e o controle de garantia também será realizado.
Exemplo completo ao fim da seção.

Notas Fracionadas

Uma mesma nota fiscal poderá ser passada mais de uma vez para o sistema Exati, possibilitando que o EBS fracione a quantidade de itens presentes na nota em múltiplos envios. Cada nota recebida repetidamente ficará indexada no sistema Exati da seguinte maneira: se passada a nota de número 53 três vezes, ela será cadastrada com os números 53, 53.2 e 53.3.

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: os materiais podem se repetir dentro da array ITENS. Assim, é possível separar, em cada linha, lotes distintos para um mesmo material. Vide exemplo abaixo.

Exemplo 1: será incluído no estoque três unidades do material “1030001”, sendo duas unidades do lote “LOTE1” e uma do lote “LOTE2”

{
   "NOME_FORNECEDOR": "Isabella",
   "CNPJ_FORNECEDOR": "13791529000137",
   "LOGIN_RESPONSAVEL": "integracao_estoque",
   "DATA_EMISSAO": "2025-02-28",
   "PRAZO_ENTREGA": "2025-02-28",
   "FORMA_PGTO": "BOL",
   "NUM_NOTA": "53",
   "SERIE_NOTA": 1,
   "DATA_ENTRADA": "2025-02-28",
   "ITENS": [
       {
           "COD_ITEM": "1030001",
           "QUANT_ITEM": 2,
           "PRECO_ITEM": 4.47,
           "ID_CENTRO_ESTOQUE": 1,
           "LOTE_PRODUTO": "LOTE1",
           "DATA_VENCIMENTO": "2025-12-31",
           "IDENTIFICACOES": [
               {
                   "COD_MATERIAL_IDENT": "SERIAL001"
               },
               {
                   "COD_MATERIAL_IDENT": "SERIAL002"
               }
           ]
       },
       {
           "COD_ITEM": "1030001",
           "QUANT_ITEM": 1,
           "PRECO_ITEM": 23.0,
           "ID_CENTRO_ESTOQUE": 1,
           "LOTE_PRODUTO": "LOTE2",
           "DATA_VENCIMENTO": "2026-02-27",
           "IDENTIFICACOES": [
               {
                   "COD_MATERIAL_IDENT": "SERIAL003"
               }
           ]
       }
   ]
}

Exemplo 2:

{
    "NOME_FORNECEDOR": "Amy",
    "CNPJ_FORNECEDOR": "13791529000137",
    "LOGIN_RESPONSAVEL": "integracao_estoque",
    "DATA_EMISSAO": "2024-03-02",
    "PRAZO_ENTREGA": "2024-05-02",
    "FORMA_PGTO": "DIN",
    "NUM_NOTA": "52332",
    "SERIE_NOTA": 1,
    "DATA_ENTRADA": "2024-04-02",
    "ITENS": [
   	 {
   		 "COD_ITEM": "1.473",
   		 "QUANT_ITEM": 2.0,
   		 "PRECO_ITEM": 6.47,
   		 "ID_CENTRO_ESTOQUE": 1
   	 }
    ]
}

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

Exemplo no Postman:

04. Incluir Nota Fiscal de Entrada

Retorno da requisição#

Retorno da requisição