Jump to: navigation, search

State records are associated with customer locations and are used by other areas of eoStar, such as taxes and report filters, to determine which customers are in a particular geographic area.

eoStar ships with a record for each US state and the District of Columbia.

  • Additional records for other geographic areas may be created as necessary.

Feature Information

  • Functional Area: Administration, Finance
  • Roles Impacted: Admin Clerk, AR/AP Clerk
  • Platform: eoStar Backend
  • Plugin: N/A


In order to access this screen, employees must have the following permission:

  • Records > Employee > Records > Access Records Panel > States > "View".

How To Create a New State Record

  1. Go to Records > Customer > States.
  2. Click New.
  3. Specify a record number by either selecting a provided number or enter your own.
  4. Enter the record Name.
  5. Excise tax paid to state includes on purchases - Check this box to include excise tax paid to the state on your purchases.
  6. Automatically refuse DEX pricing changes - Check this box to automatically refuse any pricing changes when DEXing.
  7. Click Post.

Assigning a Customer to a State

  1. Go to Records > Customer > Records > Location Panel.
  2. Select the State.
  3. Click Post.


Taxes Panel


Normally, sales tax is setup in Tax Areas and Tax Classes while excise tax is setup in the Beverage Tax Plugin. This panel allows for the setup of two additional taxes for each state.

  • Taxes setup here will only affect products in the specified product set when they are ordered by a customer in the specified customer set.
  • Multiple lines may be entered with different rates for different combinations of product and customer sets.
  • These taxes may be listed on handheld invoices:
    • Go to File > Database Administration > Configure > Handheld panel and enable the Print tax breakdown on invoices setting.
  • Each tax entered here may be mapped to specific GL accounts on the Order: Sales Tax State source.
    • Check the Use state tax type source option to include them in the rules panel.

How To setup a State Tax

  1. Enter a Description.
  2. Select a Basis:
    • Per Gallon - The tax is the number of gallons delivered multiplied by the rate.
    • Percentage of Revenue - The tax is a percentage of the final price of product(s) delivered.
    • Percentage of Sample Cost - The a percentage of the cost of sample product(s) delivered.
  3. Enter a Rate.
  4. Select an Effective Date.
  5. Select a Product Set.
  6. Select a Customer Set.
  7. Click Add.

How To Delete a Line

  1. Select it in the grid.
  2. Click Delete.

Alcohol Compliance Panel


This panel contains the state's non-compliance payment term and hold code for purchasing alcohol.

  • Customers listed in the grid will have the hold code applied and their payment term(s) will be overridden by the terms entered here.
  • The Alcohol Compliance Import tool is used to add/remove large amounts of customers at once.

Enter Non-Compliance Settings

  1. Select the Terms for customer's not in compliance with state law.
    • Separate invoices will still be created based on the terms entered on the customer record.
    • For example, if alcoholic products are normally COD and non-alcoholic are Net 30, but due to compliance issues they are overridden to both be COD, they will still be split onto separate invoices.
  2. Apply to Alcohol Only - Check this box to apply the terms to alcoholic products only and allow non-alcoholic products to be ordered normally.
  3. Select the Hold Code for customer's not in compliance with state law.

Manually Add/Remove Customers

  1. Select a customer to add to the list.
  2. Click Add Customer.
    • Repeat steps 4 and 5 until all necessary customers have been added.
  3. Remove Selected Customer - Highlight a customer in the list and click this link to remove the customer from the list.

CRV Exemptions Panel

Customers added to this panel are exempt from paying California Redemption Value fees.

  • For customer to be exempted from CRV fees, they must be added to the grid and Activated.
  • The other fields are for reference/reporting only.

How To Add a Customer Exemption

  1. Select a Customer.
  2. Check the Activated box.
  3. Select the Type of exemption:
    • Default - This is the base value of the field if no specific exemption type is selected.
    • CalRecycle_Exemption - For customers who have registered with CalRecycle that they will self-report CRV fees.
    • Statutory Exemption - For plane, train, and passenger boat customers.
    • Other - Any exemption not covered by the other three options.
  4. Select the Effective Date.
  5. Enter a Reference number/note.
  6. Click Add.

How To Update a Customer Exemption

  1. Select the customer in the grid.
  2. Enter the new information in the fields at the bottom.
    • Un-check the Activated box to end the exemption.
  3. Click Update.

Customers Panel

This panel lists all customers assigned to the state.

  • Check the Map box to view each customer's location on a map.
  • Click Show erased customers to view de-activated customers assigned to the state.

Delivery Charges Panel

This panel is used to set up state-specific delivery charge settings.


  • Enter the Delivery Charge for all customers in this state.
    • The charge entered here will override any other delivery charges for customers in this state.
  • Check Do not credit back split-case charges to exclude the split-case charge when entering a unit return for customers in this state.
    • When enabled, customers in this state will only be credited the return price even if a split-case charge was included on the initial order.

Vending Panel

Only available with the Vending Plugin, This panel is used to set a Minimum Vend Price for Taxes.

  • Products with a price that does not meet or exceed the minimum entered here will not be charged vending tax.

Reports Panel

This panel shows any reports related to States. The selected report can be changed under the Report menu at the bottom and may be run for a specific time period. The reports shown here can be sent to both the printer and excel. For more information, see Reports Panel.