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.

CS
Timu ya Creodata Solutions
25 Machi 2026
Imetafsiriwa kutoka kwa makala asili ya Kiingereza. Soma kwa Kiingereza

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 XMLAina ya dataUrefu wa juuHitajiMaelezo kwa Kenya
report_typeMaandishi (enum)10LazimaLazima iwe CTR hasa
report_dateTarehe—LazimaMuundo: YYYY-MM-DD; lazima iwe tarehe ya sasa au ya karibuni
reporting_entity_idMaandishi50LazimaEntity Registration Number iliyotolewa na FRC; lazima ilingane kikamilifu na kumbukumbu za FRC
reporting_entity_nameMaandishi200LazimaJina kamili la kisheria la taasisi kama lilivyosajiliwa na FRC
reporting_person_nameMaandishi100LazimaJina kamili la afisa uzingatiaji anayehusika
reporting_person_idMaandishi50LazimaNamba ya mfanyakazi (staff ID) au namba ya National ID ya afisa uzingatiaji
reporting_person_titleMaandishi50InapendekezwaCheo cha kazi (k.m. Mkuu wa Uzingatiaji, afisa wa kuripoti utakatishaji fedha — MLRO)
report_referenceMaandishi50LazimaNamba 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 XMLAina ya dataUrefu wa juuHitajiMaelezo kwa Kenya
transaction_dateTarehe—LazimaMuundo: YYYY-MM-DD; lazima iwe ndani ya kipindi cha kuripoti
transaction_amountDesimali—LazimaNafasi mbili za desimali zinahitajika (k.m. 1250000.00); bila alama ya sarafu
transaction_currencyMaandishi (ISO 4217)3LazimaMsimbo wa herufi tatu wa ISO 4217; tumia KES, si Ksh wala KSH
transaction_typeMaandishi (enum)30LazimaLazima iwe mojawapo ya: CASH_DEPOSIT, CASH_WITHDRAWAL, CURRENCY_EXCHANGE
transaction_referenceMaandishi100LazimaNamba ya kumbukumbu ya muamala katika mfumo mkuu wa benki (core banking)
account_numberMaandishi50LazimaNamba kamili ya akaunti kama ilivyo katika mfumo mkuu wa benki
branch_codeMaandishi20LazimaMsimbo wa tawi (sort code) uliosajiliwa na CBK
branch_nameMaandishi100InapendekezwaJina la tawi linalosomeka kwa urahisi
channelMaandishi (enum)30Kwa mashartiInahitajika kwa miamala ya pesa kwa simu; tazama misimbo ya njia za Kenya hapa chini
kes_equivalent_amountDesimali—Kwa mashartiInahitajika pale transaction_currency si KES; kiasi kinacholingana kilichobadilishwa kwa kiwango cha CBK
cbk_rate_dateTarehe—Kwa mashartiInahitajika pale kes_equivalent_amount imejazwa
transaction_descriptionMaandishi500InapendekezwaMaelezo mafupi ya madhumuni ya muamala ikiwa yanajulikana

Misimbo ya njia (channel) za Kenya kwa miamala ya pesa kwa simu:

NjiaThamani ya enum ya XML
M-PESA (Safaricom)MOBILE_WALLET_MPESA
Airtel MoneyMOBILE_WALLET_AIRTEL
T-Kash (Telkom Kenya)MOBILE_WALLET_TKASH
Mhudumu wa dirisha la tawi (fedha taslimu)BRANCH_CASH
Kutoa fedha taslimu kwenye ATMATM_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 XMLAina ya dataUrefu wa juuHitajiMaelezo kwa Kenya
person_first_nameMaandishi100LazimaKama lilivyo kwenye hati ya utambulisho; bila kufupisha kwa herufi za mwanzo (initials)
person_last_nameMaandishi100LazimaJina la ukoo kama lilivyo kwenye hati ya utambulisho
person_middle_nameMaandishi100HiariLijumuishe ikiwa lipo kwenye kitambulisho
date_of_birthTarehe—LazimaMuundo: YYYY-MM-DD; lazima ionyeshe umri wa mtu mzima unaoaminika
genderMaandishi (enum)1InapendekezwaM au F
id_typeMaandishi (enum)30LazimaNATIONAL_ID, PASSPORT au ALIEN_ID
id_numberMaandishi50Lazima kwa raia wa KETarakimu 8 kwa National ID ya Kenya; herufi na tarakimu kwa pasipoti
id_issuing_countryMaandishi (ISO 3166-1 alpha-3)3LazimaKEN kwa Kenya; kwa pasipoti, nchi iliyoitoa
id_expiry_dateTarehe—Kwa mashartiInahitajika kwa pasipoti na alien ID; muundo YYYY-MM-DD
nationalityMaandishi (ISO 3166-1 alpha-3)3LazimaKEN kwa raia wa Kenya
occupationMaandishi100InapendekezwaKama ilivyotangazwa katika kumbukumbu za Mjue Mteja Wako (KYC)
address_countryMaandishi (ISO 3166-1 alpha-3)3LazimaKEN kwa wateja wakazi wa Kenya
address_countyMaandishi100LazimaKaunti ya Kenya (k.m. Nairobi, Mombasa, Kiambu)
address_townMaandishi100LazimaMji au kitongoji
address_streetMaandishi200InapendekezwaJina la mtaa au la eneo la makazi (estate)
phone_numberMaandishi20InapendekezwaJumuisha msimbo wa nchi (+254 kwa Kenya)
email_addressMaandishi100HiariPale 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 XMLAina ya dataUrefu wa juuHitajiMaelezo kwa Kenya
report_typeMaandishi (enum)10LazimaLazima iwe STR hasa
reasonMaandishi4000LazimaMaelezo kamili ya STR — misingi ya shaka. Lazima yawe na maudhui ya maana. Thamani tupu au za kujaza nafasi tu (placeholder) husababisha kukataliwa.
is_suspiciousBoolean—LazimaLazima iwe TRUE kwa uwasilishaji wote wa STR
subject_typeMaandishi (enum)10LazimaPERSON au ENTITY
indicator_codesMaandishi500LazimaOrodha ya misimbo ya viashiria iliyoidhinishwa na FRC inayohusu kesi, ikitenganishwa kwa koma
transaction_descriptionMaandishi1000Lazima kwa STRMaelezo mafupi, yanayoeleza ukweli tu, ya muamala au miamala yenye mashaka
reporting_person_nameMaandishi100LazimaAfisa uzingatiaji anayehusika na ripoti
reporting_person_idMaandishi50LazimaNamba ya mfanyakazi (staff ID) au National ID ya afisa uzingatiaji anayeripoti
date_of_suspicionTarehe—LazimaTarehe ambayo shaka ilijitokeza kwa mara ya kwanza; muundo YYYY-MM-DD
action_takenMaandishi500Lazima kwa KenyaInaeleza hatua zilizochukuliwa na taasisi (ufuatiliaji, kuzuia akaunti, mapitio ya KYC, n.k.)
tipping_off_acknowledgedBoolean—LazimaLazima 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:

  1. 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)
  2. Hakuna herufi za alfabeti, nafasi, vistari wala vitenganishi vingine
  3. Namba ya kitambulisho haipaswi kuwa sifuri pekee wala tarakimu moja inayojirudia (k.m. 00000000 na 11111111 hushindwa 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_DEPOSIT yenye njia MOBILE_WALLET_MPESA
  • Utoaji wa fedha taslimu kwenye ATM lazima utumie ATM_CASH, si BRANCH_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:

SehemuHali katika XSD ya msingiHali kwa FRC ya KenyaSababu ya kuhitajika
id_number kwa raia wa KenyaInapendekezwaLazimaMasharti ya uchunguzi wa kina wa mteja (CDD) chini ya POCAMLA
branch_codeInapendekezwaLazimaUlinganishaji na rejista ya matawi ya CBK
action_taken (STR)HiariLazimaMiongozo ya FRC kuhusu kuandika hatua zilizochukuliwa na taasisi
date_of_suspicion (STR)HiariLazimaKukokotoa kama muda wa mwisho wa kuwasilisha umezingatiwa
tipping_off_acknowledged (STR)HiariLazimaUthibitisho wa katazo la kumtahadharisha mhusika (tipping-off) chini ya POCAMLA
channel kwa pesa kwa simuHiariLazimaUainishaji wa mbinu za uhalifu (typology) zinazohusu pesa kwa simu

Makosa ya kawaida ya uthibitishaji wa XML na jinsi ya kuyarekebisha

Msimbo wa kosaUjumbe wa kosaChanzo cha msingiSuluhisho
ERR_001Schema validation failed: element <transaction_date> has invalid valueTarehe 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_002Schema validation failed: <transaction_amount> is not a valid decimalKiasi kina alama ya sarafu (USD 15,000) au kitenganishi cha maelfuOndoa herufi zote zisizo tarakimu isipokuwa nukta ya desimali; tumia muundo 15000.00
ERR_003Schema validation failed: <transaction_type> value CASH is not in permitted enumerationKutumia thamani za mkato zisizo kwenye enum ya skimaTumia thamani kamili za enum: CASH_DEPOSIT, CASH_WITHDRAWAL, CURRENCY_EXCHANGE
ERR_004Schema validation failed: mandatory element <id_number> is missingSehemu ya National ID ni tupu au haipo kwenye XMLHakikisha id_number imejazwa kwa wahusika wote ambao id_type yao ni NATIONAL_ID
ERR_005Schema validation failed: <transaction_currency> value Ksh is not valid ISO 4217Kutumia vifupisho vya sarafu visivyo vya kiwango rasmiTumia misimbo ya herufi tatu ya ISO 4217: KES, USD, EUR, GBP
ERR_006Schema validation failed: element <reason> is emptySehemu ya reason (maelezo) ya STR ni tupu au ina nafasi tupu pekeeAndika maelezo yenye maudhui ya maana; tazama Jinsi ya kuandika maelezo ya STR kwa goAML
ERR_007Schema validation failed: malformed XML — unexpected end elementTagi ya XML ambayo haijafungwa katika faili iliyotengenezwaThibitisha muundo wa XML kwa kichanganuzi (parser) kabla ya kuwasilisha; kagua tagi ambazo hazijafungwa
ERR_008Business rule violation: duplicate report_reference valueNamba ileile ya kumbukumbu ya ripoti imetumika katika uwasilishaji wa awaliTengeneza namba mpya ya kumbukumbu ya kipekee kwa kufuata mpango wa namba za kumbukumbu wa taasisi yako
ERR_012Business rule violation: reporting_entity_id does not match FRC registryNamba ya usajili wa taasisi katika XML hailingani kikamilifu na kumbukumbu za FRCNakili namba ya usajili ya FRC herufi kwa herufi kutoka kwenye cheti rasmi cha usajili cha FRC
ERR_045Business rule violation: id_number format invalid for id_type NATIONAL_IDNational ID ina herufi zisizo tarakimu, urefu usio sahihi au herufi za mpangilioBakiza 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:

Tazama Ripoti za goAML kwa vitendo.