5.7 KiB
5.7 KiB
| judul | proyek | terkait | stack | kategori | status | tipe | tags | diperbarui | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| SFA CMS — Sync Customer dari Odoo | SFA CMS | Mito · Odoo 18 · mito_base | Laravel 11 · Filament 3 · Odoo 18 REST API (mito_base) | Integrasi | Ter-deploy di VPS (develop 8d5f815) 2026-10-06 — cron aktif | dokumen-internal |
|
2026-10-06 |
Index: SFA — Index · Kategori: Integrasi
Pasangan dari SFA CMS — Sync Master Product dari Odoo. Client API, auth, masalah
no_database,.env, dan langkah deploy sama persis; dokumen ini hanya mencatat yang khusus untuk customer.
Sync Customer Odoo → SFA-CMS
1. Ringkasan
| Sumber | GET /api/v1/customers dari mito_base (res.partner tipe contact) |
| Yang di-sync | Hanya status = validate → 1.259 customer (dari 2.205; 946 draft kebanyakan data sampah: nama karyawan [00] …, nomor HP, dll) |
| Kunci | Kolom lama customer.cust_code = id res.partner Odoo (string, mis. 9483). Tidak ada kolom/tabel baru |
| Data lama CMS | Dihapus (soft delete) — 834 customer lama. Master customer sekarang murni dari Odoo |
| Command | php artisan odoo:sync-customers (--dry-run, --since=) |
| Jadwal | Harian 01:15 WIB (15 menit setelah sync product) · log storage/logs/odoo-sync-customers.log |
| Hasil uji lokal | created=1259 deleted=834, run berikutnya unchanged=1259 deleted=0, tanpa duplikat |
| Server (dry-run 06-10-2026) | created=1259 deleted=836 — semua customer uji di server di-soft delete. Lihat SFA CMS — Deploy 2026-10-06 |
File: app/Console/Commands/SyncOdooCustomers.php + jadwal di routes/console.php.
2. Mapping Field
| Odoo API | CMS customer |
Catatan |
|---|---|---|
id |
cust_code |
Kunci sync. Number sequence CUST tidak dipakai |
name |
cust_name |
Maks 60 karakter |
initial_name |
shop_name |
Nama toko, mis. TOKO ABADI ELEKTRONIK / ABADI MAKMUR MANDIRI |
is_company |
cust_type |
COMPANY / INDIVIDUAL |
status |
cust_status |
Selalu ACTIVE (yang di-sync hanya validate) |
phone (fallback mobile) |
phone_number |
Maks 20 karakter |
email |
email_address |
|
address.street, street2, city, state, zip |
cust_address |
Digabung pakai koma |
area.name |
area_id + area_code |
Ambil bagian sebelum -: SURABAYA - GUDANG DEPO … → SURABAYA, dicocokkan ke area.description / area_code |
channel.name |
channel_id + channel_code |
Dicocokkan ke channel_code / description |
grade.name |
customer_grade_id + customer_grade_code |
A/B/C cocok ke master yang ada |
salesperson.name |
employee_id + empl_code |
Prefix [00] dibuang, dicocokkan ke employee.empl_name. Tidak membuat employee baru |
Kolom yang tidak disentuh sync: longitude, latitude, radius, credit_limit,
term_of_payment_*, wh_*, legal_entity_id, pkp, vat_num, discount, pic,
cust_category, dll. Nilai yang diisi dari CMS/mobile (mis. titik GPS) tidak tertimpa.
3. Aturan Sync
| Kondisi | Aksi |
|---|---|
cust_code belum ada |
Create |
| Ada & berubah | Update |
| Ada & tidak berubah | Dilewati |
| Soft-deleted & muncul lagi di Odoo | Restore |
| Tidak ada di hasil Odoo (data lama, customer di-draft/archive di Odoo) | Soft delete, hanya saat full sync |
Customer hasil Customer Registration CMS (customer_registration.customer_id) |
Tidak dihapus walaupun belum ada di Odoo |
| Odoo mengembalikan 0 customer | Soft delete dilewati (anomali) |
Soft delete → histori SO, kunjungan, task, dan invoice lama tetap utuh.
4. Temuan & Catatan Terbuka
| # | Temuan | Dampak / Saran |
|---|---|---|
| 1 | API customer tidak mengirim kode customer (ref & short_code kosong di semua 2.205 record) |
Terpaksa pakai id Odoo sebagai cust_code. Kalau Odoo nanti punya kode customer resmi, mapping bisa diganti |
| 2 | Kode area/channel CMS (SBY, DLDI, SMOO) ≠ Odoo (SURABAYA - GUDANG DEPO …, GT, SC) |
Sync membuat 37 master baru (area: GELAEL, SHOPEE, TOKOPEDIA, ASC MEDAN, …; channel: GT, SC, RESELLER, PROMOSI, …). Perlu keputusan: rapikan di Odoo atau buat tabel mapping |
| 3 | Salesperson: 42 nama di Odoo, 29 cocok ke employee CMS | 13 sisanya (Bimo Firgiawan, Alvian Alieffikry, …) → employee_id kosong. Daftarkan employee-nya di CMS dengan nama sama, sync berikutnya otomatis terisi |
| 4 | 206 customer validate tanpa area, 509 tanpa salesperson | Perlu dilengkapi di Odoo |
| 5 | Customer Registration CMS belum terhubung ke Odoo | Customer hasil registrasi tetap ada di CMS tapi tidak ada di Odoo. Perlu alur kirim ke Odoo (belum ada endpoint POST /customers) |
| 6 | Menu Customer di Filament masih bisa create/edit | Customer yang dibuat manual akan ter-soft delete di sync berikutnya. Saran: read-only, kecuali via Customer Registration |
| 7 | 🔴 Prospect dari SFA Mobile ikut terhapus tiap malam | POST /master/customer (sfa-api) membuat customer PROSPECT dengan cust_code number sequence. Full sync men-soft delete semua cust_code yang bukan id Odoo (kecuali hasil registrasi) → prospect hilang dari aplikasi esok harinya (Mcustomer paranoid). Opsi: batasi soft delete ke cust_code numerik (asal Odoo), atau kecualikan cust_category = PROSPECT. Putuskan sebelum production |
| 8 | Sync membuat baris baru, bukan mengadopsi baris lama | Saat pertama jalan, transaksi lama (SO, kunjungan, invent_trans) tetap menunjuk ke customer/produk lama yang di-soft delete. Aman untuk server yang masih data uji; kalau ada data sungguhan perlu pemetaan (Odoo tidak punya ref/short_code → hanya lewat nama/HP) |