IOSOR Panduan
Laporan mesti sepadan dengan DLR, bukan jumlah serahan
Diserah bukan bermakna dihantar. Eksport laporan kewangan dan produk mesti mengikut resit DLR — jangan sekali-kali menagih berdasarkan jumlah penerimaan API sahaja.
Jumlah serahan API memberikan rasa lega yang palsu: sistem menerima mesej, jadi minggu tersebut kelihatan berjaya. Namun kelegaan itu hilang semasa penutupan akaun kewangan. Laporan yang mengira serahan sebagai kejayaan akan bercanggah dengan resit DLR, penolakan baki dompet untuk trafik berbilang segmen, dan audit webhook.
IOSOR menetapkan peraturan tetap: eksport laporan mesti mengikut resit penghantaran (DLR). Status diserah, dalam talian gilir, dan diterima untuk dihantar kekal sebagai petunjuk operasi sahaja. Status dihantar, gagal, dan tidak diketahui ialah lajur sebenar yang diteliti oleh pasukan kewangan dan produk.
Serahan ialah petunjuk operasi, bukan metrik penutupan
Penerimaan mesej untuk dihantar sekadar membuktikan sistem memproses tugas tersebut. Ini tidak membuktikan telefon bimbit penerima telah menerima SMS. Jika KPI utama dalam laporan anda ialah jumlah serahan, anda akan melaporkan kadar kejayaan yang terlalu tinggi setiap kali peratusan status gagal atau tidak diketahui meningkat. Kekalkan jumlah serahan sebagai lajur kapasiti — jangan jadikan ia ganti rugi status dihantar.
Lajur eksport berpandukan resit DLR
Skema eksport menamakan status resit secara jelas. Status dihantar memerlukan resit DLR yang sah. Status gagal memerlukan isyarat kegagalan muktamad. Status tidak diketahui kekal tidak diketahui sehingga resit diterima — ia bukan status dihantar secara lembut. Minggu invois yang menyembunyikan status tidak diketahui di dalam kategori berjaya akan mencetuskan pertikaian mengenai kadar penghantaran sebenar.
Penyelarasan webhook dan lejar berasaskan resit yang sama
Penyelarasan audit webhook dengan eksport lejar ialah cara terbaik membuktikan laporan anda adalah tepat. Log webhook harian, status DLR, dan rekod lejar prabayar mesti menunjukkan maklumat yang konsisten. Jika webhook menunjukkan gagal manakala laporan mencatatkan kejayaan, laporan itu tidak betul — kemaskini eksport laporan dan jangan ubah baki dompet secara sewenang-wenangnya.
Tolak minggu invois berasaskan jumlah serahan
Sebarang penutupan minggu yang mengenakan bil atau meraikan pencapaian berdasarkan jumlah serahan sahaja mesti dihalang. Ubah suai laporan supaya bahagian kewangan menganalisis bahagian dihantar dan tidak diketahui. Jika kontrak rakan kongsi menggunakan terma serahan API berjaya, terjemahkan frasa tersebut kepada nota DLR tanpa mengubah lajur laporan.
Laluan operasi berkaitan
- Minggu invois DLR: bahagian tidak diketahui tidak dihantar
- Penyelarasan Log Webhook Harian dengan Baki Prabayar
- Invois SMS Minggu Pertama: Apabila Matematik Segmen dan Bil Bercanggah
Mulakan dengan IOSOR
Buka pakej laporan minggu ini dalam konsol IOSOR dan pastikan setiap KPI tajuk berasaskan resit DLR — delivered, failed dan unknown — bukan submit atau accept API. Jika carta masih mengira submit sebagai kejayaan, namakan semula atau buang sebelum tutup kewangan. Eksport sekali dan kongsi lajur resit yang sama untuk produk dan kewangan.
Inti IOSOR
Laporan ditutup dengan resit DLR: delivered, failed dan unknown — bukan submit. Submit hanya untuk throughput, bukan kebenaran penghantaran atau hujah invois.
Lakukan: satu skema eksport dikunci kepada medan resit. Jangan: produk meraikan accept sementara kewangan bertengkar failed DLR.
Adakah panduan ini membantu?
Panduan berkaitan
- Pandangan laporan berbanding baris lejar dompet mentah
Pandangan laporan kewangan dan produk merangkum DLR dan perbelanjaan. Baris lejar dompet mentah kekal di bawah eksport Dompet — jangan anggap CSV laporan sebagai lejar.
- Kewangan dan produk berkongsi satu eksport yang sama
Papan pemuka produk dan penutupan kewangan mesti membaca eksport DLR yang sama. Lembaran kerja kedua dengan status yang lebih mesra adalah punca kegagalan penyelarasan.