cadastrar notas

Cadastra uma ou mais notas fiscais para o pedido informado na URL. As notas são enviadas à loja na próxima sincronização.

orderId: código do pedido na API (campo code, visível na consulta do pedido) ou ID do pedido na loja.

Regras:

o pedido precisa existir na API;

code identifica a nota na API e é usado depois para consultar, atualizar e remover. Use um valor único por nota;

se já existir uma nota com o mesmo code, ela não é alterada e não aparece na resposta. Para alterar uma nota existente, use PUT /orders/invoices/{invoiceCode};

cada product_code em items precisa ser um item do pedido; caso contrário a nota é recusada;

cada nota é gravada separadamente: se uma nota do lote for recusada, as demais continuam sendo gravadas e a resposta lista o resultado de cada uma.

Atenção: a loja soma a quantidade faturada dos itens a cada envio da mesma nota. Evite reenviar items de uma nota já cadastrada; para corrigir dados como rastreio ou datas, use o PUT sem items.

curl --location '/orders/PED-000123/invoices' \ --header 'Content-Type: application/json' \ --data '{ "data": [ { "code": "NF-000150-1", "type": "SALE", "distribution_center_code": "CD1", "number": "150", "serie": "1", "key": "35261011222333000181550010000001501000001500", "invoice_date": "2026-10-19 13:00:00", "delivery_date": "2026-10-24 17:00:00", "items": [ { "product_code": "PROD-001", "attended_quantity": 10 } ] } ] }'

[ { "id": 501, "code": "NF-000150-1", "order_id": 123, "type": "SALE", "distribution_center_code": "CD1", "number": "150", "serie": "1", "key": "35261011222333000181550010000001501000001500", "invoice_date": "2026-10-19 13:00:00", "delivery_date": "2026-10-24 17:00:00", "created_at": "2026-10-19T16:00:00.000000Z", "updated_at": "2026-10-19T16:00:00.000000Z" } ]

Requisição

Respostas