erpnew/docs/print_count_delta.md

打印次数增量 API

该接口用于为支持 print_count 字段的业务对象递增打印次数。目前支持：

• printing_order → printing.models.PrintingOrder
• plate_order → printing.models.PlateOrder

未来可以在后端枚举中扩展更多对象类型（例如采购单等）。

Endpoint

• Method: POST
• Path: /api/v1/print-count/delta/
• Auth: 需要登录（仅校验是否认证）
• Content-Type: application/json

请求参数

字段	类型	必填	说明
object_type	string	是	对象类型，printing_order 或 plate_order
object_id	integer	是	目标对象的 ID
delta	integer/string	否	增量值，默认 1；若传入小于 1 或无法转换为整数，则自动回退为 1

响应

{
  "object_type": "printing_order",
  "object_id": 12,
  "delta": 3,
  "print_count": 5
}

字段说明：

• delta: 实际生效的增量（若请求非法会改为 1）
• print_count: 更新后的打印次数

错误响应

HTTP 状态码	场景	响应
400	object_type 不受支持	{"detail": "不支持的对象类型"}
404	object_id 与 object_type 匹配的对象不存在	{"detail": "指定对象不存在"}
401	未认证访问	DRF 默认未认证响应

扩展说明

• delta 仅做加法，不提供回退逻辑。
• 所有增量操作在数据库事务中执行，可避免并发更新冲突。
• 新的对象类型只需在后端的 PrintCountObjectType 枚举和映射表中补充即可。