> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Atualizar um rascunho

> Atualizar um rascunho.

Edita somente uma invoice `draft`. Os campos ausentes são preservados. Não é possível trocar cliente, moeda ou assinatura. Uma invoice já finalizada retorna `409`.

A API recalcula os totais a partir dos itens no salvamento. A edição não cria pagamento, link público ou e-mail. Para períodos de assinatura ambíguos, novos itens são recusados; os itens existentes podem ser enviados com seu `id`, preservando período, vínculo e prorrata.

**id** `string` *required*

ID da invoice (`inv_*`).

**amount** `integer`

Valor em centavos, inclusive zero. Alternativa a `line_items`.

**line\_items** `array`

Substitui todos os itens. Usa o mesmo formato da criação. Em um item existente, envie `id` para preservar seu período e vínculo com a assinatura. Não envie `amount` junto.

**description** `string | null`

Descrição da cobrança.

**statement\_descriptor** `string | null`

Identificador que aparecerá na cobrança.

**due\_date** `string`

Vencimento em ISO 8601.

**days\_until\_due** `integer`

Prazo em dias, como alternativa a `due_date`.

**collection\_method** `string`

`send_invoice` ou `charge_automatically`. O segundo exige uma assinatura.

**default\_payment\_method** `string | null`

Método do mesmo cliente e organização.

**payment\_method\_types** `array`

Métodos permitidos: `pix`, `boleto`, `credit_card`. Pelo menos um.

**payment\_settings** `object`

Mesmo contrato de parcelamento das assinaturas: `payment_method_options.credit_card.installments.plan` com `type: "fixed_count"`, `interval: "month"` e `count` de 2 até o limite configurado (máximo 12). O principal deve comportar pelo menos R\$ 7,00 por parcela. Envie `payment_method_options.credit_card: null` para remover o plano fixo.

**late\_fee** `object | null`

Multa no mesmo formato da criação; `null` desliga.

**interest** `object | null`

Juros no mesmo formato da criação; `null` desliga.

**allow\_late\_payment** `boolean`

Permite pagamento após o vencimento.

**delivery** `string`

`chargefy` envia e-mail e lembretes depois da finalização; `manual` deixa a entrega com você.

**reminder\_before\_due\_days** `integer`

Dias antes do vencimento. Inteiro não negativo.

**reminder\_past\_due\_days** `integer`

Dias após o vencimento. Inteiro não negativo.

**metadata** `object`

Metadados do integrador.

```json Response 200 theme={"theme":"css-variables"}
{
  "id": "inv_ztXkaV1WLnrmCafN",
  "object": "invoice",
  "affiliates": [],
  "allow_late_payment": true,
  "amount_credit_balance_applied": 0,
  "amount_discount": 0,
  "amount_due": 12990,
  "amount_due_now": 12990,
  "amount_paid": 0,
  "amount_remaining": 12990,
  "amount_subtotal": 12990,
  "amount_tax": 0,
  "amount_total": 12990,
  "attempt_count": 0,
  "billing_reason": "manual",
  "collection_method": "send_invoice",
  "created_at": "2026-05-19T18:00:00Z",
  "currency": "brl",
  "customer": "cus_9KaTnfYPTCwvFLAd",
  "customer_billing_address": null,
  "customer_billing_name": null,
  "customer_document": null,
  "customer_document_type": null,
  "customer_email": null,
  "customer_name": null,
  "default_payment_method": null,
  "description": "Mensalidade de junho",
  "due_date": "2026-06-10T12:00:00Z",
  "ending_balance": 0,
  "finalized_at": null,
  "hosted_invoice_url": null,
  "interest": {
    "percent_per_month": 1
  },
  "interest_amount": null,
  "invoice_pdf_url": null,
  "late_fee": {
    "type": "percentage",
    "value": 2
  },
  "late_fee_amount": null,
  "latest_charge": null,
  "line_items": [
    {
      "id": "ili_GyVv5CghtCEFZTQj",
      "object": "invoice_line_item",
      "amount_discount": 0,
      "amount_subtotal": 12990,
      "amount_tax": 0,
      "amount_total": 12990,
      "currency": "brl",
      "description": "Mensalidade de junho",
      "discountable": true,
      "metadata": {},
      "period_end": null,
      "period_start": null,
      "position": 0,
      "price": null,
      "price_data": {
        "currency": "brl",
        "unit_amount": 12990
      },
      "product": null,
      "proration": false,
      "proration_details": {},
      "quantity": 1,
      "recurring_interval": null,
      "recurring_interval_count": null,
      "subscription_item": null,
      "unit_amount": 12990
    }
  ],
  "livemode": true,
  "marked_uncollectible_at": null,
  "metadata": {},
  "next_payment_attempt": null,
  "number": null,
  "paid_at": null,
  "paid_out_of_band": false,
  "payment_intent": null,
  "payment_method_types": [
    "pix",
    "boleto",
    "credit_card"
  ],
  "payment_settings": {
    "payment_method_options": null
  },
  "starting_balance": 0,
  "statement_descriptor": "MENSALIDADE",
  "status": "draft",
  "subscription": null,
  "surcharge_amount": 0,
  "updated_at": "2026-05-19T18:00:00Z",
  "voided_at": null
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.