【顺丰快递管家】通用接口文档


获取月结账单明细

<p>&gt; 根据月结卡号查询指定月份费用明细。对应月结卡号需要找产品经理开通业务。</p> <p>请求接口:/public/monthlyCardBill/getBspBillDetail</p> <p>请求方法:POST</p> <p>请求类型:JSON</p> <p>请求参数:</p> <table> <thead> <tr> <th>参数名称</th> <th style="text-align: center;">参数类型</th> <th style="text-align: center;">是否必填</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td>monthlyCardNo</td> <td style="text-align: center;">String</td> <td style="text-align: center;">是</td> <td>月结卡号</td> </tr> <tr> <td>month</td> <td style="text-align: center;">String</td> <td style="text-align: center;">否</td> <td>查询月份,空为查询上月,格式yyyy-MM</td> </tr> </tbody> </table> <p>请求示例:</p> <pre><code class="language-json">{&amp;quot;monthlyCardNo&amp;quot;:&amp;quot;0123456&amp;quot;,&amp;quot;month&amp;quot;:&amp;quot;2023-01&amp;quot;}</code></pre> <p>响应参数:</p> <table> <thead> <tr> <th>参数名称</th> <th style="text-align: center;">参数类型</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td>businessName</td> <td style="text-align: center;">String</td> <td>业务名称</td> </tr> <tr> <td>businessType</td> <td style="text-align: center;">String</td> <td>业务类型,expressWaybill:快递运单费用,expressSameCity:同城服务费用</td> </tr> <tr> <td>details</td> <td style="text-align: center;">List&lt;Array&gt;</td> <td>明细列表,名称对应明细模版下标</td> </tr> <tr> <td>detailsTemplate</td> <td style="text-align: center;">List&lt;Object&gt;</td> <td>明细模版,赋值对应明细列表下标</td> </tr> <tr> <td>nameCn</td> <td style="text-align: center;">String</td> <td>字段中文名称</td> </tr> <tr> <td>nameEn</td> <td style="text-align: center;">String</td> <td>字段英文名称</td> </tr> </tbody> </table> <p>响应示例:</p> <pre><code class="language-json">// 响应成功示例 {   &amp;quot;result&amp;quot;: [     {       &amp;quot;businessName&amp;quot;: &amp;quot;快递运单费用&amp;quot;,       &amp;quot;businessType&amp;quot;: &amp;quot;expressWaybill&amp;quot;,       &amp;quot;details&amp;quot;: [         [           &amp;quot;11-03&amp;quot;,           &amp;quot;SF012345678&amp;quot;,           &amp;quot;北京&amp;quot;,           &amp;quot;北京&amp;quot;,           &amp;quot;&amp;quot;,           &amp;quot;1&amp;quot;,           &amp;quot;顺丰标快&amp;quot;,           &amp;quot;寄转第三方&amp;quot;,           &amp;quot;10&amp;quot;,           &amp;quot;4&amp;quot;,           &amp;quot;10&amp;quot;,           &amp;quot;赵先生&amp;quot;,           &amp;quot;&amp;quot;,           &amp;quot;888-8888888&amp;quot;,           &amp;quot;999-9999999&amp;quot;,           &amp;quot;赵先生&amp;quot;,           &amp;quot;2023-03-01 14:54&amp;quot;,           &amp;quot;北京&amp;quot;,           &amp;quot;北京市北京市昌平区北京市昌平区&amp;quot;,           &amp;quot;0123456&amp;quot;,           &amp;quot;文件&amp;quot;,           &amp;quot;1&amp;quot;,           &amp;quot;&amp;quot;,           &amp;quot;0&amp;quot;,           &amp;quot;北京&amp;quot;,           &amp;quot;朱女士&amp;quot;,           &amp;quot;北京市北京市朝阳区北京市朝阳区&amp;quot;,           &amp;quot;1&amp;quot;,           &amp;quot;&amp;quot;,           &amp;quot;2023-03-02 09:19&amp;quot;,           &amp;quot;&amp;quot;,           &amp;quot;9999999999&amp;quot;,           &amp;quot;cd0c92981e694c1281b7632cc198933211&amp;quot;         ]       ],       &amp;quot;detailsTemplate&amp;quot;: [         {           &amp;quot;nameCn&amp;quot;: &amp;quot;日期&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;billingDate&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;运单号码&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;waybillno&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;寄件地区&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;senderCity&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;到件地区&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;receiverCity&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;对方公司名称&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;otherCompanyName&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;计费重量&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;feeWeight&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;产品类型&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;productType&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;付款方式&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;incomeTypeName&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;费用(元)&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;payAmount&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;折扣/促销&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;rebateAmount&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;应付金额&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;shouldPayAmount&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;经手人&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;handName&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;增值费用&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;serviceFeeName&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;寄件公司电话&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;senderPhone&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;到方客户电话&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;receiverPhone&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;寄件人&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;sender&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;寄件时间&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;pickUpDate&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;始发地(省名)&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;senderProvince&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;寄件公司地址&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;senderAddress&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;收件人工号&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;pickUpEmp&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;托寄物内容&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;cargo&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;托寄物数量&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;cargoQuantity&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;声明价值&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;value&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;体积&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;volume&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;目的地(省名)&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;receiverProvince&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;收件人&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;receiver&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;收件地址&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;receiverAddress&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;实际重量&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;totalWeight&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;回单单号&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;returnTracking&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;签收时间&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;signTime&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;退回件关联运单号&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;sourceWaybill&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;子公司卡号&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;payerCustCode&amp;quot;         },         {           &amp;quot;nameCn&amp;quot;: &amp;quot;订单号&amp;quot;,           &amp;quot;nameEn&amp;quot;: &amp;quot;orderNo&amp;quot;         }       ]     }   ],   &amp;quot;succ&amp;quot;: &amp;quot;ok&amp;quot;,   &amp;quot;msg&amp;quot;: null }</code></pre>

页面列表

ITEM_HTML