Создание заказа по позициям корзины
Метод: POST
Путь: /cp/ts/orders/createByCart
Параметры запроса
Параметры авторизации описаны в общем справочнике.
| Параметр | Описание |
|---|---|
number | номер заказа клиента, если не указан, то сформируется согласно шаблону номеров заказов, если указан, то проверяется на уникальность |
clientId* | идентификатор клиента |
agreementId* | идентификатор соглашения (договора) |
createTime | rfc3339 - дата и время создания заказа, если не указан, заполняется автоматически, не может быть из будущего |
managerId | идентификатор сотрудника, ответственного за заказ |
positions* | список ID позиций корзины |
delivery[methodId] | ID способа доставки |
delivery[meetData][officeId]* | ID офиса самовывоза. Обязателен, если methodId имеет type=pickup и блок offices в своем объекте. |
delivery[meetData][address]* | Если methodId имеет type=pickup и блок addresses в своем объекте, то в параметре передается адрес самовывоза из указанного methodId. При такой ситуации параметр обязателен для заполнения. |
delivery[meetData][shipmentAddressId]* | ID адреса доставки покупателя. Обязателен, если methodId имеет type!=pickup и не передан delivery[meetData][address] |
delivery[meetData][person]* | контактное лицо. Параметр обязателен, если methodId имеет type!=pickup |
delivery[meetData][contact]* | контакт (телефон) получателя. Параметр обязателен, если methodId имеет type!=pickup |
delivery[meetData][comment] | комментарий |
delivery[meetData][employeePerson] | string - контактный сотрудник |
delivery[meetData][employeeContact] | string - контакт сотрудника |
delivery[meetData][resellerComment] | string - комментарий от магазина |
delivery[timeInterval][startTime] | rfc3339 - время начала интервала доставки |
delivery[timeInterval][endTime] | rfc3339 - время конца интервала доставки |
locale | string - локаль для сохранения описаний товаров |
externalId | Параметр для связи с внешними сервисами |
fields | дополнительная информация, поля |
Пример запроса
- cURL
- JavaScript
- Go
- PHP
curl --request POST 'https://demo.public.api.abcp.ru/cp/ts/orders/createByCart' \
--data-urlencode 'userlogin=YOUR_LOGIN' \
--data-urlencode 'userpsw=YOUR_PASSWORD_MD5' \
--data-urlencode 'clientId=123' \
--data-urlencode 'agreementId=456' \
--data-urlencode 'positions[0]=1001' \
--data-urlencode 'positions[1]=1002' \
--data-urlencode 'delivery[methodId]=1' \
--data-urlencode 'delivery[meetData][officeId]=10'
const body = new URLSearchParams();
body.append('userlogin', 'YOUR_LOGIN');
body.append('userpsw', 'YOUR_PASSWORD_MD5');
body.append('clientId', '123');
body.append('agreementId', '456');
body.append('positions[0]', '1001');
body.append('positions[1]', '1002');
body.append('delivery[methodId]', '1');
body.append('delivery[meetData][officeId]', '10');
const response = await fetch('https://demo.public.api.abcp.ru/cp/ts/orders/createByCart', {method: 'POST', body});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"io"
"log"
"net/http"
"net/url"
)
func main() {
form := url.Values{}
form.Add("userlogin", "YOUR_LOGIN")
form.Add("userpsw", "YOUR_PASSWORD_MD5")
form.Add("clientId", "123")
form.Add("agreementId", "456")
form.Add("positions[0]", "1001")
form.Add("positions[1]", "1002")
form.Add("delivery[methodId]", "1")
form.Add("delivery[meetData][officeId]", "10")
response, err := http.PostForm("https://demo.public.api.abcp.ru/cp/ts/orders/createByCart", form)
if err != nil {
log.Fatal(err)
}
defer response.Body.Close()
body, err := io.ReadAll(response.Body)
if err != nil {
log.Fatal(err)
}
fmt.Println(string(body))
}
<?php
$params = [
'userlogin' => 'YOUR_LOGIN',
'userpsw' => 'YOUR_PASSWORD_MD5',
] + [
'clientId' => '123',
'agreementId' => '456',
'positions[0]' => '1001',
'positions[1]' => '1002',
'delivery[methodId]' => '1',
'delivery[meetData][officeId]' => '10',
];
$ch = curl_init('https://demo.public.api.abcp.ru/cp/ts/orders/createByCart');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
echo $response;
?>
Ответ
Метод возвращает массив заказов