DOM360
Financeiro

Bloquear ou desbloquear um cliente por decisão da DOM360

PATCH
/billing/blocks/{tenant_id}

Liga (admin = blocked) ou desliga (unblocked) o bloqueio administrativo, com motivo; nenhum pagamento o tira. Pedir o estado em que o cliente já está não grava nada e devolve o estado. Bloquear um cliente excluído é 409 (tenant_deleted); desbloquear um é aceito. O bloqueio financeiro não muda por aqui: só o pagamento ou o passe o mudam.

Autorização

bearer billing:execute
AutorizaçãoBearer <token>

Credencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.

Em: header

Escopo: billing:execute

Parâmetros de caminho

tenant_id*integer

Id do cliente

Formatoint64

Corpo da requisição

application/json

Definições TypeScript

Use o tipo request body no TypeScript.

O corpo de PATCH /billing/blocks/{tenant_id}. O bloqueio financeiro não se altera à mão: só o pagamento ou o passe o mudam.

Corpo da resposta

application/json

application/json

curl -X PATCH "https://example.com/billing/blocks/0" \  -H "Content-Type: application/json" \  -d '{    "admin": "blocked",    "reason": "string"  }'
{  "admin_blocked_at": "2019-08-24T14:15:22Z",  "billing_blocked_at": "2019-08-24T14:15:22Z",  "blocked": true,  "kind": null,  "tenant_id": 0}