Recorrência & Mensalidades (NFS-e)

Atualizar Contrato Recorrente

Atualiza informações do contrato recorrente como valor da cobrança, dia de vencimento, descrição do serviço ou contato do tomador.

PUT
https://api.nfer.me
/v1/recurring-contracts/{id}

Authorizations

X-API-Key
string
header
required

Chave de API emitida no painel NFER enviada no header da requisição.

Content-Type
string
header
required

application/json

Path Parameters

id
string<uuid>
required

UUID do contrato recorrente.

Exemplo:a819c940-bf72-46a2-9659-192518e11a91

Body

application/json
amount
number
opcional

Novo valor da mensalidade.

Exemplo:1750.00
dayOfMonth
integer (1 a 31)
opcional

Novo dia de vencimento/emissão no mês.

Exemplo:15
description
string
opcional

Nova discriminação de serviços.

Exemplo:Suporte e Consultoria - Ref. {{mes_ano}}
active
boolean
opcional

Status de ativação do contrato.

nextIssueDate
string<date>
opcional

Sobrescreve a data da próxima emissão (YYYY-MM-DD).

Response

application/json

Contrato atualizado com sucesso.

id
string<uuid>
opcional

Identificador único do recurso.

Exemplo:a819c940-bf72-46a2-9659-192518e11a91
amount
integer
opcional
Exemplo:1750
day_of_month
integer
opcional
Exemplo:15
next_issue_date
string
opcional

Exemplo retornado: "2026-11-15"

Exemplo:2026-11-15
updated_at
string<date-time>
opcional

Data e hora da última atualização.

Exemplo:2026-10-14T23:10:00.000Z
Atualizar Contrato Recorrente
curl --request PUT \
  --url https://api.nfer.me/v1/recurring-contracts/{id} \
  --header 'X-API-Key: <sua_chave_api>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 1750,
  "dayOfMonth": 15
}'
{
  "id": "a819c940-bf72-46a2-9659-192518e11a91",
  "amount": 1750,
  "day_of_month": 15,
  "next_issue_date": "2026-11-15",
  "updated_at": "2026-10-14T23:10:00.000Z"
}