_add

Create a new Stock item

Parameters

id (optional)

Integer ID for the stock item. If this is provided, the server will try to update the existing stock item instead of creating a new one.

name

String. The human-readable name of the Stock item.

code

String. The stock code for this item.

Codes must be unique, so if you try to create a new stock item with an existing stock code, then the existing item will be updated instead.

nominal (optional)

Integer nominal code for accounting purposes. Defaults to 0 if not supplied.

cost

Float cost of one of the stock item. How much you bought it for.

amount

Float. How many of the item are you adding to database.

price

Float price of the stock. How much you sell the product for.

description (optional)

String description of the Stock item.

notes (optional)

String notes about the Stock item. You could include details of where it was purchased, any special instructions for working with it, etc.

supplier (optional)

String name of the Supplier. Must match an existing Supplier.

Example

FM_api('Stock_add',
	[
		'name'=>'1kg 1.75mm PLA Filament',
		'code'=>'PLA001',
		'nominal'=>'1',
		'cost'=>'12.99',
		'price'=>'15.99',
		'amount'=>'3',
		'description'=>'PLA filament for 3D printers'
	]
);

Result

{"ok":1,"id":"7"}