Сравнение версий

Старая версия 1

changes.mady.by.user Семенов Михаил

Сохранено

по сравнению с

Новая версия 2

changes.mady.by.user Семенов Михаил

Сохранено

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

  • Эндпоинт: 
    • POST /merchant/Appeals/CreateInvoiceAppeal (для счетов)
    • POST /merchant/Appeals/CreateWithdrawalAppeal (для выплат)

Запрос:

POST /merchant/Appeals/CreateInvoiceAppeal HTTP/1.1
Host: api.example.com
ECDSA: {signature}:{id}
Content-Type: application/json
Accept: application/json
{
  "invoiceId": 12345
}

Ответ:

{
  "id": "H7OOOH-Q206B-ULЗY4V"
}

Результат: Получение ID апелляции (H7OOOH-Q206B-ULЗY4V) для дальнейших действий.

...

  • Эндпоинт: POST /merchant/Appeals/UploadFile

Запрос:

POST/merchant/Appeals/UploadFile?appealId=H7OOOH-Q206B-ULЗY4V&externalId=upload_123 HTTP/1.1
Host: api.example.com
ECDSA: {signature}:{id}
Content-Type: multipart/form-data
Accept: application/json

Content-Disposition: form-data; name="file"; filename="receipt.pdf"
Content-Type: application/pdf

[Бинарное содержимое файла]

Ответ:

{
  "fileIds": ["file_456"]
}

Результат: Получение ID загруженного файла (file_456) для ссылки.

...

  • Эндпоинт: GET /merchant/Appeals/GetById

Запрос:

GET/merchant/Appeals/GetById?id=H7OOOH-Q206B-ULЗY4V HTTP/1.1
Host: api.example.com
ECDSA: {signature}:{id}
Accept: application/json

Ответ:

{
  "id": "H7OOOH-Q206B-ULЗY4V",
  "creationTime": "2025-05-21T09:00:00Z",
  "status": "Created",
  "operationType": "Invoice",
  "operationId": 12345,
  "expiresAt": "2025-05-28T09:00:00Z",
  "expireSecondsRemaining": 604800,
  "historyEntries": [
    {
      "id": "history_001",
      "creationTime": "2025-05-21T09:00:00Z",
      "status": "Created",
      "comment": "Апелляция создана",
      "author": "Мерчант"
    }
  ],
  "messages": [],
  "chatFiles": [],
  "files": [
    {
      "id": "file_456",
      "createdAt": "2025-05-21T09:05:00Z",
      "name": "receipt.pdf",
      "authorName": "Мерчант",
      "fileLink": "https://api.example.com/files/file_456"
    }
  ],
  "reason": "Оспаривание счета"
}

Результат: Получение текущего статуса (Created, Rejected, Accepted и т.д.) и просмотр истории, сообщений и прикрепленных файлов.

...

Эндпоинт для настройки коллбэков:

Мерчант или агрегатор должен зарегистрировать URL для получения коллбэков через соответствующий API-метод (например, POST /merchant/Callbacks/Register — уточните у администратора API).

Структура коллбэка:

{  "entityType": "Appeal",
  "appealId": "H7OOOH-Q206B-ULЗY4V",
  "invoiceId": "2222",
  "invoiceExternalId": "1234",
  "message": "Сообщение от арбитра",
  "files": [
    {
      "id": "H6Q7FX-MQ2CJ-OIYPHP",
      "link": "https://rt-appeals.s3.yandexcloud.net/H6Q7FX...",
      "name": "763167df-5646-494e-b315-e554596218da.pdf"
    }

Особенности структуры:

  • Поле entityType всегда имеет значение "Appeal".
  • Поле appealId указывает ID апелляции.
  • Для апелляций по счетам используются поля invoiceId и invoiceExternalId.
  • Для апелляций по выплатам вместо invoiceId и invoiceExternalId используются поля withdrawalId и withdrawalExternalId.
  • Поле message содержит текст сообщения от арбитра.
  • Поле files содержит массив прикрепленных файлов (если есть), с их ID, ссылкой для скачивания и именем файла.

...