通过订单号检索“ Shopify付款”费用,以便与会计+银行存款进行对帐?

时间:2019-03-19 22:15:21

标签: shopify quickbooks-online xero-api

在一个会计系统中,从运行Shopify Payments(或其他方式)的Shopify商店中存入Shopify用户的银行帐户中的存款似乎是人们经常绊倒的事情之一-根据有关该主题的请求数在Shopify的支持社区论坛上,例如:https://community.shopify.com/c/Shopify-APIs-SDKs/Fees-charged-by-Shopify-via-API/m-p/265261/

(会计方面的)问题是,Shopify Payments在将交易余额存入商店所有者的银行帐户之前会删除“费用金额”(有关费用的完整列表,请参见:https://www.shopify.com/pricing)。

Shopify费用通常类似于2.6% of transaction value + $0.30

根据以上所述计算应收取的费用非常简单(对费用表进行硬编码),直到这些费用在将来的某个时刻发生变化为止。

这如何影响集成?

对于许多可用的简单集成,这会导致打到银行帐户的发票金额与我们根据Shopify发票金额轻松获取的Shopify发票金额“期望”打到银行帐户的金额之间存在差异许多此类解决方案都使用API​​。

这种差异意味着,基于会计的用户有必要手动推断出哪个Shopify发票与哪个收款银行存款相关联-然后手动添加一个负订单项来说明差额/平衡账簿。

  

当被问及他们的客户如何解决上述问题时,这是来自不同会计系统/软件供应商(特别是Xero和Quickbooks )的建议方法。

我知道那里有解决方案,试图解决所有上述问题(取得不同程度的成功),但是由于Kiting的数量,我目前的情况涉及其中的任何一个都无法充分解决以下问题所需的其他功能:我们的业务。

  

我们需要能够找到费用(或自己计算费用)并将这些费用添加到发票中,以便我们的会计系统期望有正确的金额进入我们的银行帐户-因此,问题是:我们如何才能检索经常帐户“ Shopify付款”的费用/费率。

理想情况下,我想避免对这些信息进行硬编码,因为Shopify可能确实会更改费用(可能只有很小的通知),这意味着那时我们的集成会中断。能够通过API请求检索给定帐户的费用明细表会更好,从而避免费用发生变化时出现问题。

我有多个客户也面临相同的问题-所以我认为值得检查是否有人遇到/解决了该问题,并讨论我当前的解决方案

Shopify说什么?

通常,他们的评论是,在回应API请求时,没有包括从发票中扣除的费用的路线图,该请求取自:https://community.shopify.com/c/Shopify-APIs-SDKs/Fees-charged-by-Shopify-via-API/m-p/265261/(这很奇怪)—意思是“不会做”是指功能请求的最佳分类,可以通过简单/随时调用当前可用的API端点来提供此信息。

  

无法按订单获取费用金额,我不确定Shopify商店当前如何与其帐户系统对接。

我很想听听以前可能遇到此问题的任何Shopify用户的解决方案!我在支持下打开了一个票务请求,因此我也将看到返回的内容并发回。

1 个答案:

答案 0 :(得分:0)

好的,所以这不是一个完整的解决方案,但我会不断更新,并将继续编辑此答案,直到找到完整的解决方案(或直到有答案的人添加答案为止)为止。

需要白名单/ API端点批准

我发现了一个Shopify API端点,该端点应该在此处提供我正在寻找的信息:https://help.shopify.com/en/api/reference/shopify_payments/transaction

根据Shopify API文档,响应应包含费用金额,并且API端点为: /admin/shopify_payments/balance/transactions.json

除了将正确格式的请求发送到避免端点会给出以下响应之外,这将完全满足我的需求:

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

基本上,似乎每个商家都需要批准它,因此对于您来说,这不是一个理想的应用程序解决方案。我要求该功能,如果使操作更简单(将其授予我们的帐户),则会添加到此功能。

公开访问类似费用数据

  

在与其他一些端点玩耍时,我遇到了这个端点(该端点是公共的,可用于Apps-我是我的合作伙伴/自行开发Shopify Apps),它似乎提供类似的功能:

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

拨打电话(并收到给定订单ID的“种类”:“销售”结果)时,我得到了以下有趣的JSON片段:

        "gateway": "shopify_payments",
        "status": "success",

,更重要的是:

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

其中JSON'金额;属性对应于发票销售金额(包括运费),为十进制免费值。

"fee": 339似乎指示Shopify Payments扣除的费用金额(基于附加的JSON标识符:description”:“ Shopify Payments申请费用”)。

是的。那就是费用。

在检查Shopify帐户层(在本例中为Advanced)之后,扣除的费用应为:2.4%+ 30¢,这表示总金额匹配— 2.4%* $ 128.81 = $ 3.09144 + 30美分(每笔交易)= $ 3.39。 / p>

  

因此,基本上所有东西都存在(不需要白名单),以便为Shopify Payments用户按订单获取费用金额。这可能还包括向外部网关收取的Shopify费用,尽管我不使用它,所以我不能肯定地说。

该端点功能意味着Shopify Fees可能会添加到与会计系统集成的任何Shopify应用程序中-但也意味着,如果您正在使用的集成将发票金额存入会计,则相对容易插入但不会像我一样添加与Shopify费用相关联的否定订单项。

仍然给我一些问题,但至少是最初的“如何找到Shopify费用?”问题得到解决。