Добавяне на стока/услуга с API
Функция/команда: | item_create |
Предназначение: | Използва се за добавяне на нова стока или услуга |
Параметри: |
-
item - обект (StdClass в PHP), който съдържа следните полета:
code - Артикулен номер
name - Наименование
measure_id - ID на мерна единица *
price - Продажна цена без ДДС
price_base - Доставна цена без ДДС
group_id - ID на артикулна група
supplier_id - ID на доставчик
critical_quantity - Критично количество
quantity - Начално количество. Подава се ако се ползва модул "Склад"
notes - Бележки
service - Флаг за услуга - въведете 1 ако въвеждате услуга
name_second - Име за Invoice
price_retail - Цена за Invoice
|
Postman пример: | https://fakturirane.com/api/v1/item_create?item={"code":"100001", "name":"Абонамент за услуга", "measure_id":"90"} |
Резултат: |
{
"error": 0,
"item_id": "420"
}
-error - Код на грешка
-item_id - ID на стоката/услугата. Напр. 420
|
Възможни грешки: |
101 - Не е изпратен обект като първи параметър на функцията.
103 - Не е попълнено полето name на обекта, който е подаден като параметър.
204 - С този артикулен номер вече съществува запис в базата данни.
|
Забележка: | ID номерата на мерните единици можете да видите тук. |
Примерен PHP код: |
// Следния код се вмъква в примерния скрипт.
$item = new StdClass();
$item->code = 'testcode';
$item->name = 'Име на стока';
$item->price = 10.50;
$item->quantity = 1; // Подава се само ако се ползва модул "Склад"
$item_id = $FAPI->item_create($item);
if(isset($item_id)){
echo 'Стоката е добавена успешно! ID - '.$item_id;
}
|