Openapi For Warehouse FAQ

Q：Which ones belong to the push interface and which ones belong to the query interface?

A:

Push interface:

Query interface:

PS.The red mark "※" indicates that this interface is mandatory for integration.

Q：What is the basis for verifying the webhook request for the corresponding callback key and issued key?

A:

The callback key is the key used for OneWarehouse to callback after the successful operation of the WMS storage order and delivery order. OneWarehouse will analyze and verify whether the key is consistent.

The issued key is the key used when OneWarehouse invokes WMS. OneWarehouse will pass the sign, timestamp, and other fields to WMS, ensuring that the ones sent by OneWarehouse are consistent. If your system does not currently require this security verification method, you do not need to perform this verification step.

Q：Do you want IP whitelist restrictions?

A:

If the WMS system has relevant restrictions, it can be equipped with the following IP whitelist of OneWarehouse

As for the WMS system calling back to the OneWarehouse gateway, there is no whitelist restriction

The fixed export IP of OneWarehouse is:

• 121.11.221.130
• 121.11.221.131
• 52.77.143.211
• 122.248.196.11
• 46.51.219.5
• 13.214.244.173
• 18.143.33.165
• 13.215.123.123
• 120.78.70.56
• 120.78.69.89
• 120.78.67.40
• 120.78.71.91

Q： How can I access the test environment?

A:

In order to configure the test environment, you need to provide the push receiving address first. This is because there are six core push interfaces that are initiated by OneWarehouse. You can provide the URL initially and internally implement it temporarily, and we will configure it accordingly to provide the test environment.

The six core push interfaces are as follows:

1. Commodity Synchronization Interface
2. Purchase Order Interface
3. Return Order Interface
4. Receipt Order Cancellation Interface
5. Outbound Order Interface
6. Outbound Order Cancellation Interface

Q:What is the process of testing in the sandbox environment?

A:

For the testing process of the OneWarehouse system in the sandbox environment, it is recommended to follow the steps below:

1. Create product files: Create product files in the system, but note that this will not trigger the creation of a product interface immediately. It will only be called when the first product creation inbound order is successful.
2. Test the inbound process: Create an inbound order and verify the receipt of the inbound order. Then simulate the inbound operation, and call the callback interface to change the status of the inbound order to completed. At this time, the inventory will increase.
3. Test the outbound process: Create an outbound order, simulate the warehouse outbound completion, and then call the outbound order callback interface to change the order status to shipped. The outbound order testing process needs to pay special attention to the logistics surface label interface to ensure that the surface label image can be obtained correctly.
4. Integrity testing: After completing the above three test steps, it is recommended to perform an integrity test to simulate actual operating scenarios and test the functional integrity and stability of the entire system.