> For the complete documentation index, see [llms.txt](https://doc.duaer.com/zh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/zh/guides/coupa-purchase-to-pay.md).

# Coupa 采购到付款：每张采购订单卡在哪一步

把 Coupa 接进 Duaer，通过 Coupa Core API 读出每张采购订单经过的请购、收货、发票和付款，看哪里在等、等了多久。
## Duaer 从 Coupa 读出什么？

每张采购订单是一个事项，同时读出供应商、币种和订单金额（各行金额之和）。没有订单号时用订单 ID。步骤是（都按 Coupa 写的日期）：

- 请购（Requisition created）：这张订单来源的请购单的创建日期。
- 下单（Order created）：采购订单的创建日期。
- 收货（Goods received）：这张订单的收货记录的交易日期，作废的不算。
- 发票（Invoice posted）：有行对应到这张订单的发票的发票日期；草稿、作废、放弃和撤回的发票不算。
- 付款（Paid）：这些发票上记录的每笔付款的付款日期。
- 已取消的订单不读。步骤自动对应到采购到付款流程模板，员工端「我的流程」里的采购到付款看板直接可用，见 [流程发现](/zh/build/process-findings.md#purchase-to-pay)。

## 怎么把 Coupa 接进 Duaer？

1. 在 Coupa 里由管理员进入 Setup › Oauth2/OpenID Connect Clients，新建一个客户端，授权方式选 Client credentials，勾选这些读取权限：core.purchase_order.read、core.requisition.read、core.invoice.read、core.inventory.receiving.read。保存后记下 Identifier（客户端 ID）和 Secret。
2. 在 Duaer 里新建“Coupa API”凭证：实例主机名（形如 acme.coupahost.com，不带 https://）、客户端 ID、客户端密钥；权限范围默认就是上面四项，客户端权限不同时再改。
3. 所有者或管理员打开侧边栏「数据来源」，点「添加数据来源」，在「采购到付款」下选 Coupa，选这个凭证，点「检查实例」。客户端读不到的资源会连同状态码列出来。
4. 映射是固定的；预览后设置运行频率和可见范围，确认开始。

## 多久读一次，读多少？

每次运行读两条线，每条最多读一页（Coupa 一页最多 50 条）：按修改时间读采购订单（连同它的请购、收货、发票和付款），按修改时间读发票（连同发票上的付款和这张订单的收货）。付款会改动发票，所以新付款随发票读到。读完一个时间窗口就从它结束的地方接着读；第一次会从头读完全部历史订单和发票，数据多时分多次读完。同一步骤不会重复写入。只读，不往 Coupa 写任何东西。

## 有哪些限制？

- 字段名按 Coupa 公开的 Core API 文档实现，还没有用真实实例验证；第一次真实读取时可能需要调整。
- 收货按订单行所属订单查找，发票按发票行上的订单号查找。实例不支持这些筛选时，Duaer 仍会核对订单，不会把别的订单的收货或发票算进来。
- 审批、变更单、退货和贷项通知单、费用报销、Coupa Pay 虚拟卡暂不读。
## Questions

### Duaer 会改动 Coupa 里的数据吗？

不会。Duaer 只用读取权限调用 Coupa Core API 的查询。

### 能接测试实例吗？

能。填测试实例的主机名（例如 acme-test.coupahost.com）和那个实例里建的客户端即可。

## 相关

- [在 Duaer 里添加流程数据来源](https://doc.duaer.com/zh/build/process-sources.md)
- [在 Duaer 里从数据看出流程，并生成工作流程](https://doc.duaer.com/zh/build/process.md)
- [在 Duaer 里看流程发现和 SOP 符合度](https://doc.duaer.com/zh/build/process-findings.md)
- [SAP S/4HANA 采购到付款：从请购到付款每一步卡在哪](https://doc.duaer.com/zh/guides/sap-s4hana-purchase-to-pay.md)
- [Workday 采购到付款：每张采购订单卡在哪一步](https://doc.duaer.com/zh/guides/workday-purchase-to-pay.md)