SureXeroLite （獨立發行商） （預覽版）
釋放多功能連接器的強大功能，該連接器旨在輕鬆設定並無縫整合到您首選的業務應用程式中。 使用此連接器，您可以輕鬆產生發票、管理客戶和產品，並輕鬆存取發票詳細信息，從而創建流暢且有效率的工作流程。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 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 帳戶即可開始使用
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
|
array of object | ||
|
識別碼
|
id | string |
Id |
|
authEventId
|
authEventId | string |
驗證事件標識碼 |
|
tenantId
|
tenantId | string |
Xero 租用戶識別碼 |
|
tenantType
|
tenantType | string |
租戶類型 |
|
tenantName
|
tenantName | string |
租客名稱 |
|
創建日期UTCC
|
createdDateUtc | string |
創建日期 UTC |
|
更新日期UTC
|
updatedDateUtc | string |
更新日期 UTC |
列出發票
此操作允許您列出與所選選項匹配的 Xero 發票
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Xero 租用戶 ID
|
xero-tenant-id | True | string |
Xero 租用戶 ID |
|
Where 篩選器
|
where | string |
篩選器，例如 Type==“ACCPAY” AND Status==“AUTHORISED” |
|
|
篩選狀態
|
Statuses | string |
篩選以逗號分隔的狀態清單。 例如- AUTHORISED、DRAFT |
|
|
篩選 ID
|
IDs | string |
篩選以逗號分隔的 ID 清單 |
|
|
篩選發票號碼
|
InvoiceNumbers | string |
篩選以逗號分隔的發票號碼清單。 |
|
|
篩選聯絡人 ID
|
ContactIDs | string |
篩選以逗號分隔的聯絡人 ID 清單。 |
|
|
更小的輕量級響應
|
summaryOnly | boolean |
擷取回應物件的較小版本。 |
|
|
分頁
|
page | integer |
使用分頁擷取發票集合 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Invoices
|
Invoices | array of object |
Invoices |
|
連絡人識別碼
|
Invoices.Contact.ContactID | string |
Xero 聯絡人識別碼 |
|
名稱
|
Invoices.Contact.Name | string |
聯絡人/機構的全名 |
|
Date
|
Invoices.Date | string |
發票開立日期 – YYYY-MM-DD |
|
到期日
|
Invoices.DueDate | string |
發票到期日期 – YYYY-MM-DD |
|
發票狀態
|
Invoices.Status | string |
發票狀態（草稿、已提交、已授權） |
|
行金額類型
|
Invoices.LineAmountTypes | string |
行金額類型（不含、不含、不含稅） |
|
明細項目
|
Invoices.LineItems | array of object |
明細項目 |
|
Description
|
Invoices.LineItems.Description | string |
明細項目說明 |
|
單位金額
|
Invoices.LineItems.UnitAmount | number |
委刊項單位金額 |
|
稅種
|
Invoices.LineItems.TaxType | string |
如果所選 AccountCode 的預設稅碼不正確，則用作覆寫 |
|
稅額
|
Invoices.LineItems.TaxAmount | number |
稅額是根據稅率自動計算為行金額的百分比（見下文）。 |
|
明細金額
|
Invoices.LineItems.LineAmount | number |
如果已使用 DiscountRate，明細金額會反映折扣價格 |
|
帳戶代碼
|
Invoices.LineItems.AccountCode | string |
客戶定義的字母數字帳戶代碼，例如 200 或 SALES |
|
帳戶 ID
|
Invoices.LineItems.AccountId | string |
Xero 帳戶識別碼（在組織內唯一） |
|
數量
|
Invoices.LineItems.Quantity | number |
明細項目數量 |
|
明細項目 ID
|
Invoices.LineItems.LineItemID | string |
Xero 產生的 LineItem 識別碼 |
|
小計
|
Invoices.SubTotal | number |
不含稅的發票總額 |
|
總稅金
|
Invoices.TotalTax | number |
發票上的稅金總額 |
|
總數
|
Invoices.Total | number |
包含發票稅金的總計（即小計 + 總稅） |
|
更新日期 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 |
發票已全額付款的日期 |
|
付款
|
Invoices.Payments | array of object |
付款 |
|
批次付款 ID
|
Invoices.Payments.BatchPaymentID | string |
如果付款是作為批次的一部分建立的，則顯示 |
|
付款標識碼
|
Invoices.Payments.PaymentID | string |
Xero 產生的付款識別碼 （在組織內唯一） |
|
Date
|
Invoices.Payments.Date | string |
付款日期 （YYYY-MM-DD） 例如 2009-09-06 |
|
總數
|
Invoices.Payments.Amount | number |
付款金額 |
|
貨幣匯率
|
Invoices.Payments.CurrencyRate | number |
收到付款時的匯率 |
列出聯絡人
此操作可讓您列出與所選選項相符的 Xero 聯絡人
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Where 篩選器
|
where | string |
篩選器，例如 Name=“ABC limited” |
|
|
篩選 ContactID
|
IDs | string |
篩選以逗號分隔的 ContactID 清單 |
|
|
更小的輕量級響應
|
summaryOnly | boolean |
擷取回應物件的較小版本。 |
|
|
分頁
|
page | integer |
使用分頁擷取發票集合 |
|
|
包括已存檔
|
includeArchived | boolean |
狀態為「已封存」的聯絡人將包含在回應中 |
|
|
搜尋字詞
|
searchTerm | string |
搜尋參數，可跨欄位執行不區分大小寫的文字搜尋 （Name、FirstName、LastName、ContactNumber、CompanyNumber、EmailAddress） |
|
|
Xero 租用戶識別碼
|
xero-tenant-id | True | string |
指定 Xero 租用戶 ID |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
聯繫人
|
Contacts | array of object |
聯繫人 |
|
聯絡人 ID
|
Contacts.ContactID | string |
Xero 識別碼 （組織內唯一） |
|
連絡電話
|
Contacts.ContactNumber | string |
此欄位在 Xero UI 中是唯讀的，用於識別外部系統中的聯絡人。 它會在 Xero 的「聯絡人 UI」中顯示為聯絡人代碼。 |
|
聯絡狀態
|
Contacts.ContactStatus | string |
聯絡人的目前狀態 |
|
名稱
|
Contacts.Name | string |
聯絡人/機構的全名 |
|
名字
|
Contacts.FirstName | string |
聯絡人的名字 |
|
姓氏
|
Contacts.LastName | string |
聯絡人的姓氏 |
|
電子郵件地址
|
Contacts.EmailAddress | string |
聯絡人的電子郵件地址 |
|
銀行帳戶詳細資料
|
Contacts.BankAccountDetails | string |
聯絡人銀行帳號 |
|
Addresses
|
Contacts.Addresses | array of object |
Addresses |
|
地址類型
|
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 |
電話 |
|
電話類型
|
Contacts.Phones.PhoneType | string |
電話類型 |
|
電話號碼
|
Contacts.Phones.PhoneNumber | string |
電話號碼 |
|
電話區號
|
Contacts.Phones.PhoneAreaCode | string |
電話區號 |
|
電話國家代碼
|
Contacts.Phones.PhoneCountryCode | string |
電話國家代碼 |
|
更新日期 UTC
|
Contacts.UpdatedDateUTC | string |
上次更新的 UTC 時間戳記 |
|
聯絡人
|
Contacts.ContactPersons | array of object |
其他聯絡人 |
|
名字
|
Contacts.ContactPersons.FirstName | string |
其他聯絡人名字 |
|
姓氏
|
Contacts.ContactPersons.LastName | string |
附加聯絡人姓氏 |
|
電子郵件地址
|
Contacts.ContactPersons.EmailAddress | string |
其他聯絡人電子郵件地址 |
新增發票
此操作允許您在 Xero 中添加新發票
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Xero 租用戶 ID
|
xero-tenant-id | True | string |
Xero 租用戶識別碼 |
|
Date
|
Date | string |
發票開立日期 – YYYY-MM-DD |
|
|
到期日
|
DueDate | string |
發票到期日期 – YYYY-MM-DD |
|
|
發票類型
|
Type | True | string |
發票類型 （ACCREC - 銷售發票或客戶發票，ACCPAY - 帳單或供應商發票） |
|
附加參考編號
|
Reference | string |
僅限 ACCREC – 附加參考編號 |
|
|
連絡人識別碼
|
ContactID | True | string |
Xero 識別碼 （組織內唯一） |
|
行金額類型
|
LineAmountTypes | string |
如果您未指定此元素，則預設情況下，明細金額不包括稅金。 （獨家、全包、無稅）。 |
|
|
發票號碼
|
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 |
設定後顯示在銷售發票（應收帳款）上 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Invoices
|
Invoices | array of object |
Invoices |
|
連絡人識別碼
|
Invoices.Contact.ContactID | string |
Xero 聯絡人識別碼 |
|
名稱
|
Invoices.Contact.Name | string |
聯絡人/機構的全名 |
|
Date
|
Invoices.Date | string |
發票開立日期 – YYYY-MM-DD |
|
到期日
|
Invoices.DueDate | string |
發票到期日期 – YYYY-MM-DD |
|
發票狀態
|
Invoices.Status | string |
發票狀態（草稿、已提交、已授權） |
|
行金額類型
|
Invoices.LineAmountTypes | string |
行金額類型（不含、不含、不含稅） |
|
明細項目
|
Invoices.LineItems | array of object |
明細項目 |
|
Description
|
Invoices.LineItems.Description | string |
明細項目說明 |
|
單位金額
|
Invoices.LineItems.UnitAmount | number |
委刊項單位金額 |
|
稅種
|
Invoices.LineItems.TaxType | string |
如果所選 AccountCode 的預設稅碼不正確，則用作覆寫 |
|
稅額
|
Invoices.LineItems.TaxAmount | number |
稅額是根據稅率自動計算為行金額的百分比（見下文）。 |
|
明細金額
|
Invoices.LineItems.LineAmount | number |
如果已使用 DiscountRate，明細金額會反映折扣價格 |
|
帳戶代碼
|
Invoices.LineItems.AccountCode | string |
客戶定義的字母數字帳戶代碼，例如 200 或 SALES |
|
帳戶 ID
|
Invoices.LineItems.AccountId | string |
Xero 帳戶識別碼（在組織內唯一） |
|
數量
|
Invoices.LineItems.Quantity | number |
明細項目數量 |
|
明細項目 ID
|
Invoices.LineItems.LineItemID | string |
Xero 產生的 LineItem 識別碼 |
|
小計
|
Invoices.SubTotal | number |
不含稅的發票總額 |
|
總稅金
|
Invoices.TotalTax | number |
發票上的稅金總額 |
|
總數
|
Invoices.Total | number |
包含發票稅金的總計（即小計 + 總稅） |
|
更新日期 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 中新增聯絡人
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Xero 租用戶 ID
|
xero-tenant-id | True | string |
Xero 租用戶 ID |
|
名稱
|
Name | True | string |
聯絡人/機構的全名 |
|
名字
|
FirstName | string |
主要連絡人名字 |
|
|
姓氏
|
LastName | string |
主要聯絡人姓氏 |
|
|
電子郵件地址
|
EmailAddress | string |
主要聯絡人電子郵件地址 |
|
|
應收帳款稅種
|
AccountsReceivableTaxType | string |
用於應收帳款發票聯絡的預設稅種 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
聯繫人
|
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 |
聯絡人銀行帳號 |
|
Addresses
|
Contacts.Addresses | array of object |
聯絡人的地址 |
|
地址類型
|
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 |
連絡人的電話 |
|
電話類型
|
Contacts.Phones.PhoneType | string |
電話類型 |
|
電話號碼
|
Contacts.Phones.PhoneNumber | string |
電話號碼 |
|
電話區號
|
Contacts.Phones.PhoneAreaCode | string |
電話區號 |
|
電話國家代碼
|
Contacts.Phones.PhoneCountryCode | string |
電話國家代碼 |
|
|
Contacts.UpdatedDateUTC | string |
更新日期 UTC |
|
聯絡人
|
Contacts.ContactPersons | array of object |
其他聯絡人 |
|
名字
|
Contacts.ContactPersons.FirstName | string |
其他聯絡人名字 |
|
姓氏
|
Contacts.ContactPersons.LastName | string |
附加聯絡人姓氏 |
|
電子郵件地址
|
Contacts.ContactPersons.EmailAddress | string |
其他聯絡人電子郵件地址 |