Xero: importuj encję

Opis

Importuje jedną encję Xero Accounting API, ograniczoną do organizacji powiązanej z połączeniem, za pośrednictwem połączenia Xero do tabeli projektu. Wybierz połączenie, typ jednostki i ewentualne filtry; krok pobiera pasujące rekordy i zapisuje je, bez konieczności tworzenia zapytania.

Jeden typ kroku obsługuje jedenaście encji, od danych referencyjnych (plan kont, kontakty, pozycje, stawki podatkowe, waluty) po rekordy transakcyjne (faktury, noty kredytowe, płatności, ręczne zapisy dziennika, transakcje bankowe).

Konfiguracja

Pole	Wymagane	Uwagi
Połączenie Xero	Tak	Połączenie Xero, przez które odbywa się odczyt.
Tabela docelowa	Tak	Tabela projektu, do której zapisywane są wyniki.
Typ jednostki	Tak	Która encja ma zostać pobrana. Domyślnie Faktury.
Status	Nie	Zawęża do pojedynczej wartości Status w Xero, na przykład AUTHORISED lub PAID.
Data od	Nie	Dolna granica Date encji w formacie YYYY-MM-DD.
Data do	Nie	Górna granica Date encji w formacie YYYY-MM-DD.
Zaktualizowane po	Nie	Wysyłane jako granica czasu modyfikacji, więc zwracane są tylko wiersze zmienione po niej. Puste pole pobiera wszystko.

Notatka

Zaktualizowane po to filtr po stronie żądania bez zapisanego znacznika (watermark) — PlaidCloud nie zapamiętuje, w którym miejscu zakończyło się poprzednie uruchomienie, więc aby uzyskać zachowanie przyrostowe, podawaj granicę samodzielnie przy każdym uruchomieniu.

Typy jednostek

Typ jednostki	Co zawiera
Plan kont	Kod konta, nazwa, typ, klasa, typ podatku, status, kod raportowania.
Kontakty	Klienci i dostawcy, wraz ze statusem, numerem podatkowym i walutą domyślną.
Faktury	Faktury sprzedaży i zakupu, wraz z kontaktem, datami, statusem, sumami i kwotą należną.
Noty kredytowe	Noty kredytowe do sprzedaży lub zakupów, wraz z kontaktem, datą, statusem i sumą.
Płatności	Płatności z datą, kwotą, statusem i kontem bankowym.
Ręczne zapisy dziennika	Opis zapisu dziennika, data i status.
Transakcje bankowe	Transakcje wydatków i wpływów, wraz z datą, statusem, sumą i flagą uzgodnienia.
Pozycje	Pozycje magazynowe i usługowe, wraz z flagą śledzenia i ilością na stanie.
Kategorie śledzenia	Nazwy kategorii śledzenia i status.
Stawki podatkowe	Nazwy stawek podatkowych, typy, status i obowiązująca stawka.
Waluty	Kody walut i opisy.

Notatka

Nie każda encja obsługuje każdy filtr — Pozycje i Waluty nie przyjmują żadnego z nich, a Plan kont i Kontakty przyjmują status, ale nie zakres dat. Pola filtrów pozostają włączone dla każdej encji; Xero odrzuca filtr, którego encja nie obsługuje, więc krok zgłasza błąd zamiast zwracać błędny zestaw wyników.

Uwaga

Organizacja pochodzi z połączenia, a nie z tego kroku. Każde żądanie do Xero wskazuje jedną organizację, a niesie ją połączenie — dlatego krok nie ma pola organizacji. Aby pobrać tę samą encję z drugiej organizacji, utwórz drugie połączenie Xero wskazujące na nią.

Powiązane

• Kroki Xero
• Połącz z Xero — przewodnik krok po kroku
• Konektor REST Xero