Money S4/S5¶
Přeneste zákazníky a přijaté objednávky z ERP systému Money S4/S5 do CRM v Daktele – operátoři tak vědí, kdo volá a co si objednal, a nemusí otevírat Money.
Co integrace umí a kdy ji použít¶
Integrace Money S4/S5 pravidelně importuje data z vaší instalace Money do CRM databáze v Daktele:
- Firmy se stanou CRM společnostmi v Daktele.
- Osoby se stanou CRM kontakty v Daktele a každá se propojí se svou firmou.
- Přijaté objednávky se stanou CRM záznamy v Daktele, a to typu, který si zvolíte (Order pairing).
Data proudí jedním směrem, z Money do Daktely. Money zůstává vaším hlavním zdrojem; Daktela udržuje aktuální kopii, se kterou pracují operátoři.
Typické případy použití
- Rozpoznání zákazníka. Příchozí hovor, e-mail nebo chat se spáruje se synchronizovaným kontaktem, takže operátor hned vidí jméno zákazníka a jeho firmu.
- Dotazy na objednávky. Když se zákazník ptá na objednávku, operátor ji najde mezi CRM záznamy zákazníka v Daktele a nemusí se ptát back office.
- Kontext pro operátory. Operátoři vidí v CRM Daktely údaje o firmě a objednávce, které si zvolíte – IČO, adresu, číslo objednávky.
- Jeden zdroj pravdy. Váš tým dál pracuje v Money; změny se do kontaktního centra dostanou automaticky do půl hodiny.
Tip
Daktela nabízí podobné integrace i pro další účetní a ERP systémy, například Pohoda a Helios Green. Úplný seznam najdete v článku Integrace pro synchronizaci CRM.
Předpoklady a nastavení¶
Předpoklady¶
- V Money: Money S5 API nastavené pro vaši instalaci a dostupné z internetu přes HTTPS, a API klient (Client ID a Client secret), jehož role smí číst firmy, osoby a přijaté objednávky. První nastavení API dělá váš implementátor Money – pokud je Daktela vaše první integrace přes API, požádejte ho o nastavení.
- V Daktele: administrátorský účet s přístupem do Spravovat → Integrace a CRM databáze, do které se data importují.
- Volitelně: typ CRM záznamu v Daktele, pokud chcete importovat přijaté objednávky.
Krok 1: Získejte údaje k Money API¶
Vyžádejte si od implementátora nebo správce Money:
- základní URL vašeho Money S5 API – zadáte ji jako URI instance;
- Client ID a Client secret pro Daktelu (v Money S5 se generují v nastavení API, v části API klíče).
Ověřte, že je API dostupné z internetu, ne jen z vaší vnitřní sítě – Daktela se k němu připojuje z cloudu.
Krok 2: Připojte Money v Daktele¶
- V Daktele přejděte do Spravovat → Integrace a u MoneyS4/S5 klikněte na Konfigurovat.
-
Vyplňte formulář pro připojení:
Pole Co zadat CRM databáze CRM databáze v Daktele, do které se data z Money importují. Typ záznamu CRM Nepovinné. Typ záznamu pro přijaté objednávky importované přes Order pairing. URI instance Základní URL vašeho Money S5 API, začínající https://(nebohttp://).ID klienta Client ID z kroku 1. Client secret Client secret z kroku 1. -
Klikněte na Autorizovat. Daktela ověří, že Money pro tyto údaje vydá přístupový token.
Krok 3: Spárujte pole¶
-
Otevře se seznam polí vašeho CRM v Daktele. V části Contact pairing vyberte ke každému poli kontaktu v Daktele pole Money, které ho bude plnit (z osob), a ke každému poli společnosti pole z firem. V části Order pairing udělejte totéž pro pole CRM záznamů (z přijatých objednávek).

-
Klikněte na Aktivovat.
První synchronizace proběhne do 30 minut.
Technické detaily¶
| Oblast | Chování |
|---|---|
| Směr | Jednosměrně, Money → Daktela. Do Money se nic nezapisuje. |
| Připojení | Daktela předá přihlašovací údaje integrační službě Daktela, která za ni volá Money S5 API. API musí být dostupné z internetu; služba čeká na spojení až 10 sekund a na každou odpověď až 60 sekund. |
| Ověření | OAuth 2.0 client credentials: služba si vyžádá přístupový token z <URI instance>/connect/token (scope S5Api), uloží si ho a nový si vyžádá, když ho Money odmítne jako prošlý. |
| API | GraphQL endpoint <URI instance>/graphql. Dostupné dotazy a pole se načítají z <URI instance>/graphql/schema. Vaše verze Money musí nabízet stránkované dotazy na osoby (Person), firmy (Company) a přijaté objednávky (ReceivedOrder); pokud je nenabízí, načtení párování polí nebo synchronizace selže s chybou, která to uvádí. |
| Plán | Každých 30 minut. |
| Přírůstková synchronizace | Každý běh si vyžádá jen záznamy, jejichž datum změny (Modify_Date) je pozdější než čas předchozího běhu; u osob se kontroluje i datum vytvoření (Create_Date). Čas se posílá v UTC (od verze 33.8.0). První běh naimportuje všechny záznamy. |
| Velikost dávky | Záznamy se stahují po stránkách o 100 záznamech, seřazené podle ID v Money. |
| Pořadí entit | Nejdřív firmy (společnosti), potom osoby (kontakty), nakonec přijaté objednávky – aby se kontakt mohl vždy propojit se svou firmou. |
| Nepodporováno | Další doklady z Money (faktury, vydané objednávky, …). Záznamy smazané v Money se v Daktele nemažou. |
| Více konfigurací | Můžete připojit více instalací Money nebo importovat do více CRM databází. Každá konfigurace má vlastní dlaždici s názvem podle URI instance. |
Jak se záznamy párují¶
- Každý importovaný kontakt, společnost a záznam dostane v Daktele unikátní název
<ID konfigurace>_<ID v Money>. Daktela si toto spárování pamatuje, takže pozdější změny v Money aktualizují stejný záznam v Daktele a nevzniká duplicita. IDz Money se vždy automaticky páruje s unikátním názvem aNazevs názvem kontaktů a společností; přijaté objednávky dostanou jako název vždy své číslo dokladu (CisloDokladu). Ostatní pole se řídí vaším spárováním z kroku 3.- Kontakt → firma: osoba se propojí s firmou uvedenou v jejím poli
Parent_ID. - Přijaté objednávky se vždy importují se stavem
OPEN. Aby se objednávka propojila se zákazníkem, spárujte zákazníka objednávky s polem Kontakt záznamu (a jeho firmu s polem Společnost). Pokud objednávka zůstane bez kontaktu a má telefonní číslo, vyhledá Daktela existující kontakt se stejným telefonním číslem nebo e-mailem a objednávku s ním propojí. Pokud objednávka telefonní číslo nemá nebo žádný kontakt neodpovídá, vytvoří Daktela z údajů objednávky nový kontakt. - Seznam polí: seznam pro párování nabízí všechna pole objektu Money včetně polí navázaných objektů až do hloubky tří úrovní, zploštělá s podtržítkem (
<objekt>_<pole>). - Pokud importovaný záznam v Daktele smažete, další běh ho neobnoví, ale nahlásí ho jako chybu.
Testovací běh a kompletní synchronizace¶
- Testovací běh (od verze 30.0.0): když je integrace aktivní, otevřete její konfiguraci a klikněte na Testovací pokus. Daktela hned naimportuje prvních pět záznamů každé spárované entity, takže spárování ověříte bez čekání na plánovaný běh.
- Kompletní synchronizace: když upravujete aktivní konfiguraci, můžete zapnout volbu Kompletní synchronizace – další běh pak znovu naimportuje všechny záznamy, nejen změny. Hodí se po změně párování polí.
Chyby synchronizace¶
Pokud běh selže – Money není dostupné, odmítne přihlašovací údaje nebo se některé záznamy nepodaří uložit – zobrazí dlaždice Money v Spravovat → Integrace upozornění. Otevřete ho a stáhněte si soubor s chybami (CSV), ve kterém je u každého neúspěšného záznamu jeho název, unikátní název, typ entity a důvod. Když selže spojení, dostanou administrátoři také upozornění e-mailem – jednou, dokud se další běh znovu nepřipojí.

Časté zprávy integrační služby:
| Zpráva | Co ověřit |
|---|---|
| Money ERP connection failed / timed out | API není na URI instance dostupné z internetu nebo odpovídá příliš pomalu. |
| Money ERP authentication failed | Client ID nebo Client secret je špatně, nebo byl API klient odstraněn. |
| Money ERP returned an API error; check the query, mapped fields and API user permissions | Role API klienta nesmí číst některý ze spárovaných objektů nebo polí. |
| Money ERP mapped field is absent from the GraphQL schema | Spárované pole už ve vaší verzi Money neexistuje – spárujte jiné pole. |
| Money ERP GraphQL schema does not expose a paginated … query | Vaše verze Money nenabízí dotaz, který Daktela potřebuje – zeptejte se implementátora Money na aktualizaci. |