Reprocessing

Cria um job de reprocessamento (sempre uma simulação com o relatório de impacto)

Cria um job de reprocessamento de comissões para um programa numa janela de datas, aplicando uma nova regra. Sempre nasce como simulação (dry_run): nenhum valor é alterado, apenas é gerado o relatório de impacto (comissões recalculadas, ajustes planejados, delta total e maiores variações por afiliado). Requer um usuário com função owner ou admin. A aplicação definitiva ocorre só no POST /reprocess/:jobId/execute.

POST

reprocess

curl --request POST \
  --url https://api.userepass.com/reprocess \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "programId": "prog_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "from": "2026-05-01T00:00:00.000Z",
  "to": "2026-05-31T23:59:59.000Z",
  "newRuleId": "cmrl_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "affiliateIds": [
    "aff_01J9Z3K8N2QF4T7B9XP0WMD5RC"
  ],
  "dryRun": true
}
'

import requests

url = "https://api.userepass.com/reprocess"

payload = {
    "programId": "prog_01J9Z3K8N2QF4T7B9XP0WMD5RC",
    "from": "2026-05-01T00:00:00.000Z",
    "to": "2026-05-31T23:59:59.000Z",
    "newRuleId": "cmrl_01J9Z3K8N2QF4T7B9XP0WMD5RC",
    "affiliateIds": ["aff_01J9Z3K8N2QF4T7B9XP0WMD5RC"],
    "dryRun": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    programId: 'prog_01J9Z3K8N2QF4T7B9XP0WMD5RC',
    from: '2026-05-01T00:00:00.000Z',
    to: '2026-05-31T23:59:59.000Z',
    newRuleId: 'cmrl_01J9Z3K8N2QF4T7B9XP0WMD5RC',
    affiliateIds: ['aff_01J9Z3K8N2QF4T7B9XP0WMD5RC'],
    dryRun: true
  })
};

fetch('https://api.userepass.com/reprocess', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.userepass.com/reprocess",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'programId' => 'prog_01J9Z3K8N2QF4T7B9XP0WMD5RC',
    'from' => '2026-05-01T00:00:00.000Z',
    'to' => '2026-05-31T23:59:59.000Z',
    'newRuleId' => 'cmrl_01J9Z3K8N2QF4T7B9XP0WMD5RC',
    'affiliateIds' => [
        'aff_01J9Z3K8N2QF4T7B9XP0WMD5RC'
    ],
    'dryRun' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.userepass.com/reprocess"

	payload := strings.NewReader("{\n  \"programId\": \"prog_01J9Z3K8N2QF4T7B9XP0WMD5RC\",\n  \"from\": \"2026-05-01T00:00:00.000Z\",\n  \"to\": \"2026-05-31T23:59:59.000Z\",\n  \"newRuleId\": \"cmrl_01J9Z3K8N2QF4T7B9XP0WMD5RC\",\n  \"affiliateIds\": [\n    \"aff_01J9Z3K8N2QF4T7B9XP0WMD5RC\"\n  ],\n  \"dryRun\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.userepass.com/reprocess")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"programId\": \"prog_01J9Z3K8N2QF4T7B9XP0WMD5RC\",\n  \"from\": \"2026-05-01T00:00:00.000Z\",\n  \"to\": \"2026-05-31T23:59:59.000Z\",\n  \"newRuleId\": \"cmrl_01J9Z3K8N2QF4T7B9XP0WMD5RC\",\n  \"affiliateIds\": [\n    \"aff_01J9Z3K8N2QF4T7B9XP0WMD5RC\"\n  ],\n  \"dryRun\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.userepass.com/reprocess")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"programId\": \"prog_01J9Z3K8N2QF4T7B9XP0WMD5RC\",\n  \"from\": \"2026-05-01T00:00:00.000Z\",\n  \"to\": \"2026-05-31T23:59:59.000Z\",\n  \"newRuleId\": \"cmrl_01J9Z3K8N2QF4T7B9XP0WMD5RC\",\n  \"affiliateIds\": [\n    \"aff_01J9Z3K8N2QF4T7B9XP0WMD5RC\"\n  ],\n  \"dryRun\": true\n}"

response = http.request(request)
puts response.read_body

{
  "id": "repr_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "organizationId": "org_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "programId": "prog_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "status": "dry_run",
  "newRuleId": "cmrl_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "from": "2026-05-01T00:00:00.000Z",
  "to": "2026-05-31T23:59:59.000Z",
  "affiliateIds": [
    "aff_01J9Z3K8N2QF4T7B9XP0WMD5RC"
  ],
  "summary": {
    "conversionsAffected": 42,
    "commissionsRecalculated": 38,
    "adjustmentsPlanned": 4,
    "blockedCount": 0,
    "unchangedCount": 12,
    "affiliatesImpacted": 7,
    "deltaTotalCents": 152900,
    "topVariations": [
      {
        "affiliateId": "aff_01J9Z3K8N2QF4T7B9XP0WMD5RC",
        "deltaCents": 1990
      }
    ]
  },
  "confirmationRequired": true,
  "createdBy": "user_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "executedAt": "2026-06-13T12:00:00.000Z",
  "canceledAt": "2026-06-13T12:00:00.000Z",
  "createdAt": "2026-06-13T12:00:00.000Z",
  "updatedAt": "2026-06-13T12:00:00.000Z",
  "confirmationToken": "rcft_01J9Z3K8N2QF4T7B9XP0WMD5RC"
}

Authorizations

Authorization

string

header

required

Chave de API (prefixo rstr_) enviada como Authorization: Bearer rstr_....

Body

application/json

programId

string

required

Programa cujas comissões serão reprocessadas.

Pattern: ^prog_[0-9A-HJKMNP-TV-Z]{26}$

Example:

"prog_01J9Z3K8N2QF4T7B9XP0WMD5RC"

from

any

required

Início da janela de reprocessamento (ISO-8601). Apenas conversões/comissões a partir desta data são consideradas.

Example:

"2026-05-01T00:00:00.000Z"

any

required

Fim da janela de reprocessamento (ISO-8601). Apenas conversões/comissões até esta data são consideradas.

Example:

"2026-05-31T23:59:59.000Z"

newRuleId

string

required

Regra de comissão a ser aplicada no recálculo (substitui a regra usada originalmente).

Pattern: ^cmrl_[0-9A-HJKMNP-TV-Z]{26}$

Example:

"cmrl_01J9Z3K8N2QF4T7B9XP0WMD5RC"

affiliateIds

string[]

Restringe o reprocessamento a estes afiliados. Omitido: reprocessa todos os afiliados do programa na janela.

Minimum array length: 1

Pattern: ^aff_[0-9A-HJKMNP-TV-Z]{26}$

dryRun

enum<boolean>

default:true

Sempre true: a criação é obrigatoriamente uma simulação. A aplicação definitiva ocorre apenas no passo de execução do job (POST /reprocess/:jobId/execute).

Available options:

true

Response

201 - application/json

Default Response

string

required

Identificador único do job de reprocessamento (prefixo repr_ + ULID).

Example:

"repr_01J9Z3K8N2QF4T7B9XP0WMD5RC"

organizationId

string

required

Organização dona do job.

Example:

"org_01J9Z3K8N2QF4T7B9XP0WMD5RC"

programId

string

required

Programa cujas comissões foram reprocessadas.

Example:

"prog_01J9Z3K8N2QF4T7B9XP0WMD5RC"

status

enum<string>

required

Status atual do job.

Available options:

dry_run,

executed,

canceled

Example:

"dry_run"

newRuleId

string

required

Regra de comissão aplicada no recálculo.

Example:

"cmrl_01J9Z3K8N2QF4T7B9XP0WMD5RC"

from

string<date-time>

required

Início da janela de reprocessamento (ISO-8601).

Example:

"2026-05-01T00:00:00.000Z"

string<date-time>

required

Fim da janela de reprocessamento (ISO-8601).

Example:

"2026-05-31T23:59:59.000Z"

affiliateIds

string[] | null

required

Afiliados aos quais o reprocessamento foi restrito. null quando abrange todos os afiliados do programa.

summary

object

required

Relatório de impacto do reprocessamento.

Show child attributes

confirmationRequired

boolean

required

Indica se a execução exigirá confirmationToken por ultrapassar o limite de impacto configurado nas suas preferências de reprocessamento.

Example:

true

createdBy

string

required

Usuário que criou o job.

Example:

"user_01J9Z3K8N2QF4T7B9XP0WMD5RC"

executedAt

string<date-time> | null

required

Momento em que o job foi executado (ISO-8601). null enquanto não executado.

Example:

"2026-06-13T12:00:00.000Z"

canceledAt

string<date-time> | null

required

Momento em que o job foi cancelado (ISO-8601). null quando não cancelado.

Example:

"2026-06-13T12:00:00.000Z"

createdAt

string<date-time>

required

Data de criação do job (ISO-8601).

Example:

"2026-06-13T12:00:00.000Z"

updatedAt

string<date-time>

required

Data da última atualização do job (ISO-8601).

Example:

"2026-06-13T12:00:00.000Z"

confirmationToken

string

Token da dupla confirmação. Presente apenas enquanto o job está em dry_run; usado na execução do job quando o impacto excede o limite configurado nas suas preferências de reprocessamento.

Example:

"rcft_01J9Z3K8N2QF4T7B9XP0WMD5RC"

Cria um job de reprocessamento (sempre uma simulação com o relatório de impacto)

curl --request POST \
  --url https://api.userepass.com/reprocess \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "programId": "prog_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "from": "2026-05-01T00:00:00.000Z",
  "to": "2026-05-31T23:59:59.000Z",
  "newRuleId": "cmrl_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "affiliateIds": [
    "aff_01J9Z3K8N2QF4T7B9XP0WMD5RC"
  ],
  "dryRun": true
}
'

import requests

url = "https://api.userepass.com/reprocess"

payload = {
    "programId": "prog_01J9Z3K8N2QF4T7B9XP0WMD5RC",
    "from": "2026-05-01T00:00:00.000Z",
    "to": "2026-05-31T23:59:59.000Z",
    "newRuleId": "cmrl_01J9Z3K8N2QF4T7B9XP0WMD5RC",
    "affiliateIds": ["aff_01J9Z3K8N2QF4T7B9XP0WMD5RC"],
    "dryRun": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    programId: 'prog_01J9Z3K8N2QF4T7B9XP0WMD5RC',
    from: '2026-05-01T00:00:00.000Z',
    to: '2026-05-31T23:59:59.000Z',
    newRuleId: 'cmrl_01J9Z3K8N2QF4T7B9XP0WMD5RC',
    affiliateIds: ['aff_01J9Z3K8N2QF4T7B9XP0WMD5RC'],
    dryRun: true
  })
};

fetch('https://api.userepass.com/reprocess', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.userepass.com/reprocess",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'programId' => 'prog_01J9Z3K8N2QF4T7B9XP0WMD5RC',
    'from' => '2026-05-01T00:00:00.000Z',
    'to' => '2026-05-31T23:59:59.000Z',
    'newRuleId' => 'cmrl_01J9Z3K8N2QF4T7B9XP0WMD5RC',
    'affiliateIds' => [
        'aff_01J9Z3K8N2QF4T7B9XP0WMD5RC'
    ],
    'dryRun' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.userepass.com/reprocess"

	payload := strings.NewReader("{\n  \"programId\": \"prog_01J9Z3K8N2QF4T7B9XP0WMD5RC\",\n  \"from\": \"2026-05-01T00:00:00.000Z\",\n  \"to\": \"2026-05-31T23:59:59.000Z\",\n  \"newRuleId\": \"cmrl_01J9Z3K8N2QF4T7B9XP0WMD5RC\",\n  \"affiliateIds\": [\n    \"aff_01J9Z3K8N2QF4T7B9XP0WMD5RC\"\n  ],\n  \"dryRun\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.userepass.com/reprocess")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"programId\": \"prog_01J9Z3K8N2QF4T7B9XP0WMD5RC\",\n  \"from\": \"2026-05-01T00:00:00.000Z\",\n  \"to\": \"2026-05-31T23:59:59.000Z\",\n  \"newRuleId\": \"cmrl_01J9Z3K8N2QF4T7B9XP0WMD5RC\",\n  \"affiliateIds\": [\n    \"aff_01J9Z3K8N2QF4T7B9XP0WMD5RC\"\n  ],\n  \"dryRun\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.userepass.com/reprocess")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"programId\": \"prog_01J9Z3K8N2QF4T7B9XP0WMD5RC\",\n  \"from\": \"2026-05-01T00:00:00.000Z\",\n  \"to\": \"2026-05-31T23:59:59.000Z\",\n  \"newRuleId\": \"cmrl_01J9Z3K8N2QF4T7B9XP0WMD5RC\",\n  \"affiliateIds\": [\n    \"aff_01J9Z3K8N2QF4T7B9XP0WMD5RC\"\n  ],\n  \"dryRun\": true\n}"

response = http.request(request)
puts response.read_body

{
  "id": "repr_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "organizationId": "org_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "programId": "prog_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "status": "dry_run",
  "newRuleId": "cmrl_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "from": "2026-05-01T00:00:00.000Z",
  "to": "2026-05-31T23:59:59.000Z",
  "affiliateIds": [
    "aff_01J9Z3K8N2QF4T7B9XP0WMD5RC"
  ],
  "summary": {
    "conversionsAffected": 42,
    "commissionsRecalculated": 38,
    "adjustmentsPlanned": 4,
    "blockedCount": 0,
    "unchangedCount": 12,
    "affiliatesImpacted": 7,
    "deltaTotalCents": 152900,
    "topVariations": [
      {
        "affiliateId": "aff_01J9Z3K8N2QF4T7B9XP0WMD5RC",
        "deltaCents": 1990
      }
    ]
  },
  "confirmationRequired": true,
  "createdBy": "user_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "executedAt": "2026-06-13T12:00:00.000Z",
  "canceledAt": "2026-06-13T12:00:00.000Z",
  "createdAt": "2026-06-13T12:00:00.000Z",
  "updatedAt": "2026-06-13T12:00:00.000Z",
  "confirmationToken": "rcft_01J9Z3K8N2QF4T7B9XP0WMD5RC"
}