> ## Documentation Index
> Fetch the complete documentation index at: https://userepass.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Reprocess (CLI)

> Jobs de reprocessamento de comissões: dry-run, inspeção do impacto e execução.

O grupo `reprocess` gerencia os jobs de [reprocessamento](/docs/conceitos/reprocessamento) de comissões. O fluxo seguro é sempre o mesmo: **`create` (dry-run) → `items` (inspecionar o impacto) → `execute` (aplicar em definitivo)**.

## Criação (sempre dry-run)

`reprocess create` **nunca aplica nada sozinho**. Mesmo sem nenhuma flag de confirmação, ele só calcula o impacto. A aplicação definitiva é sempre o comando separado `execute`.

```bash theme={null}
repass reprocess create --data '{
  "programId": "prog_xxx",
  "newRuleId": "rule_xxx",
  "from": "2026-06-01T00:00:00Z",
  "to": "2026-07-01T00:00:00Z"
}'
```

<Warning>
  `reprocess create` é `sensitive` (pede confirmação), mas é seguro de rodar: é **sempre dry-run**, calcula o impacto sem alterar nenhuma comissão. Em terminal interativo pede confirmação; fora de TTY exige `--yes` (veja [Convenções](/docs/cli/convencoes#modelo-de-risco)).
</Warning>

## Consulta e impacto

```bash theme={null}
# Listar os jobs (paginado, com filtros)
repass reprocess list --program-id prog_xxx --status dry_run --json

# Buscar um job pelo id
repass reprocess get repr_xxx --json

# Impacto item a item (uma linha por comissão afetada, paginado)
repass reprocess items repr_xxx --json
```

`reprocess list` e `reprocess items` são paginados. Veja [Paginação](/docs/cli/paginacao) para `--all` e cursores.

```json repass reprocess items repr_xxx --json theme={null}
[
  { "id": "rpri_xxx", "commissionId": "comm_xxx", "affiliateId": "aff_xxx", "kind": "increase", "deltaCents": 1500 },
  …
]
```

Revise sempre `reprocess items` antes de executar: é a visão exata do que `execute` vai aplicar.

## Execução e cancelamento

```bash theme={null}
# Aplica em definitivo o impacto calculado no dry-run
repass reprocess execute repr_xxx --yes

# Cancela o job antes da execução (não desfaz nada já aplicado)
repass reprocess cancel repr_xxx --yes
```

<Warning>
  `reprocess execute` é `destructive`. Aplica em definitivo as alterações de comissão calculadas no dry-run e **não é reversível**. Rode `reprocess get repr_xxx` e `reprocess items repr_xxx` antes para conferir o impacto exato. O corpo `--data`/`--file` (`{ confirmationToken }`) é exigido quando a política de reprocessamento pede confirmação extra para jobs acima do limite configurado. Em terminal interativo pede confirmação; fora de TTY exige `--yes` (veja [Convenções](/docs/cli/convencoes#modelo-de-risco)).
</Warning>

<Warning>
  `reprocess cancel` também é `destructive`. Descarta o job antes da execução. Não desfaz nada já aplicado (só evita a execução), mas o job cancelado não volta a ficar executável. Em terminal interativo pede confirmação; fora de TTY exige `--yes`.
</Warning>

<Note>
  Para o schema completo de cada corpo (filtros do job, formato dos itens de impacto, origem do `confirmationToken`), consulte a página SDK equivalente ([Reprocess](/docs/sdk/recursos/reprocess)) e a [Referência da API](/docs/convencoes/ids-e-recursos). As regras de negócio estão em [Reprocessamento](/docs/conceitos/reprocessamento).
</Note>