Introducing
Moshi-moshi Developer !
Kalian tau engga??? kalau SAMUDRA EXPRESS itu menyediakan berbagai macam API untuk mempermudah kalian khususnya pada Developer dalam mengakses berbagai macam informasi data loh ...
Ini merupakan salah satu bentuk komitmen kami dalam melayani para Customer khususnya bagi mereka yang ingin membuat aplikasi Desktop, Mobile, dan Website secara custom tanpa harus menggunakan platform yang sama.
Berikut ini adalah beberapa List API yang bisa kalian temukan :
- Informasi untuk melakukan Cek Tarif, Resi Kiriman dan Pricelist
Output-JSON - Pengambilan data Invoice Corporate, Pickup Order, Lokasi Gerai, dan POD
JSON - Auto Completion Destinasi & Origin
- Widget untuk Cek Resi & Tarif
embed - Fitur Corporate antara lain :
- Membuat Data Booking
- Update Data Booking
- Menghapus Data Booking
- History Data Booking
- Membuat Data Booking
- Read Data Booking
Apabila mengalami kendala dan kesulitan harap menghubungi kami melalui email ke alamat div.it@samudraexpress.co.id
Booking Resi
Fitur Booking resi adalah fitur khusus corporate yang sudah melakukan pengajuan permohonan integrasi sistem dengan Samudra Express. Untuk menggunakan fitur Booking resi ini adalah sebagai berikut :
1. Membuat Data Booking
Request API [POST]: https://global.sblog.co.id/api/booking/create/format/json/raw/?apikey={API Key Anda}
Type: raw
Value: formatted json
Example format json:
{
"userid": "UCCGB000xxx",
"up": "ANGGITA",
"name": "Coca Cola, PT",
"address": "Jakarta Barat",
"zip_code": "13910",
"telp": "083806075xxx",
"fax": ""
}
Response Output JSON:
{
"result": {
"booking_id": "UCCGB000008000xxx",
"from": {
"userid": "UCCGB000xxx",
"name": "PT. INDOPACIFIK/KJP, PT. INDOPACIFIC / KJP",
"address": "JL. TRANS KALIMANTAN, KOMP.PERSADA RAYA 3, JALUR 20, NO.20, RT.25",
"telp": "082158992xxx",
"fax": ""
},
"to": {
"up": "ANGGITA",
"name": "COCA COLA, PT",
"address": "JAKARTA TIMUR",
"zip_code": "13910",
"telp": "083806075xxx",
"fax": ""
}
},
"status": "success",
"code": "BK101",
"message": "Proses membuat booking resi berhasil"
}
Keterangan format data json:
| Parameter | Deskripsi | Value | Type | Mandatory |
|---|---|---|---|---|
| userid | User ID corporate Anda | [ID Corporate] | string(11) | Required |
| up | Nama UP untuk penerima barang | [Nama UP] | string | Optional |
| name | Nama penerima barang | [Nama] | string | Required |
| address | Alamat penerima barang | [Alamat] | string | Required |
| zip_code | Kodepos alamat | [Kodepos] | number | Optional |
| telp | Telp penerima barang | [Telp] | number | Required |
| fax | Fax penerima barang | [Fax] | number | Optional |
2. Update Data Booking:
Request API [POST]: https://global.sblog.co.id/api/booking/update/format/json/raw/?apikey={API Key Anda}
Type: raw
Value: formatted json
Example format json:
{
"booking_id": "UCBDJ00000800xxxx",
"userid": "UCBDJ000xxx",
"up": "Anggita Salikha",
"name": "Coca Cola, PT",
"address": "Jakarta Timur",
"zip_code": "13910",
"telp": "083806075xxx",
"fax": ""
}
Response Output JSON:
{
"result": {
"booking_id": "UCBDJ00000800xxxx",
"from": {
"userid": "UCBDJ000xxx",
"name": "PT. INDOPACIFIK/KJP, PT. INDOPACIFIC / KJP",
"address": "JL. TRANS KALIMANTAN, KOMP.PERSADA RAYA 3, JALUR 20, NO.20, RT.25",
"telp": "082158992xxx",
"fax": ""
},
"to": {
"up": "ANGGITA SALIKHA",
"name": "COCA COLA, PT",
"address": "JAKARTA TIMUR",
"zip_code": "13910",
"telp": "083806075xxx",
"fax": ""
}
},
"status": "success",
"code": "BK102",
"message": "Proses memperbaharui booking resi berhasil"
}
Keterangan format data json:
| Parameter | Deskripsi | Value | Type | Mandatory |
|---|---|---|---|---|
| booking_id | Booking ID Anda | [Booking ID] | string(17) | Required |
| userid | User ID corporate Anda | [ID Corporate] | string(11) | Required |
| up | Nama UP untuk penerima barang | [Nama UP] | string | Optional |
| name | Nama penerima barang | [Nama] | string | Required |
| address | Alamat penerima barang | [Alamat] | string | Required |
| zip_code | Kodepos alamat | [Kodepos] | number | Optional |
| telp | Telp penerima barang | [Telp] | number | Required |
| fax | Fax penerima barang | [Fax] | number | Optional |
3. Delete Data Booking:
Request API [POST]: https://global.sblog.co.id/api/booking/delete/format/json/raw/?apikey={API Key Anda}
Type: raw
Value: formatted json
Example format json:
{
"booking_id": "UCBDJ00000800xxxx",
"userid": "UCBDJ000xxx"
}
Response Output JSON:
{
"status": "success",
"code": "BK103",
"message": "Proses menghapus booking resi berhasil"
}
Keterangan format data json:
| Parameter | Deskripsi | Value | Type | Mandatory |
|---|---|---|---|---|
| booking_id | Booking ID Anda | [Booking ID] | string(17) | Required |
| userid | User ID corporate Anda | [ID Corporate] | string(11) | Required |
4. Histori Data Booking:
Request API [GET]: https://global.sblog.co.id/api/booking/data/{userid}/search/{page}/{itemsperpage}/?apikey={API Key Anda}&firstdate={yyyy-mm-dd}&lastdate={yyyy-mm-dd}&query={pencarian data}
Response Output JSON:
{
"results": [
{
"booking_id": "UCBDJ00000800xxxx",
"connote": null,
"up": "IBU DEWI",
"name": "MAJU MUNDUR, PT",
"address": "JL. H.TAIMAN UJUNG NO.8
TENGAH KRAMAT JATI",
"zip_code": "13910",
"telp": "083806075xxx",
"fax": "",
"created_at": "2017-09-08 21:45:14",
"updated_at": null,
"userid": "UCBDJ000xxx",
"status_delivery": "ON PROCESS",
"received_by": null,
"date_pod": null,
"detail_pod": null
}
],
"status": "success",
"code": "RS501",
"message": "Data ditemukan.",
"metadata": {
"records_total": 1,
"records_count": 1,
"number_item_first": 1,
"number_item_last": 1,
"items_per_page": 10,
"page_now": 1,
"page_total": 1
}
}
Keterangan Request:
| Parameter | Deskripsi | Value | Type | Mandatory |
|---|---|---|---|---|
| userid | User ID corporate Anda | [ID Corporate] | string(11) | Required |
| page | Nomor halaman | [Page] | integer | Required |
| itemsperpage | Total data yang ingin ditampilkan | [ItemPerPage] | integer | Required |
| firstdate | Tanggal Awal periode | [yyyy-mm-dd] | date | Required |
| lastdate | Tanggal Akhir periode | [yyyy-mm-dd] | date | Required |
| query | Data yang ingin di cari | [Query] | string | Optional |
5. Read Data Booking:
Request API [GET]: https://global.sblog.co.id/api/booking/data/read/{booking_id}/?apikey={API Key Anda}&show={lite or full}
Response Output JSON with show=full:
{
"result": {
"booking_id": "UCBDJ00000800xxxx",
"connote": null,
"status_delivery": "ON PROCESS",
"received_by": null,
"date_pod": null,
"detail_pod": null,
"created_at": "2020-09-11 13:56:28",
"updated_at": "2020-09-11 14:39:30",
"from": {
"userid": "UCBDJ000xxx",
"name": "PT. INDOPACIFIK/KJP, PT. INDOPACIFIC / KJP",
"address": "JL. TRANS KALIMANTAN, KOMP.PERSADA RAYA 3, JALUR 20, NO.20, RT.25",
"telp": "082158992xxx",
"fax": ""
},
"to": {
"up": "ANGGITA SHALIKHA",
"name": "COCA COLA, PT",
"address": "JAKARTA TIMUR",
"zip_code": "13910",
"telp": "083806075xxx",
"fax": ""
}
},
"status": "success",
"code": "RS501",
"message": "Data ditemukan."
}
Response Output JSON with show=lite:
{
"result": {
"booking_id": "UCBDJ00000800xxxx",
"connote": null,
"created_at": "2017-09-11 13:56:28",
"updated_at": "2017-09-11 14:39:30",
"from": {
"userid": "UCBDJ000xxx",
"name": "PT. INDOPACIFIK/KJP, PT. INDOPACIFIC / KJP",
"address": "JL. TRANS KALIMANTAN, KOMP.PERSADA RAYA 3, JALUR 20, NO.20, RT.25",
"telp": "082158992xxx",
"fax": ""
},
"to": {
"up": "ANGGITA SHALIKHA",
"name": "COCA COLA, PT",
"address": "JAKARTA TIMUR",
"zip_code": "13910",
"telp": "083806075xxx",
"fax": ""
}
},
"status": "success",
"code": "RS501",
"message": "Data ditemukan."
}
Keterangan Request:
| Parameter | Deskripsi | Value | Type | Mandatory |
|---|---|---|---|---|
| booking_id | Nomor Booking ID Anda | [Booking ID] | string(17) | Required |
| show | Menampilkan data. Default adalah full | [lite or full] | string | Optional |
Catatan:
Untuk aplikasi web base, agar lebih mudah kami menyarankan menggunakan type form-data sebagai berikut:
Request Create API [POST]: https://global.sblog.co.id/api/booking/update/format/json/?apikey={API Key Anda}
Request Update API [POST]: https://global.sblog.co.id/api/booking/update/format/json/?apikey={API Key Anda}
Request Delete API [POST]: https://global.sblog.co.id/api/booking/update/format/json/?apikey={API Key Anda}
Buat form input dengan attribute name="data" kemudian value sesuaikan dengan format masing - masing request yang di inginkan.
Untuk lebih jelasnya, Anda dapat menghubungi pihak IT SAMUDRA EXPRESS via email div.it@samudraexpress.co.id
Terima kasih.
Pasang Widget Cek Resi & Tarif
Samudra Express menyediakan Widget Cek Resi dan Tarif agar dapat dengan mudah di pasang di website atau blog Anda.
Anda hanya cukup meng-copy dan paste code berikut :
Light Theme
<iframe frameborder="0" height="500" scrolling="yes" src="https://samudraexpress.co.id/embed/?m=1&theme=light&footer=true" width="100%"></iframe>
Dark Theme
<iframe frameborder="0" height="500" scrolling="yes" src="https://SBL.co.id/embed/?m=1&theme=dark&footer=true" width="100%"></iframe>
Contoh Light Theme
Dark Theme
Check Data POD Kurir
API Production URL: https://api.sblog.co.id/v2/
API Tester URL: https://api.sblog.co.id/v2/test/
Check Informasi Data POD Parameter
| Parameter | Deskripsi | Value | Type data |
|---|---|---|---|
| mode | Untuk menentukan jenis API yang akan diproses | pod | string |
| connote | Menentukan data POD berdasarkan no connote | [No Connote] | integer(12) |
| prettyprint | Merapikan data json agar mudah dibaca (opsional) | true / false | boolean |
Contoh URL Data JSON
Data Origin Dan Destinasi Untuk Autocompletion API
API Production URL: https://api.sblog.co.id/v2/
API Tester URL: https://api.sblog.co.id/v2/test/
Check Data Origin Autocompletion Parameter
| Parameter | Deskripsi | Value | Type data |
|---|---|---|---|
| mode | Untuk menentukan jenis API yang akan diproses | origincompletion | string |
| term | Untuk menentukan kata kunci pencarian origin | [Nama Kota] | string |
| prettyprint | Merapikan data json agar mudah dibaca (opsional) | true / false | boolean |
Check Data Destinasi Autocompletion Parameter
| Parameter | Deskripsi | Value | Type data |
|---|---|---|---|
| mode | Untuk menentukan jenis API yang akan diproses | destinasicompletion | string |
| term | Untuk menentukan kata kunci pencarian origin | [Nama Kota / Kabupaten] | string |
| prettyprint | Merapikan data json agar mudah dibaca (opsional) | true / false | boolean |
Contoh URL Data JSON (Origin)
Contoh URL Data JSON (Destinasi)
Check Data Invoice Corporate
API Production URL: https://api.sblog.co.id/v2/
API Tester URL: https://api.sblog.co.id/v2/test/
Check Data Invoice Corporate Parameter (ID Corporate)
| Parameter | Deskripsi | Value | Type data |
|---|---|---|---|
| mode | Untuk menentukan jenis API yang akan diproses | invoice corporate | string |
| idcorporate | No ID Corporate Anda | [No ID Corporate Anda] | string(11) |
| tanggalawal | Tanggal Transaksi Awal | yyyy-MM-dd | timestamp |
| tanggalakhir | Tanggal Transaksi Akhir | yyyy-MM-dd | timestamp |
| page | Halaman | [Nomor halaman] | Integer |
| itemsperpage | Menampilkan jumlah item per halaman | [jumlah item] | integer |
| prettyprint | Merapikan data json agar mudah dibaca (opsional) | true / false | boolean |
Check Data Invoice Corporate Parameter (ID User Corporate)
| Parameter | Deskripsi | Value | Type Data |
|---|---|---|---|
| mode | Untuk menentukan jenis API yang akan diproses | invoic eusercorporate | string |
| id user corporate | No ID User Corporate Anda | [No ID User Corporate Anda] | string(11) |
| tanggalawal | Tanggal Transaksi Awal | yyyy-MM-dd | timestamp |
| tanggal akhir | Tanggal Transaksi Akhir | yyyy-MM-dd | timestamp |
| page | Halaman | [Nomor halaman] | Integer |
| itemsperpage | Menampilkan jumlah item per halaman | [jumlah item] | integer |
| prettyprint | Merapikan data json agar mudah dibaca (opsional) | true / false | boolean |
Contoh URL Data JSON (ID Corporate)
Contoh URL Data JSON (ID User Corporate)
Check Pricelist Via API
API Production URL: https://api.sblog.co.id/v2/
API Tester URL: https://api.sblog.co.id/v2/test/
Check Price List Parameter
| Parameter | Deskripsi | Value | Type data |
|---|---|---|---|
| mode | Untuk menentukan jenis API yang akan diproses | pricelist | string |
| origin | Untuk menentukan kota asal / kota origin | [Nama Kota Orign] | string |
| weight | Untuk menentukan harga sesuai berat kiriman | [berat kilo] | integer |
| page | Halaman | [Nomor halaman] | integer |
| itemsperpage | Menampilkan jumlah item per halaman | [jumlah item] | integer |
| prettyprint | Merapikan data json agar mudah dibaca (opsional) | true / false | boolean |
Contoh URL Data JSON
Check Data Detail Connote
API Production URL: https://api.sblog.co.id/v2/
API Tester URL: https://api.sblog.co.id/v2/test/
Check Data Detail Connote Parameter
| Parameter | Deskripsi | Value | Type data |
|---|---|---|---|
| mode | Untuk menentukan jenis API yang akan diproses | detailconnote | string |
| connote | Nomor Resi atau Connote Anda | [No Resi atau Connote Anda] | integer(12) |
| prettyprint | Merapikan data json agar mudah dibaca (opsional) | true / false | boolean |
Contoh URL Data JSON
Check Data Pickup Order
API Production URL: https://api.sblog.co.id/v2/
API Tester URL: https://api.sblog.co.id/v2/test/
Check Data Detail Pickup Order Paramater
| Parameter | Deskripsi | Value | Type Data |
|---|---|---|---|
| mode | Untuk menentukan jenis API yang akan diproses | detailpo | string |
| nopo | Nomor Pickup Order Anda | [No Pickup Order Anda] | string(11) |
| page | Halaman | [Nomor halaman] | integer |
| itemsperpage | Menampilkan jumlah item per halaman | [jumlah item] | integer |
| prettyprint | Merapikan data json agar mudah dibaca (opsional) | true/false | boolean |
Contoh URL Data JSON
Check Informasi Data Gerai Via API
API Production URL: https://api.sblog.co.id/v2/
API Tester URL: https://api.sblog.co.id/v2/test/
Check Informasi Data Gerai
| Parameter | Deskripsi | Value | Type Data |
|---|---|---|---|
| mode | Untuk menentukan jenis API yang akan diproses | datagerai | string |
| cabang | Untuk menentukan Gerai di Cabang tersebut | [Kode Cabang] | string (3) |
| page | Halaman | [Nomor Halaman] | integer |
| itemsperpage | Menampilkan jumlah Item per-halaman | [Jumlah Item] | integer |
| prettyprint | Merapikan data JSON agar mudah dibaca (opsional) | true/false | boolean |
Contoh URL Data JSON
\Check Status Connote (History Pengiriman)
API Production URL: https://api.sblog.co.id/v2/
API Tester URL: https://api.sblog.co.id/v2/test/
Check Status Connote Parameter
| Parameter | Deskripsi | Value | Type Data |
|---|---|---|---|
| mode | Untuk menentukan jenis API yang akan diproses | statusconnote | string |
| identifier | Menampilkan info data POD (opsional) | pod | string |
| connote | Nomor transaksi Connote pengiriman Anda | [No Connote Anda] | integer (12) |
| prettyprint | Untuk merapikan data JSON agar mudah dibaca (opsional) | true/false | boolean |
Contoh URL Data JSON
Contoh URL Data JSON + Identifier
Check Tarif Pengiriman Via API
API Production URL: https://api.sblog.co.id/v2/
API Tester URL: https://api.sblog.co.id/v2/test/
Check Tarif Pengiriman Parameter
| Parameter | Deskripsi | Value | Type Data |
|---|---|---|---|
| mode | Untuk menentukan jenis API yang diproses | tarif | string |
| origin | Nama kota asal | [Nama Kota Asal Anda] | string |
| destinasi | Nama daerah tujuan | [Nama daerah tujuan (kelurahan, kota/kabupaten)] | string |
| weight | Berat kiriman barang | [Berat kiriman barang Anda] | integer |
| prettyprint | Merapikan data JSON agar mudah dibaca (opsional) | true/false | boolean |
Contoh URL Data JSON
