Table of Contents

Integration Customer Center

Enables real-time retrieval and display of data directly from ERP systems

The Integration Customer Center (ICC) is an app designed to retrieve and display real-time data from ERP systems, such as Microsoft Dynamics 365 Business Central.

Supported document types are:

  • Open orders
  • Invoices
  • Credit notes
Note

When using Business Central as the ERP system, the ICC displays posted invoices and credits

Using the ICC, you can:

  • Retrieve lists of each supported document type
  • Render an instance of a document type based on a template
  • Retrieve a pdf of an instance of a document type

To see how ICC works conceptually, refer to our documentation.

Note

Before you can use the ICC, you must have a live integration setup up, as it depends on retrieving and displaying data in real-time.

After you've set up the live integration, you need to:

  • Add the ICC app to a paragraph on your solution
  • Make sure your remote system returns XML in the format expected by DynamicWeb

App Settings

Add the app to a paragraph on your solution to access the app settings, which allow you to control the behaviour of the app.

Integration Customer Center 1

If you wish to see how the ICC app is set up in Swift, refer to our documentation.

The Navigation templates allows you to render a navigation for switching between your ICC pages: Orders, Invoices, and Credits.

The template must use Razor syntax to render the ICC content dynamically. To display the page content, ensure the template includes the following Razor code:

@GetValue("Ecom:IntegrationCustomerCenter.PageContent")

Pages

The Pages section controls which types of documents you want to render, i.e. order, invoices, and credits. Each page settings view allows you to:

  • Provide a Name for the page
  • Select a document Type to render
  • Provide a Menu name
  • Provide a Tag name
  • Select a List template and an Item template to render the list and list entries with
  • Provide an Item id parameter name

Integration Customer Center 2

Paging

Finally, you can set up paging using the paging controls:

  • Set the Items per page
  • Select the 'Next' button text and the 'Previous' button text

Passing custom parameters to Business Central with the ICC

The Integration Customer Center app is capable of passing user input directly to Business Central by analyzing the request parameters when loading the frontend page. Any parameters prefixed with “ICC_” will be included in the XML to Business Central.

Example
If, for instance, you wish to filter records by year, Dynamicweb would respond to a http request parameter, ICC_Year=2022, and pass it through to Business Central as an attribute of the GetList node:

<GetList type="DeliveryNote" customerID="1234" requestAmount="10" firstItem="1" Year="2022"></GetList>

Multiple parameters can be passed and must be agreed between the Business Central developer and the Dynamicweb Developer. The parameters can be used for filtering, sorting or even for instructing Business Central to save different kinds of data depending on the scenario.

Improve this doc
To top