📦 Managing products

Create new products

Products can be anything you buy or sell, it could be merchandise or services. A product can have an available quantity on multiple warehouses and show different prices based on price lists.

Endpoint: https://api-billing.koywe.com/V1/products
Method: POST
Required headers:
Content-Type: application/json
Authorization: Bearer <token>
Accept: */*

1 {
2    "name": "papas fritas lays",
3    "invoicing_details": "",
4    "additional_details": "",
5    "model": "",
6    "brand": "",
7    "status": "1",
8    "sku": "33",
9    "measure_unit": null,
10    "type": "1",
11    "embedded_quantity_barcode": null,
12    "embedded_quantity_barcode_decimals": null,
13    "additional_data_1": "aaa",
14    "additional_data_2": "bbb",
15    "additional_data_3": "ccc",
16    "favorite": 1,
17    "product_category_id": null,
18    "cost":    {
19       "currency_id": 39,
20       "value": 2344
21    },
22    "price": [
23     {
24           "price_list_id": "1",
25           "unit_net": 1680.672269,
26           "unit_tax": 319.327731,
27           "unit_total": 2000,
28           "currency_id": "39",
29           "sales_commission_percentage": null,
30           "taxes": [
31                 {
32                   "tax_type_id": "387",
33                   "tax_percentage": 19,
34                   "tax_amount": 319.327731
35                 }
36 
37           ]
38        }
39     ],
40    "inventories":    {
41    	"details": [
42    			{
43    				"product_location_id": 1,
44    				"available_quantity": 25
45    			}
46    	],
47       "total_available": 25,
48       "total_reserved": 0
49    }
50 }

Create new product categories

Products can optionally belong to a category. Categories can also have a hierarchy by having a parent category.

Endpoint: https://api-billing.koywe.com/V1/product_categories
Method: POST
Required headers:
Content-Type: application/json
Authorization: Bearer <token>
Accept: */*

1 {
2 	"account_id": 39,
3 	"name": "categoria ejemplo API 3",
4 	"parent_product_category_id": null
5 }

Create new product locations

Locations can be warehouses, shipping vehicles, stores or any other place where you store products.

Endpoint: https://api-billing.koywe.com/V1/product_locations
Method: POST
Required headers:
Content-Type: application/json
Authorization: Bearer <token>
Accept: */*

1 {
2 	"account_id": 39,
3 	"name": "bodega pruebas",
4 	"status": 1,
5 	"company_branch_id": 1
6 }

Create new product price list

Price lists allow you to define different prices for the same product in order to provide custom pricing to your customers.

Endpoint: https://api-billing.koywe.com/V1/product_price_lists
Method: POST
Required headers:
Content-Type: application/json
Authorization: Bearer <token>
Accept: */*

1 {
2 	"account_id": 39,
3 	"name": "new product price list"
4 }