Cara Membuat Model Template

Setelah file berhasil diimpor ke dalam sistem, data akan langsung diproses. Namun, karena tiap distributor bisa menggunakan sistem eksternal dengan format Excel yang berbeda-beda—baik dari segi struktur maupun nama kolom—sistem perlu solusi yang fleksibel. Tentunya, portal tidak bisa membatasi pengguna dengan format file tertentu seperti pada SAP atau DMS karena hal itu akan menyulitkan proses integrasi.

Begitu pula saat pengguna ingin mengekspor data: mereka harus bisa menentukan sendiri format Excel yang dibutuhkan, terutama jika data tersebut akan digunakan di sistem lain.

Sebagai solusinya, portal menghadirkan fitur ModelMapper atau ModelTemplate. Fitur ini bisa diakses melalui menu Model Templates.

Cara Membuat Model Template Baru

Step 1. Buka menu Model Templates.

Step 2. Pilih Add New Model Template.

Step 3. Isi data mengenai model template baru yang akan dibuat seperti :

• Integrasi

• Module

• Metode

• Json Format

• Response Keys

Beberapa hal penting yang perlu diperhatikan saat membuat Model Template:

1. Field yang ditandai dengan tanda * wajib diisi.

2. Distributor harus sudah memiliki minimal satu integrasi aktif sebelum dapat membuat template.

3. Model Template dibedakan berdasarkan kombinasi Integration, Module, dan Method. Sistem tidak mengizinkan pembuatan template dengan kombinasi yang sama lebih dari satu kali.

4. Setiap integrasi (aplikasi) memiliki Model Template-nya sendiri, meskipun modul dan metodenya sama.

   • Contoh: Jika integrasi DMS sudah memiliki template untuk SalesOrder-Export, maka integrasi lain seperti External harus membuat template SalesOrder-Export-nya sendiri.

5. Setelah template dibuat, nilai Integration, Module, dan Method tidak bisa diubah untuk mencegah duplikasi.

6. Response Keys selalu diisi dengan:

   jsonSalinEdit{"MappingResultType":"List","RootProperty":"data"}

7. Cara membuat format JSON klik disini.

---

Mengelola Template yang Sudah Dibuat

• Untuk mengedit JSON pada template yang sudah ada, pengguna bisa klik ikon edit/pensil pada daftar Model Template.

  

  Tombol Edit Model Template

  

  Edit Model Template
• Untuk melihat detail lengkap sebuah template, cukup klik barisnya di daftar template.

  

  Daftar Model Template

  

  Detail Model Template

• Untuk menghapus model template yang sudah dibuat, dapat dilakukan dari beberapa laman yaitu:

  • Delete dari Daftar Model Template

    

  • Delete dari Detail Model Template

    

Cara Membuat Model Template (JsonFormat)

1. SalesOrder(Item)

Berikut adalah tabel penjelasan property SalesOrder(Item) yang dibutuhkan dan dapat digunakan pada saat membuat Model Template.

Nama Property	Tipe Data	Penjelasan	Dibutuhkan/Wajib
OriginId	STRING	Id dari data. Jika tidak ada id, maka dapat menggabungkan beberapa data pada excel sehingga unik.	YA
OrderNo	STRING	Nomor pesanan penjualan	YA
OrderDate	Date	Tanggal pesanan penjualan	YA
Status	STRING	Status pesanan penjualan	YA
CustomerId	STRING	Id Pelanggan	YA
CustomerCode	STRING	Kode pelanggan	YA
CustomerName	STRING	Nama pelanggan	YA
ProductCode	STRING	Kode produk	YA
ProductName	STRING	Nama produk	YA
Price	FLOAT	Harga produk	YA
TotalQuantity	FLOAT	Total kuantitas	YA
LineTotal	FLOAT	Total penjualan	YA
SupplierId	STRING	Id Supplier (tidak perlu di excel, hanya modelmapper saja). Dapat dilihat di contoh.	YA
DailyVisitItemId	STRING	Id DailyVisit untuk menandakan bahwa pesanan penjualan ini efective call atau tidak	TIDAK
CustomerLatitude	STRING	Latitude lokasi pelanggan	TIDAK
CustomerLongitude	STRING	Longitude lokasi pelanggan	TIDAK
Channel	STRING	Nama channel pelanggan	TIDAK
City	STRING	Kota	TIDAK
District	STRING	Kecamatan	TIDAK
Province	STRING	Provinsi	TIDAK
QuantityL	FLOAT	Kuantitas L	TIDAK
QuantityM	FLOAT	Kuantitas M	TIDAK
QuantityS	FLOAT	Kuantitas S	TIDAK
UnitL	STRING	Nama satuan L	TIDAK
UnitM	STRING	Nama satuan M	TIDAK
UnitS	STRING	Nama satuan S	TIDAK
DiscountItem	FLOAT	Diskon item (nominal)	TIDAK
DiscountOrder	FLOAT	Diskon order (nominal)	TIDAK
Tax	FLOAT	Pajak (nominal)	TIDAK

📌 ModelMapper Import (SalesOrder)

Pada proses import menggunakan ModelMapper, kolom di sebelah kiri menunjukkan nama property pada sistem portal (konsolidasi data), sedangkan bagian kanan dengan format $.data[#]. mengacu pada property dari file Excel yang diimpor.

🔔 Catatan Penting: Selain field-field yang sudah disebutkan, property SupplierId wajib ditambahkan ke dalam mapping, seperti yang ditunjukkan pada contoh. Property ini bersifat mandatory dan tidak boleh diabaikan.

1 { 
2   "Id": {
3     "JsonPath": "$.data[#].OriginId"
4   },
5   "NomorOrder": {
6     "JsonPath": "$.data[#].OrderNo"
7   },
8   "TanggalPesanan": {
9     "JsonPath": "$.data[#].OrderDate"
10  },
11  "IdPelanggan": {
12    "JsonPath": "$.data[#].CustomerId"
13  },
14  "KodePelanggan": {
15    "JsonPath": "$.data[#].CustomerCode"
16  },
17  "NamaPelanggan": {
18    "JsonPath": "$.data[#].CustomerName"
19  },
20  "Latitude": {
21    "JsonPath": "$.data[#].CustomerLatitude"
22  },
23  "Longitude": {
24    "JsonPath": "$.data[#].CustomerLongitude"
25  }
26 }

2. DailyVisit(Item)

Berikut adalah tabel penjelasan property DailyVisit(Item) yang dibutuhkan dan dapat digunakan pada saat membuat ModelMapper.

Nama Property	Tipe Data	Penjelasan	Dibutuhkan/Wajib
OriginId	STRING	Id dari data. Jika tidak ada id, maka dapat menggabungkan beberapa data pada excel sehingga unik.	YA
Date	DATE	Tanggal kunjungan	YA
EmployeeId	STRING	Id pegawai	YA
EmployeeName	STRING	Nama pegawai	YA
CustomerId	STRING	Id Pelanggan	YA
CustomerName	STRING	Nama pelanggan	YA
CheckInLatitude	FLOAT	Latitude lokasi kunjungan	YA
CheckInLongitude	FLOAT	Longitude lokasi kunjunga	YA
TotalSales	FLOAT	Total penjualan	YA
SupplierId	STRING	Id Supplier (tidak perlu di excel, hanya modelmapper saja). Dapat dilihat di contoh.	YA
Planned	INTEGER		TIDAK
Pseq	INTEGER	Urutan kunjungan	TIDAK
CheckInTime	DATETIME	Waktu check in kunjungan	TIDAK
CheckOutTime	DATETIME	Waktu check out kunjungan	TIDAK

Proses/Cara pembuatan model mapper DailyVisit sama saja dengan contoh SalesOrder di atas. Sesuaikan nama-nama propertynya dengan tabel di atas. NB: Selain property-property yang sudah dijelaskan, pada modelmapper import harus ditambahkan property SupplierId seperti pada contoh. Ini WAJIB

3. PurchaseInvoice(Item)

Berikut adalah tabel penjelasan property PurchaseInvoice(Item) yang dibutuhkan dan dapat digunakan pada saat membuat Model Template.

Nama Property	Tipe Data	Penjelasan	Dibutuhkan/Wajib
OriginId	STRING	Id dari data. Jika tidak ada id, maka dapat menggabungkan beberapa data pada excel sehingga unik.	YA
PurchaseNo	STRING	Nomor pembelian	YA
Status	STRING	Status pembelian	YA
PurchaseDate	DATE	Tanggal pembelian	YA
PaymentDueDate	DATE	Tanggal jatuh tempo pembayaran	YA
ProductCode	STRING	Kode produk	YA
ProductName	STRING	Nama produk	YA
Price	FLOAT	Longitude lokasi kunjunga	YA
TotalQuantity	FLOAT	Total penjualan	YA
LineTotal	FLOAT	Total pembelian	YA
TotalPayment	FLOAT	Total pembayaran	YA
SupplierId	STRING	Urutan kunjungan	YA
QuantityL	FLOAT	Kuantitas L	TIDAK
QuantityM	FLOAT	Kuantitas L	TIDAK
QuantityS	FLOAT	Kuantitas L	TIDAK
UnitL	STRING	Nama satuan L	TIDAK
UnitM	STRING	Nama satuan M	TIDAK
UnitS	STRING	Nama satuan S	TIDAK
DiscountItem	FLOAT	Diskon item (nominal)	TIDAK
Discount	FLOAT	Diskon pembelian (nominal)	TIDAK
Tax	FLOAT	Pajak (nominal)	TIDAK
ReferenceNo.	STRING	Nomor referensi	TIDAK