--- judul: Mito — FDD — CMS — Master Product (Revised) proyek: SFA CMS terkait: Mito · Odoo 18 kategori: FDD tipe: dokumen-eksternal versi: "1.0" tanggal_dokumen: 2026-09-08 status: Draft — approver & distribution belum diisi sumber: dokumen FDD dari tim SFA/CMS (bukan tulisan internal) tags: - sfa - cms - mito - fdd - integrasi - master-product --- > Index: [[SFA — Index]] · Kategori: **FDD** · Dokumen pihak luar — **jangan diedit isinya**, > catatan/tanggapan internal ditulis di [[SFA — Index]]. > > FDD integrasi Master Product `Odoo 18 → CMS → SFA Mobile`, pola **pull**: scheduler ada di > sisi CMS, Odoo cuma jadi source of truth + API provider. # **Master Product** ## **Customizations** SFA - Content Management System |**Item**|**Details**| |---|---| |Prepared for|Mito| |Project|SFA–CMS Integration with Odoo 18| |Document Title|Functional Design Document| |Version|1.0| |Date|08/09/2026| Mito – FDD – CMS – Master Product | Version 1.0 ### **Revision & Sign-off Sheet** #### **Change Record** |**Date**|**Author**|**Version**|**Change Reference**| |---|---|---|---| |08/09/2026|Project Team|1.0|Initial FDD–Master Product integration| #### **Approvers** |**Name**|**Version Approved**|**Position**|**Date**| |---|---|---|---| |**istribution**
**Name**||**Position**|| #### **Distribution** #### **Document Properties** |**Item**|**Details**| |---|---| |Document Title|Functional Design Document| |Author|Project Team| |Creation Date|08/09/2026| |Last Updated|08/09/2026| Mito – FDD – CMS – Master Product | Version 1.0 ### **Table of Contents** - 1 Introduction - 2 Justification - 3 Modification Description Arsitektur integrasi menggunakan pola pull: CMS menjadi pihak yang menginisiasi request melalui scheduler. Odoo 18 tidak menjalankan scheduler untuk proses ini; Odoo 18 berperan sebagai source system/API provider yang mengembalikan data Master Product kepada CMS. - 3.1 Integration Overview - 3.2 Detail Fitur - 3.3 Integration Flow - 3.4 Data Mapping - 3.5 Validation - 4 Access Right - 5 Error Handling - 6 Test Scripts Mito – FDD – CMS – Master Product | Version 1.0 ### **1 Introduction** #### **Background** Master Product pada Odoo 18 menjadi sumber data produk yang diakses oleh CMS untuk menyediakan data produk kepada aplikasi mobile SFA. Integrasi dirancang menggunakan scheduler/cron job pada CMS yang secara berkala mengambil data master product dari Odoo 18 melalui API. #### **Purpose** Dokumen ini mendefinisikan kebutuhan fungsional dan alur integrasi Master Product antara Odoo 18, CMS, dan aplikasi mobile SFA, termasuk proses pengiriman data, validasi, create/update product pada CMS, logging, dan distribusi data ke SFA. #### **Audience** Customer Project : PT Mahakarya Sukses Indonesia - PT Stein Perkasa Internasional Partner Consultant : Partner Project Mgr : ### **2 Justification** #### **Standard** Odoo 18 berfungsi sebagai source of truth untuk master product. CMS menjadi layer integrasi yang mengambil data dari Odoo dan penyedia data product untuk SFA. #### **Purpose of the modification** Menyediakan mekanisme sinkronisasi otomatis Master Product dari Odoo 18 ke CMS dan selanjutnya dari CMS ke aplikasi mobile SFA. #### **Considerations** - Scheduler/cron dijalankan dari sisi CMS sesuai interval yang disepakati. - CMS melakukan validasi ID product sebelum melakukan create atau update. - CMS menyimpan log success dan error untuk kebutuhan monitoring dan troubleshooting. - Data yang berhasil diproses CMS diteruskan ke SFA. - Detail interval scheduler, endpoint API, authentication, dan field teknis final mengikuti technical design/API specification. ### **3 Modification Description** #### **3.1 Integration Overview** Integrasi menggunakan pola Odoo → CMS → SFA. CMS secara otomatis menjalankan scheduler untuk mengambil data product dari Odoo 18 melalui API. CMS menerima response, melakukan mapping dan validasi ID product, kemudian menentukan apakah product perlu dibuat baru atau di-update. Setelah proses berhasil, CMS mengirimkan data product ke SFA. Mito – FDD – CMS – Master Product | Version 1.0 _ a ia |=
‘—
a(|
‘Sync Lastce Update <—— Scheduler/Cron
| Job
| =‘CMs.
a=
wt
aes as
a ha
u
=
_Gambar 1. High-level integration flow Master Product_ #### **3.2 Detail Fitur** |**Action**|**Description**| |---|---| |Create|CMS membuat record product baru apabila Product ID dari Odoo belum tersedia di
CMS.| |Edit / Update|CMS memperbarui record product apabila Product ID dari Odoo sudah tersedia di
CMS.| |View|Data product yang tersimpan di CMS dapat digunakan sebagai sumber data product
untuk SFA.| |Delete|Tidak didefinisikan pada flow ini. Status/archive handling mengikuti kebutuhan bisnis
dan technical design.| |Search / Filter|Tidak menjadi bagian utama proses integrasi; mekanisme pencarian/filter pada
CMS/SFA mengikuti kebutuhan aplikasi.| |Sync|Scheduler CMS mengambil data product dari Odoo 18 untuk diproses secara otomatis.| #### **3.3 Integration Flow** |**No.**|**Process**|**Functional Description**| |---|---|---| |1|Scheduler / Cron Job|CMS menjalankan scheduler secara berkala sesuai
konfigurasi interval.| |2|Request Product Data|CMS melakukan request/get data Master Product dari
Odoo 18 melalui API.| |3|Odoo API Response|Odoo 18 mengembalikan data product kepada CMS
berdasarkan request dari CMS.| |4|Receive API & Sync/Map
Product|CMS menerima response dan melakukan mapping data
product Odoo ke struktur data CMS.| |5|Validasi Product ID|CMS memvalidasi Product ID. Jika tidak valid, proses
masuk ke error handling dan error code dicatat.| |6|Check Product ID|CMS mengecek apakah Product ID sudah tersedia di
CMS.| |6A|Product belum ada|CMS membuat product baru.| Mito – FDD – CMS – Master Product | Version 1.0 |6B|Product sudah ada|CMS melakukan update terhadap product existing.| |---|---|---| |7|Receive Success|CMS menghasilkan status sukses setelah proses
create/update berhasil.| |8|Log|CMS mencatat log success atau error sesuai hasil
proses.| |9|Send Data to SFA|CMS mengirimkan data product yang berhasil diproses
ke aplikasi mobile SFA.| |10|Receive Data in SFA|SFA menerima data product dari CMS untuk digunakan
pada aplikasi.| #### **3.4 Data Mapping** Field teknis Odoo 18 belum ditentukan secara eksplisit pada source flow. Oleh karena itu, mapping berikut menggunakan logical business field dan kolom Odoo Field diberi status TBD untuk dikonfirmasi pada technical/API design. |**Name Field**|**Odoo Field**|**CMS Field**|**Type**|**Condition**| |---|---|---|---|---| |Product ID|TBD|product_id|Integer / String|Mandatory; digunakan sebagai
unique identifier| |Product Name|TBD|product_name|String|Mandatory| |SKU / Internal
Reference|TBD|sku|String|Jika digunakan oleh master
product| |Product Type|TBD|product_type|Selection / String|Mengikuti konfigurasi product
type| |Product Status|TBD|status|Selection /
Boolean|Mengikuti status product pada
Odoo| |UOM|TBD|uom|String /
Reference|Mengikuti konfigurasi UOM| |Product Category|TBD|category|Reference|Mengikuti master category| |Last Updated|TBD|updated_at|Date Time|Digunakan untuk informasi
sinkronisasi| #### **3.5 Validation** |**No.**|**Validation**|**Condition**|**Expected Result**|**Error / Handling**| |---|---|---|---|---| |1|Product ID tersedia|Product ID valid|Proses dilanjutkan ke
pengecekan existing product.|-| |2|Product ID tidak valid|ID kosong / format tidak sesuai
/ tidak dapat dipetakan|Data tidak diproses.|Send/record error
code dan Log Error.| |3|Product belum ada|Product ID tidak ditemukan di
CMS|CMS membuat product baru.|-| |4|Product sudah ada|Product ID ditemukan di CMS|CMS melakukan update
product.|-| |5|Create/Update gagal|Error saat penyimpanan data|Transaksi dianggap gagal.|Log Error dan error
code.| |6|Sync berhasil|Create/Update berhasil|CMS mencatat success dan
meneruskan data ke SFA.|-| ### **4 Access Right** |**Component**|**Access / Responsibility**| |---|---| |Odoo 18|Menyediakan API Master Product dan mengembalikan data product
berdasarkan request dari CMS.| |CMS|Menjalankan scheduler, request data dari Odoo, menerima response,
mapping, validasi, create/update, logging, dan mengirim data product
ke SFA.| |SFA Mobile|Menerima dan menggunakan data product dari CMS.| |User|Tidak menjalankan scheduler secara manual sebagai bagian dari
normal business flow, kecuali disediakan oleh administrator.| Mito – FDD – CMS – Master Product | Version 1.0 ### **5 Error Handling** Error handling digunakan untuk memastikan kegagalan integrasi dapat ditelusuri dan tidak dianggap sebagai sinkronisasi berhasil. |**No.**|**Scenario**|**Handling**|**Log**| |---|---|---|---| |1|Invalid Product ID|CMS menolak data yang tidak valid dan
menghasilkan/menyimpan error code.|Log Error| |2|Mapping gagal|Data tidak diproses sampai mapping dapat dilakukan
dengan benar.|Log Error| |3|Create product gagal|Record tidak dianggap sukses; error dicatat untuk
troubleshooting.|Log Error| |4|Update product gagal|Record tidak dianggap sukses; error dicatat untuk
troubleshooting.|Log Error| |5|API communication failure|Request dari CMS ke Odoo dianggap gagal dan dicatat
untuk monitoring/retry sesuai technical design.|Log Error| |6|Successful synchronization|CMS mencatat hasil sukses setelah create/update selesai.|Log Success| ### **6 Test Scripts** |**No.**|**Skenario**
**Pengujian**|**Langkah Pengujian oleh**
**User/System**|**Data yang**
**Diuji**|**Hasil yang**
**Diharapkan**|**Error**
**Message (jika**
**ada)**|**Notes**| |---|---|---|---|---|---|---| |1|Scheduler
berhasil
dijalankan|Jalankan/menunggu
scheduler CMS sesuai
jadwal.|Product valid
di Odoo|Data product dikirim
dari Odoo ke CMS.|-|| |2|CMS menerima
data product|CMS melakukan request
ke API Odoo dan
menerima response
payload product.|Payload
product valid|CMS menerima dan
memproses payload.|-|| |3|Validasi Product
ID berhasil|
CMS melakukan validasi
Product ID.|Product ID
valid|Proses dilanjutkan.|-|| |4|Product baru
dibuat|Kirim Product ID yang
belum ada di CMS.|Product baru|CMS membuat product
baru.|-|| |5|Product existing
di-update|Kirim Product ID yang
sudah ada di CMS dengan
perubahan data.|Product
existing|CMS memperbarui
product.|-|| |6|Product ID
invalid|
Kirim payload dengan
Product ID kosong/tidak
valid.|Invalid
Product ID|Data ditolak dan error
dicatat.|Error code
sesuai API
specification|| |7|Create gagal|Simulasikan kegagalan
penyimpanan saat create.|Product baru|Proses dianggap gagal
dan Log Error
terbentuk.|Error code
sesuai API
specification|| |8|Update gagal|Simulasikan kegagalan
penyimpanan saat update.|Product
existing|Proses dianggap gagal
dan Log Error
terbentuk.|Error code
sesuai API
specification|| |9|Send data ke
SFA berhasil|Setelah create/update
sukses, cek proses
outbound CMS ke SFA.|Product valid|SFA menerima data
product.|-|| |10|End-to-end sync|Jalankan scheduler CMS
dan verifikasi data dari
Odoo→CMS→SFA.|Product valid|Data tersedia di CMS
dan SFA sesuai hasil
mapping.|-|| **Note:** Dokumen ini merupakan FDD berdasarkan flow integrasi yang diberikan. Endpoint API, authentication, scheduler interval, exact Odoo field technical name, payload JSON, retry mechanism, dan detail database belum dispesifikasikan pada source dan perlu dikonfirmasi pada tahap Technical Design/API Specification. Mito – FDD – CMS – Master Product | Version 1.0