Integracje / Xero

Programy księgowe i ERP

Integracja AI: Xero

Podłączamy faktury sprzedaży (Invoices), rachunki do zapłaty (Bills), transakcje bankowe i raporty ProfitAndLoss oraz AgedReceivables z Xero przez oficjalne REST API OAuth 2.0. Asystent zestawia te dane z polską ewidencją, przelicza kwoty kursem NBP z tabeli A i przygotowuje zestawienie konsolidacyjne po polsku dla zarządu.

Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.

Narzędzie „Faktury sprzedaży · Xero” w portalu redAi, ekran z danymi z programu Xero
Narzędzie „Faktury sprzedaży · Xero” w Waszym portalu. Dane przykładowe.

W skrócie

Jak asystent AI łączy się z systemem Xero?

Łączymy się z Xero przez oficjalne REST API OAuth 2.0. Rejestrujecie aplikację w Xero Developer Portal (Client ID i Client Secret), a użytkownik z rolą Advisor lub Standard autoryzuje dostęp jednym kliknięciem.

Na start potrzebujemy
Konto Xero z rolą Advisor lub Standard do jednorazowej autoryzacji OAuth
Czego asystent nie robi
Asystent nie wystawia ani nie zmienia żadnych dokumentów w Xero: działa wyłącznie w trybie odczytu.
Gdzie są dane
Na Waszym serwerze. Zaczynamy od odczytu, zapis włączacie sami.

Dane z Xero w czacie i we własnym module

Pracujecie na dwa sposoby. W czacie pytacie o cokolwiek z programu i dostajecie odpowiedź na Waszych danych. Do rzeczy, które wracają co dzień, budujemy w portalu osobne narzędzie: Faktury sprzedaży · Xero. Moduł wyciąga bieżący stan faktur sprzedaży prosto z Xero przez REST API OAuth 2.0 i pokazuje, które są opłacone, które czekają na płatność, a które przekroczyły termin. Widzicie w jednym miejscu, gdzie trzeba podjąć działanie, bez oddzielnego logowania do Xero. Po kliknięciu faktury asystent pokazuje szczegóły i proponuje konkretny krok: wysyłkę przypomnienia albo eskalację do opiekuna klienta.

  • Pobiera faktury ze statusami DRAFT, AUTHORISED i PAID bezpośrednio z Xero Invoices API
  • Oznacza każdą fakturę po terminie i wskazuje, o ile dni przekroczono termin płatności
  • Wykrywa faktury autoryzowane bez dopasowania do transakcji bankowych w Xero
  • Pokazuje liczbę pozycji i numer referencyjny (PO) przypisany do faktury w Xero
  • Pozwala wysłać przypomnienie przez Xero po Waszym zatwierdzeniu w portalu
Rozmowa z asystentem AI w portalu redAi o danych z programu Xero: Wiekowanie należności z Xero

Pytanie w czacie

Asystent czyta raport AgedReceivables z Xero i od razu wskazuje, gdzie skupić uwagę, bez ręcznego przeglądania każdej pozycji.

Jak wyglądają nasze należności w Xero według raportu AgedReceivables? Chcę wiedzieć, które przedziały są największe i czy coś wymaga pilnego działania.
Karta INV-0891 w narzędziu Faktury sprzedaży · Xero w portalu redAi

Karta w narzędziu

Karta faktury z Xero zbiera historię działań w jednym miejscu i podpowiada następny krok, a każdą zmianę w programie zatwierdzacie sami.

Moduł łączy Xero z portalem Waszej firmy: jeden ekran zamiast kilku zakładek, a asystent podpowiada, co zrobić z każdą fakturą.

Ekrany na danych przykładowych. Narzędzie dla Waszej firmy układamy pod Wasz sposób pracy: inne kolumny, inne progi, inne powiadomienia.

Co podłączamy

Zaczynamy od odczytu danych. Zapis i akcje w systemie Xero włączamy dopiero wtedy, gdy sami tego chcecie.

Invoices, faktury sprzedaży

CzytamyInvoiceNumber, Contact (kontrahent), AmountDue, CurrencyCode, DueDate, Status: AUTHORISED, PAID lub OVERDUE

AsystentPrzelicza AmountDue na PLN kursem NBP z daty dokumentu, wyznacza faktury z Status=OVERDUE i układa listę priorytetową do windykacji.

Bills, zobowiązania dostawców

CzytamyNumer dokumentu, Contact (dostawca), AmountDue, DueDate, waluta z CurrencyCode po stronie kosztów

AsystentZestawia zobowiązania z polskim zapisem kosztów, wskazuje te po terminie i przelicza kwoty na PLN do zestawienia dla kontrolera.

BankTransactions

CzytamyKwota, data, BankAccount, opis transakcji, powiązanie z dokumentem źródłowym

AsystentUzgadnia wpływy i wypłaty z fakturami i rachunkami, wskazuje nieuzgodnione pozycje do weryfikacji.

Accounts, plan kont

CzytamyNumer konta, Type (REVENUE, DIRECTCOSTS, CURRENT, EQUITY) i nazwa konta po angielsku

AsystentMapuje każde konto Xero na polski plan kont (zespół 0-9) według słownika budowanego raz na starcie, działa automatycznie przy każdym pobieraniu danych.

ProfitAndLoss, raport wynikowy

CzytamyRevenue, Cost of Goods Sold, Gross Profit, Administrative Expenses, Operating Profit, Net Profit Before Tax

AsystentTłumaczy pozycje na polski, przelicza na PLN i dopisuje komentarz zarządczy z porównaniem miesiąc do miesiąca.

BalanceSheet, bilans

CzytamyAktywa, zobowiązania i kapitał własny na koniec okresu, z podziałem na typy kont Xero

AsystentZestawia z polskim bilansem do konsolidacji, przeliczając pozycje walutowe kursem NBP z dnia bilansowego.

AgedReceivables, wiekowanie należności

CzytamyNależności podzielone na przedziały: 1-30, 31-60, 61-90 i powyżej 90 dni po terminie z kwotami w walucie

AsystentPrzelicza kwoty na PLN, sortuje według ryzyka i wskazuje pary potencjalnie wewnątrzgrupowe do eliminacji w zestawieniu konsolidacyjnym.

O co pytają w praktyce

Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.

  • „Które faktury w Xero są przeterminowane i na jaką łączną kwotę?”
  • „Jaki był wynik operacyjny zagranicznej spółki w zeszłym miesiącu?”
  • „Ile wynoszą należności po przeliczeniu na PLN kursem NBP?”
  • „Czy bookkeeper wprowadził wszystkie faktury sprzedaży za ten tydzień?”

Co się zmienia

Zarząd dostaje codziennie polskie zestawienie z zagranicznej księgowości bez czekania na excel od biura rachunkowego.

Asystent działa na Waszym serwerze, na Waszych uprawnieniach. Każdy odczyt i każda akcja zostawiają ślad w logu. Program zostaje tam, gdzie jest, razem z historią danych i nawykami zespołu.

O programie

Xero to chmurowy program księgowy dla małych i średnich firm, szczególnie popularny w Wielkiej Brytanii, Australii i zachodnioeuropejskich spółkach zależnych polskich grup. Firma pracuje w nim po angielsku, w walucie lokalnej. Faktury, zobowiązania, transakcje bankowe i raporty wynikowe leżą wyłącznie w chmurze Xero, bez lokalnych plików ani bazy do pobrania.

Na co dzień pracownicy wystawiają faktury sprzedaży, wprowadzają rachunki do zapłaty po stronie kosztów i uzgadniają wyciągi bankowe z transakcjami. Xero prowadzi plan kont z typami (przychody, koszty bezpośrednie, aktywa, kapitał własny) i generuje raporty wynikowe oraz bilans. Obsługuje wielowalutowość: przy każdej transakcji zapisuje CurrencyCode i kurs platformy.

Gdzie to działa najlepiej

Kontroler finansowy

Co miesiąc ręcznie tłumaczy raport ProfitAndLoss z Xero z angielskiego na polski, przelicza EUR na PLN i składa zestawienie konsolidacyjne dla zarządu. Praca trwa kilka dni po zamknięciu okresu.

Z asystentem: Asystent codziennie rano dostarcza przetłumaczony raport z komentarzem miesiąc do miesiąca i kwotami w PLN według kursu NBP. Kontroler zatwierdza zamiast przepisywać.

Dyrektor finansowy grupy

Zarząd nie wie, ile należności zagranicznej spółki jest przeterminowanych i na jak długo. Raport z biura rachunkowego przychodzi co miesiąc, więc bieżący stan jest nieznany.

Z asystentem: Asystent codziennie sprawdza Invoices z Status=OVERDUE w Xero, przelicza kwoty na PLN i wysyła podsumowanie z podziałem na przedziały czasowe.

Główna księgowa

Przygotowując konsolidację roczną, musi ręcznie przejrzeć transakcje między polską spółką a zagraniczną córką, żeby wskazać pary do eliminacji. Pliki z Xero i polskiego systemu leżą w dwóch różnych excelach.

Z asystentem: Asystent sięga do pola Contact w Xero i zestawia z danymi polskiego systemu, wskazując potencjalne pary transakcji wewnątrzgrupowych. Decyzja o eliminacji zostaje po stronie księgowej.

Jak się łączymy

Łączymy się z Xero przez oficjalne REST API OAuth 2.0. Rejestrujecie aplikację w Xero Developer Portal (Client ID i Client Secret), a użytkownik z rolą Advisor lub Standard autoryzuje dostęp jednym kliknięciem. Dostajemy Tenant ID i access token odnawiany automatycznie co 30 minut, z refresh tokenem ważnym 60 dni przy regularnym użytkowaniu. Zakres uprawnień: wyłącznie odczyt, bez write i bez dostępu do modułu płac.

Portal z bazami i historią rozmów stoi na serwerze klienta. Dane z Xero trafiają przez API do narzędzia i są tam przetwarzane. Gdy biuro rachunkowe zagranicznej spółki nie chce od razu dawać dostępu OAuth, możemy pracować na zaplanowanych eksportach CSV z raportów ProfitAndLoss i AgedReceivables, wysyłanych codziennie na wspólny adres e-mail lub folder. Jedyne ograniczenie tej drogi: opóźnienie wynikające z częstotliwości eksportów.

Czego potrzebujemy od Was

  • Konto Xero z rolą Advisor lub Standard do jednorazowej autoryzacji OAuth
  • Zarejestrowana aplikacja w Xero Developer Portal: Client ID i Client Secret
  • Numer organizacji Xero (Tenant ID), który dostajemy automatycznie po autoryzacji
  • Jednorazowe zmapowanie zagranicznego planu kont na polskie konta (np. Sales = konto 701)
  • Kontakt po stronie spółki lub jej biura rachunkowego do przeprowadzenia autoryzacji

Czego asystent nie robi

  • Asystent nie wystawia ani nie zmienia żadnych dokumentów w Xero: działa wyłącznie w trybie odczytu.
  • Nie wysyła ponagleń do kontrahentów bez potwierdzenia: pokazuje gotowy projekt do zatwierdzenia.
  • Nie podejmuje decyzji o eliminacji transakcji wewnątrzgrupowych: flaguje pary i prezentuje je do weryfikacji przez księgowego lub biegłego rewidenta.
  • Nie zastępuje zamknięcia okresu: nie podpisuje dokumentów, nie zatwierdza bilansu i nie składa sprawozdań finansowych.

Częste pytania

Jak często asystent pobiera dane z Xero?

Częstotliwość ustawiacie sami: może to być codziennie rano, co godzinę albo na żądanie przed spotkaniem zarządu. Harmonogram leży w ustawieniach narzędzia i możecie go zmienić bez angażowania naszego zespołu.

Czy słownik mapowania planu kont trzeba aktualizować po każdej zmianie w Xero?

Słownik budujemy raz na starcie i działa automatycznie przy każdym pobieraniu. Gdy zagraniczna spółka doda nowe konto albo zmieni jego typ, asystent zgłosi niezmapowaną pozycję przy najbliższym raporcie. Uzupełniacie słownik jednym wpisem.

Czy możemy ograniczyć, które dane Xero widzi asystent?

Zakres dostępu wynika ze scopów OAuth: transactions.read, reports.read i contacts.read. Jeśli chcecie wykluczyć kontakty albo ograniczyć się do raportów, ustawiamy węższy zestaw scopów przed autoryzacją. Każda zmiana zakresu wymaga jednorazowej ponownej autoryzacji przez użytkownika Xero.

Co się dzieje z dostępem, gdy pracownik, który autoryzował połączenie, odejdzie z firmy?

Refresh token jest powiązany z kontem użytkownika Xero, który kliknął autoryzację. Gdy to konto zostanie usunięte lub zdegradowane, token przestaje działać. Wystarczy jednorazowa autoryzacja przez nowego użytkownika z rolą Advisor lub Standard, bez zmian po stronie integracji.

Pełny opis integracji w bazie wiedzy →

Jak zaczynamy

  1. Bezpłatna prezentacja. Mówicie, na czym pracujecie i co Was korkuje. Mówimy wprost, czy da się to spiąć, a jeśli nie ma czego automatyzować, też to powiemy.
  2. Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
  3. Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
Wybierzcie termin → Wolicie napisać?
Wolicie napisać

Pokażemy to na Waszych danych z Xero

Jedno zdanie wystarczy: czego szukacie w Xero albo co ma się dziać samo. Odpiszemy, co podłączymy i od czego zacząć.

Xero jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.