AgeCode

Age Code APIs to POST, PUT, GET and DELETE AgeCode Information

APIDescription
GET api/v7/AgeCode

Retrieves the list of Age Code for a given tenant. The tenant information is verified through the token.

POST api/v7/AgeCode

Add a new Age Code.

PUT api/v7/AgeCode

Add or Update an AgeCode.

GET api/v7/AgeCode/{AgeCodeName}

Retrieves the Age Code information for the given Age Code name.

DELETE api/v7/AgeCode/{AgeCodeName}

Deletes an existing Age Code.

Batchapply

APIDescription
POST api/v7/BatchApply

No documentation available.

GET api/v7/BatchApply?BatchCode={BatchCode}

No documentation available.

PUT api/v7/BatchApply?BatchCode={BatchCode}&Status={Status}

No documentation available.

GET api/v7/BatchApply?StartDate={StartDate}&EndDate={EndDate}

No documentation available.

Encryption

API to encrypt/decrypt data

APIDescription
POST api/v7/Encryption/Decrypt

Decrypts encrypted data

POST api/v7/Encryption/Encrypt

Encrypts given data

EncryptionKey

API to GET, POST and DELETE encryption key

APIDescription
POST api/v7/EncryptionKey

Add new Encryption Key/Value pair.

GET api/v7/EncryptionKey

Returns the current active encryption key and Id for tenant

GET api/v7/EncryptionKey/GetAll

Returns all the encryption key and Id for current tenant

DELETE api/v7/EncryptionKey?keyCode={keyCode}

Delete an Encryption Key/Value pair.

GET api/v7/EncryptionKey?keyCode={keyCode}

Returns the encryption key/value pair with the specified Key Code

FileOperations

File Operations Controller

APIDescription
GET api/v7/FileOperations/GetFile?fileName={fileName}

Retrieves the file (if present) in the specified path configured through sourceData with matching fileName

GroupDetails

APIs for GroupDetails POST, PUT, DELETE and GET

APIDescription
DELETE api/v7/GroupDetails

Delete product group detail information.

PUT api/v7/GroupDetails

Add or Update group detail information.

POST api/v7/GroupDetails

Create group detail information.

GET api/v7/GroupDetails

Returns all group detail record from the database.

GET api/v7/GroupDetails/{groupCode}

Returns group detail record from the database.

GET api/v7/GroupDetails/{groupCode}/Products

Returns all products which belong to a specific group.

GET api/v7/GroupDetails/Products

Returns all products which belong to a group.

Groups

APIs for Group POST, PUT, DELETE and GET

APIDescription
PUT api/v7/Groups

Add or Update group information from a client.

POST api/v7/Groups

Accepts group information from a client.

GET api/v7/Groups

Returns all group records from the database.

DELETE api/v7/Groups/{groupCode}

Delete product group information.

GET api/v7/Groups/{groupCode}

Returns a group record from the database.

Hierarchies

Hierarchies APIs to POST, PUT, DELETE and GET

APIDescription
GET api/v7/Hierarchies

Retrieve the 'paged' list of hierarchies for a given tenant. [Optional Header]: {PageSize} - Defines the number of records in one page. Along with PageIndex it can be used to retrieve a subset of data. If this parameter is not provided, system takes default page size. [Optional Header]: {PageIndex} - Defines which page would be retrieved from server. If this parameter is not provided, system pulls the first page with 'PageSize' set of records. Example: If PageIndex is 0 and PageSize is 50, the response is first 50 records.

POST api/v7/Hierarchies

Add a new hierarchy.

PUT api/v7/Hierarchies

Add or Update existing hierarchy.

GET api/v7/Hierarchies/{hierarchyCode}

Retrieve the hierarchy information for the given hierarchy code.

DELETE api/v7/Hierarchies/{hierarchyCode}

Delete an existing hierarchy.

GET api/v7/Hierarchies/GetDepartments

Retrieve the hierarchy information all departments

GET api/v7/Hierarchies?hierarchyLevelCode={hierarchyLevelCode}

Retrieve the hierarchy information for the given hierarchy level code.

GET api/v7/Hierarchies?hierarchyParentCode={hierarchyParentCode}

Retrieve the hierarchy information for the given hierarchy parent code.

HierarchyAgeCode

APIDescription
GET api/v7/HierarchyAgeCode

Retrieve the list of all Hierarchy-AgeCodes for current organization

POST api/v7/HierarchyAgeCode

Adds a new Hierarchy-AgeCode

GET api/v7/HierarchyAgeCode/{hierarchyCode}

Retrieve the Unit of Measure information for given Hierarchy Code for current organization

HierarchyLevels

APIs for HierarchyLevels POST, PUT and GET

APIDescription
GET api/v7/HierarchyLevels

Returns HierarchyLevelCode and LevelName for all HierarchyLevels.

PUT api/v7/HierarchyLevels

Add or Update Hierarchy Level. Accepts HierarchyLevelCode and LevelName and return a response containing an acknowledgement. If the record exists than it updates; If the record does not exist than the API inserts the record.

POST api/v7/HierarchyLevels

Adds a HierarchyLevel. Accepts HierarchyLevelCode and LevelName and return a response containing an acknowledgement.

GET api/v7/HierarchyLevels/{hierarchyLevelCode}

Accepts a HierarchyLevelCode from client and return HierarchyLevelCode and the LevelName as a response.

HierarchyProducts

APIDescription
POST api/v7/HierarchyProducts

Receive a hierarchy code from client and return product information as response.

Options

API for Option GET

APIDescription
GET api/v7/Options?groupName={groupName}&deviceName={deviceName}&store={store}

Returns the requested parameter group from the database.

GET api/v7/Options?parentDeviceName={parentDeviceName}

Returns the requested TouchTypes from the database.

PrePacks

APIs for PrePacks POST, PUT, DELETE and GET

APIDescription
PUT api/v7/PrePacks

Update prePack information from a client.

POST api/v7/PrePacks

Accepts prePack information from a client.

GET api/v7/PrePacks

Returns all prePack records from the database.

DELETE api/v7/PrePacks/{prePackCode}

Delete product prePack information.

GET api/v7/PrePacks/{prePackCode}

Returns a prePack record from the database.

ProductAgeCode

APIs for ProductAgeCode POST, PUT and GET

APIDescription
GET api/v7/ProductAgeCode

Retrieve the list of all AgeCode Restrictions on all Products for current organization

POST api/v7/ProductAgeCode

Adds a new Product-AgeCode

PUT api/v7/ProductAgeCode

Updates/Adds a Product-AgeCode

GET api/v7/ProductAgeCode/{ProductCode}?OrgName={OrgName}

Retrieve the AgeCode Restriction information for given Product Code for current organization

ProductDescriptions

APIDescription
PUT api/v7/ProductDescriptions

Add or Update a product description information from a client.

POST api/v7/ProductDescriptions

Accepts a product description information from a client.

GET api/v7/ProductDescriptions/{productCode}?description={description}

Search products description for client and return products description information as response.

ProductOrgFeature

APIs for Product Org Feature POST, PUT and GET

APIDescription
GET api/v7/ProductOrgFeature

Retrieve the list of all product features of all Products

POST api/v7/ProductOrgFeature

Adds a new Product Org Feature

PUT api/v7/ProductOrgFeature

Add or Update a Product Org Feature

GET api/v7/ProductOrgFeature/{ProductCode}?OrgName={OrgName}

Retrieve the product features information for given Product Code for given organization

ProductPrices

APIDescription
PUT api/v7/ProductPrices

Add or Update a product price information from a client.

POST api/v7/ProductPrices

Accepts a product price information from a client.

GET api/v7/ProductPrices/{productCode}?lowestPriceDate={lowestPriceDate}

Search the lowest product price of a product which is still in effect for the specified lowestPriceDate.

GET api/v7/ProductPrices/{productCode}?priceStartDate={priceStartDate}

Search products price for client and return products price information as response.

Products

APIDescription
PUT api/v7/Products

Add or Update a product information from a client.

POST api/v7/Products

Accepts a product information from a client.

DELETE api/v7/Products/{productCode}

Delete a product information from a client.

GET api/v7/Products/{productCode}?effectiveStartDateTime={effectiveStartDateTime}

Receive a product a code from client and return product information as response.

GET api/v7/Products?effectiveStartDateTime={effectiveStartDateTime}

Receive all products information as response. [Optional Header]: {PageSize} - Defines the number of records in one page. Along with PageIndex it can be used to retrieve a subset of data. If this parameter is not provided, system takes default page size. [Optional Header]: {PageIndex} - Defines which page would be retrieved from server. If this parameter is not provided, system pulls the first page with 'PageSize' set of records. Example: If PageIndex is 0 and PageSize is 50, the response is first 50 records.

GET api/v7/Products?productCodeList={productCodeList}

Receive a list of comma delimted productcode from client and return product information as response.

GET api/v7/Products?productId={productId}&orgName={orgName}&effectiveStartDateTime={effectiveStartDateTime}

Receive a product a code and orgName from client and return product information as response. [Optional Header]: {PageSize} - Defines the number of records in one page. Along with PageIndex it can be used to retrieve a subset of data. If this parameter is not provided, system takes default page size. [Optional Header]: {PageIndex} - Defines which page would be retrieved from server. If this parameter is not provided, system pulls the first page with 'PageSize' set of records. Example: If PageIndex is 0 and PageSize is 50, the response is first 50 records.

GET api/v7/Products?searchCriteria={searchCriteria}

Search products for client and return products information as response. [Optional Header]: {PageSize} - Defines the number of records in one page. Along with PageIndex it can be used to retrieve a subset of data. If this parameter is not provided, system takes default page size. [Optional Header]: {PageIndex} - Defines which page would be retrieved from server. If this parameter is not provided, system pulls the first page with 'PageSize' set of records. Example: If PageIndex is 0 and PageSize is 50, the response is first 50 records.

ProductVendors

APIDescription
PUT api/v7/ProductVendors

Add or Update a product vendor information from a client.

POST api/v7/ProductVendors

Accepts a product vendor information from a client.

GET api/v7/ProductVendors/{productCode}?vendorCode={vendorCode}

Get products vendor for client and return products vendor information as response.

Reports

Reports control exposes methods to generate enterprise reports.

APIDescription
GET api/v7/Reports/StoreSalesReport?TenderTypeIDs={TenderTypeIDs}&TenderTypeDescriptions={TenderTypeDescriptions}&TenderTypeIsRefundable={TenderTypeIsRefundable}&StoreId={StoreId}&StartDate={StartDate}&EndDate={EndDate}

Generates a store sales report based on the criteria provided.

Restriction

Restriction API for POST, PUT and GET

APIDescription
GET api/v7/Restriction

Retrieve the list of Restrictions.

POST api/v7/Restriction

Adds a new Restriction

PUT api/v7/Restriction

Add or Update an existing Restriction

GET api/v7/Restriction/{restrictionCode}

Retrieve the Restriction information for given Restriction Code

RestrictionDetail

Restriction Details APIs for POST, DELETE and GET

APIDescription
POST api/v7/RestrictionDetail

Adds new Restriction Details

DELETE api/v7/RestrictionDetail

Removes existing Restriction Details

GET api/v7/RestrictionDetail/{restrictionCode}

Retrieve the products and hierarchies related to a given Restriction Code

Roles

Roles APIs for POST, PUT, GET and DELETE

APIDescription
GET api/v7/Roles

Get all roles for a tenant. Tenant information is obtained from Token

POST api/v7/Roles

Add a new role

PUT api/v7/Roles

Add or Update a role

GET api/v7/Roles/{roleCode}

Get a role by roleCode

DELETE api/v7/Roles/{roleCode}

Delete a role

Security

Security APIs for 'Login', 'Logout', 'Token validation' and 'Reset password' for the system

APIDescription
POST api/v7/Security/Login

Issues an authentication token to a user based on provided orgName, user name and password. The tenant name is optional which can be set via a custom header "nep-organization".

POST api/v7/Security/Logout

Logs out a previously issued token. The token should be set in 'Authorization' header.

POST api/v7/Security/ResetPassword

Change the current user password based on provided user name and password within an organization context. The tenant name is optional which can be set in the "nep-organization" header.

GET api/v7/Security/ValidateToken?token={token}

Validates an issued token

TaxClassTaxRules

Tax type APIs for POST, PUT, DELETE and GET

APIDescription
GET api/v7/TaxClassTaxRules

Retrieve the list of tax class and tax rule for a given tenant.

POST api/v7/TaxClassTaxRules

Add a new tax class and tax type.

PUT api/v7/TaxClassTaxRules

Add or Update an existing taxclass-TaxRule.

GET api/v7/TaxClassTaxRules/{taxClassCode}

Retrieve the tax class and tax rule information for the given tax class code.

GET api/v7/TaxClassTaxRules/{taxClassCode}?taxCode={taxCode}

Retrieve the tax class and tax rule information for the given tax class and tax code.

GET api/v7/TaxClassTaxRules/{taxClassCode}?taxRuleCode={taxRuleCode}

Retrieve the tax class and tax rule information for the given tax class and tax rule code.

GET api/v7/TaxClassTaxRules/{taxClassCode}?taxRuleCode={taxRuleCode}&taxCode={taxCode}

Retrieve the tax class and tax rule information for the given tax class, tax rule and tax code.

GET api/v7/TaxClassTaxRules?taxCode={taxCode}

Retrieve the tax class and tax rule information for the given tax code.

TaxClassTaxTypes

Tax type APIs for POST, PUT and GET

APIDescription
GET api/v7/TaxClassTaxTypes

Retrieve the list of tax class and tax type for a given tenant.

POST api/v7/TaxClassTaxTypes

Add a new tax class and tax type.

PUT api/v7/TaxClassTaxTypes

Add or Update an existing taxclass-taxtype.

GET api/v7/TaxClassTaxTypes/{taxClassCode}

Retrieve the tax class and tax type information for the given tax class code.

GET api/v7/TaxClassTaxTypes/{taxClassCode}?taxTypeCode={taxTypeCode}

Retrieve the tax class and tax type information for the given tax type code.

GET api/v7/TaxClassTaxTypes?taxTypeCode={taxTypeCode}

Retrieve the tax class and tax type information for the given tax type code.

Taxes

Tax API for POST, PUT, GET and DELETE

APIDescription
GET api/v7/Taxes

Retrieve the list of tax for a given tenant.

POST api/v7/Taxes

Add a new tax.

PUT api/v7/Taxes

Add or Update an existing tax.

GET api/v7/Taxes/{taxCode}

Retrieve the tax information for the given tax code.

DELETE api/v7/Taxes/{taxCode}?activeDate={activeDate}

Delete an existing tax.

GET api/v7/Taxes?locationName={locationName}

Retrieve the tax information for the given tax destination.

GET api/v7/Taxes?taxClassCode={taxClassCode}

Retrieve the tax information for the given tax code.

GET api/v7/Taxes?taxTypeCode={taxTypeCode}

Retrieve the tax information for the given tax code.

TaxLocations

TaxLocation API for POST, PUT, GET and DELETE

APIDescription
GET api/v7/TaxLocations

Retrieve a list of tax destinations.

POST api/v7/TaxLocations

Add a new tax destination.

PUT api/v7/TaxLocations

Add or Update an existing tax destination.

DELETE api/v7/TaxLocations?locationName={locationName}

Delete an existing tax destination.

Taxonomies

Taxonomy APIs for GET, DELETE, POST and PUT

APIDescription
POST api/v7/Taxonomies

Accepts a taxonomy record to add to the database.

GET api/v7/Taxonomies

Returns all taxonomy records from the database.

PUT api/v7/Taxonomies/{taxonomyName}

Add or Update a taxonomy record in the database.

GET api/v7/Taxonomies/{taxonomyName}

Returns a taxonomy record from the database.

DELETE api/v7/Taxonomies/{taxonomyName}

Removes a taxonomy record from the database.

GET api/v7/Taxonomies?locationType={locationType}

Returns a set of taxonomy records matching the criteria or all taxonomy records if no criteria are provided.

GET api/v7/Taxonomies?locationType={locationType}&region={region}

Returns a set of taxonomy records matching the criteria or all taxonomy records if no criteria are provided.

GET api/v7/Taxonomies?organizationName={organizationName}

Returns a taxonomy record and its entire parent chain.

GET api/v7/Taxonomies?region={region}

Returns a set of taxonomy records matching the criteria or all taxonomy records if no criteria are provided.

TaxonomyLevels

Taxonomy level APIs for GET, POST and PUT

APIDescription
POST api/v7/TaxonomyLevels

Accepts a taxonomy level record to add to the database.

GET api/v7/TaxonomyLevels

Returns all taxonomy level records from the database.

PUT api/v7/TaxonomyLevels/{taxonomyLevelName}

Add or Update a taxonomy level record in the database.

GET api/v7/TaxonomyLevels/{taxonomyLevelName}

Returns a taxonomy level record from the database.

DELETE api/v7/TaxonomyLevels/{taxonomyLevelName}

Removes a taxonomy level record from the database.

TaxRules

tax rule APIs for POST, PUT and GET

APIDescription
GET api/v7/TaxRules

Retrieve the list of tax rule for a given tenant.

POST api/v7/TaxRules

Add a new tax rule.

PUT api/v7/TaxRules

Add or Update an existing tax rule.

GET api/v7/TaxRules/{taxRuleCode}

Retrieve the tax rule information for the given tax rule code.

TaxTables

Tax Table API for POST, PUT, GET and DELETE

APIDescription
GET api/v7/TaxTables

Retrieve the list of tax tables for a given tenant.

POST api/v7/TaxTables

Add a new tax table.

PUT api/v7/TaxTables

Add or Update an existing tax table.

GET api/v7/TaxTables/{taxTableCode}

Retrieve the tax table information for the given tax table code.

DELETE api/v7/TaxTables/{taxTableCode}

Delete an existing tax table.

TaxTypes

Tax type APIs for POST, PUT and GET

APIDescription
GET api/v7/TaxTypes

Retrieve the list of tax type for a given tenant.

POST api/v7/TaxTypes

Add a new tax type.

PUT api/v7/TaxTypes

Add or Update an existing tax type.

GET api/v7/TaxTypes/{taxTypeCode}

Retrieve the tax type information for the given tax type code.

TerminalStatus

The terminal status controller

APIDescription
POST api/v7/TerminalStatus

Accepts a terminal status message from a client.

TerminalStatusReport

The terminal status report controller

APIDescription
POST api/v7/TerminalStatusReport

Accepts a property record that describes how a terminal should be presented in the terminal status report.

GET api/v7/TerminalStatusReport?taxonomyName={taxonomyName}

Returns the terminal status records for a taxonomy group and its child groups.

TransactionLookups

Controller for customer transaction lookups

APIDescription
POST api/v7/TransactionLookups/CustomerByAccountToken

Search for last customer entry recorded with an email address and return the customer with basic transaction data.

POST api/v7/TransactionLookups/CustomerTransaction

Perform a customer transaction lookup request using the provided customer and period and return the transaction overview information. The period can either be the last N transactions or days.

POST api/v7/TransactionLookups/DisplayTransaction

Perform a display transaction lookup for the specified transaction and return the item data for the transaction or an error message.

POST api/v7/TransactionLookups/DisplayTransactionDetails

Perform a display transaction lookup for the specified transaction and return the detail item data for the transaction or an error message.

POST api/v7/TransactionLookups/ReturnLookup

Perform a return lookup request using 1 or more original transactions, or a member ID, or an account number to limit the possible transactions and a single item that is in at least one of the transactions.

POST api/v7/TransactionLookups/ReturnPricePoint

Perform a return price point lookup request using 1 original transactions, 1 item that is in the transaction and a price point for that item and return a line item and other transaction data associated with the provided data.

POST api/v7/TransactionLookups/SearchTransaction

Perform a a transaction search based on supplied criteria, which returns transaction summaries of matching records. [Optional Header]: {PageSize} - Defines the number of records in one page. Along with PageIndex it can be used to retrieve a subset of data. If this parameter is not provided, system takes default page size. [Optional Header]: {PageIndex} - Defines which page would be retrieved from server. If this parameter is not provided, system pulls the first page with 'PageSize' set of records. Example: If PageIndex is 0 and PageSize is 50, the response is first 50 records. The body of the post contains the SearchTransactionRequest to be executed

POST api/v7/TransactionLookups/TaxDetails

Retrieve the tax details in a transaction (group by line item).

POST api/v7/TransactionLookups/TotalSpend

Perform a total spend lookup request using the provided customer and timeframe and return the total spend information

POST api/v7/TransactionLookups/TransactionInfo

Lookup a transaction based on the provided transaction ID

POST api/v7/TransactionLookups/TrustedCustomerCheck

This method will check if the specified customer has exceeded the specified number of non-receipted returns in the specified period. The customer will be added if it does not exist.

POST api/v7/TransactionLookups/TrustedCustomerUpdate

This method will add a non-receipted return for the specified customer on the specified date

POST api/v7/TransactionLookups/UnlockItem

Unlock the specified item and make it available for future lookups

POST api/v7/TransactionLookups/UnlockTransaction

Unlock the specified transaction and make it available for future lookups

POST api/v7/TransactionLookups/VoidTransaction

Checks the specified transaction to see if it can be voided

Transactions

The transaction controller

APIDescription
POST api/v7/Transactions

Accepts a PosLog transaction from a client.

PUT api/v7/Transactions/{transactionId}

Updates a transaction in the database.

GET api/v7/Transactions/{transactionId}

Returns a requested transaction from the database.

TransactionSearch

Transaction Search Controller

APIDescription
POST api/v7/TransactionSearch/Search

Searches transactions based on the provided filters.

UOM

Unit of Measure APIs for POST, PUT and GET

APIDescription
GET api/v7/UOM

Retrieve the list of all UOMs.

POST api/v7/UOM

Adds a new UOM

PUT api/v7/UOM

Add or Update an existing UOM

GET api/v7/UOM/{UomCode}

Retrieve the Unit of Measure information for given UOM Code

UserRoles

APIs to POST, PUT and DELETE 'User' to an 'Organization' and 'Specific Role' in the system

APIDescription
POST api/v7/UserRoles

Add a user to an org unit with a role. Please note that ** API supports multiple job codes per user. This will be supported by the POS in a future release. **

DELETE api/v7/UserRoles

Remove a user from an org unit/role

PUT api/v7/UserRoles

Add or Update the user's org unit/role. Please note that ** API supports multiple job codes per user. This will be supported by the POS in a future release. **

Users

User APIs to POST, PUT, GET and DELETE user information

APIDescription
GET api/v7/Users

Gets all users for a tenant

POST api/v7/Users

Create a new user. Please note that ** API supports multiple job codes per user. This will be supported by the POS in a future release. **

GET api/v7/Users/{userId}

Get a user by id

PUT api/v7/Users/{userId}

Add or Update an existing user. Please note that ** API supports multiple job codes per user. This will be supported by the POS in a future release. **

DELETE api/v7/Users/{userId}

Delete an existing user

GET api/v7/Users?alternateId={alternateId}

Get a user by alternate id

GET api/v7/Users?orgName={orgName}

Get a user by orgName

Vendors

Vendor API for POST, PUT and GET

APIDescription
PUT api/v7/Vendors

Add or Update vendor information from a client.

POST api/v7/Vendors

Accepts vendor information from a client.

GET api/v7/Vendors

Returns all vendor records from the database.

DELETE api/v7/Vendors/{vendorCode}

Delete a product vendor information from a client.

GET api/v7/Vendors/{vendorCode}

Returns a vendor record from the database.

GET api/v7/Vendors?locationType={locationType}

Returns a set of vendor records matching the criteria or all vendor records if no criteria are provided.

GET api/v7/Vendors?locationType={locationType}&region={region}

Returns a set of vendor records matching the criteria or all vendor records if no criteria are provided.

GET api/v7/Vendors?region={region}

Returns a set of vendor records matching the criteria or all vendor records if no criteria are provided.

SecurityV8

Newer version(V8) of Security APIs for 'Login', 'Logout', 'Token validation' and 'Reset password' for the system

APIDescription
POST api/v8/Security/Login

Issues an authentication token to a user based on provided orgName, user name and password. The tenant name is optional which can be set via a custom header "nep-organization".

POST api/v8/Security/Logout

Logs out a previously issued token. The token should be set in 'Authorization' header.

POST api/v8/Security/ResetPassword

Change the current user password based on provided user-name and password within an organization context. The tenant name is optional which can be set in the "nep-organization" header.

GET api/v8/Security/ValidateToken

Validate an issued token. The token should be set in 'Authorization' header.

TransactionSearchV8

Newer version(V8) of Transaction Search API

APIDescription
POST api/v8/TransactionSearch/Search

Searches transactions based on the provided filters.