Create Item
POST https://api.freshbooks.com/accounting/account/{{accountId}}/items/items
If you add an inventory
to an item, FreshBooks will decrement that inventory
value each time you add that item to an invoice and save (or send) it.
However, qty
is seen as the amount of items associated with that sale. Therefore, it will remain unchanged with anytime it is added to an invoice.
For example: You may have 5 boxes of nails. Each box of nails will have 99 nails in it. Therefore, your inventory
will equal 5
and your qty
will equal 99
.
Request Body
{"item"=>{"name"=>"Packback", "qty"=>"10", "inventory"=>"50", "unit_cost"=>{"amount"=>"550.00", "code"=>"CAD"}, "vis_state"=>0, "description"=>"65L Brack Pack", "sku"=>"KS994RUR"}}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string |
RESPONSES
status: OK
{"response":{"result":{"item":{"accounting_systemid":"wkMd2g","description":"Backpack with ferns","id":59704,"inventory":"55","itemid":59704,"name":"Backpack","qty":"20","tax1":0,"tax2":0,"unit_cost":{"amount":"750.00","code":"USD"},"updated":"2019-04-19 08:09:32","vis_state":0}}}}