SureXeroLite (независимый издатель) (предварительная версия)
Разблокируйте возможности универсального соединителя, предназначенного для простой настройки и простой интеграции с предпочитаемыми бизнес-приложениями. С помощью этого соединителя вы можете легко создавать счета, управлять клиентами и продуктами, а также легко получать доступ к сведениям о счете, создавая гладкий и эффективный рабочий процесс.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Поддержка 848 |
| URL | https://service.nowplatform.co/csm |
| Адрес электронной почты | support@848.co |
| Метаданные соединителя | |
|---|---|
| Publisher | Группа 848 |
| Веб-сайт | https://www.xero.com |
| Политика конфиденциальности | https://www.xero.com/uk/legal/privacy |
| Категории | Продуктивность; Финансировать |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Вход Xero |
Войдите в учетную запись Xero, чтобы приступить к работе |
| Добавление нового контакта |
Это действие позволяет добавить новый контакт в Xero |
| Добавление нового счета |
Это действие позволяет добавить новый счет в Xero |
| Перечисление счетов |
Это действие позволяет вывести список счетов из Xero, которые соответствуют выбранным параметрам. |
| Список контактов |
Это действие позволяет вывести список контактов из Xero, которые соответствуют выбранным параметрам. |
Вход Xero
Войдите в учетную запись Xero, чтобы приступить к работе
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
|
array of object | ||
|
id
|
id | string |
Идентификатор |
|
authEventId
|
authEventId | string |
Идентификатор события проверки подлинности |
|
tenantId
|
tenantId | string |
Идентификатор клиента Xero |
|
tenantType
|
tenantType | string |
Тип клиента |
|
tenantName
|
tenantName | string |
Имя клиента. |
|
createdDateUtc
|
createdDateUtc | string |
Дата создания в формате UTC |
|
обновленоDateUtc
|
updatedDateUtc | string |
Обновленная дата UTC |
Добавление нового контакта
Это действие позволяет добавить новый контакт в Xero
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор клиента Xero
|
xero-tenant-id | True | string |
Идентификатор клиента Xero |
|
Имя
|
Name | True | string |
Полное имя контакта или организации |
|
Имя (Первое имя)
|
FirstName | string |
Имя основного контакта |
|
|
Фамилия
|
LastName | string |
Фамилия основного контакта |
|
|
Электронная почта
|
EmailAddress | string |
Основной адрес электронной почты контакта |
|
|
Тип налога с задолженностью по счетам
|
AccountsReceivableTaxType | string |
Тип налога по умолчанию, используемый для контакта по счетам AR |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Контакты
|
Contacts | array of object |
Контакты |
|
Код контактного лица
|
Contacts.ContactID | string |
Идентификатор Xero |
|
Номер контакта
|
Contacts.ContactNumber | string |
Число для идентификации контактов во внешних системах |
|
Состояние контакта
|
Contacts.ContactStatus | string |
Текущее состояние контакта |
|
Имя
|
Contacts.Name | string |
Полное имя контакта или организации |
|
Имя (Первое имя)
|
Contacts.FirstName | string |
Имя основного контакта |
|
Фамилия
|
Contacts.LastName | string |
Фамилия основного контакта |
|
Электронная почта
|
Contacts.EmailAddress | string |
Основной адрес электронной почты контакта |
|
Сведения о банковском счете
|
Contacts.BankAccountDetails | string |
Номер банковского счета контакта |
|
Адреса
|
Contacts.Addresses | array of object |
Адреса для контакта |
|
AddressType
|
Contacts.Addresses.AddressType | string |
Тип адреса |
|
Город
|
Contacts.Addresses.City | string |
Город |
|
Регион
|
Contacts.Addresses.Region | string |
Регион |
|
Почтовый индекс
|
Contacts.Addresses.PostalCode | string |
Почтовый индекс |
|
Страна
|
Contacts.Addresses.Country | string |
Страна |
|
Телефоны
|
Contacts.Phones | array of object |
Телефоны для контакта |
|
PhoneType
|
Contacts.Phones.PhoneType | string |
Тип телефона |
|
Номер телефона
|
Contacts.Phones.PhoneNumber | string |
Номер телефона |
|
PhoneAreaCode
|
Contacts.Phones.PhoneAreaCode | string |
Код области телефона |
|
PhoneCountryCode
|
Contacts.Phones.PhoneCountryCode | string |
Код страны телефона |
|
|
Contacts.UpdatedDateUTC | string |
Обновленная дата UTC |
|
ContactPersons
|
Contacts.ContactPersons | array of object |
Additonal contact people |
|
Имя (Первое имя)
|
Contacts.ContactPersons.FirstName | string |
Имя дополнительного контактного лица |
|
Фамилия
|
Contacts.ContactPersons.LastName | string |
Фамилия контактного лица additonal |
|
Электронная почта
|
Contacts.ContactPersons.EmailAddress | string |
Адрес электронной почты пользователя additonal contact |
Добавление нового счета
Это действие позволяет добавить новый счет в Xero
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор клиента Xero
|
xero-tenant-id | True | string |
Идентификатор клиента Xero |
|
Date
|
Date | string |
Дата выставлена счет -YYY-MM-DD |
|
|
Срок
|
DueDate | string |
Счет по дате должен быть установлен — YYYY-MM-DD |
|
|
Тип счета
|
Type | True | string |
Тип счета (ACCREC — счет по продажам или счет клиента, счет ACCPAY-a или счет поставщика) |
|
Дополнительный справочный номер
|
Reference | string |
Только ACCREC — дополнительный справочный номер |
|
|
Код контактного лица
|
ContactID | True | string |
Идентификатор Xero (уникальный в организациях) |
|
Типы суммы строк
|
LineAmountTypes | string |
Суммы строк являются эксклюзивными по умолчанию, если этот элемент не указан. (Эксклюзивное, инклюзивное, NoTax). |
|
|
Номер счета
|
InvoiceNumber | string |
Уникальный буквенно-цифровой код, определяющий счет |
|
|
Описание элемента строки
|
Description | True | string |
Описание элемента строки |
|
Количество элементов строки
|
Quantity | True | number |
Количество элементов строки |
|
Сумма единицы элемента строки
|
UnitAmount | True | number |
Сумма единицы элемента строки |
|
Код учетной записи элемента строки
|
AccountCode | string |
Клиент определяет код буквенно-цифровой учетной записи, например 200 или SALES |
|
|
Скидка
|
DiscountRate | number |
Процентная скидка или сумма скидки, применяемая к элементу строки. |
|
|
Код Валюты
|
CurrencyCode | string |
Валюта, в которую был поднят счет |
|
|
Валютный курс
|
CurrencyRate | number |
Ставка валюты для счета с мультикурсией |
|
|
Состояние счета
|
Status | string |
Состояние счета (ЧЕРНОВИК, ОТПРАВЛЕНО, АВТОРИЗОВАНО) |
|
|
Ожидаемая дата оплаты
|
ExpectedPaymentDate | string |
Отображается на счетах по продажам (задолженность по счетам) при установке этого счета |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Invoices
|
Invoices | array of object |
Invoices |
|
Код контактного лица
|
Invoices.Contact.ContactID | string |
Идентификатор контакта Xero |
|
Имя
|
Invoices.Contact.Name | string |
Полное имя контакта или организации |
|
Date
|
Invoices.Date | string |
Дата выставлена счет -YYY-MM-DD |
|
Срок
|
Invoices.DueDate | string |
Счет по дате должен быть установлен — YYYY-MM-DD |
|
Состояние счета
|
Invoices.Status | string |
Состояние счета (ЧЕРНОВИК, ОТПРАВЛЕНО, АВТОРИЗОВАНО) |
|
Типы суммы строк
|
Invoices.LineAmountTypes | string |
Типы строк (эксклюзивные, включительно, NoTax) |
|
LineItems
|
Invoices.LineItems | array of object |
LineItems |
|
Description
|
Invoices.LineItems.Description | string |
Описание элемента строки |
|
Сумма единицы
|
Invoices.LineItems.UnitAmount | number |
Сумма единицы lineitem |
|
Тип налога
|
Invoices.LineItems.TaxType | string |
Используется в качестве переопределения, если налоговый код по умолчанию для выбранного объекта AccountCode не является правильным. |
|
Сумма налога
|
Invoices.LineItems.TaxAmount | number |
Сумма налога вычисляется автоматически в процентах от суммы линии (см. ниже) на основе налоговой ставки. |
|
Сумма строки
|
Invoices.LineItems.LineAmount | number |
Сумма строки отражает скидку на цену, если используется скидка |
|
Код учетной записи
|
Invoices.LineItems.AccountCode | string |
Клиент определяет код буквенно-цифровой учетной записи, например 200 или SALES |
|
Идентификатор учетной записи
|
Invoices.LineItems.AccountId | string |
Идентификатор учетной записи Xero (уникальный в организациях) |
|
Количество
|
Invoices.LineItems.Quantity | number |
Количество LineItem |
|
Идентификатор LineItem
|
Invoices.LineItems.LineItemID | string |
Созданный идентификатор Xero для LineItem |
|
Общее число вложенных данных
|
Invoices.SubTotal | number |
Общее количество счетов, за исключением налогов |
|
Итого налогов
|
Invoices.TotalTax | number |
Общий налог на счет |
|
Total
|
Invoices.Total | number |
Общий объем налога на счет включительно (т. е. SubTotal + TotalTax) |
|
Обновленная дата UTC
|
Invoices.UpdatedDateUTC | string |
Формат utc последней измененной даты |
|
Код Валюты
|
Invoices.CurrencyCode | string |
Валюта, в которую был поднят счет |
|
|
Invoices.Type | string |
Тип счета |
|
Номер счета
|
Invoices.InvoiceID | string |
Созданный идентификатор Xero для счета (уникальный в организациях) |
|
Номер счета
|
Invoices.InvoiceNumber | string |
Уникальный буквенно-цифровой код, определяющий счет |
|
Сумма из-за суммы
|
Invoices.AmountDue | number |
Сумма, оставшаяся для оплаты по счету |
|
Сумма оплачена
|
Invoices.AmountPaid | number |
Сумма платежей, полученных для счета |
|
Сумма кредитоспособности
|
Invoices.AmountCredited | number |
Сумма всех кредитных заметок, переплат и предварительных платежей, примененных к счету |
|
Валютный курс
|
Invoices.CurrencyRate | number |
Ставка валюты для счета с мультикурсией |
Перечисление счетов
Это действие позволяет вывести список счетов из Xero, которые соответствуют выбранным параметрам.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор клиента Xero
|
xero-tenant-id | True | string |
Идентификатор клиента Xero |
|
Где фильтр
|
where | string |
Фильтр, например Type=="ACCPAY" AND Status=="АВТОРИЗОВАНО" |
|
|
Фильтрация по состояниям
|
Statuses | string |
Фильтрация по разделенным запятыми списку состояний. Например, АВТОРИЗОВАННЫЙ, ЧЕРНОВИК |
|
|
Фильтрация по идентификаторам
|
IDs | string |
Фильтрация по разделенным запятыми списку идентификаторов |
|
|
Фильтрация по номерам счетов
|
InvoiceNumbers | string |
Фильтруйте список разделенных запятыми номера счета. |
|
|
Фильтрация по идентификаторам контакта
|
ContactIDs | string |
Фильтрация по разделенному запятыми списку идентификаторов контактов. |
|
|
Меньший упрощенный ответ
|
summaryOnly | boolean |
Получите меньшую версию объекта ответа. |
|
|
Постраничная разбивка
|
page | integer |
Получение коллекции счетов с помощью разбиения по страницам |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Invoices
|
Invoices | array of object |
Invoices |
|
Код контактного лица
|
Invoices.Contact.ContactID | string |
Идентификатор контакта Xero |
|
Имя
|
Invoices.Contact.Name | string |
Полное имя контакта или организации |
|
Date
|
Invoices.Date | string |
Дата выставлена счет -YYY-MM-DD |
|
Срок
|
Invoices.DueDate | string |
Счет по дате должен быть установлен — YYYY-MM-DD |
|
Состояние счета
|
Invoices.Status | string |
Состояние счета (ЧЕРНОВИК, ОТПРАВЛЕНО, АВТОРИЗОВАНО) |
|
Типы суммы строк
|
Invoices.LineAmountTypes | string |
Типы строк (эксклюзивные, включительно, NoTax) |
|
LineItems
|
Invoices.LineItems | array of object |
LineItems |
|
Description
|
Invoices.LineItems.Description | string |
Описание элемента строки |
|
Сумма единицы
|
Invoices.LineItems.UnitAmount | number |
Сумма единицы lineitem |
|
Тип налога
|
Invoices.LineItems.TaxType | string |
Используется в качестве переопределения, если налоговый код по умолчанию для выбранного объекта AccountCode не является правильным. |
|
Сумма налога
|
Invoices.LineItems.TaxAmount | number |
Сумма налога вычисляется автоматически в процентах от суммы линии (см. ниже) на основе налоговой ставки. |
|
Сумма строки
|
Invoices.LineItems.LineAmount | number |
Сумма строки отражает скидку на цену, если используется скидка |
|
Код учетной записи
|
Invoices.LineItems.AccountCode | string |
Клиент определяет код буквенно-цифровой учетной записи, например 200 или SALES |
|
Идентификатор учетной записи
|
Invoices.LineItems.AccountId | string |
Идентификатор учетной записи Xero (уникальный в организациях) |
|
Количество
|
Invoices.LineItems.Quantity | number |
Количество LineItem |
|
Идентификатор LineItem
|
Invoices.LineItems.LineItemID | string |
Созданный идентификатор Xero для LineItem |
|
Общее число вложенных данных
|
Invoices.SubTotal | number |
Общее количество счетов, за исключением налогов |
|
Итого налогов
|
Invoices.TotalTax | number |
Общий налог на счет |
|
Total
|
Invoices.Total | number |
Общий объем налога на счет включительно (т. е. SubTotal + TotalTax) |
|
Обновленная дата UTC
|
Invoices.UpdatedDateUTC | string |
Формат utc последней измененной даты |
|
Код Валюты
|
Invoices.CurrencyCode | string |
Валюта, в которую был поднят счет |
|
|
Invoices.Type | string |
Тип счета |
|
Номер счета
|
Invoices.InvoiceID | string |
Созданный идентификатор Xero для счета (уникальный в организациях) |
|
Номер счета
|
Invoices.InvoiceNumber | string |
Уникальный буквенно-цифровой код, определяющий счет |
|
Сумма из-за суммы
|
Invoices.AmountDue | number |
Сумма, оставшаяся для оплаты по счету |
|
Сумма оплачена
|
Invoices.AmountPaid | number |
Сумма платежей, полученных для счета |
|
Сумма кредитоспособности
|
Invoices.AmountCredited | number |
Сумма всех кредитных заметок, переплат и предварительных платежей, примененных к счету |
|
Валютный курс
|
Invoices.CurrencyRate | number |
Ставка валюты для счета с мультикурсией |
|
Полная оплата по дате
|
Invoices.FullyPaidOnDate | string |
Дата полной оплаты счета |
|
Payments
|
Invoices.Payments | array of object |
Payments |
|
Идентификатор пакетной оплаты
|
Invoices.Payments.BatchPaymentID | string |
Присутствует, если платеж был создан как часть пакета |
|
Идентификатор оплаты
|
Invoices.Payments.PaymentID | string |
Созданный идентификатор Xero для оплаты (уникальный в организациях) |
|
Date
|
Invoices.Payments.Date | string |
Дата оплаты производится (ГГГГ-MM-DD), например 2009-09-06 |
|
Сумма
|
Invoices.Payments.Amount | number |
Сумма платежа |
|
Валютный курс
|
Invoices.Payments.CurrencyRate | number |
Обменный курс при получении платежа |
Список контактов
Это действие позволяет вывести список контактов из Xero, которые соответствуют выбранным параметрам.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Где фильтр
|
where | string |
Фильтр, например Name="ABC limited" |
|
|
Фильтрация по контактным идентификаторам
|
IDs | string |
Фильтрация по разделенному запятыми списку контактных идентификаторов |
|
|
Меньший упрощенный ответ
|
summaryOnly | boolean |
Получите меньшую версию объекта ответа. |
|
|
Постраничная разбивка
|
page | integer |
Получение коллекции счетов с помощью разбиения по страницам |
|
|
Включение архива
|
includeArchived | boolean |
Контакты с состоянием ARCHIVED будут включены в ответ |
|
|
Условие поиска
|
searchTerm | string |
Параметр поиска, выполняющий поиск без учета регистра в поле (Name, FirstName, LastName, ContactNumber, CompanyNumber, EmailAddress) |
|
|
Идентификатор клиента Xero
|
xero-tenant-id | True | string |
Указание идентификатора клиента Xero |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Контакты
|
Contacts | array of object |
Контакты |
|
Контактный номер
|
Contacts.ContactID | string |
Идентификатор Xero (уникальный в организациях) |
|
Номер контакта
|
Contacts.ContactNumber | string |
Это поле считывается только в пользовательском интерфейсе Xero, используемом для идентификации контактов во внешних системах. Он отображается в виде кода контакта в пользовательском интерфейсе контактов в Xero. |
|
Состояние контакта
|
Contacts.ContactStatus | string |
Текущее состояние контакта |
|
Имя
|
Contacts.Name | string |
Полное имя контакта или организации |
|
Имя (Первое имя)
|
Contacts.FirstName | string |
Имя контактного лица |
|
Фамилия
|
Contacts.LastName | string |
Фамилия контактного лица |
|
Электронная почта
|
Contacts.EmailAddress | string |
Адрес электронной почты контактного лица |
|
Сведения о банковском счете
|
Contacts.BankAccountDetails | string |
Номер банковского счета контакта |
|
Адреса
|
Contacts.Addresses | array of object |
Адреса |
|
AddressType
|
Contacts.Addresses.AddressType | string |
Тип адреса |
|
Город
|
Contacts.Addresses.City | string |
Город |
|
Регион
|
Contacts.Addresses.Region | string |
Регион |
|
Почтовый индекс
|
Contacts.Addresses.PostalCode | string |
Почтовый индекс |
|
Страна
|
Contacts.Addresses.Country | string |
Страна |
|
Внимание
|
Contacts.Addresses.AttentionTo | string |
Внимание к |
|
Телефоны
|
Contacts.Phones | array of object |
Телефоны |
|
PhoneType
|
Contacts.Phones.PhoneType | string |
Тип телефона |
|
Номер телефона
|
Contacts.Phones.PhoneNumber | string |
Номер телефона |
|
PhoneAreaCode
|
Contacts.Phones.PhoneAreaCode | string |
Код области телефона |
|
PhoneCountryCode
|
Contacts.Phones.PhoneCountryCode | string |
Код страны телефона |
|
Обновленная дата UTC
|
Contacts.UpdatedDateUTC | string |
Метка времени UTC последнего обновления для контакта |
|
ContactPersons
|
Contacts.ContactPersons | array of object |
Additonal contact people |
|
Имя (Первое имя)
|
Contacts.ContactPersons.FirstName | string |
Имя дополнительного контактного лица |
|
Фамилия
|
Contacts.ContactPersons.LastName | string |
Фамилия контактного лица additonal |
|
Электронная почта
|
Contacts.ContactPersons.EmailAddress | string |
Адрес электронной почты пользователя additonal contact |