Appearance

订单接口文档（order） ​

基本信息 ​

  • 接口地址：/index.php/api
  • 请求方法：POST
  • 接口类型：接收方接口（第三方平台推送 → OMS 接收）
  • 路由参数：method = {app_id}.order.{action}，如：ome.order.add

接口方法列表 ​

接口名方法功能描述
ome.order.addPOST新增/更新订单（依据 lastmodify 与是否存在决定 create/update）
ome.order.status_updatePOST更新订单状态（仅接收作废 dead，版本>1 其他状态不接收）
ome.order.pay_status_updatePOST更新订单支付状态（版本2不走此接口）
ome.order.ship_status_updatePOST更新订单发货状态（版本2不走此接口）
ome.order.custom_mark_addPOST新增订单买家备注
ome.order.custom_mark_updatePOST更新订单买家备注
ome.order.memo_addPOST新增订单商家备注与旗标
ome.order.memo_updatePOST更新订单商家备注与旗标
ome.order.payment_updatePOST更新订单支付方式与金额调整

说明：订单接收报文将由组件进行格式化处理（components：master、items、shipping、consignee、consigner、custommemo、markmemo、marktype、member、tax、booltype）。

系统级参数 ​

参数名类型必填名称描述
flagstring是接入标识固定值 erpapi
app_idstring是应用ID如 ecos.ome
certi_idstring是证书ID系统证书编号
from_node_idstring是来源节点推送方节点ID
node_idstring是目标节点店铺节点ID（OMS节点）
node_typestring是节点类型如 ecos.ome
timestampint是时间戳10位时间戳
methodstring是接口方法名形如 {app_id}.order.add
signstring是签名用于验证请求合法性
formatstring否响应格式可选，默认 json
vstring否API版本如 1.0

签名算法说明 ​

  • 生成公式：sign = strtoupper(md5(strtoupper(md5(assemble($params))). $token))
  • 要点：
    • 参与签名的参数集合不包含 sign 本身；常以键名排序后按约定拼装
    • 首次 md5 后转大写，与 token 拼接后再 md5，最终再转大写
    • 保持编码一致、去除多余空白

接收参数（业务参数） ​

注：订单接收参数较为复杂，且会在组件层进行格式化。下表按实际接收数据字段列出，字段可为 JSON 字符串或对象/数组，组件会自动解码。表格中通过缩进和层级标记区分字段层级：

  • 一级字段：直接字段名
  • 二级字段：parent.field 格式
  • 三级字段：parent.child.field 格式
  • 数组字段：parent[] 或 parent[].field 格式
参数名类型必填说明
订单基础字段
order_bnstring/int是订单号（幂等键的一部分，组件直接赋值）
statusstring是订单状态：active/finish/close/dead 等（组件直接赋值）
pay_statusint/string是支付状态（0=未支付，1=已支付，若为2则自动修正为1；组件根据 payments 计算）
ship_statusint/string否发货状态
lastmodifyint是平台最后修改时间（时间戳），用于决定是否更新；为空则使用当前时间戳
modifiedint否平台修改时间（时间戳，与 lastmodify 同义，优先使用 lastmodify）
total_amountnumber是订单总额（见校验公式；组件直接赋值）
cost_itemnumber是明细原价汇总（组件直接赋值）
pmt_goodsnumber是商品级优惠汇总（>=0；组件直接赋值）
pmt_ordernumber是订单级优惠汇总（>=0；组件直接赋值）
discountnumber是手动调价金额（可为负；组件直接赋值，update 时为空则设0）
cost_taxnumber/string否税额（update 时使用）
cur_amountnumber是当前金额（组件直接赋值）
payednumber是已支付金额（组件根据 payments 计算或直接赋值）
titlestring是订单标题/店铺名称（组件直接赋值）
datestring否订单日期（格式：YYYY-MM-DD HH:mm:ss）
createtimeint是创建时间（时间戳；组件转换为时间戳）
order_sourcestring是订单来源（如 taobao、tmall 等；组件直接赋值）
order_typestring是订单类型：normal/platform/offline/eticket/presale 等（组件直接赋值，默认 normal）
trade_typestring否交易类型：fixed/step 等
t_typestring否订单类型标识（fixed 等，fenxiao 时标记分销位）
currencystring是币种（如 CNY；组件直接赋值，默认 CNY）
cur_ratenumber是汇率（组件直接赋值，默认 1）
source_statusstring是平台订单状态（如 WAIT_SELLER_SEND_GOODS；组件直接赋值）
coupons_namestring是优惠券名称（组件直接赋值）
order_bool_typeint是订单布尔类型标识（组件直接赋值，如分销位、翱象订单等）
change_skustring是换货 SKU（组件直接赋值）
service_pricenumber是服务价格（组件直接赋值，默认 0）
platform_service_feenumber是平台服务费（组件直接赋值，默认 0）
weightstring/number是重量（组件直接赋值）
score_unumber是使用积分（组件直接赋值）
score_gnumber是获得积分（组件直接赋值）
order_limit_timestring/int否订单限时（时间戳或字符串；组件转换为时间戳，为空则使用系统配置）
order_customsstring否定制订单标识（Y 表示定制订单，组件会设置 is_delivery='N'）
custom_abnormal_msgstring否定制订单转换失败消息（定制订单时使用）
custom_transform_statusstring否定制订单转换状态（定制订单时使用）
relate_order_bnstring否关联订单号（组件直接赋值）
platform_order_bnstring是平台订单号（组件直接赋值，默认等于 order_bn）
pay_bnstring是支付方式编码（组件通过 get_payment 获取配置）
paytimeint否支付时间（时间戳；组件根据 payments 计算）
auto_combinebool是是否自动合并（组件直接赋值，默认 true）
is_service_orderstring否是否服务订单（存在时组件直接赋值）
self_deliverystring否是否自提（组件直接赋值）
is_assign_storestring否是否指定仓发货（'true' 时组件直接赋值）
cpup_servicestring否物流升级服务（组件直接赋值）
is_deliverystring否是否允许发货（'N'/'Y'；组件直接赋值，定制订单时强制 'N'）
timing_confirmstring否定时确认（组件直接赋值）
step_trade_statusstring否分阶段交易状态（组件直接赋值）
logistics_infosarray/string否物流信息（JSON 字符串会解码为数组；组件直接赋值）
logistics_service_msgstring否物流服务标签（翱象订单时组件赋值到 promise_service）
cos_idint否组织架构ID（组件直接赋值）
betc_idint否贸易公司ID（组件直接赋值）
is_force_wlbstring否是否强制物流宝（false/true，系统关闭时将拒收）
is_sh_shipstring否是否平台自发（false/true）
is_daixiaostring否是否代销（False/True）
is_ptstring否是否平台（空字符串表示否）
is_yushoustring否是否预售（false/true）
is_errortradestring否是否异常订单（false/true）
is_lgtypestring否是否物流类型（False/True）
is_taxstring否是否开票（false/true，update 时使用；存在强制开票配置时将被覆盖）
tax_nostring否税号（update 时使用）
tax_titlestring否发票抬头（update 时使用）
erpHoldint否ERP 占位标识
signfor_statusint否签收状态
end_timestring/int否买家确认收货时间（字符串将转为时间戳）
memeber_idstring否会员ID（注意拼写）
payer_register_nostring否付款人注册号
buyer_memostring否买家备注
mark_textstring否商家备注文本
mark_typestring否订单旗标类型（如 b0）
custom_markstring否自定义标记
point_feenumber否积分费用
real_point_feenumber否实际积分费用
coupon_feenumber否优惠券费用
credit_card_feestring否信用卡费用
step_paid_feestring否分阶段已付费用
alipay_pointnumber否支付宝积分
errortrade_descstring否异常订单描述
to_node_idint否目标节点ID
node_idint否节点ID（系统级参数，可能重复）
收货人信息（consignee）
consignee[]array是收货人信息
namestring是收货人姓名（组件直接赋值；可能为密文占位符，组件会按 oaid 等附加索引拼接）
mobilestring是收货手机（组件直接赋值；可能追加索引与 hash）
telephonestring是收货座机（组件直接赋值）
addrstring是收货地址（组件直接赋值；清洗换行/引号/反斜杠）
zipstring/int是邮编（组件直接赋值）
area_statestring是省份（组件用于构建 area 字段：省/市/区）
area_citystring是城市（组件用于构建 area 字段）
area_districtstring是区县（组件用于构建 area 字段）
area_streetstring否镇/街道（组件用于构建 area 字段的四级地区，存在时追加到 area）
emailstring是邮箱（组件直接赋值）
r_timestring是收货时间范围（组件直接赋值）
countrystring否国家（组件未直接使用）
买家会员信息（member_info）
member_info[]object是会员信息对象（组件直接传递给 save 方法；member_id 会被 unset）
  unamestring是买家昵称（组件通过 save 方法处理；可能与 buyer_open_uid 结合处理）
  namestring是买家姓名（组件通过 save 方法处理；可能为占位符）
  mobilestring是买家手机（组件通过 save 方法处理）
  telstring是买家座机（组件通过 save 方法处理）
  alipay_nostring是买家支付账号（组件通过 save 方法处理；存在时按规则追加 hash）
  buyer_open_uidstring是买家开放UID（组件通过 save 方法处理；用于加密索引）
  addrstring是买家地址（组件通过 save 方法处理）
  zipstring是买家邮编（组件通过 save 方法处理）
  area_statestring是买家省份（组件通过 save 方法处理）
  area_citystring是买家城市（组件通过 save 方法处理）
  area_districtstring是买家区县（组件通过 save 方法处理）
  emailstring是买家邮箱（组件通过 save 方法处理）
  consigneeobject是收货人信息（组件从 _ordersdf['consignee'] 获取并赋值到 member_info）
  member_idstring否会员ID（组件会 unset 此字段，不传递给 save 方法）
  shop_typestring否店铺类型（组件自动添加，不来自接收参数）
配送信息（shipping）
shipping[]array否配送信息
shipping_namestring否配送方式名称
shipping_idstring否配送方式ID
cost_shippingnumber否运费
cost_protectnumber/string否保价费
is_codstring否是否货到付款（false/true）
is_protectstring否是否保价
支付信息（payinfo）
payinfo[]array否支付信息
pay_namestring否支付方式名称
cost_paymentnumber/string否支付手续费
支付明细（payments[]）
payments[]array否支付明细数组
  trade_noint否交易号
  pay_bnstring否支付单号
  paymethodstring否支付方式
  moneynumber否支付金额
  pay_timestring否支付时间
  pay_accountstring否支付账号
  accountstring否账户
  paycostnumber/string否支付手续费
  bankstring否银行
  memostring否备注
支付明细（兼容老版本 payment_detail）
payment_detail[]array否支付明细信息
paymethodstring否支付方式
pay_accountstring否支付账号
trade_noint否交易号
pay_timeint否支付时间（时间戳）
currencystring否币种
优惠明细（pmt_detail[]）
pmt_detail[]array否优惠明细数组
  pmt_idint否优惠ID
  pmt_describestring否优惠描述
  pmt_amountnumber否优惠金额
  promotion_idstring否促销ID
  kd_discount_feenumber否跨店优惠金额
  kd_child_discount_feestring否跨店子优惠金额
订单明细（order_objects[]）
order_objects[]array是订单明细数组（组件遍历处理）
  bnstring是明细货号（组件用于查找销售物料；超长将截断至 40；若不存在则标记为失败订单）
  oidint是子订单ID（组件用于索引和处理；用于翱象择仓择配等）
  statusstring是明细状态：active/close（组件用于判断是否删除、是否失败订单）
  quantitynumber是明细数量（组件用于计算；为空则默认为 1）
  pricenumber是明细单价（组件用于计算；用于计算 amount、sale_price 等）
  amountnumber是原价小计（组件用于计算；为空则计算为 price*quantity）
  pmt_pricenumber是商品级优惠金额（组件用于计算 sale_price = amount - pmt_price）
  sale_pricestring否销售金额（组件用于计算；若未提供则计算为 amount - pmt_price）
  part_mjz_discountnumber是均摊订单级优惠（组件直接赋值）
  divide_order_feenumber是明细实付（组件直接赋值；用于校验和计算）
  namestring是明细名称（组件直接赋值）
  shop_goods_idint是店铺商品ID（组件直接赋值，用于 order_items）
  shop_product_idint是店铺产品ID（组件用于 order_items 处理）
  weightstring/number是重量（组件直接赋值，可为 0）
  scorestring/number是积分（组件直接赋值，可为 0 或空）
  is_oversoldbool是是否超卖（组件直接赋值，true 转为 1）
  obj_typestring否对象类型：goods/gift/pkg/pko/lkb 等（组件处理，默认 goods）
  obj_aliasstring否对象别名（组件处理，有默认值）
  costnumber否成本（组件处理 order_items 时使用，存在时优先使用）
  store_codestring否仓库编码（组件处理，可能从 channel config 或翱象建议仓获取）
  estimate_con_timestring/int否预计到货时间（组件处理，可从 o2o_info 或对象字段获取）
  product_attrarray否商品属性（组件直接赋值，用于 order_items）
  original_strstring否原始字符串（组件直接赋值）
  promotion_idstring否促销ID（组件直接赋值）
  sku_uuidstring否SKU UUID（组件直接赋值）
  customizationstring否定制信息（组件直接赋值；存在时标记订单为定制订单）
  addonstring/array否扩展信息（组件处理，数组会转为 JSON 字符串）
  gift_midsstring/array否赠品ID（组件处理，统一格式为逗号分隔字符串）
  order_attrobject否订单属性（组件直接赋值，如 esDate）
  order_items[]array是订单购买商品明细
    bnstring是明细项货号
    namestring否明细项名称
    pricenumber否明细项单价
    quantitynumber否明细项数量
    amountnumber否原价小计
    costnumber否成本
    pmt_pricenumber否商品级优惠金额
    sale_pricestring否销售金额
    sale_amountnumber否销售金额（数字）
    part_mjz_discountnumber否均摊订单级优惠
    divide_order_feenumber否明细实付
    item_typestring否明细类型：product/normal/adjunct/gift 等
    statusstring否明细状态：active/close
    shop_product_idint否店铺产品ID
    shop_goods_idint否店铺商品ID
    specIdint否规格ID
    sendnumnumber否已发数量
    adjust_feenumber否调整费用
    original_strstring否原始字符串
    product_attrarray否商品属性（label/value 数组）
    customizationstring否定制信息
    promotion_idstring否促销ID
    estimate_con_timestring否预计到货时间
    zhengji_statusstring否正价状态
    is_sh_shipstring否是否平台自发
    scorestring否积分
    extend_item_list[]object否明细扩展信息
      gov_subsidy_amount_newnumber否政府补贴金额（新）
      use_gov_subsidy_newstring否使用政府补贴（新）
      gov_zhaoshangpistring否政府招商批
      qn_distrstring否千牛分销
      gov_energy_levelstring否政府能级
      gov_main_subjectstring否政府主体
      gov_sn_checkstring否政府序列号校验
  is_sh_shipstring否是否平台自发（组件处理，'true' 转为 'true'，否则 'false'）
  is_daixiaostring否是否代销（组件处理，'true' 时 s_type='dx'，否则 'zx'）
  ship_statusint否发货状态（组件直接赋值）
  pic_pathstring否图片路径（组件未直接使用）
  et_shop_namestring否店铺名称（组件未直接使用）
  logistics_companystring否物流公司（组件未直接使用）
  logistics_codestring否物流单号（组件未直接使用）
  source_statusstring否平台子订单状态（组件未直接使用）
  adjust_feenumber否调整费用（组件未直接使用）
  zhengji_statusstring否正价状态（组件未直接使用）
  is_updatestring否是否更新（update 时使用，'false' 时跳过处理）
  warehouse_idsstring否仓库编码列表（抖音平台；组件直接赋值）
  out_warehouse_idsstring否指定区域仓编码（组件直接赋值）
  authod_idstring否主播ID（组件直接赋值到 author_id）
  author_namestring否主播姓名（组件直接赋值）
扩展字段（extend_field）
extend_field[]object否扩展字段（组件直接赋值，包含 version、consolidate_info 等）
  versionstring否接口版本号（组件赋值到 api_version）
  consolidate_infoobject否集运中转信息（快手平台；组件直接赋值）
  oaidstring否隐私索引ID（用于加密）
  receiver_streetstring否收货街道
  adjust_feenumber否调整费用
  platform_subsidy_feenumber否平台补贴费用
  qn_distrstring否千牛分销
  need_returnobject否需要退货（子订单ID为键）
  is_free_giftarray否是否免费赠品
  shipperarray否发货人信息
  gift_midsarray否赠品ID列表
  is_fqg_s_feearray否是否分钱购费用
  fqg_numarray否分钱购数量
  has_giftarray否是否有赠品
  special_refund_type_infoobject否特殊退款类型信息
  extend_infoobject否扩展信息（如 privacy）
  presentobject否礼品信息（is_present 等）
  gov_subsidy[]object否政府补贴
    gov_subsidy_amount_newnumber否政府补贴金额（新）
    gov_subsidy_amount_exactnumber否政府补贴金额（精确）
    gov_subsidy_amountnumber否政府补贴金额
    use_gov_subsidy_newstring否使用政府补贴（新）
    use_gov_subsidystring否使用政府补贴
    use_gov_predictstring否使用政府预测
    gov_storestring否政府店铺
    gov_sn_checkstring否政府序列号校验
    gov_main_subjectstring否政府主体
  tax_info[]object否税务信息
    s_tariff_feeobject否关税费用（子订单ID为键）
    sub_order_tax_feeobject否子订单税费（子订单ID为键）

金额一致性校验（摘自实现）：total_amount = cost_item + 运费 + 保价费 + 手动调价 + 税金 + 支付手续费汇总 - pmt_goods - pmt_order，并对明细层进行 amount/sale_price/divide_order_fee 等项校验。

响应参数 ​

响应格式统一为 JSON，包含以下字段：

字段名类型必填说明
rspstring是响应状态：succ（成功）或 fail（失败）
msgstring是响应消息（成功时包含操作描述，失败时包含错误信息）
dataobject否响应数据（成功时可能包含订单号等信息，失败时可能包含错误详情）

数据示例 ​

请求示例（新增订单） ​

json
{
    "is_service_order": "",
    "cur_amount": 177,
    "from_node_id": 1388180734,
    "sign": "662E1CD4E92D010C94BDE066F4D31221",
    "app_id": "ecos.ome",
    "trade_from": "WAP",
    "order_limit_time": "",
    "cost_item": 414,
    "modified": 1744364899,
    "pmt_detail": [
        {
            "pmt_id": 2526959714656153600,
            "pmt_describe": "2025春季家装节跨店满减",
            "pmt_amount": 30,
            "kd_child_discount_fee": "",
            "promotion_id": "tbCross-107324892120_2048706900843",
            "kd_discount_fee": 30
        },
        {
            "pmt_id": 2526959714656153600,
            "pmt_describe": "活动价",
            "pmt_amount": 207,
            "kd_child_discount_fee": "",
            "promotion_id": "Tmall$bigMarkdown-107232237641_2063903328379",
            "kd_discount_fee": 207
        }
    ],
    "is_daixiao": "False",
    "cost_tax": "",
    "is_pt": "",
    "lastmodify": 1744364899,
    "title": "天猫工具旗舰店",
    "real_point_fee": 0,
    "o2o_info": {},
    "order_bn": 2526959714656153498,
    "date": "2025-10-11 17:48:22",
    "to_node_id": 1081190530,
    "pmt_goods": 207,
    "order_source": "taobao",
    "score_u": 0,
    "member_info": {
        "tel": "",
        "uname": "c**",
        "area_district": "",
        "area_state": "",
        "addr": "",
        "name": "c**",
        "zip": "",
        "mobile": "",
        "area_city": "",
        "alipay_no": "****",
        "buyer_open_uid": "AAHxuAVrAABxoR0DtQtaQQik",
        "email": ""
    },
    "score_g": 0,
    "tax_title": "",
    "erpHold": 0,
    "signfor_status": 0,
    "mark_text": "",
    "t_type": "fixed",
    "method": "ome.order.add",
    "payed": 177,
    "order_objects": [
        {
            "gift_mids": "",
            "weight": "",
            "is_sh_ship": "",
            "obj_alias": "商品",
            "logistics_company": "",
            "obj_type": "goods",
            "part_mjz_discount": 30,
            "pmt_price": 0,
            "order_attr": {
                "esDate": "2025-10-13"
            },
            "logistics_code": "",
            "score": "",
            "shop_goods_id": 526892359022,
            "price": 138,
            "bn": "887350098396",
            "oid": 2526959714656153600,
            "order_items": [
                {
                    "specId": 526892359022,
                    "part_mjz_discount": 30,
                    "is_sh_ship": "",
                    "cost": 138,
                    "customization": "",
                    "promotion_id": "",
                    "shop_product_id": 5540499848253,
                    "shop_goods_id": 526892359022,
                    "pmt_price": 207,
                    "expand_card_expand_price_used_suborder": 0,
                    "score": "",
                    "sale_price": "",
                    "divide_order_fee": 177,
                    "price": 138,
                    "status": "active",
                    "extend_item_list": {
                        "gov_subsidy_amount_new": 0,
                        "use_gov_subsidy_new": "",
                        "gov_zhaoshangpi": "",
                        "qn_distr": "",
                        "gov_energy_level": "",
                        "gov_main_subject": "",
                        "gov_sn_check": ""
                    },
                    "bn": "887350098396",
                    "original_str": "颜色分类:12V锂电充电器5307",
                    "product_attr": [
                        {
                            "value": "12V锂电充电器5307",
                            "label": "颜色分类"
                        }
                    ],
                    "sendnum": 0,
                    "name": "电动工具12V锂电池1.5Ah/2.0Ah适配12V机器5120",
                    "estimate_con_time": "",
                    "adjust_fee": 0,
                    "sale_amount": 207,
                    "item_type": "product",
                    "amount": 414,
                    "zhengji_status": "",
                    "expand_card_basic_price_used_suborder": 0,
                    "quantity": 3
                }
            ],
            "sale_price": "",
            "et_shop_name": "",
            "divide_order_fee": 177,
            "name": "电动工具12V锂电池1.5Ah/2.0Ah适配12V机器5120",
            "store_code": "",
            "is_oversold": false,
            "adjust_fee": 0,
            "source_status": "WAIT_SELLER_SEND_GOODS",
            "estimate_con_time": "",
            "amount": 414,
            "zhengji_status": "",
            "pic_path": "https://img.alicdn.com/bao/uploaded/46493103.jpg",
            "quantity": 3
        }
    ],
    "payments": [
        {
            "trade_no": 2024002526959714656153498,
            "account": "***on.zh@126.com",
            "pay_time": "2025-10-11 17:48:19",
            "pay_account": "****",
            "paymethod": "支付宝",
            "money": 177,
            "memo": "",
            "pay_bn": "alipay",
            "paycost": "",
            "bank": ""
        }
    ],
    "cn_info": {
        "sign_time": "2025-10-13 23:59:59",
        "es_date": "2025-10-13",
        "trade_attr": {
            "esDate": "2025-10-13",
            "signTime": "2025-10-13 23:59:59",
            "erpHold": 0
        }
    },
    "credit_card_fee": "",
    "step_trade_status": "",
    "coupon_fee": 0,
    "weight": "",
    "cur_rate": 1,
    "is_sh_ship": "false",
    "point_fee": 0,
    "consignee": {
        "telephone": "",
        "area_state": "浙江省",
        "addr": "通*镇**村西三**号",
        "r_time": "~",
        "name": "陈**",
        "zip": 314300,
        "mobile": "***********",
        "country": "",
        "area_city": "嘉兴市",
        "area_district": "海盐县",
        "email": ""
    },
    "is_lgtype": "False",
    "currency": "CNY",
    "trade_type": "fixed",
    "mark_type": "b0",
    "custom_mark": "",
    "payinfo": {
        "pay_name": "支付宝",
        "cost_payment": ""
    },
    "is_force_wlb": "False",
    "order_type": "normal",
    "is_delivery": "",
    "buyer_memo": "",
    "other_list": [
        {
            "type": "unpaid",
            "unpaidprice": ""
        },
        {
            "oid": 2526959714656153498,
            "type": "category",
            "cid": 50006226
        }
    ],
    "pay_status": 1,
    "end_time": "",
    "status": "active",
    "memeber_id": "淘宝工具旗舰店",
    "payer_register_no": "",
    "pmt_order": 30,
    "is_errortrade": "false",
    "discount": 0,
    "node_id": 1388180734,
    "payment_detail": {
        "paymethod": "支付宝",
        "pay_account": "****",
        "trade_no": 2024002526959714656153498,
        "pay_time": 1744364899,
        "currency": "CNY"
    },
    "is_yushou": "false",
    "total_amount": 177,
    "ship_status": 0,
    "extend_field": {
        "need_return": {
            "2526959714656153498": ""
        },
        "is_free_gift": [
            {
                "2526959714656153498": ""
            }
        ],
        "shipper": [
            {
                "2526959714656153498": ""
            }
        ],
        "gift_mids": [
            {
                "2526959714656153498": ""
            }
        ],
        "oaid": "1jMDribia0pmqfcwU4R8Maln2Dxg0RFwWicjeuC4GYcqCW5sqTIgYIwNFpfGmS1ZrulENNMlu",
        "receiver_street": "通元镇",
        "adjust_fee": 0,
        "is_fqg_s_fee": [
            {
                "2526959714656153498": ""
            }
        ],
        "gov_subsidy": {
            "gov_subsidy_amount_new": 0,
            "gov_subsidy_amount_exact": 0,
            "use_gov_subsidy_new": "",
            "gov_store": "",
            "use_gov_subsidy": "",
            "use_gov_predict": "",
            "gov_subsidy_amount": 0,
            "gov_sn_check": "",
            "gov_main_subject": ""
        },
        "special_refund_type_info": {
            "2526959714656153498": ""
        },
        "fqg_num": [
            {
                "2526959714656153498": ""
            }
        ],
        "qn_distr": "",
        "extend_info": {
            "2526959714656153498": {
                "privacy": 1
            }
        },
        "platform_subsidy_fee": 0,
        "tax_info": {
            "s_tariff_fee": {
                "2526959714656153498": ""
            },
            "sub_order_tax_fee": {
                "2526959714656153498": ""
            }
        },
        "has_gift": [
            {
                "2526959714656153498": ""
            }
        ],
        "present": {
            "is_present": false
        }
    },
    "step_paid_fee": "",
    "source_status": "WAIT_SELLER_SEND_GOODS",
    "shipping": {
        "shipping_name": "快递",
        "is_cod": "false",
        "is_protect": "",
        "cost_shipping": 0,
        "cost_protect": "",
        "shipping_id": ""
    },
    "errortrade_desc": "",
    "is_tax": "false",
    "alipay_point": 0,
    "createtime": 1744339314
}

响应示例 ​

响应成功 ​

创建订单成功（ome.order.add）：

json
{
    "rsp": "succ",
    "msg": "返回值：订单创建成功！订单ID：12345",
    "data": {
        "tid": "2526959714656153498"
    }
}

响应失败 ​

创建订单失败（数据为空）：

json
{
    "rsp": "fail",
    "msg": "创建失败：格式化数据为空"
}

业务说明 ​

  • 本接口为接收方，第三方平台推送订单创建、状态/支付/发货等更新至 OMS；幂等建议：method + node_id + order_bn。

错误码定义（示例） ​

  • E_PARAM：参数缺失或格式不正确
  • E_STATE：订单状态不允许当前操作
  • E_DUPLICATE：重复提交/版本未变化
  • E_INTERNAL：内部处理异常