Skip to content

docs(dingtalk): 记录 API 带附件发起销售收款确认单与 PB 月包惯例 - #326

Open
keyapi wants to merge 1 commit into
mainfrom
cursor/ce-okf-dingtalk-oa-create-receipt
Open

keyapi wants to merge 1 commit into
mainfrom
cursor/ce-okf-dingtalk-oa-create-receipt

Conversation

@keyapi

@keyapi keyapi commented Nov 2, 2026

Copy link
Copy Markdown
Owner

Summary

  • 把本次对话里「钉钉原生销售收款确认单可用 API 带附件发起」写成独立学习文档:除已有 Workflow.Instance.Write 外还要 Storage.UploadInfo.Read + Storage.File.Write(开完必须发新版);OSS PUT 不能用 urllib 默认 Content-Type;unionId 走旧 topapi/v2/user/get;重交前确认上一张已 TERMINATED。
  • 把 PB 月度钉钉包写成惯例:表单只写各结日一行,不要月合计行;日 CSV 升序后最后挂 PB invoice 合并 YYYYMM.csv(merge_invoices.py);日文件夹须先收进 YYYYMM/。
  • 级联更新 dingtalk_oa_approval / pb_reconciliation 的 handoff、skill、API 参考与 workflow,并跑 update_index.py + check_solutions_health.py --fix/--strict。

单独开 PR,不并入 #297。 #297 是 PB 无货件/建单 + 10/19 摘单丢表头;本 PR 是钉钉 API 发起与月包附件顺序。摘单丢表头正文仍以 #297 为准,这里只交叉引用。

Test plan

  • uv run python scripts/update_index.py(根 index.md 已含两篇新文档)
  • uv run python scripts/check_solutions_health.py --fix 与 --strict(114 篇,孤儿 0)
  • uv run python scripts/check_secrets.py 零命中
  • 评审:公开文档无发起人 userId / 部门 id / 真实审批编号 / 明文凭证
  • 评审:PB 惯例明确「不要月合计行」且指向 merge_invoices.py

- 原生 OA 单可 API 带附件发起(存储权限、OSS PUT、unionId)→ docs/solutions/integration-issues/dingtalk-oa-create-receipt-with-attachments.md
- PB 月度钉钉包:日行 + 日 CSV,月合并只当最后附件、不要月合计行 → docs/solutions/conventions/pb-dingtalk-receipt-monthly-package.md
- 级联登记 handoff / skill / oa-attachment-api / workflow,并同步根目录索引

已同步更新根目录索引。无客户数据/凭证;无隐私外泄。

Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant