Sincronizar comissões

Consulta somente conectores autorizados e registra um recibo por fonte.

POST/commissions/synccommissions:write

COMPORTAMENTO

A solicitação valida a entrada, persiste o comando e devolve o estado inicial. A execução pode continuar na fila dedicada.

EFEITO

Pode criar trabalho assíncrono e eventos de webhook depois da confirmação no banco.

REPETIÇÃO

Em falha de rede, confirme o estado do recurso antes de repetir. Refaça automaticamente apenas 429 e 5xx com backoff e jitter.

Solicitação

sourcesarray · bodyFontes que devem ser consultadas.opcional

fromstring · bodyInício ISO 8601.date-timeopcional

tostring · bodyFim ISO 8601.date-timeopcional

AuthorizationBearer ach_live_...

Acceptapplication/json

Escopocommissions:write

Exemplo executável

curl

curl -X POST 'https://achadu.com/api/v1/commissions/sync' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "sources": [],
  "from": "2026-09-01T15:00:00Z",
  "to": "2026-09-01T15:00:00Z"
}'

Resposta e erros

Toda resposta inclui request_id. Listas acrescentam pagination; recursos mutáveis retornam o estado persistido após a operação.

200 application/json

{
  "data": {
    "id": "com_01J...",
    "marketplace": "amazon",
    "amount": 24.73,
    "currency": "BRL",
    "status": "approved",
    "order_id": "ORDER-123",
    "occurred_at": "2026-08-31T18:20:00.000Z"
  },
  "request_id": "req_01J..."
}

200Operação concluída.

400Parâmetro, corpo ou transição inválida.

401Chave ausente, inválida, expirada ou revogada.

402O plano da conta não libera esta interface.

403A chave precisa do escopo commissions:write.

404Recurso inexistente nesta conta.

409O estado atual impede esta operação.

413O corpo JSON ultrapassa 128 KB.

429A janela de 120 solicitações por minuto foi excedida.

Sincronizar comissões

Solicitação

Exemplo executável

Resposta e erros

Operações relacionadas