customFields — это набор дополнительных параметров, которые можно передавать в методах purchase/confirm, purchase/create, purchase/update.
Для передачи могут использоваться любые параметры, имеющиеся в объекте Покупка. После передачи в методах значения будут записаны в соответствующие поля в системе BPMSoft.
Для работы customFields со справочниками необходимо добавить в объект справочника колоку «Code»(без префикса и прочего). Именно по этому полю будет происходить поиск значения при отправке запроса через API.
Пример справочника и объекта на стороне BPMSoft:
Пример запроса:
{
"id": "№026",
"number": "№026",
"date": "2020-09-25T09:27:12.926Z",
"shopCode": "063",
"cashdeskCode": "063",
"client": {
"mobilePhone": "89000654077",
},
"products": [
{
"index": 1,
"productCode": "001",
"price": 100,
"quantity": 1,
"amount": 100,
"customFields": {
"ProductLevel": "Gold",
}
}
],
"payments": [
{
"type": "Cash",
"amount": 400
}
],
"paymentForm": "FullPayment",
"isTesting": false,
}
Также вы можете очистить значение полей customFields при редактировании покупки в Purchase/Update, передав null в значение поля