淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	更多限制	描述
amount	String	可选	28600.0		总金额
ack	Number	可选	0		确认标识 0-未确认，1-已确认
ali_company_name	String	可选	alibaba		公司名称
okki_order_no	String	可选	POMxxxxx		小满订单号
okki_create_time	String	可选	2020-08-01 12:45:00		小满创建时间
ali_cgs	String	可选	122345		阿里客户id
ali_order_no	String	可选	Pxxxxx		阿里订单号
ali_paid_time	String	可选	2020-07-30 12:23:33		阿里支付时间
okki_client_id	String	可选	123		小满客户id
order_product_list	OrderProductList []	可选		最大列表长度：999999	产品列表
standards Standard [] 可选标准产品 └ name String 可选 account 名称 └ count Number 可选 5 数量 └ amount String 可选 28600.0 金额 └ okki_valid_from String 可选 2020-09-01 00:00:00 生效时间 └ type Number 可选 2 类型（1新签/2续约/3追加/4升级） └ okki_order_product_id String 可选 xxxx 小满合同id └ product_name String 可选 OKKI Lite管理软件V1.0 产品名称 └ ali_order_product_id String 可选 xxxx 阿里订单号号 └ duration Number 可选 24 周期（月） └ okki_execute_time String 可选 2020-07-30 12:23:33 小满执行时间 └ is_free Number 可选 0 是否免费（0购买/1赠送） extras Extra [] 可选额外追加 └ name String 可选 account 模块名称 └ count Number 可选 1 模块数量 └ okki_valid_to String 可选 2022-09-01 23:59:59 截止时间 └ original_amount String 可选 28600.0 原价 └ okki_order_refer_ids String 可选 xx,xx,xx 关联合同id └ business_id String 可选 1234 小满业务id └ product_id String 可选 21 产品id ali_discount AliDiscount [] 可选优惠信息 └ ali_order_product_id String 可选 xxx 订单行号 └ amount String 可选 1000 金额 └ remark String 可选经理审批备注 └ okki_append_order_product_id String 可选 POM123_1 追加小满合同号 └ ali_append_order_product_id String 可选 P123213_1 追加阿里合同号 └ promotion_id String 可选 123 订单行促销Id └ extend_fields String 可选 [{'"extend_fields_key'":'"orderPromoteId'",'"extend_fields_value'":'"1,2,3'"},{'" extend_fields_key'":'"b'",'"extend_fields_value'":'"b_1'"}] 拓展信息 └ quotation_item_id String 可选 12222 组合促销中方案行id
refer	String	可选	refer		refer
original_amount	String	可选	28600.0		总原价
trade_no	String	可选	xxxxx		流水号
action	Number	可选	1		操作类型（ 0查询订单价格 1创建订单）
ali_create_time	String	可选	2020-08-01 12:44:50		阿里订单创建时间
ali_discount	AliDiscount []	可选		最大列表长度：999	优惠信息
└ ali_order_product_id String 可选 123 阿里订单行号 └ amount String 可选 1000 优惠金额 └ remark String 可选备注备注
promotion_id	String	可选	21212		促销Id
quotation_id	String	可选	12332		小满报价方案id

名称	类型	示例值	描述
amount	String	28600.0	总价格
ack	Number	0	确认标识 0-未确认，1-已确认
ali_company_name	String	alibaba	阿里公司名称
okki_order_no	String	POMxxxxx	小满单号
okki_create_time	String	2020-08-01 12:45:00	小满单创建时间
ali_cgs	String	122345	阿里客户id
ali_order_no	String	Pxxxxx	阿里订单号
ali_paid_time	String	2020-07-30 12:23:33	阿里支付时间
okki_client_id	String	123	小满客户ID
order_product_list	OrderProductList []		产品列表
standards Standard [] 标准模块 └ name String account 模块名称 └ count Number 5 模块数量 └ amount String 28600.0 价格 └ okki_valid_from String 2020-09-01 00:00:00 生效开始时间 └ type Number 2 类型（1新签/2续约/3追加/4升级） └ okki_order_product_id String xxxx 小满合同号 └ product_name String OKKI Lite管理软件V1.0 产品名称 └ ali_order_product_id String xxxx 阿里订单行号 └ duration Number 24 周期 └ okki_execute_time String 2020-07-30 12:23:33 执行时间 └ is_free Number 0 是否免费（0购买/1赠送） extras Extra [] 追加服务 └ name String account 模块名称 └ count Number 1 模块数量 └ okki_valid_to String 2022-09-01 23:59:59 服务截止时间 └ original_amount String 28600.0 原价 └ okki_order_refer_ids String xx,xx 小满关联合同id └ business_id String 1234 小满业务id └ product_id String 21 产品id ali_discount AliDiscount [] 优惠信息 └ ali_order_product_id String 123 阿里订单行号 └ amount String 1000 优惠金额 └ remark String 经理审批优惠备注 └ ali_append_order_product_id String P123213_1 追加阿里合同号 └ okki_append_order_product_id String POM123213_1 追加小满合同号 └ available_modules String [] 该订单可增购的模块，如“oms” └ quotation_item_id String 123123 小满方案行id
refer	String	refer	refer
success	Boolean	true	请求是否成功
original_amount	String	28600.0	总原价
resp_code	String	0	错误码
trade_no	String	xxxxx	流水号
action	Number	1	操作类型（ 0查询订单价格 1创建订单）
ali_create_time	String	2020-08-01 12:44:50	阿里订单创建时间
resp_msg	String	success	错误原因
ali_discount	AliDiscount []		优惠信息
└ ali_order_product_id String 123 阿里订单行号 └ amount String 1000 优惠金额 └ remark String 备注备注
error_desc	String	error_desc	错误信息
upgrade_product_list	UpgradeProductList []		升级订单
└ product_id String 24 产品id └ product_name String OKKI Lite管理软件V1.0 产品名称 from_product_list FromProductList [] 可升级订单列表 └ product_id String 1 产品id └ product_name String 小满外贸客户管理软件V3.0 产品名称 └ valid_from String 2021-05-31 00:00:00 开始时间 └ valid_to String 2022-05-30 23:59:59 结束时间
discount_information	String	OMS优惠6000元	小满优惠优惠信息
quotation_id	String	123123123	小满报价id

{"amount":"28600.0","quotation_id":"12332","ack":0,"ali_company_name":"alibaba","okki_order_no":"POMxxxxx","promotion_id":"21212","okki_create_time":"2020-08-01 12:45:00","ali_cgs":"122345","ali_order_no":"Pxxxxx","ali_paid_time":"2020-07-30 12:23:33","okki_client_id":"123","order_product_list":[{"amount":"28600.0","okki_order_refer_ids":"xx,xx,xx","okki_valid_from":"2020-09-01 00:00:00","extras":[{"name":"account","count":1}],"promotion_id":"123","type":2,"okki_order_product_id":"xxxx","product_name":"OKKI Lite管理软件V1.0","ali_order_product_id":"xxxx","standards":[{"name":"account","count":5}],"duration":24,"okki_execute_time":"2020-07-30 12:23:33","okki_append_order_product_id":"POM123_1","is_free":0,"okki_valid_to":"2022-09-01 23:59:59","original_amount":"28600.0","product_id":"21","ali_append_order_product_id":"P123213_1","ali_discount":[{"amount":"1000","remark":"经理审批","ali_order_product_id":"xxx"}],"extend_fields":"[{'\"extend_fields_key'\":'\"orderPromoteId'\",'\"extend_fields_value'\":'\"1,2,3'\"},{'\" extend_fields_key'\":'\"b'\",'\"extend_fields_value'\":'\"b_1'\"}]","business_id":"1234","quotation_item_id":"12222"}],"refer":"refer","original_amount":"28600.0","trade_no":"xxxxx","action":1,"ali_discount":[{"amount":"1000","remark":"备注","ali_order_product_id":"123"}],"ali_create_time":"2020-08-01 12:44:50"}

{
    "amount":"28600.0",
    "ack":0,
    "ali_company_name":"alibaba",
    "okki_order_no":"POMxxxxx",
    "okki_create_time":"2020-08-01 12:45:00",
    "ali_cgs":"122345",
    "ali_order_no":"Pxxxxx",
    "ali_paid_time":"2020-07-30 12:23:33",
    "okki_client_id":"123",
    "order_product_list":[
        {
                "standards":[
                    {
                            "name":"account",
                            "count":5
                    }
                ],
                "amount":"28600.0",
                "okki_valid_from":"2020-09-01 00:00:00",
                "type":2,
                "okki_order_product_id":"xxxx",
                "product_name":"OKKI Lite管理软件V1.0",
                "ali_order_product_id":"xxxx",
                "duration":24,
                "okki_execute_time":"2020-07-30 12:23:33",
                "is_free":0,
                "extras":[
                    {
                            "name":"account",
                            "count":1
                    }
                ],
                "okki_valid_to":"2022-09-01 23:59:59",
                "original_amount":"28600.0",
                "okki_order_refer_ids":"xx,xx",
                "business_id":"1234",
                "product_id":"21",
                "ali_discount":[
                    {
                            "ali_order_product_id":"123",
                            "amount":"1000",
                            "remark":"经理审批优惠"
                    }
                ],
                "ali_append_order_product_id":"P123213_1",
                "okki_append_order_product_id":"POM123213_1",
                "quotation_item_id":"123123"
        }
    ],
    "refer":"refer",
    "success":true,
    "original_amount":"28600.0",
    "resp_code":"0",
    "trade_no":"xxxxx",
    "action":1,
    "ali_create_time":"2020-08-01 12:44:50",
    "resp_msg":"success",
    "ali_discount":[
        {
                "ali_order_product_id":"123",
                "amount":"1000",
                "remark":"备注"
        }
    ],
    "error_desc":"error_desc",
    "upgrade_product_list":[
        {
                "product_id":"24",
                "product_name":"OKKI Lite管理软件V1.0",
                "from_product_list":[
                    {
                            "product_id":"1",
                            "product_name":"小满外贸客户管理软件V3.0",
                            "valid_from":"2021-05-31 00:00:00",
                            "valid_to":"2022-05-30 23:59:59"
                    }
                ]
        }
    ],
    "discount_information":"OMS优惠6000元",
    "quotation_id":"123123123"
}

{"success":"不等于true","error_desc":"Illegal request","resp_code":"sign-check-failure"}

错误码	错误描述	解决方案
http-service-unknown-error

错误码查询工具 SDK下载

开放平台

CRM猎户座前台

qimen.alibaba.okki.customer.order.create (ICBU CRM订购小满订单记录同步小满履约)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ