**Versi:** 0.2 — Draft revisi **Tanggal:** 13 Oktober 2026 **Status:** Untuk review Business, Product, Developer, dan Finance ## 1. Tujuan dan ruang lingkup Dokumen ini mendefinisikan alur reward berbasis rupiah untuk SFA dan CMS serta integrasi CMS ke Odoo untuk membuat **Draft Vendor Bill** setelah konsumen melakukan claim reward. Ruang lingkup sistem: - **CMS** 1. List saldo per customer 2. Config setup reward 3. Claim history customer 4. Integrasi Odoo untuk membuat Draft Vendor Bill - **SFA** 1. IMEI registration / scan IMEI 2. Claim reward ### 1.1 Prinsip bisnis 1. Setiap IMEI yang valid dan eligible hanya dapat menghasilkan reward satu kali sesuai cakupan aturan duplikasi yang ditetapkan. 2. Reward diberikan dalam bentuk **nominal rupiah**, bukan poin. 3. Nominal reward ditentukan oleh **program dan produk**. Contoh: Product A = Rp10.000 per IMEI, Product B = Rp10.000 per IMEI, Product C = Rp15.000 per IMEI. 4. CMS harus memvalidasi hubungan IMEI dengan produk menggunakan sumber data yang tepercaya. Product ID yang dikirim SFA tidak boleh langsung dipercaya tanpa validasi. 5. Saldo reward terakumulasi lintas bulan dan tidak otomatis direset saat pergantian bulan. 6. Konsumen hanya dapat melakukan full-balance claim. Claim sebagian/cicilan tidak diperbolehkan; beberapa claim dalam satu bulan tetap dapat dilakukan jika reward baru masuk setelah claim sebelumnya. 7. Saldo dipotong saat claim berhasil divalidasi dan dicatat secara atomik di CMS, bukan ketika Vendor Bill dibayar. 8. Setiap full-balance claim yang diterima CMS diproses untuk membuat Draft Vendor Bill di Odoo. Tidak ada approval claim tambahan di CMS. 9. Finance tetap menjalankan review, posting, dan pembayaran melalui workflow accounting di Odoo. 10. Perubahan konfigurasi reward hanya berlaku untuk transaksi baru sesuai effective date. Reward historis mempertahankan nominal snapshot saat transaksi diperoleh. ## 2. Pembagian modul | Sistem | Modul/Fitur | Tanggung jawab utama | |---|---|---| | CMS | 1. List saldo per customer | Melihat saldo tersedia, total earned, total claimed, aktivitas terakhir, dan status integrasi. | | CMS | 2. Config setup reward | Mengatur program, nominal reward per produk, periode berlaku, minimum claim, eligibility, dan aturan duplikasi. | | CMS | 3. Claim history customer | Melihat riwayat claim, nominal, tanggal, status, dan referensi Vendor Bill Odoo. | | CMS | 4. Integrasi Odoo | Mengirim claim ke Odoo, menangani retry, menyimpan Odoo Bill ID, dan mendukung rekonsiliasi. | | SFA | 1. IMEI registration / scan IMEI | Memindai IMEI dan mengirim permintaan validasi serta pencatatan reward ke CMS. | | SFA | 2. Claim reward | Menampilkan saldo, menerima nominal claim, mengirim request claim, dan menampilkan hasil. | ## 3. Konfigurasi reward di CMS Konfigurasi dibagi menjadi dua tingkat: **Reward Program** untuk aturan umum program dan **Product Reward Mapping** untuk nominal reward masing-masing produk. ### 3.1 Reward Program — konfigurasi umum | Field | Keterangan | |---|---| | Program ID | Identitas unik program reward. | | Nama program | Nama program yang ditampilkan di CMS. | | Start date / End date | Periode program berlaku. | | Status | Draft, Active, Paused, atau Ended sesuai desain status final. | | Claim mode | Tetapkan sebagai `FULL_BALANCE` untuk kebijakan saat ini; nominal claim wajib sama dengan saldo tersedia. Claim sebagian tidak diperbolehkan. | | Claim frequency | Beberapa claim dalam satu bulan dapat dilakukan jika saldo baru bertambah setelah claim sebelumnya. Setiap claim tetap harus mengambil seluruh saldo tersedia pada saat claim diproses. | | Akumulasi saldo | Aktif; saldo yang belum diklaim dibawa ke bulan berikutnya. | | Eligibility rules | Aturan konsumen, kanal, wilayah, atau syarat program lain jika diperlukan. | | IMEI uniqueness scope | Menentukan apakah satu IMEI hanya boleh mendapat reward sekali secara global, per program, atau cakupan lain yang disepakati. | | Expiry policy | Jika saldo memiliki masa berlaku, definisikan secara eksplisit; jika tidak, saldo tidak kedaluwarsa. | ### 3.2 Product Reward Mapping — konfigurasi nominal per produk Satu program dapat memiliki banyak mapping produk. Setiap produk yang eligible harus memiliki konfigurasi reward aktif untuk periode transaksi. | Field | Keterangan | |---|---| | Mapping ID | Identitas unik mapping. | | Program ID | Program yang menggunakan mapping tersebut. | | Product ID / Product Code | Identitas produk yang telah divalidasi CMS. | | Product Name | Nama produk untuk kemudahan operasional. | | Reward Amount (IDR) | Nominal reward untuk setiap IMEI valid dari produk tersebut. | | Effective From / Effective To | Tanggal mulai dan akhir berlakunya nominal. | | Status | Active atau Inactive. | | Eligibility / restrictions | Batasan tambahan untuk produk, jika ada. | | Max reward per IMEI | Default 1 kali dalam cakupan uniqueness yang disepakati. | **Contoh konfigurasi** | Program | Product | Reward per IMEI | Periode | Status | |---|---|---:|---|---| | Program A | Product A | Rp10.000 | 1–31 Oktober 2026 | Active | | Program A | Product B | Rp10.000 | 1–31 Oktober 2026 | Active | | Program A | Product C | Rp15.000 | 1–31 Oktober 2026 | Active | Jika nominal Product C diubah menjadi Rp17.500 mulai tanggal tertentu, transaksi sebelum tanggal efektif tetap memakai nominal lama. CMS harus menyimpan snapshot nominal pada ledger, bukan menghitung ulang transaksi historis dari konfigurasi terbaru. ### 3.3 Validasi hubungan IMEI dan produk Urutan yang direkomendasikan: 1. SFA mengirim IMEI, Consumer ID, Program ID, request ID, timestamp, dan metadata relevan ke CMS. 2. CMS memvalidasi format IMEI dan memeriksa eligibility serta duplikasi. 3. CMS mengambil Product ID dari database registrasi produk atau sumber data tepercaya lain. 4. CMS mencari Product Reward Mapping aktif berdasarkan Program ID, Product ID, dan tanggal transaksi. 5. Jika relasi IMEI–produk tidak dapat diverifikasi atau mapping aktif tidak ditemukan, CMS menolak reward dan mencatat alasan penolakan. 6. Jika valid, CMS mencatat transaksi reward dengan nominal snapshot dan menambahkan saldo secara atomik. Jika sumber data produk hanya tersedia melalui SFA, CMS tetap harus melakukan validasi silang sebelum memberikan reward. ## 4. Functional flow ### 4.1 Flow A — Registrasi IMEI dari SFA 1. Konsumen melakukan scan atau input IMEI di SFA. 2. SFA mengirim IMEI, Consumer ID, Program ID, request ID unik, timestamp, dan metadata yang relevan ke CMS. 3. CMS memvalidasi format IMEI, status program, eligibility konsumen, relasi IMEI–produk, dan aturan duplikasi. 4. CMS menentukan produk melalui sumber data tepercaya. 5. CMS mencari mapping reward aktif berdasarkan program, produk, dan effective date. 6. Jika valid, CMS menyimpan Reward Transaction di ledger, termasuk nominal reward snapshot, lalu menambah saldo secara atomik. 7. CMS mengirim hasil ke SFA: status validasi, nama/identitas produk yang sesuai, nominal reward yang diperoleh, dan saldo terbaru. | Hasil validasi | Perilaku sistem | |---|---| | IMEI valid dan produk memiliki mapping aktif | Catat satu transaksi EARN dan tambah saldo satu kali. | | IMEI duplikat | Tolak reward tambahan dan tampilkan alasan yang sesuai. | | Program tidak aktif / konsumen tidak eligible | Tolak transaksi dan catat alasan. | | IMEI–produk tidak dapat diverifikasi | Tolak reward; jangan mempercayai Product ID yang tidak tervalidasi. | | Tidak ada mapping reward aktif | Tolak reward dan catat alasan. | | Gangguan CMS atau timeout | Jangan menampilkan sukses sebelum konfirmasi; retry harus aman dan tidak menggandakan reward. | ### 4.2 Flow B — Claim reward dari SFA dan pembuatan Draft Vendor Bill di Odoo **Aturan claim:** satu claim harus mengambil 100% saldo tersedia pada saat CMS memproses transaksi. SFA tidak mengizinkan konsumen mengetik nominal yang lebih kecil. Ini menjaga proses Finance/Accounting lebih sederhana karena setiap claim mewakili satu penarikan seluruh saldo yang tersedia pada saat itu. 1. SFA menampilkan saldo tersedia yang dapat diklaim. 2. Konsumen memilih **Claim Full Balance**. SFA tidak menyediakan input nominal sebagian; sistem mengisi nominal claim sama dengan saldo tersedia yang ditampilkan. 3. CMS memvalidasi identitas konsumen, saldo terkini, status program, dan request ID/idempotency key. CMS memastikan nominal yang diproses sama dengan seluruh saldo tersedia pada saat transaksi dikunci. 4. CMS membuat Claim ID, mencatat debit claim, dan mengurangi saldo tersedia dalam satu transaksi database. Ini adalah titik pemotongan saldo. 5. CMS membuat event integrasi/outbox untuk pengiriman claim ke Odoo. 6. Worker integrasi mengirim data claim ke Odoo untuk membuat Draft Vendor Bill. 7. Jika bill berhasil dibuat atau ditemukan dari retry sebelumnya, CMS menyimpan Odoo Bill ID/reference dan mengubah status integrasi menjadi sukses. 8. Jika terjadi timeout atau error sementara, claim tetap tercatat dan saldo tetap terpotong; integrasi melakukan retry aman atau rekonsiliasi. 9. Claim tidak menunggu status bill Paid. Posting dan pembayaran merupakan proses terpisah di Odoo. ## 5. Detail modul CMS ### 5.1 Modul 1 — List saldo per customer **Tujuan:** memberi visibilitas saldo dan ringkasan reward per konsumen untuk operasional dan customer support. | Field / komponen | Deskripsi | |---|---| | Consumer ID / nama | Identitas konsumen sesuai master data. | | Saldo tersedia | Seluruh saldo yang dapat diklaim melalui satu full-balance claim setelah memperhitungkan transaksi ledger yang relevan. | | Total earned | Akumulasi reward dari IMEI valid. | | Total claimed | Akumulasi nominal claim yang telah dicatat sebagai debit. | | Pending integration | Nominal claim yang telah didebit tetapi integrasi Odoo belum selesai. Ini adalah indikator operasional dan tidak boleh dikurangi lagi dari saldo. | | Last activity | Tanggal transaksi reward atau claim terakhir. | | Filter | Consumer ID/nama, tanggal, program, produk, status, dan rentang saldo. | | Drill-down | Membuka reward ledger dan claim history konsumen. | Hak akses saldo dan detail konsumen dibatasi untuk role yang berwenang. Perubahan saldo manual tidak diperbolehkan tanpa transaksi adjustment/reversal yang diaudit. ### 5.2 Modul 2 — Config setup reward Modul konfigurasi menyediakan: - Pengelolaan Reward Program dan status program. - Pengaturan mode claim. Untuk kebijakan saat ini, mode harus `FULL_BALANCE`; claim sebagian tidak diperbolehkan. - Pengaturan kebijakan akumulasi saldo. - Pengelolaan Product Reward Mapping untuk nominal reward per produk. - Pengaturan effective date dan status mapping. - Validasi agar tidak ada mapping aktif yang saling tumpang tindih untuk kombinasi program–produk pada periode yang sama, kecuali aturan bisnis secara eksplisit mengizinkannya. - Audit trail untuk pembuatan, perubahan, aktivasi, dan penonaktifan konfigurasi. - Hak akses berbasis role untuk membuat, mengubah, dan mengaktifkan konfigurasi. **Aturan penting:** nominal reward dikunci sebagai snapshot pada transaksi EARN. Perubahan konfigurasi tidak mengubah transaksi historis. ### 5.3 Modul 3 — Claim history customer | Field | Deskripsi | |---|---| | Claim ID | ID unik CMS untuk setiap claim. | | Consumer ID | Pemilik claim. | | Tanggal request | Waktu konsumen melakukan claim. | | Claim amount | Nominal yang didebit dari saldo. | | Status claim | RECEIVED, REJECTED, PROCESSING, DRAFT_CREATED, PENDING_RETRY, NEEDS_RECONCILIATION, atau REVERSED. | | Integration status | QUEUED/SENDING, SUCCESS, RETRY, atau PERMANENT_ERROR. | | Odoo Bill ID / reference | Referensi dokumen Odoo jika tersedia. | | Error code/message | Alasan kegagalan integrasi untuk role berwenang. | | Retry count / last retry | Informasi operasional integrasi. | | Audit trail | Perubahan status, actor/system, timestamp, dan alasan koreksi. | Status claim CMS dan status accounting Vendor Bill Odoo harus dipisahkan. `DRAFT_CREATED` berarti draft bill telah ditemukan/dibuat, bukan berarti bill sudah diposting atau dibayar. ### 5.4 Modul 4 — Integrasi CMS ke Odoo Tujuan: setiap claim yang telah didebit di CMS diproses untuk membuat Draft Vendor Bill di Odoo. | Data | Keterangan | |---|---| | External Claim ID | Claim ID unik CMS; digunakan sebagai external reference/idempotency key. | | Vendor / Partner | Penerima tagihan yang sesuai secara legal dan telah dimapping ke Odoo. | | Company | Company Odoo yang sesuai. | | Bill date / accounting date | Mengikuti kebijakan Finance dan periode accounting yang terbuka. | | Currency | IDR, kecuali program secara eksplisit mendukung mata uang lain. | | Amount | Sama dengan nominal claim yang didebit di CMS. | | Description | Contoh: `SFA Reward Claim - [tanggal/periode]`. | | Journal / expense account / tax | Mengikuti mapping yang disetujui Finance dan konfigurasi Odoo. | | Odoo Bill ID | Disimpan di CMS setelah bill berhasil dibuat atau ditemukan saat retry. | | Target state | Draft; CMS tidak otomatis mem-posting atau membayar bill. | Nama field dan payload di atas merupakan kontrak fungsional, bukan spesifikasi API final. Detail teknis harus disesuaikan dengan versi Odoo, modul accounting, metode integrasi, dan mapping Finance. ## 6. Reward ledger dan perhitungan saldo Ledger adalah sumber kebenaran transaksi reward. Saldo tidak boleh bergantung hanya pada nilai yang dapat diedit manual di layar. | Jenis transaksi | Dampak saldo tersedia | Keterangan | |---|---:|---| | EARN | + nominal reward | IMEI valid; hanya satu kali sesuai aturan. Simpan Program ID, Product ID, IMEI reference, dan reward amount snapshot. | | CLAIM_DEBIT | − nominal claim | Dicatat ketika claim lolos validasi dan diterima CMS. | | REVERSAL / REFUND | +/- sesuai koreksi | Transaksi kompensasi dengan alasan dan audit trail. | | ADJUSTMENT | +/- sesuai persetujuan | Koreksi operasional terkontrol dan diaudit. | Formula dasar: **Saldo tersedia = total EARN − total CLAIM_DEBIT + net REVERSAL/ADJUSTMENT yang relevan** Nominal setiap claim harus sama dengan saldo tersedia yang dikunci dan divalidasi CMS pada saat claim diproses. Jika saldo langsung dipotong saat claim, nominal claim tidak boleh sekaligus dihitung sebagai reservasi yang mengurangi saldo untuk kedua kalinya. Pending integration merupakan status operasional, bukan debit tambahan. Pembuatan claim dan debit saldo harus atomik. Dua claim yang berjalan bersamaan tidak boleh menggunakan saldo yang sama atau membuat saldo menjadi negatif. Gunakan locking/conditional update atau mekanisme transaksi database yang setara. ### 6.1 Data minimum reward transaction - Reward Transaction ID - Consumer ID - Program ID - IMEI reference atau nilai yang disimpan sesuai kebijakan keamanan - Product ID / Product Code hasil validasi - Reward amount snapshot - Currency - Timestamp transaksi - Status transaksi - Request ID / idempotency key - Referensi ke claim atau transaksi koreksi jika relevan ## 7. Status lifecycle | Objek | Status | Makna | |---|---|---| | Reward | AVAILABLE | Reward tercatat dan masuk ke saldo yang dapat diklaim. | | Reward | REVERSED | Reward dikoreksi melalui transaksi kompensasi. | | Claim | RECEIVED | CMS menerima request claim. | | Claim | REJECTED | Validasi bisnis gagal; saldo tidak dipotong. | | Claim | PROCESSING | Claim tercatat dan integrasi berjalan. | | Claim | DRAFT_CREATED | Draft Vendor Bill telah dikonfirmasi ada di Odoo. | | Claim | PENDING_RETRY | Kegagalan sementara atau timeout; saldo tetap terpotong. | | Claim | NEEDS_RECONCILIATION | Hasil integrasi tidak pasti atau membutuhkan tindakan operasional. | | Claim | REVERSED | Claim dikoreksi melalui prosedur resmi. | | Integration | QUEUED / SENDING | Menunggu atau sedang mengirim request. | | Integration | SUCCESS | Bill berhasil dibuat atau ditemukan. | | Integration | RETRY | Kegagalan sementara; aman untuk dicoba ulang. | | Integration | PERMANENT_ERROR | Data atau konfigurasi perlu diperbaiki. | | Odoo Bill | Draft / Posted / Paid / Cancelled | Status accounting Odoo; terpisah dari status claim CMS. | ## 8. Monthly settlement dan rekonsiliasi Monthly settlement adalah proses pelaporan dan rekonsiliasi, **bukan reset saldo**. Saldo yang belum diklaim dibawa ke bulan berikutnya. Proses yang disarankan: 1. CMS membuat snapshot saldo awal dan saldo akhir per konsumen/program. 2. CMS merekap EARN, CLAIM_DEBIT full-balance, REVERSAL/ADJUSTMENT, serta claim yang masih pending. 3. CMS mencocokkan setiap Claim ID dengan External Reference dan Odoo Bill ID. 4. Claim yang belum memiliki bill atau memiliki status tidak cocok masuk exception report. 5. Setelah perbedaan ditangani, periode dapat ditandai reconciled. Saldo tersedia tetap dibawa ke periode berikutnya. | Komponen | Oktober | November | |---|---:|---:| | Saldo awal | Rp0 | Rp100.000 | | Earn reward | Rp100.000 | Rp150.000 | | Claim debit | Rp0 | Rp200.000 | | Saldo akhir | Rp100.000 | Rp50.000 | Contoh mengasumsikan tidak ada expiry, reversal, adjustment, atau transaksi lain. Nilai laporan harus dihitung dari ledger. ## 9. Error handling dan kontrol integrasi | Skenario | Tindakan sistem | Perlakuan saldo | |---|---|---| | Saldo tidak cukup / di bawah minimum | Reject claim dengan alasan yang jelas. | Tidak dipotong. | | Request claim terkirim ulang | Gunakan idempotency key dan kembalikan hasil claim yang sama. | Tidak ada debit ganda. | | Odoo timeout | Tandai PENDING_RETRY atau NEEDS_RECONCILIATION; cari bill berdasarkan external reference. | Tetap terpotong. | | Odoo menolak vendor/account/tax | Catat error, perbaiki mapping/data, lalu kirim ulang dengan Claim ID yang sama. | Tetap terpotong sampai resolusi. | | Bill dibuat tetapi respons hilang | Cari bill yang sudah ada; jangan membuat ulang. | Tetap terpotong. | | Error permanen | Buat exception untuk rekonsiliasi dan koreksi terkontrol. | Tidak otomatis dikembalikan. | | Bill dibatalkan setelah dibuat | Ikuti prosedur accounting dan buat reversal/refund di CMS bila disetujui. | Tidak berubah otomatis tanpa koreksi sah. | | IMEI valid terkirim ulang | Idempotency dan unique constraint mencegah EARN ganda. | Tidak ada reward ganda. | Kontrol teknis minimum: - Unique constraint untuk IMEI sesuai cakupan aturan bisnis. - Idempotency key untuk registrasi IMEI dan claim. - Transactional outbox untuk pengiriman event claim ke Odoo. - External reference unik di Odoo jika memungkinkan. - Retry dengan backoff dan batas percobaan yang jelas. - Logging, alert untuk error permanen, serta rekonsiliasi berkala. - Audit trail untuk perubahan konfigurasi dan transaksi koreksi. - Jangan melakukan refund otomatis hanya karena timeout atau respons integrasi tidak diketahui. Jika integrasi gagal permanen, saldo tidak otomatis dikembalikan. Tim operasional/Finance harus menyelesaikan exception; jika koreksi diperlukan, lakukan reversal/refund yang sah dengan audit trail. ## 10. Detail fitur SFA ### 10.1 IMEI registration / scan IMEI - Menyediakan scan kamera dan/atau input manual jika diperbolehkan. - Menampilkan loading saat CMS memvalidasi IMEI. - Menampilkan hasil valid/invalid, produk yang terverifikasi, nominal reward yang didapat, dan saldo terbaru. - Mencegah double submit di UI; CMS tetap menjadi otoritas validasi duplikasi dan nominal. - Product ID dari SFA, bila dikirim, hanya menjadi petunjuk dan tetap perlu divalidasi CMS. - Jika jaringan gagal, tampilkan status belum terkonfirmasi dan sediakan retry aman. ### 10.2 Claim reward - Menampilkan saldo tersedia dan tombol **Claim Full Balance**. - Tidak menyediakan input nominal bebas atau opsi claim sebagian. Nominal claim harus sama dengan seluruh saldo tersedia saat claim diproses. - SFA mengirim request ID unik ke CMS untuk mencegah claim ganda. - Setelah CMS mengonfirmasi claim tercatat dan saldo dipotong, SFA menampilkan nominal claim dan saldo terbaru. - Status integrasi dapat ditampilkan secara sederhana: diproses, draft bill dibuat, atau perlu bantuan. - Jangan menyatakan claim telah dibayar hanya karena Draft Vendor Bill dibuat di Odoo. ## 11. Acceptance criteria / UAT - [ ] IMEI valid menambah saldo tepat satu kali. - [ ] IMEI duplikat tidak menambah saldo. - [ ] CMS memvalidasi relasi IMEI–produk dari sumber data tepercaya. - [ ] Nominal reward mengikuti mapping program–produk dan effective date yang benar. - [ ] Perubahan konfigurasi tidak mengubah nominal reward historis. - [ ] Produk tanpa mapping aktif tidak menghasilkan reward. - [ ] Saldo reward tetap terakumulasi lintas bulan. - [ ] Claim hanya dapat dilakukan untuk seluruh saldo tersedia; claim sebagian ditolak. - [ ] Jika saldo berubah sebelum claim diproses (misalnya ada reward baru atau request paralel), CMS menghitung ulang saldo dan mengonfirmasi nominal full-balance yang benar sebelum debit. - [ ] Konsumen dapat melakukan beberapa full-balance claim dalam satu bulan jika reward baru menambah saldo setelah claim sebelumnya. - [ ] Saldo dipotong ketika claim berhasil dicatat CMS, bukan ketika bill dibayar. - [ ] Claim invalid tidak mengubah saldo. - [ ] Concurrent claim tidak menyebabkan saldo negatif atau debit ganda. - [ ] Satu Claim ID hanya menghasilkan satu Draft Vendor Bill aktif. - [ ] Timeout Odoo memicu retry/rekonsiliasi tanpa membuat bill duplikat. - [ ] CMS menyimpan Odoo Bill ID dan status integrasi. - [ ] Monthly settlement mencocokkan ledger CMS dengan dokumen Odoo. - [ ] Koreksi saldo menggunakan reversal/adjustment dengan audit trail. ## 12. Open decisions sebelum development | Topik | Keputusan yang dibutuhkan | |---|---| | Sumber IMEI–produk | Apakah CMS dapat mengakses database registrasi produk secara langsung atau perlu layanan/API dari sistem lain? | | IMEI uniqueness scope | Apakah satu IMEI hanya bisa mendapat reward sekali secara global atau sekali per program? | | Full-balance claim | Konfirmasi bahwa seluruh program menggunakan aturan full-balance dan tidak memerlukan minimum claim terpisah. | | Penerima/vendor Odoo | Apakah vendor adalah konsumen individu, distributor/partner, atau berbeda per program? | | Vendor Bill grouping | Satu bill per claim (baseline dokumen ini) atau settlement batch? | | Expiry reward | Apakah saldo reward memiliki masa berlaku? | | Claim error permanen | Siapa yang berwenang menyetujui reversal/refund jika claim tidak dapat diselesaikan? | | Odoo API | Versi Odoo, endpoint/metode integrasi, autentikasi, field wajib, dan unique external reference. | | Accounting mapping | Company, vendor, journal, expense account, tax, bill date, dan accounting date. | | Consumer master data | Bagaimana Consumer ID dipetakan ke partner/vendor Odoo dan bagaimana validasi penerima dilakukan? | | Perubahan konfigurasi | Siapa yang dapat membuat, menyetujui, dan mengaktifkan mapping reward? Apakah diperlukan maker-checker? | ## 13. Ringkasan keputusan desain SFA menangani scan IMEI dan claim request. CMS menjadi source of truth untuk konfigurasi reward, validasi IMEI–produk, reward ledger, saldo, claim history, dan integrasi. Nominal reward diatur per kombinasi program dan produk, lalu disimpan sebagai snapshot pada saat IMEI valid memperoleh reward. Claim wajib mengambil seluruh saldo tersedia; claim sebagian/cicilan tidak diperbolehkan. Saldo dipotong saat full-balance claim berhasil dicatat di CMS. Setiap claim dikirim ke Odoo untuk membuat Draft Vendor Bill tanpa approval claim tambahan di CMS. Posting dan pembayaran tetap merupakan proses terpisah di Odoo. Saldo reward diakumulasi lintas bulan; monthly settlement digunakan untuk rekonsiliasi tanpa mereset saldo.