金蝶云星辰（自建）连飞书-可视化场景与常见问题
金蝶云星辰（自建）连飞书
一、场景封装
参考文档：OA同步ERP表单要求
| 场景名称 | 分类 | 相关连接器 | 来源单据 | 写入单据 | 流程触发方式 | 触发间隔 | 同步边界 | 同步方式 |
|---|---|---|---|---|---|---|---|---|
| 星辰采购申请单→飞书OA | 单据推送 | 金蝶云星辰（自建）,飞书自建应用 | 星辰采购申请单 | 飞书OA | 消息触发 | 当金蝶单据新增时 | OA同步ERP表单要求 | 仅新增 |
| 星辰付款单→飞书OA | 单据推送 | 金蝶云星辰（自建）,飞书自建应用 | 星辰付款单 | 飞书OA | 消息触发 | 当金蝶单据新增时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰审核 | 单据推送 | 金蝶云星辰（自建）,飞书自建应用 | 飞书OA | 星辰审核 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 星辰采购订单→飞书OA | 单据推送 | 金蝶云星辰（自建）,飞书自建应用 | 星辰采购订单 | 飞书OA | 消息触发 | 当金蝶单据新增时 | OA同步ERP表单要求 | 仅新增 |
| 星辰商品新增→飞书多维表 | 多维表 | 金蝶云星辰（自建）,飞书多维表格 | 星辰商品新增 | 飞书多维表 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰预收款单 | 单据 | 金蝶云星辰（自建）,飞书自建应用 | 飞书OA | 星辰预收款单 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰销售退货单 | 单据 | 飞书自建应用,金蝶云星辰（自建） | 飞书OA | 星辰销售退货单 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰销售报价单 | 单据 | 飞书自建应用,金蝶云星辰（自建） | 飞书OA | 星辰销售报价单 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰销售发票 | 单据 | 金蝶云星辰（自建）,飞书自建应用 | 飞书OA | 星辰销售发票 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰采购申请单 | 单据 | 飞书自建应用,金蝶云星辰（自建） | 飞书OA | 星辰采购申请单 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰采购发票 | 单据 | 金蝶云星辰（自建）,飞书自建应用 | 飞书OA | 星辰采购发票 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰采购入库单 | 单据 | 金蝶云星辰（自建）,飞书自建应用 | 飞书OA | 星辰采购入库单 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰调拨出库单 | 单据 | 金蝶云星辰（自建）,飞书自建应用 | 飞书OA | 星辰调拨出库单 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰移仓单 | 单据 | 飞书自建应用,金蝶云星辰（自建） | 飞书OA | 星辰移仓单 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰生产领料单 | 单据 | 金蝶云星辰（自建）,飞书自建应用 | 飞书OA | 星辰生产领料单 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰生产任务单 | 单据 | 飞书自建应用,金蝶云星辰（自建） | 飞书OA | 星辰生产任务单 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰收款退款单 | 单据 | 飞书自建应用,金蝶云星辰（自建） | 飞书OA | 星辰收款退款单 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰收款单 | 单据 | 金蝶云星辰（自建）,飞书自建应用 | 飞书OA | 星辰收款单 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰收料通知单 | 单据 | 飞书自建应用,金蝶云星辰（自建） | 飞书OA | 星辰收料通知单 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰销售出库单 | 单据 | 飞书自建应用,金蝶云星辰（自建） | 飞书OA | 星辰销售出库单 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰销售订单 | 单据 | 金蝶云星辰（自建）,飞书自建应用 | 飞书OA | 星辰销售订单 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰采购订单 | 单据 | 金蝶云星辰（自建）,飞书自建应用 | 飞书OA | 星辰采购订单 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰商品 | 档案协同 | 飞书自建应用,金蝶云星辰（自建） | 飞书OA | 星辰商品 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰供应商 | 档案协同 | 飞书自建应用,金蝶云星辰（自建） | 飞书OA | 星辰供应商 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰客户 | 档案协同 | 金蝶云星辰（自建）,飞书自建应用 | 飞书OA | 星辰客户 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰职员 | 档案协同 | 金蝶云星辰（自建）,飞书自建应用 | 飞书OA | 星辰职员 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰部门 | 档案协同 | 金蝶云星辰（自建）,飞书自建应用 | 飞书OA | 星辰部门 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
| 飞书OA→星辰凭证 | 凭证 | 金蝶云星辰（自建）,飞书自建应用 | 飞书OA | 星辰凭证 | 消息触发 | OA审批所有人审批通过时 | OA同步ERP表单要求 | 仅新增 |
二、常见问题
大部分金蝶的报错，都可以到社区中搜索，根据别人遇到的问题和解决方案解决客户遇到的问题。OA同步erp表单要求：https://doc.tizdata.com/af/2121；erp同步OA边界：https://doc.tizdata.com/af/1780#4-erp%E5%8D%95%E6%8D%AE%E5%90%8C%E6%AD%A5oa%E7%B3%BB%E7%BB%9F
Q：请求接口返回失败：根据日期获取期间失败？
A：出现在本月的最后一天比较常见，因为erp的期间是按照年月日00：00：00划分的，OA的完成时间一般是年月日时分秒，传递最后一天的时分秒时，系统会认为超过了期间的设置范围。
解决方案：用自定义字段给OA的时间做下格式化，格式化成年月日即可。
Q："fail to upload webapi file!the request was rejected because its size (32114242) exceeds the configured maximum (20971520)？
A：附件超过金蝶的接口限制，金蝶要求单个附件5M，允许传递多个。
Q：账套所属分组不匹配：根据tenant ID找不到租户信息？
A：连接测试星辰授权即可。
Q：一个申请被同步了多次，为什么？
A：a. 场景：OA系统生成erp系统的单据、凭证时，流程日志没有报错，但是单据生成就是重复的。
b. 排查方式：找到日志，查看下日志有没有重新执行过的记录，若没有，则说明客户可能一个表单审批通过，被多个流程执行。
c. 优化：如果目的接口有外部单号，让实施配置上，这样日志会报错，但是数据不会重复；如果没有外部单号，告知客户，数据成功之后不要轻易的点击重新执行，会造成数据重复。
Q：请求接口返回失败：请录入第N行商品批次、生产日期……；这个情况，一样的单子，有的时候可以成功，有的时候成功不了？
A：系统开启了“请选择批次或保质期商品在出库时批次自动填充规则”是“批号顺序出库”；“请选择批次保质期自动填充范围”是“在所有仓库范围内按批次顺序出库、近效期先出”时，创建销售出库单，只要库存足够的情况下，不需要传递报错提示的生产日期、保质期、批次相关的信息；系统当前库存不足的时候则会提示需要传递生产日期等信息。