Acumatica REST API如何通过账单参考号查询支票以作废账单

作废账单前必须先作废关联付款（含支票）是Acumatica AP模块的内置校验规则，不需要做自定义开发，直接调用默认Contract-Based REST API即可完成关联查询，具体实现步骤如下：

前置配置 #

• 所有请求使用你实例对应版本的默认系统API端点即可，通用路径前缀为https://<你的Acumatica实例域名>/entity/Default/<端点版本号>，端点版本和你实例版本匹配即可，2019R2及之后版本均支持以下查询逻辑
• 请求头携带认证信息：支持Basic Auth（填集成账号的用户名密码）或Bearer Token认证，统一加Content-Type: application/json头

查询实现 #

你可以根据自己的业务逻辑选任意一种查询方式：

方式1：从账单实体拉取关联支票（逻辑最直观） #

直接查询APBill实体，通过$filter传入目标账单的参考号、账单类型（普通应付账单类型固定为INV，如果是借项调整填ADR，按需匹配），同时用$expand参数拉取关联的付款应用记录，请求示例：

GET https://<你的Acumatica实例域名>/entity/Default/22.200.001/APBill
  ?$filter=ReferenceNbr eq '<目标账单参考号>' and Type eq 'INV'
  &$expand=Applications

返回结果的Applications数组就是该账单关联的所有付款记录：

• 记录中Type字段值为CHQ的条目即为对应支票
• 记录中的ReferenceNbr就是支票编号，结合Type字段可以唯一定位到对应支票实体

注意：如果账单存在合并付款、分期付款场景，数组会返回多笔关联付款，需要全部处理，不能只取第一条。

方式2：直接查询支票实体（适合后续直接做作废操作） #

如果不需要先拉取账单详情，可以直接查询APPayment（支票/付款实体），通过关联应用记录过滤出和目标账单绑定的支票，请求示例：

GET https://<你的Acumatica实例域名>/entity/Default/22.200.001/APPayment
  ?$filter=Applications/any(a: a/ReferenceNbr eq '<目标账单参考号>' and a/DocType eq 'INV')

该请求会直接返回所有匹配的支票实体，拿到实体的id字段或者Type+ReferenceNbr组合键即可直接调用后续作废接口。

作废流程注意事项 #

• 作废支票不要直接做删除操作，调用APPayment实体内置的VoidPayment动作接口即可，请求方式为POST，路径为https://<你的Acumatica实例域名>/entity/Default/<端点版本号>/APPayment/<支票实体id>/VoidPayment，请求体传空JSON对象{}即可
• 必须等支票作废请求执行完成、系统自动生成的冲销分录释放成功后，再调用APBill实体的VoidBill动作作废目标账单，顺序颠倒会触发系统“存在已核销付款记录无法作废”的报错
• 如果查询返回空结果，先登录Acumatica前端确认目标账单是否确实已生成对应支票，排除付款已被提前作废、账单未过账等异常场景

内容的提问来源于stack exchange，提问作者Dipole-Dev