API inventory EN

Материал из WiKi - UserSide

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 - Communications facility
210 - Cable line
211 - Communication Line (from 3.15 onwards 210 is used instead)
212 - Task
213 - Buildings
215 - Employees (from 3.16dev2)
900 - Written off

4th and 5th digit - sub-account

01 - Long subreport
02 - Short subreport
03 - INVENTORY
08 - Rent
09 - Accounting of the sold things
.. (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

Modified in 3.19beta1 (storage_id parameter made mandatory)

Modified in 3.18.26 (added is_check_serial_number input parameter)

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

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 the Written off Inventory
Obligatory parameters:
 id - id of the inventory (The inventory must be written off)

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)