---
# System prepended metadata

title: TMS - Logistics Topic
tags: [fulfillment, logistic, last-mile, partners]

---

# TMS - Logistics Topic

These are the requirements when integrating partners in the field of logistics.

:tada: Agenda
---
- [What is the type of partners to integrate?](/s)
- [Summarize **order statuses** from partners to integrate](/s/)
- [Summarize **location mapping** from partners to integrate (optional)](/s/)
- [Register Account on partner system](/s)
- [Register Webhook on partner system](/s)

:memo: Where do I start?
---

:::info
:busts_in_silhouette: Logistics Department
:::

### Step 1: What is the type of partners to integrate?

There are two type of partners
- [ ] Fulfillment
- [ ] Last-mile
- The partner is **fulfillment** type, you need to tell to *IT department* about ==what is the last-mile will be integrated with this fulfillment?== If the partner is new, please contact to partner to know all of last-mile's their already supported. You have to make sure that this fulfillment works with the last-mile integration before base on `tpl code`
- The partner is **last-mile** type, you need to tell to *IT department* about ==what is the fulfillment will be integrated with this last-mile?==

### Step 2: Summarize **order statuses** from partners to integrate

> Visit website [TMS](http://ekiwi.tmsapp.vn/auth/login), to view all delivery order status on ***Shipping*** tab

- You need to contact your partner to provide all order status will be intergrated into system.
- Perform mapping order status from partner into the system.

> :bulb: Attach all documents by excel file

### Step 3: Summarize **location mapping** from partners to integrate (optional)

- You need to contact your partner to provide all location will be mapped into system.
- Perform mapping location from partner into the system (*IT department will support*).

> :bulb: Attach all documents by excel file

### Step 4: Register Account on partner system

- Redirect to partner system
- Register an account
- Contact partner to get **API_KEY** or **TOKEN** on both environment: ***production*** and ***sandbox*** (dev/staging)
- Send all **API_KEY** or **TOKEN** to *IT department* via *Head of IT* or *Team-leader*

### Step 5: Register Webhook on partner system

- You can be received link `url webhook` from partner. Other case, if the partner require register link webhook via postman, IT department will support you.

###### tags: `logistic` `fulfillment` `last-mile` `partners`
