API接口-三态速递

API接口

免费开放全功能API接口，电商平台无缝集成

Seamless API Integration

三态速递系统数据接口（API）

三态国际包裹业务为客户提供快捷便利，低成本的国际快递和国际邮寄服务。我们开发的基于Web的iShip软件技术，提供国际包裹全程跟踪与国际包裹资费计算的外部访问接口，为我们的客户提供实时的包裹资费计算与包裹跟踪信息,用户可以跟据实际情况把我们的国际包裹资费计算与国际包裹跟踪集成到他们的网站或系统,为他们的客户提供更详细的物流信息,提高客户满意度。目前我们的接口基本功能包括国际包裹国际包裹资费查询与国际包裹跟踪查询。

此接口为您集成国际包裹资费计算与国际包裹跟踪的程序提供了便捷、快速的集成方案。我们提供 Web Service(SOAP)与HTTP（POST/GET）2种访问方式，以供用户选择。

2011年6月30日，我们推出了Web Service(SOAP)的2.0版本，在原有的基础上增加了订单录入和查找的功能；同时2.0版本的使用需要对"数据标识（appKey）"和"密钥（token）"进行验证；如需要申请请联系销售人员或直接拨打客服联系电话：400-881-8106。

查询系统所支持的邮寄区域
查询系统中的可用的运费规则
根据货运类型查询运费规则
根据货运代号查询运费规则
获取三态货运方式代号
获取三态货运类型代号
提交订单信息到三态物流系统
获取通过接口添加的订单

IT技术支持

案例演示

获取代码

通过此接口，外部网络可查询我们系统所支持的邮寄区域。

                <?php
                $client = new SoapClient('http://www.sendfromchina.com/ishipsvc/web-service?wsdl');

                try {
                $parameter = array(
                'HeaderRequest' => array(
                'appKey' => '提供给用户的数据标识',
                'token' => '提供给用户的密钥',
                'userId' => '用户在三态的userCode'
                ),
                );
                // 调用getCountries
                $result=$client->getCountries($parameter);
                // 遍历对象集
                foreach ($result->countries as $value) {
                //输出每个国家的名称
                echo $value->enName . '<br />';
                }
                } catch (SoapFault$e) {
                print "Sorry an error was caught executing your request:{$e->getMessage()}";
                }
                ?>

通过此接口，外部网络可根据目的地与重量查询我们系统中的可用的运费规则。

                <?php
                $client = new SoapClient('http://www.sendfromchina.com/ishipsvc/web-service?wsdl');
                $parameter = array(
                'HeaderRequest' => array(
                'appKey' => '提供给用户的数据标识',
                'token' => '提供给用户的密钥',
                'userId' => '用户在三态的userCode'
                ),
                'ratesRequestInfo' => array(
                'country' => 'Canada',
                'weight' => 0.05,
                'length' => 20,
                'width' => 30,
                'height' => 20,
                'priceType' => 1,
                ),
                );

                try{
                // 调用getRates
                $result = $client->getRates($parameter);
                // 遍历对象集
                foreach($result->rates as $value) {
                //返回可提供的各种运输方式的总费用
                echo $value->totalfee.'<br>';
                }
                } catch (SoapFault $e) {
                print "Sorry an error was caught executing your request:{$e->getMessage()}";
                }
                ?>

根据三态货运方式类型查询运费规则。

                <?php
                $client = new SoapClient('http://www.sendfromchina.com/ishipsvc/web-service?wsdl');
                $parameter = array(
                'HeaderRequest' => array(
                'appKey' => '提供给用户的数据标识',
                'token' => '提供给用户的密钥',
                'userId' => '用户在三态的userCode'
                ),
                'ratesRequestInfo' => array(
                'country' => 'Canada',
                'type' => 'CRE',    //国际快递
                'weight' => 0.05,
                'length' => 20,
                'width' => 30,
                'height' => 20,
                'priceType' => 1,    //用户为userId的运费信息
                ),
                );

                try {
                // 调用getRates
                $result = $client->getRatesByType($parameter);
                // 遍历对象集
                foreach($result->rates as $value){
                // 返回可提供的各种运输方式的总费用
                echo $value->totalfee . '<br>';
                }
                } catch (SoapFault $e) {
                print "Sorry an error was caught executing your request:{$e->getMessage()}";
                }
                ?>

根据三态货运方式代号查询运费规则。

                <?php
                $client = new SoapClient('http://www.sendfromchina.com/ishipsvc/web-service?wsdl');
                $parameter = array(
                'HeaderRequest' => array(
                'appKey' => '提供给用户的数据标识',
                'token' => '提供给用户的密钥',
                'userId' => '用户在三态的userCode'
                ),
                'ratesRequestInfo' => array(
                'country' => 'Canada',
                'type' => 'CRE',    // 国际快递
                'weight' => 0.05,
                'length' => 20,
                'width' => 30,
                'height' => 20,
                'priceType' => 1,    //用户为userId的运费信息
                ),
                );

                try {
                // 调用getRateByMode
                $result=$client->getRateByMode($parameter);
                // 返回可提供的各种运输方式的总费用
                echo $result->totalfee . '<br />';
                } catch (SoapFault $e) {
                print "Sorry an error was caught executing your request:{$e->getMessage()}";
                }
                ?>

获取三态货运方式代号。

                <?php
                $client = new SoapClient('http://www.sendfromchina.com/ishipsvc/web-service?wsdl');

                try {
                $parameter = array(
                'HeaderRequest' => array(
                'appKey' => '提供给用户的数据标识',
                'token' => '提供给用户的密钥',
                'userId' => '用户在三态的userCode'
                ),
                );
                // 调用getCountries
                $result = $client->getShipTypes($parameter);
                // 遍历对象集
                foreach ($result->shiptypes as $value) {
                // 输出每个运输方式的货运代号
                echo $value->method_code . '<br />';
                }
                } catch (SoapFault$e) {
                print "Sorry an error was caught executing your request:{$e->getMessage()}";
                }
                ?>

获取三态货运类型代号。

                <?php
                $client = new SoapClient('http://www.sendfromchina.com/ishipsvc/web-service?wsdl');

                try {
                $parameter = array(
                'HeaderRequest' => array(
                'appKey' => '提供给用户的数据标识',
                'token' => '提供给用户的密钥',
                'userId' => '用户在三态的userCode'
                ),
                );
                // 调用getCountries
                $result = $client->getClassTypes($parameter);
                // 遍历对象集
                foreach($result->classTypes as $value){
                // 输出每个运输方式的货运类型代号
                echo $value->class_code . '<br />';
                }
                } catch (SoapFault$e) {
                print "Sorry an error was caught executing your request:{$e->getMessage()}";
                }
                ?>

提交订单信息到三态物流系统。

                <?php
                $client = new SoapClient('http://www.sendfromchina.com/ishipsvc/web-service?wsdl');

                try {
                $parameter = array(
                'HeaderRequest' => array(
                'appKey' => '提供给用户的数据标识',
                'token' => '提供给用户的密钥',
                'userId' => '用户在三态的userCode'
                ),
                'addOrderRequestInfo' => array(
                'customerOrderNo' => '客户的订单标识',
                'shipperAddressType' => 2,
                'shipperName' => '发件人名称',
                'shipperEmail' => '发件人邮箱',
                'shipperAddress' => '发件人地址',
                'shipperZipCode' => '发件人邮编',
                'shippingMethod' => 'HKDHL',    // 三态提供运输方式
                'recipientCountry' => 'Canada',    // 三态提供的国家英文名称
                'recipientName' => '收件人名称',
                'recipientAddress' => '收件人地址',
                'recipientZipcode' => '收件人邮编',
                'recipientPhone' => '收件人电话',
                'recipientEmail' => '收件人电子邮件',
                'goodsDescription' => '物品描述',
                'goodsQuantity' => '物品数量',
                'goodsDeclareWorth' => '物品价值',
                'goodsDetails' => array(
                array(
                'detailDescription' => '详细物品描述1',
                'detailQuantity' => '详细物品数量1',
                'detailCustomLabel' => 'customlabel1',
                'detailWorth' => '详细物品总价值1',
                ),
                array(
                'detailDescription' => '详细物品描述1',
                'detailQuantity' => '详细物品数量1',
                'detailCustomLabel' => 'customlabel2',
                'detailWorth' => '详细物品总价值2',
                ),
                ),
                ),
                );
                $result = $client->addOrder($parameter);
                } catch (SoapFault$e) {
                print "Sorry an error was caught executing your request:{$e->getMessage()}";
                }
                ?>

根据不同的条件获取该用户通过接口添加的订单。

                <?php
                $client = new SoapClient('http://www.sendfromchina.com/ishipsvc/web-service?wsdl');

                try {
                $parameter = array(
                'derRequest' => array(
                'appKey' => '提供给用户的数据标识',
                'token' => '提供给用户的密钥',
                'userId' => '用户在三态的userCode'
                ),
                'searchOrderRequestInfo' => array(
                'orderCode' => '三态生成的跟踪号'
                ),
                );
                // 调用searchOrders
                $result = $client->searchOrder($parameter);
                } catch (SoapFault$e) {
                print "Sorry an error was caught executing your request:{$e->getMessage()}";
                }
                ?>

HTTP访问方式是指用户通过URL（GET）或提交表单（POST）方式来获取运费规则信息。我们系统接收到用户按一定规则提交的请求后，将会以XML的形式返回相关信息。

查询ISHIP邮寄国家名称
查询ISHIP支持的邮寄方式
查询ISHIP支持的邮寄类型
直接查询可用运费规则
按邮寄类型查询运费规则
按邮寄方式查询运费规则
查询包裹跟踪信息

IT技术支持

案例演示

获取代码

在提交运费查询之前，用户须先获取ISHIP系统的国家名称,以供选择。

                <?php
                //HTTP REQUIRE URL
                define('REQUIRECOUNTRYURL','http://www.sendfromchina.com/shipfee/country_list');
                ?>
                <p>Get sfcservice.com shipping rate.</p>
                <form action="XMLGetRateRespones.php" method="post">

                <table cellpadding="0">
                <tr>
                <td>Country</td><td>
                <select name="countryName">
                <?php

                $doc = new DOMDocument();
                $doc->load( REQUIRECOUNTRYURL );
                $dataset = $doc->getElementsByTagName( "country" );
                foreach( $dataset as $row ){
                $countryNames = $row->getElementsByTagName( "englishname" );
                $countryName = $countryNames->item(0)->nodeValue;
                ?>

                <option value='<?php echo $countryName ?>'><?php echo $countryName ?></option>
                <?php }?>
                </select>
                </td> </tr>
                </table>
                </form>

                <?php
                //HTTP REQUIRE URL
                define('REQUIRESHIPTYPE','http://www.sendfromchina.com/shipfee/ship_type_list');
                ?>
                <p>Get sfcservice.com shipping rate.</p>
                <form action="XMLGetRateRespones.php" method="post">

                <table cellpadding="0">
                <tr>
                <td>Ship Class</td><td>
                <select name="shipmode">
                <?php

                $doc = new DOMDocument();
                $doc->load( REQUIRESHIPTYPE );
                $dataArr = $doc->getElementsByTagName( "shiptype" );
                foreach( $dataArr as $row ){
                $en_names = $row->getElementsByTagName( "en_name" );
                $en_name = $en_names->item(0)->nodeValue;
                $method_codes = $row->getElementsByTagName( "method_code" );
                $method_code = $method_codes->item(0)->nodeValue;
                ?>

                <option value='<?php echo $method_code ?>'><?php echo $en_name ?></option>
                <?php }?>
                </select>
                </td> </tr>
                </table>
                </form>

                <?php
                //HTTP REQUIRE URL
                define('REQUIRESHIPCLASS','http://www.sendfromchina.com/shipfee/ship_class_list');
                ?>
                <p>Get sfcservice.com shipping rate.</p>

                <table cellpadding="0">
                <tr>
                <td>Ship Type</td><td>
                <select name="classType">
                <?php

                $doc = new DOMDocument();
                $doc->load( REQUIRESHIPCLASS );
                $dataArr = $doc->getElementsByTagName( "shipclass" );
                foreach( $dataArr as $row ){
                $en_names = $row->getElementsByTagName( "en_name" );
                $en_name = $en_names->item(0)->nodeValue;
                $class_codes = $row->getElementsByTagName( "class_code" );
                $class_code = $class_codes->item(0)->nodeValue;
                ?>
                <option value='<?php echo $class_code ?>'><?php echo $en_name ?></option>
                <?php }?>
                </select>
                </td> </tr>
                </table>

此查询需要提交国际包裹的目的国家与重量。所以在提交查询时，我们先生成一个表单来取得国家信息与货物重量，再提交查询。

提交查询表单代码：

                    <?php
                    define('REQUIRECOUNTRYURL','http://www.sendfromchina.com/shipfee/country_list');
                    ?>
                    <p>Get sfcservice.com shipping rate.</p>
                    <form action="getRateRespones.php" method="post">

                    <table cellpadding="0">
                    <tr>
                    <td>Country</td><td>
                    <select name="countryName">
                    <?php

                    $doc = new DOMDocument();
                    $doc->load( REQUIRECOUNTRYURL );
                    $dataset = $doc->getElementsByTagName( "country" );
                    foreach( $dataset as $row ){
                    $countryNames = $row->getElementsByTagName( "englishname" );
                    $countryName = $countryNames->item(0)->nodeValue;
                    ?>

                    <option value='<?php echo $countryName ?>'><?php echo $countryName ?></option>
                    <?php }?>
                    </select>
                    </td> </tr>
                    <tr>
                    <td>Weight:</td>
                    <td><input type="text" name="weight" /></td>

                    </tr> <tr>
                    <td colspan="2"><input type="submit" value="GetRates" /></td>
                    </tr>
                    </table>
                    </form>

getRateRespones.php代码：

                    <?php
                    // URL to call
                    define('REQUIRERATE','http://www.sendfromchina.com/shipfee/out_rates');
                    $countryName = @$_POST['countryName'];
                    $weight = @$_POST['weight'];

                    // Construct the GetShippingRate call
                    $profile = '?country='.$countryName.'&weight='.$weight;

                    require_once 'XMLGetRate.php';

                    $doc = new DOMDocument();
                    $doc->load( REQUIRERATE .$profile);
                    // Load the call and capture the document returned by sendfromchina.com API
                    $dataset = $doc->getElementsByTagName( "rate" );
                    // Check to see if the response was loaded, else print an error
                    if(@$dataset->item(0)->nodeValue){
                    ?>

                    <hr color="#6794B8" size="2" >
                    <table cellspacing="1" cellpadding="0" width="85%">
                    <tr align="center" bgcolor="#C3D5FD">

                    <th width="30%">Mail Service</th>
                    <th width="25%">Total Fee(&#165;CNY)</th>

                    <th width="25%">Delivery time(Workday)</th>
                    <th width="10%">Tracking</th>
                    <th width="10%">By volume</th>
                    </tr>
                    <?php
                    // For each Shippinh Rate Item node, and display all of them
                    foreach( $dataset as $row ){
                    $totalfees = $row->getElementsByTagName( "totalfee" );
                    $totalfee = $totalfees->item(0)->nodeValue;
                    $deliverytimes = $row->getElementsByTagName( "deliverytime" );
                    $deliverytime = $deliverytimes->item(0)->nodeValue;
                    $iftrackings = $row->getElementsByTagName( "iftracking" );
                    $iftracking = $iftrackings->item(0)->nodeValue;
                    $classtypes = $row->getElementsByTagName( "classtype" );
                    $classtype = $classtypes->item(0)->nodeValue;
                    $byvolumes = $row->getElementsByTagName( "byvolume" );
                    $byvolume = $byvolumes->item(0)->nodeValue;
                    $shiptypes = $row->getElementsByTagName( "shiptypename" );
                    $shiptypename = $shiptypes->item(0)->nodeValue;
                    ?>

                    <tr align="center" bgcolor="#ffffff">
                    <td width="30%"><?php echo $shiptypename ?></td>

                    <td width="25%"><?php echo $totalfee ?></td>

                    <td width="25%"><?php echo $deliverytime ?></td>
                    <td width="10%"><?php echo $iftracking ?></td>
                    <td width="10%"><?php echo $byvolume ?></td>
                    </tr>

                    <?php
                    }

                    ?> </table>
                    <?php
                    }else{
                    //display error message
                    $errors = $doc->getElementsByTagName( "errors" );
                    $error = $errors->item(0)->nodeValue;
                    echo $error;

                    }

                    ?>

此查询需要提交国际包裹的目的国家、重量与类型。在提交查询前，我们应生成一个表单来取得国家信息、货物重量与类型，再提交查询。

提交查询表单代码：

                    <?php
                    define('REQUIRECOUNTRYURL','http://www.sendfromchina.com/shipfee/country_list');
                    define('REQUIRESHIPCLASS','http://www.sendfromchina.com/shipfee/ship_class_list');
                    ?>
                    <p>Get sfcservice.com shipping rate by type.</p>
                    <form action="getRateByTypeRespones.php" method="post">
                    <table cellpadding="0">
                    <tr>
                    <td>Country</td><td>
                    <select name="countryName">
                    <?php
                    $doc = new DOMDocument();
                    $doc->load( REQUIRECOUNTRYURL );
                    $dataset = $doc->getElementsByTagName( "country" ); //获取国家
                    foreach( $dataset as $row ){
                    $countryNames = $row->getElementsByTagName( "englishname" );
                    $countryName = $countryNames->item(0)->nodeValue;
                    ?>

                    <option value='<?php echo $countryName ?>'><?php echo $countryName ?></option>
                    <?php
                    }
                    unset($doc);

                    ?>
                    </select>
                    </td> </tr>
                    <tr>
                    <td>Type</td><td>
                    <select name="type">
                    <?php
                    $doc = new DOMDocument();
                    $doc->load( REQUIRESHIPCLASS );
                    $dataArr = $doc->getElementsByTagName( "shipclass" ); //获取运费类型
                    foreach( $dataArr as $row ){
                    $en_names = $row->getElementsByTagName( "en_name" );
                    $en_name = $en_names->item(0)->nodeValue;
                    $class_codes = $row->getElementsByTagName( "class_code" );
                    $class_code = $class_codes->item(0)->nodeValue;
                    ?>
                    <option value='<?php echo $class_code ?>'><?php echo $en_name ?></option>
                    <?php
                    }
                    unset($doc);
                    ?>
                    </select>
                    </td> </tr>
                    <tr>
                    <td>Weight:</td>
                    <td><input type="text" name="weight" /></td>
                    </tr>
                    <tr>
                    <td colspan="2"><input type="submit" value="GetRates" /></td>
                    </tr>
                    </table>
                    </form>

getRateByTypeRespones.php代码：

                    <?php
                    // URL to call
                    define('REQUIRERATE','http://www.sendfromchina.com/shipfee/out_rates');
                    $countryName = @$_POST['countryName'];
                    $weight = @$_POST['weight'];

                    // Construct the GetShippingRate call
                    $profile = '?country='.$countryName.'&weight='.$weight;
                    //Construct the GetShippingRate By type
                    $profile .= '&type='.$_POST['type'];
                    require_once 'XMLGetRateByType.php';
                    $doc = new DOMDocument();
                    $doc->load( REQUIRERATE .$profile);
                    // Load the call and capture the document returned by sendfromchina.com API
                    $dataset = $doc->getElementsByTagName( "rate" );
                    // Check to see if the response was loaded, else print an error
                    if(@$dataset->item(0)->nodeValue){
                    ?>

                    <hr color="#6794B8" size="2" >
                    <table cellspacing="1" cellpadding="0" width="85%">
                    <tr align="center" bgcolor="#C3D5FD">

                    <th width="30%">Mail Service</th>
                    <th width="25%">Total Fee(&#165;CNY)</th>

                    <th width="25%">Delivery time(Workday)</th>
                    <th width="10%">Tracking</th>
                    <th width="10%">By volume</th>
                    </tr>
                    <?php
                    // For each Shippinh Rate Item node, and display all of them
                    foreach( $dataset as $row ){
                    $totalfees = $row->getElementsByTagName( "totalfee" );
                    $totalfee = $totalfees->item(0)->nodeValue;
                    $deliverytimes = $row->getElementsByTagName( "deliverytime" );
                    $deliverytime = $deliverytimes->item(0)->nodeValue;
                    $iftrackings = $row->getElementsByTagName( "iftracking" );
                    $iftracking = $iftrackings->item(0)->nodeValue;
                    $classtypes = $row->getElementsByTagName( "classtype" );
                    $classtype = $classtypes->item(0)->nodeValue;
                    $byvolumes = $row->getElementsByTagName( "byvolume" );
                    $byvolume = $byvolumes->item(0)->nodeValue;
                    $shiptypes = $row->getElementsByTagName( "shiptypename" );
                    $shiptypename = $shiptypes->item(0)->nodeValue;
                    ?>

                    <tr align="center" bgcolor="#ffffff">
                    <td width="30%"><?php echo $shiptypename ?></td>

                    <td width="25%"><?php echo $totalfee ?></td>

                    <td width="25%"><?php echo $deliverytime ?></td>
                    <td width="10%"><?php echo $iftracking ?></td>
                    <td width="10%"><?php echo $byvolume ?></td>
                    </tr>

                    <?php
                    }

                    ?>

                    </table>
                    <?php
                    }else{
                    //display error message
                    $errors = $doc->getElementsByTagName( "errors" );
                    $error = $errors->item(0)->nodeValue;
                    echo $error;

                    }
                    ?>

此查询需要提交国际包裹的目的国家、重量与邮寄方式。在提交查询前，我们应生成一个表单来取得国家信息、货物重量与邮寄方式，再提交查询。

提交查询表单代码：

                    <?php
                    //HTTP REQUIRE URL
                    define('REQUIRECOUNTRYURL','http://www.sendfromchina.com/shipfee/country_list');
                    define('REQUIRESHIPTYPE','http://www.sendfromchina.com/shipfee/ship_type_list');
                    ?>

                    <p>Get sfcservice.com shipping rate by mode.</p>
                    <form action="getRateByTypeRespones.php" method="post">

                    <table cellpadding="0">
                    <tr>
                    <td>Country:</td><td>
                    <select name="countryName">
                    <?php

                    $doc = new DOMDocument();
                    $doc->load( REQUIRECOUNTRYURL );
                    $dataset = $doc->getElementsByTagName( "country" );
                    foreach( $dataset as $row ){
                    $countryNames = $row->getElementsByTagName( "englishname" );
                    $countryName = $countryNames->item(0)->nodeValue;
                    ?>

                    <option value='<?php echo $countryName ?>'><?php echo $countryName ?></option>
                    <?php }?>
                    </select>
                    </td> </tr>
                    <tr>
                    <td>Mode:</td><td>
                    <select name="mode">
                    <?php

                    $doc = new DOMDocument();
                    $doc->load( REQUIRESHIPTYPE );
                    $dataArr = $doc->getElementsByTagName( "shiptype" );
                    foreach( $dataArr as $row ){
                    $en_names = $row->getElementsByTagName( "en_name" );
                    $en_name = $en_names->item(0)->nodeValue;
                    $method_codes = $row->getElementsByTagName( "method_code" );
                    $method_code = $method_codes->item(0)->nodeValue;
                    ?>
                    <option value='<?php echo $method_code ?>'><?php echo $en_name ?></option>
                    <?php }?>
                    </select>
                    </td> </tr>
                    <tr>
                    <td>Weight:</td>
                    <td><input type="text" name="weight" /></td>

                    </tr>
                    <tr>
                    <td colspan="2"><input type="submit" value="GetRate" /></td>
                    </tr>
                    </table>
                    </form>

getRateByTypeRespones.php代码：



                    <?php
                    // URL to call
                    define('REQUIRERATE','http://www.sendfromchina.com/shipfee/out_rates');
                    $countryName = @$_POST['countryName'];
                    $weight = @$_POST['weight'];

                    // Construct the GetShippingRate call
                    $profile = '?country='.$countryName.'&weight='.$weight;
                    //Construct the GetShippingRate By mode
                    $profile .= '&mode='.$_POST['mode'];
                    require_once 'XMLGetRateByMode.php';
                    $doc = new DOMDocument();
                    $doc->load( REQUIRERATE .$profile);
                    // Load the call and capture the document returned by sendfromchina.com API
                    $dataset = $doc->getElementsByTagName( "rate" );
                    // Check to see if the response was loaded, else print an error
                    if(@$dataset->item(0)->nodeValue){
                    ?>
                    <hr color="#6794B8" size="2" >
                    <table cellspacing="1" cellpadding="0" width="85%">
                    <tr align="center" bgcolor="#C3D5FD">
                    <th width="30%">Mail Service</th>
                    <th width="25%">Total Fee(&#165;CNY)</th>
                    <th width="25%">Delivery time(Workday)</th>
                    <th width="10%">Tracking</th>
                    <th width="10%">By volume</th>
                    </tr>
                    <?php
                    // For each Shippinh Rate Item node, and display all of them
                    foreach( $dataset as $row ){
                    $totalfees = $row->getElementsByTagName( "totalfee" );
                    $totalfee = $totalfees->item(0)->nodeValue;
                    $deliverytimes = $row->getElementsByTagName( "deliverytime" );
                    $deliverytime = $deliverytimes->item(0)->nodeValue;
                    $iftrackings = $row->getElementsByTagName( "iftracking" );
                    $iftracking = $iftrackings->item(0)->nodeValue;
                    $classtypes = $row->getElementsByTagName( "classtype" );
                    $classtype = $classtypes->item(0)->nodeValue;
                    $byvolumes = $row->getElementsByTagName( "byvolume" );
                    $byvolume = $byvolumes->item(0)->nodeValue;
                    $shiptypes = $row->getElementsByTagName( "shiptypename" );
                    $shiptypename = $shiptypes->item(0)->nodeValue;
                    ?>
                    <tr align="center" bgcolor="#ffffff">
                    <td width="30%"><?php echo $shiptypename ?></td>
                    <td width="25%"><?php echo $totalfee ?></td>
                    <td width="25%"><?php echo $deliverytime ?></td>
                    <td width="10%"><?php echo $iftracking ?></td>
                    <td width="10%"><?php echo $byvolume ?></td>
                    </tr>
                    <?php
                    }
                    ?>
                    </table>
                    <?php
                    }else{
                    //display error message
                    $errors = $doc->getElementsByTagName( "errors" );
                    $error = $errors->item(0)->nodeValue;
                    echo $error;

                    }

                    ?>

此查询需要提交ISHIP提供的订单ID或者ISHIP提供的跟踪号码。在提交查询前，我们应生成一个表单来输入订单ID或者跟踪号码，再提交查询。

代码：

                    <h2>Get Track Information </h2>
                    <form action="getTrackInfoRespone.php" method="post">
                    <table cellpadding="0">
                    <tr>
                    <td>Track &amp; Confirm :</td>
                    <td><input type ="text" name= "trackingNumber" value="" /></td>
                    <td><input type="submit" value= "Track" name ="Track"/></td>
                    </tr>
                    </table>
                    </form>

getTrackInfoRespone.php

                    <?php
                    header("Content-type: text/html; charset=utf-8");
                    define('REQUIRETRACKING','http://www.sendfromchina.com/tracking/to_xml');
                    $trackingNumber = @$_POST['trackingNumber'];
                    if($trackingNumber == ''){
                    echo "Please fill the Track Number.";
                    return;
                    }
                    ?>
                    <h2>Get Track Information </h2>

                    <form action="./getTrackInfoRespone.php" method="post">
                    <table cellpadding="0">
                    <tr>
                    <td>Track &amp; Confirm :</td>
                    <td><input type ="text" name= "trackingNumber" value="" /></td>
                    <td><input type="submit" vale= "Track" name ="Track"/></td>
                    </tr>
                    </table>
                    </form>
                    <hr color="#6794B8" size="2" >
                    <?php
                    $profile = '?number='.$trackingNumber;
                    $doc = new DOMDocument();
                    $doc->load( REQUIRETRACKING .$profile);
                    // Load the call and capture the document returned by sendfromchina.com API
                    $order = $doc->getElementsByTagName( "Order" );
                    // Check to see if the response was loaded, else print an error
                    if(@$order->item(0)->nodeValue){
                    $order_id = $doc->getElementsByTagName( "order_id" );
                    $orderId = $order_id->item(0)->nodeValue;
                    $orderWeight = $doc->getElementsByTagName( "weight" );
                    $weight = $orderWeight->item(0)->nodeValue;
                    $orderType = $doc->getElementsByTagName( "type" );
                    $type = $orderType->item(0)->nodeValue;
                    $orderDestination = $doc->getElementsByTagName( "destination" );
                    $destination = $orderDestination->item(0)->nodeValue;

                    ?>


                    <h3>Order Information </h3>
                    <table cellspacing="1" cellpadding="1" width="85%">
                    <tr >
                    <td>Order Id:</td><td><?php echo $orderId ?> </td> <td>&nbsp;&nbsp;&nbsp;</td><td>Weight:</td><td><?php echo $weight ?> </td>
                    </tr>
                    <tr >
                    <td>Type:</td><td><?php echo $type ?> </td> <td>&nbsp;&nbsp;&nbsp;</td><td>Destination:</td><td><?php echo $destination ?> </td>
                    </tr>
                    </table>
                    <?php

                    $trackingHistory = $doc->getElementsByTagName( "Track" );
                    if(@$trackingHistory->item(0)->nodeValue){
                    ?>

                    <h3>Shipment Travel History </h3>
                    <table cellspacing="1" cellpadding="0" width="85%">
                    <tr align="center" bgcolor="#C3D5FD">
                    <td>Activity</td>
                    <td>TrackDate </td>
                    <td>Location</td>
                    </tr>
                    <?php
                    foreach( $trackingHistory as $row ){
                    $track_date = $row->getElementsByTagName( "track_date" );
                    $trackDate = $track_date->item(0)->nodeValue;
                    $locations = $row->getElementsByTagName( "locations" );
                    $location = $locations->item(0)->nodeValue;
                    $activitys = $row->getElementsByTagName( "activity" );
                    $activity = $activitys->item(0)->nodeValue;


                    ?>



                    <tr align="center" >
                    <td><?php echo $activity ?></td>
                    <td><?php echo $trackDate ?></td>
                    <td><?php echo $location ?></td>
                    </tr>
                    <?php
                    }
                    ?>
                    </table>
                    <?php
                    }
                    }else{
                    $errors = $doc->getElementsByTagName( "message" );
                    $error = $errors->item(0)->nodeValue;
                    echo $error;


                    }
                    ?>

一般的网上购物网站都会有运输计算这一环节，如果你想使用我们的国际包裹资费计算集成到你们的网站，主要是有两个重要的部分，商品显示页面运费计算与下订单过程中的运输费用。

商品显示页面运费计算
下订单过程中的运输费用

IT技术支持

案例演示

获取代码

在产品显示页面，通常会根据产品的重量、用户选择产品的个数与目的地显示平邮与快递的价格，供用户参考。在集成过程中，可能调用我们的getRates获取ISHIP的所有可行的运费计算规则，然后搞照ISHIP的分类(China Postal Service,China Registered Postal,China Express Mail)取得第一个也就是价格最低的此类型的运输方式，供用户选择。

                <?php
                define('REQUIRECOUNTRYURL','http://www.sendfromchina.com/shipfee/country_list');//http require URL for iship country
                define('REQUIRERATE','http://www.sendfromchina.com/shipfee/out_rates');//http require URL for iship shipping Rates
                $countryName = @$_POST['countryName'];
                $quantity = @$_POST['quantity'];
                if($quantity == null){
                $quantity = 1;
                }
                if($countryName == null){
                $countryName = "Canada";
                }
                $preItemFee = 18;
                $preWeight = 0.125;

                $profile = '?country='.$countryName.'&weight='.$preWeight * $quantity ;

                ?>
                <script language="javascript">
                window.onload=function(){

                document.forms['form1'].quantity.value= '<?php echo $quantity ?>';
                document.forms['form1'].countryName.value= '<?php echo $countryName ?>';
                }

                function shipincart_submit(country){

                document.form1.submit();

                }

                </script>
                <h2>Estimate Shipping Costs</h2>
                <form name="form1" action="./calculate.php" method="post">
                <table cellspacing="0" cellpadding="0">
                <tr>
                <td width="141" height="35">Quantity:
                <select name="quantity" id="quantity" onchange="return shipincart_submit();">
                <option value="1">1</option>
                <option value="2">2</option>
                <option value="3">3</option>
                <option value="4">4</option>
                <option value="5">5</option>
                <option value="6">6</option>
                <option value="7">7</option>
                <option value="8">8</option>
                <option value="9">9</option>
                <option value="10">10</option>
                </select>
                </td>
                <td width="169">Weight: <strong><?php echo $preWeight * $quantity ;?></strong> kg</td>
                <td width="180">Item cost: <strong><?php echo $preItemFee*$quantity ?> CNY</strong></td>
                </tr>
                <tr>
                <td height="35">Shipping to(Country):</td>
                <td colspan="2"><label>
                <select name="countryName" id="countryName" onchange="return shipincart_submit();">
                <?php

                $doc = new DOMDocument();
                $doc->load( REQUIRECOUNTRYURL );
                $dataset = $doc->getElementsByTagName( "country" );
                foreach( $dataset as $row ){
                $countryNames = $row->getElementsByTagName( "englishname" );
                $countryName = $countryNames->item(0)->nodeValue;
                ?>

                <option value='<?php echo $countryName ?>'><?php echo $countryName ?></option>
                <?php
                }
                ?>
                </select>
                </label></td>
                </tr>
                <tr>
                <td colspan="3">
                <table width="100%" border="0" cellpadding="0" cellspacing="0">
                <tbody>
                <tr>
                <th width="210" align="left">Available Shipping Methods</th>
                <th align="left">Shipping Cost</th>
                <th align="left">Total Cost</th>
                </tr>
                <?php
                $doc1 = new DOMDocument();
                $doc1->load( REQUIRERATE .$profile);
                // Load the call and capture the document returned by sendfromchina.com API
                $dataset = $doc1->getElementsByTagName( "rate" );
                // Check to see if the response was loaded, else print an error
                if(@$dataset->item(0)->nodeValue){


                foreach( $dataset as $row ){

                $classtypes = $row->getElementsByTagName( "classtype" );
                $classtype = $classtypes->item(0)->nodeValue;

                switch ($classtype){
                case 'China Postal Service':
                $key = 'CPS';
                $name = 'Standard';
                break;
                case 'China Registered Postal':
                $key = 'CRP';
                $name = 'Registered';
                break;
                case 'China Express Mail':
                $key = 'CEM';
                $name = 'Expedited';
                break;
                }

                if($Rates[$key] != ture){
                $totalfees = $row->getElementsByTagName( "totalfee" );
                $totalfee = $totalfees->item(0)->nodeValue;
                $iftrackings = $row->getElementsByTagName( "iftracking" );

                $byvolumes = $row->getElementsByTagName( "byvolume" );

                $shiptypes = $row->getElementsByTagName( "shiptypename" );
                $Rates[$key] = ture;
                ?>
                <tr>
                <td><?php echo $name; ?></td>
                <td><?php echo $totalfee ?> CNY</td>
                <td><?php echo $totalfee + $preItemFee*$quantity ?> CNY</td>
                </tr>
                <?php


                }



                }


                ?>



                <?php

                //var_dump($Rates);
                }
                ?>
                </tbody>
                </table> </td>
                </tr>
                </table>
                </form>

同理，在用户下订单过程中，需要提供运输方式会用户选择，并把运输费用写入到订单中。在此过程中我们可以使用getRates获取ISHIP的所有可行的运费计算规则，供用户选择(其中要提供用户Shipping地址的国家，产品的重量)；用户选择后提交ISHIP的运输方式代号(可从getRates中提取)，再使用我们提供的getRatesByMode取得在此订单重量与运输目的地上使用此运输方式的详细信息。以下是模拟的购物车样例代码：

cart.php

                <?php
                session_start();
                $quantity = @$_GET['quantity'];
                if($quantity == null || $quantity == ''){
                $quantity = 1;
                }
                $preItemFee = 18;//pre item price
                $preWeight = 0.125;//pre item weight

                ?>

                <script language="javascript">
                window.onload = function(){
                document.getElementById('cart_quantity').value = '<?php echo $quantity ?>';

                }
                function updateQuantity(){
                var value = document.getElementById('cart_quantity').value;
                document.forms['cart'].action = "./cart.php?quantity="+value;
                document.forms['cart'].submit();
                }
                </script>

                <form name="cart" action="./shippingaddress.php" method="post" id="cart">
                <table cellpadding="1" border="1" width="100%">
                <tr>
                <td><strong>Item</strong> </td>
                <td><strong>Product Name</strong> </td>
                <td><strong>Quantity</strong> </td>
                <td><strong>Pre Price</strong> </td>
                <td><strong>Price</strong></td>
                </tr>
                <tr>
                <td><img src="./img/item1.jpg" width="85" border="0" height="85"></a> </td>
                <td>Super Quad Band Cellphone Plays Movies</td>
                <td> <input name="cart_quantity" id="cart_quantity" value="1" size="4" onkeyup="value=value.replace(/[^\d]/g,'');"
                type="text"><a href="#" onclick="updateQuantity();">Update</a> </td>
                <td>CNY&#165;<?php echo $preItemFee; ?></td>
                <td>CNY&#165;<?php echo $preItemFee*$quantity; ?> </td>
                </tr>
                </table>
                <div style="float:right">Subtotal:CNY&#165;<?php echo $preItemFee*$quantity; ?></div>
                <div style="clear: both "></div>
                <div style="float:right"><input type="button" value="Checkout" onclick = "this.form.submit();" /></div>
                </form>
                <ul>

shippingaddress.php

                <?php
                session_start();

                define('REQUIRECOUNTRYURL','http://www.sendfromchina.com/shipfee/country_list');

                $_SESSION['defaultAddress']['string'] = '<strong>Test User</strong><br />
                Nanshang,Shengzheng Guangdong<br />
                Shengzheng,AR,518000<br />
                Switzerland<br />
                Phone:888166222';
                $_SESSION['defaultAddress']['country'] = 'Canada';

                ?>
                <form action="./checkout.php" name="" method="post">

                <table cellpadding="1" border="1" width="90%">
                <tr>
                <td>
                <input name="shippingType" type="radio" value="1" checked="checked" onclick="document.getElementById('newAddress').style.display='none'"/>
                </td>
                <td><?php echo $_SESSION['defaultAddress']['string']; ?>
                <input type="hidden" name="countryName" value="<?php echo $_SESSION['defaultAddress']['country'] ?>" />
                </td>
                </tr>
                <tr>
                <td>
                <input name="shippingType" type="radio" value="2" onclick="document.getElementById('newAddress').style.display='block'"/>
                </td>
                <td>New Shipping Address</td>
                </tr>
                </table>

                <table cellpadding="1" border="1" width="90%" id="newAddress" style="display:none">

                <tr>
                <td>First name:*</td>
                <td colspan="3">
                <input name="firstname" value="" maxlength="32" id="firstname" chkname="First name" chkrule="nnull/min2" type="text"> </td>
                </tr>
                <tr>

                <td>Last name:*</td>
                <td>
                <input name="lastname" value="" maxlength="32" id="lastname" chkname="Last name" chkrule="nnull/min2" type="text"> </td>
                </tr>
                <tr>
                <td>Address Line1:*</td>
                <td colspan="3">
                <input name="street_address" value="" maxlength="64" id="street-address" chkname="Address Line1" chkrule="nnull/min5" type="text"> </td>
                </tr>
                <tr>
                <td>Address Line2:</td>
                <td colspan="3">
                <input name="suburb" maxlength="64" id="suburb" type="text"> </td>
                </tr>
                <tr>
                <td>City:*</td>
                <td colspan="3"><input name="city" value="" maxlength="32" id="city" chkname="City" chkrule="nnull/min3" type="text"> </td>
                </tr>
                <tr>
                <td>Country / Region:*</td>
                <td colspan="3"><select name="countryName" id="countryName" onchange="return shipincart_submit();">
                <?php

                $doc = new DOMDocument();
                $doc->load( REQUIRECOUNTRYURL );
                $dataset = $doc->getElementsByTagName( "country" );
                foreach( $dataset as $row ){
                $countryNames = $row->getElementsByTagName( "englishname" );
                $countryName = $countryNames->item(0)->nodeValue;
                ?>

                <option value='<?php echo $countryName ?>'><?php echo $countryName ?></option>
                <?php }?>
                </select></td>
                </tr>

                <tr id="zone_id_tr">
                <td>State/Province/Region:*</td>
                <td colspan="3"><input name="zone" id="country" /></td>
                </tr>

                <tr>
                <td>ZIP/Postal Code:*</td>
                <td colspan="3"><input name="postcode" value="" maxlength="10" id="postcode" chkname="ZIP/Postal Code" chkrule="nnull/min4" type="text"> </td>
                </tr>
                <tr>
                <td>Phone Number:*</td>
                <td colspan="3"><input name="phone" value="" maxlength="45" id="phone" chkname="Phone Number" chkrule="nnull/min4/tel" type="text"></td>
                </tr>
                </table>
                <div align="center">
                <input type="submit" name="submit" value="submit" onclick="this.form.submit();"/>
                </div>
                </form>

checkout.php



        <?php
        session_start();
        define('REQUIRERATE','http://www.sendfromchina.com/shipfee/out_rates');

        $shippingType = $_POST['shippingType'];
        if($shippingType == 1){//use default shipping address
        $address = $_SESSION['defaultAddress']['string'];
        }elseif($shippingType == 2){
        $firstname = @$_POST['firstname'];
        $lastname = @$_POST['lastname'];
        $street_address = @$_POST['street_address'];
        $suburb = @$_POST['suburb'];
        $zone = @$_POST['zone'];
        $postcode = @$_POST['postcode'];
        $countryName = @$_POST['countryName'];
        $phone = @$_POST['phone'];
        $city = @$_POST['city'];

        $address = $firstname." ".$lastname."</br>".
        $street_address.' '.$suburb."</br>".
        $city.','.$postcode."</br>".
        $countryName."</br>".
        "Phone:".$phone;
        }else{
        Header("Location: ./shippingaddress.php");
        break;
        }
        $countryName = @$_POST['countryName'];
        $quantity = @$_POST['quantity'];
        if($quantity == null){
        $quantity = 1;
        }

        if($countryName == null){
        $countryName = "Canada";
        }
        $_SESSION['order']['shippingAddress'] = $address;
        $_SESSION['order']['countryName'] = $countryName;
        $_SESSION['order']['quantity'] = $quantity;



        $preItemFee = 18;
        $preWeight = 0.125;
        $profile = '?country='.$countryName.'&weight='.$preWeight*$quantity;


        ?>





        <h4> shipping address:</h4>
        <div style="margin-left:15px">

        <p><?php echo $address; ?>
        </p>
        </p>
        <p>&nbsp; </p>
        </div>



        <div style="width:95%; height:auto">
        <form action="./order.php" method="post">
        <ul>
        Please select the preferred shipping method to use on this order.
        </ul>

        <?php
        $doc = new DOMDocument();

        $doc->load( REQUIRERATE .$profile);
        // Load the call and capture the document returned by sendfromchina.com API
        $dataset = $doc->getElementsByTagName( "rate" );
        // Check to see if the response was loaded, else print an error
        if(@$dataset->item(0)->nodeValue){
        $Rates =NULL;
        foreach( $dataset as $row ){
        $totalfees = $row->getElementsByTagName( "totalfee" );
        $totalfee = $totalfees->item(0)->nodeValue;
        $deliverytimes = $row->getElementsByTagName( "deliverytime" );
        $deliverytime = $deliverytimes->item(0)->nodeValue;
        $iftrackings = $row->getElementsByTagName( "iftracking" );
        $iftracking = $iftrackings->item(0)->nodeValue;
        $classtypes = $row->getElementsByTagName( "classtype" );
        $classtype = $classtypes->item(0)->nodeValue;
        $byvolumes = $row->getElementsByTagName( "byvolume" );
        $byvolume = $byvolumes->item(0)->nodeValue;
        $shiptypes = $row->getElementsByTagName( "shiptypename" );
        $shiptypename = $shiptypes->item(0)->nodeValue;
        $classtypecodes = $row->getElementsByTagName( "classtypecode" );
        $classtypecode = $classtypecodes->item(0)->nodeValue;
        $shiptypecodes = $row->getElementsByTagName( "shiptypecode" );
        $shiptypecode = $shiptypecodes->item(0)->nodeValue;


        switch ($classtypecode){
        case 'CPS':

        $name = 'Standard';
        break;
        case 'CRP':

        $name = 'Registered';
        break;
        case 'CRE':

        $name = 'Expedited';
        break;
        }
        if(@$Rates[$classtypecode] != 1){
        $Rates[$classtypecode] =1;
        ?>

        <ul>
        <input name="shipping" value="<?php echo $shiptypecode ?> " id="shipping" rule="shipping" type="radio" checked="checked">
        <label for="ship-chinaups-chinaups"> <strong><?php echo $name ?></strong> .............................................................. <strong> CNY&#165;<?php echo $totalfee ?> </strong></label>
        </ul>
        <ul>
        Delivery Estimates: <?php echo $deliverytime ?> days to major destinations.
        </ul>

        <?php

        }

        }

        }
        ?>

        <input type="submit" value="Submit" />
        </form>
        </div>

order.php

        <?php
        session_start();
        define('REQUIRERATE','http://www.sendfromchina.com/shipfee/out_rates');
        $method = trim($_POST['shipping']);

        if($method == null){
        Header("Location: ./checkout.php");
        break;
        }
        $quantity = $_SESSION['order']['quantity'];
        $address = $_SESSION['order']['shippingAddress'];
        $countryName = $_SESSION['order']['countryName'] ;
        $preItemFee = 18;
        $preWeight = 0.125;
        $profile = '?country='.$countryName.'&weight='.$preWeight*$quantity;
        //Construct the GetShippingRate By mode
        $profile .= '&mode='.$method;

        ?>

        <h2>Order Information</h2>
        <h4>Item</h4>
        <table cellpadding="1" border="1" width="100%">
        <tr>
        <td><strong>Item</strong> </td>
        <td><strong>Product Name</strong> </td>
        <td><strong>Quantity</strong> </td>
        <td><strong>Pre Price</strong> </td>
        <td><strong>Price</strong></td>
        </tr>
        <tr>
        <td><img src="./img/item1.jpg" width="85" border="0" height="85"></a> </td>
        <td>Super Quad Band Cellphone Plays Movies / + Camera </td>
        <td> <?php echo $quantity; ?> </td>
        <td>CNY&#165;<?php echo $preItemFee; ?></td>
        <td>CNY&#165;<?php echo $preItemFee*$quantity; ?> </td>
        </tr>
        </table>
        <br />
        <h4> shipping address:</h4>
        <div style="margin-left:15px">

        <?php echo $address; ?>

        </div>

        <h4> shipping method:</h4>
        <table cellpadding="1" border="1" width="100%">
        <tr>
        <td><strong>Shipping Service</strong> </td>
        <td><strong>Iship Shipping Type Code</strong> </td>
        <td><strong>Shipping Time</strong> </td>
        <td><strong>Shipping Price</strong> </td>

        </tr>
        <?php
        $doc = new DOMDocument();
        $doc->load( REQUIRERATE .$profile);
        // Load the call and capture the document returned by sendfromchina.com API
        $dataset = $doc->getElementsByTagName( "rate" );
        // Check to see if the response was loaded, else print an error
        if(@$dataset->item(0)->nodeValue){


        $totalfees = $doc->getElementsByTagName( "totalfee" );
        $totalfee = $totalfees->item(0)->nodeValue;
        $deliverytimes = $doc->getElementsByTagName( "deliverytime" );
        $deliverytime = $deliverytimes->item(0)->nodeValue;
        $iftrackings = $doc->getElementsByTagName( "iftracking" );
        $iftracking = $iftrackings->item(0)->nodeValue;
        $classtypes = $doc->getElementsByTagName( "classtype" );
        $classtype = $classtypes->item(0)->nodeValue;
        $byvolumes = $doc->getElementsByTagName( "byvolume" );
        $byvolume = $byvolumes->item(0)->nodeValue;
        $shiptypes = $doc->getElementsByTagName( "shiptypename" );
        $shiptypename = $shiptypes->item(0)->nodeValue;
        $shiptypecodes = $doc->getElementsByTagName( "shiptypecode" );
        $shiptypecode = $shiptypecodes->item(0)->nodeValue;
        ?>
        <tr>

        <td><?php echo $shiptypename; ?></td>
        <td><?php echo $shiptypecode;?></td>
        <td><?php echo $deliverytime;?></td>
        <td><?php echo $totalfee; ?></td>

        </tr>
        <?php

        }
        ?>

        </table>

三态速递系统数据接口（API）

案例演示

获取代码

案例演示

获取代码

案例演示

获取代码

关于我们

客户支持

个性化服务

投诉&举报