24 KiB
| judul | proyek | terkait | stack | kategori | status | tipe | tags | diperbarui | |||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| SFA — Reward Claim ke Odoo (Draft Vendor Bill) | SFA CMS · mito_odoo | Mito · Odoo 18 · SFA Mobile | Odoo 18 (mito_base REST API) · Laravel 11 · Filament 3 · MySQL · PostgreSQL | Integrasi | CMS di-push ke develop (46fc3c7) · Odoo di-commit lokal cj/api (a5cc341e), belum di-push · teruji di lokal 14-10-2026 | dokumen-internal |
|
2026-10-15 |
Index: SFA — Index · Kategori: Integrasi · FDD: SFA–CMS Reward Claim Integration to Odoo 18 (v0.4) · Fitur induk: SFA — Reward
Setiap claim reward yang sudah memotong saldo di CMS dikirim ke Odoo dan dibuatkan Draft Vendor Bill: vendor sesuai user, product sesuai parameter, amount sesuai claim. Integrasi satu arah (CMS → Odoo), aman di-retry karena idempotent per Claim ID. Posting & pembayaran tetap oleh Finance di Odoo.
Diagram untuk meeting: SFA — Reward Claim ke Odoo (diagram).excalidraw — buka di excalidraw.com lewat menu Open.
SFA — Reward Claim ke Odoo (Draft Vendor Bill)
Alur Claim → Draft Vendor Bill
Kode status dan error di bawah sama persis dengan kode (integration_status / status di tabel reward_claim,
error.code dari API Odoo).
flowchart TD
A["SFA Mobile / Admin CMS:<br/>Claim full balance"] --> B["CMS: reward_claim dibuat + saldo dipotong<br/>status PROCESSING · integration QUEUED"]
B --> C["Worker odoo:push-reward-claims (tiap menit)<br/>ambil QUEUED · RETRY jatuh tempo · SENDING macet > 10 mnt"]
C --> D["Kunci claim → SENDING<br/>POST /api/v1/reward-bills"]
D --> E{"Odoo: Claim ID sudah<br/>punya bill?"}
E -- "ya" --> E1["200 · created=false<br/>bill lama dikembalikan"]
E -- "tidak" --> F{"nominal > 0?"}
F -- "tidak" --> F1["422 validation_error"]
F -- "ya" --> G{"Vendor dengan CMS User ID<br/>(company cocok)?"}
G -- "tidak ada" --> G1["422 vendor_not_found"]
G -- "lebih dari 1" --> G2["422 vendor_duplicate"]
G -- "diarsipkan" --> G3["422 vendor_inactive"]
G -- "tepat 1, aktif" --> H{"Default Reward Product<br/>valid?"}
H -- "kosong" --> H1["422 reward_product_not_set"]
H -- "tidak aktif / bukan Purchase /<br/>company lain" --> H2["422 reward_product_invalid"]
H -- "ya" --> I["Create Draft Vendor Bill<br/>201 · created=true"]
I -. "request paralel, Claim ID sama" .-> I1["409 claim_in_progress"]
E1 --> S["CMS: SUCCESS · DRAFT_CREATED<br/>simpan odoo_bill_id + odoo_bill_ref"]
I --> S
F1 & G1 & G2 & G3 & H1 & H2 --> P["CMS: PERMANENT_ERROR · NEEDS_RECONCILIATION<br/>tidak di-retry otomatis"]
P --> Q["Admin perbaiki data di Odoo<br/>→ tombol Kirim Ulang ke Odoo"]
Q --> D
D -- "timeout · koneksi · 5xx · 401 · 404" --> R["CMS: RETRY · PENDING_RETRY<br/>jeda 1 · 5 · 15 · 30 · 60 mnt"]
I1 --> R
R -- "next_retry_at lewat" --> C
R -- "gagal ke-10" --> P
S -.-> T["Finance: review → Post → Bayar di Odoo<br/>(di luar integrasi)"]
classDef ok fill:#d1fae5,stroke:#059669,color:#064e3b
classDef err fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
classDef warn fill:#fef3c7,stroke:#d97706,color:#78350f
classDef todo fill:#f3f4f6,stroke:#9ca3af,color:#374151,stroke-dasharray:4 3
class E1,I,S ok
class F1,G1,G2,G3,H1,H2,P err
class R,Q,I1 warn
class T todo
Hijau = sukses, merah = ditolak (tidak di-retry otomatis), kuning = retry / butuh tindakan admin, abu-abu putus-putus = di luar integrasi. Saldo user tidak pernah dikembalikan otomatis di cabang mana pun (FDD §7).
Alur Status Integrasi
stateDiagram-v2
[*] --> QUEUED : claim dibuat (Node API / CMS)
QUEUED --> SENDING : worker mengunci claim
SENDING --> SUCCESS : 200 / 201
SENDING --> PERMANENT_ERROR : 422 (mapping / konfigurasi)
SENDING --> RETRY : timeout, koneksi, 5xx, 409, 401, 404
SENDING --> SENDING : macet lebih dari 10 menit, diambil ulang
RETRY --> SENDING : next_retry_at lewat, atau tombol Kirim Ulang
RETRY --> PERMANENT_ERROR : gagal ke-10
PERMANENT_ERROR --> SENDING : tombol Kirim Ulang ke Odoo
SUCCESS --> [*]
integration_status |
status claim |
Arti | Tombol Kirim Ulang ke Odoo |
|---|---|---|---|
QUEUED |
PROCESSING |
Baru, menunggu worker | Tidak (otomatis) |
SENDING |
PROCESSING |
Sedang dikirim | Tidak |
SUCCESS |
DRAFT_CREATED |
Draft bill ada di Odoo (bukan sudah posted/dibayar) | Tidak |
RETRY |
PENDING_RETRY |
Gagal sementara, dicoba lagi otomatis | Ya (kirim sekarang) |
PERMANENT_ERROR |
NEEDS_RECONCILIATION |
Data Odoo belum benar, atau gagal 10x | Ya (setelah data diperbaiki) |
Retry Setelah Timeout — Kenapa Tidak Dobel
sequenceDiagram
participant W as Worker CMS
participant O as Odoo /api/v1/reward-bills
participant DB as PostgreSQL Odoo
W->>O: POST claim_id=RCL261014000001
O->>DB: INSERT account_move (snk_reward_claim_ref = RCL…001)
Note over W,O: Respons hilang (timeout) — bill sebenarnya sudah dibuat
W->>W: RETRY · next_retry_at = +1 menit
W->>O: POST claim_id=RCL261014000001 (sama)
O->>DB: cari snk_reward_claim_ref = RCL…001
DB-->>O: bill #28148 sudah ada
O-->>W: 200 · created=false · id 28148
W->>W: SUCCESS · DRAFT_CREATED
Note over O,DB: Dua request bersamaan: INSERT kedua ditolak unique constraint<br/>→ 409 claim_in_progress → CMS retry → dapat bill yang sama
1. Keputusan Teknis
| # | Hal | Keputusan | Alasan |
|---|---|---|---|
| 1 | Metode integrasi (FDD §10 #1) | Custom REST API di mito_base (POST /api/v1/reward-bills), bukan External API XML-RPC |
Field vendor & setting product wajib ditambah lewat module juga; idempotensi + validasi jadi satu transaksi di Odoo (External API = 3–4 call terpisah, rawan dobel); API key cuma bisa satu aksi ini (External API butuh user Accounting/Settings); error code jelas untuk CMS; polanya sama dengan endpoint IMEI/customer/product yang sudah dipakai OdooClient |
| 2 | Nama field CMS User ID (FDD §10 #2) | snk_cms_user_id (Char), bukan x_cms_user_id |
Prefix x_ untuk field Studio/manual; module ini konsisten pakai snk_. Char sesuai rekomendasi FDD §3.1 |
| 3 | Isi CMS User ID | users.id CMS (akun login yang claim), bukan empl_code employee |
Claim tercatat per users.id. Tidak semua pengklaim punya employee (konsumen hasil registrasi); di data lokal user Rahmat (57) dan employee Rahmat (20250404) bahkan tidak terhubung. Kolom CMS User ID dimunculkan di CMS supaya admin bisa menyalinnya |
| 4 | Keunikan (FDD §10 #3) | UNIQUE(snk_cms_user_id) global & UNIQUE(snk_reward_claim_ref) lewat _sql_constraints |
Tahan request paralel (cek Python bisa lolos dua-duanya), sekaligus jadi index. NULL tidak bentrok. Kalau nanti unik per company → unique(snk_cms_user_id, company_id) |
| 5 | Idempotensi | Claim ID (claim_code CMS) disimpan di field khusus account.move.snk_reward_claim_ref, bukan hanya di ref |
ref (Bill Reference) bisa diedit Finance dan tidak bisa diberi unique. Field khusus readonly, copy=False |
| 6 | Company (FDD §10 #4) | Company default user API (env.company) |
Satu company saat ini. Product setting disimpan per company (res.company), siap multi-company |
| 7 | Jurnal, akun, pajak (FDD §10 #6) | Default Odoo: jurnal purchase default, akun expense dari product/kategori, pajak dari Vendor Taxes product | Menunggu keputusan Finance — lihat §8 |
| 8 | Klasifikasi gagal | 422 = permanen (data/konfigurasi salah, tidak di-retry); lainnya = sementara (retry bertahap) |
Mengulang request yang mapping-nya salah tidak akan pernah berhasil; timeout/Odoo mati bisa pulih sendiri |
| 9 | Referensi bill balik ke CMS | Disimpan dari respons create saja (odoo_bill_id, odoo_bill_ref), tidak ada sinkronisasi status setelahnya |
FDD §8 (one-way) vs Acceptance Criteria #7 (referensi tersimpan) saling bertentangan → diambil jalan tengah. Perlu dikonfirmasi |
2. Setup Sebelum Dipakai
Odoo (sekali per database):
- Buat product, misalnya Reward SFA: tipe Service, centang Purchase (=
purchase_ok), Vendor Taxes kosong, isi Expense Account di tab Accounting sesuai keputusan Finance. - Accounting → Configuration → Settings → Vendor Bills → Default Reward Product → pilih product tadi → Save.
- Tiap vendor penerima reward: Contact → tab Sales & Purchase → CMS User ID =
users.idCMS. Field hanya tampil untuk grup Accounting Administrator. Contact wajib punya Account Receivable/Payable (lihat §9 temuan #1). - Settings → Technical → System Parameters:
mito_base.api_key(string acak ≥32 karakter,openssl rand -hex 32) danmito_base.api_user_id(user yang boleh membuat Vendor Bill).
CMS (.env): ODOO_URL, ODOO_DB, MITO_API_KEY (= mito_base.api_key). Cron php artisan schedule:run
tiap menit harus aktif (sama dengan sync IMEI).
3. Penjelasan Kode — Odoo (mito_odoo/mito/mito_base)
Commit a5cc341e [ADD][MITO] REST API Draft Vendor Bill dari Claim Reward SFA (branch cj/api). Versi module
18.0.1.0.1 → 18.0.1.0.2. Tanpa migration script: hanya menambah kolom + constraint, tidak ada perubahan destruktif.
3.1 models/account/snk_reward_claim_bill.py (baru) — logika utama
Semua aturan bisnis ada di sini, bukan di controller, supaya bisa di-test dengan TransactionCase dan bisa dipanggil
dari jalur lain (misalnya server action) tanpa HTTP.
| Bagian | Isi |
|---|---|
RewardClaimBillError(UserError) |
Exception dengan atribut code (vendor_not_found, dst.). Controller mengubahnya jadi HTTP 422 + error.code |
Field snk_reward_claim_ref |
Char, copy=False, readonly=True. Duplikat bill (menu Duplicate) tidak membawa Claim ID |
_sql_constraints snk_reward_claim_ref_uniq |
unique(snk_reward_claim_ref) — jaminan satu Claim ID = satu bill di level database |
_snk_find_reward_claim_bill() |
Cari bill berdasarkan Claim ID dengan sudo(): cek duplikat harus melihat semua bill, termasuk yang tersembunyi ir.rule Operating Unit user API. sudo() hanya untuk satu search ini |
_snk_get_reward_vendor() |
Cari res.partner dengan snk_cms_user_id sama persis dan company_id kosong / sama. active_test=False supaya vendor arsip terdeteksi sebagai vendor_inactive, bukan vendor_not_found. limit=2 cukup untuk mendeteksi duplikat |
_snk_get_reward_product() |
Baca env.company.snk_reward_claim_product_id; tolak kalau kosong, tidak aktif, bukan Purchase, atau milik company lain |
snk_create_reward_claim_bill() |
Urutan: validasi wajib isi → cek bill lama dulu (return (bill, False)) → nominal > 0 → vendor → product → create() in_invoice dengan 1 line (qty 1, price_unit = amount, label Reward Claim <Claim ID>), ref + snk_reward_claim_ref = Claim ID, invoice_date = tanggal claim bila dikirim |
savepoint() + UniqueViolation |
Kalau dua request paralel lolos cek "bill lama", INSERT kedua ditolak constraint → savepoint di-rollback → claim_in_progress (409). Cursor tetap sehat |
Cek bill lama dilakukan sebelum validasi lain dengan sengaja: retry claim yang sudah punya bill harus selalu sukses, walaupun setelah itu vendor diarsipkan atau setting product diubah.
3.2 controllers/api/reward_bills.py (baru) — endpoint REST
@api_route('/reward-bills', methods=['POST'], tags=['Reward'], body=..., response=...): otomatis terdaftar di Swagger/api/v1/docs(lewatAPI_REGISTRYdicore.py) dan mewarisi auth Bearer, format JSON, serta rollback saat error.- Parsing
amount: helperget_floatdicore.pymenganggap0sama dengan "kosong" (0 in (None, '', False)di Python bernilaiTrue). Angka dari JSON diterima langsung supayaamount: 0ditolak dengan pesan yang benar ("Nominal claim harus lebih dari 0"), bukan "amount is required".core.pysengaja tidak diubah karena dipakai endpoint lain. claim_datedivalidasi formatYYYY-MM-DD(fields.Date.to_date).RewardClaimBillError→ApiError(message, 422 | 409, code)._ERROR_STATUSmemetakanclaim_in_progresske 409.serialize_bill():namedikirimnullselama draft belum bernomor (Odoo 18 mengisiFalse//),createdmembedakan 201 dan 200.
3.3 models/base/res_partner.py — field CMS User ID
snk_cms_user_id = fields.Char(copy=False, tracking=True) + unique(snk_cms_user_id). tracking=True mencatat setiap
perubahan mapping di chatter contact (audit FDD §3.3). copy=False supaya duplikat contact tidak langsung bentrok constraint.
3.4 models/base/snk_res_company.py + snk_res_config_settings.py — Default Reward Product
res.company.snk_reward_claim_product_id: Many2oneproduct.product(varian, bisa langsung dipakai di invoice line — FDD §3.2), domainpurchase_ok = True,check_company=True.res.config.settings.snk_reward_claim_product_id:related='company_id.…',readonly=False→ disimpan otomatis olehset_values()bawaan saat tombol Save di Settings ditekan. Disimpan per company, bukan diir.config_parameter, supaya siap multi-company dan tidak butuh hak Settings untuk membacanya.
3.5 View
| File | Perubahan |
|---|---|
views/base/res_partner.xml |
View baru view_partner_property_form_snk_cms_user inherit account.view_partner_property_form: field CMS User ID tepat setelah Payment Terms (tab Sales & Purchase → Purchase), groups="account.group_account_manager" |
views/account/snk_account_setting_view.xml |
Setting Default Reward Product di block account_vendor_bills (record yang sama dengan Print Out Parameter), company_dependent="1", no_create |
3.6 tests/test_reward_claim_bill.py (baru) — 11 test
TransactionCase, tag post_install -at_install. Mencakup: bill draft terbentuk benar, retry Claim ID sama →
bill sama (count 1), claim_date → Bill Date, CMS User ID di-trim, vendor_not_found, vendor_inactive,
reward_product_not_set, reward_product_invalid, nominal 0/negatif, Claim ID kosong, unique CMS User ID
(IntegrityError di dalam savepoint).
4. Penjelasan Kode — CMS (snk_sfa-cms)
Commit 46fc3c7 add : kirim claim reward ke Odoo sebagai Draft Vendor Bill (outbox tiap menit) — di-push ke develop.
Tidak ada migration: semua kolom (integration_status, retry_count, next_retry_at, odoo_bill_id, …) sudah dibuat
di migration reward 2026_10_13_000003.
4.1 app/Services/OdooClient.php — tambah post()
get()danpost()sekarang memakai satuparse(): sukses →['data', 'meta', 'status']; gagal →OdooApiException(turunanRuntimeException, jadi pemanggil lama yang menangkapRuntimeException/Throwabletetap jalan).- Retry koneksi bawaan (
retry(3, 2000)untukConnectionException) tetap berlaku juga untuk POST. Aman karena endpoint idempotent.
4.2 app/Services/OdooApiException.php (baru)
Membawa status (HTTP), errorCode (error.code Odoo, mis. vendor_not_found) dan errorMessage (pesan asli Odoo
untuk ditampilkan ke admin).
4.3 app/Services/RewardClaimOdooService.php (baru) — inti pengiriman
| Method | Isi |
|---|---|
dueQuery() |
Claim yang siap dikirim: QUEUED, RETRY dengan next_retry_at sudah lewat (atau null), dan SENDING yang macet > STALE_SENDING_MINUTES (10) — misalnya proses PHP mati di tengah request |
send($claim, $force) |
acquire() → post('reward-bills', {claim_id: claim_code, cms_user_id: (string) user_id, amount, claim_date: requested_at WIB}) → tandai hasil. Return false kalau claim sedang dipegang proses lain |
acquire() |
Update bersyarat (UPDATE … SET integration_status='SENDING' WHERE id=? AND <masih due>), dicek jumlah baris yang berubah. Dua worker atau worker + klik admin tidak bisa memegang claim yang sama. $force (tombol / --claim) melewati syarat jatuh tempo tapi tetap menolak SUCCESS dan SENDING yang masih segar |
markSuccess() |
SUCCESS / DRAFT_CREATED, simpan odoo_bill_id, odoo_bill_ref = nomor bill, atau Bill Reference (= Claim ID) kalau draft belum bernomor; error dibersihkan |
markPermanent() |
PERMANENT_ERROR / NEEDS_RECONCILIATION, simpan error_code + error_message, next_retry_at null |
markRetry() |
RETRY / PENDING_RETRY, retry_count + 1, next_retry_at = sekarang + RETRY_DELAYS (1, 5, 15, 30, 60 menit; selebihnya 60). Gagal ke-MAX_RETRY (10) → markPermanent() |
Pemetaan error: OdooApiException 422 → permanen; OdooApiException lain (401, 404, 409, 5xx) dan
ConnectionException (timeout) → retry; Throwable lain → retry + Log::error.
4.4 app/Console/Commands/PushRewardClaimsToOdoo.php (baru) — worker
php artisan odoo:push-reward-claims— ambildueQuery()urutid(claim lama duluan),--limit=50per jalan, dilindungiCache::lock(600 detik) supaya tidak ada dua worker paralel.--claim=RCL…— kirim satu claim tertentu denganforce(termasukPERMANENT_ERROR). Berguna untuk debug di server.- Output per claim:
RCL… → STATUS (bill #id) [error_code] pesan.
4.5 routes/console.php — jadwal
Schedule::command('odoo:push-reward-claims')->everyMinute()->withoutOverlapping(10), log ke
storage/logs/odoo-push-reward-claims.log. Jadi claim masuk Odoo paling lambat ±1 menit setelah user klik Claim.
4.6 Filament
| File | Perubahan |
|---|---|
RewardClaimResource.php |
Action sendToOdooAction() Kirim Ulang ke Odoo: hanya tampil untuk PERMANENT_ERROR & RETRY; dialog konfirmasi menampilkan error terakhir; hasil → notifikasi hijau (Bill #id) atau merah persistent ([error_code] pesan). Kolom + entry CMS User ID (user_id, copyable) |
RewardClaimResource/Pages/ViewRewardClaim.php |
Action yang sama di header halaman detail |
RewardBalanceResource.php |
Kolom + entry CMS User ID dengan petunjuk "Isi di Odoo: Vendor → Sales & Purchase → CMS User ID" |
UserResource.php |
Kolom id diberi label CMS User ID, tampil default (sebelumnya tersembunyi), copyable & searchable |
5. Kontrak API
POST /api/v1/reward-bills · Header Authorization: Bearer <mito_base.api_key> · Swagger: /api/v1/docs tag Reward
{ "claim_id": "RCL261014000001", "cms_user_id": "57", "amount": 250000, "claim_date": "2026-10-14" }
| Field | Wajib | Keterangan |
|---|---|---|
claim_id |
✅ | reward_claim.claim_code, idempotency key |
cms_user_id |
✅ | reward_claim.user_id (= users.id), dicocokkan ke res.partner.snk_cms_user_id |
amount |
✅ | > 0, IDR |
claim_date |
– | YYYY-MM-DD → Bill Date. Kosong = diisi Finance / saat posting |
description |
– | Ditambahkan ke label line setelah Claim ID |
Respons sukses (201 baru, 200 sudah ada):
{ "success": true, "data": { "id": 28148, "name": null, "state": "draft", "claim_id": "RCL261014000001",
"ref": "RCL261014000001", "partner": {"id": 11081, "name": "Administrator test"},
"product": {"id": 67653, "name": "Reward SFA"}, "invoice_date": "2026-10-14", "currency": "IDR",
"amount_untaxed": 250000.0, "amount_tax": 0.0, "amount_total": 250000.0, "created": true } }
| HTTP | error.code |
Arti | Perlakuan CMS |
|---|---|---|---|
| 422 | vendor_not_found |
Tidak ada vendor dengan CMS User ID ini | Permanen |
| 422 | vendor_duplicate |
CMS User ID di >1 vendor (secara teori dicegah constraint) | Permanen |
| 422 | vendor_inactive |
Vendor diarsipkan | Permanen |
| 422 | reward_product_not_set |
Default Reward Product kosong | Permanen |
| 422 | reward_product_invalid |
Product tidak aktif / bukan Purchase / company lain | Permanen |
| 422 | validation_error |
Field wajib kosong, nominal ≤ 0, format tanggal salah | Permanen |
| 409 | claim_in_progress |
Request paralel Claim ID sama | Retry |
| 401 | unauthorized |
API key salah / tidak ada | Retry |
| 404 | – | Endpoint belum di-deploy di server Odoo tujuan | Retry |
6. Pengujian (lokal, 14-10-2026)
Unit test Odoo di MITO_DEV: --test-tags /mito_base:TestRewardClaimBill → 11 test, 0 gagal (1,29 detik). Saat
menjalankan test, server web lokal sedang memakai 8069, jadi perlu --http-port=8099 --gevent-port=8098.
Manual via API (curl ke localhost:8070):
| # | Skenario | Hasil |
|---|---|---|
| 1 | Claim baru, Rp 250.000 | ✅ 201, bill #28148 Draft, vendor + product + amount benar, pajak 0 |
| 2 | Kirim ulang Claim ID sama | ✅ 200, created:false, id sama — 1 bill di DB |
| 3 | cms_user_id tidak dikenal |
✅ 422 vendor_not_found |
| 4 | amount 0 / negatif / tidak dikirim |
✅ 422 pesan sesuai |
| 5 | Tanpa Authorization | ✅ 401 unauthorized |
| 6 | claim_date format salah |
✅ 422 validation_error |
Dari CMS (odoo:push-reward-claims --claim= dan tombol): claim RCL261013000001 → PERMANENT_ERROR [vendor_not_found] (CMS User ID 57 belum dipasang di Odoo — perilaku benar). Klik tombol saat .env masih mengarah ke
mitodev → RETRY [http_404] karena endpoint belum di-deploy di mitodev — juga perilaku benar.
7. Deploy
| Repo | Commit | Status |
|---|---|---|
mito_odoo |
a5cc341e di cj/api |
⚠️ Belum di-push. cj/api lokal bercabang dari origin/cj/api (commit IMEI lama ter-rebase ulang). Rencana: rebase commit reward ke atas origin/develop, -u mito_base + test ulang di lokal, lalu push (fast-forward) dan PR ke develop |
snk_sfa-cms |
46fc3c7 di develop |
✅ Di-push 14-10-2026, belum di-deploy |
Urutan wajib: Odoo dulu (-u mito_base --stop-after-init, setup §2), baru CMS. Kalau CMS naik duluan, claim
akan RETRY [http_404] sampai Odoo siap (tidak rusak, hanya tertunda; setelah 10x jadi PERMANENT_ERROR dan perlu
diklik Kirim Ulang).
8. Keputusan Terbuka (bahan meeting)
| # | Hal | Kondisi sekarang | Perlu keputusan |
|---|---|---|---|
| 1 | Expense account | Ikut kategori product All → 510.1000.00 Harga Pokok Penjualan |
Akun beban reward/promosi yang benar → isi di product Reward SFA (tanpa ubah kode) |
| 2 | Journal | Default purchase journal → ADV Advance Purchase |
Jurnal mana? Kalau perlu tetap, tambah setting Default Reward Journal (kecil, di samping Default Reward Product) |
| 3 | Pajak | Ikut Vendor Taxes product (sekarang kosong) | Termasuk / di luar pajak? PPh atas reward? |
| 4 | Operating Unit / analytic | Kosong di bill | Perlu? Kalau ya, ambil dari mana (OU vendor?) |
| 5 | Pemilik mapping | Admin Accounting mengisi CMS User ID manual per vendor | Siapa yang bertanggung jawab, kapan diisi (sebelum user boleh claim?) |
| 6 | Vendor = siapa | Contact Odoo apa pun yang diberi CMS User ID | Konsumen individu, dealer, atau per program? Perlu master vendor baru per user? |
| 7 | Referensi bill di CMS | Disimpan dari respons create (FDD §8 vs AC #7 bertentangan) | Konfirmasi ke tim FDD |
| 8 | Keunikan lintas company | Global | Cukup global, atau per company? |
9. Temuan Selama Pengujian
MITO_DEV: 407 dari 677 contact aktif tidak punya Account Receivable/Payable (tidak adair.defaultuntukproperty_account_receivable_id/payable_id), sehingga form contact menolak disimpan. Tidak terkait fitur ini; untuk testing diisi manual115.1010.00 Piutang Usaha/211.1010.00 Hutang Usaha. Cek apakah production sama.- CMS User ID ≠ Employee Code. Admin sempat mengisi
20250404(kode employee Rahmat), padahal claim milikusers.id57. Solusinya kolom CMS User ID ditampilkan di Users, Reward Balance, dan Claim History. get_floatdicontrollers/api/core.pymenganggap0= kosong (0 == False). Diakali di endpoint reward; endpoint lain (qty,price_unitdi sale order) punya perilaku yang sama — kandidat perbaikan terpisah.mito_base.api_keydiMITO_DEVhanya 12 karakter — server lain wajib ≥32 karakter.- Untuk test lokal,
.envCMS diarahkan kehttp://localhost:8070/MITO_DEV(nilai mitodev dikomentari di atasnya). Kembalikan sebelum kerja lain yang butuh sync dari mitodev.