Получить позиции возвратов покупателей
Метод: GET
Путь: /ts/customerComplaints/getPositions
Право доступа: «Получение информации из TS»
Операция возвращает позиции одного или нескольких возвратов покупателей.
Параметры запроса
Параметры авторизации описаны в общем справочнике.
| Параметр | Описание |
|---|---|
opId | Обязательный. ID операции |
orderPickingGoodId | Необязательный. ID позиции отгрузки |
orderPickingGoodIds | Необязательный. IDs позиций отгрузки через запятую |
pickingIds | Необязательный. IDs операций отгрузки через запятую |
oldCoPositionIds | Необязательный. IDs позиций старого заказа через запятую |
oldItemID | Необязательный. ID партии из отгрузки |
itemId | Необязательный. ID созданной партии |
locId | Необязательный. ID места хранения |
status | Необязательный. Статус позиции: см. статусы позиций |
type | Необязательный. Тип возврата: см. типы позиций |
dateStart | Необязательный. Минимальная дата создания операции |
dateEnd | Необязательный. Максимальная дата создания операции |
skip | Необязательный. Общий параметр пагинации; количество операций, которое нужно пропустить. |
limit | Необязательный. Общий параметр пагинации; максимум — 1000, по умолчанию используется максимальное значение. |
output | Необязательный. e — добавить информацию о справочных товарах |
fields | Необязательный. Дополнительная информация, перечисленная через запятую |
Пример запроса
- cURL
- JavaScript
- Go
- PHP
curl --get 'https://demo.public.api.abcp.ru/ts/customerComplaints/getPositions' \
--data-urlencode 'userlogin=YOUR_LOGIN' \
--data-urlencode 'userpsw=YOUR_PASSWORD_MD5' \
--data-urlencode 'opId=3' \
--data-urlencode 'status=2' \
--data-urlencode 'type=1' \
--data-urlencode 'limit=30' \
--data-urlencode 'output=e'
const params = new URLSearchParams({
userlogin: 'YOUR_LOGIN',
userpsw: 'YOUR_PASSWORD_MD5',
opId: '3',
status: '2',
type: '1',
limit: '30',
output: 'e',
});
const response = await fetch(
`https://demo.public.api.abcp.ru/ts/customerComplaints/getPositions?${params}`,
);
const data = await response.json();
package main
import (
"fmt"
"io"
"log"
"net/http"
"net/url"
)
func main() {
params := url.Values{}
params.Set("userlogin", "YOUR_LOGIN")
params.Set("userpsw", "YOUR_PASSWORD_MD5")
params.Set("opId", "3")
params.Set("status", "2")
params.Set("type", "1")
params.Set("limit", "30")
params.Set("output", "e")
response, err := http.Get("https://demo.public.api.abcp.ru/ts/customerComplaints/getPositions?" + params.Encode())
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',
'opId' => '3',
'status' => '2',
'type' => '1',
'limit' => '30',
'output' => 'e',
];
$url = 'https://demo.public.api.abcp.ru/ts/customerComplaints/getPositions?' . http_build_query($params);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
$data = json_decode($response, true);
print_r($data);
?>
Ответ
Метод возвращает массив объектов со следующими полями:
| Поле | Описание |
|---|---|
id | ID позиции |
opId | ID операции возврата |
status | Статус позиции |
type | Тип возврата |
orderPickingGoodId | ID позиции товара в операции отгрузки |
oldItemId | ID отгруженной партии |
itemId | ID партии, созданной данной позицией возврата |
quantity | Количество |
attrs | Структура объекта описана в справочнике attrs |
product | Карточка товара |
pickingDate | Дата и время выдачи товара клиенту |
comment | Комментарий |
orderPickingGood | Информация о позиции операции отгрузки |
orderPicking | Информация об операции отгрузки |
availableQuantity | Доступное для возврата количество |