ODE

Formulir Masuk Delivery Order — Trial

Operasional Driver Ekspedisi · intake manual, import scan, dan kontrak API

Form v1.0 0 DO tersimpan Data lokal (browser)

A · Inti DO — dikonsumsi ODE hari ini

Enam field di bawah ini adalah satu-satunya yang saat ini dibaca aplikasi ODE (tabel delivery_order). Field bertanda * wajib.

Nomor DO *

Unik. Ini kunci idempotensi ingestion.

Status awal *

Sumber *

ID sumber eksternal Opsional, untuk rekonsiliasi ke sistem pembuat DO.

Driver ref *

ID stabil driver, bukan nama tampilan.

Vehicle ref / nopol *

Harus ada di master kendaraan agar CP1 lolos.

Customer ref *

B · Master driver & kendaraan

Dipakai untuk login driver, validasi nopol (CP1), dan tampilan. Bentuknya mengikuti kontrak company-master-sync.

Nama driver *

Telepon driver *

Jenis kendaraan

Tipe kendaraan

Kapasitas (kg)

Nomor lambung / armada

C · Customer & rute

Koordinat + radius dipakai untuk uji geofence CP3/CP6. Default radius 150 m (usulan ODE-OD-004).

Nama customer *

PIC customer

Telepon customer

Alamat customer

Titik jemput / muat (origin)

Nama lokasi *

Tipe

Latitude *

Longitude *

Radius (m)

Alamat

Titik antar / bongkar (destination)

Nama lokasi *

Tipe

Latitude *

Longitude *

Radius (m)

Alamat

D · Muatan

Deskripsi muatan *

Jenis

Jumlah koli

Berat (kg) *

Volume (m³)

Nilai barang (Rp)

Nomor segel

Catatan penanganan

E · Jadwal & uang jalan

Tanggal terbit DO

Window muat — dari

Window muat — sampai

Window antar — sampai

Metode uang jalan

Total uang jalan (Rp)

BBM

Tol

Parkir

F · Dokumen & catatan

Surat jalan Invoice Packing list Izin khusus

Catatan operasional

Daftar DO tersimpan

Tersimpan di localStorage browser ini. Export untuk dipakai sebagai payload ingestion.

Total

Assigned

Ready

Total kg

Nomor DO	Status	Driver	Kendaraan	Customer	Muatan	Aksi

Belum ada DO. Tambahkan lewat tab Entri DO.

Import dari PDF / hasil scan

Tahap trial: unggah dokumen → periksa → isi form di samping. OCR otomatis belum aktif; teks hasil scan bisa ditempel untuk ekstraksi awal.

Klik atau taruh file di sini
PDF, JPG, atau PNG · maks 10 MB

Teks dokumen (tempel dari PDF / hasil OCR)

Alur yang disarankan

Unggah PDF/scan surat jalan.
Ekstrak teks (tempel) → field terisi otomatis bila polanya dikenali.
Verifikasi manual — OCR tidak boleh jadi sumber kebenaran.
Simpan → DO masuk daftar, siap diexport/ingest.
Simpan hash dokumen (ditampilkan di atas) sebagai bukti asal.

Yang bisa diekstrak otomatis

Nomor DO, tanggal, nopol, telepon, berat, jumlah koli. Nama/alamat tetap manual karena format surat jalan tiap perusahaan berbeda.

Kalau nanti mau OCR penuh

Butuh service OCR (Tesseract/PaddleOCR) + antrean + layar konfirmasi. Jangan auto-commit ke DB tanpa persetujuan manusia — satu salah baca nopol bisa menggagalkan CP1.

Import CSV / JSON

Untuk memasukkan banyak DO sekaligus. Format CSV memakai header yang sama dengan template.

Klik atau taruh file CSV / JSON
Baris dengan nomor DO duplikat akan dilewati

Kolom wajib

doNumber, status, origin, driverRef, vehicleRef, customerRef,
driverName, driverPhone, customerName, cargoDescription, cargoWeightKg,
originName, originLat, originLng, destName, destLat, destLng

Kolom lain opsional dan akan diisi kosong bila tidak ada.

Kontrak ingestion yang diusulkan

ODE saat ini read-only untuk DO: belum ada endpoint pembuat DO. Kontrak di bawah adalah usulan agar tiga jalur (entry, scan, API) memakai bentuk data yang sama.

POST /v1/admin/delivery-orders
Authorization: Bearer <staff-token>
Idempotency-Key: <uuid>
Content-Type: application/json

{
  "doNumber": "DO-2026-10-0001",
  "status": "ASSIGNED",
  "origin": "company_sync",
  "externalSourceId": "ERP-778812",
  "driverRef": "DRV-001",
  "vehicleRef": "B 9012 XYZ",
  "customerRef": "CUST-001",
  "master": {
    "driver":  { "name": "...", "phone": "...", "vehicleRegistrationNumber": "B 9012 XYZ", "vehicleType": "CDD Long" },
    "vehicle": { "registrationNumber": "B 9012 XYZ", "type": "CDD Long" },
    "customer":{ "name": "...", "phone": "...", "address": "..." },
    "locations": [
      { "locationId": "LOC-POOL-01", "name": "Pool Cakung", "type": "loading",
        "latitude": -6.1823, "longitude": 106.9437, "geofenceRadiusOverride": 150 }
    ]
  },
  "operational": { "...": "lihat tab Panduan Field" }
}

Respons yang diharapkan: 201 Created atau 200 OK dengan replayed: true bila Idempotency-Key sama. Duplikat doNumber → 409 CONFLICT.

Tiga jalur masuk

Jalur	Cocok untuk	Status hari ini	Yang perlu dibangun
Entri manual	Volume rendah, koreksi cepat, trial	belum ada di ODE	Form ini + endpoint create
Import PDF/scan	DO dari pihak lain / arsip kertas	belum ada	Upload + OCR + layar konfirmasi
API ke aplikasi pembuat DO	Volume tinggi, sumber otoritatif	kontrak belum beku (ODE-OD-008)	Adapter + mapping + rekonsiliasi

Urutan yang saya sarankan: API dulu untuk jangka panjang, tapi form ini dulu supaya trial bisa jalan minggu ini tanpa menunggu kontrak.

Jalur sementara tanpa endpoint baru

Untuk trial, DO bisa dimasukkan server-side (di luar API) memakai upsert idempoten pada delivery_order. Tidak menambah permukaan API publik.

INSERT INTO delivery_order (do_number, status, driver_ref, vehicle_ref, customer_ref, origin, revision)
VALUES ('DO-TRIAL-0001','ASSIGNED','DRV-001','B 9012 XYZ','CUST-001','internal',1)
ON CONFLICT (do_number) DO UPDATE
  SET status = EXCLUDED.status,
      driver_ref = EXCLUDED.driver_ref,
      vehicle_ref = EXCLUDED.vehicle_ref,
      customer_ref = EXCLUDED.customer_ref,
      revision = delivery_order.revision + 1,
      updated_at = now();

Catatan: master kendaraan (vehicle_master_projection) juga harus diisi, kalau tidak validasi nopol CP1 akan menolak semua plat.

Panduan field

Field	Dipakai ODE?	Kenapa perlu
doNumber	ya	Identitas DO + kunci idempotensi
status	ya	Menentukan DO muncul & bisa dipilih driver
origin	ya	Membedakan DO internal vs sync perusahaan
driverRef	ya	Filter DO per driver di perangkat
vehicleRef	ya	Dicocokkan saat driver input nopol (CP1)
customerRef	ya	Referensi customer untuk laporan & filter
Driver name/phone	belum	Untuk login & tampilan; butuh master driver
Customer name/address	belum	Butuh master customer (REQ-052)
Lokasi + lat/lng + radius	belum	Uji geofence CP3/CP6 (REQ-053/064)
Muatan & berat	belum	Konteks operasional, laporan, uji beban
Uang jalan	belum	Gate CP sebelum progres (REQ-011/071)
Window jadwal	belum	Uji keterlambatan & laporan
Dokumen	belum	Checklist CP4 (surat jalan, invoice, packing list)

Kolom “belum” tetap disimpan di form supaya trial terasa realistis dan supaya bentuk datanya sudah siap saat kontrak upstream dibekukan.

Siklus status DO

ASSIGNED → READY → ACTIVE → OPERATIONALLY_FINISHED → PENDING_SYNC → COMPLETION_PENDING → COMPLETE

Hanya server yang boleh menetapkan COMPLETE. Perangkat berhenti di OPERATIONALLY_FINISHED.

Checkpoint CP1–CP7

CP1	Vehicle Pickup — validasi nopol
CP2	Departure — mulai tracking
CP3	Loading Arrival — geofence
CP4	Loading Process — foto sebelum/proses/sesudah + dokumen
CP5	Start Delivery
CP6	Unloading Arrival — geofence
CP7	Unloading Process — bukti serah terima