Skima ya XML ya goAML v5.0.2: marejeo ya sehemu za lazima za CTR na STR
Marejeo kamili ya sehemu za lazima za XSD v5.0.2 ya goAML kwa uwasilishaji wa CTR na STR — majina ya sehemu, aina za data, kanuni mahususi za Kenya, na masharti ya uthibitishaji.
Afisa uzingatiaji anapowasilisha taarifa ya miamala ya fedha taslimu (CTR) au taarifa ya miamala yenye mashaka (STR) kwa Financial Reporting Centre (FRC) ya Kenya, lango la goAML la FRC halipokei fomu wala lahajedwali. Linapokea faili ya XML ambayo lazima ifuate kikamilifu skima ya XSD v5.0.2 ya goAML — maelezo rasmi yanayoweza kutekelezwa na mashine kuhusu kila elementi, aina ya data, kikomo cha urefu na kanuni ya kimuundo ambayo ripoti halali lazima iitimize.
Visa vingi vya kukataliwa kwa ripoti vinatokana na mojawapo ya vyanzo viwili vya msingi: timu ya TEHAMA ya taasisi inayowajibika kuripoti ilitengeneza faili ya XML isiyokidhi skima, au timu ya uzingatiaji iliandaa data isiyotimiza masharti ya sehemu za lazima mahususi kwa Kenya, ambayo yanaongezwa juu ya skima ya msingi. Matatizo yote mawili yanaweza kuzuiwa kwa kuwa na marejeo sahihi.
Makala hii ndiyo marejeo hayo. Inatoa uchambuzi kamili, sehemu kwa sehemu, wa elementi za lazima za XML kwa uwasilishaji wa CTR na STR kwa FRC ya Kenya, aina za data na masharti ya muundo ambayo kila sehemu inalazimisha, na kanuni mahususi za Kenya zinazotumika zaidi ya XSD ya msingi. Wasanidi programu wa TEHAMA wanaojenga michakato ya kutengeneza XML (pipelines) na maafisa uzingatiaji wanaopitia ubora wa data kabla ya kuwasilisha watapata hapa kila wanachohitaji.
Kuelewa skima ya XSD v5.0.2 ya goAML
Maana ya uthibitishaji wa skima ya XSD na kwa nini ni muhimu
XSD (XML Schema Definition) ni maelezo rasmi yaliyoandikwa kwa XML yanayofafanua muundo unaoruhusiwa, majina ya elementi, aina za data, masharti ya thamani, na idadi ya kujitokeza (cardinality — inayohitajika au ya hiari, idadi ya chini/ya juu ya kujitokeza) kwa kila elementi katika hati ya XML inayohusika.
Lango la goAML la FRC linapopokea XML uliyowasilisha, huipitisha faili kwenye kikagua skima ya XSD kabla mchambuzi yeyote hajaiona. Kikagua hicho hukagua kila elementi katika faili dhidi ya kanuni zilizofafanuliwa katika skima ya XSD v5.0.2 ya goAML. Ikiwa elementi yoyote inakiuka kanuni yoyote — sehemu ya lazima inayokosekana, tarehe katika muundo usio sahihi, maandishi yanayozidi urefu wake wa juu, thamani isiyo kwenye orodha ya thamani zinazoruhusiwa — kikagua hurudisha kosa la uthibitishaji wa skima na uwasilishaji wote hukataliwa.
Uthibitishaji wa skima una majibu mawili tu: faili ama inapita kikamilifu ama inashindwa. Faili yenye elementi 99 sahihi na tarehe moja yenye muundo mbovu inashindwa kwa uhakika uleule kama faili yenye makosa ya msingi ya kimuundo. Ndiyo sababu uthibitishaji wa XSD kabla ya kuwasilisha si hiari — ni kiwango cha chini kwa mchakato wowote wa kutengeneza CTR au STR.
Ngazi sita za mpangilio wa skima
Skima ya XSD v5.0.2 ya goAML hupanga data ya ripoti katika muundo wa kidaraja wenye ngazi sita. Kuelewa mpangilio huu ni muhimu kwa wasanidi programu wanaoandika msimbo wa kutengeneza XML na kwa timu za uzingatiaji zinazopitia XML inayotolewa.
Ngazi ya 1: Report (ripoti) — Elementi ya msingi (root) ya hati ya XML. Ina sehemu za kichwa cha ripoti zinazotambulisha aina ya ripoti, taasisi inayoripoti, tarehe ya uwasilishaji na afisa uzingatiaji anayehusika. Kila CTR na STR huanza na elementi hii.
Ngazi ya 2: Transaction (muamala) — Elementi moja au zaidi za muamala zilizo ndani ya Report. Kila elementi ya Transaction inaeleza muamala mmoja wa kifedha, ikijumuisha tarehe yake, kiasi, sarafu na aina. Ripoti ya CTR hutengenezwa kwa kila muamala unaostahili kuripotiwa ulio sawa na au zaidi ya kiwango cha kiasi kinacholingana na USD 15,000. Kwa kawaida STR huwa na elementi moja au zaidi za Transaction zinazohusishwa na shughuli yenye mashaka inayoripotiwa.
Ngazi ya 3: Party (mhusika) — Kila Transaction ina elementi za Party zinazotambulisha watu binafsi au taasisi walio kila upande wa muamala. Wahusika huainishwa kulingana na nafasi yao: from_person au from_entity kwa upande wa kutoa fedha (debit), to_person au to_entity kwa upande wa kupokea fedha (credit). Kwa amana ya fedha taslimu, mteja ni from_person na benki ni to_entity.
Ngazi ya 4: Account (akaunti) — Elementi za Account ziko ndani ya elementi za Party. Zina namba ya akaunti, msimbo wa tawi, aina ya akaunti na sarafu ya akaunti ambayo muamala ulipitia. Elementi ya Account inahitajika popote namba ya akaunti inapojulikana.
Ngazi ya 5: ID (kitambulisho) — Elementi za hati ya utambulisho ziko ndani ya elementi za Party za aina ya mtu binafsi (Person). Zinarekodi aina ya hati ya utambulisho (kitambulisho cha taifa — National ID, pasipoti, kitambulisho cha mgeni — alien ID), namba ya hati, nchi iliyoitoa, na tarehe ya kuisha kwa muda wake pale inapohusika. Kwa raia wa Kenya, elementi ya National ID ni ya lazima.
Ngazi ya 6: Address (anwani) — Elementi za Address ziko ndani ya elementi za Party (watu binafsi na taasisi). Zinarekodi nchi, kaunti/jimbo, jiji/mji na anwani ya mtaa ya mhusika. Kwa uwasilishaji kwa FRC ya Kenya, angalau nchi na mji vinahitajika.
Tofauti kati ya miundo ya skima ya STR na CTR
Ripoti za STR na CTR zote hutumia skima ileile ya msingi ya XSD v5.0.2 ya goAML. Hutofautishwa kwa thamani ya elementi ya report_type (CTR au STR) na kwa sehemu mahususi za lazima zinazohusu kila aina.
Kwa CTR, msisitizo wa lazima uko kwenye data sahihi ya muamala: kiasi, sarafu, aina za miamala, na utambulisho wa mteja uliothibitishwa kwa National ID. Sehemu ya maelezo (narrative) haihusiki.
Kwa STR, msisitizo wa lazima unahamia kwenye msingi wa shaka: sehemu ya reason (maelezo) ni ya lazima na lazima iwe na maudhui ya maana; alama ya is_suspicious lazima iwekwe kuwa TRUE; misimbo ya viashiria lazima ijazwe; na maelezo lazima yahusishe miamala na mbinu ya uhalifu (typology) inayotambulika katika AML (kupambana na utakatishaji fedha haramu). Data ya miamala bado inahitajika, lakini maudhui ya kiuchambuzi ya ripoti yana uzito mkubwa zaidi katika skima.
Nyongeza mahususi za nchi katika usanidi wa FRC ya Kenya
Skima ya msingi ya XSD v5.0.2 ya goAML, kama inavyosambazwa na Ofisi ya Umoja wa Mataifa ya Kupambana na Dawa za Kulevya na Uhalifu (UNODC) kwa matumizi ya FIU (vitengo vya taarifa za kifedha) zote zinazoshiriki, ina seti ya kawaida ya elementi zinazotumika duniani kote. FRC ya Kenya imesanidi lango lake kulazimisha sehemu za ziada za lazima na kanuni za kibiashara ambazo ni mahususi kwa mazingira ya udhibiti na ya kifedha ya Kenya. Hizi ni pamoja na:
- National ID ya lazima kwa raia wa Kenya (skima ya msingi huchukulia kitambulisho kama kinachopendekezwa, si cha lazima)
- Uainishaji wa lazima wa njia ya pesa kwa simu (mobile money) kwa miamala ya M-PESA, Airtel Money na T-Kash
- Msimbo wa tawi lazima ulingane na tawi lililosajiliwa na Benki Kuu ya Kenya (CBK)
- FRC Entity Registration Number (namba ya usajili wa taasisi kwa FRC) lazima iwepo na ilingane kikamilifu na kumbukumbu za FRC
- Kiwango cha chini kilichoimarishwa cha urefu wa maelezo kwa kesi zenye viashiria vya TF, yaani ufadhili wa ugaidi (kivitendo, maneno 500+)
Kanuni hizi mahususi za Kenya hutekelezwa katika tabaka la uthibitishaji wa kanuni za kibiashara, baada ya uthibitishaji wa skima. Faili inaweza kupita uthibitishaji wa XSD na bado ikashindwa ukaguzi wa kanuni za kibiashara wa FRC.
Sehemu za lazima za CTR — marejeo kamili
Jedwali la 1: Sehemu za kichwa cha ripoti
| Jina la elementi ya XML | Aina ya data | Urefu wa juu | Hitaji | Maelezo kwa Kenya |
|---|---|---|---|---|
report_type | Maandishi (enum) | 10 | Lazima | Lazima iwe CTR hasa |
report_date | Tarehe | — | Lazima | Muundo: YYYY-MM-DD; lazima iwe tarehe ya sasa au ya karibuni |
reporting_entity_id | Maandishi | 50 | Lazima | Entity Registration Number iliyotolewa na FRC; lazima ilingane kikamilifu na kumbukumbu za FRC |
reporting_entity_name | Maandishi | 200 | Lazima | Jina kamili la kisheria la taasisi kama lilivyosajiliwa na FRC |
reporting_person_name | Maandishi | 100 | Lazima | Jina kamili la afisa uzingatiaji anayehusika |
reporting_person_id | Maandishi | 50 | Lazima | Namba ya mfanyakazi (staff ID) au namba ya National ID ya afisa uzingatiaji |
reporting_person_title | Maandishi | 50 | Inapendekezwa | Cheo cha kazi (k.m. Mkuu wa Uzingatiaji, afisa wa kuripoti utakatishaji fedha — MLRO) |
report_reference | Maandishi | 50 | Lazima | Namba ya kumbukumbu ya ripoti ya kipekee inayotengenezwa na taasisi inayoripoti; lazima iwe ya kipekee kwa kila uwasilishaji |
Maelezo mahususi kwa Kenya kuhusu reporting_entity_id: Muundo wa FRC Entity Registration Number ni FRC/INST/YYYY/NNNN. Hata tofauti ndogo — nafasi tupu mwishoni, herufi ndogo, kuacha alama za mkwaju — husababisha kukataliwa kwa kosa la kanuni za kibiashara ERR_045. Nakili namba hiyo moja kwa moja kutoka kwenye cheti chako cha usajili cha FRC na uithibitishe herufi kwa herufi.
Maelezo mahususi kwa Kenya kuhusu report_reference: Namba ya kumbukumbu ya kipekee ya ripoti haipaswi kutumika tena katika uwasilishaji mwingine. Taasisi nyingi hutumia muundo unaounganisha msimbo wa taasisi, aina ya ripoti, tarehe na namba ya mfuatano (k.m. NSBK-CTR-20260325-001). Namba za kumbukumbu zilizojirudia husababisha kukataliwa kwa kosa ERR_008.
Jedwali la 2: Sehemu za muamala
| Jina la elementi ya XML | Aina ya data | Urefu wa juu | Hitaji | Maelezo kwa Kenya |
|---|---|---|---|---|
transaction_date | Tarehe | — | Lazima | Muundo: YYYY-MM-DD; lazima iwe ndani ya kipindi cha kuripoti |
transaction_amount | Desimali | — | Lazima | Nafasi mbili za desimali zinahitajika (k.m. 1250000.00); bila alama ya sarafu |
transaction_currency | Maandishi (ISO 4217) | 3 | Lazima | Msimbo wa herufi tatu wa ISO 4217; tumia KES, si Ksh wala KSH |
transaction_type | Maandishi (enum) | 30 | Lazima | Lazima iwe mojawapo ya: CASH_DEPOSIT, CASH_WITHDRAWAL, CURRENCY_EXCHANGE |
transaction_reference | Maandishi | 100 | Lazima | Namba ya kumbukumbu ya muamala katika mfumo mkuu wa benki (core banking) |
account_number | Maandishi | 50 | Lazima | Namba kamili ya akaunti kama ilivyo katika mfumo mkuu wa benki |
branch_code | Maandishi | 20 | Lazima | Msimbo wa tawi (sort code) uliosajiliwa na CBK |
branch_name | Maandishi | 100 | Inapendekezwa | Jina la tawi linalosomeka kwa urahisi |
channel | Maandishi (enum) | 30 | Kwa masharti | Inahitajika kwa miamala ya pesa kwa simu; tazama misimbo ya njia za Kenya hapa chini |
kes_equivalent_amount | Desimali | — | Kwa masharti | Inahitajika pale transaction_currency si KES; kiasi kinacholingana kilichobadilishwa kwa kiwango cha CBK |
cbk_rate_date | Tarehe | — | Kwa masharti | Inahitajika pale kes_equivalent_amount imejazwa |
transaction_description | Maandishi | 500 | Inapendekezwa | Maelezo mafupi ya madhumuni ya muamala ikiwa yanajulikana |
Misimbo ya njia (channel) za Kenya kwa miamala ya pesa kwa simu:
| Njia | Thamani ya enum ya XML |
|---|---|
| M-PESA (Safaricom) | MOBILE_WALLET_MPESA |
| Airtel Money | MOBILE_WALLET_AIRTEL |
| T-Kash (Telkom Kenya) | MOBILE_WALLET_TKASH |
| Mhudumu wa dirisha la tawi (fedha taslimu) | BRANCH_CASH |
| Kutoa fedha taslimu kwenye ATM | ATM_CASH |
| Huduma za benki kupitia mawakala (fedha taslimu) | AGENT_CASH |
Maelezo kuhusu transaction_type kwa pesa kwa simu: Mteja akiweka fedha taslimu kwa wakala wa M-PESA na fedha hizo zikaingizwa kwenye akaunti ya benki, transaction_type ni CASH_DEPOSIT na channel ni MOBILE_WALLET_MPESA. Aina ya muamala inaeleza asili ya mzunguko wa fedha taslimu; njia (channel) inaeleza utaratibu uliotumika.
Jedwali la 3: Sehemu za utambulisho wa mteja (mahususi kwa Kenya)
| Jina la elementi ya XML | Aina ya data | Urefu wa juu | Hitaji | Maelezo kwa Kenya |
|---|---|---|---|---|
person_first_name | Maandishi | 100 | Lazima | Kama lilivyo kwenye hati ya utambulisho; bila kufupisha kwa herufi za mwanzo (initials) |
person_last_name | Maandishi | 100 | Lazima | Jina la ukoo kama lilivyo kwenye hati ya utambulisho |
person_middle_name | Maandishi | 100 | Hiari | Lijumuishe ikiwa lipo kwenye kitambulisho |
date_of_birth | Tarehe | — | Lazima | Muundo: YYYY-MM-DD; lazima ionyeshe umri wa mtu mzima unaoaminika |
gender | Maandishi (enum) | 1 | Inapendekezwa | M au F |
id_type | Maandishi (enum) | 30 | Lazima | NATIONAL_ID, PASSPORT au ALIEN_ID |
id_number | Maandishi | 50 | Lazima kwa raia wa KE | Tarakimu 8 kwa National ID ya Kenya; herufi na tarakimu kwa pasipoti |
id_issuing_country | Maandishi (ISO 3166-1 alpha-3) | 3 | Lazima | KEN kwa Kenya; kwa pasipoti, nchi iliyoitoa |
id_expiry_date | Tarehe | — | Kwa masharti | Inahitajika kwa pasipoti na alien ID; muundo YYYY-MM-DD |
nationality | Maandishi (ISO 3166-1 alpha-3) | 3 | Lazima | KEN kwa raia wa Kenya |
occupation | Maandishi | 100 | Inapendekezwa | Kama ilivyotangazwa katika kumbukumbu za Mjue Mteja Wako (KYC) |
address_country | Maandishi (ISO 3166-1 alpha-3) | 3 | Lazima | KEN kwa wateja wakazi wa Kenya |
address_county | Maandishi | 100 | Lazima | Kaunti ya Kenya (k.m. Nairobi, Mombasa, Kiambu) |
address_town | Maandishi | 100 | Lazima | Mji au kitongoji |
address_street | Maandishi | 200 | Inapendekezwa | Jina la mtaa au la eneo la makazi (estate) |
phone_number | Maandishi | 20 | Inapendekezwa | Jumuisha msimbo wa nchi (+254 kwa Kenya) |
email_address | Maandishi | 100 | Hiari | Pale inapopatikana katika kumbukumbu za KYC |
Kanuni muhimu ya Kenya — muundo wa National ID: Namba za kitambulisho cha taifa cha Kenya (National Identity Card) ni tarakimu 8 kamili. Hakuna herufi, hakuna vistari, hakuna nafasi. Muundo ni NNNNNNNN. Makosa ya kawaida ni pamoja na:
- Kuwasilisha namba ya tarakimu 7 (vitambulisho vya zamani vilivyotolewa kabla ya 1990 — hivi bado ni vitambulisho halali vya tarakimu 7 na vinapaswa kuwasilishwa kama tarakimu 7, bila kuongezewa sifuri mwanzoni)
- Kujumuisha namba ya mfululizo (serial number) ya kadi badala ya namba ya kitambulisho
- Kuwasilisha namba ya KRA PIN (inayoanza na herufi) kama National ID
- Kuwasilisha namba ya pasipoti kwa raia wa Kenya ilhali ana National ID
Kwa raia wa kigeni, id_type lazima iwe PASSPORT na namba ya pasipoti lazima iwasilishwe. FRC haikubali aina nyingine za vitambulisho vya kigeni kama mbadala wa pasipoti pale taasisi inaporipoti kuhusu wahusika wasio raia wa Kenya.
Sehemu za lazima za STR — marejeo kamili
STR hutumia muundo uleule wa skima kama CTR kwa sehemu za muamala na za utambulisho. Sehemu za ziada za lazima zinazohusu STR pekee zimejikita katika kichwa cha ripoti (sehemu ya sababu za shaka) na katika elementi za uchambuzi wa kesi.
| Jina la elementi ya XML | Aina ya data | Urefu wa juu | Hitaji | Maelezo kwa Kenya |
|---|---|---|---|---|
report_type | Maandishi (enum) | 10 | Lazima | Lazima iwe STR hasa |
reason | Maandishi | 4000 | Lazima | Maelezo kamili ya STR — misingi ya shaka. Lazima yawe na maudhui ya maana. Thamani tupu au za kujaza nafasi tu (placeholder) husababisha kukataliwa. |
is_suspicious | Boolean | — | Lazima | Lazima iwe TRUE kwa uwasilishaji wote wa STR |
subject_type | Maandishi (enum) | 10 | Lazima | PERSON au ENTITY |
indicator_codes | Maandishi | 500 | Lazima | Orodha ya misimbo ya viashiria iliyoidhinishwa na FRC inayohusu kesi, ikitenganishwa kwa koma |
transaction_description | Maandishi | 1000 | Lazima kwa STR | Maelezo mafupi, yanayoeleza ukweli tu, ya muamala au miamala yenye mashaka |
reporting_person_name | Maandishi | 100 | Lazima | Afisa uzingatiaji anayehusika na ripoti |
reporting_person_id | Maandishi | 50 | Lazima | Namba ya mfanyakazi (staff ID) au National ID ya afisa uzingatiaji anayeripoti |
date_of_suspicion | Tarehe | — | Lazima | Tarehe ambayo shaka ilijitokeza kwa mara ya kwanza; muundo YYYY-MM-DD |
action_taken | Maandishi | 500 | Lazima kwa Kenya | Inaeleza hatua zilizochukuliwa na taasisi (ufuatiliaji, kuzuia akaunti, mapitio ya KYC, n.k.) |
tipping_off_acknowledged | Boolean | — | Lazima | Lazima iwe TRUE — inathibitisha kwamba afisa anayeripoti anatambua katazo la kumtahadharisha mhusika (tipping-off) chini ya POCAMLA |
Maelezo kuhusu urefu wa sehemu ya reason: Ingawa kikomo cha juu cha skima kwa sehemu ya reason ni herufi 4,000, uthibitishaji wa kanuni za kibiashara wa FRC hulazimisha viwango vya chini vya kivitendo kulingana na aina ya kiashiria. Kesi za kawaida za utakatishaji fedha (ML): angalau takriban herufi 200 (takriban maneno 30–40). Kesi zenye viashiria vya TF: angalau takriban herufi 3,000 (takriban maneno 500). Maelezo yanayofikia kiwango cha chini cha kiufundi lakini hayana maudhui ya kutosha yatapita uthibitishaji wa skima, lakini yatasababisha FRC kuomba taarifa za ziada.
Maelezo kuhusu indicator_codes: Misimbo ya viashiria lazima itoke kwenye orodha ya misimbo ya viashiria iliyochapishwa na FRC ya Kenya. Kuwasilisha misimbo iliyobuniwa na taasisi yenyewe au misimbo kutoka kwenye utekelezaji wa goAML wa FIU ya nchi nyingine husababisha kukataliwa kwa kosa la kanuni za kibiashara ERR_045. Tazama makala inayohusiana, Maktaba ya viashiria vya STR: mbinu za uhalifu (typologies) za AML kwa benki za Kenya (2026)EN, kwa marejeo ya sasa ya misimbo ya viashiria ya FRC ya Kenya.
Sehemu za muamala kwa STR: Sehemu zote zilezile za muamala kutoka kwenye jedwali la CTR hapo juu zinatumika kwa uwasilishaji wa STR. Tofauti kuu ni kwamba STR inaweza kuhusishwa na miamala ambayo kila mmoja uko chini ya kiwango cha CTR cha kiasi kinacholingana na USD 15,000 — kigezo cha kuwasilisha STR ni shaka, si kiasi.
Kanuni za uthibitishaji mahususi kwa Kenya
Uthibitishaji wa muundo wa National ID
Kama ilivyoelezwa hapo juu, FRC ya Kenya hulazimisha uthibitishaji mkali wa muundo wa namba za National ID. Kanuni ya uthibitishaji hukagua:
- Aina ya kitambulisho ni
NATIONAL_ID— sehemu lazima iwe na tarakimu 7 au 8 hasa (7 kwa vitambulisho vya zamani, 8 kwa vitambulisho vilivyotolewa kuanzia takriban 1991 na kuendelea) - Hakuna herufi za alfabeti, nafasi, vistari wala vitenganishi vingine
- Namba ya kitambulisho haipaswi kuwa sifuri pekee wala tarakimu moja inayojirudia (k.m.
00000000na11111111hushindwa ukaguzi wa uhalisia)
Njia ya kuaminika zaidi ya kupita uthibitishaji huu ni kuchukua namba ya kitambulisho moja kwa moja kutoka kwenye chanzo cha KYC kilichothibitishwa na kuendesha ukaguzi wa muundo kabla ya kuwasilisha. Benki nyingi huhifadhi namba za vitambulisho katika mifumo yao ya KYC zikiwa na nafasi tupu mwanzoni au zikiwa zimeunganishwa na namba za mfululizo — ondoa herufi zote zisizo tarakimu kabla ya kuziweka kwenye XML.
Kanuni za uainishaji wa njia za pesa kwa simu
FRC ya Kenya inataka miamala ya pesa kwa simu iainishwe kwa kutumia misimbo ya njia (channel) iliyofafanuliwa katika Jedwali la 2 hapo juu. Kanuni za uainishaji ni:
- Muamala wowote ulioanzishwa kupitia M-PESA, bila kujali kama chanzo chake cha awali au mahali unapoishia ni akaunti ya benki, lazima utumie
MOBILE_WALLET_MPESA - Uhamisho kutoka benki kwenda M-PESA, yaani kutoka kwenye akaunti ya benki ya mteja hadi namba yake ya M-PESA iliyounganishwa nayo, huainishwa kama
MOBILE_WALLET_MPESA - Amana ya fedha taslimu kupitia wakala wa M-PESA inayoingizwa kwenye akaunti ya benki ni
CASH_DEPOSITyenye njiaMOBILE_WALLET_MPESA - Utoaji wa fedha taslimu kwenye ATM lazima utumie
ATM_CASH, siBRANCH_CASH - Amana za fedha taslimu kupitia huduma za benki za mawakala (k.m. Equity Agents, Co-op Kwa Jirani) lazima zitumie
AGENT_CASH
Kutumia msimbo usio sahihi wa njia — au kuacha sehemu ya channel kwa miamala ya pesa kwa simu — husababisha kukataliwa kwa kosa la kanuni za kibiashara ERR_045.
Hitaji la urefu wa ziada wa maelezo kwa viashiria vya TF
Kwa STR zinazojumuisha msimbo wowote wa kiashiria cha TF (Terrorist Financing — ufadhili wa ugaidi), utaratibu wa FRC ya Kenya unataka maelezo katika sehemu ya reason yatimize viwango vilivyoimarishwa vya urefu na undani. Ingawa skima ya XSD hailazimishi idadi ya maneno, uthibitishaji wa kanuni za kibiashara wa FRC huziwekea alama STR zenye viashiria vya TF ambazo maelezo yake ni mafupi kuliko takriban herufi 3,000 (takriban maneno 500), ili zipitiwe na mtu, na huenda zikaombewa taarifa za ziada.
Maelezo ya TF lazima yajumuishe, pamoja na vipengele vitano vya kawaida: nchi au maeneo mahususi yenye hatari kubwa yanayohusika, majina ya taasisi au watu wowote walio chini ya vikwazo waliotajwa katika tahadhari za uchujaji, njia na utaratibu wa kuhamisha fedha, na hatua zilizochukuliwa na taasisi, ikijumuisha kuzuia akaunti au kumjulisha mdhibiti.
Sehemu ambazo FRC ya Kenya inazifanya kuwa za lazima zaidi ya XSD ya msingi
Sehemu zifuatazo ni za hiari katika XSD v5.0.2 ya msingi ya goAML lakini huchukuliwa kuwa za lazima na tabaka la kanuni za kibiashara la FRC ya Kenya:
| Sehemu | Hali katika XSD ya msingi | Hali kwa FRC ya Kenya | Sababu ya kuhitajika |
|---|---|---|---|
id_number kwa raia wa Kenya | Inapendekezwa | Lazima | Masharti ya uchunguzi wa kina wa mteja (CDD) chini ya POCAMLA |
branch_code | Inapendekezwa | Lazima | Ulinganishaji na rejista ya matawi ya CBK |
action_taken (STR) | Hiari | Lazima | Miongozo ya FRC kuhusu kuandika hatua zilizochukuliwa na taasisi |
date_of_suspicion (STR) | Hiari | Lazima | Kukokotoa kama muda wa mwisho wa kuwasilisha umezingatiwa |
tipping_off_acknowledged (STR) | Hiari | Lazima | Uthibitisho wa katazo la kumtahadharisha mhusika (tipping-off) chini ya POCAMLA |
channel kwa pesa kwa simu | Hiari | Lazima | Uainishaji wa mbinu za uhalifu (typology) zinazohusu pesa kwa simu |
Makosa ya kawaida ya uthibitishaji wa XML na jinsi ya kuyarekebisha
| Msimbo wa kosa | Ujumbe wa kosa | Chanzo cha msingi | Suluhisho |
|---|---|---|---|
| ERR_001 | Schema validation failed: element <transaction_date> has invalid value | Tarehe haiko katika muundo wa YYYY-MM-DD (k.m. 25/03/2026 au 2026-3-25) | Andika upya sehemu zote za tarehe katika muundo mkali wa YYYY-MM-DD; ongeza sifuri mbele ya miezi na siku zenye tarakimu moja |
| ERR_002 | Schema validation failed: <transaction_amount> is not a valid decimal | Kiasi kina alama ya sarafu (USD 15,000) au kitenganishi cha maelfu | Ondoa herufi zote zisizo tarakimu isipokuwa nukta ya desimali; tumia muundo 15000.00 |
| ERR_003 | Schema validation failed: <transaction_type> value CASH is not in permitted enumeration | Kutumia thamani za mkato zisizo kwenye enum ya skima | Tumia thamani kamili za enum: CASH_DEPOSIT, CASH_WITHDRAWAL, CURRENCY_EXCHANGE |
| ERR_004 | Schema validation failed: mandatory element <id_number> is missing | Sehemu ya National ID ni tupu au haipo kwenye XML | Hakikisha id_number imejazwa kwa wahusika wote ambao id_type yao ni NATIONAL_ID |
| ERR_005 | Schema validation failed: <transaction_currency> value Ksh is not valid ISO 4217 | Kutumia vifupisho vya sarafu visivyo vya kiwango rasmi | Tumia misimbo ya herufi tatu ya ISO 4217: KES, USD, EUR, GBP |
| ERR_006 | Schema validation failed: element <reason> is empty | Sehemu ya reason (maelezo) ya STR ni tupu au ina nafasi tupu pekee | Andika maelezo yenye maudhui ya maana; tazama Jinsi ya kuandika maelezo ya STR kwa goAML |
| ERR_007 | Schema validation failed: malformed XML — unexpected end element | Tagi ya XML ambayo haijafungwa katika faili iliyotengenezwa | Thibitisha muundo wa XML kwa kichanganuzi (parser) kabla ya kuwasilisha; kagua tagi ambazo hazijafungwa |
| ERR_008 | Business rule violation: duplicate report_reference value | Namba ileile ya kumbukumbu ya ripoti imetumika katika uwasilishaji wa awali | Tengeneza namba mpya ya kumbukumbu ya kipekee kwa kufuata mpango wa namba za kumbukumbu wa taasisi yako |
| ERR_012 | Business rule violation: reporting_entity_id does not match FRC registry | Namba ya usajili wa taasisi katika XML hailingani kikamilifu na kumbukumbu za FRC | Nakili namba ya usajili ya FRC herufi kwa herufi kutoka kwenye cheti rasmi cha usajili cha FRC |
| ERR_045 | Business rule violation: id_number format invalid for id_type NATIONAL_ID | National ID ina herufi zisizo tarakimu, urefu usio sahihi au herufi za mpangilio | Bakiza tarakimu 7–8 pekee; hakiki dhidi ya nakala iliyoskaniwa ya hati asili ya KYC |
Kuendesha kiotomatiki utengenezaji wa XML ili kuepuka makosa ya skima
Kwa nini kutengeneza XML kwa mkono husababisha kukataliwa
Kila faili ya XML iliyoandaliwa kwa mkono ni kazi ya mikono — na kazi ya mikono huleta makosa ya kibinadamu. Aina za makosa yanayosababisha kukataliwa ndizo hasa aina za makosa ambayo binadamu hufanya: tarehe iliyoandikwa kama DD/MM/YYYY badala ya YYYY-MM-DD, kiasi chenye koma kama kitenganishi cha maelfu, thamani ya aina ya muamala iliyokaribia kuwa sahihi lakini ina tofauti ndogo, National ID yenye nafasi tupu mwanzoni iliyotokana na data iliyohamishwa kutoka mfumo wa KYC.
Pale XML inapotengenezwa kwa mkono — iwe katika kihariri cha maandishi, makro ya Excel au hati ya programu (script) iliyoandikwa mahususi — kukataliwa katika uwasilishaji wa kwanza ni jambo la kawaida, na kila tukio huongeza mzunguko wa kurudia kazi kwenye ratiba ya uwasilishaji: tafuta kosa, sahihisha data, tengeneza faili upya, na uwasilishe upya.
Kile ambacho injini ya kutengeneza XML kiotomatiki hufanya kwa njia tofauti
Injini ya kutengeneza XML kiotomatiki, iliyojengwa mahususi kukidhi skima ya goAML, huondoa aina hizi za kushindwa kwa utaratibu:
- Uoanishaji wa sehemu unaozingatia skima: Kila sehemu ya data inayoingizwa huoanishwa na jina halisi la elementi yake katika XSD ya goAML. Hakuna kunakili majina ya elementi kwa mkono.
- Kulazimisha aina za data wakati wa kuingiza: Sehemu za tarehe hukubali tarehe halali pekee na huzitoa katika muundo wa YYYY-MM-DD. Sehemu za desimali huondoa herufi za mpangilio na hulazimisha nafasi mbili za desimali.
- Uthibitishaji wa enum: Sehemu za aina ya muamala, njia (channel) na aina ya kitambulisho huchaguliwa kutoka kwenye thamani kamili za enum zinazoruhusiwa — hakuna uandishi wa maandishi huru.
- Kulazimisha kanuni za kibiashara za Kenya: Muundo wa National ID, usajili wa msimbo wa tawi, uainishaji wa njia za pesa kwa simu, na ulinganifu wa namba ya usajili wa taasisi kwa FRC vyote huthibitishwa kabla XML haijatengenezwa.
- Uthibitishaji wa XSD kwenye matokeo: XML iliyotengenezwa huthibitishwa dhidi ya XSD v5.0.2 ya goAML kabla haijawekwa tayari kwa kuwasilishwa. Faili zinazoshindwa uthibitishaji hazionyeshwi kwa afisa uzingatiaji hadi tatizo la msingi la data litatuliwe.
- Utambuzi wa kiwango kwa kila muamala pamoja na ubadilishaji wa fedha za kigeni: Kila muamala wa fedha taslimu hupimwa papo hapo dhidi ya kiwango cha kiasi kinacholingana na USD 15,000, na kiwango cha ubadilishaji kilichotumika hurekodiwa katika CTR.
Matokeo yake ni mchakato wa uwasilishaji unaotoa faili za XML zinazokidhi skima na masharti ya FRC ya Kenya kila mara — kwa kiwango cha kukataliwa kinachokaribia sifuri.
Maswali yanayoulizwa mara kwa mara
Ngazi sita za skima ya XSD v5.0.2 ya goAML ni zipi?
Report (elementi ya msingi, yenye kichwa kinachotambulisha aina ya ripoti, taasisi, tarehe ya uwasilishaji na afisa uzingatiaji); Transaction (tarehe, kiasi, sarafu na aina); Party (from_person au from_entity upande wa kutoa fedha, to_person au to_entity upande wa kupokea fedha); Account (namba, msimbo wa tawi, aina na sarafu); ID (aina ya hati ya utambulisho, namba, nchi iliyoitoa na tarehe ya kuisha kwa muda wake); na Address (nchi, kaunti, mji na mtaa). Faili hushindwa uthibitishaji ikiwa ngazi yoyote inavunja kanuni, hata iwe ndogo kiasi gani.
FRC ya Kenya inahitaji sehemu zipi zaidi ya skima ya msingi ya goAML?
Namba ya National ID kwa raia wa Kenya, msimbo wa tawi (unaokaguliwa dhidi ya rejista ya matawi ya CBK), njia ya pesa kwa simu kwa miamala ya M-PESA, Airtel Money na T-Kash, na kwa STR, sehemu za action_taken, date_of_suspicion na tipping_off_acknowledged. Hizi hulazimishwa na tabaka la kanuni za kibiashara la FRC baada ya uthibitishaji wa XSD, hivyo faili inaweza kupita skima na bado ikakataliwa.
National ID ya raia wa Kenya lazima iwe katika muundo gani ndani ya faili ya goAML?
Tarakimu saba au nane, bila nafasi, vistari wala herufi, na isiwe thamani isiyoaminika kama vile sifuri pekee. Ondoa kila herufi isiyo tarakimu kutoka kwenye rekodi ya KYC kabla ya kutengeneza faili; muundo usio sahihi husababisha kosa la kanuni za kibiashara ERR_045.
Faili za CTR na STR zinatofautiana vipi katika skima?
Zinatumia XSD ileile na hutofautishwa kwa elementi ya report_type. CTR hujikita kwenye data sahihi ya muamala na utambulisho uliothibitishwa, bila maelezo. STR lazima iwe na maelezo yenye maudhui ya maana katika reason, is_suspicious ikiwa imewekwa kuwa true, misimbo ya viashiria na uhusiano na mbinu ya uhalifu (typology) inayotambulika — na maelezo lazima yawe marefu zaidi na ya kina zaidi pale kiashiria cha ufadhili wa ugaidi kinapokuwepo.
Ni makosa gani ya uthibitishaji ya goAML yanayojitokeza zaidi?
Tarehe zisizo katika muundo wa YYYY-MM-DD (ERR_001), kiasi chenye alama au vitenganishi vya maelfu (ERR_002), aina za miamala zisizo kwenye orodha ya thamani zinazoruhusiwa (ERR_003), id_number inayokosekana (ERR_004), misimbo ya sarafu isiyo ya ISO kama vile Ksh (ERR_005), reason ya STR iliyo tupu (ERR_006), report_reference iliyojirudia (ERR_008) na reporting_entity_id isiyolingana na rejista ya FRC (ERR_012). Jedwali lililo hapo juu linaorodhesha suluhisho la kila moja.
Jenga mchakato wako wa uwasilishaji juu ya msingi imara wa skima
Kuelewa skima ya XML ya goAML ndio msingi wa mchakato wa kuaminika wa kuwasilisha CTR na STR. Iwe taasisi yako inajenga mchakato wake wenyewe wa kutengeneza XML au inatathmini jukwaa lililojengwa mahususi, marejeo ya sehemu na kanuni za uthibitishaji katika makala hii yanakupa unachohitaji ili kufanikiwa katika uwasilishaji wa kwanza mara kwa mara.
Jukwaa la goAML la Creodata hushughulikia kiotomatiki mzunguko mzima wa kukidhi skima — kuanzia uoanishaji wa sehemu na kulazimisha aina za data, kupitia uthibitishaji wa kanuni za kibiashara mahususi kwa Kenya, hadi kutoa XML iliyothibitishwa dhidi ya XSD. Timu yako ya uzingatiaji inajikita kwenye uchambuzi; jukwaa linashughulikia masharti ya kiufundi ya uwasilishaji.
Tazama jukwaa likifanya kazi kupitia onyesho la moja kwa moja.
Omba onyesho → https://www.creodata.com/demo
Makala zinazohusiana:
