Lazada additional feature Seller own Fleet (SOF)
General overview of the module
As this looks like a separate module for the open API of Lazada it has it's own Authentication. The module consist of only 2 calls.
-
Authenticate
-
SendUpdateOrderStatus
It is only used to update the status of the order when the Seller is fulfilling orders through their own means.
Documentation can be found HERE
New documentation ca be found HERE
New endpoints have been provided. We received confirmation that the requests themselves won't change.
- Instead of sofp.lazada.sg/api/ it is now sofp-sg.lel.asia/api/
- Authentication – sofp-sg.lel.asia/api/auth
- Update status – sofp-sg.lel.asia/api/statuses new endpoint: https://sofp-sg.lel.asia/api/statuses/
SOFP credentials:
SOF Weblink: https://sofp-sg.lel.asia/login/
SOF username: angel.sveshtnikov@wearepentagon.com
SOF password: password123
In order for all of this to work we would need to download invoices as well.
In the documentation there is a GetDocument call Documentation
After the explanation for SOF I am adding below the sections for GetDocument - Invoice
Authentication - specifics
Authenticate it doesn't seem to be something complicated. Will provide username and password
We need to add 'JWT' in front of the token.
Status flows - specifics
In order for us to be able to work with this functionality we have to:
1. Add an additional delivery_type
Add type "sof" when selected we have to be using this specific module integration.
When this method is used we have to be able to provide username and password.
2. Update to status Shipped
This has to be done using the call: SendUpdateOrderStatus
To mark the order as shipped and update it with tracking number we need to use this call: SetOrderReadyToShip
The scenario will be like every other standard integration we have. When update_shipping = 1 and tool_status = ready_for_delivery we should be sending the Shipped status to the marketplace.
3. Download tracking number
As the marketplace will be generating their own tracking number which we need to use to continue with the next step we need to be downloading the tracking numbers using the call GetOrderItems.
3. Update to status Delivered
We need to have some sort of flag that is specific for this operation. We should be able to use automated import to manage that field.
We need to be able to mark an order as Delivered please advise what should be the best approach. Is it going to be an additional table order_lazada?
4. Update to status Not_delivered
We need to have some sort of flag that is specific for this operation. We should be able to use automated import to manage that field.
In table account.lazada we would like to have the option to specify if we want to send automatically Not Delivered.
We need to be able to mark an order as Not_delivered please advise what should be the best approach. Is it going to be an additional table order_lazada?
Authentication for GetDocuments - specifics
We need to use the standard way of Authenticate.
Documents - specifics
| Parameters | Type | Required | Value | Description |
|---|---|---|---|---|
| doc_type | String | true | invoice | Document types, including 'invoice', 'shippingLabel', or 'carrierManifest'. Mandatory. |
| order_item_ids | String | true | [279709, 279709] | Max List Size: 100 Identifier of the order item for which the caller wants to get a document. Mandatory. |
We need to be using the invoice value for the parameters and we need to be storing the data in the database.
We need the file in a PDF format in a folder on an FTP. The credentials for the FTP have been already shared.
Other - specifics
Outstanding questions
Things to finalise
Invoices naming convention when creating the files on the FTP.
Run through marketplace_manifests table, what is written there and how it works.
Cron jobs timing
DHL integration for statuses.