DOM360
Financeiro

Rodar o passe de bloqueio agora

POST
/billing/enforcement-runs

Roda agora o que o passe diário faz — vence liberações, manda os avisos do dia, confere no Asaas, bloqueia e desbloqueia —, para um cliente ou para a plataforma inteira (só a equipe DOM360). Não conta como o passe do dia: o de amanhã roda igual. Cliente fora do alcance é 404 antes de aceitar. Aceito, responde 202 com a operação em Location; o resultado tem a forma de EnforcementReportDto. Com outro passe em execução, a operação termina failed com error.code = enforcement_running.

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 cabeçalho

Idempotency-Key?|

Chave opcional de 1 a 255 caracteres ASCII visíveis; quando enviada, vale o mesmo contrato da §8.

Corpo da requisição

application/json

Definições TypeScript

Use o tipo request body no TypeScript.

O corpo de POST /billing/enforcement-runs.

Corpo da resposta

application/json

application/json

curl -X POST "https://example.com/billing/enforcement-runs" \  -H "Idempotency-Key: b3f0c1e2-4a5b-4c6d-8e9f-0a1b2c3d4e5f" \  -H "Content-Type: application/json" \  -d '{}'
{  "completed_after_interruption": true,  "created_at": "2019-08-24T14:15:22Z",  "dealer_id": 0,  "error": null,  "finished_at": "2019-08-24T14:15:22Z",  "kind": "billing_closing",  "operation_id": "cb4ede3c-a5d1-45e3-a9d2-fe83accbce52",  "progress": {    "done": 0,    "total": 0  },  "required_capability": "string",  "result": {},  "result_location": "string",  "started_at": "2019-08-24T14:15:22Z",  "status": "queued",  "tenant_id": 0}