language:
1、网站的业务流程可以查看官网的新手帮助
http://www.grand-index.com/issue
或者联系客户经理和客服。
2、添加订单前,先通过getShipTypes和getRates接口方法了解运输方式相关信息,
结合客户经理的推荐,选择符合你的最佳运输方式。


分拨中心ID
(Division id)
中文名称
(Chinese name)
英文名称
(English name)
1深圳分公司Shenzhen
2广州分公司Guangzhou
14上海分公司Shanghai
16深圳仓储SZ Warehouse
17海外销售组Huizhou Warehouse
22香港分公司HongKong
23东莞仓储(SFC)DG Warehouse(SFC)
30FBAFBA
31义乌分公司Yiwu
32印度德里仓储IN Warehouse
33龙岗分公司Longgang
34杭州分公司Hangzhou
35番禺分公司PANYU
36印度孟买仓储MENGMAI
37义乌仓储Yiwu Warehouse
40SS
41YY
42EE
43TZTZ


该参数是每个接口的必填参数,详见接口请求示例,全部接口格式一样(如: 获取运输方式列表)
HeaderRequest
字段字段类型是否必填字段描述
appKeystringrequiredSFC 提供给用户的密 钥key
tokenstringrequiredSFC 提供给用户的密 钥token
userIdstringrequired用户 code


请求参数:
字段字段类型是否必填字段描述
HeaderRequestarrayrequired查看头部参数(HeaderRequest)
divisionIdstringoption分拨中心ID,查看分拨中心列表,不填则默认深圳分公司
PHP请求示例
//php示例--获取运输方式列表header('content-type:text/html;charset=utf-8');try{ // 开始请求接口 $client = new SoapClient('http://www.grand-index.com/ishipsvc/web-service?wsdl'); $parameter = array ( //每个接口固定必填参数HeaderRequest 'HeaderRequest' => array ( 'appKey' => 'SFC 提供给用户的密钥 key', 'token' => 'SFC 提供给用户的密钥 token', 'userId' => '用户 code' ), //以下请求参数的名称、类型会根据请求接口不同而不同,并且会有多个请求参数 'divisionId' => '1',//分拨中心ID,不填则默认等于1 (即:深圳分拨中心的ID) ); //请求接口方法getShipTypes $result = $client->getShipTypes($parameter); // 打印接口返回结果 print_r($result); echo '
'; echo $result->shiptypes['0']->cn_name;//获取第一个运输方式的中文名称 }catch(SoapFault $e){ echo $e->getMessage();}
返回参数:
classtypes
字段字段类型字段描述
method_codestring运输方式code
en_namestring运输方式英文名称
Cn_namestring运输方式中文名称
Deliverytimestring递送时间,单位(工作日)。如‘5-14’工作日
iftrackingstring是否可追踪
is_weightstring是否按材积重量计费
PHP返回示例


请求参数:
字段字段类型是否必填字段描述
HeaderRequestarrayrequired查看头部参数(HeaderRequest)
ratesRequestInfoarrayrequired请求信息
ratesRequestInfo
字段字段类型是否必填字段描述
weightstringrequired物品重量 KG
statestringrequired收件州
countrystringrequired收件国家
lengthstringrequired物品长度 CM
widthstringrequired物品宽度 CM
heightstringrequired物品高度 CM
scanTypestringrequired包装类型 1默认 纸箱 2邮袋
priceTypestringrequired价格类型 1默认 用户折扣价格 2公布价
divisionIdstringrequired分拨中心ID,查看分拨中心列表
zip_codestringrequired邮政编码
citystringoption城市
PHP请求示例
//php示例header('content-type:text/html;charset=utf-8');try{ // 开始请求接口 $client = new SoapClient('http://www.grand-index.com/ishipsvc/web-service?wsdl'); $parameter = array ( //每个接口固定必填参数HeaderRequest 'HeaderRequest' => array ( 'appKey' => 'SFC 提供给用户的密钥 key', 'token' => 'SFC 提供给用户的密钥 token', 'userId' => '用户 code' ), //以下请求参数的名称、类型会根据请求接口不同而不同,并且会有多个请求参数 'ratesRequestInfo' => Array ( 'weight' => '0.5', 'state' => 'US', 'country' => 'US', 'length' => '10', 'width' => '10', 'height' => '10', 'scanType' => 1, //包装类型 1默认 纸箱 2邮袋 'priceType' => '',//价格类型 1默认 用户折扣价格 2公布价 'divisionId' => '1', 'zip_code' => '12345', 'city' => 'US' ) ); //请求接口方法名 $result = $client->getRates($parameter); ); // 打印接口返回结果 print_r($result); }catch(SoapFault $e){ echo $e->getMessage();} 
返回参数:
rates
字段字段类型字段描述
totalfeestring总费用
costfeestring基本运费
dealfeestring处理费
addonsstring燃油附加费
deliverytimestring妥投时效
isweightstring是否按材积重量计费
iftrackingstring是否可订单跟踪
classtypestring运输方式分类,平邮,挂号,快递
classtypecodestring运输方式分类的code CPS平邮 CRP挂号 CRE快递 AFE空运
shiptypecodestring运输方式
shiptypenamestring运输方式名称
shiptypecnnamestring运输方式中文名称
isbatterystring是否可以带电
notestring备注
PHP返回示例


请求参数:
字段字段类型是否必填字段描述
HeaderRequestarrayrequired查看头部参数(HeaderRequest)
addOrderRequestInfoarrayrequired订单信息
注意:以下很多字段,比如:投保价值、收件城市、电话 ...... ; 有的运输方式要求必填,有的运输方式非必填,有的运输方式不能填。具体看当前业务
addOrderRequestInfo
字段字段类型是否必填字段描述
customerOrderNostringoption客户参考号
opDivisionintrequired操作分拨中心,查看分拨中心列表
isFbaintoption是否是FBA 0/1
warehouseNamestringoption仓储分拨中心 'FBA','',(MXFBA墨西哥fba用于传'其它私人地址')
orderStatusstringrequired订单状态:confirmed(已确认)、preprocess(预处理)
recipientNamestringrequired收件人
recipientCountrystringrequired收件国家
shippingMethodstringrequired运输方式
subShipTypestringoption运输子方式
trackingNumber1stringoption跟踪号
recipientStatestringoption收件州省
recipientCitystringoption收件城市
recipientAddressstringrequired收件地址
doorplatestringoption门牌号 门牌号信息请和地址信息一起推送到“recipientAddress”字段;【门牌号字段可用渠道:EUEXPIE,EUEXPIEB,EUEXP4,EUEXP6】
smallLangAddressstringoption小语种地址
recipientZipCodestringoption收件邮编
recipientPhonestringoption收件电话
recipientEmailstringoption收件邮箱
recipientOrganizationstringoption收件公司
exportDeclarationintoption是否出口一般贸易报关 0/1
is_Customsintoption是否单独报关 0/1
customeCodestringoption报关单号
isSignatureintoption是否电子签名 0/1
isReturnintoption是否退件 0/1
withBatteryintoption是否带电池 0/1
type_of_batterystringoption电池类型'PI966', 'PI967', 'PI969', 'PI970', '无电池', ''
batteryTypeStrintoption电池类型:默认0/内置电池为1 /配套电池为2 /纯电池为3
fbaNumberstringoption仓储号/FBA号
fbaWarehouseCodestringoption仓储代码
taxTypestringoption税号类型,1(自身税号),2(用SFC税号清关)
taxesNumberstringoption税号
markstringoption税号标注 '',A-Z
salesLinkstringoption销售链接
erp_sourcestringoptionERP来源
shippingWorthstringoption销售价值
dutyforwardintoption关税预付 0/1
codAmountstringoption代收货款金额
goodsDeclareWorthstringrequired总申报价值 float
worthCurrencystringoption总申报价值币种(币种三字简码,默认USD)
evaluatestringoption总投保价值 float(该字段已作废,投保价值数据不予接收!)
goodsWeightstringoption重量 float KG
pieceNumberintoption件数/箱数 int
goodsQuantityintoption订单总数量 int
goodsLengthstringoption订单长度 CM
goodsWidthstringoption订单宽度 CM
goodsHeightstringoption订单高度 CM
goodsDescriptionstringrequired订单描述
shipperAddressTypeintrequired取寄件人默认地址,固定填1
isRemoteConfirmintoption接口是否返回偏远收费提示 0/1
isGetAreaintoption接口是否返回分区区号(如:RM2R-3的3) 0/1
platformCodestringoptionSFC对应的平台订单号
notifyUrlstringoptionSFC对应的的url
ebayIdentifystringoptionSFC对应的EBAY帐号ID
IDCRstringoption身份证号/企业登记号/istore排序号
oriGSTstringoption印度GST/gst编号
oriCompanystringoption印度接口公司
salesPlatformstringoption销售平台
vendor_idstringoptionVendor(供应商)ID
gst_exemption_codestringoptionGSTexemption Code
abnstringoptionABN(进口商)
areaCodestringoption分区打印shipping_desc
postscriptstringoption用于区分义乌两个仓YW2
commonstringoption公用字段(KREXP/KREXPSEA韩国专线用于传个人识别编号或出生年月日;JPEXP日本专线用于传店铺名;KREXPHX用于个人通关编码;TREXPTH用于身份证ID编码;)
iossNostringoptionIOSS号
platformOrderNostringoption平台订单号
invoicestringoption发票号
goodsDetailsarrayrequired物品详情,二维数组,每个子数组对应一个物品,查看下面的goodsDetails
goodsDetails
字段字段类型是否必填字段描述
detailDescriptionstringrequired物品描述/英文描述
detailDescriptionCNstringoption中文描述
detailQuantitystringrequired数量 int
detailWorthstringrequired单个物品申报价
detailCustomLabelstringoption物品参考号/SKU
hsCodestringoption海关编码
detailWeightstringoption重量 KG
originstringoption原产地,默认‘CN’
boxIdintoption包裹号 int
dispositionstringoption销售类型
enMaterialstringoption英文物品材质
cnMaterialstringoption中文物品材质
purposestringoption用途
detailEbayLineIdstringoptioneBay交易行ID
detailEbayTxnIdstringoptionebay交易号
detailEbayItemIdstringoptionebay物品号
detailEbayUserIdstringoptionebay用户buyerID
detailEbayPayDatestringoptionEbay付款时间
detailEbaySoldDatestringoptionEbay卖出日期
ecommerce_idstringoptionAmazon产品代号
priceTagstringoption吊牌价/MRP价值
shelfLifestringoption保质期
PHP请求示例
//php示例header('content-type:text/html;charset=utf-8');try{ // 开始请求接口 $client = new SoapClient('http://www.grand-index.com/ishipsvc/web-service?wsdl'); $parameter = array ( //每个接口固定必填参数HeaderRequest 'HeaderRequest' => array ( 'appKey' => 'SFC 提供给用户的密钥 key', 'token' => 'SFC 提供给用户的密钥 token', 'userId' => '用户 code' ), //以下请求参数的名称、类型会根据请求接口不同而不同,并且会有多个请求参数 'addOrderRequestInfo' => Array ( 'customerOrderNo' => 'ookk' . date('mdhis'), // 客户参考号 'opDivision' => 1, // 操作分拨中心 int 'isFba' => 0, // 是否是FBA 0/1 'warehouseName' => '', // 仓储分拨中心 'FBA','' 'orderStatus' => 'preprocess', // 状态:已确认confirmed/预处理preprocess/已交寄3 'recipientName' => 'tom', // 收件人 'recipientCountry' => 'GB', // 国家 'shippingMethod' => 'TESTEXP', // 主方式 'subShipType' => '', // 子方式 'trackingNumber1' => '', // 跟踪号 'recipientState' => 'zhou', // 州省 'recipientCity' => 'city', // 城市 'recipientAddress' => 'xx addr', // 地址 'doorplate' => '', // 门牌号 'smallLangAddress' => 'small addr', // 小语种地址 'recipientZipCode' => 'W1S 3PR', // 邮编 'recipientPhone' => '1234567890', // 电话 'recipientEmail' => 'qq@qq.com', // 邮箱 'recipientOrganization' => 'company ', // 公司 'exportDeclaration' => 1, // 是否出口一般贸易报关 0/1 'is_Customs' => 1, // 是否单独报关 0/1 'customeCode' => '123ABC', // 报关单号 'isSignature' => 1, // 是否电子签名 0/1 'isReturn' => 1, // 是否退件 0/1 'deliveryType' => 2, // 末端派送类型,默认0 ,1PCP自提,2TRACK卡派 'withBattery' => 1, // 是否带电池 0/1 'type_of_battery' => 'PI966', // 电池类型'PI966', 'PI967', 'PI969', 'PI970', '无电池', '' 'batteryTypeStr' => 0, // 电池类型:默认0/内置电池为1 /配套电池为2 /纯电池为3 'fbaNumber' => 'fba no', // 仓储号/FBA号 'fbaWarehouseCode' => 'fba code', // 仓储代码 'taxType' => '2', // 税号类型,1(自身税号),2(用SFC税号清关) 'taxesNumber' => 'sui hao', // 税号 'mark' => 'A', // 税号标注 '',A-Z 'salesLink' => 'www.html_sfc.com', // 销售链接 'erp_source' => '通途ERP', // ERP来源 'shippingWorth' => '88', // 销售价值 'checkinsurance' => 1, // 是否购买查验保险 0/1 'dutyforward' => 1, // 关税预付 0/1 'codAmount' => '33', // 代收货款金额 'goodsDeclareWorth' => 8, // 总申报价值 float 'worthCurrency'=>'USD', // 申报价值币种,币种三字简码 'evaluate' => 8, // 总投保价值 float(该字段已作废,投保价值数据不予接收!) 'goodsWeight' => 1, // 重量 float 'pieceNumber' => 1, // 件数/箱数 int 'goodsQuantity' => 1, // 订单总数量 int 'goodsLength' => 2, // 长 'goodsWidth' => 2, // 宽 'goodsHeight' => 2, // 高 'goodsDescription' => 'the order desc', // 订单描述 'matchProduct' => 0, // 物品详情是否匹配产品 0/1 'shipperAddressType' => 0, // 是否取寄件人默认地址 0/1 'shipperState' => 'GD', // 寄件人省份 'shipperCity' => 'shenzhen', // 寄件人城市 'shipperCompanyName' => 'send company', // 寄件人公司 'shipperName' => 'tom', // 寄件人 'shipperEmail' => 'ww@ww.com', // 寄件人mail 'shipperAddress' => 'xxx addr', // 寄件人addr 'shipperPhone' => '1234567890', // 寄件人phone 'shipperZipCode' => '12345', // 寄件人邮编 'isRemoteConfirm' => 1, // 接口是否返回偏远收费提示 0/1 'isGetArea' => 1, // 接口是否返回分区区号(如:RM2R-3的3) 0/1 'platformCode' => '', // SFC对应的EBAY平台订单号 'notifyUrl' => '', // SFC对应的EBAY的url 'ebayIdentify' => '', // SFC对应的EBAY帐号ID 'IDCR' => '', // 身份证号/企业登记号/istore排序号 'oriGST' => '', // 印度GST/gst编号 'oriCompany' => '', // 印度接口公司 'salesPlatform' => '', // 销售平台 'vendor_id' => '', // Vendor(供应商)ID 'gst_exemption_code' => '', // GSTexemption Code 'abn' => '', // ABN(进口商) 'areaCode' => '', // 分区打印shipping_desc 'postscript' => '', // 用于区分义乌两个仓YW2 'shippingWorth1' => '', 'goodsDetails' => array ( '0' => Array ( 'detailDescription' => 'en desc', // 物品描述/英文描述 'detailDescriptionCN' => '中文描述', // 中文描述 'detailQuantity' => 2, // 数量 int 'detailWorth' => 4, // 单个物品申报价 'detailCustomLabel' => 'w1', // 物品参考号/SKU 'hsCode' => '01041010', // 海关编码 'detailWeight' => 1, // 重量 'origin' => 'CN', // 原产地 'boxId' => 1, // 包裹号 int 'disposition' => '', // 销售类型 'enMaterial' => 'en eaterial', // 英文物品材质 'cnMaterial' => '中文物品材质', // 中文物品材质 'purpose' => 'en purpose', // 用途 'detailEbayLineId' => '', // eBay交易行ID 'detailEbayTxnId' => 0, // ebay交易号 'detailEbayItemId' => '', // ebay物品号 'detailEbayUserId' => '', // ebay用户buyerID 'detailEbayPayDate' => '', // Ebay付款时间 'detailEbaySoldDate' => '', // Ebay卖出日期 'ecommerce_id' => '', // Amazon产品代号 'priceTag' => '', // 吊牌价/MRP价值 'shelfLife' => '' ) ) // 保质期 ) ); //请求接口方法名 $result = $client->addOrder($parameter); // 打印接口返回结果 print_r($result); }catch(SoapFault $e){ echo $e->getMessage();} 
返回参数:
字段字段类型字段描述
orderCodestringSFC的订单号
customerOrderNostring客户参考号
operatingTimestring操作时间
orderActionStatusstring添加订单结果:Y添加成功、N添加失败(MXEXPFS,MXEXP,MXEXPIP,MXEXPIPB,MXEXPB,MXEXPIE,MXEXPHK客户参考号存在时返回N,同时有返回SFC单号和跟踪号则代表添加成功)
notestring添加失败的原因
alertstring温馨订单提示语
areastring订单分区的区名
trackingNumberstringSFC订单的跟踪号
trackingNumberUspsstringSFC订单的转单号(运输方式为墨西哥MXEXPB时,优先作为跟踪号)
ae_codestringSFC的订单号
PHP返回示例



请求示例:
 https://www.grand-index.com/ishipsvc/http-api?apiName=updateOrderShipType&parameter={ "HeaderRequest":{ "userId":"用户 code", "appKey":"SFC 提供给用户的密钥 key", "token":"SFC 提供给用户的密钥 token" }, "orderCode":"AE订单号", "shipType":"运输方式" }

返回示例:
 { "customerOrderNo": "CTO20211230014632", "status": "1", "msg": "Update sucess.", "orderCode": "SFCAA0029136387YQ", "trackingNumber": "", "trackingNumberUsps": "", "ae_code": "SFCAA0029136387YQ", "time": "2022-12-27 13:23:29" }


请求参数:
字段字段类型是否必填字段描述
HeaderRequestarrayrequired查看头部参数(HeaderRequest)
updateOrderVolumeWeightarrayrequired要修改的订单信息,看下面的updateOrderVolumeWeight
updateOrderVolumeWeight
字段字段类型是否必填字段描述
orderCodestringrequired要修改的订单号
statusstringrequired状态(固定为3)
volumeWeightListarrayrequired要修改订单的重量和长宽高,看下面的volumeWeightList
volumeWeightList
字段字段类型是否必填字段描述
weightstringoption修改物品重量 KG
lengthstringoption修改物品长度 CM
widthstringoption修改物品宽度 CM
heightstringoption修改物品高度 CM
PHP请求示例
'11','length'=>'22','width'=>'33','height'=>'44'); try{ $parameter = array( 'HeaderRequest' => array( 'appKey' => 'SFC 提供给用户的密钥 key', 'token' => 'SFC 提供给用户的密钥 token', 'userId' => '用户 code' ), 'updateOrderVolumeWeight' => Array ( 'orderCode'=>'QA0200701190001', 'status'=>3, 'volumeWeightList'=>$obj ) ); $result=$client->updateOrderVolumeWeight($parameter); //遍历对象集 echo "
"; print_r($result); }catch(SoapFault $e){ print"Sorry an error was caught executing yourrequest:{$e->getMessage()}"; } echo "
"; die("over");?>
返回参数:
字段字段类型字段描述
statusint结果状态:1成功,0失败
msgstring成功提示语或失败原因
orderCodestringSFC的订单号
timestring操作时间
PHP返回示例


请求参数:
字段字段类型是否必填字段描述
HeaderRequestarrayrequired查看头部参数(HeaderRequest)
delOrderRequestInfostringrequired要删除的订单信息,看下面的delOrderRequestInfo
delOrderRequestInfo
字段字段类型是否必填字段描述
orderCodestringrequired单个订单号
PHP请求示例
//php示例header('content-type:text/html;charset=utf-8');try{ /** *开始请求接口, *注意! *这里的url是http://www.grand-index.com/ishipsvc/web-service?wsdl */ $client = new SoapClient('http://www.grand-index.com/ishipsvc/web-service?wsdl'); $parameter = array ( //每个接口固定必填参数HeaderRequest 'HeaderRequest' => array ( 'appKey' => 'SFC 提供给用户的密钥 key', 'token' => 'SFC 提供给用户的密钥 token', 'userId' => '用户 code' ), //以下请求参数的名称、类型会根据请求接口不同而不同,并且会有多个请求参数 'delOrderRequestInfo' => Array ( 'orderCode' =>'QA0200908160..' //订单号 ) ); //请求接口方法名 $result = $client->deleteOrder($parameter); // 打印接口返回结果 print_r($result); }catch(SoapFault $e){ echo $e->getMessage();} 
返回参数:
字段字段类型字段描述
askstring接口请求结果:Success成功、Error失败
messagestring成功/失败描述
PHP返回示例


请求参数:
字段字段类型是否必填字段描述
HeaderRequestarrayrequired查看头部参数(HeaderRequest)
orderCodestringrequired要修改的订单号
updateOrderInfoarrayrequired要修改的订单信息,看下面的updateOrderInfo
updateOrderInfo
字段字段类型是否必填字段描述
orderStatusstringrequired修改状态:preprocess(预处理)、confirmed(已确认)、sumbmitted(已交寄)、intercept(已截件)
authenticatestringrequired验证字段 : md5(‘订单号’+‘用户code’)
weightstringoption修改物品重量 KG
PHP请求示例
//php示例header('content-type:text/html;charset=utf-8');try{ // 开始请求接口 $client = new SoapClient('http://www.grand-index.com/ishipsvc/web-service?wsdl'); $order_code = 'SFC1W1234567890'; // 订单号 $parameter = array ( //每个接口固定必填参数HeaderRequest 'HeaderRequest' => array ( 'appKey' => 'SFC 提供给用户的密钥 key', 'token' => 'SFC 提供给用户的密钥 token', 'userId' => '用户 code' ), //以下请求参数的名称、类型会根据请求接口不同而不同,并且会有多个请求参数 'orderCode' => $order_code, 'updateOrderInfo' => Array ( //'weight' => '', 'orderStatus' => 'confirmed', 'authenticate' => md5($order_code . '用户 code') ) // 单号+客户code ); //请求接口方法名 $result = $client->updateOrderStatus($parameter); // 打印接口返回结果 print_r($result); }catch(SoapFault $e){ echo $e->getMessage();} 
返回参数:
字段字段类型字段描述
askstring接口请求结果:Success成功、Error失败
messagestring成功/失败描述
timestring操作时间
PHP返回示例


请求参数:
字段字段类型是否必填字段描述
HeaderRequestarrayrequired查看头部参数(HeaderRequest)
orderCodestringrequired订单号(或者跟踪号或者客户参考号)
PHP请求示例
//php示例header('content-type:text/html;charset=utf-8');try{ // 开始请求接口 $client = new SoapClient('http://www.grand-index.com/ishipsvc/web-service?wsdl'); $parameter = array ( //每个接口固定必填参数HeaderRequest 'HeaderRequest' => array ( 'appKey' => 'SFC 提供给用户的密钥 key', 'token' => 'SFC 提供给用户的密钥 token', 'userId' => '用户 code' ), //以下请求参数的名称、类型会根据请求接口不同而不同,并且会有多个请求参数 'orderCode' => 'QA0200003090003',//订单号(或者跟踪号或者客户参考号) ); //请求接口方法名 $result = $client->getFeeByOrderCode($parameter); // 打印接口返回结果 print_r($result); }catch(SoapFault $e){ echo $e->getMessage();} 
返回参数:
字段字段类型字段描述
askstring接口请求成功返回‘Success’,请求失败返回‘Error’
sysTimestring接口请求时间
orderCodestring请求订单号
customerOrderNostring客户参考号
msgstring请求失败原因
baseFeestring基本费
regFeestring挂号费
dealFeestring处理费
insurancestring保险费
totalFeestring总运费费用=baseFee+regFee+dealFee+insurance (不包含其他费用)
currencyCodestring币种
chargebackTimestring扣费时间
chargebackWorkDaystring扣费日期(SFC工作日)
shipTypeCodestring运输方式
subShipTypestring运输子方式
waybillCodestring货运单号
discountstring折扣
originBaseFeestring按件处理费
originAddonsstring燃油附加费
stDealFeestring运输方式处理费
stRegFeestring运输方式挂号费
feeWeightstring计费重
realWeightstring订单实重
userUploadWeightstring客户预报重量
otherFeearray其它费和退款赔付费用,如果没费用则不返回,如果只有一个则是一维数组,如果大于一个则是二维数组,看下面的otherFee
otherFee
字段字段类型字段描述
titlestring英文费用名称
cnTitlestring中文费用名称
feestring费用
reasonstring退款原因
PHP返回示例


可根据SFC订单号打印物流标签

URL如下:

http://www.grand-index.com/order/print/index/?orderCodeList=SFC单号&printType=打印类型&isPrintDeclare=1&declare=0&ismerge=1&print_type=标签类型&printSize=标签尺寸

参数说明:

打印类型 0:普通A4 1:热敏
标签类型 pdf或者html
标签尺寸 1:10*10 3:10*15

例如:

http://www.grand-index.com/order/print/index/?orderCodeList=SFC2WA0200909100108&printType=1&isPrintDeclare=1&declare=0&ismerge=1&print_type=pdf&printSize=3


请求参数:
字段字段类型是否必填字段描述
HeaderRequestarrayrequired查看头部参数(HeaderRequest)
searchOrderRequestInfoarrayrequired要搜索的订单信息,查看searchOrderRequestInfo
searchOrderRequestInfo
字段字段类型是否必填字段描述
orderCodestringrequired订单号
PHP请求示例
//php示例header('content-type:text/html;charset=utf-8');try{ // 开始请求接口 $client = new SoapClient('http://www.grand-index.com/ishipsvc/web-service?wsdl'); $parameter = array ( //每个接口固定必填参数HeaderRequest 'HeaderRequest' => array ( 'appKey' => 'SFC 提供给用户的密钥 key', 'token' => 'SFC 提供给用户的密钥 token', 'userId' => '用户 code' ), //以下请求参数的名称、类型会根据请求接口不同而不同,并且会有多个请求参数 'searchOrderRequestInfo' => array('orderCode'=>'WA0200908070006') ); //请求接口方法名 $result = $client->searchOrder($parameter); // 打印接口返回结果 print_r($result); }catch(SoapFault $e){ echo $e->getMessage();} 
返回参数:
orderInfo
字段字段类型字段描述
orderCodestring订单号
customerOrderNostring客户参考号
shipperNamestring寄件人
shipperEmailstring寄件人邮箱
shipperAddressstring寄件人地址
shipperPhonestring寄件人电话
shipperZipCodestring寄件人邮编
shipperCompanyNamestring寄件人公司名
shippingMethodstring运输方式
recipientCountrystring收件国家
recipientNamestring收件人
recipientStatestring收件州省
recipientCitystring收件城市
recipientAddressstring收件地址
recipientZipCodestring收件邮编
recipientPhonestring收件电话
recipientEmailstring收件邮箱
goodsDescriptionstring物品描述
goodsQuantitystring物品数量
goodsDeclareWorthstring物品申报价值
goodsWeightstring物品重量 KG
goodsLengthstring物品长度 CM
goodsWidthstring物品宽度 CM
goodsHeightstring物品高度 CM
orderStatusstring订单状态英文名称
orderStatusCnstring订单状态中文名称
addTimestring订单添加时间
deliveryTimestring订单付款时间
trackNumberstring订单跟踪号
trackNumberUspsstring订单转单号
subShipTypestring订单运输子方式
ae_codestring订单号
goodsDetailsarray所有物品详情,每个子数组为一个物品,看下面的goodsDetails
goodsDetails
字段字段类型字段描述
detailDescriptionstring物品描述
detailQuantitystring物品数量
detailCustomLabelstring物品参考号
detailWorthstring物品价格
PHP返回示例


请求参数:
字段字段类型是否必填字段描述
HeaderRequestarrayrequired查看头部参数(HeaderRequest)
searchTimeOrderRequestInfoarrayrequired要搜索的订单信息,查看searchTimeOrderRequestInfo
searchTimeOrderRequestInfo
字段字段类型是否必填字段描述
startTimestringrequired开始日期Y-m-d
endTimestringrequired结束时间Y-m-d
packagesstringrequired第几页
sizestringoption每页显示多小订单
PHP请求示例
//php示例header('content-type:text/html;charset=utf-8');try{ // 开始请求接口 $client = new SoapClient('http://www.grand-index.com/ishipsvc/web-service?wsdl'); $parameter = array ( //每个接口固定必填参数HeaderRequest 'HeaderRequest' => array ( 'appKey' => 'SFC 提供给用户的密钥 key', 'token' => 'SFC 提供给用户的密钥 token', 'userId' => '用户 code' ), //以下请求参数的名称、类型会根据请求接口不同而不同,并且会有多个请求参数 'searchTimeOrderRequestInfo' => Array ( 'startTime'=>'2019-08-13',//开始日期Y-m-d 'endTime'=>'2019-08-14',//结束时间Y-m-d 'packages'=>'1', //选填,第几页 'size'=>'5', //选填,每页显示多小订单 ) ); //请求接口方法名 $result = $client->searchTimeOrder($parameter); // 打印接口返回结果 print_r($result); }catch(SoapFault $e){ echo $e->getMessage();} 
返回参数:
orderInfo
字段字段类型字段描述
orderCodestring订单号
customerOrderNostring客户参考号
shipperNamestring寄件人
shipperEmailstring寄件人邮箱
shipperAddressstring寄件人地址
shipperPhonestring寄件人电话
shipperZipCodestring寄件人邮编
shipperCompanyNamestring寄件人公司名
shippingMethodstring运输方式
recipientCountrystring收件国家
recipientNamestring收件人
recipientStatestring收件州省
recipientCitystring收件城市
recipientAddressstring收件地址
recipientZipCodestring收件邮编
recipientPhonestring收件电话
recipientEmailstring收件邮箱
goodsDescriptionstring物品描述
goodsQuantitystring物品数量
goodsDeclareWorthstring物品申报价值
goodsWeightstring物品重量 KG
goodsLengthstring物品长度 CM
goodsWidthstring物品宽度 CM
goodsHeightstring物品高度 CM
orderStatusstring订单状态英文名称
orderStatusCnstring订单状态中文名称
addTimestring订单添加时间
deliveryTimestring订单付款时间
trackNumberstring订单跟踪号
trackNumberUspsstring订单转单号
subShipTypestring订单运输子方式
ae_codestring订单号
goodsDetailsarray所有物品详情,每个子数组为一个物品,看下面的goodsDetails
goodsDetails
字段字段类型字段描述
detailDescriptionstring物品描述
detailQuantitystring物品数量
detailCustomLabelstring物品参考号
detailWorthstring物品价格
PHP返回示例


请求参数:
字段字段类型是否必填字段描述
HeaderRequestarrayrequired查看头部参数(HeaderRequest)
startimestringrequired开始时间Y-m-d H:i:s
endtimestringrequired结束时间Y-m-d H:i:s
pagestringoption第几页,每页默认500条记录
PHP请求示例
//php示例header('content-type:text/html;charset=utf-8');try{ // 开始请求接口 $client = new SoapClient('http://www.grand-index.com/ishipsvc/web-service?wsdl'); $parameter = array ( //每个接口固定必填参数HeaderRequest 'HeaderRequest' => array ( 'appKey' => 'SFC 提供给用户的密钥 key', 'token' => 'SFC 提供给用户的密钥 token', 'userId' => '用户 code' ), //以下请求参数的名称、类型会根据请求接口不同而不同,并且会有多个请求参数 'startime'=>'2019-08-01 00:00:00',//开始时间Y-m-d H:i:s 'endtime'=>'2019-08-07 00:00:00',//结束时间Y-m-d H:i:s 'page'=>'1', //选填 ); //请求接口方法名 $result = $client->getFeeByTime($parameter); // 打印接口返回结果 print_r($result); }catch(SoapFault $e){ echo $e->getMessage();} 
返回参数:
字段字段类型字段描述
askstring修改订单结果:Success成功、Error失败
sysTimestring操作时间
msgstring成功提示语或失败原因
pagestring第几页
countstring总记录
dataarray订单费用明细,查看下面的data
data
字段字段类型字段描述
uniqueCodestring
orderCodestring订单号
baseFeestring基本费
regFeestring
dealFeestring处理费
insurancestring
totalFeestring总运费费用=baseFee+regFee+dealFee+insurance (不包含其他费用)
countWeightstring计费重
realWeightstring订单实重
userUploadWeightstring客户预报重量
currencyCodestring币种
chargebackTimestring
chargebackWorkDaystring
subShipTypestring运输子方式
waybillCodestring货运单号
discountstring
originBaseFeestring
originAddonsstring
stDealFeestring
stRegFeestring
waybillStatusstring
PHP返回示例


URL:http://tracking.grand-index.com/tracking/track-api/get-track
请求参数:
字段字段类型是否必填字段描述
datajsonrequired订单跟踪号组成的数组,再转成json(参见请求demo)
PHP请求示例
$curl = curl_init();$track_num_arr = array('UWQ817779901000930307', 'LO971629672CN');$data = json_encode($track_num_arr);curl_setopt_array($curl, array( CURLOPT_URL => "http://tracking.grand-index.com/tracking/track-api/get-track?data=$data", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "GET", CURLOPT_HTTPHEADER => array( "cache-control: no-cache", ),));$response = curl_exec($curl);$err = curl_error($curl);curl_close($curl);if ($err) { echo "cURL Error #:" . $err;} else { echo $response;} 
返回参数:返回值为josn格式
字段字段类型字段描述
codeint0为请求成功,其他为失败
dataarray跟踪信息
data
字段字段类型字段描述
numberstring请求单号
customer_order_codestring客户单号
ship_typestring渠道代码
destinationstring目的地国家
statusstring订单状态(1 运输途中;2 运输过久;3 完成;4 退件返回完成;5 到达待取;6 等待揽收;7 SFC处理中;)
trackarray每个单号的具体信息
track
字段字段类型字段描述
change_datestring跟踪时间
ti_notestring跟踪信息
ti_addressstring地点
codestring节点代码(部分渠道返回)
节点代码对照表(点击下载)
PHP返回示例


请求参数:
字段字段类型是否必填字段描述
HeaderRequestarrayrequired查看头部参数(HeaderRequest)
dataarrayrequired查看下面的data
data
字段字段类型是否必填字段描述
company_namestringrequired快递公司
package_idstringrequired快递单号
sfc_numberintrequiredSFC包裹数量
receipt_numberstringoption国内快递发货件数
receipt_weightstringoption国内快递发货重量 KG
user_remarkstringoption备注
PHP请求示例
//php示例header('content-type:text/html;charset=utf-8');try{ // 开始请求接口 $client = new SoapClient('http://www.grand-index.com/ishipsvc/web-service?wsdl'); $parameter = array ( //每个接口固定必填参数HeaderRequest 'HeaderRequest' => array ( 'appKey' => 'SFC 提供给用户的密钥 key', 'token' => 'SFC 提供给用户的密钥 token', 'userId' => '用户 code' ), //以下请求参数的名称、类型会根据请求接口不同而不同,并且会有多个请求参数 'data' => array ( 'company_name' => 'xxx物流有限公司', //快递公司 'package_id' => '1234567890', //快递单号 'sfc_number' => '2', //SFC包裹数量 'receipt_number' => '', //国内快递发货件数 'receipt_weight' => '2.15', //国内快递发货重量 'user_remark' => '测试新建国内快递交货单',//备注 ) ); //请求接口方法名 $result = $client->createExpressWaybill($parameter); // 打印接口返回结果 print_r($result); }catch(SoapFault $e){ echo $e->getMessage();} 
返回参数:
obj
字段字段类型字段描述
statusint接口状态:0失败,1成功
msgstring接口成功描述/失败原因
PHP返回示例


apiName=getShipTypes&parameter={"HeaderRequest":{"userId":"","appKey":"","token":""},"divisionId":"2"} [{"method_code":"TESTEXP","en_name":"TESTEXP","cn_name":"测试专用渠道","deliverytime":"7.0-10.0","iftracking":"YES","is_weight":"NO"}] apiName=getRates&parameter={"HeaderRequest":{"appKey":"","token":"","userId":""},"ratesRequestInfo":{"weight":"0.5","state":"US","country":"US","length":"10","width":"10","height":"10","priceType":"","divisionId":"1","zip_code":"12345"}} {"rates":[{"totalfee":"0.010000","costfee":"0.000000","dealfee":"0.000000","regfee":"0.000000","addons":"0.000000","deliverytime":"7-10","isweight":"NO","iftracking":"YES","classtype":"China Express Mail","classtypecode":"CRE","shiptypecode":"TESTEXP","shiptypename":"TESTEXP","shiptypecnname":"测试专用渠道","isbattery":"NO","currency":"RMB"},{"totalfee":"1.000000","costfee":"0.000000","dealfee":"0.000000","regfee":"0.000000","addons":"0.000000","deliverytime":"7-10","isweight":"YES","iftracking":"YES","classtype":"","classtypecode":"AFE","shiptypecode":"USEXP","shiptypename":"USEXP","shiptypecnname":"美国专线大货","isbattery":"YES","currency":"RMB"}]} apiName=updateOrderVolumeWeight&parameter={"HeaderRequest":{"appKey":"","token":"","userId":""},"updateOrderVolumeWeight":{"orderCode":"QXXXX010160039","status":3,"volumeWeightList":{"weight":"11","length":"22","width":"33","height":"44"}}} {"status":1,"msg":"Update success","orderCode":"QXXXX010160039","time":"2020-12-29 15:44:19"} apiName=addOrder&parameter={"HeaderRequest":{"appKey":"","token":"","userId":""},"addOrderRequestInfo":{"opDivision":"1","is_Customs":"1","orderStatus":"Confirmed","customerOrderNo":"C23O20210104024423","trackingNumber1":"GZH20210104024423","isSignature":"0","dutyforward":"1","shipperAddressType":"1","shipperName":"李先生","shipperEmail":"jonneyjs_wang@163.com","shipperAddress":"A5 Country Lane, 71 Dorset Road, Parkwood","shipperPhone":"520-709-3774","shipperZipCode":"2193","shipperCompanyName":"Yirishe Co","shipperCity":"\tJohannesburg","recipientCity":"villegly","recipientState":"AC","recipientCompanyName":"","shippingMethod":"STKYW437","priceTag":"1","esbNumber":"23131232","subShipType":"","recipientCountry":"SINGAPORE","recipientName":"asdasd","recipientAddress":"Billtalstr.60","recipientZipCode":"\t65843","recipientPhone":"13546587458","recipientEmail":"","goodsDescription":"car","goodsQuantity":"1","goodsDeclareWorth":"5","recipientOrganization":"DFSDFSDF","ebayIdentify":"1111111","withBattery":"1","isReturn":"1","orderNote":"1","taxesNumber":"12345678901","mark":"","isRemoteConfirm":"1","evaluate":"","checkinsurance":"1.57","shippingWorth":"","goodsWeight":"1","salesLink":"","goodsLength":"","goodsWidth":"","goodsHeight":"","isFba":"0","type_of_battery":"Pi966","IDCR":"45345","exportDeclaration":"","codAmount":"22","vendor_id":"","gst_exemption_code":"","abn":"","pieceNumber":"1","salesPlatform":"","detailEbayLineId ":"1","warehouseName":"1","batteryTypeStr":"","goodsDetails":[{"ecommerce_id":"545633646","detailDescription":"Obama12asd3321","detailQuantity":"5","detailCustomLabel":"2123203215783278","detailWorth":"1","priceTag":"5","detailEbayPayDate":"0000-00-00 00:00:00","detailWeight":"0.31","detailEbayTxnId":"11111","detailEbayItemId":"11111","detailEbaySoldDate":"0000-00-00 00:00:00","detailDescriptionCN":"那你就","hsCode":"9503001000","enMaterial":"1ff","cnMaterial":"1看看","boxId":"10"}]}} {"orderCode":"SFC1WXXXX012290004","customerOrderNo":"C23O20201229074731","operatingTime":"2020-12-29 15:47:35","orderActionStatus":"Y","note":"","alert":"","trackingNumber":"VR389128587YP","ae_code":"SFC1WXXXX012290004"} apiName=deleteOrder&parameter={"HeaderRequest":{"appKey":"","token":"","userId":""},"delOrderRequestInfo":{"orderCode":"QXXXX010160039"}} {"ask":"Error","message":"Order does not exist"} apiName=updateOrderStatus&parameter={"HeaderRequest":{"appKey":"","token":"","userId":""},"orderCode":"QXXXX010160039","updateOrderInfo":{"orderStatus":"confirmed","authenticate":"49b75953d80380f63cef23c0c5cd27a6"}} {"ask":"Error","message":"update orders status is incorrect","time":"2020-12-29 16:14:42"} apiName=getFeeByOrderCode&parameter={"HeaderRequest":{"appKey":"","token":"","userId":""},"orderCode":"QXXXX009250020"} {"ask":"Error","sysTime":"2020-12-29 16:21:57","orderCode":"QXXXX009250020","msg":"can not find order fee."} apiName=searchOrder&parameter={"HeaderRequest":{"appKey":"","token":"","userId":""},"searchOrderRequestInfo":{"orderCode":"WXXXX010090004"}} {"orderInfo":{"orderCode":"WXXXX010090004","customerOrderNo":"CTO20201009111243","shippingMethod":"STEXPMPD","shipperName":"fajianrenxm","shipperEmail":"564565464@123.com","shipperAddress":"yuangzhengdaxia","shipperPhone":"1234567899","shipperZipCode":"123456","shipperCompanyName":"","recipientCountry":"Germany","recipientName":"Prowo e.V.","recipientState":"Berlin","recipientCity":"Berlin","recipientAddress":"Niedrigschwelliger Wohnverbund Scharnweber Str. 29","recipientZipCode":"10247","recipientPhone":"01781443904","recipientEmail":"sfctracking@suntekcorps.com","goodsDescription":",Soap Dispenser","goodsQuantity":"5","goodsDeclareWorth":"15.00","goodsWeight":"0.000","goodsLength":"0.00","goodsWidth":"0.00","goodsHeight":"0.00","trackNumber":"","trackNumberUsps":"","addTime":"2020-09-14 23:59:59","deliveryTime":"0000-00-00 00:00:00","sendTime":"0000-00-00","orderStatus":"Confirmed","orderStatusCn":"\u5df2\u786e\u8ba4","subShipType":"","goodsDetails":[{"detailDescription":"Soap Dispenser","detailQuantity":"5","detailCustomLabel":"YXY200603002[B07C96-61]","detailWorth":"3.00"}],"area":"5","ae_code":"SFC3WXXXX010090004"}} apiName=searchTimeOrder&parameter={"HeaderRequest":{"appKey":"","token":"","userId":""},"searchTimeOrderRequestInfo":{"startTime":"2020-09-7","endTime":"2020-09-7","package":"1","size":"100"}} {"orderInfo":[{"orderCode":"QXXXX012300008","customerOrderNo":"","shippingMethod":"CHEXP","shipperName":"fajianrenxm","shipperEmail":"564565464@123.com","shipperAddress":"yuangzhengdaxia","shipperPhone":"1234567899","shipperZipCode":"123456","shipperCompanyName":"gongsi","recipientCountry":"Chile","recipientName":"FASDFA","recipientState":"Arica y Parinacota","recipientCity":"ARICA","recipientAddress":"ASDFASD ","recipientZipCode":"","recipientPhone":"86076922251394","recipientEmail":"","goodsDescription":"ASDFAS","goodsQuantity":"1","goodsDeclareWorth":"31.00","goodsWeight":"1.000","goodsLength":"1.00","goodsWidth":"1.00","goodsHeight":"1.00","trackNumber":"","trackNumberUsps":"","addTime":"2020-12-30 14:31:02","deliveryTime":"2020-12-30 14:36:59","sendTime":null,"orderStatus":"Received","orderStatusCn":"已收货","subShipType":"","goodsDetails":[{"detailDescription":"ASDFAS","detailQuantity":"1","detailCustomLabel":"ASDFAS","detailWorth":"31.00"}],"area":"","ae_code":"SFC1QXXXX012300008"},{"orderCode":"QXXXX012300007","customerOrderNo":"","shippingMethod":"CHEXP","shipperName":"fajianrenxm","shipperEmail":"564565464@123.com","shipperAddress":"yuangzhengdaxia","shipperPhone":"1234567899","shipperZipCode":"123456","shipperCompanyName":"gongsi","recipientCountry":"Chile","recipientName":"FASDFA","recipientState":"Arica y Parinacota","recipientCity":"ARICA","recipientAddress":"ASDFASD ","recipientZipCode":"","recipientPhone":"86076922251394","recipientEmail":"","goodsDescription":"ASDFAS","goodsQuantity":"1","goodsDeclareWorth":"30.00","goodsWeight":"1.000","goodsLength":"1.00","goodsWidth":"1.00","goodsHeight":"1.00","trackNumber":"","trackNumberUsps":"","addTime":"2020-12-30 14:30:20","deliveryTime":"2020-12-30 14:36:48","sendTime":null,"orderStatus":"Received","orderStatusCn":"已收货","subShipType":"","goodsDetails":[{"detailDescription":"ASDFAS","detailQuantity":"1","detailCustomLabel":"ASDFAS","detailWorth":"30.00"}],"area":"","ae_code":"SFC1QXXXX012300007"}]} apiName=getFeeByTime&parameter={"HeaderRequest":{"appKey":"","token":"","userId":""},"startime":"2020-08-01 00:00:00","endtime":"2020-08-06 00:00:00","page":"1"} {"ask":"Success","sysTime":"2020-12-30 10:17:35","page":"1","count":"4","msg":"Success","data":[{"uniqueCode":"SFC1QXXXX007290010-AXXXX2020080301","orderCode":"SFC1QXXXX007290010","baseFee":"1010.00","regFee":"0.00","dealFee":"20.00","insurance":"0.00","totalFee":"1030.00","countWeight":"1.000","currencyCode":"RMB","chargebackTime":"2020-08-03 13:44:58","chargebackWorkDay":"2020-08-03","shipTypeCode":"EUEXP5DH","subShipType":"EUEXP5DH-DPD","waybillCode":"AXXXX2020080301","discount":"1.0000","stDealFee":"0.00","stRegFee":"0.00","originBaseFee":"1000.00","originAddons":"0.00","feeWeight":"1.000","vat":null,"tariff":null,"waybillStatus":"1","customerOrderNo":"","otherFees":[]},{"uniqueCode":"SFC1QXXXX007290002-AXXXX2020080302","orderCode":"SFC1QXXXX007290002","baseFee":"1400.00","regFee":"0.00","dealFee":"20.00","insurance":"0.00","totalFee":"1420.00","countWeight":"40.000","currencyCode":"RMB","chargebackTime":"2020-08-03 14:26:32","chargebackWorkDay":"2020-08-03","shipTypeCode":"EUEXP5","subShipType":"EUEXP5-DPD","waybillCode":"AXXXX2020080302","discount":"1.0000","stDealFee":"0.00","stRegFee":"0.00","originBaseFee":"1000.00","originAddons":"0.00","feeWeight":"40.000","vat":null,"tariff":null,"waybillStatus":"1","customerOrderNo":"","otherFees":[]}]} apiName=createExpressWaybill&parameter={"HeaderRequest":{"appKey":"","token":"","userId":""},"data":{"company_name":"xxx物流有限公司","package_id":"1234567890","sfc_number":"2","receipt_number":"","receipt_weight":"2.15","user_remark":"测试新建国内快递交货单"}} {"status":"1","msg":"Tracking No. 1234567890 creating is successfully"}