Потерянные заказы

Создание потерянного заказа

Инструмент “Потерянные заказы” позволяет добавлять и просматривать заявки на заказы, которые вы считаете принадлежат вам, но не отобразились в вашей статистике по продажам, рекламодатель повторно рассмотрит условия атрибуции.

Параметры

HTTP Метод	Авторизация	URL	Параметры	Примечание
POST	Authorization: Bearer {token}	https://gdeslon.ru/api/v1/lost-orders/	Список параметров	Ответ в формате JSON

Ваш токен для авторизации находится в разделе XML API.

Список параметров для запроса

Название	Тип	Обязательный	Ограничения параметров	Допустимые значения
order_id	string	Да	Максимальная длина 255 символов
order_date	date	Да	За прошедшие 3 месяца	%d.%m.%Y или %Y-%m-%d
order_total	float	Да	2 знака после плавующей точки
merchant_id	integer	Да		Список рекламодателей
attachment	file	Да	JPEG/JPG/PNG/PDF, размер не более 10мб
description	string	Нет	Максимальная длина 255 символов

Пример использования

Пример запроса с использованием утилиты curl:

curl -L -H 'Authorization: Bearer {access_token}' -X POST https://gdeslon.ru/api/v1/lost-orders/
-F 'order_id=GS123L' \
-F 'order_date=24.07.2018' \
-F 'order_total=554.34' \
-F 'merchant_id=54376' \
-F 'attachment=@/example/FS859YVnMiY.jpg' \
-F 'description=really my order'

Пример ответа API-сервера в формате JSON:

{
    "id": 5796,
    "order_id": "2342lost",
    "order_date": "2021-06-28",
    "description": "создаем товар через api",
    "attachment": "http://gdeslon.ru/uploads/ticket/path/to/file/tvorojok.jpg",
    "merchant_id": 54376,
    "merchant_name": "merchant.com",
    "order_updated_date": "2021-07-27",
    "order_total": 12020.22,
    "order_status": "in_waiting",
    "ticket_state": "in_work"
}

Описание полей ответа API-сервера:

Название	Описание
`id`	Идентификатор заявки
`order_id`	Номер заказа
`order_date`	Дата заказа
`description`	Описание заявки
`attachment`	Путь до загруженного фаила
`merchant_id`	Идентификатор рекламодателя
`merchant_name`	Название рекламодателя
`order_updated_date`	Дата обновления данных по заказу
`order_total`	Сумма заказа
`order_status`	Статус заказа
`ticket_state`	Статус заявки

Cписок потерянных заказов