Preparing to retrieve orders from MarcomCentral

To retrieve orders from a store at the MarcomCentral web site, copy the MarcomReceiveOrders SOAP web service input device supplied with the MarcomCentral Connect feature. The Request URL and Request payload properties of the input device are set to call the Order MarcomCentral web service and retrieve orders by date. Set other properties to values that work with your MarcomCentral store and RICOH ProcessDirector workflows.

Before doing this procedure, make sure that you imported WSDL files and installed a security certificate. If your environment requires a proxy server to communicate with MarcomCentral, make sure that you set up the system to use it. For more information, see the related tasks.

To prepare to retrieve orders from MarcomCentral:
  1. Click the Administration tab.
  2. In the left pane, click Devices ⇒ Input Devices.
  3. Copy the MarcomReceiveOrders input device and give it a new name.
  4. On the General tab, set the Polling interval property to the time that you want the input device to wait between web service calls.

    Make sure that the polling interval meets the MarcomCentral terms of service. If the terms limit calls to the MarcomCentral system to a maximum of 1 every 5 minutes, set the value to 5 minutes or more.

  5. On the Request tab:
    1. Set the Use proxy property to the proxy server (if any) that you use to communicate with the web service.
    2. Set the Time zone offset property to the offset in hours between Coordinated Universal Time (UTC) and the time zone that the MarcomCentral web service uses.

      For example, if the MarcomCentral web service uses Pacific Standard Time to compute dates and times, set the property to -8.

        Note:

      • Make sure that you change this property when a MarcomCentral location that hosts the web service changes between standard and daylight savings time. Otherwise, you can lose the orders placed during the lost or gained hour.

      • To retrieve orders, the input device uses symbols for two properties:

        • WebService.CurrentRequestTime

          RICOH ProcessDirector sets the value of this property at the start of the polling interval.

        • WebService.LastSuccessRequestTime

          When the input device successfully communicates with the application, RICOH ProcessDirector sets the value of this property to match the value of the WebService.CurrentRequestTime property. A successful communication results in a response code 200, even if no data is received that creates a job.

    3. Set the SOAP request property to the GetOrdersByDate SOAP request that you imported.

      If you prepended MyStore to the names of the SOAP requests when you imported them, set the property to MyStore-GetOrdersByDate.

    4. Use the default values for all other properties on the Request tab.
  6. On the Authentication tab:
    1. Set the Static credential property to your MarcomCentral order token.
    2. Leave the values of all other properties blank.
  7. When you finish editing the properties, click OK.
After you define a workflow to process MarcomCentral orders, right-click the input device and select Properties. On the General tab, set the Child workflow property to the name of the workflow that you defined.

Related information:

MarcomCentral Connect
MarcomReceiveOrders
Running the sample workflows for processing orders retrieved from MarcomCentral
Importing WSDL files
Installing a security certificate for a web site
Setting up the system to use a proxy server
Parent topic: Setting up to process orders from MarcomCentral