Skip to end of metadata
Go to start of metadata



Generate an Advice of Charge message on a channel.


Generates an AOC-D or AOC-E message on a channel.


Action: AOCMessage
ActionID: <value>
Channel: <value>
ChannelPrefix: <value>
MsgType: <value>
ChargeType: <value>
UnitAmount(0): <value>
UnitType(0): <value>
CurrencyName: <value>
CurrencyAmount: <value>
CurrencyMultiplier: <value>
TotalType: <value>
AOCBillingId: <value>
ChargingAssociationId: <value>
ChargingAssociationNumber: <value>
ChargingAssociationPlan: <value>
  • ActionID - ActionID for this transaction. Will be returned.
  • Channel - Channel name to generate the AOC message on.
  • 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.
  • MsgType - Defines what type of AOC message to create, AOC-D or AOC-E
    • D
    • E
  • ChargeType - Defines what kind of charge this message represents.
    • NA
    • FREE
    • Currency
    • Unit
  • 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.
  • 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.
  • CurrencyName - Specifies the currency's name. Note that this value is truncated after 10 characters.
  • CurrencyAmount - Specifies the charge unit amount as a positive integer. This value is required when ChargeType==Currency.
  • CurrencyMultiplier - Specifies the currency multiplier. This value is required when ChargeType==Currency.
    • OneThousandth
    • OneHundredth
    • OneTenth
    • One
    • Ten
    • Hundred
    • Thousand
  • TotalType - Defines what kind of AOC-D total is represented.
    • Total
    • SubTotal
  • 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
    • Normal
    • ReverseCharge
    • CreditCard
    • CallFwdUnconditional
    • CallFwdBusy
    • CallFwdNoReply
    • CallDeflection
    • CallTransfer
  • ChargingAssociationId - Charging association identifier. This is optional for AOC-E and can be set to any value between -32768 and 32767
  • ChargingAssociationNumber - Represents the charging association party number. This value is optional for AOC-E.
  • 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.

See Also

Import Version

This documentation was imported from Asterisk Version SVN-branch-1.8-r404456

  • No labels