Ejemplos por país

📦 Gestionar productos

Crear nuevos productos

Los productos pueden ser cualquier cosa que compre o venda: mercancías o servicios. Un producto puede tener una cantidad disponible en múltiples bodegas y mostrar diferentes precios según las listas de precios.

• Endpoint: https://api-billing.koywe.com/V1/products
• Método: POST
• Cabeceras requeridas:
• 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
   }
}

Crear nuevas categorías de productos

Los productos pueden pertenecer opcionalmente a una categoría. Las categorías también pueden tener una jerarquía al tener una categoría padre.

• Endpoint: https://api-billing.koywe.com/V1/product_categories
• Método: POST
• Cabeceras requeridas:
• Content-Type: application/json
• Authorization: Bearer \<token>
• Accept: /

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

Crear nuevas ubicaciones de productos

Las ubicaciones pueden ser bodegas, vehículos de transporte, tiendas u otros lugares donde almacena productos.

• Endpoint: https://api-billing.koywe.com/V1/product_locations
• Método: POST
• Cabeceras requeridas:
• Content-Type: application/json
• Authorization: Bearer \<token>
• Accept: /

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

Crear nueva lista de precios de productos

Las listas de precios le permiten definir diferentes precios para el mismo producto y así ofrecer precios personalizados a sus clientes.

• Endpoint: https://api-billing.koywe.com/V1/product_price_lists
• Método: POST
• Cabeceras requeridas:
• Content-Type: application/json
• Authorization: Bearer \<token>
• Accept: /

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