Entegrations.io(预览版)

Entegrations.io,inc 提供了 3 组广泛的功能。 1) 利用PayPal帐户PayPal发票、付款和 IPN 功能。 2) 利用 Xero 帐户进行发票和联系人的 Webhook。 3) QBO Inovice 利用 QuickBooks Online 帐户。

此连接器在以下产品和区域中可用:

服务 Class 区域
Copilot Studio 高级 除以下各项外的所有 Power Automate 区域
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域
     - Azure 政府区域
     - Azure 中国区域
     - 美国国防部(DoD)
Power Apps 高级 除以下各项外的所有 Power Apps 区域
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
Power Automate 高级 除以下各项外的所有 Power Automate 区域
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
联系人​​
Name entegrations.io inc 支持
URL https://www.entegrations.io/#contact
Email support@entegrations.io
连接器元数据
发布者 entegrations.io inc
网站 https://www.entegrations.io
隐私策略 https://www.entegrations.io/privacy.html
类别 生产力

Entegrations.io 提供利用PayPal帐户的发票、付款和 IPN 数据。 发票功能允许通过PayPal平台创建发票并将其发送到接收方。 付款功能允许通过PayPal平台向一个或多个接收方发送付款。 IPN 功能允许接收PayPal IPN 数据。 所有这些 3 个功能都通过代理到第三方(即 entegrations.io)来工作。 在使用此连接器之前,需要凭据。 为此,需要进行一次性PayPal授权,并允许我们代表你创建发票或付款。 请访问 https://portal.entegrations.io/portal 载入说明。 作为载入的一部分,你将获得 API 密钥,可以在 Microsoft Flow 上使用自定义连接器时用于连接。

先决条件

订阅可用的 https://portal.entegrations.io/portal 计划之一是使用此连接器的先决条件。 首先,可以选择基本计划。 作为订阅和启用此连接器的一部分,你将获得要使用的 API 密钥。

如何获取凭据

  1. 在以下位置注册合适的计划 https://portal.entegrations.io/portal
  2. 登录以转到“我的帐户”页。
  3. 在“可用连接器/应用”部分下找到此连接器。 启用连接器并遵循一次性身份验证流。
  4. 访问并复制自动生成的 API 密钥,并在使用此连接器时将其用于流中。

正在创建连接

连接器支持以下身份验证类型:

默认 用于创建连接的参数。 所有区域 不可共享

违约

适用:所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享,系统会提示其他用户显式创建新连接。

Name 类型 Description 必选
API 密钥 securestring 此 API 的 API 密钥 True

限制

名称 调用 续订期
每个连接的 API 调用数 100 60 秒

操作

创建 QBO 发票

根据 API 创建和发送 QuickBooks Online 发票 https://developer.intuit.com/app/developer/qbo/docs/api/accounting/ecommerce/invoice

创建PayPal付款

根据一个或多个接收方的 API 创建PayPal付款 https://developer.paypal.com/docs/api/payments.payouts-batch/v1/#payouts_create

创建PayPal发票

根据发票的 API 创建草稿PayPal发票,并立即将其发送到接收方https://developer.paypal.com/docs/api/invoicing/v1/#invoices_createhttps://developer.paypal.com/docs/api/invoicing/v1/#invoices_send

删除 IPN new_case创建的 Webhook

删除与PayPal IPN new_case创建的 Webhook 对应的 Entegrations.io Webhook。

删除 IPN recurring_payment已完成的 Webhook

删除与PayPal IPN recurring_payment已完成 Webhook 对应的 Entegrations.io Webhook。

删除 IPN 已完成的 webhook express_checkout

删除与PayPal IPN express_checkout已完成 Webhook 对应的 Entegrations.io Webhook。

删除付款成功 Webhook

删除与PayPal付款成功 webhook 对应的 Entegrations.io Webhook。

删除发票 Webhook

删除与 Xero Invoices Webhook 对应的 Entegrations.io Webhook。

删除发票付费 Webhook

删除与PayPal发票付费 Webhook 对应的 Entegrations.io Webhook。

删除联系人 Webhook

删除与 Xero Contacts 更新 webhook 相对应的 Entegrations.io Webhook。

删除通用 IPN Webhook

删除与 PayPal IPN 的通用 Webhook 对应的 Entegrations.io Webhook。

高级使用:删除发票、付款等 Webhook

高级使用:删除与PayPal webhook 相对应的 Entegrations.io Webhook。

创建 QBO 发票

根据 API 创建和发送 QuickBooks Online 发票 https://developer.intuit.com/app/developer/qbo/docs/api/accounting/ecommerce/invoice

参数

名称 密钥 必需 类型 说明
发件人的电子邮件
SenderEmail True string

发件人的电子邮件,对应于 Intuit QuickBooks Online 帐户。

发件人的领域 ID 或公司 ID
RealmId True string

发件人的领域 ID 或公司 ID,对应于 Intuit QuickBooks Online 帐户。

交易记录日期
TxnDate string

YYYY 格式的事务日期-MM-DD 格式

截止日期
DueDate string

YYYY 格式的截止日期-MM-DD 格式

DocNumber
DocNumber string

DocNumber

金额
Amount True double

金额

详细信息类型
DetailType True string

详细信息类型

价值
value True string

价值

Name
name True string

Name

客户参考
value True string

客户参考

返回

响应详细信息,包括状态。

创建PayPal付款

根据一个或多个接收方的 API 创建PayPal付款 https://developer.paypal.com/docs/api/payments.payouts-batch/v1/#payouts_create

参数

名称 密钥 必需 类型 说明
发件人的电子邮件
email True string

发件人的电子邮件对应于PayPal帐户。

发送方的 Batch ID
sender_batch_id string

发送方的 Batch ID(应为唯一值,每PayPal在过去 30 天内)。

电子邮件主题
email_subject string

PayPal发送的电子邮件通知的主题。

接收方类型
recipient_type string

收件人类型。 有效值为 EMAIL/PAYER_ID/PHONE 之一。 此值或付款项/详细信息中的值是必需的。

接收方类型
recipient_type string

收件人类型。 有效值为 EMAIL/PAYER_ID/PHONE 之一。 此值或 Payout 批处理标头中的值是必需的。

接收方(电子邮件/付款人 ID/电话)
receiver True string

接收方的电子邮件/PayPal payer_id/电话号码。

注释
note string

付款项目级别说明。

发件人的项目 ID
sender_item_id string

发送方的付款项 ID(应是唯一值,每PayPal在过去 30 天内)。

货币
currency True string

货币

价值
value True string

价值

返回

创建PayPal发票

根据发票的 API 创建草稿PayPal发票,并立即将其发送到接收方https://developer.paypal.com/docs/api/invoicing/v1/#invoices_createhttps://developer.paypal.com/docs/api/invoicing/v1/#invoices_send

参数

名称 密钥 必需 类型 说明
发件人的电子邮件
email True string

发件人的电子邮件对应于PayPal帐户。

发件人的名字
first_name string

发件人的名字。

发件人的姓氏
last_name string

发件人的姓氏。

发件人的业务名称
business_name string

发件人的业务名称。

发件人的国家/地区电话代码
country_code string

电话的国家/地区代码。

发件人电话号码,带区号
national_number string

带区号的电话 nuber。

发件人地址 1
line1 True string

地址行 1。

发件人城市
city True string

City

发件人的状态
state string

State

发件人邮政编码
postal_code string

邮政编码

发件人的国家/地区代码
country_code True string

两个字符的 ISO 国家/地区代码。

向电子邮件计费
email True string

向电子邮件计费。 这可能是接收PayPal帐户的电子邮件。

计费名字
first_name string

名字

计费姓氏
last_name string

姓氏

发货名字
first_name string

名字

寄送姓氏
last_name string

姓氏

寄送地址 1
line1 string

地址行 1。

航运城市
city string

City

发货状态
state string

State

寄送邮政编码
postal_code string

邮政编码

发货国家/地区代码
country_code string

国家/地区代码

物料名称
name string

物料名称

项目数量
quantity string

数量。 例如 1.5

单价货币
currency True string

货币

单价值
value True string

价值

项目税类型/名称
name True string

税务类型/名称

项目税百分比
percent True string

百分之。 例如 8.5

折扣率
percent string

Percent

发货成本货币
currency string

货币

发货成本值
value string

价值

发票说明
note string

发票说明

发票术语
terms string

发票术语

返回

响应详细信息,包括状态。

删除 IPN new_case创建的 Webhook

删除与PayPal IPN new_case创建的 Webhook 对应的 Entegrations.io Webhook。

参数

名称 密钥 必需 类型 说明
要删除的 Webhook 的 ID
webhookId True string

要删除的 Webhook 的 ID

删除 IPN recurring_payment已完成的 Webhook

删除与PayPal IPN recurring_payment已完成 Webhook 对应的 Entegrations.io Webhook。

参数

名称 密钥 必需 类型 说明
要删除的 Webhook 的 ID
webhookId True string

要删除的 Webhook 的 ID

删除 IPN 已完成的 webhook express_checkout

删除与PayPal IPN express_checkout已完成 Webhook 对应的 Entegrations.io Webhook。

参数

名称 密钥 必需 类型 说明
要删除的 Webhook 的 ID
webhookId True string

要删除的 Webhook 的 ID

删除付款成功 Webhook

删除与PayPal付款成功 webhook 对应的 Entegrations.io Webhook。

参数

名称 密钥 必需 类型 说明
要删除的 Webhook 的 ID
webhookId True string

要删除的 Webhook 的 ID

删除发票 Webhook

删除与 Xero Invoices Webhook 对应的 Entegrations.io Webhook。

参数

名称 密钥 必需 类型 说明
要删除的 Webhook 的 ID
webhookId True string

要删除的 Webhook 的 ID

删除发票付费 Webhook

删除与PayPal发票付费 Webhook 对应的 Entegrations.io Webhook。

参数

名称 密钥 必需 类型 说明
要删除的 Webhook 的 ID
webhookId True string

要删除的 Webhook 的 ID

删除联系人 Webhook

删除与 Xero Contacts 更新 webhook 相对应的 Entegrations.io Webhook。

参数

名称 密钥 必需 类型 说明
要删除的 Webhook 的 ID
webhookId True string

要删除的 Webhook 的 ID

删除通用 IPN Webhook

删除与 PayPal IPN 的通用 Webhook 对应的 Entegrations.io Webhook。

参数

名称 密钥 必需 类型 说明
要删除的 Webhook 的 txnType
txnType True string

要删除的 Webhook 的 txnType

要删除的 Webhook 的 txnStatus
txnStatus True string

要删除的 Webhook 的 txnStatus

要删除的 Webhook 的 ID
webhookId True string

要删除的 Webhook 的 ID

高级使用:删除发票、付款等 Webhook

高级使用:删除与PayPal webhook 相对应的 Entegrations.io Webhook。

参数

名称 密钥 必需 类型 说明
要删除的 Webhook 的 ID
webhookId True string

要删除的 Webhook 的 ID

触发器

每当创建新事例时

为PayPal新案例创建 IPN 事件创建 entegrations.io Webhook,每当 entegrations.io 从PayPal接收代表 ipn 有效负载时,就会触发该事件。

每当在 Xero 创建或更新发票时

为 Xero Invoices 创建 entegrations.io Webhook 更新数据,每当 entegrations.io 从 Xero 接收发票的代理 Webhook 有效负载时,都会触发该 webhook。

每当在 Xero 创建或更新联系人时

为 Xero Contacts 数据创建 entegrations.io Webhook,每当 entegrations.io 从 Xero 接收联系人的代理 Webhook 有效负载时,都会触发该 webhook。

每当定期付款完成时

为PayPal定期付款完成的 IPN 事件创建 entegrations.io Webhook,每当 entegrations.io 从PayPal收到代表 ipn 有效负载时,就会触发该事件。

每当快速结帐付款完成时

为PayPal express_checkout已完成的 IPN 事件创建 entegrations.io Webhook,每当 entegrations.io 从PayPal接收代表 ipn 有效负载时,就会触发该事件。

每当支付付款时

为 PayPal Payouts 付费数据创建 entegrations.io Webhook,每当 entegrations.io 从 PayPal 收到 Payouts Payouts 的代理 Webhook 有效负载时,就会触发该 webhook。

每当支付发票(PayPal)

为PayPal开票付费数据创建 entegrations.io Webhook,每当 entegrations.io 收到PayPal支付发票的代理 Webhook 有效负载时,就会触发该 webhook。

高级使用:开票时收到付款更新

高级使用:为PayPal发票、付款等 webhook 数据创建 entegrations.io Webhook,每当 entegrations.io 从 PayPal 收到代表 Webhook 有效负载时,就会触发该 webhook 数据。 请注意,这是默认有效负载,可获取PayPal发送的任何内容。

高级使用:收到 IPN(泛型)更新时

高级使用:为PayPal IPN 事件数据创建 entegrations.io Webhook,每当 entegrations.io 从PayPal接收代表 IPN 有效负载时,就会触发该 webhook。 请注意,这是默认有效负载,可获取PayPal发送的任何内容。

每当创建新事例时

为PayPal新案例创建 IPN 事件创建 entegrations.io Webhook,每当 entegrations.io 从PayPal接收代表 ipn 有效负载时,就会触发该事件。

参数

名称 密钥 必需 类型 说明
paypalEmailAddress
paypalEmailAddress True string

PayPal帐户的电子邮件地址。 必须使用用于连接器的同一PayPal电子邮件地址。

返回

每当在 Xero 创建或更新发票时

为 Xero Invoices 创建 entegrations.io Webhook 更新数据,每当 entegrations.io 从 Xero 接收发票的代理 Webhook 有效负载时,都会触发该 webhook。

参数

名称 密钥 必需 类型 说明
xeroEmailAddress
xeroEmailAddress True string

Xero 帐户的电子邮件地址。 必须使用用于加入自定义连接器的同一 Xero 电子邮件地址。

shouldGetInvoiceAsPdf
shouldGetInvoiceAsPdf boolean

指示发票是否还必须作为 PDF 从 Xero 获取,以及发票资源。

返回

每当在 Xero 创建或更新联系人时

为 Xero Contacts 数据创建 entegrations.io Webhook,每当 entegrations.io 从 Xero 接收联系人的代理 Webhook 有效负载时,都会触发该 webhook。

参数

名称 密钥 必需 类型 说明
xeroEmailAddress
xeroEmailAddress True string

Xero 帐户的电子邮件地址。 必须使用用于加入自定义连接器的同一 Xero 电子邮件地址。

返回

每当定期付款完成时

为PayPal定期付款完成的 IPN 事件创建 entegrations.io Webhook,每当 entegrations.io 从PayPal收到代表 ipn 有效负载时,就会触发该事件。

参数

名称 密钥 必需 类型 说明
paypalEmailAddress
paypalEmailAddress True string

PayPal帐户的电子邮件地址。 必须使用用于连接器的同一PayPal电子邮件地址。

返回

每当快速结帐付款完成时

为PayPal express_checkout已完成的 IPN 事件创建 entegrations.io Webhook,每当 entegrations.io 从PayPal接收代表 ipn 有效负载时,就会触发该事件。

参数

名称 密钥 必需 类型 说明
paypalEmailAddress
paypalEmailAddress True string

PayPal帐户的电子邮件地址。 必须使用用于连接器的同一PayPal电子邮件地址。

返回

每当支付付款时

为 PayPal Payouts 付费数据创建 entegrations.io Webhook,每当 entegrations.io 从 PayPal 收到 Payouts Payouts 的代理 Webhook 有效负载时,就会触发该 webhook。

参数

名称 密钥 必需 类型 说明
paypalEmailAddress
paypalEmailAddress True string

PayPal帐户的电子邮件地址。 必须使用用于连接器的同一PayPal电子邮件地址。

返回

每当支付发票(PayPal)

为PayPal开票付费数据创建 entegrations.io Webhook,每当 entegrations.io 收到PayPal支付发票的代理 Webhook 有效负载时,就会触发该 webhook。

参数

名称 密钥 必需 类型 说明
paypalEmailAddress
paypalEmailAddress True string

PayPal帐户的电子邮件地址。 必须使用用于连接器的同一PayPal电子邮件地址。

返回

高级使用:开票时收到付款更新

高级使用:为PayPal发票、付款等 webhook 数据创建 entegrations.io Webhook,每当 entegrations.io 从 PayPal 收到代表 Webhook 有效负载时,就会触发该 webhook 数据。 请注意,这是默认有效负载,可获取PayPal发送的任何内容。

参数

名称 密钥 必需 类型 说明
paypalEmailAddress
paypalEmailAddress True string

PayPal帐户的电子邮件地址。 必须使用用于连接器的同一PayPal电子邮件地址。

返回

高级使用:收到 IPN(泛型)更新时

高级使用:为PayPal IPN 事件数据创建 entegrations.io Webhook,每当 entegrations.io 从PayPal接收代表 IPN 有效负载时,就会触发该 webhook。 请注意,这是默认有效负载,可获取PayPal发送的任何内容。

参数

名称 密钥 必需 类型 说明
正在创建的 IPN 的txn_type。
txnType True string

正在创建的 IPN 的txn_type。 将所有txn_types全部保留。

要创建的 Webhook 的 txn 或付款状态。
txnStatus True string

要创建的 Webhook 的 txn 或付款状态。 保留所有状态。

paypalEmailAddress
paypalEmailAddress True string

PayPal帐户的电子邮件地址。 必须使用用于连接器的同一PayPal电子邮件地址。

返回

定义

EntegrationsInvoice4PayPalCreateResponse

响应详细信息,包括状态。

名称 路径 类型 说明
状态
status string

创建发票的状态。 可能的值:成功或错误。

PayPal_invoice_id
details.paypal_invoice_id string

由PayPal生成的发票 ID。

PayPal_invoice_number
details.paypal_invoice_number string

PayPal生成的发票编号。

errorMessage
errorMessage string

错误消息(如果有错误)。

EntegrationsPayouts4PayPalCreateResponse

名称 路径 类型 说明
状态
status string

创建付款的状态。 可能的值:成功或错误。

PayPal_payout_batch_id
details.paypal_payout_batch_id string

此付款的PayPal生成的批处理 ID。

sender_batch_id
details.sender_batch_id string

请求中发送的批处理 ID(回显相同的值)

errorMessage
errorMessage string

错误消息(如果有错误)。

EntegrationsWebhook4PayPalDefaultPushResponse

名称 路径 类型 说明
由PayPal提供的 ID
id string
由PayPal提供的create_time
create_time string
由PayPal给出的event_type
event_type string
PayPal给出的resource_type
resource_type string
摘要,由PayPal提供
summary string
由PayPal提供的资源
resource object
PayPal提供的资源的字符串化版本
resource_json_stringified string

EntegrationsWebhook4PayPalInvoicingPaidPushResponse

名称 路径 类型 说明
由PayPal提供的 ID
invoice_paid_paypal_invoice_id string
由PayPal提供的create_time
invoice_paid_time string
摘要,由PayPal提供
invoice_paid_summary string
由PayPal提供的资源
invoice_paid_resource object

EntegrationsWebhook4PayPalPayoutsPaidPushResponse

名称 路径 类型 说明
由PayPal提供的 ID
payouts_batch_success_paypal_payout_batch_id string
由PayPal提供的create_time
payouts_batch_success_time string
摘要,由PayPal提供
payouts_batch_success_summary string
由PayPal提供的资源
payouts_batch_success_resource object

EntegrationsWebhook4PayPalIpnEcCompletedPushResponse

名称 路径 类型 说明
PayPal给出的txn_id
txn_id string
由PayPal给出的payment_date
payment_date string
PayPal给出的mc_gross
mc_gross string
PayPal提供的mc_fee
mc_fee string
由PayPal提供的payer_email
payer_email string

EntegrationsWebhook4PayPalIpnNewCaseCreatedPushResponse

名称 路径 类型 说明
PayPal提供的case_creation_date
case_creation_date string
PayPal给出的case_id
case_id string
PayPal提供的buyer_additional_information
buyer_additional_information string
由PayPal提供的case_type
case_type string
PayPal给出的reason_code
reason_code string

EntegrationsWebhook4PayPalIpnRecurringPaymentCompletedPushResponse

名称 路径 类型 说明
PayPal给出的txn_id
txn_id string
由PayPal给出的payment_date
payment_date string
自定义值(必须在与PayPal集成期间使用)由PayPal
custom string
由PayPal给出的payment_status
payment_status string
由PayPal给出的金额
amount string
如果名字和姓氏为 null,则为 null。 否则为业务名称。 这些值由PayPal提供
payer_full_name string
由PayPal提供的payer_email
payer_email string

EntegrationsWebhook4XeroInvoicesPushResponse

名称 路径 类型 说明
由 Xero 提供的 resourceUrl
resource_url string
由 Xero 提供的 resourceId
resource_id string
由 Xero 提供的 eventDateUtc,例如 2017-06-21T01:15:39.902
event_date_tc string
由 Xero 提供的 eventType。 可以是“创建”或“更新”
event_type string
由 Xero 提供的 eventCategory。 可以是发票或联系人,但此方案的 INVOICE。
event_category string
由 Xero 提供的 tenantId,例如 c2cc9b6e-9458-4c7d-93cc-f02b81b0594f
tenant_id string
由 Xero 提供的 tenantType,这是组织目前
tenantType string
Xero 提供的发票资源。
invoice_resource object
将此发票提取为 PDF 时,此可选字段可以包含 Xero 提供的 Application/pdf 内容的 Base64 版本。
invoice_pdf_as_base64 object

EntegrationsWebhook4XeroContactsPushResponse

名称 路径 类型 说明
由 Xero 提供的 resourceUrl
resource_url string
由 Xero 提供的 resourceId
resource_id string
由 Xero 提供的 eventDateUtc,例如 2017-06-21T01:15:39.902
event_date_tc string
由 Xero 提供的 eventType。 可以是“创建”或“更新”
event_type string
由 Xero 提供的 eventCategory。 可以是发票或联系人,但此方案的 CONTACT。
event_category string
由 Xero 提供的 tenantId,例如 c2cc9b6e-9458-4c7d-93cc-f02b81b0594f
tenant_id string
由 Xero 提供的 tenantType,这是组织目前
tenantType string
根据 Xero 提供的联系人资源
contact_resource object

EntegrationsInvoice4IntuitCreateResponse

响应详细信息,包括状态。

名称 路径 类型 说明
状态
status string

创建发票的状态。 可能的值:成功或错误。

intuit_invoice_id
details.intuit_invoice_id string

QuickBooks 生成的发票 ID。

intuit_invoice_number
details.intuit_invoice_number string

QuickBooks 生成的发票编号。

errorMessage
errorMessage string

错误消息(如果有错误)。