MS Dynamics GP Export

 

Back Office > Data Export > Data Portal > MS Dynamics GP (Great Plains)

 

Description

 

This feature is used to export SwiftPOS Sales and Stock Movement transactional data to Microsoft Dynamics GP.

 

The MS Dynamic GP Export will export the following:

 

  1. Sales - All Sales, Refunds, Account Charges/Payments, etc. Note : With regards to Account related transactions, the MS Dynamics GP export does not export individual Account (Debtor) specific data, but rather exports data that can be imported into MS Dynamics GP in a single Debtors Account (and NOT into individual Debtor Accounts).
  2. Stock Movements - All Stock Adjustments, Damages, Receipts, Returns, Transfers, Wastage and Stocktake variances.

 

To Be Considered

 

  1. Note : All assigning tabs MUST HAVE Accounts assigned. Unassigned Accounts may cause errors. The assigning tabs are:
     
    1. Clearing Accounts
    2. Sales Accounts
    3. Inventory Accounts
    4. Tax Accounts
       
  2. Stock transfers between Locations that exist in different Location Groups (Venues), is supported when exporting to a single MS Dynamics GP Company file. Obviously MS Dynamics GP Accounts will need to be configured for the Locations in question.
  3. For Location Groups (Venues) that have the Track Individual Location Costs option selected, transfers between Locations will be exported, with the value of the transfer calculated based on the cost of the Products in the From Location (at the time of the Transfer).

 


Pre-Requisites

 

  1. To make use of this feature, sites will need to be registered for the General Ledger MS Dynamics GP interface. This may incur an additional charge. To confirm charges, email registrations@swiftpos.com.au.
  2. In Back Office> Administration > Global Preferences > Other tab, ensure the GL Account Code Format is set in Global Preferences. The following needs to be considered when specifying the value of the GL Account Code Format.
     
    1. The GL Account Code, based on the 3 sources and a GL Account Code Format value of XXXXXXXXXXXXX, will be exported as a 13 character field.
    2. If the GL Account Code Format value entered is more than 13 characters long, the GL Account Code will NOT be generated.
    3. If it is LESS than 13 characters, then only the number of characters specified in the GL Account Code Format will be generated. The remainder will be truncated.
    4. Any hyphen characters included in GL Account Code Format value entered will result in the GL Account Code NOT being generated.
       
  3. In Back Office> Administration > Location Groups (Venues) > Location Group Edit ensure the following:
     
    1. Ensure the drop down Entity field is appropriately selected in the Back Office> Administration > Location Groups (Venues) > Location Group Edit.
    2. Ensure that the MS Dynamics GP Data Export Path is configured for those Location Groups (Venues) from which transactions will be exported for subsequent importation into MS Dynamics GP.

 

  1. In Back Office> Administration > Location Records > Location Full Edit - Ensure the following is configured for all Locations within each Location Group (Venue) from which data is to be exported:
     
    1. Ensure the Department field is configured appropriately.3 characters in length.  Note : This field is mandatory when exporting data for MS Dynamics GP.
    2. Ensure the Location/Site field is configured appropriately. 6 characters in length).  Note : This field is mandatory when exporting data for MS Dynamics GP.
    3. Ensure that the MS Dynamics GP Accounts are configured in the Data Portal > MS Dynamics GP > Settings > Accounts tab.

      1. The GL Account Code exported is sourced from the following:
         
        1. GL Account - These Accounts can be either added or imported into the Accounts tab. 4 characters in length. (Represented as AAAA in the example below). Once added/imported, these Accounts can then be used to ensure all assignments/mappings are completed in the Clearing Account, Sales Account, Inventory Accounts and Tax Accounts tabs to the right of the Accounts tab.
        2. Location/Site - This is configured here. 6 characters in length.  (Represented as BBBBBB in the example below).
        3. Department - This is configured here.  3 characters in length. (Represented as CCC in the example below).
           

Department Override - To override the default Location specific Department, a Department override can be configured against Master Groups and will be used instead of the Location specific Department when exporting.

 

  1. Create a special Master Group (for example, Game Day), and specify an override Dept code (3 characters and represented as CCC in the example below) for it. The code specified here will be used to override the default Location's Department Code when generating the GL Account for export. Note : Override Dept Codes ONLY have to be configured for those Master Groups that require it. All other Master Groups can be left blank. In which case they will default to the Location specific Department. 
  2. Create a special Product Group (for example, Game Day), to which specific Products can be assigned.
  3. Assign the specially created Product Group (step 2 above) to the specially created Master Group (step 1 above).
  4. Assign (using the Report Group field) the required Products to the specially created Product Group (step 2 above).

 

      1. For example:
         
  1. MS Dynamics GP Accounts - These are configured in the Data Portal > MS Dynamics GP > Settings > Accounts tab and can consist of one of the following:

    1. GL Account - These are the Accounts that are added form by importing the Chart of Accounts (COA). They are 4 characters in length and are then used as the first 4 characters of the GL Account generated when exported.

MS Dynamics GP Account

Location/Site

Department

GL Account Exported

Comments

AAAA

BBBBBB

CCC

AAAABBBBBBCCC

Where AAAA is the MS Dynamics GP Account from the COA Import.

BBBBBB is the Location/Site value configured against each Location.

CCC is the Department value configured against each Location.

3161

003BGL

RES

3161003BGLRES

 

31612

003BGL

RES

31612003BGLRE

Note : The GL Account will be generated for export, but will most probably cause an error when importing into MS Dynamics GP.

3161

003BG

RES

 

Note : The GL Account will not be generated for export in these two cases, as they do NOT comply with the GL Account Code Format.

3161

003BGL

RE

 

 

    1. Alternative Account - These Accounts are added (via the Accounts Tab) to ensure an alternate GL Account is generated when exporting. These Accounts can be one of the following lengths:

Length

Format

Location/Site

Department

GL Account Exported

Comments

4

XXXX

BBBBBB

CCC

XXXXXBBBBBBCCC

Where XXXX, XXXX-YYYYYY and/or XXXX-YYYYYY-CCC  is the MS Dynamics GP Account added as an Alternative Account. Note : The hyphen characters must be included. These will be removed when generating the GL Account for export.

BBBBBB is the Location/Site value configured against each Location.

CCC is the Department value configured against each Location.

11

XXXX-YYYYYY

003BGL

RES

XXXXYYYYYYRES

15

XXXX-YYYYYY-ZZZ

003BGL

RES

XXXXYYYYYYZZZ


For Example :

Length

Alternate Account

Location/Site

Department

GL Account Exported

Comments

4

8540

003BGL

RES

8540003BGLRES

Note : Once an Alternative Account has been added (via the Accounts Tab), they need to be assigned/mapped to the appropriate Accounts, that is via the Clearing Accounts, Sales Account, Inventory Accounts and Tax Accounts Tabs.

 

Also, A Product requiring Alternative Accounts to that of the Accounts currently assigned/mapped to the Product's Location/Master Group combinations (in the Tabs in the Settings screen), a separate Master Group will need to be created and the Product assigned to it. Also, once the Master Group has been created ensure the Alternative Account has been created and the Location/Master Group combinations (in the Tabs in the Settings screen) are correctly assigned/mapped.

11

8540-045ENT

003BGL

RES

8540045ENTRES

15

8540-045ENT-ZZZ

003BGL

GDY

8540045ENTGDY



  1. In SwiftPOS Back Office > Members > Member Classifications, if required set a Discount Expense Media against Member Classifications. This is optional and once set the Discount Expenses incurred in a sale will be exported using the GL Clearing Account the Discount Expense Media is mapped to.
  2. Venues that have multiple Location Groups (Venues) and transfer Inventory/Stock between Location Group (Venues), then it is advised that the following is configured:
     
    1. Ensure the Transfer Mapping option is set to Inventory<->Clearing Account in Administration > Global Preferences > Other tab > GL Account section.
    2. Ensure the Draw From, Transfer In and Transfer Out Media are mapped to an appropriate Clearing Account in the Clearing Accounts tab in Data Export > Data Portal > Microsoft Dynamics GP > Settings screen.

 

  1. Ensure MS Dynamics GP is backed up before importing from SwiftPOS. In the event something goes wrong, then at least the MS Dynamics GP data can be restored from the backup.
  2. It is recommended that all types of Transactions are tested and imported into MS Dynamics GP. It maybe necessary to enlist the assistance/expertise of an accountant to ensure that from the MS Dynamics GP end, all transactions are posted correctly.
  3. Once testing of all types of Transactions has completed, the Dynamics GP export can be optionally included as part of the End of Day process. For more information ...
  4. Follow the setup instructions below before commencing with the export of any data.

 


Setup

 

  1. In Back Office> Data Export > Data Portal > MS Dynamics GP > Settings - Create/Import the MS Dynamics GP Accounts required to assign/map SwiftPOS combinations found in the tabs to the right. For example, Location/Media Clearing Accounts, Location/Master Group Sales Accounts, Location/Master Group Inventory Accounts, etc. The screenshot below provides an example of the basic Accounts required for an initial Export. Obviously this list can be customised and added to, to suit the requirements of individual sites and their corresponding MS Dynamics GP Account List (Chart of Accounts). Note : Account Codes added must comply with the GL Account Code Format as outlined in the Pre-requisites above. Duplicate Accounts are NOT accepted.
     

 

This tab is accessed from Back Office> Data Export > Data Portal > MS Dynamics GP > Settings.

 

MS Dynamics GP Accounts

 

This tab is used to create/import a list of MS Dynamics GP Accounts that will be used by the Export feature to assign/map to SwiftPOS Location/Media, Location/Master Group combinations and SwiftPOS Locations in the tabs to the right. Note : SwiftPOS does not require the whole of the MS Dynamics GP Account list to be setup, as only a small subset of these are actually used by the MS Dynamics GP Export feature.

 

  • Add Row - Select to add a row to the grid
  • Delete Row - Select to delete the currently selected row.
  • Import Chart of Accounts - Select to Import the Chart of Accounts (COA) from a CSV file.

 

As a guide and at a minimum the Accounts needed to be available/configured in XERO are as follows:

  1. Asset Type Accounts
    1. Undeposited Funds - An account to which Cash payments/refunds from sales made can be posted.
    2. Clearing Account - An account to be used as a default account for the assigning/mapping of SwiftPOS Location/Media combinations.
    3. Accounts Receivable/Trade Debtors - An Account to which Customer/Member Account Charges/Payments can be posted.
    4. Inventory - Accounts to which Stock Sales generated transaction data can be posted.
  2. Liability Type Accounts
    1. Tax - Accounts to which GST Collected and Paid can be posted.
  3. Revenue Type Accounts
    1. Sales - Accounts to which income/revenue from sales made can be credited.
  4. Expense Type Accounts
    1. Direct Costs Type Accounts
      1. Cost of Goods Sold (COGS) - Accounts to which the Cost of Goods from sales can be posted.
    2. Expense Type Accounts
      1. Stock Adjustments - Accounts to which Stocktake and Stock Adjustments (Receipts, Adjustments, Damaged Goods, Returns, Promotions and Wastage) generated transaction data can be posted.
      2. Unders & Overs - An Account to which variances in POS Terminal Cash Offs can be posted.

 

 

Note : For sites with multiple Locations, they may choose to create Location specific Accounts. Obviously this list will vary from site to site and will also be dependent on the site's specific Chart of Accounts (Account List). Liaise with Accountants to ensure the Accounts required are configured correctly.

 

  1. Using the Clearing Accounts, Sales Accounts, Inventory Accounts and Tax Accounts tabs to the right of the Accounts tab, assign/map the Location/Media, Location/Master Group and Location entries in the grid of each tab, to the appropriate MS Dynamics GP Accounts (as created in step 1 above). This can be done by using the Quick setup options available in the header section of the tabs, or by selecting from the drop down list of Accounts, listed on the right hand side of the grid, in each of the tabs. Note : All grid entries in each of the tabs MUST BE assigned/mapped to MS Dynamics GP Accounts.

 

 

 

 

These screenshots are an example of the assignments/mappings required for one Location. This will need to be repeated for all other Locations in a multi Location site.

 

Note : It is highly recommended that ALL grid entries in ALL tabs are assigned/mapped to a MS Dynamics GP Account. Use the Exclude from Export Account (listed as the first entry in the Account drop down lists in the assigning/mapping tabs) to ensure specific  Location/Media, Location/Master Group and Location entries are excluded from being exported. Note : Caution must be taken when using the Exclude from Export Account, as it can potentially result in unbalanced Journals being generated and these will NOT successfully import into MS Dynamics GP.

 


Operation

 

  1. Backup your MS Dynamics GP data.
  2. Prior to exporting for the first time, it maybe necessary to ensure that all transactions to date are marked as exported. Previous years transactions may not need to be exported and therefore will need to be marked as exported. This can be done by using the Mark ALL as Exported buttons in the screen below. This will need to be done for Sales/Stock Movement transaction data.
  3. Once all transactions have been marked as exported, then reset transactions for the specific Trading Dates that need to be exported to MS Dynamics GP. This can be done using the Reset buttons in the screen below. This will need to be done for both Sales/Stock Movement transaction data.
  4. Export the Sales and Stock Movements data for the dates reset. The export files generated will be CSV delimited (.CSV) files, and by default files will be written to the MS Dynamics GP Data Export Path specified against each Location Group (Venue).
  5. Note : Once all the setup (above) has been completed, it is highly recommended to initially export to MS Dynamics GP manually (ie. NOT as part of the End of Day). Once all problems have been identified and resolved, then it can be included as part of the End of Day process.
  6. In MS Dynamics GP import the files generated by the Export. The files generated are named as follows:
    1. For Sales/Stock Movement transaction data - GENERAL-YYYY_MM_DD_HH_MM_SS_SSS.csv

 

 

This screen is accessed from Back Office> Data Export > Data Portal > MS Dynamics GP > Export, and is used to facilitate the export of Sales/Stock Movement transaction data from SwiftPOS.

 

Location Groups Grid

 

  • All - Select to ensure the Data in all Location Groups listed in the grid are flagged for Export. Unselect to ensure no Location Groups are selected.
  • Export - Select individual Location Groups to ensure Data from those selected is Exported.
  • ID/Name - Displays the Location Group ID and Name.
  • LG Export Path - Displays the Export Path to which Export files will be written. These are configured in the MS Dynamics GP Data Export Path for each Location Group (Venue).
  • Last Result - Displays the result of the last time Data was Exported.

 

Sales/Stock Movement Transaction Data

 

  • Location Group - Select from the drop down list the All or one of the Location Groups from which data will be exported.
  • Include All unexported up to Trading Date - Select to ensure that all Transactions, up to and including the selected Trading Date, that have not been exported are exported.
  • Use LG Export Paths, otherwise use - Select to set the default Export Path. Leave Unselected to use the LG Export Paths as configured in the grid above. Select the Open Folder icon to open and view the content. Note : The Open Folder icon will only be displayed if the Use LG Export Paths option is NOT selected.
  • Trading Date - Select the date for which and export file is to be created. Note : Once exported, the data exported will be marked as exported. This will ensure that the same data is not exported multiple times.
  • Export - Select to invoke the export. Once completed a prompt will be displayed confirming completion. A file named similar to GENERAL-2018_06_19_13_14_18_023.csv will be generated and written to the Export Path specified above.
  • Reset - Select a Trading Date to ensure that General Journal related transactions for that date are flagged as NOT Exported, so that they can be exported again. Select to display the following prompt:

 

  • Location Group - Select from the drop down list the Location Group for which data will be reset.
  • Trading Date - Select the Trading Date for which General Journal related transactions will be reset.  Note : Resetting is limited to a single date at a time.

 

Note : When Resetting and exporting Journals again, be sure that they DO NOT result in duplicate Journals when imported into MS Dynamics GP.

 

  • Mark ALL as Exported - Select to ensure ALL General Journal related data in SwiftPOS is marked as exported. Note : This is usually recommended when initially configuring SwiftPOS to export to MS Dynamics GP for the first time and there is a requirement that all previous General Journal related transactions are marked as Exported.
  • Note : For those Venues that have multiple Location Groups (Venues) and do Inventory/Stock transfres between them Location Group (Venues)For those Venues that  is usually recommended when initially configuring SwiftPOS to export to MS Dynamics GP for the first time and there is a requirement that all previous General Journal related transactions are marked as Exported.

 

Multi Venue (LGs) Inventory/Stock Transfers

 

To handle the transfer of Inventory/Stock between Location Groups (Venues), do as follows:
 

  1. Ensure that the setup outlined HERE has been completed.
  2. Ensure the checkbox opposite the appropriate Location Groups (Venues) has been selected. That is, all LGs that will be engaged in Inventory/Stock Transfers, regardless of whether they provide or receive inventory/Stock, or both.
  3. Run the export for the dates the Transfers took place. If all goes well then for a single transfer from one LG to another, at a minimum, 2 GL Journals should be generated that would look something similar to the following example:
     

4 bottles of wine with a total cost of $20.00 was transferred from the B&G Bottle Shop location in LG 0 to the LC Conference Room Bar location in LG 1

 

  1. GL Journal generated after exporting for the From LG 0:
    Batch Number,Account No,Line Description,DebitAmount,CreditAmount,Date,InterCompanyDB,InterCompanyTransaction
    SPGP20231024,6301001BGLBSH,Inventory - Beverage; B&G Bottle Shop,0,20,2023/10/24,PANTH,TRUE
    SPGP20231024,8652001BGLBSH,Inter Venue Transfers; B&G Bottle Shop,20,0,2023/10/24,PANTH,TRUE (Clearing Account Entry)
     
  2. GL Journal generated after exporting for the To LG 1:
    Batch Number,Account No,Line Description,DebitAmount,CreditAmount,Date,InterCompanyDB,InterCompanyTransaction
    SPGP20231024,6301104LGCCON,Inventory - Beverage; LC Conference Room Bar,20,0,2023/10/24,PANTH,TRUE
    SPGP20231024,8652104LGCCON,Inter Venue Transfers; LC Conference Room Bar,0,20,2023/10/24,PANTH,TRUE (Clearing Account Entry)

 


Import Chart of Accounts

 

For information regarding the Charts of Accounts file format, see below.

 

  • Select the Import Chart of Accounts button.
  • In the Open screen select the .CSV file to be imported.
  • Select Open
    • If an error is encountered during the Import, the following prompt will be displayed.

 

Errors can be viewed in the Event Logs > SwiftPOS Applications > SwiftPOS SQL Application logs.

 

    • If SUCCESSFUL, the grid in the Accounts tab will be populated with the imported MS Dynamics GP Accounts.

 

Chart of Accounts File Format

 

Field Name

Description

Data Type

Max Length

Account

The MS Dynamic GP Account

Text

10

Description

The description of the Account

Text

50

Type

The type of Account. For example Assets, Expenses, Sales, COGS, etc

Text

20

 

For example:

1001,Sales Bar Bulk Beer,Sales
1002,Sales Bar Bottled Beer,Sales
1003,Sales Bar Spirits,Sales
1004,Sales Bar Wine,Sales
3001,Purchases Bar Bulk Beer,COGS
3002,Purchases Bottled Beer ,COGS
3003,Purchases Bar Spirits,COGS
3004,Purchases Bar Wine,COGS

5000,Cash On Hand ,Assets

 


MS Dynamics GP End of Day (EOD)

 

To ensure Sales/Stock Movement transaction data is exported daily, ensure the following has been done:

 

  1. Complete the steps outlined in the Pre-Requisites above.
  2. Ensure the MS Dynamics GP Export option is selected in the EOD Options screen for the Location Groups (Venues) from which transactions will be exported.
  3. Confirm the EOD Run Time is correctly configured.
  4. Confirm the EOD Service is running.
  5. The first time the End of Day runs, check the Event Logs > SwiftPOS Services > End of Day Services. An example of the entries expected to be seen in the Event Log is shown below:

 

  1. Note : The first time the MS Dynamics GP Export runs successfully as part of the End of Day process, the export files generated will contain Journals for ALL Transactions that are NOT marked as Exported. This will mean that once the EOD has processed, there should not be any Trading Dates available for export, when viewed in the Export screen, for each of the Location Groups (Venues) that have the MS Dynamics GP Export option selected in the End of Day screen.

 


File Formats

 

The following is the file formats currently generated by Swiftpos to export to MS Dynamics GP. For an example of a export file generated, click here.

 

  1. Sales/Inventory Transaction Data

Field Name

Description

Data Type

Batch Number

SPGPYYYYMMDD

Text

Account

AAAABBBBBBCCC

Where AAAA is the MS Dynamic GP Account, BBBBBB is the Location/Site and CCC is the Department

Text

Line Description

AAAAAAAAAAAAAAAAAAA; BBBBBBBBBBBBBBBBB

Where AAAA is the MS Dynamic GP Account Description by default. However for Sales Accounts AAAA is the Product Group. BBBB is the Location Name.

Text

Debit Amount

The amount debited to the Account

Decimal

Credit Amount

The amount credited to the Account

Decimal

Date

DD/MM/YYYY - The Trading Date

Date

InterCompanyDB

The Location Group's selected Entity

Text

InterCompanyTransaction

True/False

Text

 


Related Topics

 

  1. Data Export
  2. Import/Export Overview
  3. Sample File