按订单号检索“Shopify Payments”费用以与会计 + 银行存款进行对账？

Question

在会计系统内对存款进行核对，从运行 Shopify Payments（或其他方式）的 Shopify 商店进入 Shopify 用户的银行帐户，这似乎是人们经常根据数字偶然发现 \xe2\x80\x94 的事情之一有关 Shopify 支持社区论坛上的主题的请求，例如： https: //community.shopify.com/c/Shopify-APIs-SDKs/Fees-charged-by-Shopify-via-API/mp/265261 /

\n\n

问题（对于会计）是 Shopify Payments在将交易余额存入店主的账户之前删除了费用金额（有关费用的完整列表，请参阅：https: //www.shopify.com/pricing ）银行账户。

\n\n

Shopify 费用通常如下所示：2.6% of transaction value + $0.30

\n\n

根据上述内容计算应收取的费用非常简单（对费用表进行硬编码），直到这些费用在未来某个时候发生变化。

\n\n

这对集成有何影响？

\n\n

对于许多可用的简单集成，这会导致打入银行帐户的发票金额与我们根据通过 Shopify 轻松检索的 Shopify 发票金额“预期”打入银行帐户的金额之间存在差异。的 API 由许多此类解决方案提供。

\n\n

这种差异意味着基于会计的用户有必要手动推断哪个 Shopify 发票与哪个传入银行存款 \xe2\x80\x94\xc2\xa0 相关联，然后手动添加一个负行项目来计算差额/余额图书。

\n\n

\n

这是几个不同的会计系统/软件供应商（特别是 Xero 和 Quickbooks）在被问及他们的客户如何解决上述问题时提出的建议方法。

\n

\n\n

我知道有一些解决方案试图解决上述所有问题（取得了不同程度的成功），但由于我目前的情况涉及大量的配套工作，这些解决方案都无法充分解决我们业务所需的其他功能。

\n\n

\n

我们需要能够找到费用（或者自己计算）并将这些费用添加到发票中，以便我们的会计系统期望正确的资金金额打入我们的银行帐户 \xe2\x80\x94 因此问题：如何我们可以检索当前帐户的“Shopify Payments”费用/费率吗？

\n

\n\n

理想情况下，我希望避免对这些信息进行硬编码，因为 Shopify 可能会更改费用（可能只发出少量通知），这意味着到那时我们的集成就会中断。最好能够通过 API 请求检索给定帐户的费用表，从而避免费用发生变化时出现问题。

\n\n

我有多个客户也面临同样的问题 \xe2\x80\x94\xc2\xa0so 我认为值得检查一下是否有人遇到/解决了问题，并讨论我当前的解决方案

\n\n

Shopify 说什么？

\n\n

一般来说，他们的评论是，在响应 API 请求时，没有包含从发票中扣除的费用的路线图，取自： https: //community.shopify.com/c/Shopify-APIs-SDKs/Fees-charged- by-Shopify-via-API/mp/265261/（这看起来很奇怪） \xe2\x80\x94\xc2\xa0 意味着“不会做”是功能请求的最佳分类，它将通过简单的 / 提供此信息对当前可用的 API 端点的随时可用的调用。

\n\n

\n

由于无法获取每个订单的费用金额，我不确定 Shopify 商店目前如何与其帐户系统交互。

\n

\n\n

我很乐意听到以前遇到过此问题的任何 Shopify 用户的解决方案！我在支持人员的帮助下打开了一个票证请求，这样我也会看到我在那里得到的信息并发回。

\n

Answer 1

好的，这不是一个完整的解决方案，但我会随时更新，并将继续编辑此答案，直到找到完整的解决方案（或者直到有解决方案的人添加答案）。

\n\n

需要白名单/API 端点批准

\n\n

我找到了一个 Shopify API 端点，它应该提供我正在寻找的信息：https ://help.shopify.com/en/api/reference/shopify_ payments/transaction

\n\n

根据 Shopify API 文档，响应应包含费用金额，API 端点为：\n/admin/shopify_payments/balance/transactions.json

\n\n

这将使我得到我所需要的，除了发送正确格式的请求到避免端点给出以下响应：

\n\n

{\n    "errors": "[API] This action requires merchant approval for read_shopify_payments_payouts scope."\n}\n

\n\n

基本上，它似乎需要得到每个商家的批准，这使得它作为一个应用程序对于你们来说并不是理想的解决方案。我请求了该功能，如果它使事情变得更容易（当/如果它被授予我们的帐户），我会添加到此功能。

\n\n

公众获取类似费用数据

\n\n

\n

在使用其他一些端点时，我遇到了这个端点（它是公开的，并且可供应用程序 \xe2\x80\x94 我是合作伙伴/自己开发 Shopify 应用程序），它似乎提供了类似的功能：

\n

\n\n

https://help.shopify.com/en/api/reference/orders/transaction

\n\n

拨打电话时（并收到给定订单 ID 的 "kind": "sale" 结果），我得到以下有趣的 JSON 片段：

\n\n

        "gateway": "shopify_payments",\n        "status": "success",\n

\n\n

更重要的是：

\n\n

"balance_transaction": {\n                    "id": "XXXXXXXXXX",\n                    "object": "balance_transaction",\n                    "amount": 12881,\n                    "available_on": 1553040000,\n                    "created": 1552943224,\n                    "currency": "usd",\n                    "description": "XXXXX@outlook.com",\n                    "exchange_rate": null,\n                    "fee": 339,\n                    "fee_details": [\n                        {\n                            "amount": 339,\n                            "application": "ca_1vQrdCwnvOuC2Ypn5R9whwXkGxb4XJjx",\n                            "currency": "usd",\n                            "description": "Shopify Payments application fee",\n                            "type": "application_fee"\n                        }\n                    ],\n

\n\n

其中 JSON \' 金额；属性对应于发票销售额（包括运费）的十进制自由值。

\n\n

显示"fee": 339为 Shopify Payments 扣除的费用金额（基于附加的 JSON 指示符：description": "Shopify Payments 申请费"）。

\n\n

是的。这就是费用。

\n\n

检查 Shopify 账户等级（在本例中为高级）后，扣除的费用应为：2.4% + 30\xc2\xa2，这意味着总额确实与 \xe2\x80\x94 2.4% * $128.81 = $3.09144 + 30 美分（每笔交易) = 3.39 美元。

\n\n

\n

因此，基本上存在一切（不需要白名单）来为 Shopify Payments 用户获取每个订单的费用金额。这可能还包括向外部网关收取的 Shopify 费用，尽管我不使用外部网关，所以我不能确定。

\n

\n\n

该端点功能意味着 Shopify 费用可能可以添加到与会计系统 \xe2\x80\x94 集成的任何 Shopify 应用程序中，但也意味着如果您正在使用的集成存入发票金额，事后提取费用相对容易到会计中，但不会像我的那样添加与 Shopify 费用 \xe2\x80\x94\xc2\xa0 相关的负行项目。

\n\n

仍然给我留下了一些问题，但至少最初的“我如何找到 Shopify 费用？”问题得到了解决。

\n