Pickup Request

Endpoint super kami, gunakan data se valid mungkin untuk menghindari koreksi dari sistem kami

SDK Method

KiriminAja::requestPickup(RequestPickupData $data);

Request Section

FieldDataTypeNullableDesc
addressstring(max:200)falseAlamat lengkap
phonestring(max:15)falseNomor telepon menggunakan format angka 0
namestring(max:50)falseNama pengirim paket
zipcodestring(max:5)trueKode pos pengirim
kecamatan_idintegerfalseKecamatan id pengirim
packagesarray(min:1 object)falseLihat penyusunan list paket berikut
schedulestringfalseLihat bagian #Pickup Schedules
platform_namestringtrueNama aplikasi anda ketika menerima notifikasi, secara default adalah mitra

Packages Section

FieldDataTypeNullableDesc
order_idstring(max:20)falseOrder ID, harus memiliki prefix berupa string
destination_namestring(max:50)falseNama penerima
destination_phonestring(max:15)falseNomor telepon diawali dengan angka 0
destination_addressstring(max:200,min:10)falseAlamat penerima, kami menggunakan minimal 10 karakter untuk menghindari Bad Address pickup
destination_kecamatan_idintfalseKecamatan penerima
weightint(min:1)falseBerat paket dalam gram
widthint(min:1)falsecm
lengthint(min:1)falsecm
qtyinttrueJumlah barang dalam paket, akan terisi 1 jika kosong
heightint(min:1)falsecm
item_valueintfalseNilai barang secara keseluruhan
shipping_costintfalseBiaya pengiriman, see # Shipping Price section
servicestringfalseLihat shipping price untuk ini
insurance_amountnumerictrueLihat Syarat & Ketentuan
service_typestringfalseThe service type, like EZ, REG, CTC, OKE, etc (see shipping price section)
codintfalseCOD PRICE NB : Isi 0 untuk paket non COD
package_type_idintfalseTipe paket tersedia untuk sementara 1
item_namestring(max:255)falseIsi paket
dropbooltrueDROP-OFF / CASHLESS
notestring(max:50)trueSpecial instructions

Package Insurance & COD NB

Nilai add_cost dan insurance_amount dihitung berdasarkan kesepakatan sebelum proses integrasi API dengan kami.

Untuk mempercepat request pickup, kami hanya melakukan pengecekan ulang biaya pengiriman barang ketika divalidasi oleh driver, bukan melalui API.

COD Fee Calculation

ParamAmount
item_value20000
shipping_cost15000
insurance_amount500
cod_fee (from T&A)Lihat Syarat & Ketentuan
--------+++++++
total35500
add_costtotal * cod_fee and rounded up to 1 (ex : 1000,27 to 1001)
codtotal + cod_fee

Insurance Amount Calculation

ParamAmount
item_value20000
percentage (from T&A)tergantung ekspedisi (Lihat Syarat & Ketentuan)
--------*******
insurance_amountitem_value * percentage and rounded up to 100

Request Sample

{
    "address" : "Jl. Jodipati No.29 Perum Taman Kencana Sejahtera",
    "phone" : "0813334546789",
    "kecamatan_id" : 5784,
    "packages" : [
        {
          "order_id": "DEV-000000018",
          "destination_name": "Flag Test",
          "destination_phone": "082223323333",
          "destination_address": "Jl. Magelang KM 11",
          "destination_kecamatan_id": 419,
          "destination_zipcode": 55598,
          "weight": 520,
          "width": 8,
          "height": 8,
          "length": 8,
          "item_value": 275000,
          "shipping_cost": 65000,
          "service": "sicepat",
          "service_type": "SIUNT",
          "item_name": "TEST Item name",
          "package_type_id": 1,
          "cod": 100000
        }

    ],
    "name" : "Tokotries",
    "zipcode" : "55598",
    "schedule" : "2021-11-30 22:00:00"
}

Response

{
    "status": true,
    "text": "Request pickup berhasil",
    "method": "request_pickup",
    "payment_status": "paid",
    "details": [
        {
            "order_id": "DEV-000000018",
            "kj_order_id": "DEV-000000018",
            "awb": null,
            "service": "SICEPAT",
            "service_type": "SIUNT"
        }
    ],
    "pickup_number": "XID-7850941654"
}
Response Explanation
ParamDataTypeRemark
payment_statusEnumpending, paid
detailsArray of ObjectPickup request packages list
pickup_numberStringPickup Number / Payment ID
Sebelumnya
Schedules
Berikutnya
Payment QRIS
© 2022 - 2023 PT Selalu Siap Solusi, All Right Reserved