Styling

If the application is not set up to use the Coleman Oil card, it must be styled in using Editnet.  The following actions are needed:

  1. Unzip the module into the application directory.  Move Coleman.Exe and ColeRpt.Exe to the Tools directory or another directory in the workstations path.  Move the sample Lockout.Aco file to the Data subdirectory.
  2. In Media Definitions, define media 8 as Coleman Oil.  If a media number other than 8 is used, the Media command in the ColeTend chain must be changed to reflect the new media.
  3. Style a Coleman Oil media button onto the Tender page and give it the command Chain to ColeInit.
  4. Edit the ColeTend chain as needed after the AcceptIt label to reflect the printing and file updating needs of that application.
  5. Style a Coleman Oil media button onto the Overring page and give it the command Chain to ColeCred.
  6. Edit the ColeOver chain as needed at the Do Other Stuff comment to reflect the printing and file updating needs of that application.
  7. Optional – A Debugging button can be placed on the Manager Functions page, TraPr Functions page, or some similar restricted access screen.  Label the button Analyze Coleman Oil Card and give it the Chain to ColeDbg command.
  8. The module was written specifically for a keyboard wedge mag stripe reader and would need restyling if some other type of reader were used.

At this point, the application will support the Coleman Oil card, and subsequent stores should only need to have the steps listed in the Configuration section performed.
Configuration

Configuration will need to be performed for each store and assumes that the Coleman Oil module has already been styled into the application.

  1. In the application directory, edit Cole-Bat.Bat.
  2. Change the /SITENUM= command line switch to reflect the site number for that store.  Add leading zeros as necessary to assure that this is a four digit number.  For many stores it is expected that this is the only switch that will need to be set.
  3. If the store uses other than the standard participant ID code 094, change the /PARTCODE= command line switch as needed.  Add leading zeros as necessary to assure that this is a three digit number.
  4. If the store uses other than the standard codes shown on the /AUTHCODE= command line switches, change them as needed.  Note that this switch is unique in that there can be more than one occurrence of the switch and it has two different forms.  See the Executable Syntax section for more details.
  5. Save and Exit the file, then repeat these steps for Cole-Dbg.Bat.
  6. If you have a more current copy of the Lockout.Aco file, replace the existing one in the DATA subdirectory.
  7. After training and prior to going live, be sure to erase the Coleman.Txt file in the reports subdirectory.

Operation

After an order has been rung, the Coleman Oil button is pressed.  The user is then prompted to swipe the card after which a window pops up confirming approval, or giving a reason for rejection.  Reasons for rejection are explained in the Variable Usage section.  After approval the check is closed and a new order can be started.  After rejection, control returns to the tender screen.

Optionally, an amount can be entered prior to pressing the Coleman Oil button.  If the amount entered is less than the amount due, an error window will inform the user that this is not allowed.  The reason for this being that leaving the check open after an amount was posted to the batch allows for events that would cause the Media reports not to balance with the actual batch deposited.

If the amount entered is more than the amount due, a window will offer the user one of three choices.  They can accept the amount they entered, they can change the amount entered to the amount due, or they can cancel and return to the tender screen.

The Overring function works similar to the regular authorization except that it posts to the batch as a credit.  Note that the card must still be swiped as part of the overring process.

There is no manual entry of a Coleman Oil card.  This is because the batch requires information only encoded on the mag stripe and not visible to the cardholder.

The Analyze Coleman Oil Card button runs the interface with a dummy amount using the /DEBUG and /NOPOST command line switches.  It causes the executable to display internal information to the screen and not post it to the batch.  This can be useful when debugging a new application or determining how a particular card is being read.

The ColeRpt executable is not currently linked into any styling.  When run from the application directory it creates ColeRpt.Rp in the Reports subdirectory containing an image of a batch detail report.  This can then be copied to a printer or exported to other software as desired.
Executable Syntax

COLEMAN /SITENUM=xxxx /PARTCODE=xxx /AUTHCODE=xx {optional switches}

        *          /SITENUM=site number – This is a unique number for each restaurant and must be four digits in length.
        *          /PARTCODE=participant ID code – All Coleman Oil cards currently use code 094, but this may change in the future.  This number must be three digits in length.
        *          /AUTHCODE=authorization code or authorization code range – This command line switch is a little different in that it can occur on the command line as many times as necessary, only limit being that the total command line can not have more than 127 characters.  A single two digit code can be specified or a range can be defined by separating the low end and high end of the range with a dash(-).
          Ex:  /AUTHCODE=00-02 /AUTHCODE=44
        *          /DEBUG – Causes the program to display internal information to the screen and can be useful in troubleshooting.  The program still executes and posts data normally.
        *          /NOPOST – Prevents output to the transaction file.  This can be useful when debugging or testing where you don’t actually want to submit a test transaction.

Sample Report

  *** Coleman Oil Detail Report ***

              Site 1234

    Fri, Sep 22, 2000    5:53pm

  Seq  Date  Time    Check

        Account    Card    Amount