Examples by country

📦 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: /

{
   "name": "papas fritas lays",
   "invoicing_details": "",
   "additional_details": "",
   "model": "",
   "brand": "",
   "status": "1",
   "sku": "33",
   "measure_unit": null,
   "type": "1",
   "embedded_quantity_barcode": null,
   "embedded_quantity_barcode_decimals": null,
   "additional_data_1": "aaa",
   "additional_data_2": "bbb",
   "additional_data_3": "ccc",
   "favorite": 1,
   "product_category_id": null,
   "cost":    {
      "currency_id": 39,
      "value": 2344
   },
   "price": [
    {
          "price_list_id": "1",
          "unit_net": 1680.672269,
          "unit_tax": 319.327731,
          "unit_total": 2000,
          "currency_id": "39",
          "sales_commission_percentage": null,
          "taxes": [
                {
                  "tax_type_id": "387",
                  "tax_percentage": 19,
                  "tax_amount": 319.327731
                }

          ]
       }
    ],
   "inventories":    {
    "details": [
            {
                "product_location_id": 1,
                "available_quantity": 25
            }
    ],
      "total_available": 25,
      "total_reserved": 0
   }
}

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: /

{
    "account_id": 39,
    "name": "categoria ejemplo API 3",
    "parent_product_category_id": null
}

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: /

{
    "account_id": 39,
    "name": "bodega pruebas",
    "status": 1,
    "company_branch_id": 1
}

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: /

{
    "account_id": 39,
    "name": "new product price list"
}