Перейти к основному содержимому

Получение списка позиций операции возврата покупателя

Операция: /cp/ts/customerComplaints/getPositions

Метод: GET

Возвращает список позиций операции возврата покупателя

Параметры запроса​

Параметры авторизации описаны в общем справочнике.

ПараметрОписание
opIdID операции
idsIDs позиций возврата через запятую.
opIdsIDs операций через запятую.
orderPickingGoodIdID позиции отгрузки по выдаче клиенту.
orderPickingNumberНомер операции отгрузки.
orderPickingGoodIdsIDs позиций отгрузки через запятую.
executionDateStartначальная дата диапазона поиска завершения позиции (RFC3339)
executionDateEndконечная дата диапазона поиска завершения позиции (RFC3339)
pickingIdsIDs операции отгрузки.
coPositionIdsIDs позиций заказа через запятую.
oldCoPositionIdsIDs позиции заказа через запятую.
agreementIdID договора с клиентом.
clientIdID клиента.
oldItemIdID старой партии.
productIdsIDs карточек товаров через запятую.
itemIdЧисловой ID партии.
shopLegalPersonIdsIDs юридических лиц магазина через запятую.
tagIdsIDs тегов через запятую.
autoАвтоопределяемый параметр для поиска по позиции.
statusesСтатусы позиций через запятую (значения статусов).
locIdID места хранения.
statusСтатус позиции (значения статуса).
typeТип возврата (значения типа).
dateStartМинимальная дата создания операции в формате по времени создания (RFC3339)
dateEndМаксимальная дата создания операции в формате по времени создания (RFC3339)
updateDateStartНачальная дата диапазона поиска по времени обновления (RFC3339).
updateDateEndКонечная дата диапазона поиска по времени обновления (RFC3339).
skipКоличество операций в ответе, которое нужно пропустить.
limitМаксимальное количество позиций, которое должно быть возвращено в ответе.
sortКак сортировать позиции: status — по статусу, createDate — по дате создания операции.
outputРасширенный формат: e — загрузить данные о партиях, местах хранения, товарах и отгрузке; o — сведения о возврате; t — теги.
fieldsДополнительные поля через запятую: item, oldItem, location, product, orderPickingInfo, operationInfo, tags, supplierReturnPos, supplierAgreement, coInfo.

Пример запроса​

curl --get 'https://demo.public.api.abcp.ru/cp/ts/customerComplaints/getPositions' \
--data-urlencode 'userlogin=YOUR_LOGIN' \
--data-urlencode 'userpsw=YOUR_PASSWORD_MD5' \
--data-urlencode 'opId=100' \
--data-urlencode 'output=et' \
--data-urlencode 'limit=30'

Метод возвращает список позиций операции возврата покупателя:

ПараметрОписание
idИдентификатор позиции
opIdИдентификатор операции
statusСтатус позиции (значения статуса)
typeТип возврата (значения типа)
orderPickingGoodIdID позиции отгрузки
oldItemIdID партии, отгруженной по операции отгрузки
itemIdID партии, созданной операцией возврат (назначается при переводе позиции в статус "в работе")
locIdID места хранения принятого товара
quantityКоличество
attrsСтруктура объекта описана в справочнике attrs
pickingDateДата и время выдачи товара обратно клиенту
executionDateДата завершения позиции
commentКомментарий
productКарточка товара
orderPickingGoodОбъект позиции отгрузки
orderPickingОбъект операции отгрузки
availableQuantityКоличество товара, доступное к возврату по позиции отгрузки
operationInfoДополнительные данные операции возврата.
tagsСписок тегов, назначенных позиции
externalIdПараметр для связи с внешними сервисами