Upload Service

lexi.hafften Tue, 11/26/2019 - 07:11

field_block:node:guide:title

Upload Service

field_block:node:guide:body

eCRV Web Services offers the Upload service to add parcel data to an eCRV. This service updates data elements located on the County/Parcels sub-tab in the user interface. To add Parcel IDs to an eCRV, use Upload County Parcel Service.

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/UploadService.wsdl
End Point: https://www.mndor.state.mn.us/ecrv_ws_c5/services/UploadService

Test Region

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

Input [+]

The user must specify the type of request:

CountyUploadRequest
MuniUploadRequest

The remainder of the request specifies the data to update:

Field	Required	Type
CrvId	Required	Int
ParcelId	Required	String
MunicipalityId	Optional	String
SchoolDistrictId	Optional	String
CropEquivalencyRating	Optional	Decimal
CropProductivityIndex	Optional	Decimal

Output [+]

The Upload 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:

CountyUploadResponse
MuniUploadResponse

The response includes:

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

Sample Requests and Responses [+]

Sample Request

Update all available values:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:upl="http://schemas.ecrv.mdor.state.mn.us/uploadService">
<soapenv:Header/>
<soapenv:Body>
<upl:CountyUploadRequest>
<upl:CrvId>123456</upl:CrvId>
<upl:ParcelId>123456789012</upl:ParcelId>

<upl:MunicipalityId>1300</upl:MunicipalityId>

<upl:SchoolDistrictId>0623</upl:SchoolDistrictId>

<upl:CropEquivalencyRating>00.15</upl:CropEquivalencyRating>

<upl:CropProductivityIndex>1</upl:CropProductivityIndex>
</upl:CountyUploadRequest>
</soapenv:Body>
</soapenv:Envelope>

Sample Response

Successful response for a county update:

<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:08:31.017Z</wsu:Created>
<wsu:Expires>2019-12-31T15:13:31.017Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns2:CountyUploadResponse xmlns:ns2="http://schemas.ecrv.mdor.state.mn.us/uploadService">
<ns2:CrvId>123456</ns2:CrvId>
<ns2:ParcelCount>1</ns2:ParcelCount>
<ns2:RequestErrors>
<ns2:RequestError>
<ns2:ErrorString>Update finished sucessfully</ns2:ErrorString>
</ns2:RequestError>
</ns2:RequestErrors>
</ns2:CountyUploadResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Failure response due to an invalid data type:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring xml:lang="en">Validation error</faultstring>
<detail>
<spring-ws:ValidationError xmlns:spring-ws="http://springframework.org/spring-ws">cvc-datatype-valid.1.2.1: 'aqbc' is not a valid value for 'decimal'.</spring-ws:ValidationError>
<spring-ws:ValidationError xmlns:spring-ws="http://springframework.org/spring-ws">cvc-type.3.1.3: The value 'aqbc' of element 'upl:CropProductivityIndex' is not valid.</spring-ws:ValidationError>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Failure response due to an invalid Parcel ID:

<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:08:31.017Z</wsu:Created>
<wsu:Expires>2019-12-31T15:13:31.017Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns2:UploadResponse xmlns:ns2="http://schemas.ecrv.mdor.state.mn.us/uploadService">
<ns2:CrvId>123456</ns2:CrvId>
<ns2:ParcelCount>0</ns2:ParcelCount>
<ns2:RequestErrors>
<ns2:RequestError>
<ns2:ErrorString>Cannot find Parcel: 123456789012</ns2:ErrorString>
</ns2:RequestError>
</ns2:RequestErrors>
</ns2:UploadResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Upload Service

Guide Menu

Upload Service