VOS3000 CDR Billing Mode Codes Accurate -1 0 1 3 Reference
Every call detail record in VOS3000 carries a billingMode field that tells you exactly how โ and whether โ that call was charged. The four VOS3000 CDR billing mode codes (-1, 0, 1, and 3) are the key to understanding your billing data, detecting revenue leaks, and auditing your call accounting accuracy. Yet many operators treat this field as an afterthought, only discovering its importance when a billing dispute arises or a revenue discrepancy demands investigation.
The billingMode field (Field 17 in the pipe-delimited CDR format) determines which type of account was charged for the call. A code of -1 means no billing was applied at all. A code of 0 means the call was billed to a phone number account. A code of 1 means it was billed to a gateway ID. A code of 3 means it was billed to a phone card (calling card). Each code has distinct implications for how the billing engine calculates charges, which rate table is referenced, and how the revenue is attributed in your financial reports. Misunderstanding even one of these codes can lead to incorrect billing analysis and lost revenue.
This guide provides an accurate, manual-verified reference for all four VOS3000 CDR billing mode codes. All code definitions are sourced from the official VOS3000 2.1.8.0/2.1.9.07 English manual ยง4.4 (page 242), with detailed explanations of how each code affects billing calculations, which account types they correspond to, and how to use them in CDR analysis and reporting.
Table of ContentsVOS3000 CDR Billing Mode Codes Accurate -1 0 1 3 Reference What Are VOS3000 CDR Billing Mode Codes? VOS3000 CDR Billing Mode Code -1: No Billing โ VOS3000 CDR Billing Mode When Does Billing Mode -1 Occur? VOS3000 CDR Billing Mode Code 0: Phone Number Billing How Phone Number Billing Works VOS3000 CDR Billing Mode 1: Gateway ID Billing How Gateway ID Billing Works โ VOS3000 CDR Billing Mode VOS3000 CDR Billing Mode 3: Phone Card Billing How Phone Card Billing Works Complete VOS3000 CDR Billing Mode Codes Comparison Table VOS3000 CDR Billing Mode Distribution Analysis VOS3000 CDR Billing Mode and Related VOS3000 Parameters Common VOS3000 CDR Billing Mode Code Problems and Solutions Problem 1: Revenue Calls Showing billingMode = -1 Problem 2: Wrong Billing Mode for Gateway Calls Problem 3: Unexpected billingMode = 3 Without Calling Card Service VOS3000 CDR Billing Mode Code Best Practices Frequently Asked Questions What does billingMode = -1 mean in VOS3000 CDR? โ VOS3000 CDR Billing Mode What is the difference between billingMode 0 and billingMode 1? Can a call have different billing modes for caller and callee sides? Why do I see billingMode = -1 for legitimate calls? Is billingMode = 3 only for calling card services? How do I filter CDRs by billing mode in VOS3000 client? Need Expert Help with VOS3000 CDR Billing Mode Codes? Need Professional VOS3000 Setup Support?
What Are VOS3000 CDR Billing Mode Codes?
The VOS3000 CDR billing mode codes appear in the billingMode field (position 17) of every CDR record in the pipe-delimited text export. They indicate the charge mode โ the type of billing entity that was used to calculate and record charges for the call. This is distinct from the billing method field (position 16, calleeBilling), which indicates whether the caller or callee is charged. The billing mode tells you what kind of account was charged, while the billing method tells you which party was charged.
Why billing mode codes matter:
Revenue attribution: Knowing which account type generated revenue helps you track income by business segment (retail phone, wholesale gateway, calling card)
Fraud detection: An unexpected billing mode code in a CDR may indicate configuration errors or unauthorized access
Reporting accuracy: Billing reports must separate revenue by account type for financial and regulatory purposes
Audit compliance: Regulators may require documentation of how each call was billed and which account was charged
Troubleshooting: Calls with billingMode = -1 that should have been billed indicate a billing configuration problem
CDR field location: The billingMode field is at position 17 in the VOS3000 pipe-delimited CDR format, as documented in the official manual ยง4.4 (page 242). It appears after the calleeBilling field and before the callerPdd field.
VOS3000 CDR Billing Mode Code -1: No Billing โ VOS3000 CDR Billing Mode
A billingMode of -1 means the call was not billed at all. No charges were calculated, no account was debited, and no billing record was generated for the call โ although the CDR itself is still recorded for operational and security purposes.
AttributeDetail Code-1 Manual DescriptionNo billing (VOS3000 manual ยง4.4: โbobillingโ โ a typo for โno billingโ) Billing AppliedNone โ call is completely exempt from charges Account DebitedNo account is debited
When Does Billing Mode -1 Occur?
There are several scenarios where a call receives a billingMode of -1 in VOS3000:
ScenarioDescriptionExpected? Illegal/unauthorized callsCalls from IP addresses not registered as valid mapping gateways Yes โ no account to bill Free E.164 numbersCalls to numbers listed in SERVER_BILLING_FREE_E164S Yes โ configured as free No-CDR free numbersCalls to numbers in SERVER_BILLING_NO_CDR_E164S Yes โ configured to skip billing Unmatched routingCalls that could not be matched to any account or rate table No โ indicates config error System errorsCalls that encountered a billing engine error during processing No โ requires investigation
Revenue leak alert: If you find CDR records with billingMode = -1 for calls that should have been billed (normal calls to paying destinations), this indicates a billing configuration problem. The most common cause is a missing rate table entry for the destination number โ VOS3000 cannot apply billing if it cannot find a matching rate. Check your rate table configuration and ensure all active destinations have valid rates assigned.
VOS3000 CDR Billing Mode Code 0: Phone Number Billing
A billingMode of 0 means the call was billed to a phone number account. This is the most common billing mode for retail VoIP operations where individual SIP accounts (each identified by a phone number or extension) are charged for their calls.
AttributeDetail Code0 Manual DescriptionPhone number (VOS3000 manual ยง4.4: โphone numberโ) Billing AppliedYes โ charges calculated and applied to the phone number account Account DebitedIndividual SIP account identified by phone number/extension
How Phone Number Billing Works
When billingMode is 0, the VOS3000 billing engine identifies the calling (or called) party by their phone number or SIP account ID. The charges are applied to that specific accountโs balance. The rate table lookup uses the destination number (calleeE164) matched against the accountโs assigned rate table. This is the standard billing model for:
Retail SIP accounts: Individual users with their own phone numbers and prepaid/postpaid balances
Business extensions: PBX extensions that are individually metered and charged
Calling card accounts: When the calling card system maps to individual phone number accounts (distinct from phone card billing mode 3)
Residential VoIP: Home users with per-call billing on their personal SIP account
Balance check: For prepaid phone number accounts, VOS3000 checks the account balance before allowing the call. If the balance is insufficient, the call is rejected or limited to the duration that the remaining balance can support. The SERVER_BILLING_PREVENT_OVERDRAFT_ADVANCE_TIME parameter reserves advance time to prevent accounts from going negative during active calls.
VOS3000 CDR Billing Mode 1: Gateway ID Billing
A billingMode of 1 means the call was billed to a gateway ID account. This is the dominant billing mode for wholesale VoIP operations where traffic is routed through mapping gateways and routing gateways, and the charges are applied to the gatewayโs account rather than to individual phone numbers.
AttributeDetail Code1 Manual DescriptionGateway ID (VOS3000 manual ยง4.4: โgateway IDโ) Billing AppliedYes โ charges calculated and applied to the gateway account Account DebitedMapping gateway or routing gateway account, identified by gateway ID
How Gateway ID Billing Works โ VOS3000 CDR Billing Mode
When billingMode is 1, the VOS3000 billing engine attributes the call charge to the gateway through which the traffic passed. This is the standard billing model for wholesale and carrier-grade VoIP operations where traffic volume is high and individual call billing would be impractical. The gatewayโs rate table is used for rate lookup, and charges are deducted from the gatewayโs account balance.
Common scenarios for gateway billing:
Wholesale termination: Carriers sending large volumes of traffic through a gateway and billed by the gatewayโs aggregate rates
Origination gateways: Incoming traffic from a PBX or softswitch is billed to the originating mapping gateway
Interconnect billing: Traffic exchanged between carriers, billed to the gateway representing the interconnection point
Enterprise PBX trunking: A business PBX connected via a SIP trunk is billed at the gateway level rather than per extension
Gateway-level reporting: The billingMode = 1 designation is essential for wholesale traffic analysis. When generating revenue reports, you should filter CDRs by billingMode to separate gateway-billed wholesale revenue from phone-number-billed retail revenue. This separation is critical for understanding your business mix and margins. For more details on wholesale billing analysis, see our CDR analysis and billing guide.
VOS3000 CDR Billing Mode 3: Phone Card Billing
A billingMode of 3 means the call was billed to a phone card (calling card) account. This applies specifically to calls made through the VOS3000 IVR-based calling card system, where users dial an access number, enter their PIN, and then dial the destination number.
AttributeDetail Code3 Manual DescriptionPhone card (VOS3000 manual ยง4.4: โphone cardโ) Billing AppliedYes โ charges calculated and applied to the calling card account Account DebitedPhone card (calling card) account identified by PIN/card number
How Phone Card Billing Works
When billingMode is 3, the VOS3000 billing engine charges the call to the calling card account that was authenticated through the IVR system. The calling card has its own balance, rate table, and billing rules that are separate from both phone number accounts and gateway accounts. The IVR system plays a balance announcement, authenticates the PIN, and manages call duration based on the cardโs remaining balance.
Phone card billing specifics:
IVR authentication: The caller dials an access number, enters their PIN via DTMF, and the IVR validates the card
Prepaid only: Phone cards are always prepaid โ the card balance must be sufficient before the call is allowed
Separate rate table: Calling card calls may use a different rate table than regular phone number accounts
Duration enforcement: The maximum call duration is calculated based on the cardโs remaining balance and the per-minute rate
Balance announcements: The IVR can announce remaining balance and maximum talk time before connecting the call
Distinguishing from billingMode 0: Do not confuse phone card billing (mode 3) with phone number billing (mode 0). Even though both involve individual accounts with balances, phone card accounts are accessed through the IVR PIN authentication flow, while phone number accounts are accessed directly via SIP registration. The billing separation ensures that calling card revenue and expenses are tracked independently from retail SIP account revenue.
Complete VOS3000 CDR Billing Mode Codes Comparison Table
CodeModeAccount TypeBilling AppliedTypical Use Case-1 No billingNoneNoIllegal calls, free numbers, unmatched calls0 Phone numberSIP accountYesRetail VoIP, individual SIP accounts1 Gateway IDGateway accountYesWholesale termination, interconnect billing3 Phone cardCalling card accountYesIVR-based calling card service
VOS3000 CDR Billing Mode Distribution Analysis
Analyzing the distribution of billing mode codes across your CDR data reveals important patterns about your traffic mix and billing health. Here is what to look for in each modeโs proportion:
Billing ModeHealthy RangeWarning SignAction Required-1 (No billing)0โ5% of total CDRsSudden spike in no-billing recordsInvestigate rate table gaps or illegal call volume0 (Phone number)Varies by business modelLower than expected for retail operationsVerify SIP account billing configuration1 (Gateway ID)Varies by business modelGateway-billed calls showing zero revenueCheck gateway rate tables and balances3 (Phone card)Only if calling card service is activePhone card CDRs without IVR prefixVerify IVR and calling card configuration
Practical analysis tip: Run a daily query on your CDR data to count the billing mode distribution. If the percentage of mode -1 records suddenly increases, it may indicate a rate table is missing entries for a new destination, or that an attack is generating unauthorized calls. If mode 3 records appear but you do not operate a calling card service, it suggests a configuration error that needs immediate attention. Use our VOS3000 data report guide for setting up automated daily reports.
VOS3000 CDR Billing Mode and Related VOS3000 Parameters
Several VOS3000 parameters interact with the billing mode system. Understanding these relationships helps you configure billing correctly and interpret CDR billing mode codes accurately:
ParameterDefaultEffect on Billing ModeSERVER_BILLING_FREE_E164S(blank)Calls to these numbers incur no charges โ may result in billingMode = -1SERVER_BILLING_NO_CDR_E164S(blank)Calls to these numbers skip CDR generation entirely โ no billingMode recordedSERVER_BILLING_RECORD_ILLEGAL_CALLOnWhen On, illegal calls generate CDRs with billingMode = -1SS_CDR_RECORD_ILLEGALOnWhen On, illegal call CDRs (mode -1) are included in text file exportSS_NO_BILLING_TO_PHONEOffWhen On, provides free billing to phone โ affects billing mode attribution
Parameter interaction note: The SERVER_BILLING_FREE_E164S parameter creates a distinct billing behavior from billingMode = -1. When a call matches a free E.164 number, the call is still processed through the billing engine (which may record it with a specific billing mode code), but the calculated charge is zero. This is different from billingMode = -1, which means billing was not applied at all. For details on free number configuration, see our toll-free E164 billing guide.
Common VOS3000 CDR Billing Mode Code Problems and Solutions
Problem 1: Revenue Calls Showing billingMode = -1
Symptom: Calls that should generate revenue are appearing in CDR records with billingMode = -1 instead of 0 or 1.
Cause: The most common cause is a missing rate table entry for the destination. When VOS3000 cannot find a matching rate for the calleeE164 in the accountโs rate table, it cannot calculate a charge and assigns billingMode = -1.
Solutions:
Verify the destination has a valid rate in the appropriate rate table
Check that the accountโs rate table assignment is correct
Ensure prefix settings properly strip routing prefixes before rate lookup โ see our gateway route prefix billing guide
Review the CDR billing discrepancy troubleshooting guide for systematic diagnosis
Problem 2: Wrong Billing Mode for Gateway Calls
Symptom: Calls through a gateway are being billed to a phone number account (mode 0) instead of the gateway account (mode 1).
Cause: The gatewayโs billing configuration in the VOS3000 client may be set to bill the calling partyโs phone number account rather than the gateway account. This typically happens when the mapping gateway is configured with a specific SIP account instead of billing at the gateway level.
Solutions:
Review the mapping gatewayโs billing settings in VOS3000 client
Verify the gatewayโs rate table and billing account assignment
Check the VOS3000 account billing configuration to ensure proper billing attribution
Problem 3: Unexpected billingMode = 3 Without Calling Card Service
Symptom: CDR records show billingMode = 3 (phone card) but no calling card service is deployed on this VOS3000 system.
Cause: A SIP account may have been incorrectly configured with phone card billing attributes, or a mapping gateway may be routing calls through the IVR calling card module unintentionally.
Solutions:
Audit all SIP accounts for unexpected calling card configuration
Check mapping gateway settings for IVR routing misconfigurations
Filter CDR records by billingMode = 3 and investigate the affected accounts
VOS3000 CDR Billing Mode Code Best Practices
Follow these best practices to ensure accurate billing mode attribution and effective CDR analysis:
Best PracticeRecommendationReason Monitor billing mode distribution dailyTrack percentage of each code Early detection of configuration errors and fraud Alert on billingMode = -1 spikesSet threshold alerts for no-billing records Prevents revenue leaks from rate table gaps Separate revenue reports by billing modeGenerate distinct reports for modes 0, 1, 3 Accurate revenue attribution by business segment Validate rate table coverageEnsure all destinations have valid rates Prevents unexpected billingMode = -1 records Document billing mode usageRecord which account types use which billing modes Enables faster troubleshooting and onboarding
Frequently Asked Questions
What does billingMode = -1 mean in VOS3000 CDR? โ VOS3000 CDR Billing Mode
A billingMode of -1 in VOS3000 means no billing was applied to the call. The call record exists in the CDR for operational and security purposes, but no account was charged. This occurs for illegal/unauthorized calls from unknown IP addresses, calls to free E.164 numbers configured in SERVER_BILLING_FREE_E164S, and calls that could not be matched to any billing account or rate table. If you are seeing billingMode = -1 for calls that should generate revenue, check your rate table configuration to ensure all active destinations have valid rates. The VOS3000 manual ยง4.4 (page 242) documents this code as โno billing.โ
What is the difference between billingMode 0 and billingMode 1?
billingMode 0 (phone number) bills the call to an individual SIP account identified by a phone number or extension. This is typical for retail VoIP where each user has their own account with a personal balance and rate table. billingMode 1 (gateway ID) bills the call to a gateway account. This is typical for wholesale VoIP where traffic is billed at the gateway level rather than per individual user. The distinction matters for revenue reporting โ mode 0 revenue comes from retail accounts, while mode 1 revenue comes from wholesale/interconnect relationships.
Can a call have different billing modes for caller and callee sides?
No, the billingMode field in the CDR represents a single billing attribution for the entire call. However, the separate calleeBilling field (position 16) does indicate which party is charged: 0 means the callerโs account is billed, and 1 means the calleeโs account is billed. These two fields together provide the complete billing picture: calleeBilling tells you which side pays, and billingMode tells you what type of account is charged. For example, calleeBilling = 0 with billingMode = 1 means the callerโs gateway account is charged.
Why do I see billingMode = -1 for legitimate calls?
If legitimate, connected calls appear with billingMode = -1, the most likely cause is a missing rate table entry for the destination number. When VOS3000 cannot find a matching rate in the accountโs assigned rate table, it cannot calculate charges and assigns no billing mode. Other causes include incorrect gateway route prefix configuration that transforms the destination number into something that does not match any rate table entry, or a misconfigured account that lacks a rate table assignment. Audit your rate tables and prefix settings to resolve these issues.
Is billingMode = 3 only for calling card services?
Yes, billingMode = 3 is specifically designated for phone card (calling card) billing in the VOS3000 manual ยง4.4. This code only appears when calls are authenticated through the VOS3000 IVR calling card module using a PIN. If you do not operate a calling card service and see this code in your CDRs, it indicates a configuration error where a SIP account or gateway is incorrectly associated with the calling card billing system. Investigate and correct the account configuration to prevent billing misattribution.
How do I filter CDRs by billing mode in VOS3000 client?
In the VOS3000 client CDR query interface (documented in manual ยง2.7.2), you can filter records by billing mode through the query options. The โBilling modeโ filter allows you to select specific modes (Phone, Gateway, Phone card) for display. Note that the client interface uses descriptive labels rather than numeric codes โ โPhoneโ corresponds to mode 0, โGatewayโ to mode 1, and โPhone cardโ to mode 3. For no-billing records (mode -1), use the illegal call recording filter or query the text file export directly.
Need Expert Help with VOS3000 CDR Billing Mode Codes?
Accurate interpretation of VOS3000 CDR billing mode codes is essential for billing accuracy, revenue protection, and operational intelligence. Whether you are investigating unexpected billingMode values, setting up revenue reports by billing type, or troubleshooting billing discrepancies, expert guidance ensures your analysis is correct and your billing configuration is airtight.
WhatsApp: +8801911119966 โ Get immediate assistance with VOS3000 CDR billing mode analysis, billing configuration, and revenue auditing. Our team specializes in VOS3000 billing system optimization, CDR analytics, and fraud detection. VOS3000 CDR Billing Mode
Explore related VOS3000 billing and CDR configuration guides: VOS3000 CDR Billing Mode
VOS3000 Billing System โ Complete overview of the VOS3000 billing architecture
VOS3000 CDR Analysis and Billing โ Analyzing CDR data for revenue optimization
VOS3000 CDR Billing Discrepancy โ Troubleshooting billing differences between CDR records and rate tables
VOS3000 Billing Precision โ Fee decimal precision and rate unit configuration
VOS3000 Billing Free Time โ Configuring free duration for promotional billing
VOS3000 Rate Table โ Setting up rate tables for accurate billing calculations
Need Professional VOS3000 Setup Support?
For professional VOS3000 installations and deployment, VOS3000 Server Rental Solution:
WhatsApp: +8801911119966 Website: www.vos3000.com Blog: multahost.com/blog Downloads: VOS3000 Downloads
VOS3000 ASR Cost Routing Order Strategic SS_GATEWAY_ASR_ROUTE_SORT_CONFIG Every VoIP operator faces the same fundamental routing… Read More
VOS3000 Prefix Mode Extension Expiration Smart Gateway Selection Method When a call arrives at VOS3000… Read More
ARTICLE CONTENT VOS3000 Real-Time Gateway ASR Advanced SS_GATEWAY_ASR_CALCULATE Configuration Answer-Seizure Ratio (ASR) is the most… Read More
VOS3000 Busy Stop Switch Reliable SS_GATEWAY_SWITCH_STOP_AFTER_USER_BUSY When a SIP 486 Busy Here response arrives from… Read More
VOS3000 Aggressive Gateway Failover Dynamic SS_GATEWAY_SWITCH_UNTIL_CONNECT In normal failover mode, VOS3000 stops trying additional gateways… Read More
VOS3000 RTP Lock-In Failover Robust SS_GATEWAY_SWITCH_STOP_AFTER_RTP_START The moment RTP media packets start flowing between a… Read More