Inventory EBS
  1. EBS
Inventory EBS
  • Docs
    • 01. Autenticação
    • 02. Confirmar Movimentação de Estoque
    • 03. Informar Número da Ordem de Movimentação
    • 04. Incluir Nota Fiscal de Entrada
    • 05. Cancelar Nota Fiscal de Entrada
    • 06. Incluir Movimentação Especial
    • 07. Consultar Materiais/Itens
    • 08. Incluir Material/Item
    • 09. Atualizar Material/Item
    • 10. Incluir Fornecedor
    • 11. Atualizar Fornecedor
    • 12. Consultar Tipos de Item
    • 13. Incluir Tipo de Item
    • 14. Consultar Família de Itens
    • 15. Incluir Família de Itens
    • 16. Atualizar Família de Itens
    • 17. Consultar Centros de Estoque
    • 18. Consultar Saldo de Estoque de Centro de Estoque
  • EBS
    • Confirmar Movimentação de Estoque
      POST
    • Informar Número da Ordem de Movimentação
      POST
    • Incluir movimentação especial
      POST
    • Incluir nota fiscal de entrada
      POST
    • Cancelar nota fiscal de entrada
      POST
    • Consultar materiais
      GET
    • Atualizar materiais
      PATCH
    • Incluir material
      POST
    • Incluir fornecedor
      POST
    • Atualizar Fornecedor
      PATCH
    • Consultar tipos de item
      GET
    • Incluir tipo de item
      POST
    • Atualizar família de itens
      PATCH
    • Consultar família de itens
      GET
    • Incluir família
      POST
    • Consultar famílias
      GET
    • Consultar centros de estoque
      GET
    • Saldo Centro Estoque
      GET
  1. EBS

Incluir nota fiscal de entrada

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

Request

Body Params application/json

Examples
{
    "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,
            "ID_CENTRO_ESTOQUE": 1,
            "LOTE_PRODUTO": "LOTE2",
            "DATA_VENCIMENTO": "2026-02-27",
            "IDENTIFICACOES": [
                {
                    "COD_MATERIAL_IDENT": "SERIAL003"
                }
            ]
        }
    ]
}

Request Code 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
curl --location --request POST 'https://api.exati.com.br/inventory/nfe' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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,
            "ID_CENTRO_ESTOQUE": 1,
            "LOTE_PRODUTO": "LOTE2",
            "DATA_VENCIMENTO": "2026-02-27",
            "IDENTIFICACOES": [
                {
                    "COD_MATERIAL_IDENT": "SERIAL003"
                }
            ]
        }
    ]
}'

Responses

🟢200OK
application/json
Nota fiscal incluída
Body

Example
{
    "status": "success",
    "data": {
        "ID_NF_ENTRADA": 12196
    }
}
🟠400Bad Request
Modified at 2025-03-18 21:09:56
Previous
Incluir movimentação especial
Next
Cancelar nota fiscal de entrada