Zadávání IČ/RČ emailem
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í .
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 |