API inventory: различия между версиями

Материал из WiKi - UserSide
Нет описания правки
Строка 70: Строка 70:
   id - ID ТМЦ
   id - ID ТМЦ
   value - MAC-адрес
   value - MAC-адрес
==== change_serial_number ====
''Добавлено в: 3.12.52''
Описание: Изменение серийного номера у ТМЦ
Обязательные параметры:
  id - ID ТМЦ
  value - серийный номер


==== change_comment ====
==== change_comment ====
Строка 85: Строка 78:
   value - заметка
   value - заметка


==== transfer_inventory ====
==== change_serial_number ====
''Доработано в: 3.12.89 (добавлен параметр operator_id)''
''Добавлено в: 3.12.52''
  Описание: Перемещение ТМЦ
  Описание: Изменение серийного номера у ТМЦ
  Обязательные параметры:
  Обязательные параметры:
   inventory_id - ID ТМЦ
   id - ID ТМЦ
   dst_account - Счет-получатель
   value - серийный номер
Необязательные параметры
  operator_id - ID оператора - автора операции
Дополнительно возвращаемые данные:
  array(
  [Id] => ID операции перемещения
  )


==== get_inventory ====
==== get_inventory ====
Строка 107: Строка 94:
   )
   )


==== get_inventory_id ====
==== get_inventory_amount ====
Описание: Получение ID ТМЦ по входящим данным
''Доработано в: 3.12.85 (в параметр location добавлено возможное значение task)''
Обязательные параметры:
 
  data_typer - тип данных, которые проверяем ''(возможные значения: inventory_number, serial_number)''
''Доработано в: 3.12.71 (в параметре object_id можно подавать значения через запятую)''
  data_value - значение
 
  Дополнительно возвращаемые данные:
''Доработано в: 3.12beta27 (добавлен параметр location)''
   array(
 
  [id] => id ТМЦ в случае успеха
  Описание: Получение списка ТМЦ
   )
Необязательные параметры:
   location - категория учёта [storage|staff|customer|node|task]
   object_id - ID объекта учёта ''(можно через запятую)''


==== get_inventory_catalog ====
==== get_inventory_catalog ====
Строка 136: Строка 125:
   )
   )


==== get_inventory_amount ====
==== get_inventory_id ====
''Доработано в: 3.12.85 параметр location добавлено возможное значение task)''
Описание: Получение ID ТМЦ по входящим данным
Обязательные параметры:
  data_typer - тип данных, которые проверяем ''(возможные значения: inventory_number, serial_number)''
  data_value - значение
Дополнительно возвращаемые данные:
  array(
  [id] => id ТМЦ в случае успеха
  )


''Доработано в: 3.12.71 (в параметре object_id можно подавать значения через запятую)''
==== get_inventory_section_catalog ====
 
  Описание: Получение наименований каталога ТМЦ
''Доработано в: 3.12beta27 (добавлен параметр location)''
  Дополнительно возвращаемые данные:
 
   array(
  Описание: Получение списка ТМЦ
  [data] => ID раздела каталога
  Необязательные параметры:
   )
   location - категория учёта [storage|staff|customer|node|task]
   object_id - ID объекта учёта ''(можно через запятую)''


==== get_inventory_storage ====
==== get_inventory_storage ====
Строка 155: Строка 149:
   )
   )


==== get_inventory_section_catalog ====
==== transfer_inventory ====
  Описание: Получение наименований каталога ТМЦ
''Доработано в: 3.12.89 (добавлен параметр operator_id)''
  Описание: Перемещение ТМЦ
Обязательные параметры:
  inventory_id - ID ТМЦ
  dst_account - Счет-получатель
Необязательные параметры
  operator_id - ID оператора - автора операции
  Дополнительно возвращаемые данные:
  Дополнительно возвращаемые данные:
   array(
   array(
   [data] => ID раздела каталога
   [Id] => ID операции перемещения
   )
   )

Версия от 19:46, 20 марта 2019

Раздел API ERP "UserSide"

Назначение: Действия с ТМЦ и складом

Дополнительные параметры:
action - подкатегория запроса (возможное значение: см.ниже)

В учёте ТМЦ используется понятие как "счет учета".

Счета представляют значения вида "20503123456" или "205031234567"

Первые 3 цифры:

101 - Поставщики
203 - Сотрудники
204 - Склад
205 - Абонент
206 - Узел связи/муфта
210 - ВОЛС
211 - Линия связи
212 - Задание
213 - Дом
900 - Списано

4 и 5 цифра - субсчет

01 - Подотчет долгий
02 - Подотчет короткий
03 - ТМЦ
08 - Аренда
09 - Учет проданного

Последние 6 или 7 цифр - это ID объекта с ведущими нулями

20503123456 - Счёт абонента id 123456 и субсчет обычного учета ТМЦ

Подкатегории

add_inventory

Описание: Приход ТМЦ
Обязательные параметры:
 inventory_catalog_id - ID наименования ТМЦ
 trader_id - ID поставщика
Необязательные параметры:
 amount - количество (по-умолчанию: 1)
 cost - стоимость (по-умолчанию: 0)
 storage_id - ID склада, на который выполнить приход (по-умолчанию: 1)
 comment - заметки
 sn - серийный номер
 barcode - штрихкод
 inventory_number - инвентарный номер
 document_number - номер документа прихода
 document_date - дата документа прихода
 additional_data_ip - IP-адрес (для ТМЦ-оборудования)
 additional_data_mac - MAC-адрес (для ТМЦ-оборудования)
Дополнительно возвращаемые данные:
 array(
  [Id] => ID ТМЦ
 )

change_arg_ip

Добавлено в: 3.12.81

Описание: Изменение IP-адреса в параметрах ТМЦ
Обязательные параметры:
 id - ID ТМЦ
 value - IP-адрес

change_arg_mac

Добавлено в: 3.12.81

Описание: Изменение MAC-адреса в параметрах ТМЦ
Обязательные параметры:
 id - ID ТМЦ
 value - MAC-адрес

change_comment

Добавлено в: 3.12.81

Описание: Изменение заметки ТМЦ
Обязательные параметры:
 id - ID ТМЦ
 value - заметка

change_serial_number

Добавлено в: 3.12.52

Описание: Изменение серийного номера у ТМЦ
Обязательные параметры:
 id - ID ТМЦ
 value - серийный номер

get_inventory

Описание: Получение информации о ТМЦ
Обязательные параметры:
 id - ID ТМЦ
Дополнительно возвращаемые данные:
 array(
  [data] => ID с информацией о ТМЦ
 )

get_inventory_amount

Доработано в: 3.12.85 (в параметр location добавлено возможное значение task)

Доработано в: 3.12.71 (в параметре object_id можно подавать значения через запятую)

Доработано в: 3.12beta27 (добавлен параметр location)

Описание: Получение списка ТМЦ
Необязательные параметры:
 location - категория учёта [storage|staff|customer|node|task]
 object_id - ID объекта учёта (можно через запятую)

get_inventory_catalog

Доработано в: 3.12.74 (добавлен параметр section_id)

Описание: Получение списка разделов каталога
Необязательные параметры
 section_id - ID типа ТМЦ (можно через запятую)
Дополнительно возвращаемые данные:
 array(
  [data] => ID раздела каталога
 )

get_inventory_catalog_id_by_name

Описание: Получение ID раздела каталога по его наименованию
Обязательные параметры:
 name - наименование
Дополнительно возвращаемые данные:
 array(
  [Id] => ID раздела каталога
 )

get_inventory_id

Описание: Получение ID ТМЦ по входящим данным
Обязательные параметры:
 data_typer - тип данных, которые проверяем (возможные значения: inventory_number, serial_number)
 data_value - значение
Дополнительно возвращаемые данные:
 array(
  [id] => id ТМЦ в случае успеха
 )

get_inventory_section_catalog

Описание: Получение наименований каталога ТМЦ
Дополнительно возвращаемые данные:
 array(
  [data] => ID раздела каталога
 )

get_inventory_storage

Описание: Получение списка складов
Дополнительно возвращаемые данные:
 array(
  [data] => ID раздела каталога
 )

transfer_inventory

Доработано в: 3.12.89 (добавлен параметр operator_id)

Описание: Перемещение ТМЦ
Обязательные параметры:
 inventory_id - ID ТМЦ
 dst_account - Счет-получатель
Необязательные параметры
 operator_id - ID оператора - автора операции
Дополнительно возвращаемые данные:
 array(
  [Id] => ID операции перемещения
 )