billmax documentation   BillMax Billing Solutions
  877.245.5629
  sales@billmax.com
 

Chapter 2. Migrating Financial Data

Table of Contents

Beginning Balance Method
Historical Transaction Method

Beginning Balance Method

A migration technique in which an Account"s non-zero beginning balance is entered into BillMax rather than migrating historical financial data. A much simpler migration technique than migrating historical financial data, but historical reporting and aging information is not available from BillMax.

Restrictions of the Beginning Balance Method

  1. Deposit Charges may not be included in a Beginning Balance record. This is due to the fact Deposit Charges is are mapped one-to-one to Deposit Refunds.

  2. Deposit Refunds or Refunds may not be included in a Beginning Balance record.

  3. More than one type of Financial Transaction may not be represented in a Beginning Balance record. In other words, a Beginning Balance record may look like a Payment record or an Sale record, but not both.

  4. An Account may not have more than one Beginning Balance record. If an Account requires more than one of the following:

    1. Unallocated Payments.

    2. Unallocated Sales.

    3. Unallocated Store Credits.

    historical data will need to be imported.

  5. Beginning Balances do not show up on Sales, Payments, Credits, or Deferred Revenue reports. They also do not show up as "Tax Billed" on the Sales Tax report. However, subsequent payments will show up as "Tax Paid" on the Sales Tax report.

  6. The payhist.startdate and payhist.enddate for Beginning Balances are for all intents and purposes are ignored. No monthlysale table records are created and they are not considered with computing tax exemption amounts.

  7. Manual Allocations may be made to Beginning Balance records. However, Manual Allocations "from" Beginning Balance records are not allowed. In other words, when receiving a Payment, the Payment may be made to a Beginning Balance record that represents money owed. However, the Beginning Balance record is not available in the Charges/Deposits list to Allocate it to the Payment.

  8. The Beginning Balance record must be the earliest in Account history. In other words, when doing a MySQL select from the payhist table and ordering by payhist.entdate, payhist.enttime and payhist.number, the Beginning Balance record must be first.

  9. The payhist.entdate of the Beginning Balance record must be greater than or equal to the account.startdate.

The Beginning Balance Method consists of creating payhist table records with a type of 9. The following fields must be populated:

Table 2.1. Beginning Balance Representing Sales

Required Fields

account.number - The Account number.

account.entdate - See restrictions 7 and 8

account.customerof

payhist.purchases - a positive value

payhist.taxable, payhist.ntaxable, payhist.taxable - negative values where the sum of these is equal to the negative of payhist.purchases

payhist.taxregion

payhist.duedate

payhist.summary - the value set to "1"

payhist.type - the value set to "9"

Optional Fields

payhist.service

payhist.servdef

payhist.descr

payhist.noautoallocate


Table 2.2. Beginning Balance Representing Store Credits

Required Fields

account.number - The Account number.

account.entdate - See restrictions 7 and 8

account.customerof

payhist.ucredit - a negative value

payhist.taxable, payhist.ntaxable, payhist.taxable - positive values where the sum of these is equal to the negative of payhist.purchases

payhist.taxregion

payhist.summary - the value set to "1"

payhist.type - the value set to "9"

Optional Fields

payhist.service

payhist.servdef

payhist.descr

payhist.noautoallocate


Table 2.3. Beginning Balance Representing Payments

Required Fields

account.number - The Account number.

account.entdate - See restrictions 7 and 8

account.customerof

payhist.bankacct - a positive value

payhist.ucash - a negative value equal to the negative of payhist.bankacct

payhist.summary - the value set to "1"

payhist.type - the value set to "9"

Optional Fields

payhist.tender

payhist.tendnum

payhist.descr

payhist.noautoallocate


After entering the Beginning Balance records, run /usr/local/billmax/bin/create_applies to update the Account balances.


Document Revision A for BillMax 2.2.0   -   Copyright © 1997-2006 The iSpark Group, Inc.

All rights reserved. No part of this documentation may be reproduced or transmitted in any fashion without written permission by The iSpark Group, Inc. This documentation is for the sole use of licensees of the BillMax billing software created by The iSpark Group, Inc. Making the documentation available to a non-licensee of BillMax without written permission of The iSpark Group, Inc. is a violation of the use of this documentation.

While precautions have been taken in the preparation of this documentation, The iSpark Group, Inc. assumes neither liability nor responsibility for errors or omissions, or for damages resulting from the use of the information contained herein.

All terms mentioned that are known to be trademarks have been appropriately capitalized. Use of the a trademark does not affect the validity of any trademark or service mark.

Links to third-party Web sites are provided for convenience. The iSpark Group, Inc. is not responsible for any content contained in the third-party Web sites.

Comments about this documentation may be sent to doc@billmax.com