Инструменты пользователя
api_передача_заказов
Различия
Здесь показаны различия между двумя версиями данной страницы.
| Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
|
api_передача_заказов [2017/06/02 20:12] Максим [Метод CreateOrder] |
api_передача_заказов [2017/06/05 11:18] (текущий) Алексей |
||
|---|---|---|---|
| Строка 36: | Строка 36: | ||
| |phone* |Строка |Номер телефона клиента в свободной форме ||| | |phone* |Строка |Номер телефона клиента в свободной форме ||| | ||
| |external_id* |Строка |Идентификатор заказа на внешней витрине, необходим для защиты от дублирования заказов. Если вы не храните на внешней витрине заказы, то можно передавать в данный параметр текущие дату+время ||| | |external_id* |Строка |Идентификатор заказа на внешней витрине, необходим для защиты от дублирования заказов. Если вы не храните на внешней витрине заказы, то можно передавать в данный параметр текущие дату+время ||| | ||
| - | |products* |Массив |Массив списка товаров для заказа состоит из списка объектов с полями: ||| | + | |products* | Массив | Массив списка товаров для заказа состоит из списка объектов с полями ||| |
| - | |Ключ |::: | Ключ |Тип |Описание | | + | |::: |::: | Ключ |Тип |Описание | |
| - | |id* |::: | id* |Число |Артикул<font 14px/inherit;;inherit;;inherit></font> товара<font 14px/inherit;;inherit;;inherit>,</font> можно<font 14px/inherit;;inherit;;inherit></font> узнать<font 14px/inherit;;inherit;;inherit>в</font> библиотеке<font 14px/inherit;;inherit;;inherit></font> товаров | | + | |::: |::: | id* |Число |Артикул товара можно узнать в библиотеке товаров | |
| - | |quantity* |::: | quantity* |Число |Количество<font 14px/inherit;;inherit;;inherit></font> товаров<font 14px/inherit;;inherit;;inherit>в</font> <font 14px/inherit;;inherit;;inherit>заказе</font> | | + | |::: |::: | quantity* |Число |Количество товаров в заказе | |
| - | |price | |price |Число |Желаемая<font 14px/inherit;;inherit;;inherit></font> цена<font 14px/inherit;;inherit;;inherit></font> товара \\ Если<font 14px/inherit;;inherit;;inherit>не</font> передана<font 14px/inherit;;inherit;;inherit>или</font> передан<font 14px/inherit;;inherit;;inherit></font> ноль<font 14px/inherit;;inherit;;inherit>/</font> пустое<font 14px/inherit;;inherit;;inherit></font> значение<font 14px/inherit;;inherit;;inherit>, то</font> устанавливается<font 14px/inherit;;inherit;;inherit></font> текущая<font 14px/inherit;;inherit;;inherit></font> розничная<font 14px/inherit;;inherit;;inherit></font> цена<font 14px/inherit;;inherit;;inherit>по</font> платформе<font 14px/inherit;;inherit;;inherit>+ доп.</font> наценка<font 14px/inherit;;inherit;;inherit></font> витрины<font 14px/inherit;;inherit;;inherit>.</font> \\ Может<font 14px/inherit;;inherit;;inherit></font> быть<font 14px/inherit;;inherit;;inherit></font> выше<font 14px/inherit;;inherit;;inherit></font> текущей<font 14px/inherit;;inherit;;inherit></font> розничной<font 14px/inherit;;inherit;;inherit></font> цены<font 14px/inherit;;inherit;;inherit>по</font> платформе<font 14px/inherit;;inherit;;inherit>,</font> соответственно<font 14px/inherit;;inherit;;inherit></font> партнерский<font 14px/inherit;;inherit;;inherit></font> бонус<font 14px/inherit;;inherit;;inherit>с</font> продажи<font 14px/inherit;;inherit;;inherit></font> будет<font 14px/inherit;;inherit;;inherit></font> выше<font 14px/inherit;;inherit;;inherit>.</font> \\ Может<font 14px/inherit;;inherit;;inherit></font> быть<font 14px/inherit;;inherit;;inherit></font> ниже<font 14px/inherit;;inherit;;inherit></font> текущей<font 14px/inherit;;inherit;;inherit></font> розничной<font 14px/inherit;;inherit;;inherit></font> цены<font 14px/inherit;;inherit;;inherit>по</font> платформе<font 14px/inherit;;inherit;;inherit>, за</font> счет<font 14px/inherit;;inherit;;inherit></font> партнерского<font 14px/inherit;;inherit;;inherit></font> бонуса<font 14px/inherit;;inherit;;inherit>.</font> \\ <font 14px/inherit;;inherit;;inherit>Но не</font> ниже<font 14px/inherit;;inherit;;inherit></font> уровня<font 14px/inherit;;inherit;;inherit>, при</font> котором<font 14px/inherit;;inherit;;inherit></font> бонус<font 14px/inherit;;inherit;;inherit></font> равен<font 14px/inherit;;inherit;;inherit></font> нулю<font 14px/inherit;;inherit;;inherit>.</font> | | + | |::: |::: | price |Число | \\ Желаемая цена товара \\ \\ \\ Если не передана или передан ноль/пустое значение, то устанавливается текущая розничная цена по платформе + доп. наценка витрины \\ \\ Может быть выше текущей розничной цены по платформе соответственно партнерский бонус с продажи будет выше \\ \\ Может быть ниже текущей розничной цены по платформе, за счет партнерского бонуса. Но не ниже уровня, при котором бонус равен нулю. | |
| - | | | | | | | | + | |::: |::: |name |Строка |Название товара в вашем магазине | |
| - | | | | | | | | + | |address |Строка |Адрес клиента в свободной форме ||| |
| - | | | | | | | | + | |secondaryPhone |Строка |Дополнительный телефон клиента, на случай если первый телефон не доступен ||| |
| - | | | | | | | | + | |email |Строка |Email клиента ||| |
| - | | | | | | | | + | |comments |Строка |Комментарий(Виден клиенту) ||| |
| - | | | | | | | | + | |clientIpAddress | Строка| ip адрес клиента в формате ipv4\\ \\ Осторожно используйте данный параметр — если переданный адрес не будет принадлежать клиенту, заказ может быть определен как подозрительный ||| |
| - | | | | | | | | + | |utmParams | Массив| Массив UTM меток ||| |
| - | |name |Строка | |Название товара в вашем магазине | | | + | |::: |::: | Ключ | Тип | Описание | |
| + | |::: |::: | utm_cid | Строка | субаккаунт | | ||
| + | |::: |::: | utm_source | Строка | Метка utm_source | | ||
| + | |::: |::: | utm_medium | Строка | Метка utm_medium | | ||
| + | |::: |::: | utm_campaign | Строка | Метка utm_campaign | | ||
| + | |::: |::: | utm_content | Строка | Метка utm_content | | ||
| + | |::: |::: | utm_term | Строка | Метка utm_term | | ||
| - | |Ключ |Тип | |Описание | | ||
| - | |name* |Строка |::: | Имя клиента в свободной форме | | ||
| - | |phone* |Строка |::: | Номер телефона клиента в свободной форме | | ||
| - | |external_id* |Строка |::: | Идентификатор заказа на внешней витрине, необходим для защиты от дублирования заказов. Если вы не храните на внешней витрине заказы, то можно передавать в данный параметр текущие дату+время | | ||
| - | |products* |Массив |::: | Массив списка товаров для заказа состоит из списка объектов с полями: | | ||
| - | |||
| - | | | | | | | | |Ключ |Тип |Описание | | ||
| - | | | | | | | |id* |Число |Артикул товара, можно узнать в библиотеке товаров | | | ||
| - | | | | | | | |quantity* |Число |Количество товаров в заказе | | | ||
| - | | | | | | | |price |Число |Желаемая цена товара \\ \\ Если <font 14px/inherit;;inherit;;inherit>не</font> передана <font 14px/inherit;;inherit;;inherit>или</font> передан ноль<font 14px/inherit;;inherit;;inherit>/</font> пустое значение<font 14px/inherit;;inherit;;inherit>, то</font> устанавливается текущая розничная цена <font 14px/inherit;;inherit;;inherit>по</font> платформе<font 14px/inherit;;inherit;;inherit>+ доп.</font> наценка витрины<font 14px/inherit;;inherit;;inherit>.</font> \\ \\ Может быть выше текущей розничной цены <font 14px/inherit;;inherit;;inherit>по</font> платформе<font 14px/inherit;;inherit;;inherit>,</font> соответственно партнерский бонус <font 14px/inherit;;inherit;;inherit>с</font> продажи будет выше<font 14px/inherit;;inherit;;inherit>.</font> \\ \\ Может быть ниже текущей розничной цены <font 14px/inherit;;inherit;;inherit>по</font> платформе<font 14px/inherit;;inherit;;inherit>, за</font> счет партнерского бонуса<font 14px/inherit;;inherit;;inherit>.</font> \\ <font 14px/inherit;;inherit;;inherit>Но не</font> ниже уровня<font 14px/inherit;;inherit;;inherit>, при</font> котором бонус равен нулю | | | ||
| - | | | | | | | |name |Строка |Название товара в вашем магазине | | | ||
| - | | | | | | | | | | | | | ||
| - | |||
| - | | | ||
| В ответ на запрос сервер вернёт: | В ответ на запрос сервер вернёт: | ||
| - | |Код |Описание | | + | |Код |Описание ||| |
| - | |201 |Заказ успешно создан, в ответе будет JSON массив со следующими полями: | | + | |201 |Заказ успешно создан, в ответе будет JSON массив со следующими полями: ||| |
| - | + | |::: | Ключ |Тип |Описание | | |
| - | | | |Ключ |Тип |Описание | | + | |::: | status |Строка |статус создания «Ок» | |
| - | | | |status |Строка |статус создания "Ок" | | + | |::: | order_id |Число |Номер созданного заказа | |
| - | | | |order_id |Число |Номер созданного заказа | | + | |::: | order_url |Строка |ссылка на заказ на витрине платформы, по данной ссылке можно делать редирект для клиента, чтобы он мог выбрать способ оплаты или ознакомиться с заказом | |
| - | | | |order_url |Строка |ссылка на заказ на витрине платформы, по данной ссылке можно делать редирект для клиента, чтобы он мог выбрать способ оплаты или ознакомиться с заказом | | + | |400 |Ошибка во вводных данных, в ответе будет JSON массив со следующими полями: ||| |
| - | + | |::: | Ключ |Тип |Описание | | |
| - | |Код |Описание | | + | |::: | status |Строка |статус создания, «ERROR» | |
| - | |400 | \\ Ошибка во вводных данных, в ответе будет JSON массив со следующими полями: | | + | |::: | errors |Массив |массив ошибок в формате JSON | |
| - | + | ||
| - | | | |Ключ |Тип |Описание | | + | |
| - | | | |status |Строка |статус создания, "ERROR" | | + | |
| - | | | |errors |Массив |массив ошибок в формате JSON | | + | |
| \\ | \\ | ||
api_передача_заказов.1496423525.txt.gz · Последние изменения: 2017/06/02 20:12 — Максим
Инструменты страницы
