field_block:node:guide:title

Route Service

field_block:node:guide:body

eCRV Web Services offers the Route service to modify the Workflow Step an eCRV is assigned to. The workflow code must be an active code for the local government agency. The Lookup Service is available to get a list of valid workflow codes. Only one eCRV can be updated per request.

A service is available for either a County or Muni (City). A user is only able to modify eCRVs for their local government agency.

field_block:node:guide:field_paragraph

URLs [+]

The URLs needed for this service are:

Production Region

WSDL: https://www.mndor.state.mn.us/ecrv_ws_c5/services/RouteService.wsdl
End Point: https://www.mndor.state.mn.us/ecrv_ws_c5/services/RouteService

Test Region

WSDL: https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/RouteService.wsdl
End Point: https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/RouteService

Input [+]

The user must specify the type of request:

CountyRoute
MuniRoute

The remainder of the request specifies the data to update:

Field	Required	Type
CrvId	Required	Int
WorkflowCodeId	Required	Int
Comments	Optional	String

Output [+]

The Route Service output returns the request response for the updated eCRV ID with errors that occurred (if any).

The responses are specified to match the initial request type:

CountyRouteResponse
MuniRouteResponse

The response includes:

Field	Return Values	Type	Parent
CrvId	Yes	Int
RequestErrors	Optional	Int
RequestError	Unbounded		RequestErrors
ErrorString	Optional	String	RequestErrors

Sample Requests and Responses [+]

Sample Requests

Update to the workflow step for Muni (City) with a comment:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:rout="http://schemas.ecrv.mdor.state.mn.us/routeService">
<soapenv:Header/>
<soapenv:Body>
<rout:MuniRouteRequest>
<rout:CrvId>123456</rout:CrvId>
<rout:WorkflowCodeId>128</rout:WorkflowCodeId>

<rout:Comments>This is a test of Muni Route service</rout:Comments>
</rout:MuniRouteRequest>
</soapenv:Body>
</soapenv:Envelope>

Sample Responses

Successful response for an updated workflow step:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header>
<wsse:Security SOAP-ENV:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<wsu:Timestamp wsu:Id="XWSSGID-15763414901991185817290" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<wsu:Created>2019-12-31T15:03:18.116Z</wsu:Created>
<wsu:Expires>2019-12-31T15:08:18.116Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</SOAP-ENV:Header> <SOAP-ENV:Body>
<RouteResponseType xmlns:ns2="http://schemas.ecrv.mdor.state.mn.us/routeService">
<ns2:CrvId>123456</ns2:CrvId>
<ns2:SuccessString>Route eCRV is successful.</ns2:SuccessString>
</RouteResponseType>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Error caused by an attempt to update to an invalid Workflow Step:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header>
<wsse:Security SOAP-ENV:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<wsu:Timestamp wsu:Id="XWSSGID-15763414901991185817290" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<wsu:Created>2019-12-31T15:03:18.116Z</wsu:Created>
<wsu:Expires>2019-12-31T15:08:18.116Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</SOAP-ENV:Header> <SOAP-ENV:Body>
<RouteResponseType xmlns:ns2="http://schemas.ecrv.mdor.state.mn.us/routeService">
<ns2:CrvId>123456</ns2:CrvId>
<ns2:RequestErrors>
<ns2:RequestError>
<ns2:ErrorString>WorkflowCode id: 120 is not active for Agency MP</ns2:ErrorString>
</ns2:RequestError>
</ns2:RequestErrors>
</RouteResponseType>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Guide Menu

Route Service