OMS接口文档

OMS接口文档


订单发货

<p><strong>简要描述:</strong> </p> <ul> <li>订单发货接口</li> </ul> <p><strong>请求URL:</strong> </p> <ul> <li><code>http://localhost:8080/api/billoperation/apiaction?token=12345678</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>POST </li> </ul> <p><strong>参数:</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">billnum</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>单据编码</td> </tr> <tr> <td style="text-align: left;">action</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>操作类型 tradeshipconfirm</td> </tr> <tr> <td style="text-align: left;">ids</td> <td style="text-align: left;">是</td> <td style="text-align: left;">List</td> <td>需要发货订单id,多张用“,”分隔</td> </tr> <tr> <td style="text-align: left;">partParam</td> <td style="text-align: left;">是</td> <td style="text-align: left;">Map</td> <td>订单-时间戳关系映射</td> </tr> <tr> <td style="text-align: left;">path</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>调用类型 固定值2</td> </tr> <tr> <td style="text-align: left;">externalData</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Map</td> <td>订单支持修改的部分内容</td> </tr> </tbody> </table> <p><strong>externalData 支持修改订单【 快递单号、整单重量】、修改发货明细,非必输</strong></p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">shipdetails</td> <td style="text-align: left;">否</td> <td style="text-align: left;">List<Map></td> <td>实际发货的发货明细,保存后将把原发货明细替换成此发货明细,不需要修改发货明细则不传</td> </tr> </tbody> </table> <p><strong> shipdetails </strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">parentid</td> <td style="text-align: left;">是</td> <td style="text-align: left;">Long</td> <td>订单id</td> </tr> <tr> <td style="text-align: left;">bodyid</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Long</td> <td>表体行id,可不传,后台根据仓库+商品表体匹配</td> </tr> <tr> <td style="text-align: left;">iWarehouseId</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Long</td> <td>仓库id,可不传</td> </tr> <tr> <td style="text-align: left;">itemid</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Long</td> <td>商品skuid,可不传</td> </tr> <tr> <td style="text-align: left;">product</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Long</td> <td>商品id,可不传</td> </tr> <tr> <td style="text-align: left;">skuCode</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Long</td> <td>【SKU编码】 与【itemid/product】 必选其一传递</td> </tr> <tr> <td style="text-align: left;">warehouseCode</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Map</td> <td>【仓库编码】 与【iWarehouseId】 必选其一传递</td> </tr> <tr> <td style="text-align: left;">cshipcode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>发货单号</td> </tr> <tr> <td style="text-align: left;">iquantity</td> <td style="text-align: left;">是</td> <td style="text-align: left;">Bigdacimal</td> <td>数量</td> </tr> <tr> <td style="text-align: left;">sBatchNo</td> <td style="text-align: left;">否</td> <td style="text-align: left;">批号</td> <td>批次存货必传</td> </tr> <tr> <td style="text-align: left;">serialNo</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>序列号</td> </tr> </tbody> </table> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">option</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Map</td> <td>选项参数</td> </tr> </tbody> </table> <p><strong> option </strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">pushFlag</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>发货不校验线上异常状态(如线上已关闭)&quot;true&quot;-不校验 &quot;false&quot;(或不传)-校验</td> </tr> </tbody> </table> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">Modify</td> <td style="text-align: left;">否</td> <td style="text-align: left;">List<Map></td> <td>修改订单的内容 不需要修改则不传</td> </tr> </tbody> </table> <p><strong> Modify </strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">Long</td> <td>订单id</td> </tr> <tr> <td style="text-align: left;">cExpressCode</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>快递单号</td> </tr> <tr> <td style="text-align: left;">cExpressCorp</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>物流网点(快递公司编码)</td> </tr> <tr> <td style="text-align: left;">iweight</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Bigdacimal</td> <td>整单重量</td> </tr> <tr> <td style="text-align: left;">dShipTime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">datetimestring</td> <td>发货时间 yyyy-MM-dd HH:mm:ss格式字符串</td> </tr> </tbody> </table> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">expresslists</td> <td style="text-align: left;">否</td> <td style="text-align: left;">List<Map></td> <td>实际发货的快递明细,传入数据会覆盖原快递明细 不需要修改则不传</td> </tr> </tbody> </table> <p><strong> expresslists </strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">parentid</td> <td style="text-align: left;">是</td> <td style="text-align: left;">Long</td> <td>订单id</td> </tr> <tr> <td style="text-align: left;">cexpresscode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>快递单号</td> </tr> <tr> <td style="text-align: left;">iweight</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Bigdacimal</td> <td>包裹重量,可不传</td> </tr> <tr> <td style="text-align: left;">cweighter</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>称重人,可不传</td> </tr> <tr> <td style="text-align: left;">dweighttime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">date</td> <td>称重时间,可不传</td> </tr> <tr> <td style="text-align: left;">tid</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>交易编号</td> </tr> <tr> <td style="text-align: left;">dshiptime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">date</td> <td>发货时间</td> </tr> <tr> <td style="text-align: left;">cshipcode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>发货单号</td> </tr> <tr> <td style="text-align: left;">whcode</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>实发仓库,只做显示用,编码名称均可</td> </tr> <tr> <td style="text-align: left;">deliverstatus</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>物流状态,只做显示用</td> </tr> <tr> <td style="text-align: left;">skucode</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>实发商品编码,只做显示用</td> </tr> <tr> <td style="text-align: left;">skuname</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>实发商品名称,只做显示用</td> </tr> <tr> <td style="text-align: left;">actualaqty</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>实发数量,只做显示用</td> </tr> <tr> <td style="text-align: left;">define1-10</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>自定义项</td> </tr> </tbody> </table> <p><strong>请求示例</strong></p> <pre><code> { "ids": "1228320612454656", "action": "tradeshipconfirm", "partParam": { "1228320612454656": "2019-06-28 11:04:22" }, "path": "0", "billnum": "ec_tradeorder", "externalData": "{\"option\":{\"pushFlag\":\"true\"},\"shipdetails\":[{\"parentid\":\"1228320612454656\",\"bodyid\":\"0\",\"iWarehouseId\":\"622402136887552\",\"itemid\":\"6932\",\"product\":\"62240213683824\",\"skuCode\":\"0000003140\",\"warehouseCode\":\"YY005\",\"cshipcode\":\"FH10272019020100000005\",\"iquantity\":\"1\",\"sBatchNo\":\"\"}],\"expresslists\":[{\"cexpresscode\":\"0\",\"iweight\":\"1\",\"parentid\":\"1228320612454656\",\"cweighter\":\"2\",\"dweighttime\":\"2011-01-01 00:00:00\",\"tid\":\"11111111\",\"cshipcode\":\"FH10272019020100000005\",\"ismain\":\"1\",\"whcode\":\"001\"}],\"Modify\":[{\"id\":\"1228320612454656\",\"cExpressCode\":\"777777\",\"iweight\":\"7.99\",\"dShipTime\":\"2019-01-01 12:12:12\"}]}" } </code></pre> <p><strong>返回示例</strong> <strong>备注 失败的订单会从data返回</strong></p> <pre><code>{ "code":200, "message":"共0张订单发货成功,失败1张", "data":"[{\"cTradeCode\":\"DSDD99992019040800000009\",\"tid\":\"NewAdd20190408001\",\"total_fee\":70.00000000,\"total_num\":4.00000000,\"refund_num\":0E-8,\"refund_fee\":0E-8,\"discount_fee\":0E-8,\"adjust_fee\":0E-8,\"post_fee\":12.00000000,\"payment\":82.00000000,\"receiver_name\":\"heylm\",\"receiver_state\":\"北京市\",\"receiver_city\":\"海淀区\",\"receiver_district\":\"西北旺地区办事处\",\"cstateid\":6323,\"ccityid\":6433,\"cdistrictid\":6460,\"receiver_address\":\"用友软件园\",\"receiver_mobile\":\"132987911111\",\"receiver_phone\":\"13298793341\",\"created\":1554708088000,\"pay_time\":1554708116000,\"invoice_name\":\"个人\",\"seller_cod_fee\":0E-8,\"buyer_cod_fee\":0E-8,\"cod_fee\":0E-8,\"express_agency_fee\":0E-8,\"has_post_fee\":0,\"trade_memo\":\"手工新增\",\"coupon_fee\":0E-8,\"status\":\"buyers_have_paid\",\"type\":\"4-在线支付\",\"commission_fee\":0E-8,\"available_confirm_fee\":0E-8,\"received_payment\":0E-8,\"cShopID\":1072275670683904,\"sys_Status\":\"shipconfirm\",\"isHold\":1,\"isUpload\":0,\"isCollection\":0,\"isClosed\":0,\"isBlend\":0,\"cExpressCoID\":1116305501147392,\"cExpressCode\":\"805271266490573671\",\"cApproveLog\":\"该店铺未设置免审策略!\",\"isInvoice\":1,\"cShipMode\":\"EnterpriseDeliver\",\"isconfirmed\":0,\"cBizAuditer\":\"AA\",\"dBizAuditTime\":1554948249000,\"isbizaudited\":1,\"cFinAuditer\":\"AA\",\"dFinAuditTime\":1554952064000,\"isfinaudited\":1,\"cshipper\":\"jinyidemotest\",\"dShipTime\":1555308668000,\"cModifier\":\"AA\",\"cShipPrintStatus\":0,\"dshipprinttime\":1554720888000,\"dpickprinttime\":1554720888000,\"dexpressprinttime\":1554720887000,\"iprintsn\":0,\"print_operator\":\"AA\",\"cExcoPrintStatus\":0,\"bCreatePost\":1,\"iEBPlatDiscount\":0E-8,\"cHoldReason\":\"\",\"isPickSelf\":0,\"buyer_payment\":0E-8,\"coupon_point\":0E-8,\"coupon_ticket\":0E-8,\"coupon_card\":0E-8,\"invoice_amount\":0E-8,\"iweight\":0E-8,\"is_sh_ship\":0,\"cshipcode\":\"FH10722019040800000004\",\"cpickcode\":\"DSJH00002019040800000001\",\"cpickrowno\":\"1\",\"ishipprintcount\":6,\"ipickprintcount\":2,\"iexpressprintcount\":6,\"ismainorder\":1,\"ipackagecnt\":1,\"isTradePosted\":0,\"cpickprintstatus\":0,\"iinvoicetype\":\"3\",\"iholdtype\":\"4\",\"cUnApproveReason\":\"其它\",\"iMergeType\":0,\"isSplitTrade\":0,\"srctype\":3,\"order_tax_fee\":0E-8,\"iAutoDistributeBillCount\":3,\"iconverttype\":0,\"has_buyer_message\":0,\"curErrlog\":\"已挂起或已关闭订单不允许进行当前操作\",\"holdtime\":1555309370000,\"sourcestatus\":\"buyers_have_paid\",\"versionguid\":\"bd4c67bb-af40-4c91-ba16-04b720a3df2b\",\"id\":1171593234125056,\"pubts\":1555321435000,\"tenant\":616973480136960,\"org\":3283,\"tradeOrderDetail\":[{\"parentid\":1171593234125056,\"tid\":\"NewAdd20190408001\",\"price\":10.00000000,\"num\":2.00000000,\"discount_fee\":0E-8,\"adjust_fee\":0E-8,\"total_fee\":20.00000000,\"payment\":20.00000000,\"is_service_order\":0,\"citemID\":1161644612620546,\"productID\":1161644612604160,\"post_fee\":0E-8,\"cWhCode\":1147225595121920,\"isGift\":0,\"refund_num\":0E-8,\"refund_fee\":0E-8,\"isInPromotion\":0,\"part_mjz_discount\":0E-8,\"divide_order_fee\":0E-8,\"isPtoSplit\":0,\"bpto\":0,\"bvirtual\":0,\"iorderweight\":0E-8,\"oriItemNum\":0E-8,\"goodtype\":0,\"onsale_num\":0E-8,\"onsale_fee\":0E-8,\"aftersale_num\":0E-8,\"aftersale_fee\":0E-8,\"id\":1171593234141440,\"pubts\":1554708376000,\"org\":3283,\"tenant\":616973480136960},{\"parentid\":1171593234125056,\"tid\":\"NewAdd20190408001\",\"price\":20.00000000,\"num\":1.00000000,\"discount_fee\":0E-8,\"adjust_fee\":0E-8,\"total_fee\":20.00000000,\"payment\":20.00000000,\"is_service_order\":0,\"citemID\":1161646427885824,\"productID\":1161646424363264,\"post_fee\":0E-8,\"cWhCode\":1147225595121920,\"isGift\":0,\"refund_num\":0E-8,\"refund_fee\":0E-8,\"isInPromotion\":0,\"part_mjz_discount\":0E-8,\"divide_order_fee\":0E-8,\"isPtoSplit\":0,\"bpto\":0,\"bvirtual\":0,\"iorderweight\":0E-8,\"oriItemNum\":0E-8,\"goodtype\":0,\"onsale_num\":0E-8,\"onsale_fee\":0E-8,\"aftersale_num\":0E-8,\"aftersale_fee\":0E-8,\"id\":1171593234141441,\"pubts\":1554708376000,\"org\":3283,\"tenant\":616973480136960},{\"parentid\":1171593234125056,\"tid\":\"NewAdd20190408001\",\"price\":30.00000000,\"num\":1.00000000,\"discount_fee\":0E-8,\"adjust_fee\":0E-8,\"total_fee\":30.00000000,\"payment\":30.00000000,\"is_service_order\":0,\"citemID\":1161648188641536,\"productID\":1161648183169280,\"post_fee\":0E-8,\"cWhCode\":1147225595121920,\"isGift\":0,\"refund_num\":0E-8,\"refund_fee\":0E-8,\"isInPromotion\":0,\"part_mjz_discount\":0E-8,\"divide_order_fee\":0E-8,\"isPtoSplit\":0,\"bpto\":0,\"bvirtual\":0,\"iorderweight\":0E-8,\"oriItemNum\":0E-8,\"goodtype\":0,\"onsale_num\":0E-8,\"onsale_fee\":0E-8,\"aftersale_num\":0E-8,\"aftersale_fee\":0E-8,\"id\":1171593234141442,\"pubts\":1554708376000,\"org\":3283,\"tenant\":616973480136960},{\"parentid\":1171593234125056,\"tid\":\"NewAdd20190408001\",\"price\":0E-8,\"num\":0E-8,\"discount_fee\":0E-8,\"adjust_fee\":0E-8,\"total_fee\":0E-8,\"payment\":12.00000000,\"is_service_order\":0,\"citemID\":27532,\"productID\":20630,\"post_fee\":12.00000000,\"isGift\":0,\"refund_num\":0E-8,\"refund_fee\":0E-8,\"isInPromotion\":0,\"part_mjz_discount\":0E-8,\"divide_order_fee\":0E-8,\"isPtoSplit\":0,\"bpto\":0,\"bvirtual\":0,\"iorderweight\":0E-8,\"oriItemNum\":0E-8,\"goodtype\":2,\"onsale_num\":0E-8,\"onsale_fee\":0E-8,\"aftersale_num\":0E-8,\"aftersale_fee\":0E-8,\"id\":1171593234141443,\"pubts\":1554708558000,\"org\":3283,\"tenant\":616973480136960}],\"_convert_tradeOrderDetail\":\"ok\"}]" }</code></pre> <p><strong>返回参数说明</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> </tbody> </table> <p><strong>备注</strong> </p> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML