Обновление позиции возврата поставщику
Путь: /cp/ts/supplierReturns/positions/update
Метод: POST
Параметры запроса
Параметры авторизации описаны в общем справочнике.
| Параметр | Тип | Описание |
|---|---|---|
id* | uint | [обязательный] ID позиции возврата поставщику |
type | uint | Тип возврата |
locId | uint | МХ, где лежит товар для возврата |
quantity | float64 | Количество |
comment | string | Комментарий к позиции |
fields | string | Поля для загрузки в расширенной структуре (через запятую) |
executionDate | datetime | Дата и время выполнения операции, формат RFC3339, изменение возможно только для позиции в конечном статусе; см. справочник статусов |
Параметр fields
| Параметр | Описание |
|---|---|
item | информация по партии товара |
location | расширяет список позиций возврата МХ |
operationInfo | информация об операции возврата |
tags | информация о тегах |
goodsReceiptPos | информация о позициях приемки |
availableQuantity | информация об остатках |
customerComplaintPos | информация о возврата покупателю |
Пример запроса
- cURL
- JavaScript
- Go
- PHP
curl --request POST 'https://demo.public.api.abcp.ru/cp/ts/supplierReturns/positions/update' \
--data-urlencode 'userlogin=YOUR_LOGIN' \
--data-urlencode 'userpsw=YOUR_PASSWORD_MD5' \
--data-urlencode 'id=5678' \
--data-urlencode 'type=2' \
--data-urlencode 'quantity=2'
const body = new URLSearchParams();
body.append('userlogin', 'YOUR_LOGIN');
body.append('userpsw', 'YOUR_PASSWORD_MD5');
body.append('id', '5678');
body.append('type', '2');
body.append('quantity', '2');
const response = await fetch('https://demo.public.api.abcp.ru/cp/ts/supplierReturns/positions/update', {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", "5678")
form.Add("type", "2")
form.Add("quantity", "2")
response, err := http.PostForm("https://demo.public.api.abcp.ru/cp/ts/supplierReturns/positions/update", 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' => '5678',
'type' => '2',
'quantity' => '2',
];
$ch = curl_init('https://demo.public.api.abcp.ru/cp/ts/supplierReturns/positions/update');
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;
?>
Метод возвращает объект позиции возврата; значения поля status описаны в справочнике статусов.