Saltar al contenido
AchaduDevelopers
Developers/API/commission_import
Comisiones

Comisiones de importación en CSV

Normaliza un CSV, elimina transacciones duplicadas y genera un recibo auditable.

POST/commissions/importscommissions:write
COMPORTAMIENTO

La solicitud valida la entrada, persiste el comando y devuelve el estado inicial. La ejecución puede continuar en la cola dedicada.

EFECTO

Puede crear trabajos asincrónicos y eventos de webhook después de la confirmación en la base de datos.

REPETICIÓN

En caso de falla de la red, confirme el estado del recurso antes de volver a intentarlo. Rehaga automáticamente solo 429 y 5xx con retroceso y fluctuación.

Solicitar

marketplacestring · bodyMarketplace o red predeterminada.opcional
filenamestring · bodyNombre del archivo original.maxLength 240opcional
contentstring · bodyUTF-8 contenido del CSV.minLength 2 · maxLength 120000obligatorio
AuthorizationBearer ach_live_...
Acceptapplication/json
Alcancecommissions:write

Ejemplo ejecutable

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

Respuesta y errores

Cada respuesta incluye request_id. Las listas añaden paginación; Los recursos mutables devuelven el estado persistente después de la operación.

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..."
}
201Recurso creado y persistido.
400Parámetro, cuerpo o transición no válidos.
401Clave faltante, inválida, caducada o revocada.
402El plan de cuenta no libera esta interfaz.
403A chave precisa do escopo commissions:write.
404La característica no existe en esta cuenta.
409El estado actual impide esta operación.
413El cuerpo JSON supera los 128 KB.
429Se ha superado la ventana de 120 solicitudes por minuto.