eWay

eWay-CRM

Integrace s eWay-CRM umožňuje export přijatých faktur z Alice do CRM systému eWay prostřednictvím SOAP API. Faktura se v eWay zakládá jako Cart (košík) typu „Purchase invoice" a je propojena s projektem.

Jak to funguje?

Po označení dokumentu k exportu (stav K exportu) Alice se přihlásí do eWay přes SOAP API (uživatelské jméno + MD5 hash hesla), získá session ID a založí v eWay novou nákupní fakturu. Volitelně se faktura naváže na projekt podle vlastního pole. Po úspěšném zápisu se v Alici doklad přesune do stavu Exportovaný, při chybě do stavu Chyba -- viz Diagnostika. Přehled všech stavů viz Stavy dokumentů.

Schéma datového toku

graph LR
    A[Alice] -->|doklad| B[eWay-CRM]
    B -.->|potvrzení| A

Podporované verze a předpoklady

Oblast	Požadavek
Aplikace	eWay-CRM s aktivním SOAP API
Autentizace	Uživatel + heslo (heslo přenášeno jako MD5 hash)
Síť	API server eWay musí být dosažitelný z cloudu Alice
Můstek	Není potřeba -- integrace probíhá přímo přes API

Podporované typy dokumentů

Typ dokumentu	Podpora	Cíl v eWay
Česká přijatá faktura	Podporováno	Cart typu „Purchase invoice"
Vydaná faktura	Nepodporováno	--
Účtenka	Nepodporováno	--
Slovenská faktura	Nepodporováno	--

Vytvoření integrace

V nastavení na kartě Integrace přidejte eWay.

Podrobný postup, jak vytvořit integraci pro účetní systémy, naleznete v části Integrace.

Konfigurace

Pole	Popis
Název	Uživatelský název spojení
URL API	Adresa SOAP API eWay (např. https://yourdomain.eway-crm.com/InternalAPI)
Uživatelské jméno	Jméno uživatele eWay
Uživatelské heslo	Heslo uživatele eWay (do API přenášeno jako MD5 hash)
Účetní jednotka	Účetní jednotka, ze které budou dokumenty importovány

Synchronizace číselníků

Číselník	eWay zdroj	Použití
Projekt	GetProjects	Volitelně na hlavičce dokumentu i na položkách
Skladová karta (Stock)	GetGoods	Kód položky (FileAs)

Mapování polí dokumentu

Identifikace dokumentu a datumy

Pole v Alice	Pole v eWay	Poznámka
Číslo faktury	FileAs
Datum uplatnění odpočtu DPH	AccountingCaseDate, TaxableSupplyDate	Fallback na datum vystavení / datum zdanitelného plnění
Datum splatnosti	PaymentDate, ValidUntil
Datum zdanitelného plnění	EffectiveFrom
Poznámka	Note

Finanční údaje

Pole v Alice	Pole v eWay
Celková částka	PriceTotal
Základ DPH	PriceTotalExcludingVat
DPH	Vat
Částka k úhradě	ForPayment

Vlastní pole

Pole v Alice	Pole v eWay	Poznámka
Zakázka (Contract)	Projects_CartGuid	Naváže fakturu na projekt v eWay (GUID)

Položky

Pole v Alice	Pole v eWay	Poznámka
Název položky	FileAs
Kód položky / Skladová karta	Code	Z vlastního pole Stock (synchronizovaný číselník), nebo z kódu položky; pokud chybí, použije se N/A
Zakázka (na položce)	Projects_ProjectGuid
Množství	Quantity
Cena bez DPH	ListPrice
Sazba DPH	VatRate	Hodnota v desetinné formě (např. 0,21 = 21 %)

Kód položky je povinný v eWay

Pokud položka nemá ani vlastní pole Stock, ani kód, exportuje se jako N/A. eWay vyžaduje vyplněný kód u každé položky.

Práce s firmami

Při exportu se dodavatel vyhledá v adresáři eWay podle IČO:

1. Vyhledání pomocí SearchCompanies podle IdentificationNumber
2. Pokud je nalezen, použije se jeho GUID jako Companies_CustomerGuid
3. Pokud není, vytvoří se nový záznam přes SaveCompany (přenese se název, IČO, DIČ, adresa)

IČO dodavatele povinné

Bez vyplněného IČO export selže s chybou „Supplier ID (ICO) is empty".

Schvalovací proces

eWay umí integraci kombinovat se schvalovacím procesem -- doklad se v Alici označí ke schválení podle vybraných projektů na položkách:

• Pro každý unikátní projekt se vytvoří v eWay jeden dokument
• Stav dokumentu zůstane Ke schválení
• Vlastníci přiřazených projektů obdrží v eWay notifikaci
• Až všichni schvalovatelé doklad schválí, Alice se to dozví a doklad může být finálně exportován

Diagnostika

Při chybě se dokument v Alici přesune do stavu Chyba s detailem v náhledu.

Failed to login using supplied credentials

Příčina: Neplatné jméno nebo heslo eWay uživatele.

Řešení: Ověřte přihlašovací údaje a v Alici je aktualizujte. Heslo se do API přenáší jako MD5 hash, ale původní hodnotu zadávejte normálně.

Supplier ID (ICO) is empty

Příčina: Dokument nemá vyplněné IČO dodavatele.

Řešení: Doplňte IČO dodavatele a export opakujte.

Cannot find {value} in CartType enum

Příčina: V eWay neexistuje typ Cart „Purchase invoice".

Řešení: V eWay administraci vytvořte/aktivujte typ Cart „Purchase invoice".

Failed to save the cart / company

Příčina: eWay odmítlo vytvořit fakturu nebo dodavatele.

Řešení: Zkontrolujte oprávnění uživatele v eWay administraci, případně detail chyby v náhledu dokumentu.

Časté dotazy | FAQ

Jaké typy dokumentů lze exportovat?

Pouze české přijaté faktury -- ukládají se jako Cart typu „Purchase invoice".

Vytvoří se v eWay dodavatel automaticky?

Ano. Pokud podle IČO dodavatel není v adresáři, Alice ho založí.

Můžu fakturu navázat na konkrétní projekt?

Ano -- na hlavičce dokumentu nastavte vlastní pole Zakázka (Contract), které je propojené se synchronizovaným číselníkem projektů z eWay.