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

Материал из WiKi - UserSide
(Новая страница: «en | ru Section '''API''' ERP "UserSide"»)
 
Нет описания правки
Строка 2: Строка 2:


Section '''[[API_EN|API]]''' ERP "UserSide"
Section '''[[API_EN|API]]''' ERP "UserSide"
Purpose: Actions with inventory and warehouse
Additional parameters:
action - request subcategory ''(possible value: see below)''
In the accounting of inventory items a concept like "account of account" is used.
Accounts represent values of the form "205031234567"
First 3 digits:
101 - Suppliers
203 - Employees ''(up to 3.16dev2)''
204 - Warehouse
205 - User
206 - Communication installation
210 - Cable line
211 - Communication Line ''(from 3.15 onwards 210 is used instead)''
212 - Task
213 - Buildings
215 - Employees ''(from 3.16dev2)''
900 - Discharged
4th and 5th digit - sub-account
01 - Long accountability
02 - Short accountability
03 - INVENTORY
08 - Rent
09 - Accounting of sold
.. ''(since 3.17dev1 you can add your own sub-accounts
The last 7 digits are the object ID with leading zeros
205031234567 - User account id 1234567 and a subaccount of the regular inventory account
== Subcategories ==
==== add_inventory ====
Description: Arrival of inventory
Obligatory parameters:
  inventory_catalog_id - ID of the inventory item name
  trader_id - ID of the supplier
Optional parameters:
  amount - quantity (default: 1)
  cost - cost (default: 0)
  storage_id - ID of the warehouse to which the receipt is executed (default: 1)
  comment - notes
  sn - serial number
  barcode - barcode
  inventory_number - inventory number
  document_number - number of the receipt document
  document_date - date of arrival document
  additional_data_ip - IP-address (for inventory equipment)
  additional_data_mac - MAC address (for inventory equipment)
==== add_inventory_assortment ====
'' Added in: 3.14.1''
Description: Adds the name of the inventory item
Obligatory parameters:
  section_id - section id of the inventory catalogue section
  name - name
Optional parameters:
  unit_name - unit of measurement
  is_require_serial_number - flag - require serial number input when inventory is received
  is_require_mac - flag - require input of MAC-address on arrival of inventory items
==== add_inventory_section ====
''Added in: 3.14.1''
Description: Adds an item catalogue section
Obligatory parameters:
  name - name
Optional parameters:
  typer - id of special attribute ''(default: 0)''
  parent_id - id of the parent section of the catalogue
  is_show_on_map - flag - whether to display objects of this section as a layer on the map
==== add_inventory_to_operation ====
''Added in: 3.13.38''
Description: Adding inventory to an operation
Obligatory parameters:
  operation_id - id of operation
  inventory_id - inventory id ''(it must be in the source account of the operation)''
Optional parameters:
  amount - quantity of inventory ''(if more than 1 unit in the inventory)''
==== change_arg_ip ====
''Added in: 3.12.81''
Description: Change the IP address in the parameters of the inventory
Obligatory parameters:
  id - ID of the inventory item
  value - IP address
==== change_arg_mac ====
''Added in: 3.12.81''
Description: Change the MAC address in the parameters of the inventory
Obligatory parameters:
  id - ID of the inventory item
  value - MAC-address
==== change_comment ====
''Added in: 3.12.81''
Description: Changing the note of the inventory item
Required parameters:
  id - ID of the inventory item
  value - note
==== change_serial_number ====
''Added in: 3.12.52''
Description: Change the serial number of the inventory item
Required parameters:
  id - ID of the inventory item
  value - serial number
==== delete_inventory ====
''Added in: 3.13.48''
Description: Deletion of DISCHARGED Inventory
Obligatory parameters:
  id - id of the inventory ''(The inventory must be discharged)''
==== edit_inventory_assortment ====
''Added in: 3.14.1''
Description: Edit the name of the inventory item
Obligatory parameters:
  id - id of the item name
Optional parameters:
  name - name
  unit_name - unit of measurement
  is_require_serial_number - flag - require serial number input at the arrival of the inventory items
  is_require_mac - flag - require MAC-address to be entered when the inventory item arrives
==== edit_inventory_section ====
''Added in: 3.14.1''
Description: Editing a section of the product catalogue
Obligatory parameters:
  id - id of the catalogue section
Optional parameters:
  name - name
  parent_id - id of the parent catalogue section
  is_show_on_map - flag - whether to display objects of this section as a layer on the map
==== get_inventory ====
Description: Receive information about inventory
Obligatory parameters:
  id - ID of the inventory item
==== get_inventory_amount ====
''Modified in: 3.16dev3 (added inventory_type_id, section_id parameters)''
''Modified in: 3.16dev2 (replaced staff with employee in the location parameter)''
''Modified in: 3.12.85 (added possible task value to location parameter)''
''Modified in: 3.12.71 (object_id parameter can be set to comma-separated values)''
''Modified in: 3.12beta27 (added location parameter)''
Description: Retrieve list of inventory items
Obligatory parameters:
  location - accounting category [storage|employee|customer|node|task] ''(staff - before 3.16dev2)''
Optional parameters:
  object_id - id of accounting object ''(can be comma separated)''
  inventory_type_id - inventory item id ''(can be comma separated)''
  section_id - product catalogue section id ''(can be comma separated)''
==== get_inventory_catalog ====
''Modified in: 3.18beta1 (added id parameter)''
''Modified in: 3.12.74 (added section_id parameter)''
Description: Get a list of catalogue sections
Optional parameters
  id - ID of the inventory item ''(can be comma separated)''
  section_id - ID of the inventory type ''(can be comma separated)''
==== get_inventory_catalog_id_by_name ====
Description: Retrieve the ID of an item of inventory by its name
Obligatory parameters:
  name - name
==== get_inventory_id ====
''Modified in: 3.18beta1 (added possible ip value for data_typer parameter)''
''Modified in: 3.14.71 (added is_all_data parameter)''
''Modified in: 3.14.34 (added possible barcode value for data_typer parameter)''
''Modified in: 3.13.11 (added possible value mac for data_typer parameter)''
Description: Retrieve inventory item IDs from incoming data
Optional parameters:
  is_all_data - flag - return all found inventory items, not just one
Obligatory parameters:
  data_typer - type of data we are checking ''(possible values: barcode, inventory_number, serial_number, mac, ip)''
  data_value - value
==== get_inventory_section_catalog ====
Description: Get the names of the inventory catalogue
==== get_inventory_storage ====
Description: Retrieve the list of warehouses
==== get_operation ====
''Modified in: 3.18beta1 (added employee_id, inventory_assortment_id parameters)''
''Modified in: 3.15.12 (added inventory_id parameter)''
''Added in: 3.12.90''
Description: Retrieve information on transactions
Optional parameters ''(but there should be at least something)'':
  id - transaction ID ''(multiple values separated by commas are possible)''
  src_account - credit account ''(from where)''
  dst_account - debit account ''(to where)''
  date_start - start date of the period
  date_finish - period end date
  inventory_id - id of inventory
  employee_id - id of the employee initiating the transaction
  inventory_assortment_id - id of the inventory item name
==== split_inventory ====
''Added in: 3.13.35''
Description: Split Inventory
Obligatory parameters:
  id - id of the inventory item
  amount - required quantity
''As a result of the splitting, a quantity equal to amount will remain in the item id and a new item will be created (returned in the variable new_id) with the remaining quantity.''
==== transfer_inventory ====
''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''
''Modified in: 3.12.89 (added operator_id, comment parameters)''
Description: Inventory transfer
Obligatory parameters:
  inventory_id - ID of inventory
  dst_account - Receiving account
Optional parameters
  comment - notes
  employee_id - ID of employee - author of operation
  operator_id - ID of operator - author of operation ''(before version 3.16dev2)''

Версия от 16:40, 22 августа 2023

en | ru

Section API ERP "UserSide"

Purpose: Actions with inventory and warehouse

Additional parameters:
action - request subcategory (possible value: see below)

In the accounting of inventory items a concept like "account of account" is used.

Accounts represent values of the form "205031234567"

First 3 digits:

101 - Suppliers
203 - Employees (up to 3.16dev2)
204 - Warehouse
205 - User
206 - Communication installation
210 - Cable line
211 - Communication Line (from 3.15 onwards 210 is used instead)
212 - Task
213 - Buildings
215 - Employees (from 3.16dev2)
900 - Discharged

4th and 5th digit - sub-account

01 - Long accountability
02 - Short accountability
03 - INVENTORY
08 - Rent
09 - Accounting of sold
.. (since 3.17dev1 you can add your own sub-accounts

The last 7 digits are the object ID with leading zeros

205031234567 - User account id 1234567 and a subaccount of the regular inventory account

Subcategories

add_inventory

Description: Arrival of inventory
Obligatory parameters:
 inventory_catalog_id - ID of the inventory item name
 trader_id - ID of the supplier
Optional parameters:
 amount - quantity (default: 1)
 cost - cost (default: 0)
 storage_id - ID of the warehouse to which the receipt is executed (default: 1)
 comment - notes
 sn - serial number
 barcode - barcode
 inventory_number - inventory number
 document_number - number of the receipt document
 document_date - date of arrival document
 additional_data_ip - IP-address (for inventory equipment)
 additional_data_mac - MAC address (for inventory equipment)

add_inventory_assortment

Added in: 3.14.1

Description: Adds the name of the inventory item
Obligatory parameters:
 section_id - section id of the inventory catalogue section
 name - name
Optional parameters:
 unit_name - unit of measurement
 is_require_serial_number - flag - require serial number input when inventory is received
 is_require_mac - flag - require input of MAC-address on arrival of inventory items

add_inventory_section

Added in: 3.14.1

Description: Adds an item catalogue section
Obligatory parameters:
 name - name
Optional parameters:
 typer - id of special attribute (default: 0)
 parent_id - id of the parent section of the catalogue
 is_show_on_map - flag - whether to display objects of this section as a layer on the map

add_inventory_to_operation

Added in: 3.13.38

Description: Adding inventory to an operation
Obligatory parameters:
 operation_id - id of operation
 inventory_id - inventory id (it must be in the source account of the operation)
Optional parameters:
 amount - quantity of inventory (if more than 1 unit in the inventory)

change_arg_ip

Added in: 3.12.81

Description: Change the IP address in the parameters of the inventory
Obligatory parameters:
 id - ID of the inventory item
 value - IP address

change_arg_mac

Added in: 3.12.81

Description: Change the MAC address in the parameters of the inventory
Obligatory parameters:
 id - ID of the inventory item
 value - MAC-address

change_comment

Added in: 3.12.81

Description: Changing the note of the inventory item
Required parameters:
 id - ID of the inventory item
 value - note

change_serial_number

Added in: 3.12.52

Description: Change the serial number of the inventory item
Required parameters:
 id - ID of the inventory item
 value - serial number

delete_inventory

Added in: 3.13.48

Description: Deletion of DISCHARGED Inventory
Obligatory parameters:
 id - id of the inventory (The inventory must be discharged)

edit_inventory_assortment

Added in: 3.14.1

Description: Edit the name of the inventory item
Obligatory parameters:
 id - id of the item name
Optional parameters:
 name - name
 unit_name - unit of measurement
 is_require_serial_number - flag - require serial number input at the arrival of the inventory items
 is_require_mac - flag - require MAC-address to be entered when the inventory item arrives

edit_inventory_section

Added in: 3.14.1

Description: Editing a section of the product catalogue
Obligatory parameters:
 id - id of the catalogue section
Optional parameters:
 name - name
 parent_id - id of the parent catalogue section
 is_show_on_map - flag - whether to display objects of this section as a layer on the map

get_inventory

Description: Receive information about inventory
Obligatory parameters:
 id - ID of the inventory item

get_inventory_amount

Modified in: 3.16dev3 (added inventory_type_id, section_id parameters)

Modified in: 3.16dev2 (replaced staff with employee in the location parameter)

Modified in: 3.12.85 (added possible task value to location parameter)

Modified in: 3.12.71 (object_id parameter can be set to comma-separated values)

Modified in: 3.12beta27 (added location parameter)

Description: Retrieve list of inventory items
Obligatory parameters:
 location - accounting category [storage|employee|customer|node|task] (staff - before 3.16dev2)
Optional parameters:
 object_id - id of accounting object (can be comma separated)
 inventory_type_id - inventory item id (can be comma separated)
 section_id - product catalogue section id (can be comma separated)

get_inventory_catalog

Modified in: 3.18beta1 (added id parameter)

Modified in: 3.12.74 (added section_id parameter)

Description: Get a list of catalogue sections
Optional parameters
 id - ID of the inventory item (can be comma separated)
 section_id - ID of the inventory type (can be comma separated)

get_inventory_catalog_id_by_name

Description: Retrieve the ID of an item of inventory by its name
Obligatory parameters:
 name - name

get_inventory_id

Modified in: 3.18beta1 (added possible ip value for data_typer parameter)

Modified in: 3.14.71 (added is_all_data parameter)

Modified in: 3.14.34 (added possible barcode value for data_typer parameter)

Modified in: 3.13.11 (added possible value mac for data_typer parameter)

Description: Retrieve inventory item IDs from incoming data
Optional parameters:
 is_all_data - flag - return all found inventory items, not just one
Obligatory parameters:
 data_typer - type of data we are checking (possible values: barcode, inventory_number, serial_number, mac, ip)
 data_value - value

get_inventory_section_catalog

Description: Get the names of the inventory catalogue

get_inventory_storage

Description: Retrieve the list of warehouses

get_operation

Modified in: 3.18beta1 (added employee_id, inventory_assortment_id parameters)

Modified in: 3.15.12 (added inventory_id parameter)

Added in: 3.12.90

Description: Retrieve information on transactions
Optional parameters (but there should be at least something):
 id - transaction ID (multiple values separated by commas are possible)
 src_account - credit account (from where)
 dst_account - debit account (to where)
 date_start - start date of the period
 date_finish - period end date
 inventory_id - id of inventory
 employee_id - id of the employee initiating the transaction
 inventory_assortment_id - id of the inventory item name

split_inventory

Added in: 3.13.35

Description: Split Inventory
Obligatory parameters:
 id - id of the inventory item
 amount - required quantity

As a result of the splitting, a quantity equal to amount will remain in the item id and a new item will be created (returned in the variable new_id) with the remaining quantity.

transfer_inventory

Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)

Modified in: 3.12.89 (added operator_id, comment parameters)

Description: Inventory transfer
Obligatory parameters:
 inventory_id - ID of inventory
 dst_account - Receiving account
Optional parameters
 comment - notes
 employee_id - ID of employee - author of operation
 operator_id - ID of operator - author of operation (before version 3.16dev2)