Сделки

CRUD по сделкам маркетплейса. Все запросы — server-to-server, под X-Aris-Key: mk_….

Создать сделку

curl -X POST https://arisdoc.cloud/api/mkt/deals \
  -H "X-Aris-Key: mk_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "order-100245",
    "title": "Арматура А500С 12мм, 20т",
    "buyer_email": "buyer@example.com",
    "seller_email": "supplier@zavod.ru",
    "amount": 1480000,
    "currency": "RUB"
  }'

Ответ:

{ "id": "f51c…", "external_id": "order-100245", "status": "created" }

Если покупатель ещё не в системе — для него автоматически создаётся ARIS ID и личная организация. Поставщик аналогично.

Получить статус сделки

curl https://arisdoc.cloud/api/mkt/deals/{deal_id} \
  -H "X-Aris-Key: mk_xxxxxxxxxxxxxxxxxxxxxxxx"

Ответ содержит полное состояние:

{
  "id": "f51c…",
  "external_id": "order-100245",
  "title": "Арматура А500С 12мм, 20т",
  "buyer_email": "buyer@example.com",
  "amount": 1480000,
  "currency": "RUB",
  "status": "approved",
  "documents": [{ "id": "…", "kind": "contract", "name": "Договор-100245.docx" }],
  "approvals": [{ "id": "…", "status": "approved", "approver": "buyer@example.com" }],
  "payments": []
}

Возможные статусы

| Статус | Что означает | |----------------|----------------------------------------------------| | created | Сделка зарегистрирована, документов ещё нет | | docs | Прикреплены документы, не отправлено на согласование | | approval | Ожидаем решение покупателя в ARIS-кабинете | | approved | Покупатель согласовал условия | | rejected | Покупатель отклонил | | escrow_hold | Деньги захолдированы в ARIS Pay | | paid | Сделка раскрыта, деньги отправлены поставщику |