324 lines
27 KiB
Markdown
324 lines
27 KiB
Markdown
|
|
|
|||
|
|
|
|||
|
|
SFA Mobile → CMS Backend → Odoo 18
|
|||
|
|
|
|||
|
|
_Functional / Technical Design (MD) — Version 1.0_
|
|||
|
|
|
|||
|
|
| **Document Control** | **Description** |
|
|||
|
|
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
|
|||
|
|
| Document Name | MD Customer Registration SFA–CMS–Odoo 18 |
|
|||
|
|
| Version | 1.0 — Draft for Review |
|
|||
|
|
| Process Owner | Sales Operations / CMS Approver / Finance |
|
|||
|
|
| Integration Pattern | Realtime API after CMS approval |
|
|||
|
|
| Systems | SFA Mobile, CMS Backend, Odoo 18 |
|
|||
|
|
| Primary Objective | Register calon customer melalui SFA, approval di CMS, pembuatan record customer di Odoo, dan aktivasi oleh Finance setelah COA AR/AP lengkap. |
|
|||
|
|
|
|||
|
|
# 1\. Introduction
|
|||
|
|
|
|||
|
|
Dokumen ini menjelaskan kebutuhan fungsional dan alur integrasi proses Customer Registration dari SFA Mobile ke CMS Backend dan Odoo 18. Sales mendaftarkan calon customer melalui SFA. CMS menerima data dan menjadi tempat utama validasi serta approval. Setelah disetujui, CMS mengirim data secara realtime ke Odoo 18. Finance melengkapi konfigurasi COA Account Receivable (AR) dan Account Payable (AP) sesuai kebijakan perusahaan sebelum customer diaktifkan.
|
|||
|
|
|
|||
|
|
Catatan desain: istilah "Draft Customer" dalam dokumen ini berarti customer berada dalam status internal belum siap digunakan untuk transaksi. Odoo 18 standar tidak selalu memiliki lifecycle draft khusus untuk contact/customer; status pending Finance dan pembatasan penggunaan mungkin membutuhkan konfigurasi atau custom field/module.
|
|||
|
|
|
|||
|
|
# 2\. Justification
|
|||
|
|
|
|||
|
|
- Menyediakan proses registrasi customer yang terkontrol dan dapat ditelusuri dari SFA sampai Odoo 18.
|
|||
|
|
- Memastikan calon customer telah melalui approval CMS sebelum dibuat di Odoo.
|
|||
|
|
- Mencegah duplikasi data, terutama email yang sudah terdaftar.
|
|||
|
|
- Memisahkan persetujuan registrasi dari aktivasi customer dan pengaturan accounting oleh Finance.
|
|||
|
|
- Menyediakan penanganan error integrasi dan mekanisme retry tanpa membuat record customer ganda.
|
|||
|
|
|
|||
|
|
# 3\. Modification Description
|
|||
|
|
|
|||
|
|
| **Area** | **Deskripsi Perubahan / Kebutuhan** |
|
|||
|
|
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|||
|
|
| SFA Mobile | Form customer registration, validasi awal, submit ke CMS, status tracking, alasan revisi/penolakan, dan resubmit. |
|
|||
|
|
| CMS Backend | Penyimpanan registrasi, validasi field, pengecekan duplikasi, approval queue, audit trail, trigger integrasi realtime, retry dan status integrasi. |
|
|||
|
|
| Odoo 18 | Endpoint penerimaan data, validasi ulang, proteksi duplikasi, pembuatan customer dengan status internal Pending Finance, serta proses Finance untuk COA AR/AP dan aktivasi. |
|
|||
|
|
| Monitoring | Pencatatan registration_id, odoo_partner_id, waktu request/response, status sync, dan detail error yang aman ditampilkan. |
|
|||
|
|
|
|||
|
|
# 4\. Detail Fitur
|
|||
|
|
|
|||
|
|
## 4.1 SFA Mobile — Sales
|
|||
|
|
|
|||
|
|
- Sales mengisi data calon customer sesuai field yang diwajibkan.
|
|||
|
|
- SFA melakukan validasi dasar sebelum submit, termasuk format email dan field wajib.
|
|||
|
|
- SFA mengirim data ke CMS melalui API dan menampilkan status registrasi.
|
|||
|
|
- Jika CMS meminta revisi, SFA menampilkan catatan approver agar sales dapat memperbaiki data dan submit ulang.
|
|||
|
|
- Sales tidak dapat mengubah data setelah status Approved/Synced, kecuali melalui proses koreksi yang disepakati.
|
|||
|
|
|
|||
|
|
## 4.2 CMS Backend — Registration & Approval
|
|||
|
|
|
|||
|
|
- Menerima payload dari SFA dan membuat registration_id unik.
|
|||
|
|
- Menormalisasi data yang relevan untuk pemeriksaan duplikasi, termasuk trim spasi dan lowercase email.
|
|||
|
|
- Memvalidasi field wajib dan format data.
|
|||
|
|
- Memeriksa apakah email telah digunakan pada registrasi aktif di CMS atau customer yang diketahui dari data master/sinkronisasi Odoo.
|
|||
|
|
- Menandai potensi duplikasi berdasarkan atribut lain seperti nama, nomor telepon, atau nomor identitas pajak jika field tersebut tersedia.
|
|||
|
|
- Menyediakan antrean approval dan menampilkan hasil validasi/indikasi duplikasi kepada approver.
|
|||
|
|
- Setelah Approved, langsung memanggil API Odoo secara realtime.
|
|||
|
|
- Mencatat hasil integrasi dan menyimpan odoo_partner_id jika pembuatan customer berhasil.
|
|||
|
|
|
|||
|
|
## 4.3 Odoo 18 — Customer & Finance
|
|||
|
|
|
|||
|
|
- Menerima data customer yang telah approved dari CMS.
|
|||
|
|
- Memvalidasi ulang payload dan memeriksa duplikasi di database Odoo sebelum membuat record.
|
|||
|
|
- Menggunakan registration_id CMS sebagai external reference/idempotency key untuk mencegah record ganda saat retry.
|
|||
|
|
- Membuat customer dengan status internal Pending Finance atau status staging ekuivalen.
|
|||
|
|
- Finance memeriksa data dan melengkapi konfigurasi COA AR/AP sesuai kebijakan accounting.
|
|||
|
|
- Finance mengaktifkan customer setelah semua persyaratan terpenuhi.
|
|||
|
|
|
|||
|
|
# 5\. Business Flow
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
Sales / SFA
|
|||
|
|
|
|
|||
|
|
| 1. Input data + submit
|
|||
|
|
v
|
|||
|
|
CMS Backend
|
|||
|
|
|
|
|||
|
|
| 2. Required-field / format validation
|
|||
|
|
| 3. Email duplicate check + potential duplicate check
|
|||
|
|
v
|
|||
|
|
CMS Approval Queue
|
|||
|
|
|-------------------------------|
|
|||
|
|
| Approved | Needs Revision / Rejected
|
|||
|
|
v v
|
|||
|
|
Realtime API to Odoo 18 Return status + reason to SFA
|
|||
|
|
| |
|
|||
|
|
v v
|
|||
|
|
Odoo duplicate check Sales revises and resubmits
|
|||
|
|
|
|
|||
|
|
| Create customer (Pending Finance)
|
|||
|
|
v
|
|||
|
|
Finance review in Odoo
|
|||
|
|
|
|
|||
|
|
| Complete COA AR/AP
|
|||
|
|
v
|
|||
|
|
Activate customer
|
|||
|
|
|
|
|||
|
|
v
|
|||
|
|
Customer available according to company access/business rules
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Approval dilakukan di CMS. Pengiriman CMS ke Odoo berlangsung realtime setelah approval. Status Active hanya ditetapkan di Odoo setelah Finance menyelesaikan konfigurasi dan aktivasi.
|
|||
|
|
|
|||
|
|
# 6\. Registration Status / Workflow
|
|||
|
|
|
|||
|
|
| **Status** | **System** | **Meaning / Next Action** |
|
|||
|
|
| ---------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------- |
|
|||
|
|
| Draft | SFA | Sales masih mengisi data. |
|
|||
|
|
| Submitted | CMS/SFA | Request diterima CMS; validasi awal berlangsung. |
|
|||
|
|
| Pending Approval | CMS | Menunggu keputusan approver. |
|
|||
|
|
| Needs Revision | CMS/SFA | Perlu perbaikan; sales dapat memperbaiki dan submit ulang. |
|
|||
|
|
| Rejected | CMS/SFA | Registrasi ditolak dengan alasan. Sesuai kebijakan, sales dapat memperbaiki dan resubmit atau membuat registrasi baru. |
|
|||
|
|
| Approved | CMS | Approver menyetujui; CMS memicu API ke Odoo. |
|
|||
|
|
| Sync Failed | CMS | Integrasi gagal; perlu retry atau eskalasi. |
|
|||
|
|
| Synced to Odoo | CMS | Odoo berhasil membuat record dan mengembalikan ID. |
|
|||
|
|
| Pending Finance | Odoo | Record dibuat tetapi belum siap digunakan. |
|
|||
|
|
| Finance Review | Odoo | Finance memvalidasi data. |
|
|||
|
|
| Pending COA | Odoo | COA AR/AP belum lengkap. |
|
|||
|
|
| On Hold | Odoo | Dibutuhkan pemeriksaan/perbaikan tambahan. |
|
|||
|
|
| Active | Odoo | Finance telah melengkapi COA AR/AP dan mengaktifkan customer. |
|
|||
|
|
|
|||
|
|
Status registrasi CMS, status integrasi, dan status aktivasi Odoo harus disimpan terpisah. Kegagalan API tidak boleh mengubah status approval menjadi Rejected.
|
|||
|
|
|
|||
|
|
# 7\. Data Requirement
|
|||
|
|
|
|||
|
|
| **Field** | **Required?** | **Validation / Notes** |
|
|||
|
|
| --------------- | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
|
|||
|
|
| registration_id | Yes (system) | ID unik yang dibuat CMS; digunakan untuk audit dan idempotency. |
|
|||
|
|
| customer_name | Yes | Tidak boleh kosong; lakukan trim whitespace. |
|
|||
|
|
| email | Conditional / per business policy | Jika diisi, harus sesuai format email dan dinormalisasi sebelum duplicate check. Jika wajib bagi semua customer, tandai Required. |
|
|||
|
|
| phone | Per business policy | Jika diisi, validasi format dan normalisasi untuk pencarian duplikasi. |
|
|||
|
|
| address | Per business policy | Field alamat sesuai form bisnis. |
|
|||
|
|
| tax_id / NPWP | Per business policy | Jika digunakan, validasi format dan cek potensi duplikasi. |
|
|||
|
|
| approved_by | Yes after approval | User approver CMS. |
|
|||
|
|
| approved_at | Yes after approval | Timestamp approval. |
|
|||
|
|
| source_system | Yes | Identifikasi sumber SFA/CMS. |
|
|||
|
|
| odoo_partner_id | After successful sync | ID record customer yang dibuat di Odoo 18. |
|
|||
|
|
|
|||
|
|
Daftar field final harus mengikuti form registrasi SFA yang sudah berjalan dan kebutuhan master customer Odoo. Field yang belum ditetapkan ditandai sebagai business decision/TBD.
|
|||
|
|
|
|||
|
|
# 8\. Validation
|
|||
|
|
|
|||
|
|
## 8.1 Validasi Form dan Format
|
|||
|
|
|
|||
|
|
- Field wajib harus terisi sebelum submit.
|
|||
|
|
- Email harus mengikuti format email yang valid jika diisi.
|
|||
|
|
- Email dinormalisasi dengan trim spasi di awal/akhir dan lowercase untuk perbandingan.
|
|||
|
|
- Nomor telepon dinormalisasi sesuai standar yang disepakati sebelum dibandingkan.
|
|||
|
|
- CMS harus menyimpan pesan validasi yang dapat dipahami pengguna tanpa membocorkan detail teknis.
|
|||
|
|
|
|||
|
|
## 8.2 Validasi Email Terdaftar
|
|||
|
|
|
|||
|
|
1. Saat submit, CMS mencari email yang sudah dinormalisasi pada registrasi customer lain yang masih aktif diproses dan pada data customer yang tersedia dari master/cache Odoo.
|
|||
|
|
2. Jika email yang sama ditemukan pada customer aktif atau registrasi lain yang masih berlaku, submit diblokir dan SFA menampilkan pesan seperti: "Email sudah terdaftar. Silakan periksa kembali atau hubungi administrator jika data tersebut perlu ditinjau."
|
|||
|
|
3. Jika email ditemukan pada registrasi lama berstatus Needs Revision, sistem harus mengaitkan perubahan dengan registration_id yang sama, bukan membuat registrasi baru.
|
|||
|
|
4. Jika email sama ditemukan pada registrasi yang sudah Rejected/Cancelled, aturan penggunaan ulang email harus mengikuti kebijakan bisnis yang ditetapkan.
|
|||
|
|
5. CMS tidak boleh mengandalkan cache sebagai satu-satunya pemeriksaan. Odoo melakukan pengecekan ulang tepat sebelum membuat customer untuk menghindari duplikasi akibat data yang berubah setelah approval.
|
|||
|
|
6. Jika CMS tidak dapat memastikan status email karena master/cache tidak tersedia, sistem harus menandai validasi tidak lengkap atau mengeskalasi pemeriksaan; jangan menganggap email pasti unik.
|
|||
|
|
|
|||
|
|
Contoh pesan validasi SFA:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
Email sudah terdaftar. Gunakan email lain atau hubungi administrator untuk pemeriksaan lebih lanjut.
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 8.3 Potensi Duplikasi Selain Email
|
|||
|
|
|
|||
|
|
- Nama mirip, nomor telepon sama, alamat sama, atau nomor identitas pajak sama dapat ditandai sebagai potential duplicate untuk ditinjau approver CMS.
|
|||
|
|
- Email yang persis sama setelah normalisasi direkomendasikan sebagai hard validation/blocker, kecuali terdapat pengecualian bisnis yang disetujui.
|
|||
|
|
- Approver dapat meminta revisi atau menolak registrasi setelah meninjau potensi duplikasi.
|
|||
|
|
- Odoo melakukan duplicate check kedua sebelum create untuk menjaga integritas master customer.
|
|||
|
|
|
|||
|
|
## 8.4 Aturan Unik dan Race Condition
|
|||
|
|
|
|||
|
|
- Pengecekan aplikasi tidak cukup untuk menjamin keunikan jika dua sales submit email yang sama hampir bersamaan.
|
|||
|
|
- Jika memungkinkan, terapkan kontrol unik pada data email yang telah dinormalisasi atau mekanisme locking/transaction yang sesuai pada CMS dan/atau Odoo.
|
|||
|
|
- Sebelum penerapan constraint unik global, konfirmasi apakah perusahaan mengizinkan satu email dipakai oleh lebih dari satu entitas/customer.
|
|||
|
|
|
|||
|
|
# 9\. Access Right
|
|||
|
|
|
|||
|
|
| **Role** | **Access / Permission** |
|
|||
|
|
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
|
|||
|
|
| Sales (SFA) | Membuat registrasi dan melihat registrasi miliknya; merevisi jika dikembalikan; tidak dapat approve. |
|
|||
|
|
| CMS Approver | Melihat antrean registrasi, meninjau indikasi duplikasi, approve, request revision, atau reject; keputusan tercatat dalam audit trail. |
|
|||
|
|
| CMS Administrator | Mengelola konfigurasi dan monitoring integrasi sesuai otorisasi; tidak otomatis memiliki hak approval bisnis kecuali ditetapkan. |
|
|||
|
|
| Odoo Finance | Melihat customer Pending Finance, memvalidasi data, melengkapi COA AR/AP, menahan atau mengaktifkan customer. |
|
|||
|
|
| Integration User | Hak API minimum yang diperlukan untuk membuat/memperbarui record terkait; tidak menggunakan akun personal. |
|
|||
|
|
|
|||
|
|
# 10\. Error Handling
|
|||
|
|
|
|||
|
|
| **Scenario** | **Expected Handling** |
|
|||
|
|
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
|
|||
|
|
| Required field / invalid email | Block submit dan tampilkan pesan validasi. |
|
|||
|
|
| Email sudah terdaftar | Block submit; tampilkan pesan dan arahkan ke pemeriksaan administrator bila perlu. |
|
|||
|
|
| Potential duplicate | Tandai untuk review approver CMS; jangan membuat record otomatis tanpa keputusan. |
|
|||
|
|
| CMS → Odoo timeout / network error | Set integration status Sync Failed; simpan error dan jadwalkan retry. |
|
|||
|
|
| Odoo create berhasil tetapi response hilang | Retry menggunakan registration_id/idempotency key; Odoo mengembalikan record yang sudah ada, bukan membuat duplikat. |
|
|||
|
|
| Odoo menemukan duplikasi | Tolak pembuatan baru atau kembalikan record yang cocok untuk pemeriksaan; catat hasil dan jangan membuat duplikat. |
|
|||
|
|
| Payload tidak valid di Odoo | Simpan error teknis di log; tampilkan ringkasan aman kepada CMS/admin untuk perbaikan. |
|
|||
|
|
| Finance belum melengkapi COA | Customer tetap Pending COA/Pending Finance dan belum boleh dipakai sesuai aturan bisnis. |
|
|||
|
|
| Finance menahan customer | Set status On Hold dengan alasan dan audit trail. |
|
|||
|
|
|
|||
|
|
# 11\. Notification
|
|||
|
|
|
|||
|
|
| **Event** | **Recipient** | **Notification** |
|
|||
|
|
| ------------------------- | ------------------------------------------------------ | ------------------------------------------------------------- |
|
|||
|
|
| Registration submitted | Sales | Konfirmasi registrasi diterima CMS. |
|
|||
|
|
| Needs revision / rejected | Sales | Status, alasan, dan data yang perlu diperbaiki. |
|
|||
|
|
| Approved | Sales / CMS monitoring | Registrasi disetujui; proses integrasi ke Odoo dimulai. |
|
|||
|
|
| Sync failed | CMS Admin / Integration Support | Notifikasi error dan registration_id untuk investigasi. |
|
|||
|
|
| Customer synced | CMS monitoring / relevant user | Konfirmasi record berhasil dibuat di Odoo. |
|
|||
|
|
| Pending Finance | Finance | Customer baru menunggu review dan COA AR/AP. |
|
|||
|
|
| Customer activated | Relevant user / CMS if status sync-back is implemented | Konfirmasi customer aktif jika notifikasi ini termasuk scope. |
|
|||
|
|
|
|||
|
|
# 12\. Audit Trail
|
|||
|
|
|
|||
|
|
- Simpan registration_id, sales user, waktu submit, perubahan data, approver, keputusan, alasan revisi/penolakan, dan timestamp.
|
|||
|
|
- Catat request/response integrasi secara aman, status sync, jumlah retry, waktu proses, dan odoo_partner_id.
|
|||
|
|
- Jangan menyimpan credential/token API atau data sensitif yang tidak diperlukan di log.
|
|||
|
|
- Catat user Finance yang melengkapi COA AR/AP dan mengaktifkan customer, termasuk timestamp perubahan.
|
|||
|
|
|
|||
|
|
# 13\. API Specification
|
|||
|
|
|
|||
|
|
Detail endpoint, autentikasi, dan nama field teknis perlu disesuaikan dengan API yang tersedia pada CMS dan Odoo 18. Struktur berikut adalah rancangan payload, bukan endpoint final.
|
|||
|
|
|
|||
|
|
## 13.1 CMS → Odoo 18: Create Approved Customer
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
{
|
|||
|
|
"registration_id": "CMS-CR-000123",
|
|||
|
|
"source_system": "SFA_CMS",
|
|||
|
|
"approval_status": "approved",
|
|||
|
|
"approved_by": "cms_user_id",
|
|||
|
|
"approved_at": "2026-10-19T13:00:00+07:00",
|
|||
|
|
"customer": {
|
|||
|
|
"name": "Example Customer",
|
|||
|
|
"email": "customer@example.com",
|
|||
|
|
"phone": "+62xxxxxxxxxx",
|
|||
|
|
"address": "Customer address"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 13.2 Success Response (Illustrative)
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
{
|
|||
|
|
"success": true,
|
|||
|
|
"registration_id": "CMS-CR-000123",
|
|||
|
|
"odoo_partner_id": 12345,
|
|||
|
|
"customer_status": "pending_finance",
|
|||
|
|
"message": "Customer record created"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 13.3 Error Response (Illustrative)
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
{
|
|||
|
|
"success": false,
|
|||
|
|
"registration_id": "CMS-CR-000123",
|
|||
|
|
"error_code": "DUPLICATE_EMAIL",
|
|||
|
|
"message": "Email is already registered"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- Gunakan HTTPS dan autentikasi service-to-service.
|
|||
|
|
- Gunakan registration_id sebagai external reference/idempotency key.
|
|||
|
|
- Respons API harus membedakan validation error, duplicate conflict, authorization error, dan transient server/network error.
|
|||
|
|
- Retry otomatis hanya untuk error sementara; validation error dan duplicate conflict memerlukan penanganan yang sesuai.
|
|||
|
|
- Pastikan aturan update vs create jelas: request berulang untuk registration_id yang sama tidak boleh membuat record customer baru.
|
|||
|
|
|
|||
|
|
# 14\. Test Scripts
|
|||
|
|
|
|||
|
|
| **ID** | **Scenario** | **Steps** | **Expected Result** |
|
|||
|
|
| ------ | ------------------------------ | -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
|
|||
|
|
| TC-01 | Registrasi valid | Sales isi semua field wajib dan submit. | CMS menerima data dan status Pending Approval. |
|
|||
|
|
| TC-02 | Email format tidak valid | Masukkan email dengan format salah. | Submit diblokir dan pesan validasi ditampilkan. |
|
|||
|
|
| TC-03 | Email sudah terdaftar di CMS | Submit registrasi menggunakan email yang telah dipakai. | Submit diblokir dengan pesan email sudah terdaftar. |
|
|||
|
|
| TC-04 | Email sudah ada di Odoo | Email tidak ada di cache CMS tetapi sudah ada di Odoo; submit/approval diproses. | Pengecekan Odoo mencegah customer duplikat; error/status dikembalikan dan dicatat. |
|
|||
|
|
| TC-05 | Potensi duplikasi nama/telepon | Submit customer dengan nama mirip atau telepon sama. | CMS menandai potential duplicate untuk review approver. |
|
|||
|
|
| TC-06 | Approval | Approver menyetujui registrasi yang valid. | CMS langsung memanggil API Odoo secara realtime. |
|
|||
|
|
| TC-07 | Needs Revision | Approver meminta revisi dan menulis alasan. | SFA menampilkan alasan; sales dapat memperbaiki dan submit ulang. |
|
|||
|
|
| TC-08 | API timeout | Simulasikan timeout CMS → Odoo. | Status Sync Failed tercatat; retry dapat dilakukan. |
|
|||
|
|
| TC-09 | Retry tanpa duplikasi | Odoo berhasil create tetapi response dianggap timeout; CMS retry request. | Odoo mengembalikan record yang sama berdasarkan registration_id. |
|
|||
|
|
| TC-10 | Finance belum melengkapi COA | Customer berhasil dibuat di Odoo tetapi COA belum lengkap. | Customer tetap Pending Finance/Pending COA dan tidak siap untuk transaksi. |
|
|||
|
|
| TC-11 | Finance mengaktifkan customer | Finance melengkapi COA AR/AP dan mengaktifkan customer. | Status customer menjadi Active sesuai aturan. |
|
|||
|
|
| TC-12 | Audit trail | Lakukan submit, approval, sync, dan aktivasi. | Jejak user, timestamp, keputusan, dan hasil integrasi tersedia. |
|
|||
|
|
|
|||
|
|
# 15\. Acceptance Criteria
|
|||
|
|
|
|||
|
|
- Approval registrasi hanya dilakukan oleh approver di CMS.
|
|||
|
|
- Sales dapat memperbaiki registrasi yang dikembalikan dan submit ulang.
|
|||
|
|
- Email dinormalisasi dan dicek sebelum submit; email yang sudah terdaftar diblokir sesuai aturan duplikasi.
|
|||
|
|
- CMS memeriksa potensi duplikasi dan menampilkannya kepada approver.
|
|||
|
|
- Setelah approval, CMS mengirim data ke Odoo secara realtime.
|
|||
|
|
- Odoo memvalidasi ulang data dan mencegah pembuatan record ganda pada request berulang.
|
|||
|
|
- CMS menyimpan odoo_partner_id dan status integrasi setelah berhasil.
|
|||
|
|
- Customer belum siap digunakan sampai Finance melengkapi COA AR/AP dan mengaktifkan customer.
|
|||
|
|
- Error integrasi, retry, keputusan approval, dan aktivasi dapat ditelusuri melalui audit trail.
|
|||
|
|
- Validasi email dan kontrol duplikasi sudah diuji termasuk skenario dua request hampir bersamaan.
|
|||
|
|
|
|||
|
|
# 16\. Open Issues / TBD
|
|||
|
|
|
|||
|
|
| **Topic** | **Decision Needed** |
|
|||
|
|
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
|
|||
|
|
| Email mandatory? | Apakah email wajib untuk seluruh tipe customer atau hanya jika tersedia? |
|
|||
|
|
| Email uniqueness scope | Apakah email harus unik secara global di seluruh customer/company atau boleh digunakan bersama? |
|
|||
|
|
| Duplicate email on rejected/cancelled registration | Apakah email dapat digunakan kembali jika registrasi sebelumnya ditolak atau dibatalkan? |
|
|||
|
|
| Exact vs potential duplicate | Rekomendasi: email exact match = block; nama/telepon/alamat mirip = review approver. |
|
|||
|
|
| Odoo draft/pending implementation | Pilih field status custom, staging model, atau mekanisme lain agar customer belum bisa dipakai sebelum Finance selesai. |
|
|||
|
|
| COA AR/AP rules | Pastikan apakah AR/AP ditetapkan per customer, lewat property account, company, fiscal configuration, atau konfigurasi khusus yang berlaku. |
|
|||
|
|
| Status feedback Odoo → CMS/SFA | Apakah status Pending Finance dan Active perlu disinkronkan kembali ke CMS/SFA? |
|
|||
|
|
| Retry policy | Tetapkan interval, batas retry, dan proses manual retry/eskalasi. |
|
|||
|
|
| API contract | Finalisasi endpoint, auth, payload field, response schema, dan error code bersama tim CMS/Odoo. |
|
|||
|
|
| Required customer fields | Finalisasi field SFA yang wajib dan mapping ke res.partner di Odoo. |
|
|||
|
|
|
|||
|
|
# 17\. Implementation Notes
|
|||
|
|
|
|||
|
|
- Jangan menganggap status Approved di CMS sama dengan Active di Odoo.
|
|||
|
|
- Jangan menggunakan email saja sebagai satu-satunya penentu bahwa dua customer pasti sama tanpa mempertimbangkan kebijakan bisnis, tetapi exact email match sebaiknya menjadi blocker sesuai keputusan ini.
|
|||
|
|
- Odoo tetap perlu melakukan pemeriksaan duplikasi karena data master dapat berubah setelah CMS melakukan validasi.
|
|||
|
|
- Jika customer multi-company, validasi email unik dan konfigurasi COA perlu mempertimbangkan aturan company yang berlaku.
|
|||
|
|
- Status Pending Finance dan pembatasan transaksi perlu diuji di Odoo; field status saja tidak cukup jika tidak ada kontrol yang mencegah penggunaan customer.
|