# Hantar pesanan dengan Pos Malaysia

> Sambungkan Pos Malaysia (SendParcel Pro) kepada BCL, tempah penghantaran untuk setiap pesanan atau bulk, cetak waybill dalam satu PDF dan batalkan.
>
> Source: https://docs.bcl.my/ms/pos-malaysia/

Pos Malaysia menghantar pesanan anda dengan Pos Laju melalui SendParcel Pro. Sambungkan akaun SendParcel Pro anda kepada BCL untuk menempah penghantaran dari pesanan, mencetak waybill dan mengikuti status penghantaran. Pos Malaysia boleh mengambil parcel dari alamat anda.

## Sebelum anda mula

Anda memerlukan tiga perkara:

- Add-on **Courier Integration**, dari **Add-ons** → **Available Add-ons**.
- Akaun SendParcel Pro. Dalam [dashboard SendParcel](https://dashboard.pos.com.my/), pergi ke **Integration** → **Add Store** dan copy **Client ID** dan **Client Secret**.
- Nombor akaun Pos Malaysia anda. Dalam SendParcel Pro, buka menu profil di bahagian atas kanan dan pilih **Linked Account**. Copy nombor dalam lajur **Account Number**.

## Sambungkan Pos Malaysia

Buat ini sekali untuk team anda:

1. Pergi ke **Platform Setup** → **Courier Integration**.
2. Pada kad **Pos Malaysia**, klik **Connect**. Jika Pos Malaysia sudah disediakan, butang itu memaparkan **Manage**. Panel sisi dibuka.

   *(Screenshot: Kad Pos Malaysia pada page Courier Integration dengan butang ditanda)*

3. Di bawah **API Credentials**, on-kan **Enable Pos Malaysia**.
4. Paste **Client ID** dan **Client Secret** anda. Klik **Verify Connection** untuk menyemaknya sebelum anda simpan.

   *(Screenshot: Kotak API Credentials dengan Enable Pos Malaysia on, Client ID dan Client Secret)*

5. Di bawah **Parcel Settings**, pilih apa yang **Item Description** cetak pada consignment note: **Item Name** atau **SKU**. Untuk **SKU**, tetapkan SKU pada setiap item dahulu.

   *(Screenshot: Parcel Settings dengan Item Description dalam panel Pos Malaysia)*

6. Di bawah **Shipping Settings**, paste **Account Number** anda. Pilih **Default Item Type**: **Document**, **Merchandise** atau **Parcel**.
7. Isi **Sender Information**: nama, telefon, e-mel dan alamat pickup anda. Jika kurier lain sudah disediakan, **Copy from** dengan namanya mengisi butiran yang sama.

   *(Screenshot: Kotak Sender Information dalam panel Pos Malaysia)*

8. Di bawah **Pickup Settings**, on-kan **Pickup Required** jika Pos Malaysia perlu mengambil parcel dari alamat anda. Kemudian pilih **Pickup Start Time** dan **Pickup End Time**.
9. Klik **Save Pos Malaysia**.

BCL memaparkan **Pos Malaysia saved**. Suis pada kad boleh on-kan atau off-kan Pos Malaysia kemudian tanpa membuka panel.

## Cipta penghantaran

Pesanan itu mesti sudah dibayar (atau COD) dan ada item dengan berat. Ia juga mesti ada alamat penghantaran penuh di Malaysia, dengan nombor telefon pembeli. Pos Malaysia menerima parcel sehingga 30 kg. Untuk setiap pesanan:

1. Pergi ke **Transactions** dan cari pesanan itu.
2. Klik ikon lori (**Courier**) pada baris itu, kemudian **Pos Malaysia**. Panel memaparkan pesanan, alamat penghantaran dan jumlah berat.
3. Pastikan alamat dan berat itu betul.
4. Klik **Create Shipment**.

BCL memaparkan **Shipment created** dengan nombor tracking. Kadang-kadang nombor tracking mengambil masa beberapa minit untuk sampai. Untuk pesanan COD, Pos Malaysia mengutip jumlah pesanan daripada pembeli.

### Apabila Pos Malaysia menolak pesanan

Jika pesanan itu belum sedia, panel memaparkan **Shipment Unavailable** dengan sebabnya. Contohnya:

- Pesanan itu tiada nombor telefon pembeli.
- Poskod kosong atau bukan poskod Malaysia.
- Item tiada berat, atau parcel itu lebih daripada 30 kg.
- Alamat penghantaran bukan di Malaysia.

Betulkan pesanan itu, kemudian cuba lagi. Jika Pos Malaysia menolak tempahan itu, BCL memaparkan **Shipment Creation Failed** dengan sebab daripada Pos Malaysia. Mesej ini kekal pada skrin sehingga anda menutupnya dengan **X**.

## Cipta penghantaran secara bulk

Untuk menghantar banyak pesanan sekali gus:

1. Dalam **Transactions**, tandakan pesanan itu.
2. Buka **Shipping** dalam bulk actions dan pilih **Bulk Pos Malaysia**.
3. Dalam **Bulk Create Pos Malaysia Shipments**, klik **Create Shipments**.

BCL menempah setiap pesanan yang sudah sedia. Bar kemajuan dipaparkan di bahagian atas page. Apabila penghantaran selesai, BCL menghantar notifikasi dengan bilangan pesanan yang ditempah. Notifikasi itu juga menyenaraikan setiap pesanan yang tidak dihantar, dengan sebabnya. Klik **Print all labels** dalam notifikasi itu untuk mencetak waybill.

## Cetak waybill

Untuk satu pesanan, klik butang penghantaran hijau dengan logo Pos Malaysia pada pesanan itu. Klik **View Airway Bill** untuk membuka label dalam tab baru, dan cetak.

Untuk mencetak banyak label dalam satu PDF:

1. Dalam **Transactions**, tandakan pesanan itu.
2. Buka **Shipping** dalam bulk actions. Di bahagian **Pos Malaysia** dalam menu itu, pilih **Bulk Print Airway Bill**.
3. Dalam **Bulk Print Pos Malaysia Airway Bills**, biarkan pesanan yang anda mahu ditanda. Klik **Skipped** untuk melihat pesanan yang BCL langkau, dan sebabnya.
4. Klik **Print** dengan bilangan label, contohnya **Print 5 labels**.

PDF itu dibuka dalam tab baru. Ia memuatkan sehingga 100 label. BCL melangkau pesanan tanpa penghantaran, dengan penghantaran yang dibatalkan, atau tanpa waybill.

## Ikuti status penghantaran

BCL menyemak status baru dari Pos Malaysia dengan sendiri. Untuk menyemak sekarang, buka penghantaran itu dan klik **Refresh Status**. Anda boleh refresh semula selepas satu minit. **Track Shipment** membuka page tracking Pos Malaysia. Status itu ialah:

| Status | Maksudnya |
|---|---|
| **Picked up** | Pos Malaysia sudah ambil parcel itu. |
| **In transit** | Parcel itu dalam perjalanan. |
| **Out for delivery** | Parcel itu dihantar kepada pembeli hari ini. |
| **Delivered** | Pembeli sudah terima parcel itu. |
| **Delivery failed** | Pos Malaysia tidak dapat menghantarnya. Semak dengan Pos Malaysia. |
| **Returned** | Parcel itu dipulangkan kepada anda. |

## Batalkan penghantaran

Anda boleh membatalkan penghantaran sebelum Pos Malaysia mengambil parcel itu:

1. Buka penghantaran itu dan klik **Cancel Shipment**.
2. Klik **Yes, cancel shipment**.

Pos Malaysia membatalkan tempahan itu. Buang waybill yang anda sudah cetak untuknya. Anda boleh mencipta penghantaran baru untuk pesanan itu kemudian.

Jika **Cancel Shipment** tidak dipaparkan, Pos Malaysia sudah ambil parcel itu, atau Pos Malaysia tidak membenarkan BCL membatalkan untuk akaun anda. Batalkan dalam SendParcel Pro, atau hubungi Pos Malaysia.

## Isu biasa

### Bagaimana saya sambungkan Pos Malaysia kepada BCL?

Dalam dashboard SendParcel, pergi ke Integration → Add Store dan copy Client ID dan Client Secret.

Dalam BCL, pergi ke Platform Setup → Courier Integration dan klik Connect pada kad Pos Malaysia. On-kan Enable Pos Malaysia, paste Client ID dan Client Secret, isi Account Number dan Sender Information anda, dan klik Save Pos Malaysia.

### Kenapa Pos Malaysia memaparkan Shipment Unavailable?

Pesanan itu belum sedia untuk Pos Malaysia. Mesej itu memberitahu sebabnya. Contohnya, pesanan itu tiada nombor telefon pembeli, tiada poskod Malaysia yang sah atau tiada berat, atau beratnya lebih daripada 30 kg. Betulkan pesanan itu, kemudian buka panel Pos Malaysia semula.

### Di mana saya boleh dapatkan Account Number Pos Malaysia saya?

Dalam SendParcel Pro, buka menu profil di bahagian atas kanan dan pilih Linked Account. Copy nombor dalam lajur Account Number. Paste nombor itu di bawah Shipping Settings dalam panel Pos Malaysia dalam BCL.

### Bagaimana saya batalkan penghantaran Pos Malaysia?

Buka penghantaran itu dalam Transactions dan klik Cancel Shipment, kemudian Yes, cancel shipment. Anda hanya boleh membatalkannya sebelum Pos Malaysia mengambil parcel itu. Jika Cancel Shipment tidak dipaparkan, batalkan dalam SendParcel Pro atau hubungi Pos Malaysia.