Testing the Integration

This article describes the Push and Pull methods between the BSS and external integration systems through the custom integration connector. As an example, we will use a Microsoft Dynamics Navision integrator to show the procedure. 

Testing Process of the Custom Integrator

To test BSS and MS Dynamics Navision:

  1. Go BSS → Setup → Administration → System Options and select Systems Setup
  2. On the custom created integrator select Edit Integration

  3. Go to the bottom of the page to the Api Tester section. Api Tester is available for Active and Inactive Integration Instances
  • For inactive integration instances, provide an instance name to the integration system by selecting Settings. You do not have to activate that instance.

  • For active integration instances, you can use the Api Tester module as shown in this section:
    1. On the Provider Instance, select the instance name you have selected.
    2. The Module section contains all the entities you can sync.
    3. In the Object ID  section, input the ID of the object

      • To try the Push method find the ID using one of the methods below

      • To try the Pull method find the ID into the External System.

  1. Click on Push Data or Pull Data to test
      • Select Push Data to push data from BSS into the Navision system. 
      • Select Pull Data to pull data from External System to the BSS system. 

Push and Pull method Results

  1. If the method is has been completed successfully, you will receive an OK message.
  2. If the method is not successful, you will receive an error message like the below:

Finding Object ID in BSS

Account ID

Go to BSS → Office → Accounts → Select the desired account.
 As you can see from the example below, the ID is 191599

Contacts ID

Go to BSS → Office → Contacts →  Select the desired contact

Copy the ID of the customer from the address bar like Account ID.

Products ID

Go to BSS → Billing → Products

  • If the Product is under a Product Group:
    1. Go to the Product Group
    2. Select the desired product
    3. Find the product ID on the address bar
  • If the product is not included in a product group:
      1. Find the desired product on the list
      2. Find the product ID on the address bar

Invoice ID

Go to BSS → Billing → Invoices

  1. In the View filter select All Invoices
  2. Select the desired invoice
  3. Find the Invoice ID on the address Bar

InvoiceItems ID

While you are in the invoice:

  1. Select the Invoice Items tab
  2. Copy the name or code of the item and then find it in the same way as Product ID

Orders ID

  1. Go to BSS → Sales → Orders
  2. In the View Filter Select All Orders
  3. Select the desired order
  4. Find the Order ID in the address bar

While you are in the Order:

  1. Select the Invoice Items tab
  2. Copy the name or code of the item and then find it in the same way as Product ID

OrderItems ID

While you are in the Order:

  1. Select the Invoice Items tab
  2. Copy the name or code of the item and then find it in the same way as Product ID


Payments ID

  1. Go to the desired Invoice on the Payments section. Under the Payment
    1. Right-click on the blank space and select Inspect Element
    2. Open the TD
    3. Find the Payment ID