Обновление позиции возврата покупателя
Операция: /cp/ts/customerComplaints/updatePosition
Метод: POST
Изменение возможно только в статусе "новый".
Параметры запроса
Параметры авторизации описаны в общем справочнике.
| Параметр | Описание |
|---|---|
id* | ID позиции возврата покупателя |
quantity | количество |
locId | ID места хранения (можно менять только пока позиция в статусе "Новая") |
type | тип возврата |
comment | комментарий |
retainSum | Сумма удержания за все единицы товара в позиции |
executionDate | дата и время выполнения, формат RFC3399, (можно изменять только если позиция находится в статусе "Завершен", status=4) |
Пример запроса
- cURL
- JavaScript
- Go
- PHP
curl --request POST 'https://demo.public.api.abcp.ru/cp/ts/customerComplaints/updatePosition' \
--data-urlencode 'userlogin=YOUR_LOGIN' \
--data-urlencode 'userpsw=YOUR_PASSWORD_MD5' \
--data-urlencode 'id=1234' \
--data-urlencode 'quantity=2' \
--data-urlencode 'type=3' \
--data-urlencode 'comment=Return reason'
const body = new URLSearchParams();
body.append('userlogin', 'YOUR_LOGIN');
body.append('userpsw', 'YOUR_PASSWORD_MD5');
body.append('id', '1234');
body.append('quantity', '2');
body.append('type', '3');
body.append('comment', 'Return reason');
const response = await fetch('https://demo.public.api.abcp.ru/cp/ts/customerComplaints/updatePosition', {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("id", "1234")
form.Add("quantity", "2")
form.Add("type", "3")
form.Add("comment", "Return reason")
response, err := http.PostForm("https://demo.public.api.abcp.ru/cp/ts/customerComplaints/updatePosition", 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',
] + [
'id' => '1234',
'quantity' => '2',
'type' => '3',
'comment' => 'Return reason',
];
$ch = curl_init('https://demo.public.api.abcp.ru/cp/ts/customerComplaints/updatePosition');
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;
?>
Метод возвращает объект позиции возврата:
| Поле | Описание |
|---|---|
id | ID позиции |
opId | ID операции |
status | Статус позиции (значения статуса) |
type | Тип возврата (значения типа) |
orderPickingGoodId | ID позиции отгрузки |
oldItemId | ID партии, отгруженной по указанной отгрузке |
itemId | ID партии, созданной операцией возврат(назначается при переводе позиции в статус "в работе") |
locId | ID места хранения принятого товара |
quantity | Количество |
attrs | Структура объекта описана в справочнике attrs |
pickingDate | Дата и время выдачи товара обратно клиенту |
comment | Комментарий |
product | Карточка товара |
orderPickingGood | Объект позиции отгрузки |
orderPicking | Объект операции отгрузки |
availableQuantity | Количество товара, доступное к возврату по позиции отгрузки |
externalId | Параметр для связи с внешними сервисами |