Table of Contents

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:

Go BSS → Setup → Administration → System Options and select Systems Setup
On the custom created integrator select Edit Integration
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.
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

If the method is has been completed successfully, you will receive an OK message.
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. 1. Find the desired product on the list
  2. Find the product ID on the address bar

Invoice ID

Go to BSS → Billing → Invoices

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

InvoiceItems ID

While you are in the invoice:

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

Orders ID

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

While you are in the Order:

Select the Invoice Items tab
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:

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

Payments ID

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