Send Shipping Provider Pickup Request

Objective

As a Venture, I want to enable sellers to send a pickup request to shipping providers. This request notifies shipping providers to collect “Ready to Ship” orders from the seller’s warehouse.

Critical KnowledgeIf you want to enable the feature, please raise a TMLSD ticket. The parameter that needs to be enabled is pickup_request/enabled
Critical KnowledgeThe carrier should have integration with the Shop system. After seller clicks “send pickup request” Seller Center sends an API call to OMS createPickupRequest https://wiki.jira.rocket-internet.de/display/TML/SellerCenter+OMS+API#SellerCenterOMSAPI-createPickupRequest with the list of order item IDs. Then the shop should pass it to the carrier. The possible validation is also on the Shop side.

Admin Settings

Step Description Image
1 Navigate to Administration > Settings > Settings. Switch to the “Shipment Provider” tab.  
2 Tick the “Enable pickup request” checkbox of the desired shipping provider. Then, click Save. In this example, we enable pickup request on DHL.
3

Navigate to Administration > Settings > Content Management > Order Overview Setup. Find “Pickup Request Sent”  column under the “Available”. Move it to the “Selected” column by clicking the button “→” if you wish for it to be displayed in the order management screen.

Please read this article to find out more about order management table customisation.

 

Seller Experience

Step Description Image
2

When Seller is at Orders > Manage Orders he should switch to the “Ready to Ship” tab.

Seller selects all the orders that he would like to be picked up by an integrated shipping provider. Afterwards, he should select “Send pickup request” mass action and click “Go”.

3

A popup box, which is depicted in the “Image” column, will appear. Seller clicks “Send pickup request”.

Seller clicks “Send pickup request” and sees a confirmation message.

Then, the API “createPickupRequest” is triggered to the Shop and the Shop, in return, should notify the shipping provider.

4 If you attempt to send pickup request for orders in which their shipping provider is not pickup request enabled, a warning message will be displayed. 
5 If Seller attempts to send pickup request for orders that are fulfilled by not integrated shipping providers then he will be notified that those orders will be disregarded. Pickup request will only be sent for the relevant orders.
6 Every time a pickup request is sent successfully, the “Pickup Request Sent” column for the corresponding order is ticked.
7 API integrated sellers should use createPickupRequest call.