# Best integrations practices

#### Stock and Prices

***

• Read the provided documentation to minimize integration issues. 

• Only send updates for products that exist in Alephee's catalog. 

• Do not send updates for products that do not exist. 

• Only send updates for products that have had their price or inventory/stock modified. 

• Do not send updates for products that have not been modified at all. 

• Do not update one product per API call. 

• Instead, send a "batch" of several products in each call. 

• Take advantage of the update time slots. 

• Do not use the daytime update time slot to make updates that can be done during the nighttime update time slot. 

• Develop a scheme for "retrying" submissions in case of communication failures with the API. 

• Use the provided services efficiently. 

• Do not make calls every minute for similar cases.

#### Orders

***

• Read the provided documentation to minimize integration issues. 

• Only take from each order what the integrating system requires. 

• Do not process all order attributes but only those needed for the integration. 

• Implement 2 (two) order integration cycles from Alephee: 

• Normal cycle: 

* Retrieve orders with a filter of "not integrated" in Alephee, without any other filter (GET orders method). 
* Process each order in the integrating system, paying special attention to those in cancelled status. 
* Mark each order in Alephee as integrated (PUT orders/integrate method). 

• Late cancellation cycle: 

* For orders that were cancelled after the sale and were previously integrated. 
* Retrieve orders with filters of CANCELLED status and modified in the last X days (GET orders method). 
* Process each order and cancel it in the integrating system using the corresponding method for each system. 

• Use the provided services efficiently. 

• Do not make calls every 1 minute or similar cases.