Netsuite Rest API

Screens

 


Subjects     

 


Settings     

 

screens-netsuite-rest-api-1

This screen is accessed from the Back Office by selecting the Data Export > Data Portal > NetSuite Rest API > Settings menu option.

 

Tabs     

 

Notes ...

 

It is recommended that all rows, in each of the tabs, be assigned/mapped to an Account or to the Exclude from Export 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, Location/Media and Location/Master Group entries are excluded from being exported. 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 post into NetSuite.

 

Configuration Tab     

 

screens-netsuite-rest-api-2

Used to configure the Connection, API Export and Location Level properties required for each Location Group (Venue) as required to ensure successful integration to NetSuite.
  • Venue - Select from the drop down list the appropriate Location Group (Venue).
  • Connection Properties
    Configure the following as provided by NetSuite:
    • Account ID
    • Consumer Key
    • Consumer Secret
    • Token ID
    • Token Secret
    • Company URL
    • Rest Services Path
  • API Export Properties
    Configure the following as is appropriate:
    • Custom Property Name
    • Custom Property
    • Approval Status
    • Currency
    • Custom Form
    • Default Class (Journal Entry)
    • Default Class (Vendor Bill/Credit)
    • Default Supplier Account
    • Exchange Rate
  • Location Level Properties
    • Department - Select to open the NetSuite Department Records screen to configure the appropriate NetSuite IDs and Descriptions for each Location.

      screens-netsuite-rest-api-3

    • Location - Select to open the NetSuite  Location Records screen to configure the appropriate NetSuite IDs and Descriptions for each Location.

      screens-netsuite-rest-api-4

    • Subsidiary - Select to open the NetSuite Subsidiary Records screen to configure the appropriate NetSuite IDs and Descriptions for each Location.

      screens-netsuite-rest-api-5

 

Accounts Tab     

 

screens-netsuite-rest-api-6

Displays a list of Account as imported (using the Import Chart of Accounts option at the bottom of the screen). Once imported, the remaining tabs to the right can be configured by assigning/mapping the imported Accounts in each of the tabs. For each Account imported the following attributes are displayed:

  • Account Number
  • Type
  • Status
  • Account id

 

Media Accounts Tab     

 

screens-netsuite-rest-api-7

 

Cost of Sales Accounts Tab     

 

screens-netsuite-rest-api-8

 

Sales Accounts Tab     

 

screens-netsuite-rest-api-9

 

Purchase Account Tab     

 

screens-netsuite-rest-api-10

 

Inventory Accounts Tab     

 

screens-netsuite-rest-api-11

 

Freight Accounts Tab     

 

screens-netsuite-rest-api-12

 

Surcharge Account Tab     

 

screens-netsuite-rest-api-13

 

 

Discount Accounts Tab     

 

screens-netsuite-rest-api-14

 

Rounding Accounts Tab     

 

screens-netsuite-rest-api-15

 

Tax Collected Accounts Tab     

 

screens-netsuite-rest-api-16

 

Tax Paid Accounts Tab     

 

screens-netsuite-rest-api-17

 

Location Group and Account Filters    

 

screens-netsuite-rest-api-20

Used to assign/map in bulk by selecting the Location Group and the NetSuite Account appropriate to the tab, before using one of the Apply To options available to assign/map it to multiple rows in the grid.

Filters

  • Location Group – Select from the drop down list of available Location Groups (Venues).
  • NetSuite Account (Media Account) – Select from the drop down list the NetSuite Account that will be used to assign/map to the SwiftPOS Location/Media combination.

 

Apply To Options     

 

screens-netsuite-rest-api-19

Used to assign/map the selected NetSuite Account to the rows in the grid by using one of the following options:

  • Selected Rows – Select to assign/map to all rows that are currently selected in the grid.
  • Unassigned Rows – Select to assign/map to all rows that are currently DO NOT have an Account assigned/mapped in the grid.
  • Selected Location – Select to assign/map to all rows in the grid that are associated with a selected Location.
  • Copy Location – Select to copy the assignments/mappings of a selected Location to another.

 


Export     

 

screens-netsuite-rest-api-18-1

This screen is accessed from the Back Office by selecting the Data Export > Data Portal > NetSuite Rest API > Export menu option.

 

Sections     

 

General Journals     
  • Location Group - Select from the drop down list the Location Group for which data will be exported.
  • Include in EOD - Select to ensure the export of data is included as part of the End of Day (EOD) process.
  • Location - Select from the drop down list the Location for which data will be exported.
  • Trading Date - Select from the drop-down list of dates the date for which data will be exported. If needed select the Refresh option (to the right of the drop-down list) to refresh the Trading Dates displayed.

 

Notes ...

 

Once exported, the data will be flagged as exported and the date will be removed from the Trading Date drop down list. This will ensure that the same data is NOT exported multiple times. It is important to note that even though the export for a specific Trading Date may NOT be completely successful, the Trading Date will still be removed from the drop down list. It is therefore VERY IMPORTANT to always review the Event Logs to ensure that any ERRORS are investigated and resolved in an appropriate manner.

 

  • Export - Select to invoke the export. Once completed a prompt will be displayed confirming completion. All exported General Journals can be viewed in the Event Logs.

 

Notes ...

 

If no prompt is displayed and the Export appears to have completed without the selected Trading Date being removed from the list of available dates, this may point to a failure of being able to connect to NetSuite. Check the Event Logs > swiftpos Applications > swiftpos SQL Application for any logging that may have occurred. Refer to Troubleshooting for more information.

 

  • Reset - Select a Trading Date to ensure that General Journal related data for that date are flagged as NOT Exported, so that they can be exported again. Select to display the following prompt:

 

screens-netsuite-rest-api-21

  • Reset continued ...
    • Location Group - Select from the drop down list the Location Group for which data will be reset.
    • Location - Select from the drop down list the Location for which data will be reset.
    • Trading Date - Select from the drop down list the Trading Date for which General Journal related data will be reset.

 

Notes ...

 

When resetting and exporting again, be sure that they DO NOT result in duplicates when imported into NetSuite.

 

  • Mark ALL as Exported - Select to display the following prompt and thereby ensure ALL General Journal related data in the selected Location is flagged as exported.

 

screens-netsuite-rest-api-22

 

  • Mark ALL as Exported continued ...
    • Location Group - Select from the drop down list the Location Group for which data will be flagged as exported.
    • Location - Select from the drop down list the Location for which data will be flagged as exported.

 

Notes ...

 

This is usually recommended when initially configuring swiftpos to Export to NetSuite for the first time and also, when there is a requirement that all existing General Journal related data for the current selection (Location Group / Location) needs to be flagged as exported.

 

Supplier Invoices     

  • Location Group - Select from the drop down list the Location Group for which data will be exported.
  • Include in EOD - Select to ensure the export of data is included as part of the End of Day (EOD) process.
  • Location - Select from the drop down list the Location for which data will be exported.
  • Trading Date - Select from the drop-down list of dates the date for which data will be exported. If needed select the Refresh option (to the right of the drop-down list) to refresh the Trading Dates displayed.

 

Notes ...

 

Once exported, the data will be flagged as exported and the date will be removed from the Trading Date drop down list. This will ensure that the same data is NOT exported multiple times. It is important to note that even though the export for a specific Trading Date may NOT be completely successful, the Trading Date will still be removed from the drop down list. It is therefore VERY IMPORTANT to always review the Event Logs to ensure that any ERRORS are investigated and resolved in an appropriate manner.

 

 

  • Export - Select to invoke the export. Once completed a prompt will be displayed confirming completion. All exported Supplier Invoices can be viewed in the Event Logs.

 

Notes ...

 

If no prompt is displayed and the Export appears to have completed without the selected Trading Date being removed from the list of available dates, this may point to a failure of being able to connect to NetSuite. Check the Event Logs > swiftpos Applications > swiftpos SQL Application for any logging that may have occurred. Refer to Troubleshooting for more information.

 

 

  • Reset - Select a Trading Date to ensure that Supplier Invoice related data for that date are flagged as NOT Exported, so that they can be exported again. Select to display the following prompt:

 

screens-netsuite-rest-api-21

  • Reset continued ...
    • Location Group - Select from the drop down list the Location Group for which data will be reset.
    • Location - Select from the drop down list the Location for which data will be reset.
    • Trading Date - Select from the drop down list the Trading Date for which Supplier Invoice related data will be reset.

 

Notes ...

 

When resetting and exporting again, be sure that they DO NOT result in duplicates when imported into NetSuite.

 

 

  • Mark ALL as Exported - Select to display the following prompt and thereby ensure ALL Supplier Invoice related data in the selected Location is flagged as exported.

 

screens-netsuite-rest-api-22

 

  • Mark ALL as Exported continued ...
    • Location Group - Select from the drop down list the Location Group for which data will be flagged as exported.
    • Location - Select from the drop down list the Location for which data will be flagged as exported.

 

Notes ...

 

This is usually recommended when initially configuring swiftpos to Export to NetSuite for the first time and also, when there is a requirement that all existing Supplier Invoice related data for the current selection (Location Group / Location) needs to be flagged as exported.

 

End of article.