Na této stránce je popisován proces automatického importu požadavků na změny sledovaných subjektů přes mejlové rozhraní. Máte-li zájem o aktivaci této služby, kontaktujte nás.

Rozhraní importu dat monitoringů - emailová brána CreditCheck

Credit Check, s.r.o. poskytuje bránu pro automatizované operace s daty monitoringů jednotlivých odběratelů monitoringů.

Přístup k této bráně není poskytován automaticky a pro jeho aktivaci je nutné kontaktovat obchodní oddělení .

Možnost importování IČ/RČ mailem přestane být během roku 2025 podporována. Pro nové implementace importu hodnot do Monitoringu prosím zvolte alternativní možnost (API). Děkujeme za pochopení.

Princip importu dat je jednoduchý a umožňuje používání napříč klientskými platformami. Základním blokem jednotlivýcj operací je csv soubor, který je přiložený k odběratelskému emailu, který je zaslaný na naše rozhraní. Soubor obsahuje seznam hodnot, ať ič nebo rč, se kterými má být provedena příslušná operace nad příslušným typem monitoringu. Viz popis níže.

Jednotlivé hodnoty v souboru jsou ve struktuře, která definuje 1 hodnotu na jednom řádku v souboru. Oddělovače zde neexistují. Hlavička sloupce není podporována, resp. je vzhodnocena jako nevalidní data v seznamu hodnot.

Příklad:

12345678

87654321

98765432

atd.

Soubor a hodnoty v souboru jsou testované a validované mnoha parametry. Pokud se vyskytne některá z námi předpokládaných chyb, nedojde k operaci s daty, soubor je z rozhraní smazán bez zálohy a odběrateli

je poslaný email se zprávou o problému.

V případě úspěchu kontrolních mechanismů dojde k příslušné operaci s daty, smazání vstupního souboru bez zálohy z našeho rozhraní a nakonec se odešle odběratelovi email se zprávou o úspěšnosti.

Doporučení

Importy hodnot pro jednotlivé typy provádějte pokud možno mimo dobu generování denních a týdenních reportů monitoringů mezi 5 - 11 hodinou dopoledne.

Ve vývoji

Části, které jsou v dokumentaci označeny jako "ve vývoji" doděláváme průběžně dle požadavků konkrétních uživatelů. Přejete-li si některou z těchto funkcí využít, požádejte o ni a my ji obratem připravíme.

Podporované operace importu monitoringu mejlového rozhraní CreditCheck

Číslo	Název operace	Verze	Příklad názvu souboru imporu	Popis	Země
1.	add	1.0	add_CCH_20130902_Ic.csv	Operace přidá seznam hodnot k již existujícímu seznamu hodnot monitoringu.	CZ
2.	new		new_CCH_20130902_Ic.csv	Operace založí nový seznam hodnot monitoringu pro odběratele monitoringu, který má povolený příslušný typ monitoringu.	CZ
3.	del		del_CCH_20130902_Ic.csv	Operace smaže seznam hodnot, které jsou obsaženy v importovaném seznamu, ze stávajícího seznamu monitoringu.	CZ
4	rep		rep_CCH_20130902_Ic.csv	Operace nahradí existující seznam hodnot monitoringu seznamem hodnot v importovaném souboru.

Podporované typy monitoringu mejlového rozhraní CreditCheck

Číslo	Název typu	Verze	Příklad názvu souboru imporu	Název monitoringu	Země
1.	CCH	1.0	add_CCH_20130902_Ic.csv	Monitoring Rizikové události	CZ
2.	IsirIc	1.0	new_IsirIc_20130902_Ic.csv	Monitoring Insolvence - IČ.	CZ
4	zaverky	1.0	add_zaverky_20130902_Ic.csv	Monitoring dostupných závěrek.	CZ
5.	dph	1.0	add_dph_20130902_Ic.csv	Monitoring plátcovství Dph.	CZ
7.	relaceIc	1.0	add_relaceIc_20130902_Ic.csv	Monitoring změn angažmá pravos ve firmě..	CZ
8.	creditlimit	1.0	add_creditlimit_20130902_Ic.csv	Monitoring kreditního limitu.	CZ
9.	np	1.0	add_np_20130902_Ic.csv	Monitoring nespolehlivých plátců.	CZ
10.	nazvy	1.0	add_nazvy_20130902_Ic.csv	Monitoring změny nazvu subjektu.	CZ
11.	adresy	1.0	add_adresy_20130902_Ic.csv	Monitoring změny adresy subjektu.	CZ
12.	sl	1.0	add_sl_20130902_Ic.csv	Monitoring nových dokumentů ve sbírce listin.	CZ
13.	soudnispory	1.0	add_soudnispory_20130902_Ic.csv	Monitoring soudních sporů ISPIS.	CZ
15.	bankUcty	1.0	add_bankUcty_20130902_Ic.csv	Monitoring změn bankovních účtů.	CZ

Pokud chcete zadávat změny u více typů monitoringu, je třeba zasalat pro každý typ monitorignu samostatný email.

Podporované typy hodnot monitoringu mejlového rozhraní CreditCheck

Číslo	Název typu	Verze	Příklad názvu souboru imporu	Název typu hodnoty	Země
1.	Ic	1.0	add_CCH_20130902_Ic.csv	Ičo. Importovaný soubor obsahuje iča.	CZ
2.	Rc	ve vývoji
3.	Osoby	ve vývoji

Podporované pojmenování souborů importu monitoringu mejlového rozhraní CreditCheck

Číslo	Části názvu z příkladu add_CCH_20130902_Ic.csv	Verze	Popis	Poznámka	Země
1.	add	1.0	Typ operace. Podporavané typy viz výše.		CZ
2.	CCH		Typ monitoringu. Podporované monitoringy viz výše.		CZ
3.	20130902		Datum vydání souboru ve formátu YYYYMMDD	Datum relase souboru nemusí odpovídat datumu importu, ale nemělo by být z budoucnosti.	CZ
4	Ic		Určuje cílový typ hodnot v importovaném souboru.	....
---	---------------------------------------------------------------------	-----------	------------------------------------------------------------------	Jednotlivé části jsou názvu souboru musí být oddělené podtržítkem.

Zprávy mejlového rozhraní

Číslo zprávy/chyby	Zpráva (text zpráv může být změněný)	Popis chování importovacího rozhraní emailu.	Řešení	Země
01	Emailová adresa, na kterou byl odeslaný tento email není povolenou adresou importovacího rozhraní systému CreditCheck.	Soubor s hodnotami byl odeslaný z nepovolené emailové adresy. Taková zpráva je bez uložení smazaná a nelze tedy data zpětně získat.	Pošlete email z Vaší povolené adresy nebo kontaktujte helpdesk CreditCheck.	CZ
02	Nepodporovaný název souboru importovacího rozhraní.	Struktura názvu souboru s hodnotami neodpovídá požadovanému vzoru. Taková zpráva je bez uložení smazaná a nelze tedy data zpětně získat.	Zkontrolujte, zda název souboru v příloze odpovídá požadovanému vzoru nebo kontaktujte helpdesk CreditCheck.	CZ
03	Nepodporovaná operace importovacího rozhraní.	Část názvu souboru s daty, která definuje požadovanou operaci s daty, neodpovídá povoleným hodnotám, a proto nelze provést jakoukoliv operaci nad daty monitoringů. Taková zpráva je bez uložení smazaná a nelze tedy data zpětně získat.	Zkontrolujte, zda název operace v části názvu souboru odpovídá povoleným hodnotám nebo kontaktujte helpdesk CreditCheck.	CZ
04	Nepodporovaný typ monitoringu importovacího rozhraní.	Část názvu souboru s daty, která definuje typ monitoringu pro který odesílatel požaduje operaci s daty, neodpovídá povoleným hodnotám a proto nelze provést jakoukoliv operaci nad daty monitoringů. Taková zpráva je bez uložení smazaná a nelze tedy data zpětně získat.	Zkontrolujte, zda název typu monitoringu v části názvu souboru odpovídá povoleným hodnotám nebo kontaktujte helpdesk CreditCheck.	CZ
05	Nepodporovaný název souboru importovacího rozhraní.	Část názvu souboru s daty, která definuje datum vydání souboru odběratele, neodpovídá požadovanému vzoru, a proto nelze provést jakoukoliv operaci nad daty monitoringů. Taková zpráva je bez uložení smazaná a nelze tedy data zpětně získat.	Zkontrolujte, zda datum v části názvu souboru odpovídá požadovanému vzoru nebo kontaktujte helpdesk CreditCheck.	CZ
06	Nepodporovaný název souboru importovacího rozhraní.	Část názvu souboru s daty, která definuje cílový typ hodnot souboru odběratele, neodpovídá požadovanému vzoru, a proto nelze provést jakoukoliv operaci nad daty monitoringů. Taková zpráva je bez uložení smazaná a nelze tedy data zpětně získat.	Zkontrolujte, zda definice cílového typu hodnot v části názvu souboru odpovídá požadovanému vzoru nebo kontaktujte helpdesk CreditCheck.	CZ
07	Nepodporovaný typ monitoringu pro odběratele XXX	Odesílatel souboru s daty požaduje operaci nad typem monitoringu, který nemá povolený.	Zkontrolujte, zda název typu monitoringu v části názvu souboru odpovídá některému z Vašich povolených typů monitoringů nebo kontaktujte helpdesk CreditCheck.	CZ
08	Soubor XXX pro odběratele XXX již existuje.	Odesílatel souboru poslal seznam hodnot, který již jednou poslal v předchozím povoleném intervalu a tudíž posílá duplicitní data. Povolený interval je doba, běžne 2 hodiny, po kterou nelze zaslat stejný seznam hodnot do importovacího rozhraní emailu. Pokud odesílatel pošle rozdílný seznam hodnot, není restrikce časového intervalu uplatněna. (Po vyhodnocení chování odesílatelů dat není vyloučena restrikce na počet povolených importů v určitém časovém intervalu.) Tato restrikce není uplatněna, pokud odesíltel poslal soubor s daty a zpracování skončilo v některé z předchozích chyb.	Nepokoušejte se importovat stále stejné soubory s hodnotami nebo kontaktujte helpdesk CreditCheck.	CZ

Ukončení importu seznamu hodnot

Pokud import dat proběhne úspěšně, je vygenerovaný email se zprávou o úspěšnosti importu dat a ten je odeslaný odesílateli emailu importu. Soubor může obsahovat 2 přílohy, které obsahují seznam hodnot, které nebyly importovány. Zde je popis souborů.

Číslo	Název souboru	Příklad názvu souboru imporu	Poznámka	Země
1.	XXX_invalid.csv	Seznam nezvalidovaných hodnot. Nelze vyloučit, že některá z nevalidních hodnot může být správná.	XXX obsahuje název zpracovávaného souboru odběratele.	CZ
2.	XXX_duplicates.csv	Seznam duplicit v importovaných hodnotách. První výskyt duplicity je importován.	XXX obsahuje název zpracovávaného souboru odběratele.	CZ

Browser not supported