---
title: "Atualiza uma nota fiscal existente."
method: PUT
path: "/v1/invoices/{id}"
tags: ["invoices"]
---

# Atualiza uma nota fiscal existente.

`PUT /v1/invoices/{id}`

## Request

- Base URL: `//app.vindi.com.br/api` (relative, and the document’s source URL is not known)
- URL: `//app.vindi.com.br/api/v1/invoices/{id}`
- Auth: HTTP basic

## Path parameters

- `id` integer, required

## Request body

- PutV1Invoices: Atualiza uma nota fiscal existente.
  - `body` string: JSON com os novos atributos da nota fiscal.
  - `amount` number: Valor da nota fiscal
  - `scheduled_at` string: Data e hora do agendamento da nota fiscal no formato ISO 8601. Use nulo para emissão imediata
  - `accrued_on` string: Data de competência da nota fiscal. Se não informada, será utilizada a data de agendamento. Caso a data de agendamento não exista, será utilizada a data atual
  - `description` string: Descrição que será exibida na nota fiscal. Se não informada, a configuração padrão da integração será usada
  - `settings` 'metadata': Configurações adicionais usadas na integração

## Response `200`

Nota fiscal atualizada com sucesso.

- Invoice: Utilize este método para listar as notas fiscais associadas à sua conta na Vindi. Leia a documentação sobre [paginação](http://atendimento.vindi.com.br/hc/pt-br/articles/203020644#pagination) e [filtros de busca](http://atendimento.vindi.com.br/hc/pt-br/articles/204163150). #### Atributos para busca <code>id</code>, <code>customer_id</code>, <code>bill_id</code>, <code>integration_id</code>, <code>status</code>, <code>integration_invoice_id</code>, <code>integration_reference</code>, <code>issued_at</code>, <code>created_at</code> e <code>integration_type</code>.
  - `id` integer, required: ID da nota fiscal
  - `amount` number, required: Valor da nota fiscal
  - `status` 'processing' | 'success' | 'failure' | 'canceled' | 'waiting' | 'processing_cancel' | 'cancel_failure' | 'scheduled', required: Status da nota fiscal
  - `integration_invoice_id` string, required: Código externo da integração
  - `integration_reference` string, required: Número ou referência da nota fiscal na instituição governamental
  - `print_url` string: URL para impressão da nota fiscal
  - `description` string: Descrição usada para a geração nota fiscal. Se não informada, a configuração padrão da integração será usada
  - `settings` string: Configurações adicionais usadas na integração
  - `issued_at` string: Data e hora da emissão da nota fiscal
  - `accrued_on` string: Data de competência da nota fiscal
  - `scheduled_at` string: Data e hora do agendamento da nota fiscal
  - `created_at` string, required: Data e hora da geração da nota fiscal
  - `updated_at` string, required: Data e hora da última atualização da nota fiscal
  - `bill` BillSummary, required
    - `id` integer, required: ID da fatura
    - `code` string: Código externo para referência via API
  - `customer` CustomerSummary, required
    - `id` integer, required: ID do cliente
    - `name` string, required: Nome do cliente
    - `email` string: E-mail do cliente
    - `code` string: Código opcional para referência via API

## Other responses

- `400`: Erro de sintaxe JSON no corpo do request.
- `404`: Nota fiscal não encontrada.
- `422`: Parâmetros inválidos. Verificar erro na resposta.

---

[API](https://skmtc.dev/vindi/apis/api-vindi.md) - [All operations](https://skmtc.dev/vindi/apis/api-vindi/llms.txt) - [OpenAPI document](https://skmtc.dev/vindi/apis/api-vindi/revisions/3e857e1cdd03?raw)