Sterling B2B Integrator - EBICS Order Authorization Service

The EBICS Order Authorization service handles incoming order requests for the bank-technical upload order type.

The following table provides an overview of the EBICS Order Authorization Service:

System name

EBICS Order Authorization Service

Graphical Process Modeler (GPM) categories

All Services

Description

This service handles incoming order requests for the bank-technical upload order type. If an order has obtained the number of signatures required, this service forwards the order to the subscriber upload mailbox. Otherwise, this service retains the order data in the database until all the required number of signatures is obtained.

Business usage

This is a system service and is used internally by EBICS. This service provides EBICS protocol handler support in Sterling B2B Integrator.

Usage examples

Use this service together with the EBICS Server service to receive EBICS bank technical order data with order type FUL from a subscriber. The order data is processed, verified, and forwarded to the subscriber’s upload mailbox.

Preconfigured?

This service is preconfigured as part of the system installation.

Requires third-party files?

No

Platform availability

All supported Sterling B2B Integrator platforms.

Related services

  • HTTP Server adapter for EBICS
  • EBICS Server service
  • EBICS Compression service
  • EBICS Encoding service
  • EBICS Encryption service
  • EBICS Signing service
  • EBICS Order Streaming service

Application requirements

None

Initiates business processes?

This service invokes the EbicsOrderProcessing business process.

Invocation

This service is invoked inside the business process that is bootstrapped by the EBICS Server service.

Business process context considerations

This service is provided out of the box inside the EBICSOrderAuthorizationProcessing business process. No configuration is required, and the parameters are taken from the process data during run time.

Returned status values

Fatal – Nonrecoverable error

Transient – Recoverable error

Logic – Recoverable error

Success

Warning

Restrictions

None

Persistence level

System Default

Debug

To test this adapter, post a valid EBICS request message, using the HTTP Client, to the preconfigured EBICS HTTP Server adapter.

Debugging information for this service is located in Sterling B2B Integrator. Navigate to Operations System Logs EBICS.

 

Configuring the EBICS Order Authorization Service

To configure the EBICS Order Authorization service, you must specify the settings for the following fields in the Graphical Process Modeler (GPM):

Field

Description

Transaction ID

Required. The transaction ID relevant to an order. Default value is null.

HostId

Required. The host ID defined in EBICS Banking Server and used in the transaction.

 

Business Process Examples

A business process, which is a flow of tasks, can either be edited in the GPM or in the BPML (Business Process Modeling Language) code. The following business process example in BPML format illustrates using the EBICS Order Authorization service to handle a request message:
				
					<operation>
  <participant name="EBICSOrderAuthorizationService"/>
  <output message="handleRequest">
    <assign to="." from="*"/>
  </output>
  <input message="testing">
    <assign to="." from="*"/>
  </input>
</operation>
				
			
The following business process example in BPML format illustrates using the EBICS Order Authorization service to handle a response message:
				
					<operation>
  <participant name="EBICSOrderAuthorizationService"/>
  <output message="handleResponse">
    <assign to="." from="*"/>
  </output>
  <input message="testing">
    <assign to="." from="*"/>
  </input>
</operation>
				
			
The following business process example in BPML format illustrates how the EBICS Order Authorization service can be used:
				
					<process name="Order Authorization">
  <sequence name="main">
    <operation name="set user token">
      <participant name="SetUserToken"/>
      <output message="SetUserTokenMessage">
        <assign to="USER_TOKEN">admin</assign>
        <assign to="." from="*"/>
      </output>
      <input message="inmsg">
        <assign to="." from="*"/>
      </input>
    </operation>
    <!-- handle incoming EBICS Order -->
    <operation>
      <participant name="EBICSOrderAuthorizationService"/>
      <output message="handleRequest">
        <assign to="." from="*"/>
      </output>
      <input message="Xin">
        <assign to="." from="*"/>
      </input>
    </operation>
    <!—internal processing by invoking a subprocess-->
    <!—The subprocess name will be dynamically 
        determined based on Order Type 
        in the ProcessData -->
    <!—The invoke mode will be dynamically 
        determined based on order Type 
        in the ProcessData -->
    <operation name="Invoke Sub Process Service"> 
      <participant name="InvokeSubProcessService"/>
      <output message="Xout">
        <assign to="INVOKE_MODE” from=”/ProcessData/OrderAuthInfo/InvokeBPMode/text()”/>
        <assign to="WFD_NAME”” from=”/ProcessData/OrderAuthInfo/InvokeBPName/text()”/>
        <assign to="." from="*"/>
      </output>
      <input message="Xin">
        <assign to="." from="*"/>
      </input>
    </operation>
    <!-- handle EBICS response -->
    <operation>
      <participant name="EBICSOrderAuthorizationService"/>
      <output message="handleResponse">
        <assign to="." from="*"/>
      </output>
      <input message="Xin">
        <assign to="." from="*"/>
      </input>
    </operation>
  </sequence>
</process>
				
			

Parent Topic

Sterling B2B Integrator - EBICS Banking Server Services

Next Topic

Sterling B2B Integrator - EBICS ES Packaging Service