atualizar nota

PUT

/orders/invoices/{invoiceCode}

Atualiza a nota fiscal informada na URL. A nota atualizada é reenviada à loja na próxima sincronização.

Envie apenas os campos que deseja alterar; nenhum campo é obrigatório. O corpo é um único objeto (sem data).

Listas (items e bankbills):

não enviada: não é alterada;

enviada: substitui integralmente a lista atual.

Atenção: a loja soma a quantidade faturada dos itens a cada envio da mesma nota. Para corrigir dados como rastreio, datas ou arquivo, envie o PUT sem items. Cada product_code em items precisa ser um item do pedido.

Requisição

Parâmetros de Caminho

Parâmetros Bodyapplication/jsonObrigatório

Examples

Respostas

🟢200OK

application/json

Nota atualizada.

Bodyapplication/json

🟠400Pedido Inválido

🔴500Erro do Servidor

Request Example

Shell

JavaScript

Java

Swift

cURL

Atualizar apenas o rastreioEnviar o arquivo da notaSubstituir os boletos

curl --location --request PUT '/orders/invoices/NF-000150-1' \
--header 'Content-Type: application/json' \
--data '{
    "tracking_code": "BR987654321",
    "tracking_url": "https://rastreio.exemplo.com.br/BR987654321"
}'

Response Example

200 - Nota atualizada

{
    "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",
    "tracking_code": "BR987654321",
    "tracking_url": "https://rastreio.exemplo.com.br/BR987654321",
    "created_at": "2026-10-19T16:00:00.000000Z",
    "updated_at": "2026-10-19T18:30:00.000000Z"
}

Modificado em 2026-10-19 20:18:07