Přeskočit obsah

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

  1. V Daktele přejděte do Spravovat → Integrace a u MoneyS4/S5 klikněte na Konfigurovat.
  2. 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:// (nebo http://).
    ID klienta Client ID z kroku 1.
    Client secret Client secret z kroku 1.
  3. Klikněte na Autorizovat. Daktela ověří, že Money pro tyto údaje vydá přístupový token.

Krok 3: Spárujte pole

  1. 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).

    Párování polí Money S4/S5 s částmi Párování kontaktů a Párování objednávek

  2. 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.
  • ID z Money se vždy automaticky páruje s unikátním názvem a Nazev s 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í.

Upozornění na chybu synchronizace integrace

Č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.