v1.0.0Terakhir Diperbarui: Juni 2026
GET

Get Order Status by Phone Number

Mengambil status pesanan terakhir pelanggan berdasarkan nomor handphone. Endpoint ini juga mengembalikan informasi singkat transaksi beserta tautan manifes URL invoice PDF.

Endpoint URL

/api/integrasi/orders/latest-status

Query Parameters

ParameterTypeDescription
no_hp *String Nomor handphone pelanggan (Format: 08xx, 62xx, +62xx). Sistem otomatis melakukan normalisasi nomor ke format internasional (+62xxxxxxxxxx).
💡 Aturan Bisnis Pemilihan Order
  1. Sistem mencari pelanggan berdasarkan nomor handphone (no_hp dan no_hp_goovi).
  2. Nomor handphone akan dinormalisasi secara otomatis ke format internasional (+62xxxxxxxxxx).
  3. Apabila terdapat lebih dari satu pelanggan dengan nomor handphone yang sama, sistem akan memilih pelanggan berdasarkan prioritas:
    • Jumlah transaksi terbanyak dalam 30 hari terakhir.
    • Tanggal transaksi terakhir paling baru.
    • Data pelanggan yang dibuat paling baru.
  4. Endpoint hanya mengembalikan data pesanan terakhir milik satu pelanggan terpilih.
  5. Detail lengkap tersedia via Invoice PDF.
Example Request
GET /api/integrasi/orders/latest-status?no_hp=6281521979154 
Host: api-tokoordert5v8c1w7b2k3.satriamitra.website
X-API-Client: MEKARI
X-API-Key: xxxxxxxxxxxxxxxxxxxxxxxxxx
Accept: application/json
Success Response
200 OK
{
  "success": true,
  "message": "Status pesanan berhasil ditemukan.",
  "data": {
    "status": "Dikirim",
    "status_code": "shipping",
    "status_message": "Pesanan Anda yang dibuat pada 06 Juni 2026 telah dikirim dan sedang dalam perjalanan menuju alamat tujuan.",
    "last_order": {
      "kode_pesanan": "ORD-20260606-0001-f80ea6",
      "tanggal_order": "2026-06-06 09:03:39",
      "total_harga": 51000,
      "status_pembayaran": "Pending",
      "metode_pembayaran": "Cash"
    },
    "customer": {
      "kode": "PEL-mbre36zt-Z7K52",
      "nama": "Winda WINNNN"
    },
    "sales": {
      "nama": "Budi Santoso",
      "no_hp": "+6281521979154"
    },
    "invoice": {
      "kode_pesanan": "ORD-20260606-0001-f80ea6",
      "url": "https://api-tokoordert5v8c1w7b2k3.satriamitra.website/api/integrasi/orders/ORD-20260606-0001-f80ea6/invoice"
    }
  }
}
Not Found
404
{
  "success": false,
  "message": "Pesanan tidak ditemukan."
}
Validation Error
422
{
  "success": false,
  "message": "Validasi gagal.",
  "errors": {
    "no_hp": [
      "The no hp field is required."
    ]
  }
}
Unauthorized
401
{
  "success": false,
  "message": "Unauthorized."
}
GET

Download Invoice PDF

Endpoint ini menyediakan berkas cetak lembar invoice pesanan langsung dalam bentuk format dokumen PDF asli (application/pdf).

Endpoint URL

/api/integrasi/orders/{kode_pesanan}/invoice
🔒 Aturan Akses File
  1. Invoice dapat diakses menggunakan nilai variabel invoice.url yang diperoleh dari objek properti data di dalam Success Response (200 OK) pada endpoint status di atas.
  2. URL invoice hanya dapat diunduh menggunakan header autentikasi valid yang dikirimkan bersamaan saat request, yaitu X-API-Client & X-API-Key.
Example Invoice Request
GET /api/integrasi/orders/ORD-20260606-0001-f80ea6/invoice
Host: api-tokoordert5v8c1w7b2k3.satriamitra.website
X-API-Client: MEKARI
X-API-Key: xxxxxxxxxxxxxxxxxxxxxxxxx
Accept: application/pdf
Success Response
200 OK
Response berupa berkas binary stream (application/pdf).
Invoice Not Found
404
{
  "success": false,
  "message": "Pesanan tidak ditemukan."
}
Unauthorized
401
{
  "success": false,
  "message": "Unauthorized."
}