寻求Quickbooks API经验人士指导：如何标记客户日记账分录为已付

要实现类似QuickBooks界面“收到付款”的功能，核心是创建**收款交易（ReceivePayment）**并关联目标日记账分录，通过关联交易（LinkedTxn）建立两者的绑定关系，具体操作步骤如下：

1. 核心逻辑 #

QuickBooks中标记客户相关的日记账分录为已付，本质是生成一笔对应金额的收款记录，并将其与日记账分录绑定，系统会据此识别该分录的应收部分已结清。

2. Retool中配置API调用 #

调用端点 #

使用QuickBooks REST API的ReceivePayment创建接口：

POST /v3/company/{你的CompanyID}/receivepayment

请求体示例 #

替换占位符为你的实际数据（注意金额、ID需精准匹配）：

{
  "CustomerRef": {
    "value": "客户ID"
  },
  "TotalAmt": 10.0,
  "LinkedTxn": [
    {
      "TxnId": "你的日记账分录ID",
      "TxnType": "JournalEntry"
    }
  ],
  "DepositToAccountRef": {
    "value": "对应存款账户ID（比如现金账户）"
  },
  "PaymentRefNum": "自定义付款编号（可选）"
}

参数说明 #

• CustomerRef.value：必须和日记账分录关联的客户ID完全一致
• TotalAmt：和日记账的贷方金额（10美元）完全匹配
• LinkedTxn：指定要关联的日记账分录，TxnType固定为JournalEntry
• DepositToAccountRef：选择款项存入的账户，可在QuickBooks后台获取对应ID

3. 验证结果 #

调用成功后，可通过GET请求查询该日记账分录的详情：

GET /v3/company/{你的CompanyID}/journalentry/{你的日记账分录ID}

在返回的LinkedTxn数组中，若能看到刚才创建的收款交易ID，说明关联成功，日记账分录已被标记为已付。

注意事项 #

• 确保目标日记账分录的行项中包含客户关联（即分录的贷方对应客户应收），否则无法建立关联
• Retool中需提前配置好QuickBooks的API授权，确保请求头包含正确的OAuth凭证
• 若无需实际存款，可选择“暂存”类账户作为DepositToAccountRef

内容的提问来源于stack exchange，提问作者DBAutomized