Atualizar fatura
PATCH/v1/invoices/:id
Atualização parcial: campos ausentes mantêm o valor atual. Uma fatura paid, void ou uncollectible mantém as condições travadas e aceita só subscription_id, description, line_items, metadata, custom_metadata e external_id — e, quando paid, também nfe_issuance_policy e nfe_description_line. Mudar o valor de qualquer outro campo nesses status (empresa, método de cobrança, política de juros e multa, vencimento, competência, rodapé) responde 422 com o código INVOICE_FIELD_LOCKED e, em details, status, locked_fields (os campos recusados) e editable_fields. Um campo travado enviado com o valor já gravado não é mudança: é ignorado, então reenviar o objeto inteiro lido da API funciona. line_items continua recusado (409) enquanto a fatura tiver NF-e emitida ou em processamento. A mesma regra vale para o PUT /invoices quando ele encontra uma fatura existente.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 422
- 429
- 500
Fatura atualizada.
Corpo da requisição falhou na validação.
Token bearer ausente ou inválido.
Token válido, porém sem permissão para esta operação. Com code insufficient_scope, details.required traz o único conjunto mínimo de escopos que, somados a details.granted, deixaria a requisição passar: o escopo do recurso (billing/{recurso}, ou billing/all fora do catálogo) e depois o verbo puro — por exemplo ["billing/customers", "delete"].
Recurso não encontrado na organização atual.
Corpo da requisição falhou na validação.
Limite de requisições excedido.
Erro inesperado no servidor.