This is a developer preview of Kubbos API. It's in beta, so it's subject to changes. If you need any of the "Coming soon" API services documented as soon as possible. Contact Us!

#items.list
#items.findById
#items.create
#items.update
#items.delete

items.list

Request

{
/* — search criteria (optional) — */
"reference":"",
"enabled":"",                   // Boolean
"shortDescriptionItem":"",
"brandID":"",                   // id value from brands.list
"itemCategoryID":"",            // id value from itemCategories.list
"includeSubCategories":"",      // Boolean
"weightFrom":"",                // Numeric
"weightTo":"",                  // Numeric
"unitOfMeasureID":"",           // id value from UOM.list
"inStockFrom":"",               // Numeric
"inStockTo":"",                 // Numeric
"minimumStockFrom":"",          // Numeric
"minimumStockTo":"",            // Numeric
"salePriceFrom":"",             // Numeric
"salePriceTo":"",               // Numeric
"salePriceTaxIncludedFrom":"",  // Numeric
"salePriceTaxIncludedTo":"",    // Numeric
"saleEnabled":"",               // Boolean
"costPriceFrom":"",             // Numeric
"costPriceTo":"",               // Numeric
"costPriceTaxIncludedFrom":"",  // Numeric
"costPriceTaxIncludedTo":""     // Numeric
}

Response

{
    "data":     {
        "result":         [
                        {
                "abc": "B",
                "enabled": "true",
                "availableItemsUnits": 15,
                "retailPrice": 83.19,
                "costPriceWarehouse": 63.45,
                "costPriceTaxIncludedWarehouse": 74.871,
                "salePriceWarehouse": 70.5,
                "minSalePriceWarehouse": 64.74,
                "stockWarehouse": 15,
                "shortDescriptionItem": "Embellecedor con manecilla. Inversor.",
                "longDescriptionItem": "Embellecedor de aluminio de diseño Italiano.",
                "saleEnabled": "true",
                "categoryName": "Bañera",
                "brandName": "Techdrae",
                "weight": 0.9,
                "reference": "HERMES-B007",
                "version": 5,
                "fileId": 104,
                "divisible": false,
                "id": "1242",
                "itemCategoryID": 724,
                "costPriceTaxID": 1260000001300,
                "salePriceTaxID": 1260000001300,
                "brandID": 526,
                "priceListID": 1260000001434,
                "unitOfMeasureID": 1260000000608,
                "costPriceUpdateOption": 2,
                "pendingEntryItemUnits": 0,
                "externalAccessEnabled": false,
                "bookedItemsUnits": 0
            },
                        {
				......
            },
                        {
                "enabled": "true",
                "availableItemsUnits": 10,
                "retailPrice": 74.989,
                "costPriceWarehouse": 45.32,
                "costPriceTaxIncludedWarehouse": 53.4776,
                "salePriceWarehouse": 63.55,
                "stockWarehouse": 10,
                "shortDescriptionItem": "Vaciador automático de 1 1/4.",
                "saleEnabled": "true",
                "categoryName": "Lavabo",
                "brandName": "Techdrae",
                "reference": "ARES-L001",
                "version": 1,
                "fileId": 121,
                "divisible": false,
                "id": "1222",
                "itemCategoryID": 722,
                "costPriceTaxID": 1260000001300,
                "salePriceTaxID": 1260000001300,
                "brandID": 526,
                "unitOfMeasureID": 1260000000608,
                "costPriceUpdateOption": 3,
                "pendingEntryItemUnits": 0,
                "externalAccessEnabled": false,
                "bookedItemsUnits": 0
            }
        ],
        "total": 26
    },
    "success": true
}

items.findById

Request

{
"id": "1222"
}

Response

{
    "data":     {
        "enabled": "true",
        "availableItemsUnits": 10,
        "retailPrice": 74.99,
        "costPriceWarehouse": 45.32,
        "costPriceTaxIncludedWarehouse": 53.48,
        "salePriceWarehouse": 63.55,
        "stockWarehouse": 10,
        "shortDescriptionItem": "Vaciador automático de 1 1/4.",
        "saleEnabled": "true",
        "reference": "ARES-L001",
        "version": 1,
        "fileId": 121,
        "fileName": "Mezclador monomando de lavabo Ares.jpg",
        "divisible": false,
        "id": "1222",
        "itemCategoryID": 722,
        "costPriceTaxID": 1260000001300,
        "salePriceTaxID": 1260000001300,
        "brandID": 526,
        "unitOfMeasureID": 1260000000608,
        "costPriceUpdateOption": 3,
        "pendingEntryItemUnits": 0,
        "externalAccessEnabled": false,
        "bookedItemsUnits": 0
    },
    "success": true
}

items.create

Request

{
"enabled":"true",
"saleEnabled":"true",
"reference":"ARES-L001",
"itemCategoryID":"722",             // id value from itemCategories.list
"shortDescriptionItem":"Vaciador automático de 1 1/4.",
"longDescriptionItem":"",
"brandID":"526",                    // id value from brands.list
"unitOfMeasureID":"1260000000608",  // id value from UOM.list
"weight":"",
"height":"",
"width":"",
"depth":"",
"divisible":"false",
"costPriceWarehouse":"45.32",
"costPriceTaxID":"1260000001300",   // id value from taxes.list 
"costPriceUpdateOption":"3",
"priceListID":"",                   // id value from itemsPriceLists.list
"minSalePriceWarehouse":"",
"salePriceWarehouse":"63.55",
"salePriceTaxID":"1260000001300",   // id value from taxes.list
"stockWarehouse":"10",
"bookedItemsUnits":"0",
"pendingEntryItemUnits":"0",
"minStockWarehouse":"",
"recommendedStockWarehouse":"",
"maxStockWarehouse":"",
"abc":"",
"supplierReferences":[]
}

Response

{
"data": {
"errors": [],
"messages": [ {
"description": "Operación realizada correctamente",
"id": "operation_success"
}],
"warns": []
},
"id": "1222",
"success": true
}

items.update

Request

{
"enabled":"true",
"saleEnabled":"true",
"reference":"ARES-L001", 
"itemCategoryID":"722",             // id value from itemCategories.list
"shortDescriptionItem":"Vaciador automático de 1 1/4\.",
"longDescriptionItem":"",
"brandID":"526",                    // id value from brands.list
"unitOfMeasureID":"1260000000608",  // id value from UOM.list
"weight":"",
"height":"",
"width":"",
"depth":"",
"divisible":"false",
"costPriceWarehouse":"45.32",
"costPriceTaxID":"1260000001300",   // id value from taxes.list 
"costPriceUpdateOption":"3",
"priceListID":"",                   // id value from itemsPriceLists.list
"minSalePriceWarehouse":"",
"salePriceWarehouse":"63.55",
"salePriceTaxID":"1260000001300",   // id value from taxes.list 
"minStockWarehouse":"",
"recommendedStockWarehouse":"",
"maxStockWarehouse":"",
"abc":"",
"id":"1222",
"version":"0",
"supplierReferences":
	[
		{
		"supplierID":"11551",       // id value from suppliers.list
		"supplierReference":"R-823742-GR",
		"defaultReference":false,
		"supplierPrice":45.45
		}
	]
}

Response

{
"data": {
"errors": [],
"messages": [ {
"description": "Operación realizada correctamente",
"id": "operation_success"
}],
"warns": []
},
"id": "1222",
"success": true
}

items.delete

Request

{
"id":"1222",
"version":1
}

Response

{
    "data":     {
        "errors": [],
        "messages": [        {
            "description": "Operación realizada correctamente",
            "id": "operation_success"
        }],
        "warns": []
    },
    "id": "1222",
    "success": true,
    "version": 1
}
  • No labels