Setting up Communication Engine for Vision Pre-Advices

Configure Communication Engine mappings for Vision pre-advice messages.

Prerequisites

Account with a Vision managed warehouse: LCB, Vinotheque, Lanchester, EHD, Coterie Vaults.

Communication Engine

The communication engine is a solution framework to enable the communication of data between Bevica and various endpoints such as a Vision warehouse.

Initial Setup

If you are not already using the communication engine to send or receive other files from the warehouse, e.g., orders, you will need to complete some initial setup. If you are already using the communication engine, you can skip this part and move to setting up the communication engine route.

1. Warehouse Integration Setup

You will need to populate the following Vision account information in the Warehouse Integration Setup record. The information will be supplied by Vision or your warehouse.

• Path to API e.g.

http://kingmoor.lcb.co.uk (LCB)

http://edi.ehdlondon.co.uk (EHD)

http://kingmoor.lanchestergroup.com (Lanchester)

• Customer Code
• Site Code
• API Username (Client ID)
• API Password (Client Secret)

2. Communication Engine Setup

Prior to setting up any communication engine routes, you need to initialise the communication engine. To do this:

1. Search for Communication Engine Setup and select to Initialise Setup. Note that if you receive an error about the TVTCOM package, this can be ignored.
2. Search for Warehouse Integration Setup, open the Warehouse Supplier Setup card, and select Actions, Create Communication Engine Auth.

Users will need the COMMUNICATION ENGINE permission set to access this functionality if they are not a super user.

Setting up a Communication Engine Route

You will need to set up a new communication engine route for Vision Pre-Advice Outbound Requests. To do this, search for Communication Engine Routes and create a new record. Populate the fields as follows:

Field	Note
Code	Enter a code for the record e.g. LCB_PREADVICE
Type	Http
Direction	Outbound
Communication Code	• Enter a Code, e.g. LCB_PREADVICE • End Point = /service/PreAdvice • is the URL base e.g.http://kingmoor.lcb.co.uk • Content Type = application/xml • Method = Post • Request Body Required = Yes • Authentication Code, drill down and select the record that has been created e.g. LCB01
Description	Enter a description
Route Action	Vision Preadvice Export
Synchronise Routes	Tick this
Process Message	Tick this
Task Scheduler	Tick this if you are going to set up the job queue
Task Sched. Parameter	Populate this, e.g. PREAD_REQ. This will be the value to populate the Parameter String on the job queue for codeunit 68807. See below.
Whse. Integration Setup	Select the relevant Warehouse Integration Setup record.

Retention policy setup

If you don't have this setup already, you can define a retention policy to delete outdated communication engine message records. To do this:

1

Step 1

Choose the icon, enter Communication Engine Setup, and then choose the related link.

2

Step 2

Select Setup Comm. Messages Retention Policy.

3

Step 3

Amend the defaults if required and select to Enable.

For more information, see Retention Policies.

Exporting files manually

Whilst you are testing the API functionality, you can run the process manually:

1. Process Outbound Requests

   • From the Outbound Request Page, select Process Requests in the ribbon. Populate the Whse. Integration Setup Code and select to Generate and Send Requests. Optionally filter on Entry Number or Supplier Request Code = PREAVICE.
   • This will create the file, mark the Outbound Request as Sent, and create a communication engine message.
2. Send the Communication Engine message to Vision

   • From the Outbound Request Page, select Comm. Engine Routes in the ribbon. You should see the route for Preadvices with a number in the No. of Pending Messages column.
   • Select Run Communication Engine to send the message to Vision. This should move the message to the No. of Messages Completed column.

Setting up the job queues

Once you are happy with the functionality, you can set up the job queues to run these two functions.

1. Process Outbound Requests

   • This will create the file, mark the Outbound Request as Sent, and create a communication engine message.
   • Create a job queue entry for Report 71303 Whse. Integration Process Outbound Requests.
   • On the Report Request page, populate the Whse. Integration Setup code and toggle on Generate Requests and Send Generated Requests. Optionally populate the Supplier Request Code = PREADVICE to send Orders and Pre-Advices separately.
   • Set the job queue entry to run on relevant days, e.g., Monday to Friday.
   • Set the Starting Time and Ending Time.
   • Set the job queue to Ready.
2. Send the Communication Engine message to Vision

   • This will send the communication engine message to Vision.
   • Create a job queue entry for Codeunit 68807 TVTCOM Run from Job Queue.
   • Set the Parameter String to be the same as the Task Sched. Parameter value on the Communication Engine Route record for the pre-advice record e.g. PREAD_REQ.
   • Set the job queue to run on relevant days, e.g., Monday to Friday.
   • Set the Starting Time and Ending Time.
   • Set the job queue to Ready.

Troubleshooting

See Communication Engine Messages for details of how communication engine messages are generated and what to do if the message errors.