Создание операции отгрузки по клиентскому заказу
Операция: /cp/ts/orderPickings/createByOldPos
Метод: POST
Параметры запроса
Параметры авторизации описаны в общем справочнике.
| Параметр | Описание |
|---|---|
opId | ID операции для добавления позиций. Если не указан - будет создана новая операция отгрузки. |
statusId* | при указании флага doneRightAway статус позиции заказа, в который будут переведены указанные позиции в случае успешного добавления в операцию отгрузки. При указании флага doneRightAway статус должен иметь признак списания. |
agreementId | ID договора. Если не передать - будет выбран договор по-умолчанию или любой активный. |
locId* | ID места сборки или отгрузки клиентского заказа. Значение "не установлено" - 0. |
ppIds* | список IDов позиций старых заказов для добавления в отгрузку |
createDate | дата и время создания отгрузки в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС (RFC3339), если не указано - используется текущая дата и время |
doneRightAway | 1 - сразу завершить операцию после добавления позиций. |
output | расширенный формат вывода. 'e' - загрузка дополнительной информации (договора, реквизиты, клиент), 't' - загрузка информации о тегах, 's' - загрузка суммарной информации о позициях |
markCodes | Массив кодов маркировки для позиций (формат: [positionId => [code1, code2, ...]]) |
externalId | Параметр для связи с внешними сервисами |
Пример запроса
- cURL
- JavaScript
- Go
- PHP
curl --request POST 'https://demo.public.api.abcp.ru/cp/ts/orderPickings/createByOldPos' \
--data-urlencode 'userlogin=YOUR_LOGIN' \
--data-urlencode 'userpsw=YOUR_PASSWORD_MD5' \
--data-urlencode 'locId=33' \
--data-urlencode 'ppIds[]=123123123' \
--data-urlencode 'ppIds[]=234234234'
const body = new URLSearchParams();
body.append('userlogin', 'YOUR_LOGIN');
body.append('userpsw', 'YOUR_PASSWORD_MD5');
body.append('locId', '33');
body.append('ppIds[]', '123123123');
body.append('ppIds[]', '234234234');
const response = await fetch('https://demo.public.api.abcp.ru/cp/ts/orderPickings/createByOldPos', {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("locId", "33")
form.Add("ppIds[]", "123123123")
form.Add("ppIds[]", "234234234")
response, err := http.PostForm("https://demo.public.api.abcp.ru/cp/ts/orderPickings/createByOldPos", 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',
] + [
'locId' => '33',
'ppIds' => ['123123123', '234234234'],
];
$ch = curl_init('https://demo.public.api.abcp.ru/cp/ts/orderPickings/createByOldPos');
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;
?>
Метод возвращает объект вида:
Узел positions содержит набор объектов вида:
| Поле | Описание |
|---|---|
id | ID позиции отгрузки |
opId | ID операции |
coPositionId | ID позиции нового заказа(не используется) |
oldCoPositionId | ID позиции старого заказа |
quantity | Количество |
itemId | ID партии |
clToResRate | Курс валюты клиента к валюте магазина |
clSellPrice | Цена продажи в валюте клиента |
sellPrice | Цена продажи в валюте магазина |
product | Товар |
item | Партия |
locations | Места хранения |
storageZones | Складские зоны |
orderPickingGoodLinks | Связи мест хранения позиций |
availableQuantityCC | Количество доступное к возврату. |
tags | Теги |
externalId | Параметр для связи с внешними сервисами |