文档中心 > API类目 > 考拉CRM Api

alibaba.kaola.crm.order.upload (稀范儿小程序保存订单数据)

稀范儿小程序保存订单数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_detail_dto OrderDetailDto 可选 订单详情信息
  • delivery_info
  • DeliveryInfo
  • 可选
  • 收获地址信息
  • └ area
  • String
  • 可选
  • 收件人所在区县
  • 收件人所在区县
  • └ country
  • String
  • 可选
  • 收件人所在国家(中国:"cn")
  • 收件人所在国家(中国:"cn")
  • └ email_address
  • String
  • 可选
  • 收件人邮箱地址
  • 收件人邮箱地址
  • └ province
  • String
  • 可选
  • 收件人所在省
  • 收件人所在省
  • └ phone
  • String
  • 可选
  • 收件人手机/电话号码
  • 收件人手机/电话号码
  • └ city
  • String
  • 可选
  • 收件人所在城市
  • 收件人所在城市
  • └ postal_code
  • String
  • 可选
  • 收件人所在地址邮编
  • 收件人所在地址邮编
  • └ address_line
  • String
  • 可选
  • 收件人具体地址
  • 收件人具体地址
  • └ customer_name
  • String
  • 可选
  • 收件人姓名
  • 收件人姓名
  • skus
  • Sku []
  • 可选
  • 订单SKU
  • └ commission_rate
  • String
  • 可选
  • 0.05
  • 佣金比例,如0.05
  • └ hscode
  • String
  • 可选
  • 税号
  • 税号
  • └ tax_rate
  • String
  • 可选
  • 0.05
  • 税率
  • └ goods_total_tax
  • String
  • 可选
  • 123.234
  • 综合税
  • └ goods_vat
  • String
  • 可选
  • 123.234
  • 增值税
  • └ goods_consumption_tax
  • String
  • 可选
  • 123.234
  • 消费税
  • └ goods_customs_tax
  • String
  • 可选
  • 123.234
  • 关税
  • └ goods_discount_amount
  • String
  • 可选
  • 123.234
  • 优惠总金额
  • └ goods_actual_amount
  • String
  • 可选
  • 123.234
  • 实际付款总金额
  • └ goods_actual_price
  • String
  • 可选
  • 123.234
  • 单价(优惠后)
  • └ goods_price
  • String
  • 可选
  • 123.234
  • 单价(优惠前)
  • └ quantity
  • Number
  • 可选
  • 1
  • 数量
  • └ shop_sku_title
  • String
  • 可选
  • SKU标题
  • SKU标题
  • └ sku
  • String
  • 可选
  • sku编码
  • sku编码
  • └ goods_shipping_fee
  • String
  • 可选
  • 12.21
  • 商品邮费
  • └ goods_cost
  • String
  • 可选
  • 12.2
  • 商品成本金额
  • └ duty_free
  • Boolean
  • 可选
  • true
  • 是否包税
  • └ commission_calc_amount
  • String
  • 可选
  • 12.32
  • 计算佣金金额
  • org
  • Org
  • 可选
  • 订单原始信息
  • └ quantity
  • Number
  • 可选
  • 1
  • 原始数量
  • └ goods_actual_price
  • String
  • 可选
  • 1.00
  • 原始单价(优惠后)
  • └ goods_actual_amount
  • String
  • 可选
  • 1.00
  • 原始实际付款总金额
  • └ goods_discount_amount
  • String
  • 可选
  • 1.00
  • 原始优惠总金额
  • └ goods_customs_tax
  • String
  • 可选
  • 1.00
  • 原始关税
  • └ goods_consumption_tax
  • String
  • 可选
  • 1.00
  • 原始消费税
  • └ goods_vat
  • String
  • 可选
  • 1.00
  • 原始增值税
  • └ goods_total_tax
  • String
  • 可选
  • 1.00
  • 原始综合税
  • └ goods_shipping_fee
  • String
  • 可选
  • 1.00
  • 原始商品邮费
  • └ goods_cost
  • String
  • 可选
  • 1.00
  • 原始商品成本金额
  • └ commission_calc_amount
  • String
  • 可选
  • 1.00
  • 原始佣金计算商品金额
  • rtn_cnl
  • RtnCnl
  • 可选
  • 订单退款信息
  • └ rtn_cnl_time
  • Number
  • 可选
  • 124124
  • 退款时间,时间戳
  • └ quantity
  • Number
  • 可选
  • 2
  • 退款数量
  • └ goods_actual_price
  • String
  • 可选
  • 1.00
  • 退款单价(优惠后)
  • └ goods_actual_amount
  • String
  • 可选
  • 1.00
  • 退款实付金额
  • └ goods_discount_amount
  • String
  • 可选
  • 1.00
  • 退款优惠金额
  • └ goods_customs_tax
  • String
  • 可选
  • 1.00
  • 退款关税金额
  • └ goods_consumption_tax
  • String
  • 可选
  • 1.00
  • 退款消费税
  • └ goods_vat
  • String
  • 可选
  • 1.00
  • 退款增值税
  • └ goods_total_tax
  • String
  • 可选
  • 1.00
  • 退款综合税
  • └ goods_shipping_fee
  • String
  • 可选
  • 1.00
  • 退款商品邮费
  • └ goods_cost
  • String
  • 可选
  • 1.00
  • 退款商品成本金额
  • └ commission_calc_amount
  • String
  • 可选
  • 1.00
  • 退款佣金计算商品金额
  • └ coupon
  • String
  • 可选
  • 12.32
  • 订单优惠,当前币种最小单位(圆)【不包含canceled/return的SKU】
  • └ vat
  • String
  • 可选
  • 234
  • 订单增值税
  • └ order_status
  • String
  • 可选
  • open
  • 系统订单状态,枚举:open(待商家发货),shipped(商家已发货),canceled(销售平台取消成功),oversold(商家履约取消),sign(顾客签收),refund(售后退货), completed(交易成功)
  • └ p_shop_order_id
  • String
  • 可选
  • 父订单号(未拆单的场合与订单号相同)
  • 父订单号(未拆单的场合与订单号相同)
  • └ actual_payment
  • String
  • 可选
  • 1232
  • 订单买家实付金额,当前币种最小单位(圆)【不包含canceled/return的SKU】
  • └ extend_info
  • String
  • 可选
  • 订单扩展属性
  • 订单扩展属性
  • └ customs_tax
  • String
  • 可选
  • 2343.234
  • 订单关税
  • └ total_tax
  • String
  • 可选
  • 343.34
  • 订单综合税 (2位小数) customsTax+consumptionTax+vat
  • buyer_info
  • BuyerInfo
  • 可选
  • 购买人信息
  • └ pay_order_id
  • String
  • 可选
  • 支付企业唯一的支付流水号
  • 支付企业唯一的支付流水号
  • └ pay_type
  • String
  • 可选
  • 11
  • 支付企业名称 枚举:01(支付宝), 02(微信), 03(有赞支付), 04(网易支付), 05(汇付支付)
  • └ pay_id_card_no
  • String
  • 可选
  • 身份证件号码
  • 身份证件号码
  • └ buyer_id
  • String
  • 可选
  • 顾客ID
  • 顾客ID
  • └ pay_name
  • String
  • 可选
  • 真实姓名
  • 真实姓名
  • └ id_card_front_pic
  • String
  • 可选
  • 买家的身份证件正面图片
  • 买家的身份证件正面图片
  • └ id_card_back_pic
  • String
  • 可选
  • 买家的身份证件反面图片
  • 买家的身份证件反面图片
  • └ order_time
  • Number
  • 可选
  • 1622707960919
  • 下单时间(时间戳),格林威治时间
  • └ created_date
  • Number
  • 可选
  • 1622707960919
  • 用户创建时间
  • └ shop_order_id
  • String
  • 可选
  • 订单号
  • 订单号
  • └ shipping_fee
  • String
  • 可选
  • 2343.434
  • 订单运费【不包含canceled/return的SKU】
  • └ modified_date
  • Number
  • 可选
  • 1622707960919
  • 最后修改时间
  • └ modified
  • Number
  • 可选
  • 1622707960919
  • 更新时间(时间戳),格林威治时间
  • └ currency
  • String
  • 可选
  • CNY
  • 订单金额币种:CNY 人民币
  • └ consumption_tax
  • String
  • 可选
  • 34.34
  • 订单消费税
  • └ import_port
  • String
  • 可选
  • 清关口岸
  • 清关口岸
  • └ declaration_mode
  • String
  • 可选
  • 清关模式 枚举: directMail(跨境) CC(个人行邮)
  • 清关模式 枚举: directMail(跨境) CC(个人行邮)
  • └ remark
  • String
  • 可选
  • 订单备注
  • 订单备注
  • └ dutiable_price
  • String
  • 可选
  • 13232.32
  • 订单完税价,当前币种最小单位(圆)注意:订单完税价=订单商品|优惠前|价格总和+运费【不包含canceled/return的SKU】
  • └ app_channel_key
  • String
  • 可选
  • app渠道key
  • app_key
  • order_status_chg_list
  • OrderStatusInfo []
  • 可选
  • 订单状态变化List
  • └ order_status
  • String
  • 可选
  • 1
  • 订单状态
  • └ order_status_time
  • Number
  • 可选
  • 1622707960919
  • 订单状态时间
  • └ order_cost
  • String
  • 可选
  • 323.32
  • 订单成本金额
  • └ order_type
  • String
  • 必须
  • normal
  • 默认 普通normal 预售 presale 定制化订单 customizebal

响应参数

名称 类型 示例值 描述
result Response result result
  • └ msg
  • String
  • msg
  • msg
  • └ code
  • Number
  • code
  • code描述
  • └ data
  • Boolean
  • data
  • data

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaKaolaCrmOrderUploadRequest req = new AlibabaKaolaCrmOrderUploadRequest();
AlibabaKaolaCrmOrderUploadRequest.OrderDetailDto obj1 = new AlibabaKaolaCrmOrderUploadRequest.OrderDetailDto();
AlibabaKaolaCrmOrderUploadRequest.DeliveryInfo obj2 = new AlibabaKaolaCrmOrderUploadRequest.DeliveryInfo();
obj2.setArea("收件人所在区县");
obj2.setCountry("收件人所在国家(中国:\"cn\")");
obj2.setEmailAddress("收件人邮箱地址");
obj2.setProvince("收件人所在省");
obj2.setPhone("收件人手机/电话号码");
obj2.setCity("收件人所在城市");
obj2.setPostalCode("收件人所在地址邮编");
obj2.setAddressLine("收件人具体地址");
obj2.setCustomerName("收件人姓名");
obj1.setDeliveryInfo(obj2);
List<AlibabaKaolaCrmOrderUploadRequest.Sku> list4 = new ArrayList<AlibabaKaolaCrmOrderUploadRequest.Sku>();
AlibabaKaolaCrmOrderUploadRequest.Sku obj5 = new AlibabaKaolaCrmOrderUploadRequest.Sku();
list4.add(obj5);
obj5.setCommissionRate("0.05");
obj5.setHscode("税号");
obj5.setTaxRate("0.05");
obj5.setGoodsTotalTax("123.234");
obj5.setGoodsVat("123.234");
obj5.setGoodsConsumptionTax("123.234");
obj5.setGoodsCustomsTax("123.234");
obj5.setGoodsDiscountAmount("123.234");
obj5.setGoodsActualAmount("123.234");
obj5.setGoodsActualPrice("123.234");
obj5.setGoodsPrice("123.234");
obj5.setQuantity(1L);
obj5.setShopSkuTitle("SKU标题");
obj5.setSku("sku编码");
obj5.setGoodsShippingFee("12.21");
obj5.setGoodsCost("12.2");
obj5.setDutyFree(true);
obj5.setCommissionCalcAmount("12.32");
AlibabaKaolaCrmOrderUploadRequest.Org obj7 = new AlibabaKaolaCrmOrderUploadRequest.Org();
obj7.setQuantity(1L);
obj7.setGoodsActualPrice("1.00");
obj7.setGoodsActualAmount("1.00");
obj7.setGoodsDiscountAmount("1.00");
obj7.setGoodsCustomsTax("1.00");
obj7.setGoodsConsumptionTax("1.00");
obj7.setGoodsVat("1.00");
obj7.setGoodsTotalTax("1.00");
obj7.setGoodsShippingFee("1.00");
obj7.setGoodsCost("1.00");
obj7.setCommissionCalcAmount("1.00");
list6.setOrg(obj7);
AlibabaKaolaCrmOrderUploadRequest.RtnCnl obj9 = new AlibabaKaolaCrmOrderUploadRequest.RtnCnl();
obj9.setRtnCnlTime(124124L);
obj9.setQuantity(2L);
obj9.setGoodsActualPrice("1.00");
obj9.setGoodsActualAmount("1.00");
obj9.setGoodsDiscountAmount("1.00");
obj9.setGoodsCustomsTax("1.00");
obj9.setGoodsConsumptionTax("1.00");
obj9.setGoodsVat("1.00");
obj9.setGoodsTotalTax("1.00");
obj9.setGoodsShippingFee("1.00");
obj9.setGoodsCost("1.00");
obj9.setCommissionCalcAmount("1.00");
list8.setRtnCnl(obj9);
obj1.setSkus(list4);
obj1.setCoupon("12.32");
obj1.setVat("234");
obj1.setOrderStatus("open");
obj1.setPShopOrderId("父订单号(未拆单的场合与订单号相同)");
obj1.setActualPayment("1232");
obj1.setExtendInfo("订单扩展属性");
obj1.setCustomsTax("2343.234");
obj1.setTotalTax("343.34");
AlibabaKaolaCrmOrderUploadRequest.BuyerInfo obj10 = new AlibabaKaolaCrmOrderUploadRequest.BuyerInfo();
obj10.setPayOrderId("支付企业唯一的支付流水号");
obj10.setPayType("11");
obj10.setPayIdCardNo("身份证件号码");
obj10.setBuyerId("顾客ID");
obj10.setPayName("真实姓名");
obj10.setIdCardFrontPic("买家的身份证件正面图片");
obj10.setIdCardBackPic("买家的身份证件反面图片");
obj1.setBuyerInfo(obj10);
obj1.setOrderTime(1622707960919L);
obj1.setCreatedDate(1622707960919L);
obj1.setShopOrderId("订单号");
obj1.setShippingFee("2343.434");
obj1.setModifiedDate(1622707960919L);
obj1.setModified(1622707960919L);
obj1.setCurrency("CNY");
obj1.setConsumptionTax("34.34");
obj1.setImportPort("清关口岸");
obj1.setDeclarationMode("清关模式 枚举: directMail(跨境) CC(个人行邮)");
obj1.setRemark("订单备注");
obj1.setDutiablePrice("13232.32");
obj1.setAppChannelKey("app渠道key");
List<AlibabaKaolaCrmOrderUploadRequest.OrderStatusInfo> list12 = new ArrayList<AlibabaKaolaCrmOrderUploadRequest.OrderStatusInfo>();
AlibabaKaolaCrmOrderUploadRequest.OrderStatusInfo obj13 = new AlibabaKaolaCrmOrderUploadRequest.OrderStatusInfo();
list12.add(obj13);
obj13.setOrderStatus("1");
obj13.setOrderStatusTime(1622707960919L);
obj1.setOrderStatusChgList(list12);
obj1.setOrderCost("323.32");
obj1.setOrderType("normal");
req.setOrderDetailDto(obj1);
AlibabaKaolaCrmOrderUploadResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_kaola_crm_order_upload_response>
    <result>
        <msg>msg</msg>
        <code>code</code>
        <data>data</data>
    </result>
</alibaba_kaola_crm_order_upload_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部