SureXeroLite (niezależny wydawca) (wersja zapoznawcza)
Odblokuj możliwości uniwersalnego łącznika zaprojektowanego z myślą o bezproblemowej konfiguracji i bezproblemowej integracji z preferowanymi aplikacjami biznesowymi. Dzięki temu łącznikowi można bez wysiłku generować faktury, zarządzać klientami i produktami oraz bez wysiłku uzyskiwać dostęp do szczegółów faktur, tworząc bezproblemowy i wydajny przepływ pracy.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Pomoc techniczna 848 |
| adres URL | https://service.nowplatform.co/csm |
| support@848.co |
| Metadane łącznika | |
|---|---|
| Publisher | Grupa 848 |
| Witryna internetowa | https://www.xero.com |
| Zasady ochrony prywatności | https://www.xero.com/uk/legal/privacy |
| Kategorie | Produktywność; Finanse |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Dodawanie nowego kontaktu |
Ta akcja umożliwia dodanie nowego kontaktu w środowisku Xero |
| Dodawanie nowej faktury |
Ta akcja umożliwia dodanie nowej faktury w środowisku Xero |
| Logowanie Xero |
Zaloguj się do swojego konta Xero, aby rozpocząć pracę |
| Wyświetlanie listy faktur |
Ta akcja umożliwia wyświetlenie listy faktur z usługi Xero, które są zgodne z wybranymi opcjami |
| Wyświetlanie listy kontaktów |
Ta akcja umożliwia wyświetlenie listy kontaktów z usługi Xero, które są zgodne z wybranymi opcjami |
Dodawanie nowego kontaktu
Ta akcja umożliwia dodanie nowego kontaktu w środowisku Xero
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator dzierżawy Xero
|
xero-tenant-id | True | string |
Identyfikator dzierżawy Xero |
|
Name
|
Name | True | string |
Imię i nazwisko kontaktu/organizacji |
|
Imię
|
FirstName | string |
Imię i nazwisko kontaktu podstawowego |
|
|
Nazwisko
|
LastName | string |
Nazwisko podstawowego kontaktu |
|
|
Adres e-mail
|
EmailAddress | string |
Podstawowy adres e-mail kontaktu |
|
|
Typ podatkowy należności
|
AccountsReceivableTaxType | string |
Domyślny typ podatku używany do kontaktu na fakturach AR |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Kontakty
|
Contacts | array of object |
Kontakty |
|
Identyfikator kontaktu
|
Contacts.ContactID | string |
Identyfikator Xero |
|
Numer kontaktowy
|
Contacts.ContactNumber | string |
Numer do identyfikowania kontaktów w systemach zewnętrznych |
|
Stan kontaktu
|
Contacts.ContactStatus | string |
Bieżący stan kontaktu |
|
Name
|
Contacts.Name | string |
Imię i nazwisko kontaktu/organizacji |
|
Imię
|
Contacts.FirstName | string |
Imię i nazwisko kontaktu podstawowego |
|
Nazwisko
|
Contacts.LastName | string |
Nazwisko podstawowego kontaktu |
|
Adres e-mail
|
Contacts.EmailAddress | string |
Podstawowy adres e-mail kontaktu |
|
Szczegóły konta bankowego
|
Contacts.BankAccountDetails | string |
Numer konta bankowego kontaktu |
|
Adresy
|
Contacts.Addresses | array of object |
Adresy kontaktu |
|
Typ adresu
|
Contacts.Addresses.AddressType | string |
Typ adresu |
|
Miejscowość
|
Contacts.Addresses.City | string |
Miejscowość |
|
Region
|
Contacts.Addresses.Region | string |
Region |
|
Kod pocztowy
|
Contacts.Addresses.PostalCode | string |
Kod pocztowy |
|
Country
|
Contacts.Addresses.Country | string |
Country |
|
Telefony
|
Contacts.Phones | array of object |
Telefony dla kontaktu |
|
PhoneType
|
Contacts.Phones.PhoneType | string |
Typ telefonu |
|
Numer Telefonu
|
Contacts.Phones.PhoneNumber | string |
Numer telefonu |
|
PhoneAreaCode
|
Contacts.Phones.PhoneAreaCode | string |
Kod obszaru telefonu |
|
PhoneCountryCode
|
Contacts.Phones.PhoneCountryCode | string |
Kod kraju telefonu |
|
|
Contacts.UpdatedDateUTC | string |
Data aktualizacji UTC |
|
Osoby kontaktowe
|
Contacts.ContactPersons | array of object |
Osoby kontaktowe dodatku |
|
Imię
|
Contacts.ContactPersons.FirstName | string |
Imię i nazwisko dodatkowej osoby kontaktowej |
|
Nazwisko
|
Contacts.ContactPersons.LastName | string |
Nazwisko osoby kontaktowej additonal |
|
Adres e-mail
|
Contacts.ContactPersons.EmailAddress | string |
Adres e-mail osoby kontaktowej dodatku |
Dodawanie nowej faktury
Ta akcja umożliwia dodanie nowej faktury w środowisku Xero
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator dzierżawy Xero
|
xero-tenant-id | True | string |
Identyfikator dzierżawy Xero |
|
Date
|
Date | string |
Data wystawienia faktury — RRRR -MM-DD |
|
|
Data upływu
|
DueDate | string |
Data ukończenia faktury — RRRR-MM-DD |
|
|
Typ faktury
|
Type | True | string |
Typ faktury (ACCREC — faktura sprzedaży lub faktura klienta, rachunek ACCPAY lub faktura dostawcy) |
|
Dodatkowy numer referencyjny
|
Reference | string |
Tylko ACCREC — dodatkowy numer referencyjny |
|
|
Identyfikator kontaktu
|
ContactID | True | string |
Identyfikator Xero (unikatowy w organizacjach) |
|
Typy kwot wierszy
|
LineAmountTypes | string |
Kwoty wierszy są domyślnie wyłączne od podatku, jeśli nie określisz tego elementu. (Wyłączność, Inclusive, NoTax). |
|
|
Numer faktury
|
InvoiceNumber | string |
Unikatowy kod alfanumeryczny identyfikujący fakturę |
|
|
Opis elementu wiersza
|
Description | True | string |
Opis elementu wiersza |
|
Ilość elementu wiersza
|
Quantity | True | number |
Ilość elementu wiersza |
|
Kwota jednostki elementu wiersza
|
UnitAmount | True | number |
Kwota jednostki elementu wiersza |
|
Kod konta elementu wiersza
|
AccountCode | string |
Kod konta alfanumerycznego zdefiniowany przez klienta, np. 200 lub SALES |
|
|
Stawka rabatowa
|
DiscountRate | number |
Rabat procentowy lub kwota rabatu jest stosowana do elementu wiersza. |
|
|
Kod waluty
|
CurrencyCode | string |
Waluta, w jakiej została podniesiona faktura |
|
|
Kurs waluty
|
CurrencyRate | number |
Kurs walutowy dla faktury wielobieżnej |
|
|
Stan faktury
|
Status | string |
Stan faktury (WERSJA ROBOCZA, PRZESŁANE, AUTORYZOWANE) |
|
|
Oczekiwana data płatności
|
ExpectedPaymentDate | string |
Wyświetlane na fakturach sprzedaży (należności) po ustawieniu |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Invoices
|
Invoices | array of object |
Invoices |
|
Identyfikator kontaktu
|
Invoices.Contact.ContactID | string |
Identyfikator kontaktu Xero |
|
Name
|
Invoices.Contact.Name | string |
Imię i nazwisko kontaktu/organizacji |
|
Date
|
Invoices.Date | string |
Data wystawienia faktury — RRRR -MM-DD |
|
Data upływu
|
Invoices.DueDate | string |
Data ukończenia faktury — RRRR-MM-DD |
|
Stan faktury
|
Invoices.Status | string |
Stan faktury (WERSJA ROBOCZA, PRZESŁANE, AUTORYZOWANE) |
|
Typy kwot wierszy
|
Invoices.LineAmountTypes | string |
Typy kwot wierszy (wykluczające, włącznie, NoTax) |
|
LineItems
|
Invoices.LineItems | array of object |
LineItems |
|
Description
|
Invoices.LineItems.Description | string |
Opis elementu wiersza |
|
Kwota jednostki
|
Invoices.LineItems.UnitAmount | number |
Kwota jednostki lineitem |
|
Typ podatku
|
Invoices.LineItems.TaxType | string |
Używany jako przesłoń, jeśli domyślny kod podatkowy dla wybranego kodu konta jest niepoprawny |
|
Kwota podatku
|
Invoices.LineItems.TaxAmount | number |
Kwota podatku jest obliczana automatycznie jako wartość procentowa kwoty wiersza (patrz poniżej) na podstawie stawki podatkowej. |
|
Kwota linii
|
Invoices.LineItems.LineAmount | number |
Kwota wiersza odzwierciedla obniżoną cenę, jeśli użyto rabatu |
|
Kod konta
|
Invoices.LineItems.AccountCode | string |
Kod konta alfanumerycznego zdefiniowany przez klienta, np. 200 lub SALES |
|
Identyfikator konta
|
Invoices.LineItems.AccountId | string |
Identyfikator konta Xero (unikatowy w organizacjach) |
|
Ilość
|
Invoices.LineItems.Quantity | number |
LineItem Quantity |
|
Identyfikator elementu lineItem
|
Invoices.LineItems.LineItemID | string |
Identyfikator wygenerowany przez Xero dla elementu LineItem |
|
Suma podrzędna
|
Invoices.SubTotal | number |
Łączna liczba faktur z wyłączeniem podatków |
|
Łączny podatek
|
Invoices.TotalTax | number |
Całkowity podatek na fakturze |
|
Total
|
Invoices.Total | number |
Łączna kwota podatku od faktury (tj. suma częściowa i łączna kwota) |
|
Data aktualizacji UTC
|
Invoices.UpdatedDateUTC | string |
Format UTC daty ostatniej modyfikacji |
|
Kod waluty
|
Invoices.CurrencyCode | string |
Waluta, w jakiej została podniesiona faktura |
|
|
Invoices.Type | string |
Typ faktury |
|
Identyfikator faktury
|
Invoices.InvoiceID | string |
Identyfikator wygenerowany przez Xero dla faktury (unikatowy w organizacjach) |
|
Numer faktury
|
Invoices.InvoiceNumber | string |
Unikatowy kod alfanumeryczny identyfikujący fakturę |
|
Kwota należna
|
Invoices.AmountDue | number |
Kwota pozostała do zapłaty na fakturze |
|
Kwota zapłacona
|
Invoices.AmountPaid | number |
Suma płatności otrzymanych na fakturze |
|
Kwota środków
|
Invoices.AmountCredited | number |
Suma wszystkich notatek kredytowych, nadmiernych płatności i przedpłat stosowanych do faktury |
|
Kurs waluty
|
Invoices.CurrencyRate | number |
Kurs walutowy dla faktury wielobieżnej |
Logowanie Xero
Zaloguj się do swojego konta Xero, aby rozpocząć pracę
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
|
array of object | ||
|
id
|
id | string |
Id |
|
authEventId
|
authEventId | string |
Identyfikator zdarzenia uwierzytelniania |
|
tenantId
|
tenantId | string |
Identyfikator dzierżawy Xero |
|
tenantType
|
tenantType | string |
Typ dzierżawy |
|
nazwa_dzierżawy
|
tenantName | string |
Nazwa dzierżawy |
|
createdDateUtc
|
createdDateUtc | string |
Data utworzenia utc |
|
updatedDateUtc
|
updatedDateUtc | string |
Data aktualizacji UTC |
Wyświetlanie listy faktur
Ta akcja umożliwia wyświetlenie listy faktur z usługi Xero, które są zgodne z wybranymi opcjami
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator dzierżawy Xero
|
xero-tenant-id | True | string |
Identyfikator dzierżawy Xero |
|
Gdzie filtr
|
where | string |
Filtruj, na przykład Type=="ACCPAY" AND Status=="AUTHORISED" |
|
|
Filtruj według stanów
|
Statuses | string |
Filtruj na rozdzielanej przecinkami liście stanów. na przykład: AUTORYZOWANY, PROJEKT |
|
|
Filtrowanie identyfikatorów
|
IDs | string |
Filtrowanie według rozdzielanej przecinkami listy identyfikatorów |
|
|
Filtrowanie numerów faktur
|
InvoiceNumbers | string |
Filtruj według rozdzielonej przecinkami listy numerów faktur. |
|
|
Filtrowanie identyfikatorów kontaktów
|
ContactIDs | string |
Filtruj według rozdzielonej przecinkami listy identyfikatorów kontaktów. |
|
|
Mniejsza uproszczona odpowiedź
|
summaryOnly | boolean |
Pobierz mniejszą wersję obiektu odpowiedzi. |
|
|
Paginacja
|
page | integer |
Pobieranie kolekcji faktur przy użyciu stronicowania |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Invoices
|
Invoices | array of object |
Invoices |
|
Identyfikator kontaktu
|
Invoices.Contact.ContactID | string |
Identyfikator kontaktu Xero |
|
Name
|
Invoices.Contact.Name | string |
Imię i nazwisko kontaktu/organizacji |
|
Date
|
Invoices.Date | string |
Data wystawienia faktury — RRRR -MM-DD |
|
Data upływu
|
Invoices.DueDate | string |
Data ukończenia faktury — RRRR-MM-DD |
|
Stan faktury
|
Invoices.Status | string |
Stan faktury (WERSJA ROBOCZA, PRZESŁANE, AUTORYZOWANE) |
|
Typy kwot wierszy
|
Invoices.LineAmountTypes | string |
Typy kwot wierszy (wykluczające, włącznie, NoTax) |
|
LineItems
|
Invoices.LineItems | array of object |
LineItems |
|
Description
|
Invoices.LineItems.Description | string |
Opis elementu wiersza |
|
Kwota jednostki
|
Invoices.LineItems.UnitAmount | number |
Kwota jednostki lineitem |
|
Typ podatku
|
Invoices.LineItems.TaxType | string |
Używany jako przesłoń, jeśli domyślny kod podatkowy dla wybranego kodu konta jest niepoprawny |
|
Kwota podatku
|
Invoices.LineItems.TaxAmount | number |
Kwota podatku jest obliczana automatycznie jako wartość procentowa kwoty wiersza (patrz poniżej) na podstawie stawki podatkowej. |
|
Kwota linii
|
Invoices.LineItems.LineAmount | number |
Kwota wiersza odzwierciedla obniżoną cenę, jeśli użyto rabatu |
|
Kod konta
|
Invoices.LineItems.AccountCode | string |
Kod konta alfanumerycznego zdefiniowany przez klienta, np. 200 lub SALES |
|
Identyfikator konta
|
Invoices.LineItems.AccountId | string |
Identyfikator konta Xero (unikatowy w organizacjach) |
|
Ilość
|
Invoices.LineItems.Quantity | number |
LineItem Quantity |
|
Identyfikator elementu lineItem
|
Invoices.LineItems.LineItemID | string |
Identyfikator wygenerowany przez Xero dla elementu LineItem |
|
Suma podrzędna
|
Invoices.SubTotal | number |
Łączna liczba faktur z wyłączeniem podatków |
|
Łączny podatek
|
Invoices.TotalTax | number |
Całkowity podatek na fakturze |
|
Total
|
Invoices.Total | number |
Łączna kwota podatku od faktury (tj. suma częściowa i łączna kwota) |
|
Data aktualizacji UTC
|
Invoices.UpdatedDateUTC | string |
Format UTC daty ostatniej modyfikacji |
|
Kod waluty
|
Invoices.CurrencyCode | string |
Waluta, w jakiej została podniesiona faktura |
|
|
Invoices.Type | string |
Typ faktury |
|
Identyfikator faktury
|
Invoices.InvoiceID | string |
Identyfikator wygenerowany przez Xero dla faktury (unikatowy w organizacjach) |
|
Numer faktury
|
Invoices.InvoiceNumber | string |
Unikatowy kod alfanumeryczny identyfikujący fakturę |
|
Kwota należna
|
Invoices.AmountDue | number |
Kwota pozostała do zapłaty na fakturze |
|
Kwota zapłacona
|
Invoices.AmountPaid | number |
Suma płatności otrzymanych na fakturze |
|
Kwota środków
|
Invoices.AmountCredited | number |
Suma wszystkich notatek kredytowych, nadmiernych płatności i przedpłat stosowanych do faktury |
|
Kurs waluty
|
Invoices.CurrencyRate | number |
Kurs walutowy dla faktury wielobieżnej |
|
Data pełnej płatności
|
Invoices.FullyPaidOnDate | string |
Data pełnej płatności faktury |
|
Payments
|
Invoices.Payments | array of object |
Payments |
|
Identyfikator płatności wsadowej
|
Invoices.Payments.BatchPaymentID | string |
Przedstawia, czy płatność została utworzona w ramach partii |
|
Identyfikator płatności
|
Invoices.Payments.PaymentID | string |
Identyfikator wygenerowany przez Xero na potrzeby płatności (unikatowy w organizacjach) |
|
Date
|
Invoices.Payments.Date | string |
Data dokonania płatności (RRRR-MM-DD) np. 2009-09-06 |
|
Kwota
|
Invoices.Payments.Amount | number |
Kwota płatności |
|
Kurs waluty
|
Invoices.Payments.CurrencyRate | number |
Kurs wymiany po otrzymaniu płatności |
Wyświetlanie listy kontaktów
Ta akcja umożliwia wyświetlenie listy kontaktów z usługi Xero, które są zgodne z wybranymi opcjami
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Gdzie filtr
|
where | string |
Filtr, na przykład Name="ABC limited" |
|
|
Filtruj według identyfikatorów kontaktów
|
IDs | string |
Filtrowanie według rozdzielonej przecinkami listy kontaktów |
|
|
Mniejsza uproszczona odpowiedź
|
summaryOnly | boolean |
Pobierz mniejszą wersję obiektu odpowiedzi. |
|
|
Paginacja
|
page | integer |
Pobieranie kolekcji faktur przy użyciu stronicowania |
|
|
Uwzględnij zarchiwizowane
|
includeArchived | boolean |
Kontakty ze stanem ARCHIVED zostaną uwzględnione w odpowiedzi |
|
|
Wyszukiwany termin
|
searchTerm | string |
Parametr wyszukiwania, który wykonuje wyszukiwanie tekstu bez uwzględniania wielkości liter w polu (Name, FirstName, LastName, ContactNumber, CompanyNumber, EmailAddress) |
|
|
Identyfikator dzierżawy Xero
|
xero-tenant-id | True | string |
Określanie identyfikatora dzierżawy Xero |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Kontakty
|
Contacts | array of object |
Kontakty |
|
Identyfikator kontaktu
|
Contacts.ContactID | string |
Identyfikator Xero (unikatowy w organizacjach) |
|
Numer kontaktowy
|
Contacts.ContactNumber | string |
To pole jest tylko do odczytu w interfejsie użytkownika Xero, używane do identyfikowania kontaktów w systemach zewnętrznych. Jest on wyświetlany jako kod kontaktu w interfejsie użytkownika kontaktów w środowisku Xero. |
|
Stan kontaktu
|
Contacts.ContactStatus | string |
Bieżący stan kontaktu |
|
Name
|
Contacts.Name | string |
Imię i nazwisko kontaktu/organizacji |
|
Imię
|
Contacts.FirstName | string |
Imię osoby kontaktowej |
|
Nazwisko
|
Contacts.LastName | string |
Nazwisko osoby kontaktowej |
|
Adres e-mail
|
Contacts.EmailAddress | string |
Adres e-mail osoby kontaktowej |
|
Szczegóły konta bankowego
|
Contacts.BankAccountDetails | string |
Numer konta bankowego kontaktu |
|
Adresy
|
Contacts.Addresses | array of object |
Adresy |
|
Typ adresu
|
Contacts.Addresses.AddressType | string |
Typ adresu |
|
Miejscowość
|
Contacts.Addresses.City | string |
Miejscowość |
|
Region
|
Contacts.Addresses.Region | string |
Region |
|
Kod pocztowy
|
Contacts.Addresses.PostalCode | string |
Kod pocztowy |
|
Country
|
Contacts.Addresses.Country | string |
Country |
|
UwagaDo
|
Contacts.Addresses.AttentionTo | string |
Uwaga: |
|
Telefony
|
Contacts.Phones | array of object |
Telefony |
|
PhoneType
|
Contacts.Phones.PhoneType | string |
Typ telefonu |
|
Numer Telefonu
|
Contacts.Phones.PhoneNumber | string |
Numer telefonu |
|
PhoneAreaCode
|
Contacts.Phones.PhoneAreaCode | string |
Kod obszaru telefonu |
|
PhoneCountryCode
|
Contacts.Phones.PhoneCountryCode | string |
Kod kraju telefonu |
|
Data aktualizacji UTC
|
Contacts.UpdatedDateUTC | string |
Znacznik czasu UTC ostatniej aktualizacji kontaktu |
|
Osoby kontaktowe
|
Contacts.ContactPersons | array of object |
Osoby kontaktowe dodatku |
|
Imię
|
Contacts.ContactPersons.FirstName | string |
Imię i nazwisko dodatkowej osoby kontaktowej |
|
Nazwisko
|
Contacts.ContactPersons.LastName | string |
Nazwisko osoby kontaktowej additonal |
|
Adres e-mail
|
Contacts.ContactPersons.EmailAddress | string |
Adres e-mail osoby kontaktowej dodatku |