XML Format: Billing Schedule Data

Billing schedule information can be exported and then imported from the SBS ARCB Billing Schedule List page in the XML formats using the following actions: 

  • Billing schedule
  • Billing schedule price adjustment
  • Billing schedule usage items (import only)
  • Revenue Split Template (added from version 41.2 onwards)

General Workflow

To create or update billing schedule information, follow these general steps: 

  1. On the SBS ARCB Billing Schedule List, select the export action you want (Export > XML > Export).

    You can save the file to the default download location.

  2. Open the file in a text editor, and make changes as needed.
  3. Back on the SBS ARCB Billing Schedule List, select the import action for the same data type you exported (Import > XML > Import).
  4. When updating data, prompts asking whether you want to roll down the start and end dates, the frequency, and the interval, appear. Select Yes or No to the prompts.

The following tables provide information on the file formats for importing data. Every field is required to appear on the import file. However, not every field requires a value. In other words, the field column must appear in the file, but the value for the field in a row can be empty.

Tip: If you do not have a sample template and to ensure you have the latest format, execute the export action to save a file with the correct formatting.

Notes:

The following items provide information with respect to importing data: 

  • The header and line records can be combined into a single composite entity, which means it can be included in a single file. However, only XML files can be used with composite entities.
  • If a stubbing cutoff date exists, and the schedule details lines have a billing start date that is earlier than or the same as the stubbing cutoff date, the line is stubbed.
  • Each entity record is processed independently of all other entity records. As a result, when an import error occurs, only the line that has the error is rolled back. All other lines that are successfully imported are not affected.
  • For composite entities, the header and line are considered a single entity. If an import error occurs with the line, the header is not imported.

  • When price adjustment data is imported, the price adjustment line number is automatically generated.
  • When importing data, the ScheduleNumber is required. Also, the ScheduleLineNum is required for a billing schedule line, but optional for composite. For more information about the file format for the data, review the sample import file.

Billing Schedule Header & Lines

Review the following table for the required content for importing data to the SBS ARCB Billing Schedule List page.

The following table shows the columns for the XML: 

  • Action: Import/Export > XML > Import or Export > Billing Schedule
Field Name Data Type Required Description
HeaderInfo
BillingScheduleNumber String Required  
SellToCustomerNo String Required  
EndUser String    
BillingEndDate Date Required  
BillingEndDate Date Required  
BillingFrequency String  

Options: 

  • Monthly
  • Quarterly
  • Semi-Annual
  • Annual
  • One Time
  • Weekly
  • Daily
  • Miscellaneous

When this value is empty, the value is from the specified billing schedule group.

Interval Integer   When this value is empty, the value is from the specified billing schedule group.
AutoRenewal Boolean   Yes/No
Description String    
NoticeDays Integer    
RenewInAdvance Integer    
CurrencyCode String    
LocationCode String    
SalespersonCode String    
ResponsibilityCenter String    
PaymentTermsCode String    
BillToCustomerNo. String    
BillToName String    
BillToAddress String    
BillToAddress2 String    
BillToCity String    
ShipToCode String    
ShipToName String    
ShipToAddress String    
ShipToAddress2 String    
ShipToCity String    
BssiArcbDetailInvAmt Integer    
BillToPostalCode String    
BillToCountry String    
ShipToPostalCode String    
ShipToCountry String    
SellToCustomerName String    
SellToAddress String    
SellToAddress 2 String    
SellToCity String    
SellToContact String    
SellToPostalCode String    
SellToCounty String    
AlignToMonth Boolean   Yes/No
ProratePartialPeriod Boolean   Yes/No
ShipmentMethodCode String    
PackageTrackingNO String    
ShippingAgentServiceCode String    
ShippingAgentCode String    
ShipToCounty String    
ShipToPostCode String    
ShipToCountry/Region String    
ShipToContact String    
SellToContactNo String  
SellToCountry String    
SellToCustomerName2 String    
YourRef String    
ExternalDocNo String    
BillToContact String    
BillToContactNo String    
Bill-to Country/Region Code    
BssiInvoiceSeparately Boolean   Yes/No
TaxLiable Boolean   Yes/No
TaxAreaCode String    
BillingScheduleGroup String    
SeriesNo String    
BssiEstimateQty Real    
BillingScheduleLineInfo
LineNo String Required  
Type String    
ItemNo String Required  
Description String    
BillingType String    
LocationCode String   Location Code
UnitMeasureCode String    
Price Real    
Qty Integer    
Amount Real    
BillingFrequency String  

Options: 

  • Monthly
  • Quarterly
  • Semi-Annual
  • Annual
  • One Time
  • Weekly
  • Daily
  • Miscellaneous
BillingStartDate Date    
BillingEndDate Date    
Interval Integer    
TaxGroupCode String    
TaxLiable Boolean    
TaxAreaCode String    
AutoRenewal Boolean    
UsageOption String    
PricingMethod String    
UsageIdentifier String    
InitialReading Integer    
RenewalLines Integer    
StubbedDate Date    
RevenueSplit Enum   Yes/No
ParentAmount Real    
BssiEstimateQty Integer   Estimated usage quantity
BssiTransactionType String    
BssiBillToCustomerForLine String Required

If this value is empty, an error occurs when an invoice is created.

Instead of leaving this value empty, use the sell-to customer details.

BssiBillToCustomerNameForLine String Required

If this value is empty, an error occurs when an invoice is created.

Instead of leaving this value empty, use the sell-to customer details.

BssiBillToAddressForLine String Required

If this value is empty, an error occurs when an invoice is created.

Instead of leaving this value empty, use the sell-to customer details.

BssiBillToAddress2ForLine String Required

If this value is empty, an error occurs when an invoice is created.

Instead of leaving this value empty, use the sell-to customer details.

BssiBillToCityForLine String Required

If this value is empty, an error occurs when an invoice is created.

Instead of leaving this value empty, use the sell-to customer details.

BssiBillToContactForLine String Required

If this value is empty, an error occurs when an invoice is created.

Instead of leaving this value empty, use the sell-to customer details.

BssiBillToContactNoForLine String Required

If this value is empty, an error occurs when an invoice is created.

Instead of leaving this value empty, use the sell-to customer details.

BssiBillToCountryForLine String Required

If this value is empty, an error occurs when an invoice is created.

Instead of leaving this value empty, use the sell-to customer details.

BssiBillToCountyForLine String Required

If this value is empty, an error occurs when an invoice is created.

Instead of leaving this value empty, use the sell-to customer details.

BssiBillToPostalForLine String Required

If this value is empty, an error occurs when an invoice is created.

Instead of leaving this value empty, use the sell-to customer details.

BillingScheduleLinePriceOptions
FreeQuantity Number    
FreeResetNumberofPeriods Number    
MinMaxType String    
MinimumValue Number    
MaximumValue Number    
MinMaxResetNumberofPeriods Number    
BssiAredTransLineDeferral      
TransactionType String    
DeferrableItem Enum   Yes/No
TransactionDate Date    
Qty Number    
DeferralAmount Number    
EventTemplateNo String    
EventPerUnit Enum   Yes/No
EventAllocationType String    
ExpirationAccount String    
RevenueDeferralAccount String    
RevenueRecognitionAccount String    
COGSDeferralAccount String    
COGSRecongitionAccount String    
DiscountDeferralAccount String    
DiscountRecognitionAccount String    
ScheduleType String    
TemplateNo String    
ConsolidatePriorPeriods Enum   Yes/No
EqualPerPeriod Enum   Yes/No
OverrideStartDate Enum   Yes/No
DeferralStartDate Date    
DeferralEndDate Date    
ScheduleFromTemplate Enum   Yes/No
BillingScheduleMERALine
MEANumber String    
SSPOrigin String    
StandaloneSellingPrice Number    
DeferredContractRevenueAccount String    
BillingScheduleMERAHeader
MEAType String    
MEANumber String    

Billing Schedule Price Adjustment

Review the following table for the required content for importing data to the SBS ARCB Billing Schedule List page.

The following table shows the columns for the XML: 

  • Action: Import/Export > XML > Import or Export > Billing Schedule Price Adjustment
Column Name Data Type Required Description
PriceAdjustmentDetails
BssiArcbBillingScheduleNumber String Required Billing schedule number
BssiArcbBillingScheduleLineNo String Required  
LineNo. String Required  
Markdown String    
EscStartDate Date Required  
EscEndDate Date    
Frequency String  

Options: 

  • None
  • Monthly
  • Quarterly
  • Semi-Annual
  • Annual
  • One Time
Percentage Integer    
Amount Integer    
CPIschedule String    
CPIIndexCalculation String    
ImportfromHdr Enum   Yes/No

Billing Schedule Usage Items

Review the following table for the required content for importing data to the SBS ARCB Billing Schedule List page.

The following table shows the columns for the XML: 

  • Action: Import/Export > XML > Import or Export > Billing Schedule Usage Items
Column Name Data Type Required Description
ScheduleNum String Required  
ItemNo String Required  
UsageOption String   Options: Reading, Consumption
CurrentReadingORQuantity Integer    
UsageIdentifier String   Unique for each usage item with the same item no.
BillingStartDate Date Required The date the usage occurred.
Comments String    

CPI Schedule

Review the following table for the required content for importing data to the SBS ARCB Billing Schedule List page.

The following table shows the columns for the XML: 

  • Action: Import/Export > XML > Import or Export > CPI Schedule
Column Name Data Type Required Description
BSSICPISchedulesHdr
BssiArcbCPIScheduleNo String Required  
BssiArcbCPIScheduleDesc String    
BssiArcbCPILastRunDate Date Required  
BssiArcbUserApplied String    
BSSICPISchedulesLine
BssiArcbLineNo Number    
BssiArcbCPIDate Date    
BssiArcbCPIValue Number