Inventory
  1. RM
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. RM

Incluir nota fiscal de entrada

POST
/nfe
RMEBS
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”.

Request

Body Params application/json
NOME_FORNECEDOR
string 
required
CNPJ_FORNECEDOR
string 
optional
CPF_FORNECEDOR
string 
optional
LOGIN_RESPONSAVEL
string 
optional
DATA_EMISSAO
string 
required
PRAZO_ENTREGA
string 
required
FORMA_PGTO
enum<string> 
required
Allowed values:
DDADINDEBCARBOLDOCTEDTRAFOLCHPCHQCREDEP
NUM_NOTA
string 
required
SERIE_NOTA
number 
required
DATA_ENTRADA
string 
required
ITENS
array[object (CreateNfeItemDto) {6}] 
required
COD_ITEM
string 
required
QUANT_ITEM
number 
required
PRECO_ITEM
number 
required
ID_CENTRO_ESTOQUE
number 
required
LOTE_PRODUTO
string 
optional
DATA_VENCIMENTO
string 
optional
Example
{
    "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,
            "PRECO_ITEM": 4.47,
            "ID_CENTRO_ESTOQUE": 1,
            "LOTE_PRODUTO": "A107",
            "DATA_VENCIMENTO": "2024-07-26"
        },
        {
            "COD_ITEM": "00.568.4510",
            "QUANT_ITEM": 5,
            "PRECO_ITEM": 23,
            "ID_CENTRO_ESTOQUE": 1
        }
    ],
    "NUM_NOTA": "52332",
    "SERIE_NOTA": 1,
    "DATA_ENTRADA": "2024-04-02"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://middlewareestoque-homol.exati.com.br/nfe' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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,
            "PRECO_ITEM": 4.47,
            "ID_CENTRO_ESTOQUE": 1,
            "LOTE_PRODUTO": "A107",
            "DATA_VENCIMENTO": "2024-07-26"
        },
        {
            "COD_ITEM": "00.568.4510",
            "QUANT_ITEM": 5,
            "PRECO_ITEM": 23,
            "ID_CENTRO_ESTOQUE": 1
        }
    ],
    "NUM_NOTA": "52332",
    "SERIE_NOTA": 1,
    "DATA_ENTRADA": "2024-04-02"
}'

Responses

🟢200OK
application/json
Nota fiscal incluída
Body
status
string 
optional
data
object 
optional
ID_NF_ENTRADA
integer 
optional
Examples
{
    "status": "success",
    "data": {
        "ID_NF_ENTRADA": 12196
    }
}
🟠400Bad Request
Previous
Incluir movimentação especial
Next
Cancelar nota fiscal de entrada