Import commissions in CSV

Normalizes a CSV, deduplicates transactions, and produces an auditable receipt.

POST/commissions/importscommissions:write

BEHAVIOR

The request validates the input, persists the command, and returns the initial state. Execution can continue in the dedicated queue.

EFFECT

You can create asynchronous work and webhook events after confirmation in the database.

REPETITION

On network failure, confirm the resource status before retrying. Automatically redo only 429 and 5xx with backoff and jitter.

Request

marketplacestring · bodyMarketplace or default network.optional

filenamestring · bodyOriginal file name.maxLength 240optional

contentstring · bodyUTF-8 content of the CSV.minLength 2 · maxLength 120000mandatory

AuthorizationBearer ach_live_...

Acceptapplication/json

Scopecommissions:write

Executable example

curl

curl -X POST 'https://achadu.com/api/v1/commissions/imports' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "content": "I found a deal for you.",
  "marketplace": "string",
  "filename": "string"
}'

Response and errors

Every response includes request_id. Lists add pagination; mutable resources return the persisted state after the operation.

201 application/json

{
  "data": {
    "id": "imp_01J...",
    "status": "processing",
    "source": "amazon",
    "rows_read": 0,
    "new_items": 0,
    "duplicates": 0,
    "errors": 0
  },
  "created": true,
  "request_id": "req_01J..."
}

201Resource created and persisted.

400Invalid parameter, body or transition.

401Missing, invalid, expired or revoked key.

402The account plan does not release this interface.

403A chave precisa do escopo commissions:write.

404Feature does not exist in this account.

409The current state prevents this operation.

413The JSON body exceeds 128 KB.

429The 120 requests per minute window has been exceeded.

Import commissions in CSV

Request

Executable example

Response and errors

Related operations