前言
期货报单除了买/卖方向，还要告诉交易所是「开仓」还是「平仓」，部分交易所还要区分平今、平昨。方向对了、开平错了，柜台会拒单。天勤里若用TargetPosTask，开平顺序 largely 由offset_priority和当前get_position自动计算；若手写insert_order，必须自己填offset参数。常见错误包括：空仓发平仓、平今手数超过今仓，或同一合约同时用 task 和insert_order导致状态混乱。
拒单后信息在委托对象的last_msg里，是中文或英文说明文字；status变为FINISHED且volume_left等于原始手数时，常表示完全未成交结束。下面说明字段含义、典型场景、如何用get_position反推该怎么报。
一、名词对照
| 名称 | 在天勤里 |
|---|---|
insert_order | 手写报单函数，参数含 direction、offset |
offset | OPEN、CLOSE、CLOSETODAY 等开平标志 |
TargetPosTask | 自动算开平，用户不直接填 offset |
offset_priority | task 的平今昨开顺序 |
get_position | 持仓对象 |
pos | 净持仓 |
pos_long/pos_short | 多空分列，锁仓要看 |
status | ALIVE=在途，FINISHED=结束 |
volume_left | 未成交手数 |
volume_orign | 原始委托手数 |
last_msg | 柜台状态说明，拒单原因常在此 |
is_error | 是否错单标记，False 也不一定无错 |
二、典型拒单场景
- 无仓却 CLOSE：净
pos为 0 仍发平仓。 - 平今超过今仓：上期所等区分平今平昨，今仓不够。
- 锁仓结构复杂：净 pos 为 0 但
pos_long>0，平今昨判断不同。 - task 与
insert_order混用：官方禁止，易重复或错单。
order=api.get_order(order_id)whileTrue:api.wait_update()ifapi.is_changing(order,"status")orapi.is_changing(order,"last_msg"):iforder.status=="FINISHED"andorder.volume_left==order.volume_orign:handle_reject(order)# 解析 last_msg，勿盲目重报handle_reject内维护「消息关键词 → 动作」表，按团队期货公司文案更新。
三、拒单后先读 position
pos=api.get_position(symbol)# 把策略目标与 pos.pos 对齐，再决定是否 set_target_volume若用TargetPosTask，可set_target_volume(pos.pos)同步 task，再设新目标，避免在错误持仓假设上继续 OPEN。
四、交易所差异（简述）
上期所等：平今、平昨分开，offset_priority重要。中金所等：指令层面不区分平今昨，按先开先平规则，见 task 源码注释。股指平今成本可通过offset_priority="昨开"等方式降低频率，但不能替代正确持仓认知。
总结
开平标志错了，表现就是last_msg里出现资金、持仓、开平相关提示，而volume_left一点没减少。天勤的TargetPosTask适合不想手填 offset 的趋势调仓；手写insert_order则要自己保证 offset 与get_position一致，且勿与 task 混用。把常见 last_msg 整理成表、拒单后先同步持仓再重试，按步骤排查，而不是反复盲报浪费报单额度。
FAQ
1）刚下单 status 为空？
正常，继续wait_update，勿立刻判失败。
2）部分成交算拒单吗？
volume_left部分减少，按部分成交处理。
3）模拟盘文案一样吗？
大体接近，以实盘期货公司为准。
4）task 内部发什么 offset？
由天勤按交易所规则和持仓计算，用户不直接设。
风险提示
以上内容用于报单排查参考，不构成投资建议。
