Receive Application

This outbound web service is invoked by Universal Access on remote systems. It is used to communicate an application for benefits for one or more social programs. WSDL describing this service can be found in <CURAM_DIR>\EJBServer\components\WorkspaceServices\axis\ProcessApplicationService\ProcessApplicationService.wsdl.

A web service request of this type contains the following information:

intakeApplicationType - An ID that uniquely identifies an Intake Application Type.
applicationReference – A unique reference for a particular application. This is a human-readable id that is displayed to clients after they complete an application. For example, "512" or "756". The application reference is used as an argument to other web services and should be stored by the receiver.
applicationLocale – Denotes the preferred locale of the user who entered the application. For example "en_US". This information should be stored by the receiver. Remote systems can send a variety of information back to the client's account. Some of this information must be localized by the sender to the preferred locale of the client.
submittedDateTime – The date and time at which the application was submitted. This is in XML Schema dateTime format. For example, 2012-05-29T15:34:49.000+01:00.
programsAppliedFor – This contains a list of the programs that were applied for as part of this application. Each program is referred to by a unique reference. This corresponds to the value of the Reference field configured in the Programs section of Universal Access configuration. For example:
```
<ns1:programsAppliedFor>
    <ns1:programTypeReference>CashAssistance</ns1:programTypeReference>
    <ns1:programTypeReference>SNAP</ns1:programTypeReference>
</ns1:programsAppliedFor>
```
applicationData – Contains a base64 encoded representation of the intake data. This intake data is the XML representation of the XML datastore associated with an application.
applicationSchemaName – The name of the schema used to create the data store for the application.
senderIdentification – Identifies the sender of the request. The sender identification contains two parts, 1) the identifier of the system from which the request originates, 2) The Citizen Workspace Account ID of the user that created the request. The second part is optional, applications submitted anonymously do not contain part two but applications submitted by a logged in user do.
supplementaryInformation – optional, reserved for future use.

The receiver of this information is expected to record the details of the application keyed against sender identification and intake application reference.

On success, the implementation of this web service must return the Boolean value "true" to indicate that the request has been successfully processed. In the case that there is a problem processing the request, a fault must be returned containing a string to indicate the nature of the problem. The String should be localized to the locale of the Universal Access Server since it will appear in the server log files.

Note: The receiver can receive multiple applications with the same Intake Application reference but the intake application reference is always unique for a particular sender. For example Systems A and B send a receiveApplication() request to system X. Both requests have the applicationReference 256. Note, however, that the receiver should never receive two applications from A with an application reference of 256.