> Průběžné zlepšování procesů > Zpracování plateb > Fiserv > Datová šablona

Datová šablona pro zpracování plateb

Name: Šablona dat pro process mining: Zpracování plateb
Creator: ProcessMind
License: https://creativecommons.org/licenses/by/4.0/

Fiserv

← Zpět na průvodce zlepšováním

Atributy zpracování plateb(19) Aktivity při zpracování plateb(13) Návody k extrakci dat(1)

Datová šablona pro zpracování plateb

Tato šablona nabízí strukturovaný rámec, který vám pomůže převést data z Fiserv do formátu vhodného pro process mining a analýzu. Uvádí základní atributy a aktivity potřebné k přehledu o vypořádání a párování plateb. Podle tohoto návodu vytvoříte záznam událostí, který odhalí neefektivitu a rizika pro shodu ve finančním provozu.

Doporučené atributy pro analýzu plateb
Důležité milníky procesu ke sledování
Technický návod k extrakci dat z Fiserv

Pracujete se záznamy událostí poprvé? Přečtěte si, jak vytvořit záznam událostí pro process mining.

Stáhnout šablonu

Atributy zpracování plateb

Tyto doporučené datové položky poskytnou záznamu událostí potřebný kontext pro analýzu celého životního cyklu plateb.

5 Povinné 9 Doporučené 5 Volitelné

	Název	Popis
	Časové razítko události EventTimestamp	Přesné datum a čas, kdy k aktivitě došlo.
Popis Tento atribut zaznamenává přesný okamžik události. Slouží jako základ časové analýzy, včetně doby průchodu, celkové doby zpracování a hledání úzkých míst. V dashboardech se z těchto údajů počítá doba mezi kroky, například čas od „Platební požadavek vytvořen“ do „Platba autorizována“. Přesná časová razítka jsou nutná pro správné seřazení událostí, které následují rychle po sobě. Proč je to důležité Je potřeba k seřazení událostí a výpočtu doby trvání jednotlivých částí procesu. Kde data získat Auditní protokoly nebo sloupce s časovými razítky aktualizací transakcí. Příklady 2023-10-15T08:30:00Z2023-10-15T09:15:22Z2023-10-16T14:00:00Z2023-10-17T10:00:00Z
	ID platební transakce PaymentTransactionId	Jedinečný identifikátor konkrétní platební instrukce nebo případu transakce.
Popis Tento atribut slouží jako hlavní klíč pro propojení všech aktivit v rámci jednoho platebního cyklu. Analytici díky němu mohou sledovat cestu od prvotního požadavku přes ověření a schválení až po konečné vypořádání nebo zrušení. V prostředí Fiserv jde obvykle o primární klíč v tabulkách historie transakcí. Je nezbytný pro rekonstrukci průběhu procesu a správné přiřazení událostí, které od sebe dělí i několik dní, například vypořádání a autorizace, ke stejnému obchodnímu objektu. Proč je to důležité Jde o základní ID případu, podle kterého se události seskupují do instancí procesu. Kde data získat Podívejte se do dokumentace Fiserv k tabulkám Transaction nebo Payment Header. Příklady TRX-99823101PMT-2023-88421002938475CHK-5512WIRE-US-9921
	Název aktivity ActivityName	Konkrétní událost nebo změna stavu, ke které došlo v platebním procesu.
Popis Tento atribut popisuje provedený krok, například „Platební požadavek vytvořen“ nebo „Platba vypořádána“. Určuje uzly v mapě procesu a pomáhá pochopit pořadí jednotlivých kroků. Analýza jednotlivých aktivit umožňuje zobrazit workflow, najít vynechané kroky a odhalit cesty, které nejsou v souladu s pravidly, například když někdo obejde povinné kontroly nebo schválení. Proč je to důležité Určuje události, které tvoří časovou osu procesu. Kde data získat Protokol historie transakcí nebo auditní tabulky změn stavu. Příklady Požadavek na platbu vytvořenPlatba autorizovánaZjištěna chyba platbyPlatba vypořádánaPlatba zrušena
	Poslední aktualizace dat LastDataUpdate	Časové razítko poslední extrakce nebo aktualizace záznamu.
Popis Ukazuje, jak aktuální jsou data použitá v analýze. Díky tomu lze posoudit, zda dashboardy zobrazují provoz v reálném čase, nebo historický stav. Pomáhá uživatelům důvěřovat zobrazeným ukazatelům a nedělat rozhodnutí na základě zastaralých dat, zejména při sledování dodržení uzávěrek nebo aktuálních úzkých míst. Proč je to důležité Zajišťuje aktuálnost a spolehlivost dat. Kde data získat Čas systému v okamžiku spuštění ETL. Příklady 2023-10-27T12:00:00Z2023-10-28T06:00:00Z
	Zdrojový systém SourceSystem	Název systému, ze kterého data pocházejí.
Popis Určuje konkrétní modul Fiserv nebo externí systém, který událost vytvořil. Hodí se to zejména v prostředí s více systémy, kde platba může začít v uživatelském kanálu a být vypořádána v hlavním bankovním systému. Analytici mohou proces filtrovat podle zdrojového systému a zaměřit analýzu na konkrétní technické prostředí nebo integrační bod. Proč je to důležité Poskytuje technický kontext a informace o původu dat. Kde data získat Pevně nastaveno při extrakci nebo převzato z metadat systému. Příklady Fiserv PremierFiserv SignatureFiserv DNAFiserv Enterprise Payments Platform
	Částka platby PaymentAmount	Peněžní hodnota platební transakce.
Popis Tento atribut udává finanční hodnotu platby. Umožňuje rozdělit analýzu podle částky a odlišit strategické platby vysoké hodnoty od běžných transakcí s nízkou hodnotou. Je nezbytný pro zobrazení „Odhalování duplicitních plateb“, kde shodné částky spolu s údaji o plátci a příjemci upozorní na možné chyby. Podporuje také analýzu schvalovacích oprávnění, protože vyšší částky často procházejí jiným workflow. Proč je to důležité Důležité pro analýzu finančních rizik a odhalování duplicit. Kde data získat Tabulka hlaviček transakcí, sloupec Amount. Příklady 150.0025000.5010.991000000.00
	Číslo účtu plátce PayerAccountNumber	Číslo účtu, ze kterého se odečítají prostředky.
Popis Určuje zdrojový účet platby. Je důležitý pro zobrazení „Odhalování duplicitních plateb“. Spolu s příjemcem, částkou a časem tvoří jedinečnou kombinaci, která pomáhá odhalit nechtěné dvojí platby. Umožňuje také analyzovat objem plateb podle zdrojového účtu a zjistit, která interní portfolia jsou nejaktivnější. Proč je to důležité Nezbytné pro odhalování duplicit a analýzu podvodů. Kde data získat Podrobnosti transakce, sloupec Debit Account. Příklady 123456789987654321ACC-001-992
	Číslo účtu příjemce PayeeAccountNumber	Číslo účtu, na který se připisují prostředky.
Popis Určuje cílový účet. Stejně jako účet plátce je důležitý pro zobrazení „Odhalování duplicitních plateb“. Zajišťuje, že analýza správně zohlední konkrétní vztahy mezi plátcem a příjemcem. Při sledování dodržení uzávěrek pomáhá znalost příjemce upřednostnit strategické dodavatele nebo důležitá vypořádání, která nesmějí selhat. Proč je to důležité Nezbytné pro odhalování duplicit a analýzu příjemců. Kde data získat Podrobnosti transakce, sloupec Credit Account nebo Beneficiary. Příklady 555000111222333444BEN-882-11
	Datum splatnosti platby PaymentDueDate	Datum, do kterého musí být platba zpracována.
Popis Cílové datum dokončení platby. Využívá se v „Kontrole dodržení uzávěrky zpracování“ k označení transakcí, u kterých hrozí zpoždění. Porovnáním časového razítka „Platba vypořádána“ s tímto atributem lze vypočítat včasnost plateb a pomoci organizaci udržet důvěru příjemců. Proč je to důležité Referenční bod pro měření dodržení SLA. Kde data získat Podrobnosti platební instrukce. Příklady 2023-11-012023-11-15
	Kód chyby ErrorCode	Konkrétní kód vytvořený při neúspěšném ověření platby.
Popis Zaznamenává technický nebo obchodní kód chyby spojený s aktivitami „Zjištěna chyba platby“. Tento atribut tvoří základ přehledu chyb při ověřování a opakovaného zpracování. Souhrn četnosti jednotlivých kódů chyb pomáhá odhalit systémové problémy s kvalitou dat, například „Neplatné směrovací číslo“, a cíleně upravit logiku ověřování nebo školení uživatelů. Proč je to důležité Pomáhá odhalit hlavní příčiny opakovaného zpracování. Kde data získat Protokoly chyb nebo podrobnosti o stavu transakce. Příklady E-101INV_ACCNSF_ERRAUTH_FAIL
	Kód měny CurrencyCode	Kód ISO měny, ve které je částka platby uvedena.
Popis Určuje měnu platby, například USD nebo EUR. Tento atribut je důležitý pro dashboard „Trendy objemu podle měny a způsobu platby“, který organizaci umožňuje sledovat expozici vůči různým cizím měnám. Používá se také k přepočtu částek pro globální výkaznictví a k tomu, aby kontrola duplicit nesprávně neoznačila transakce se stejnou číselnou hodnotou v různých měnách. Proč je to důležité Nezbytné pro analýzu zpracování plateb ve více měnách. Kde data získat Tabulka hlaviček transakcí, sloupec Currency. Příklady USDEURGBPCADJPY
	Uživatel zpracovávající platbu ProcessingUser	ID uživatele nebo systémového agenta odpovědného za aktivitu.
Popis Určuje, kdo provedl danou akci, ať už šlo o schvalujícího pracovníka, nebo automatizovaný systémový proces. Tyto údaje využívají dashboardy „Efektivita řešení chyb“ a „Průchodnost schvalování podle oprávnění“. Sledování uživatelů pomáhá odhalit potřebu školení u pracovníků s vysokou chybovostí nebo najít úzká místa, kde jsou konkrétní schvalující zahlceni požadavky. Proč je to důležité Umožňuje analyzovat zdroje a hledat úzká místa. Kde data získat Auditní protokoly, sloupec User ID. Příklady jdoeSYSTEM_BATCHmsmith_approverAPI_USER
	Zpracováno bez zásahu IsStraightThroughProcessing	Příznak, který určuje, zda platba nevyžadovala ruční zásah.
Popis Vypočítávaný booleovský atribut, který má hodnotu true, pokud případ neobsahuje kroky „Zjištěna chyba platby“, „Chyba platby vyřešena“ ani ruční „Platba schválena“, podle použité definice. Přímo podporuje KPI míry plně automatického zpracování. Umožňuje rozdělit proces na plně automatické průběhy a průběhy vyžadující zásah člověka, a jasně tak ukázat možnosti automatizace. Proč je to důležité Základní ukazatel efektivity procesu a úspěšnosti automatizace. Kde data získat Vypočítáno při transformaci dat. Příklady truefalse
	Způsob platby PaymentMethod	Způsob provedení platby, například Wire nebo ACH.
Popis Rozděluje transakce podle použitého platebního kanálu. Tento atribut je zásadní pro analýzu doby schválení, protože různé způsoby platby mají odlišné standardní postupy a dohodnuté úrovně služeb. Porovnání variant procesu podle způsobu platby pomáhá zjistit, zda se prodlevy týkají konkrétního kanálu, například mezinárodních převodů, nebo celé organizace. Proč je to důležité Rozděluje průběh procesu podle použité infrastruktury. Kde data získat Sloupec s typem transakce nebo kódem platebního nástroje. Příklady Bankovní převodACHŠekRTPInterní převod
	Banka příjemce BeneficiaryBank	Název nebo identifikátor banky, která platbu přijímá.
Popis Určuje finanční instituci, která platbu přijímá. Pomáhá analyzovat prodlevy při vypořádání, protože jednotlivé banky mohou mít různou rychlost zpracování nebo problémy s integrací. Rozšiřuje dashboard „Prodleva mezi vypořádáním a odsouhlasením“ o další hledisko a pomáhá rozlišit externí prodlevy způsobené konkrétní bankou od interních. Proč je to důležité Analýza závislostí na externích subjektech. Kde data získat Podrobnosti transakce, sloupec Bank ID nebo Name. Příklady ChaseBank of AmericaWells FargoCitibank
	Obchodní jednotka BusinessUnit	Oddělení nebo divize, která platbu zadala.
Popis Zařazuje platbu podle organizační jednotky odpovědné za výdaj. Pomáhá rozdělovat náklady a zjistit, které části organizace mají nejvíce ručního opakovaného zpracování nebo chyb. Podporuje audit souladu platebních postupů s pravidly tím, že ověřuje, zda jednotlivé jednotky dodržují příslušné regulatorní požadavky nebo interní kontrolní pravidla. Proč je to důležité Poskytuje organizační kontext pro hodnocení výkonnosti. Kde data získat Mapování nákladových středisek nebo kód oddělení. Příklady Retailové bankovnictvíFiremní úvěrySpráva majetkuProvoz
	Opakované zpracování IsRework	Příznak, který určuje, zda je tato konkrétní aktivita součástí opakovaného zpracování.
Popis Booleovský příznak označující aktivity, které následují po zjištění chyby, ale před jejím vyřešením, nebo opakované aktivity. Podporuje KPI míry opakovaného ověřování plateb. Analytici mohou filtrovat mapu procesu a zobrazit pouze standardní průběh, nebo se zaměřit výhradně na cestu opakovaného zpracování a zjistit, proč k chybám dochází. Proč je to důležité Odděluje práci přinášející hodnotu od práce spojené s opravami. Kde data získat Vypočítáno na základě opakujících se smyček v procesu. Příklady truefalse
	Úroveň schválení ApprovalLevel	Hierarchická úroveň potřebná ke schválení platby nebo použitá při jejím schválení.
Popis Udává senioritu nebo úroveň oprávnění spojenou s aktivitou „Platba schválena“. Dashboard „Průchodnost schvalování podle oprávnění“ pomáhá zjistit, zda se schvalování na vyšší úrovni nestává úzkým místem. Přehled plateb podle úrovní, například úroveň 1 a úroveň 3, pomáhá lépe nastavit delegování schvalovacích oprávnění. Proč je to důležité Rozděluje úzká místa ve schvalování podle úrovně v hierarchii. Kde data získat Tabulky uživatelských rolí nebo schvalovacího workflow. Příklady Úroveň 1VedoucíŘeditelCFO
	Zmeškána uzávěrka IsCutoffMissed	Příznak, který určuje, zda byla platba odeslána po denní bankovní uzávěrce.
Popis Vypočítávaná booleovská hodnota, která porovnává čas „Platební instrukce odeslána“ s denní uzávěrkou pro konkrétní měnu a způsob platby. Podporuje KPI míry dodržení uzávěrky. Zjištění zmeškaných uzávěrek pomáhá hledat příčiny prodlev, ať už jde o pozdní zahájení, nebo pomalé interní zpracování. Proč je to důležité Důležité pro dodržování provozních pravidel a řízení likvidity. Kde data získat Vypočítáno porovnáním EventTimestamp s referenční tabulkou uzávěrek. Příklady truefalse

Povinné Doporučené Volitelné

Aktivity při zpracování plateb

Zaznamenejte do záznamu událostí tyto důležité kroky a milníky procesu. Umožníte tak přesné zjištění průběhu a optimalizaci workflow plateb.

5 Doporučené 8 Volitelné

	Aktivita	Popis
	Platba odsouhlasena	Interní párování transakce s bankovními výpisy nebo soubory o vypořádání. Tím se uzavírá účetní proces.
Proč je to důležité Vyžadováno pro ukazatel „Prodleva mezi vypořádáním a odsouhlasením“. Zajišťuje správné uzavření účetních knih. Kde data získat Protokoly modulu odsouhlasení, kde se stav mění na „Spárováno“ nebo „Odsouhlaseno“. Zachycení Zaznamenáno při spárování v rámci odsouhlasení Typ události explicit
	Platba schválena	Ruční nebo automatické rozhodnutí, že platba může pokračovat v rámci stanovených limitů pravomocí. Zaznamená se, když oprávněný uživatel nebo systémové pravidlo změní příznak schválení.
Proč je to důležité Důležité pro analýzu 'Authorization Cycle Time Analysis'. Prodlevy v této fázi ukazují na úzká místa v řetězci ručního schvalování. Kde data získat Auditní záznamy o akci uživatele, která změnila stav z 'Pending Approval' na 'Approved'. Zachycení Zaznamená se při provedení schvalovací akce Typ události explicit
	Platba vypořádána	Převod prostředků je dokončen a zaúčtován do hlavní knihy. Z pohledu banky tím končí finanční zpracování transakce.
Proč je to důležité Hlavní koncový bod pro KPI „Míra plně automatického zpracování“. Ukazuje, že peníze skutečně odešly. Kde data získat Stav transakce „Zaúčtováno“ nebo časové razítko „Datum zaúčtování“ v hlavní knize. Zachycení Zaznamenáno při zaúčtování do hlavní knihy Typ události explicit
	Platební instrukce odeslána	Odeslání platebního souboru (například dávky ACH nebo zprávy Wire) do externí sítě či clearingového centra. Jde o důležitý bod předání.
Proč je to důležité Důležité pro „Kontrolu dodržení uzávěrky zpracování“. Ověřuje, zda organizace dodržuje denní bankovní uzávěrky. Kde data získat Protokoly dávkového zpracování nebo časová razítka vytvoření souboru. Událost se často zaznamenává jako „Dávka vytvořena“ nebo „Soubor odeslán“. Zachycení Zaznamenáno při vytvoření dávkového souboru Typ události explicit
	Požadavek na platbu vytvořen	První zadání platebního příkazu do systému Fiserv. Tato událost se zaznamená, když uživatel nebo externí systém zahájí transakci prostřednictvím API nebo uživatelského rozhraní.
Proč je to důležité Označuje začátek časové osy procesu. Je nezbytný pro výpočet celkové doby zpracování a odhalení úzkých míst při příjmu požadavků. Kde data získat Časové razítko vytvoření záznamu v tabulce historie transakcí. Vyhledejte nejstarší záznam s příslušným Payment Transaction ID. Zachycení Zaznamená se při vložení záznamu o transakci Typ události explicit
	Chyba platby vyřešena	Označuje opravu transakce, u které byla dříve zjištěna chyba. Událost se odvozuje z přechodu transakce ze stavu chyby zpět do stavu zpracování nebo platného stavu.
Proč je to důležité Nezbytné pro výpočet ukazatele 'Mean Time to Resolve Payment Errors'. Pomáhá měřit efektivitu provozního týmu. Kde data získat Odvozuje se ze změny stavu transakce z chybového kódu na běžný kód zpracování. Zachycení Porovnejte pole stavu před změnou a po ní Typ události inferred
	Oznámení o platbě odesláno	Systém odešle plátci nebo příjemci zprávu (e-mail/SMS) s potvrzením transakce. Zákazník tak má lepší přehled o jejím průběhu.
Proč je to důležité Podporuje ukazatel „Rychlost a včasnost oznámení“. Dlouhá prodleva po vypořádání snižuje důvěru zákazníků. Kde data získat Protokoly komunikace nebo tabulky historie interakcí se zákazníky propojené s ID transakce. Zachycení Zaznamenáno při odeslání e-mailu/SMS Typ události explicit
	Platba autorizována	Konečné interní potvrzení, že jsou k dispozici prostředky a transakce může být provedena. Může proběhnout současně se schválením nebo jako samostatná systémová kontrola.
Proč je to důležité Rozlišuje mezi schválením vedoucím a autorizací na úrovni systému. Důležité pro dashboard „Průchodnost schvalování podle oprávnění“. Kde data získat Změna stavu na „Autorizováno“ nebo „Připraveno k zaúčtování“. Zachycení Porovnejte pole stavu před změnou a po ní Typ události inferred
	Platba naplánována	Nastává, když je platba schválena, ale čeká na budoucí datum účinnosti. Systém zařadí transakci do fronty a zpracuje ji, až se otevře příslušné časové okno.
Proč je to důležité Vysvětluje dobu nečinnosti v procesu. Rozlišuje mezi prodlevou způsobenou úzkým místem a záměrným čekáním na datum splatnosti. Kde data získat Porovnání „Data zadání“ a „Data účinnosti“. Pokud je datum účinnosti v budoucnosti, je tento stav aktivní. Zachycení Odvozeno porovnáním pole X s polem Y Typ události calculated
	Platba potvrzena	Přijetí kladného potvrzení (ACK) od externí sítě nebo brány. Potvrzuje, že další subjekt instrukci řádně přijal.
Proč je to důležité Ověřuje, zda bylo „Odeslání platební instrukce“ úspěšné. Prodlevy v této fázi mohou ukazovat na problémy s připojením k síti nebo s externím formátem. Kde data získat Protokoly zpracování příchozích souborů nebo návratové kódy API potvrzující přijetí. Zachycení Zaznamenáno při přijetí ACK Typ události explicit
	Platba zrušena	Ukončení platebního toku před vypořádáním, které zahájí uživatel nebo systémové pravidlo. Tím se zastaví další zpracování.
Proč je to důležité Odhaluje zbytečnou práci a opuštěné případy. Časté rušení po schválení může ukazovat na neefektivní proces. Kde data získat Změna stavu na „Zrušeno“, „Stornováno“ nebo „Zastaveno“. Zachycení Zaznamenáno při změně stavu na Zrušeno Typ události explicit
	Údaje o platbě ověřeny	Systém kontroluje čísla účtů, směrovací čísla a správnost formátu. Tato událost se obvykle odvozuje z úspěšného přechodu transakce ze stavu přijetí do stavu čekání nebo schválení, aniž by došlo k chybě.
Proč je to důležité Označuje úspěšné dokončení první automatické kontroly. Případné selhání v této fázi ukazuje na problém s kvalitou dat, nikoli s likviditou nebo schválením. Kde data získat Odvozuje se z rychlé změny stavu z 'Received' na 'Pending' nebo 'Ready'. Zachycení Porovnejte pole stavu před změnou a po ní Typ události inferred
	Zjištěna chyba platby	Zaznamenává okamžik, kdy je transakce označena jako neúspěšná nebo jí je přiřazen kód výjimky. Dochází k tomu při nesplnění pravidel ověřování nebo při záporné odpovědi z externí kontroly.
Proč je to důležité Důležité pro dashboard 'Validation Error and Rework Tracker'. Vysoký počet těchto případů ukazuje na problémy s kvalitou vstupních dat. Kde data získat Pole stavu transakce se změní na kód výjimky, například 'Invalid', 'Hold' nebo 'Error'. Zachycení Zaznamená se při změně stavu na Error Typ události explicit

Doporučené Volitelné

Návody k extrakci dat

Jak získat data z Fiserv

Kroky

1. Nastavení předpokladů

Zajistěte si přístup na vývojářský portál Fiserv Commerce Hub. Vygenerujte API Key a API Secret, někdy označované jako Client ID a Client Secret, s oprávněním používat rozhraní Transaction Inquiry nebo Search API. Pokud prostředí Fiserv omezuje přístup podle IP adres, ověřte, že je vaše IP adresa na seznamu povolených.

2. Nastavení prostředí

Na serveru pro export nebo místním počítači nainstalujte Python 3.8 nebo novější. Budete potřebovat knihovny requests a pandas. Nainstalujte je příkazem pip install requests pandas. Vytvořte pracovní adresář pro skript a výstupní soubory.

3. Nastavení skriptu

Stáhněte dodaný skript Python do pracovního adresáře. Otevřete jej a upravte konfigurační část na začátku. Zadejte vlastní hodnoty API_KEY, API_SECRET a BASE_URL. Pro testování použijte adresu sandboxu, pro konečné spuštění produkční adresu. Proměnné START_DATE a END_DATE nastavte podle požadovaného období process mining.

4. Implementace ověřování

Skript obsahuje pomocnou třídu pro specifické požadavky Fiserv na ověřování. Obvykle jde o vytvoření podpisu HMAC pomocí vašeho API Secret, časového razítka a obsahu požadavku. Logiku vytváření podpisu neupravujte, pokud vaše implementace Fiserv nepoužívá jiný standard, například přístupové tokeny OAuth2 typu bearer.

5. Princip zpracování dat

Skript načítá transakce přes API. API obvykle vrací snímek objektu transakce s různými časovými údaji, například časem odeslání, autorizace a vypořádání. Skript tento objekt JSON převede do více řádků, tedy událostí v záznamu událostí. Jeden záznam JSON s časem odeslání a vypořádání tak vytvoří v souboru CSV alespoň dva samostatné řádky.

6. Zpracování stránkování

Skript obsahuje cyklus pro stránkování. Rozhraní Fiserv API omezují počet záznamů v jedné odpovědi, často na 50 nebo 100. Skript automaticky načítá další stránku, dokud nezíská všechny transakce z daného období. Při zpracování velkých objemů dat může načítání chvíli trvat, proto ověřte stabilitu internetového připojení.

7. Spuštění

Spusťte skript z příkazového řádku: python fiserv_extraction.py. V konzoli se zobrazí průběh, počet zpracovaných stránek a načtených transakcí. Sledujte případné chyby HTTP 401 (Unauthorized) nebo 429 (Rate Limit).

8. Kontrola výstupu

Po dokončení skriptu vyhledejte v adresáři soubor fiserv_event_log.csv. Otevřete jej a ověřte, že sloupec ActivityName obsahuje kombinaci 13 požadovaných aktivit a že pole EventTimestamp má správný formát.

9. Následné úpravy (volitelné)

Pokud potřebujete upravit časové pásmo, například převést UTC na místní čas, můžete změnit část skriptu, která transformuje data pomocí pandas, nebo úpravu provést v ProcessMind po nahrání.

10. Nahrání do ProcessMind

Importujte soubor CSV do ProcessMind. Namapujte PaymentTransactionId na ID případu, ActivityName na Aktivitu a EventTimestamp na Časové razítko. Číselné sloupce, například PaymentAmount, namapujte jako atributy.

Konfigurace

Přístupové údaje API: Potřebujete API Key a Secret/Shared Secret. Ověřte, že umožňují přístup pro čtení ke koncovým bodům pro reportování transakcí.
Základní URL: Pro produkční prostředí nastavte https://api.commerce.fiserv.com, případně použijte konkrétní certifikační nebo sandbox URL, kterou jste dostali při zprovoznění.
Rozsah dat: Vzhledem k velikosti odpovědí API doporučujeme extrahovat data za 30 až 90 dní. Historická data načítejte po jednotlivých měsících.
Velikost stránky: Nastavena na 100 záznamů na volání, aby se vyvážilo využití paměti a zatížení sítě.
Časové pásmo: API vrací časová razítka v UTC. Skript tento standard zachovává, aby byla data konzistentní napříč regiony.
Opakování požadavků: Zahrnuje základní mechanismus opakování při občasném vypršení časového limitu sítě (HTTP 500/502/503).

Ukázkový dotaz python

import requests
import json
import time
import hmac
import hashlib
import base64
import uuid
import pandas as pd
from datetime import datetime, timedelta

class=class="hl-string">"hl-comment"># ==========================================
class=class="hl-string">"hl-comment"># CONFIGURATION
class=class="hl-string">"hl-comment"># ==========================================
API_KEY = class="hl-string">"YOUR_API_KEY"
API_SECRET = class="hl-string">"YOUR_API_SECRET"
BASE_URL = class="hl-string">"https://cert.api.fiservapps.com"  class=class="hl-string">"hl-comment"># Update to Production URL as needed
ENDPOINT = class="hl-string">"/ch/payments/v1/transaction-inquiry"
START_DATE = class="hl-string">"2023-01-01"
END_DATE = class="hl-string">"2023-01-31"
PAGE_SIZE = 50
OUTPUT_FILE = class="hl-string">"fiserv_event_log.csv"

class=class="hl-string">"hl-comment"># ==========================================
class=class="hl-string">"hl-comment"># AUTHENTICATION HELPER
class=class="hl-string">"hl-comment"># ==========================================
def generate_headers(payload):
    class=class="hl-string">"hl-comment"># Fiserv Commerce Hub typically requires HMAC auth
    class=class="hl-string">"hl-comment"># This is a standard implementation pattern
    client_request_id = str(uuid.uuid4())
    timestamp = str(int(time.time() * 1000))
    
    class=class="hl-string">"hl-comment"># specific signature construction depends on Fiserv documentation version
    class=class="hl-string">"hl-comment"># standard pattern: apiKey + reqId + timestamp + payload
    raw_signature = API_KEY + client_request_id + timestamp + payload
    
    hmac_obj = hmac.new(
        API_SECRET.encode(class="hl-string">'utf-8'),
        raw_signature.encode(class="hl-string">'utf-8'),
        hashlib.sha256
    )
    message_signature = base64.b64encode(hmac_obj.digest()).decode(class="hl-string">'utf-8')
    
    return {
        class="hl-string">"Content-Type": class="hl-string">"application/json",
        class="hl-string">"Client-Request-Id": client_request_id,
        class="hl-string">"Api-Key": API_KEY,
        class="hl-string">"Timestamp": timestamp,
        class="hl-string">"Message-Signature": message_signature
    }

class=class="hl-string">"hl-comment"># ==========================================
class=class="hl-string">"hl-comment"># PARSING LOGIC (UNPIVOTING EVENTS)
class=class="hl-string">"hl-comment"># ==========================================
def extract_events_from_transaction(tx):
    events = []
    
    class=class="hl-string">"hl-comment"># Base Attributes
    case_id = tx.get(class="hl-string">"transactionId", class="hl-string">"")
    amount = tx.get(class="hl-string">"amount", {}).get(class="hl-string">"total", 0.0)
    currency = tx.get(class="hl-string">"amount", {}).get(class="hl-string">"currency", class="hl-string">"USD")
    method = tx.get(class="hl-string">"paymentMethod", {}).get(class="hl-string">"type", class="hl-string">"Unknown")
    payer_acc = tx.get(class="hl-string">"paymentMethod", {}).get(class="hl-string">"maskedAccountNumber", class="hl-string">"")
    class=class="hl-string">"hl-comment"># Identifying common attributes
    base_data = {
        class="hl-string">"PaymentTransactionId": case_id,
        class="hl-string">"SourceSystem": class="hl-string">"Fiserv Commerce Hub",
        class="hl-string">"LastDataUpdate": datetime.utcnow().isoformat(),
        class="hl-string">"PaymentAmount": amount,
        class="hl-string">"CurrencyCode": currency,
        class="hl-string">"PaymentMethod": method,
        class="hl-string">"PayerAccountNumber": payer_acc,
        class="hl-string">"PayeeAccountNumber": class="hl-string">"MerchantAccount", class=class="hl-string">"hl-comment"># Placeholder
        class="hl-string">"ErrorCode": tx.get(class="hl-string">"processorResponseDetails", {}).get(class="hl-string">"responseCode", class="hl-string">""),
        class="hl-string">"IsStraightThroughProcessing": class="hl-string">"True" class=class="hl-string">"hl-comment"># Default assumption unless error found
    }

    class=class="hl-string">"hl-comment"># Helper to append event
    def add_event(activity, timestamp_str, specific_attrs={}):
        if timestamp_str:
            row = base_data.copy()
            row.update({
                class="hl-string">"ActivityName": activity,
                class="hl-string">"EventTimestamp": timestamp_str
            })
            row.update(specific_attrs)
            events.append(row)

    class=class="hl-string">"hl-comment"># 1. Payment Request Created (Submission Time)
    submission_time = tx.get(class="hl-string">"submissionTime")
    add_event(class="hl-string">"Payment Request Created", submission_time)

    class=class="hl-string">"hl-comment"># 2. Payment Details Validated (Inferred: slightly after submission if no immediate 400 error)
    class=class="hl-string">"hl-comment"># We infer this exists if the transaction exists and has a submission time
    if submission_time:
        class=class="hl-string">"hl-comment"># Infer validation happened 1 second after submission
        val_time = (datetime.fromisoformat(submission_time.replace(class="hl-string">'Z', class="hl-string">'+00:00')) + timedelta(seconds=1)).isoformat()
        add_event(class="hl-string">"Payment Details Validated", val_time)

    class=class="hl-string">"hl-comment"># 3. Payment Error Identified / 4. Resolved
    status = tx.get(class="hl-string">"transactionStatus", class="hl-string">"")
    if status == class="hl-string">"FAILED":
        fail_time = tx.get(class="hl-string">"processorResponseDetails", {}).get(class="hl-string">"responseTimestamp", submission_time)
        add_event(class="hl-string">"Payment Error Identified", fail_time, {class="hl-string">"IsStraightThroughProcessing": class="hl-string">"False"})
    elif status == class="hl-string">"APPROVED" and tx.get(class="hl-string">"retryCount", 0) > 0:
        class=class="hl-string">"hl-comment"># Logic: If approved but had retries, an error was resolved
        add_event(class="hl-string">"Payment Error Resolved", submission_time) class=class="hl-string">"hl-comment"># Simplified assumption

    class=class="hl-string">"hl-comment"># 5. Payment Approved
    approval_time = tx.get(class="hl-string">"approvalTime")
    if approval_time:
        add_event(class="hl-string">"Payment Approved", approval_time)

    class=class="hl-string">"hl-comment"># 6. Payment Authorized
    auth_time = tx.get(class="hl-string">"authorizationTime")
    class=class="hl-string">"hl-comment"># If separate auth time not provided, use approval time
    if not auth_time and approval_time:
        auth_time = approval_time
    add_event(class="hl-string">"Payment Authorized", auth_time)

    class=class="hl-string">"hl-comment"># 7. Payment Scheduled (if future dated)
    req_exec_date = tx.get(class="hl-string">"requestedExecutionDate")
    if req_exec_date and req_exec_date > submission_time:
         add_event(class="hl-string">"Payment Scheduled", submission_time)

    class=class="hl-string">"hl-comment"># 8. Payment Instruction Sent
    gateway_time = tx.get(class="hl-string">"gatewayTransmitTime")
    add_event(class="hl-string">"Payment Instruction Sent", gateway_time)

    class=class="hl-string">"hl-comment"># 9. Payment Confirmed (Gateway ACK)
    gateway_ack = tx.get(class="hl-string">"gatewayAckTime")
    add_event(class="hl-string">"Payment Confirmed", gateway_ack)

    class=class="hl-string">"hl-comment"># 10. Payment Settled
    settle_time = tx.get(class="hl-string">"settlementTime") or tx.get(class="hl-string">"fundingDate")
    add_event(class="hl-string">"Payment Settled", settle_time)

    class=class="hl-string">"hl-comment"># 11. Payment Notification Sent (Inferred or specific field)
    notify_time = tx.get(class="hl-string">"customerNotificationEmailTime")
    add_event(class="hl-string">"Payment Notification Sent", notify_time)

    class=class="hl-string">"hl-comment"># 12. Payment Reconciled
    recon_time = tx.get(class="hl-string">"reconciliationDate")
    add_event(class="hl-string">"Payment Reconciled", recon_time)

    class=class="hl-string">"hl-comment"># 13. Payment Cancelled
    if status == class="hl-string">"VOIDED" or status == class="hl-string">"CANCELLED":
        void_time = tx.get(class="hl-string">"voidTime") or tx.get(class="hl-string">"lastUpdateTime")
        add_event(class="hl-string">"Payment Cancelled", void_time)

    return events

class=class="hl-string">"hl-comment"># ==========================================
class=class="hl-string">"hl-comment"># MAIN EXTRACTION LOOP
class=class="hl-string">"hl-comment"># ==========================================
def main():
    all_events = []
    page_number = 1
    has_more = True
    
    print(fclass="hl-string">"Starting extraction from {START_DATE} to {END_DATE}...")

    while has_more:
        class=class="hl-string">"hl-comment"># Construct Search Payload
        payload_dict = {
            class="hl-string">"startDate": START_DATE,
            class="hl-string">"endDate": END_DATE,
            class="hl-string">"page": page_number,
            class="hl-string">"limit": PAGE_SIZE
        }
        payload_json = json.dumps(payload_dict)
        
        headers = generate_headers(payload_json)
        full_url = BASE_URL + ENDPOINT
        
        try:
            response = requests.post(full_url, headers=headers, data=payload_json)
            
            if response.status_code == 200:
                data = response.json()
                transactions = data.get(class="hl-string">"reports", []) class=class="hl-string">"hl-comment"># Key depends on specific endpoint schema
                
                if not transactions:
                    print(fclass="hl-string">"No transactions found on page {page_number}. Finishing.")
                    has_more = False
                    break
                
                print(fclass="hl-string">"Processing page {page_number}, found {len(transactions)} transactions.")
                
                for tx in transactions:
                    events = extract_events_from_transaction(tx)
                    all_events.extend(events)
                
                class=class="hl-string">"hl-comment"># Pagination Check
                total_pages = data.get(class="hl-string">"totalPages", page_number)
                if page_number >= total_pages:
                    has_more = False
                else:
                    page_number += 1
            else:
                print(fclass="hl-string">"Error fetching data: {response.status_code} - {response.text}")
                has_more = False
                
        except Exception as e:
            print(fclass="hl-string">"Exception occurred: {str(e)}")
            has_more = False

    class=class="hl-string">"hl-comment"># ==========================================
    class=class="hl-string">"hl-comment"># EXPORT TO CSV
    class=class="hl-string">"hl-comment"># ==========================================
    if all_events:
        df = pd.DataFrame(all_events)
        class=class="hl-string">"hl-comment"># Column ordering
        cols = [
            class="hl-string">"PaymentTransactionId", class="hl-string">"ActivityName", class="hl-string">"EventTimestamp", 
            class="hl-string">"SourceSystem", class="hl-string">"PaymentAmount", class="hl-string">"CurrencyCode", class="hl-string">"PaymentMethod",
            class="hl-string">"PayerAccountNumber", class="hl-string">"ErrorCode", class="hl-string">"IsStraightThroughProcessing"
        ]
        class=class="hl-string">"hl-comment"># Ensure columns exist even if empty
        for c in cols:
            if c not in df.columns:
                df[c] = None
                
        df = df[cols]
        df.to_csv(OUTPUT_FILE, index=False)
        print(fclass="hl-string">"Extraction complete. {len(df)} rows written to {OUTPUT_FILE}")
    else:
        print(class="hl-string">"No events extracted.")

if __name__ == class="hl-string">"__main__":
    main()

Chcete začít?

Začněte zlepšovat finanční workflow použitím této šablony ve svém prostředí Fiserv. Díky našemu návodu získáte správná data pro smysluplné zlepšení cash flow a shody v provozu.

Zpět na průvodce zlepšováním

Stáhnout šablonu

Zlepšete zpracování plateb a dosáhněte 98% podílu přímého zpracování

Omezte zpoždění při párování a získejte přehled o workflow ve Fiserv.

Začněte zkušební verzi

Platební kartu nepotřebujete. Nastavení zabere jen několik minut.

Datová šablona pro zpracování plateb

Datová šablona pro zpracování plateb

Atributy zpracování plateb

Aktivity při zpracování plateb

Návody k extrakci dat

Python skript pro Fiserv Commerce Hub API

Kroky

1. Nastavení předpokladů

2. Nastavení prostředí

3. Nastavení skriptu

4. Implementace ověřování

5. Princip zpracování dat

6. Zpracování stránkování

7. Spuštění

8. Kontrola výstupu

9. Následné úpravy (volitelné)

10. Nahrání do ProcessMind

Konfigurace

Ukázkový dotaz python

Chcete začít?

Zlepšete zpracování plateb a dosáhněte 98% podílu přímého zpracování