跳转到内容
PlaidCloud

Acumatica: Post Documents 步骤

说明

Section titled “说明”

通过您的 Acumatica 连接，经由 PlaidCloud 共享的 ERP 写入管道将单据过账到 Acumatica。该步骤接收一个标题表（每份单据一行）和一个行表（每份单据一行或多行），并将每份单据过账为 JournalTransaction、SalesInvoice、Bill 或 Payment。Validate Only 会构建并检查每份单据，不占用总账声明，也不过账；可选的结果表会记录每份单据的结果。

配置

Section titled “配置”

连接

Section titled “连接”
  • Acumatica 连接：用于过账的 Acumatica 连接。
  • 环境：该连接的环境。

数据

Section titled “数据”

  • 标题表：每份单据一行：ref（您的单据标识符，必填）、doc_type（JournalTransaction/SalesInvoice/Bill/Payment，必填）、posting_date、party_id（客户/供应商，在单据类型需要时填写）、memo、due_date、branch_id。一个批次可以混合多种单据类型，PlaidCloud 会在过账前按 doc_type 分区。

  • 行表：每个 ref 对应一行或多行，其结构与单据类型相符：

    单据类型 行列
    JournalTransaction account、subaccount、branch、debit、credit
    SalesInvoice item、qty、unit_price、amount
    Bill account、amount
    Payment linked_txn_id、amount

  • 结果表：输出表 ID：每份单据一行，包含 ref、doc_type、natural_key、confirmation_id、status（posted/validated/error）、message。

  • Validate Only：默认选中。仅做预检；不占用总账声明，不过账。完全省略此字段的步骤配置（例如通过 REST API、MCP 或工作流包导入创作的配置）同样默认为 Validate Only，而不是正式过账。

  • 出错时继续：默认选中。某份单据失败后继续过账其余单据；取消选中则在第一次失败时停止批次。

过账的工作方式

Section titled “过账的工作方式”

Acumatica 会将每份单据创建为挂起状态，然后 PlaidCloud 调用释放操作，该操作以异步方式运行：先返回 202 已接受响应，轮询至完成，再由 204 确认释放。只有在通过重新读取单据的挂起标志为 false 确认释放之后，PlaidCloud 才会报告 posted。单据已落地但其释放始终未得到确认时，会保持隔离状态（不报告为已过账，也不会被悄悄丢弃），而不是仅凭单据存在就记录为成功。

能力限制

Section titled “能力限制”
限制 含义
没有原生幂等键 Acumatica 基于 PUT 的写入 API 没有幂等字段。在重试或重新运行时，防止重复过账的唯一保障是 PlaidCloud 自己的总账声明，而不是 Acumatica 端的键。
冲销需手动进行 基于合约的 API 中，没有任何单据类型具备有文档记载的作废/冲销操作。reversal_mode 处处为 NONE：拒绝而不伪造。请直接在 Acumatica 中更正过账有误的单据。
付款没有可靠的查找方式 没有任何有文档记载的字段可在结果不明确后，将付款关联回 PlaidCloud 的请求。存疑的付款会被隔离，等待人工处理，而不是靠猜测。
行项目筛选不在服务器端进行 （导入步骤上的）服务器端筛选器无法触及单据的行项目维度：请在标题/实体级别筛选，并在您的工作流中限定行的范围。

相关内容

Section titled “相关内容”