---
title: "Gera notas fiscais de uma fatura através do ID."
method: POST
path: "/v1/bills/{id}/invoice"
tags: ["bills"]
---

# Gera notas fiscais de uma fatura através do ID.

`POST /v1/bills/{id}/invoice`

Utilize esta operação para gerar notas fiscais a partir de uma fatura existente. Para isso é necessário que exista uma integração do tipo nota fiscal ativada e a fatura ainda não possua nenhuma nota fiscal gerada.

Múltiplas notas fiscais poderão ser geradas caso você esteja usando configurações com esta finalidade, como por exemplo, a [nota fiscal fracionada](https://atendimento.vindi.com.br/hc/pt-br/articles/115003695667-Nota-fiscal-fracionada).

Caso seja necessário emitir notas fiscais avulsas com configurações específicas, utilize o método `POST /invoices`.

## Path parameters

- `id` integer, required

## Response `200`

Notas fiscais geradas 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` — Fatura não encontrada.
- `422` — Parâmetros inválidos. Verificar erro na resposta.

---

[API](https://skmtc.net/vindi/apis/001-vindi-pagamentos-agost.md) · [All operations](https://skmtc.net/vindi/apis/001-vindi-pagamentos-agost/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vindi/001-vindi-pagamentos-agost/revisions/9d11e5de9308/schema)