Cria ou atualiza uma retenção

PUT 
/v1/withholdings

Localiza a retenção por id, public_id ou external_id. Não encontrando, cria com o corpo completo e devolve 201. Encontrando, aplica apenas competence_month, competence_year, metadata, external_id e custom_metadata: base, rate, amount e withholder_id são imutáveis após o registro e vêm ignorados no corpo de atualização.

Request

Responses

200

Registro atualizado.

201

Registro criado.

400

Corpo da requisição falhou na validação.

401

Token bearer ausente ou inválido.

403

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"].

404

Recurso não encontrado na organização atual.

422

Corpo da requisição falhou na validação.

429

Limite de requisições excedido.

500

Erro inesperado no servidor.