API

API 01 Permintaan Informasi Ketersediaan Layanan

POST {DOMAIN PLATFORM}/{END POINT REQUEST VESSEL}

Headers

Name	Type	Description
Content-Type	object	application / json

Request Body

Name	Type	Description
token	string	Token Pengaman
id_request	string	Kode Request Booking
portAsalId	number	Kode Pelabuhan Asal
portAsalName	string	Pelabuhan Asal
portTujuanId	number	Kode Pelabuhan Tujuan
portTujuanName	string	Pelabuhan Tujuan
kawasanAsalId	number	Kode Kawasan Asal
kawasanAsalName	string	Nama Kawasan Asal
kawasanTujuanId	number	Kode Kawasan Tujuan
kawasanTujuanName	string	Nama Kawasan Tujuan
npwp	string	NPWP User

200 Cake successfully retrieved.

[{
    "id_request": "aitilogBookingTest",
    "id_order": "1uz3bAUsEm",
    "include_cost": ["THC Asal", "LOLO ASAL", "FREIGHT", "LSS", "APBS", "DOK BL", "DOK FEE", "DOK FTZ"],
    "expire_date": "14-03-2021",
    "provision": "Barang tidak berbau",
    "foto_pelayaran": "https:\/\/aitilog.com\/upload\/kapal\/Greyhound_kapal_1607428122",
    "arrived_time": "15-03-2021",
    "departure_time": "14-03-2021",
    "ship_name": "Greyhound",
    "service_type": "PTP",
    "price": "6270000",
    "closing_time": "13-03-2021",
    "partner": {
        "foto_partner": "https:\/\/aitilog.com\/upload\/profile\/v5SY\/i4SXVXuLEsjs.png",
        "profile_partner": "bbb",
        "partner_naem": "CV. Pratama AMirah Sentosa",
        "rating": null
    },
    "container": {
        "container_type": "Dry Container",
        "ukuran_container": 40
    },
    "kuota": 5,
    "id_platform": "{ID_PLATFORM}"
}]

404 Could not find a cake matching this query.

{    "message": "Ain't no cake like that."}

RAW DATA EXAMPLE

{
    "token": "Wjdi4x98Jpa0Y",
    "id_request": "06d27a57-bf58-4f37-9f80-81ac2958c904",
    "portAsalId": 115,
    "portAsalName": "Batam",
    "portTujuanId": 48,
    "portTujuanName": "Tanjung Perak",
    "kawasanAsalId": null,
    "kawasanAsalName": "",
    "kawasanTujuanId": null,
    "kawasanTujuanName": "",
    "npwp": "018245894059000"
}

Referensi PORT dapat dilihat di https://esbbcext01.beacukai.go.id:8090/Port

Referensi KAWASAN dapat dilihat di https://esbbcext01.beacukai.go.id:8090/Kawasan/?id_port=ID_PORT

NLE mengintegrasikan proses pemesanan Vessel (wilayah domestik) dari beberapa platform. Oleh karena itu, platform diharapkan mengirimkan data penawaran (melalui response dari API Pencarian Vessel milik Platform) yang sesuai dengan kebutuhan NLE. Berikut adalah tabel data standar response API-01 yang diberlakukan di NLE.

API-01 Response

Name	Type
id_request	String	Kode request booking yang didapat dari API-01
order_id	String	Kode penawaran yang diberikan oleh AITI-LOG berdasarkan data kapal dan rute pelayarannya
included_cost	Array	Fasilitas yang diberikan dari biaya yang dikeluarkan
expired_date	Date	Tanggal berakhirnya penawaran
Provision	String/null	Ketentuan barang
foto_pelayaran	String	Foto Kapal
arrived_time	Date	Estimasi waktu tiba
departure_time	Date	Estimasi waktu berangkat
ship_name	String	Nama kapal
service_type	String	Jenis service kapal
Price	Numeric	Harga
closing_time	String	Waktu berakhirnya penawaran
Partner	Object
foto_partner	String	URL foto partner
profil_partner	String	URL profil partner
partner_name	String	Nama partner
Rating	Integer	Rating
Container	Object
container_type	String	Jenis container
ukuran_kontainer	Numeric	Ukuran container
kuota	Numeric	Jumlah kuota tersisa
id_platform	String	Identitas platform di NLE

API-02 Booking Vessel dari NLE

POST {DOMAIN PLATFORM}/{END POINT REQUEST VESSEL}

Headers

Name	Type	Description
Content-Type	String	application/json

Request Body

Name	Type	Description
token	string	Token
id_request	string	Kode Booking dari API-01
id_platform	string	Kode Platform dari NLE
ship_name	string	Nama Kapal
container_type	string	Jenis Container
Partner	string	Partner ekspedisi platform
service_type	string	Jenis layanan
order_id	string	Kode penawaran yang diberikan oleh PLATFORM
paid_date	number	Tanggal pembayaran Format Datetime
nama_pengirim	string	Nama pengirim
hp_pengirim	string	Nomor Telepon / HP Pengirim
alamat_pengirim	string	Alamat Pengirim
nama_penerima	string	Nama Pengirim
hp_penerima	string	Nomor Telepon / HP Penerima
alamat_penerima	string	Alamat Penerima
qty	number	Jumlah Container
deskripsi_umum_barang	string	Deskripsi barang secara umum
tanggal_stuffing	number	Tanggal bongkar muat Format Date
Npwp	string	NPWP Pengirim
Email	string	Email user (pengirim)
vessel_packing	array
id_container	number	Nomor Container berdasarkan jumlah container yang dipesan (1,2,3, dst). Berfungsi untuk menetukan packing termasuk kedalam container yang mana.
jenis_muatan	string	Jenis Muatan
deskripsi_muatan	string	Deskripsi Muatan
kemasan	string	Kemasan yang digunakan
jumlah_barang	number	Jumlah Barang
berat_muatan	string	Berat Muatan dalam Kg

200

Success or failed

Raw Data Example

{
    "token": "Wjdi4x98Jpa0Y",
    "id_request": "06d27a57-bf58-4f37-9f80-81ac2958c904",
    "id_platform": "PL016",
    "ship_name": "Greyhound",
    "container_type": "Dry Container",
    "partner": "PT. COBA COBA ",
    "service_type": "PTP",
    "order_id": "1uz3bAUsEm",
    "paid_date": "-",
    "nama_pengirim": "Anwar",
    "hp_pengirim": "089911223344",
    "alamat_pengirim": "Batam",
    "nama_penerima": "Rohman",
    "hp_penerima": "089711112222",
    "alamat_penerima": "Surabaya",
    "qty": 2,
    "deskripsi_umum_barang": "Tidak boleh mengandung bahan kimia atau bahan berbahaya lainnya.",
    "tanggal_stuffing": "2020-12-30",
    "npwp": "018245894059000",
    "email": "[e-mail]",
    "vessel_packing": [
        {  
            "id_container": 1,
            "jenis_muatan": "beras",
            "deskripsi": "mantul",
            "kemasan": "KG",
            "jumlah_barang": 9,
            "berat_muatan": "100"
        },{ 
            
            "id_container": 1,
            "jenis_muatan": "ketan",
            "deskripsi": "ketan hitam",
            "kemasan": "Karung",
            "jumlah_barang": 100,
            "berat_muatan": "250"
        },{ 
            "id_container": 2,
            "jenis_muatan": "mie",
            "deskripsi": "mie indomie",
            "kemasan": "DUS",
            "jumlah_barang": 100,
            "berat_muatan": "76"
        }
    ]
}

*** “id_offer” yang dijadikan response untuk API-01 silakan ubah menjadi “order_id” dan dikirim dari NLE dalam key “order_id” pula

*** untuk jumlah_kontainer akan dikirimkan melalui key “qty” API NLE

API-03 Update Status Pemesanan oleh Platform

PUT https://api.beacukai.go.id/V3/NLE/DomesticVesselBooking/status/?id_request=ID_REQUEST

Sample URL https://api.beacukai.go.id/V3/NLE/DomesticVesselBooking/status/?id_request=06d27a57-bf58-4f37-9f80-81ac2958c904 Sebagai sarana bagi Domestic Vessel Platform untuk mengupdate status pemesanan.

Path Parameters

Name	Type	Description
id_request	string	Kode Request Booking yang didapat dari API-01

Headers

Name	Type	Description
Content-Type	string	application / json
beacukai-api-key	string	token authentifikasi API

Request Body

Name	Type	Description
status	string	Status Booking vessel

200

Success or failed

Raw Data Example

{
    "status": "Menunggu Pembayaran"
}

API-04 Update Status Pembayaran dan Pemesanan oleh Platform

PUT https://api.beacukai.go.id/V3/NLE/DomesticVesselBooking/paidStatus/?id_request=ID_REQUEST

Sample URL https://api.beacukai.go.id/V3/NLE/DomesticVesselBooking/paidStatus/?id_request=06d27a57-bf58-4f37-9f80-81ac2958c904

Path Parameters

Name	Type	Description
id_request	string	Kode Request booking yang didapat dari API-01

Headers

Name	Type	Description
Content-Type	string	application/json
beacukai-api-key	string	token authentifikasi API

Request Body

Name	Type	Description
paid_date	number	Waktu pembayaran layanan Format Datetime
status	string	Status layanan vessel
payment_url	string	Link ke halaman pembayaran platform

200

Success or failed

Raw Data Example

{
    "paid_date": "2020-12-12 12:30:14",
    "status": "Lunas Dibayar",
    "payment_url": "https://carirute.prahu-hub.com/demo/order/payment_order/34/?UserNLE=[e-mail]&SSONLE=28a5d935dd61ecfdd3cf1d7b7d60d1fbeefad4d3"
}