Vai al contenuto
AchaduDevelopers
API operativaVai al sito web
Cruscotto
Developers/API/commissions_sync
Commissioni

Sincronizza le commissioni

Interroga solo i connettori autorizzati e registra una ricevuta per fonte.

POST/commissions/synccommissions:write
COMPORTAMENTO

La richiesta convalida l'input, rende persistente il comando e restituisce lo stato iniziale. L'esecuzione può continuare nella coda dedicata.

EFFETTO

È possibile creare eventi di lavoro asincrono e webhook dopo la conferma nel database.

RIPETIZIONE

In caso di errore di rete, verificare lo stato della risorsa prima di riprovare. Ripristina automaticamente solo 429 e 5xx con backoff e jitter.

Richiesta

sourcesarray · bodyFonti che dovrebbero essere consultate.facoltativo
fromstring · bodyCasa ISO 8601.date-timefacoltativo
tostring · bodyFine della norma ISO 8601.date-timefacoltativo
AuthorizationBearer ach_live_...
Acceptapplication/json
Ambitocommissions:write

Esempio eseguibile

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"
}'

Risposta ed errori

Ogni risposta include request_id. Gli elenchi aggiungono l'impaginazione; le risorse mutabili restituiscono lo stato persistente dopo l'operazione.

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..."
}
200Operazione completata.
400Parametro, corpo o transizione non validi.
401Chiave mancante, non valida, scaduta o revocata.
402Il piano dell'account non rilascia questa interfaccia.
403A chave precisa do escopo commissions:write.
404La funzionalità non esiste in questo account.
409Lo stato attuale impedisce questa operazione.
413Il corpo JSON supera i 128 KB.
429La finestra di 120 richieste al minuto è stata superata.