Product Integration
Do you know what e-commerce product is?
We have two lines of reasoning:
Type | Description |
Simple Product | Are the ones composed of a single Sku |
Configurable Product | Also known as product with variation, are those composed of two or more Skus |
SKU is the unit of stock sold, the acronym stands for Stock Keeping Unit
Simples Product
The simple product is unique, has no SKU variation. Example: Book, CD, DVD ...
Important: Even a simple product, needs attributes and characteristics that strengthen the identity of the product itself. Example: Jazz CD
Attributes can be used for filters in your categories.
Configurable Product
A configurable (variable) product has two or more variations (eg color and size or color and voltage) that differentiate it from a corresponding product.
Examples:
Product: 300 Liter refrigerator; Variation 1: 300 liter refrigerator - 110 volts Variation 2: 300 liter refrigerator - 220 volts
In the example above, each of the refrigerators has a different ID_SKU and are linked to a Product (Parent Product) code.
Product Structure
Next, we'll show the structure of a product according to the standard Skyhub Json format.
Best practices for product registration
Following a convention (standard) in the product registration is a very important practice. We then list some of the best practices to help you become even more successful in the Marketplace.
Use a standard for the composition of SKU codes, but never repeat a code, either for simple product or configurable product (variable) one;
Make sure that the product code does not have any white space. This usually from the direct copy of the Excel file cell;
The products must need to be shipped with the weight in kilograms (kg) and the dimensions in centimeters (cm)
You'll find much more in our "Best Practices Guide to Product Registration"
A little bit of "practice"
To perform any type of request, you must always fill in the Header, with the information generated by us from Skyhub, considering the model below:
POST
To register a product via API, you must use the POST method directing your request to our endpoint https://api.skyhub.com.br
Below is an example that includes a variation of COD_SKU_VARIACAO code:
If you want to register a simple product (without variation), you can use the template below where we remove the Variations array.
GET
To perform a query in the API we must use the GET method, filling in the Header as previously shown and keeping the request as below:
The "SKU_code" is the product code you wish to consult
In our example, we list a "summary" result because the complete return would bring several pages, with all the attributes that compose the product, but basically the response of our GET brought the product registration itself.
PUT
The way to update information is through the PUT method, keeping our Header and conserving the attribute in which you want to update.
To perform the update, we must maintain the endpoint:
In this example, we are only changing the name of the product, so all other attributes have been removed from the request, to facilitate understanding.
Note: You can also keep all the attributes of your request and change the values from which you want to perform an update.
DELETE
To delete a item, you must use the DELETE method, keeping the Header already indicated, the request is equal to a GET, but the product will be deleted.
Important: Before deleting any item from Skyhub, it is extremely important to verify if the product is connected to a Marketplace. Remember: You must disconnect and/or remove association of the SKU from all marketplaces, otherwise you won't be able to delete the product from Skyhub.
Last updated
