# 外部系统 ↔ 星空 双向同步流程

## 出站（外部系统 → ERP）

```
1. 外部系统落库（本地事务）
2. 组装 KingdeeSaveRequest + Model（Save 前 ExecuteBillQuery 补客户/组织/业务员编码）
3. save → NeedReturnData 回写 fid、分录 EntryId、单据编号
4. submit（状态 D 时先 workflowAudit）
5. 外部库更新 ERP 对照字段
```

失败：回滚本地事务，或失败队列重试（按架构）。

## 入站（ERP → 外部系统）

```
ExecuteBillQuery / View → 映射本地表 → insertOrUpdate
```

## 收款 / 开票（常见）

- **收款**：Push 销售订单 → Save 补 AR_RECEIVEBILL 分录 → submit
- **开票**：Save IV_SALESIC + 分录 Link，可能两次 Save（补扩展字段）

## 配置

默认单 `K3CloudApi` 实例；多组织核对销售/结算组织与组织主数据编码。