~~NOTOC~~

======话单和计费======
{| style="width:90%;"
! style="width:15em;"|事件名称
! style="width:10em;"|Event
! |说明
|-
|[[#话单上报事件|话单上报事件]]
|callbillrpt
|呼叫中坐席和用户都已经挂机，会话结束，触发话单上报事件，上报话单详情
|-
|[[#计费状态事件| 计费状态事件]]
|caccstaterpt
|呼叫过程，余额不足，通话超过最长时间，计费服务器响应异常时等都会上报计费状态。
|}
  *  账单详情可以通过[[..billlist_api|应用话单下载]]。
  
===== 数据结构说明 =====


==== 详单对象 ====
{| style="width:90%;"
! |属性
! |类型
!style="text-align:center;width:3em;"|约束
! |说明
|-
|serviceId
|String
|style="text-align:center;"|可选
|坐席ID号
|-
|callMethod
|String
|style="text-align:center;"|可选
|坐席通话方式
|-
|serviceTime
|String
|style="text-align:center;"|可选
|坐席通话时间
|-
|startTime
|String
|style="text-align:center;"|必选
|坐席开始通话时间
|}
==== 话单上报事件 ====
{| style="width:90%;"
! |属性
! |类型
!style="text-align:center;width:3em;"|约束
! |说明
|-
|event
|String
|style="text-align:center;"|必选
|事件名称 callbillrpt
|-
|appId
|String
|style="text-align:center;"|必选
|应用唯一标识
|-
|callId
|String
|style="text-align:center;"|必选
|呼叫ID
|-
|callerCode
|String
|style="text-align:center;"|必选
|主叫号码
|-
|calledCode
|String
|style="text-align:center;"|必选
|被叫号码
|-
|totalTime
|String
|style="text-align:center;"|必选
|通话总时长
|-
|ivrTime
|String
|style="text-align:center;"|必选
|ivr时长
|-
|userTime
|String
|style="text-align:center;"|必选
|用户通话时长
|-
|serviceTime
|String
|style="text-align:center;"|必选
|坐席时长
|-
|tts
|String
|style="text-align:center;"|必选
|tts次数
|-
|hangupReason
|String
|style="text-align:center;"|必选
|挂机原因
|-
|charge
|String
|style="text-align:center;"|必选
|通话费用
|-
|rowspan="3"|detailList
|rowspan="3"|String
|style="text-align:center;",rowspan="3"|必选
|坐席账单详情 参考[[#详单对象|详单对象]]
|}
----
<hidden 通知示例>
<code xml>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<request>
   <appId>247e35ff320a4142a105024055c367cf </appId>
   <callId>2015100908563101533CTI</serviceId>
   <callerCode>075586682088</callerCode>
   <calledCode>075586682088</calledCode>
   <totalTime>20</totalTime>
   <userTime>20</userTime>
   <ivrTime>5</ivrTime>
   <serviceTime>15</serviceTime>
   <tts>0</tts>
   <charge>0</charge>
   <event>callbillrpt</event>
   <timeStamp>20160131170852107</timeStamp>
   <detailList>
       <Detail>
            <callMethod>PHONE</callMethod>
            <serviceId>69864060011630</serviceId>
            <serviceTime>6</serviceTime>
            <startTime>20160305103430</startTime>
        </Detail>
        <Detail>
            <callMethod>PHONE</callMethod>
            <serviceId>69864060011630</serviceId>
            <serviceTime>4</serviceTime>
            <startTime>20160305103452</startTime>
        </Detail>
   </detailList>
</request>
</code>
</hidden>

----
==== 计费状态事件 ====
{| style="width:90%;"
! |属性
! |类型
!style="text-align:center;width:3em;"|约束
! |说明
|-
|event
|String
|style="text-align:center;"|必选
|事件名称 caccstaterpt
|-
|appId
|String
|style="text-align:center;"|必选
|应用唯一标识
|-
|callId
|String
|style="text-align:center;"|必选
|呼叫ID
|-
|errorCode
|Int
|style="text-align:center;"|可选
|错误码
  * 0: 正常
  * 1：余额不足
  * 2：超过最大通话时长（2H）
  * 其他：系统内部错误

|}

----
<hidden 通知示例>
<code xml>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<request>
    <event> caccstaterpt </event>
    <callId> 7dbc2536-c01d-11e5-a5b4-5d5dac84681f </callId>
    <appId> bb8e39dee6a24cedbb23970fa83b4114 </appId>
    <errorCode>1</errorCode>
    <timeStamp>20160131170852107</timeStamp>
</request>
</code>
</hidden>