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”.

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Nota fiscal incluída

Body

status

string

optional

data

object

optional

ID_NF_ENTRADA

integer

optional

Examples

Example 1Example 2

{
    "status": "success",
    "data": {
        "ID_NF_ENTRADA": 12196
    }
}

Incluir nota fiscal de entrada

Request

Request samples

Responses