星灿保代保险平台接口文档

苏宁保与外部的接口文档


报文格式

<h2>格式说明</h2> <table> <thead> <tr> <th style="text-align: left;">报文块</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">声明部分</td> <td style="text-align: left;">以&lt;?xml version=&quot;1.0&quot; encoding=&quot;GBK&quot;?&gt;为格式声明</td> </tr> <tr> <td style="text-align: left;">根节点</td> <td style="text-align: left;">以<PackageList>为起始标记,以</PackageList>为结束标记。可以包含多个<Package>节点</td> </tr> <tr> <td style="text-align: left;">报文根</td> <td style="text-align: left;">以<Package>为起始标记,以</Package>为结束标记</td> </tr> <tr> <td style="text-align: left;">报文头</td> <td style="text-align: left;">以<strong>&lt;</strong>Header&gt;为起始标记,以<strong>&lt;</strong>/Header&gt;为结束标记</td> </tr> <tr> <td style="text-align: left;">报文体</td> <td style="text-align: left;">以<Request>或<Response>为起始标记,以</Request>或</Response>为结束标记。(星灿请求用<Request>,保险公司请求用<Callback>,应答方用<Response>)</td> </tr> </tbody> </table> <h2>请求报文</h2> <p>请求报文包括星灿主动发起的报文以及保险公司主动发起的报文(如出单异步模式下的回调)。请求报文的报文头是固定的,星灿请求与保险公司请求头信息略有不同。</p> <h3>星灿发起请求</h3> <p>星灿发起请求报文头信息如下:</p> <table> <thead> <tr> <th style="text-align: left;">No.</th> <th style="text-align: left;">字段</th> <th style="text-align: left;">字段名</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">必传</th> <th style="text-align: left;">备注</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">1</td> <td style="text-align: left;">RequestType</td> <td style="text-align: left;">交易类型</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">见每个接口中的交易类型说明</td> </tr> <tr> <td style="text-align: left;">2</td> <td style="text-align: left;">UUID</td> <td style="text-align: left;">唯一标识</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">3</td> <td style="text-align: left;">ComCode</td> <td style="text-align: left;">保险公司编码</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">4</td> <td style="text-align: left;">SourceCode</td> <td style="text-align: left;">发送方编码</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">5</td> <td style="text-align: left;">SendTime</td> <td style="text-align: left;">发送时间</td> <td style="text-align: left;">时间</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">6</td> <td style="text-align: left;">SuningOrderNo</td> <td style="text-align: left;">苏宁交易流水号</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">星灿保代订单号</td> </tr> <tr> <td style="text-align: left;">7</td> <td style="text-align: left;">ComOrderNo</td> <td style="text-align: left;">保险公司流水号</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;">保险公司发起时,必填</td> </tr> <tr> <td style="text-align: left;">8</td> <td style="text-align: left;">Asyn</td> <td style="text-align: left;">是否异步接口</td> <td style="text-align: left;">布尔</td> <td style="text-align: left;">N</td> <td style="text-align: left;">缺省值false,表示同步</td> </tr> <tr> <td style="text-align: left;">9</td> <td style="text-align: left;">ReturnUrl</td> <td style="text-align: left;">回调Url</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">10</td> <td style="text-align: left;">ProductCode</td> <td style="text-align: left;">险种编码</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> </tbody> </table> <h3>请求报文示例</h3> <pre><code>&lt;?xml version="1.0" encoding="GBK"?&gt; &lt;PackageList&gt; &lt;Package&gt;     &lt;Header&gt;         &lt;RequestType&gt;01&lt;/RequestType&gt;         &lt;UUID&gt;14336376457645768578&lt;/UUID&gt; &lt;ComCode&gt;123456&lt;/ComCode&gt; &lt;SourceCode&gt;suning.com&lt;/SourceCode&gt; &lt;SendTime&gt;2015-11-05 18:00:00&lt;/SendTime &lt;SuningOrderNo&gt;1234567890&lt;/SuningOrderNo&gt; &lt;ComOrderNo&gt;&lt;/ComOrderNo&gt; &lt;Asyn&gt;false&lt;/ Asyn&gt; &lt;ReturnUrl&gt;http://baoxian.suning.com/ins/licai.htm?xxxxxx&lt;/ReturnUrl&gt; &lt;ProductCode&gt;123456&lt;/ProductCode&gt;     &lt;/Header&gt;         &lt;Request&gt;</code></pre> <p>        ……         </Request> </Package> </PackageList></p> <h3>保险公司发起请求</h3> <p>保险公司发起请求报文头信息如下:</p> <table> <thead> <tr> <th style="text-align: left;">No.</th> <th style="text-align: left;">字段</th> <th style="text-align: left;">字段名</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">必传</th> <th style="text-align: left;">备注</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">1</td> <td style="text-align: left;">RequestType</td> <td style="text-align: left;">交易类型</td> <td style="text-align: left;">枚举</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">见每个接口中的交易类型说明</td> </tr> <tr> <td style="text-align: left;">2</td> <td style="text-align: left;">UUID</td> <td style="text-align: left;">唯一标识</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">3</td> <td style="text-align: left;">ComCode</td> <td style="text-align: left;">保险公司编码</td> <td style="text-align: left;">枚举</td> <td style="text-align: left;">Y</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">4</td> <td style="text-align: left;">SourceCode</td> <td style="text-align: left;">发送方编码</td> <td style="text-align: left;">枚举</td> <td style="text-align: left;">Y</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">5</td> <td style="text-align: left;">SendTime</td> <td style="text-align: left;">发送时间</td> <td style="text-align: left;">时间</td> <td style="text-align: left;">Y</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">6</td> <td style="text-align: left;">SuningOrderNo</td> <td style="text-align: left;">苏宁交易流水号</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">星灿保代订单号</td> </tr> <tr> <td style="text-align: left;">7</td> <td style="text-align: left;">ComOrderNo</td> <td style="text-align: left;">保险公司流水号</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> </tbody> </table> <h3>请求报文示例</h3> <pre><code>&lt;?xml version="1.0" encoding="GBK"?&gt; &lt;PackageList&gt; &lt;Package&gt;</code></pre> <p>    <Header>         <RequestType>01</RequestType>         <UUID>14336376457645768578</UUID>         <ComCode>123456</ComCode>         <SourceCode>suning.com</SourceCode>         <SendTime>2014-04-22 18:00:00</SendTime>         <SuningOrderNo>1234567890</SuningOrderNo>         <ComOrderNo></ComOrderNo>     </Header>         <Callback>          ……         </Callback> </Package> </PackageList></p> <h2>返回报文</h2> <p>返回报文包括星灿发起保险公司响应的报文,也包括保险公司发起星灿回复的报文。两者的报文头格式相同。对于异步请求的返回报文,仅包括数据头部分;对于同步请求的返回报文,可能还包括一些业务反馈。 返回报文头信息如下:</p> <table> <thead> <tr> <th style="text-align: left;">No.</th> <th style="text-align: left;">字段</th> <th style="text-align: left;">字段名</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">必传</th> <th style="text-align: left;">备注</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">1</td> <td style="text-align: left;">RequestType</td> <td style="text-align: left;">交易类型</td> <td style="text-align: left;">枚举</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">见2.2交易类型</td> </tr> <tr> <td style="text-align: left;">2</td> <td style="text-align: left;">UUID</td> <td style="text-align: left;">唯一标识</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">3</td> <td style="text-align: left;">ComCode</td> <td style="text-align: left;">保险公司编码</td> <td style="text-align: left;">枚举</td> <td style="text-align: left;">Y</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">4</td> <td style="text-align: left;">SourceCode</td> <td style="text-align: left;">发送方编码</td> <td style="text-align: left;">枚举</td> <td style="text-align: left;">Y</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">5</td> <td style="text-align: left;">SendTime</td> <td style="text-align: left;">发送时间</td> <td style="text-align: left;">时间</td> <td style="text-align: left;">Y</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">6</td> <td style="text-align: left;">SuningOrderNo</td> <td style="text-align: left;">苏宁交易流水号</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">星灿保代订单号</td> </tr> <tr> <td style="text-align: left;">7</td> <td style="text-align: left;">ComOrderNo</td> <td style="text-align: left;">保险公司流水号</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">8</td> <td style="text-align: left;">ResponseCode</td> <td style="text-align: left;">应答返回码</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">见<a href="https://www.showdoc.com.cn/snisc/8804076964739320" title="返回码定义">返回码定义</a></td> </tr> <tr> <td style="text-align: left;">9</td> <td style="text-align: left;">ResponseInfo</td> <td style="text-align: left;">应答返回信息</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;"></td> </tr> </tbody> </table> <h2>返回报文示例</h2> <pre><code>&lt;?xml version="1.0" encoding="GBK"?&gt; &lt;PackageList&gt; &lt;Package&gt; &lt;Header&gt; &lt;RequestType&gt;01&lt;/RequestType&gt; &lt;UUID&gt;14336376457645768578&lt;/UUID&gt; &lt;ComCode&gt;123456&lt;/ComCode&gt; &lt;SourceCode&gt;suning.com&lt;/SourceCode&gt; &lt;SendTime&gt;2015-11-06 18:00:00&lt;/SendTime&gt; &lt;SuningOrderNo&gt;20151106235689&lt;/SuningOrderNo&gt; &lt;ComOrderNo&gt;&lt;/ComOrderNo&gt; &lt;ResponseCode&gt;500&lt;/ResponseCode&gt; &lt;ResponseInfo&gt;成功&lt;/ResponseInfo&gt; &lt;/Header&gt; &lt;Response&gt;</code></pre> <p>         …… </Response> </Package> </PackageList></p>

页面列表

ITEM_HTML