<html>
<head>
    <base href="https://wiki.asterisk.org/wiki">
            <link rel="stylesheet" href="/wiki/s/en/2172/18/9/_/styles/combined.css?spaceKey=AST&amp;forWysiwyg=true" type="text/css">
    </head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
    <h2><a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+ManagerAction_AOCMessage">Asterisk 11 ManagerAction_AOCMessage</a></h2>
    <h4>Page  <b>added</b> by             <a href="https://wiki.asterisk.org/wiki/display/~wikibot">Wiki Bot</a>
    </h4>
         <br/>
    <div class="notificationGreySide">
         <h1><a name="Asterisk11ManagerAction_AOCMessage-AOCMessage"></a>AOCMessage</h1>

<h3><a name="Asterisk11ManagerAction_AOCMessage-Synopsis"></a>Synopsis</h3>

<p>Generate an Advice of Charge message on a channel.</p>
<h3><a name="Asterisk11ManagerAction_AOCMessage-Description"></a>Description</h3>



<p>Generates an AOC-D or AOC-E message on a channel.</p>

<h3><a name="Asterisk11ManagerAction_AOCMessage-Syntax"></a>Syntax</h3>

<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>Action: AOCMessage
ActionID: &lt;value&gt;
Channel: &lt;value&gt;
ChannelPrefix: &lt;value&gt;
MsgType: &lt;value&gt;
ChargeType: &lt;value&gt;
UnitAmount(0): &lt;value&gt;
UnitType(0): &lt;value&gt;
CurrencyName: &lt;value&gt;
CurrencyAmount: &lt;value&gt;
CurrencyMultiplier: &lt;value&gt;
TotalType: &lt;value&gt;
AOCBillingId: &lt;value&gt;
ChargingAssociationId: &lt;value&gt;
ChargingAssociationNumber: &lt;value&gt;
ChargingAssociationPlan: &lt;value&gt;
</pre>
</div></div>
<h5><a name="Asterisk11ManagerAction_AOCMessage-Arguments"></a>Arguments</h5>


<ul>
        <li>ActionID - ActionID for this transaction. Will be returned.</li>
        <li>Channel - Channel name to generate the AOC message on.</li>
        <li>ChannelPrefix - Partial channel prefix. By using this option one can match the beginning part of a channel name without having to put the entire name in. For example if a channel name is SIP/snom-00000001 and this value is set to SIP/snom, then that channel matches and the message will be sent. Note however that only the first matched channel has the message sent on it.</li>
        <li>MsgType - Defines what type of AOC message to create, AOC-D or AOC-E
        <ul>
                <li>D</li>
                <li>E</li>
        </ul>
        </li>
        <li>ChargeType - Defines what kind of charge this message represents.
        <ul>
                <li>NA</li>
                <li>FREE</li>
                <li>Currency</li>
                <li>Unit</li>
        </ul>
        </li>
        <li>UnitAmount(0) - This represents the amount of units charged. The ETSI AOC standard specifies that this value along with the optional UnitType value are entries in a list. To accommodate this these values take an index value starting at 0 which can be used to generate this list of unit entries. For Example, If two unit entires were required this could be achieved by setting the paramter UnitAmount(0)=1234 and UnitAmount(1)=5678. Note that UnitAmount at index 0 is required when ChargeType=Unit, all other entries in the list are optional.</li>
        <li>UnitType(0) - Defines the type of unit. ETSI AOC standard specifies this as an integer value between 1 and 16, but this value is left open to accept any positive integer. Like the UnitAmount parameter, this value represents a list entry and has an index parameter that starts at 0.</li>
        <li>CurrencyName - Specifies the currency's name. Note that this value is truncated after 10 characters.</li>
        <li>CurrencyAmount - Specifies the charge unit amount as a positive integer. This value is required when ChargeType==Currency.</li>
        <li>CurrencyMultiplier - Specifies the currency multiplier. This value is required when ChargeType==Currency.
        <ul>
                <li>OneThousandth</li>
                <li>OneHundredth</li>
                <li>OneTenth</li>
                <li>One</li>
                <li>Ten</li>
                <li>Hundred</li>
                <li>Thousand</li>
        </ul>
        </li>
        <li>TotalType - Defines what kind of AOC-D total is represented.
        <ul>
                <li>Total</li>
                <li>SubTotal</li>
        </ul>
        </li>
        <li>AOCBillingId - Represents a billing ID associated with an AOC-D or AOC-E message. Note that only the first 3 items of the enum are valid AOC-D billing IDs
        <ul>
                <li>Normal</li>
                <li>ReverseCharge</li>
                <li>CreditCard</li>
                <li>CallFwdUnconditional</li>
                <li>CallFwdBusy</li>
                <li>CallFwdNoReply</li>
                <li>CallDeflection</li>
                <li>CallTransfer</li>
        </ul>
        </li>
        <li>ChargingAssociationId - Charging association identifier. This is optional for AOC-E and can be set to any value between -32768 and 32767</li>
        <li>ChargingAssociationNumber - Represents the charging association party number. This value is optional for AOC-E.</li>
        <li>ChargingAssociationPlan - Integer representing the charging plan associated with the ChargingAssociationNumber. The value is bits 7 through 1 of the Q.931 octet containing the type-of-number and numbering-plan-identification fields.</li>
</ul>



<h3><a name="Asterisk11ManagerAction_AOCMessage-ImportVersion"></a>Import Version</h3>

<p>This documentation was imported from Asterisk Version SVN-trunk-r370322</p>
    </div>
    <div id="commentsSection" class="wiki-content pageSection">
       <div style="float: right;" class="grey">
                        <a href="https://wiki.asterisk.org/wiki/users/removespacenotification.action?spaceKey=AST">Stop watching space</a>
            <span style="padding: 0px 5px;">|</span>
                <a href="https://wiki.asterisk.org/wiki/users/editmyemailsettings.action">Change email notification preferences</a>
</div>
       <a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+ManagerAction_AOCMessage">View Online</a>
              |
       <a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+ManagerAction_AOCMessage?showComments=true&amp;showCommentArea=true#addcomment">Add Comment</a>
           </div>
</div>
</div>
</div>
</div>
</body>
</html>