Všechny sbírky
Integrace
🔄Marketplace wflow
wflow to Xero
wflow to Xero
Ondřej Krejčí avatar
Autor: Ondřej Krejčí
Aktualizováno před více než týdnem

Zpracovávají se jenom Přijaté faktury (+Dobropisy), Vydané faktury (+Dobropisy) a Objednávky

Autorizace a autentifikace

Každý klient si musí vytvořit vlastního API klienta pro komunikaci s Xero API na developer.xero.com

Potřeba udělat:

Connection:

  • Zadat TenantName (název organizace ve Xero)

  • Přihlášení do Xero

  • Nastavení mappingu Categories (Xero) na číselníky ve wflow

    • První pole zobrazí uživateli všechny dostupné Categories v Xero organizaci, druhé pole zobrazí všechny Číselníky ve wflow

    • Uživatel si může vybrat žádné, nebo více dvojic k propojení

    • Tzn. Když mám v Xero kategorii „Project“ tak si to uživatel může spojit s číselníkem ve wflow „Zakázky“

  • Aktualizace plateb ze Xero do wflow (defaultně nastaveno na true)

    Flows:

    • CRON (cca v 01:00) – Aktualizace Kontaktů ze Xero do wflow (Contacts -> Partneři)

    • CRON (cca v 01:00) – Aktualizace Číselníku ze Xero do wflow (Categories -> Číselníky)

    • CRON (cca v 01:00) - Zpracování dokumentu z wflow do Xero

    • CRON (každé 4 hodiny) - Update plateb ze Xero do wflow (platí jenom pro Bills + CreditNotes)

Flow – Zpracování dokumentu z wflow do Xero:

  1. Uživatel ve wflow odešle dokument do ERP

  2. Vezmou se data dokumentu a hlavní soubor z wflow

  3. V Xero se zkontroluje, jestli se ID Partnera nachází v číselníku, když ne, tak se vytvoří

  4. V Xero se vytvoří přijatá faktura s daty z wflow (popis přenosu dat níže) a připojí se hlavní soubor

  5. Po úspěšném vytvoření přijaté faktury v Xero se dokument ve wflow nastaví jako „Exportováno do ERP“ a uzamkne se. V případě výskytu chyby, se dokument ve wflow nastaví jako „Chyba při odeslání do ERP“ a do událostí se zapíše dostupný popis chyby.

Flow – Aktualizace číselníků „Accounting“ polí

  • Na základě nastavení mappingu v instanci se přenesou všechny Categories Items ze Xero, kt. jsou aktivní

  • Spojovací údaj Categories – Categorie ID => Register ve wflow

  • Spojovací údaj Categorie Item – Categorie Item ID => Register item External ID

  • Když se ve wflow nachází číselníky, kterých ID nesouhlasí, tak se ve wflow zneaktivní

Statické číselníky:

  • Chart of Accounts (Xero) -> Účetní osnova, na detailu faktury Protiúčet M/D (wflow)

  • Tax rates (Xero) -> Řádky přiznání k DPH (wflow)

Flow – Aktualizace Partnerů

  • Do wflow se přenesou všechny „Contacts“ ze Xero do wflow číselníku „Partneři“

  • Přenášet se bude:

    • Název

    • Adresa

    • Email

    • Číslo účtu

    • DIČ

    • Currency

    • Spojovací údaj Contact ID => External ID / ID

Flow: Aktualizace plateb

  • Platí jenom pro Přijaté faktury + Dobropisy

  • Cron nastaven na každou 4. hodinu

  • Aktualizují se jenom dokumenty které byly upravené posledních 48 hodin

  • Přenášejí se i částečné platby

Data dokumentu

Přenášet se bude (vlevo pole wflow, vpravo pole Xero):

Hlavička:

  • Číslo – Invoice Number (Reference)

  • Popis - Notes

  • Partner – From (mapping na základě ID)

  • Datum přijetí – Date

  • Datum splatnosti – Due Date

  • Měna

  • Celkem s DPH

Položky:

  • Popis – Description

  • Množství – Quantity

  • Cena za jednotku – Unit price

  • Typ DPH – Tax rate

  • Číselníky – Categories

  • Celková částka - Amounts

Jiné:

  • Hlavní soubor – Related files

  • Odkaz na doklad – Notes

Na co si dávat pozor:

  • Sazby se berou výlučně z číselníku „Řádky přiznání k DPH“

  • U dobropisů – když chybí popis, tak se do položek vygeneruje string tečka (.)

  • Doporučuju vyplňovat Partnera na faktuře z číselníku

Dodatek:

  • Veškeré chybové hlášky přicházejí ze Xero

Dostali jste odpověď na svou otázku?