eCRV Web Services API

lexi.hafften Mon, 11/25/2019 - 06:42

field_block:node:guide:title

eCRV Web Services API

field_block:node:guide:body

The Minnesota Department of Revenue offers Simple Object Access Protocol (SOAP) based web services for local government agencies processing electronic Certificates of Real Estate Value (eCRVs). Below is information development staff need to use the eCRV Web Services interface, including:

Purpose of each Web Service
Design considerations important for using the interface
Web Services Description Language (WDSL) to define the service
Extensible Markup Language (XML) schemas to define the content

To use this guide, you should be familiar with SOAP-based interfaces, WSDL definitions, and XML schemas.

For information about getting started with Web Services, contact eCRV Support.

field_block:node:guide:field_paragraph

Security and Authentication [+]

Authentication

User authentication credentials (user ID and password) are transmitted as part of the SOAP header in the web service request.

Authentication occurs at the beginning of each web service call, so a persistent user session is not created.

The eCRV Web Services application uses Username Token Profile V1.0 (pdf) specification, part of the OASIS Web Services Security (WS-Security) specification.

Getting a Username

The username your system uses is assigned when you begin using the eCRV Web Services interface. To get a username, contact eCRV Support.

Sample Header with Username and Password

The code below shows the correct format for the Web Services header. Specific elements are explained in the table below the code. All of the elements are required.

Element	Description
<wsse:Username>	Username <wsse:Username>########</wsse:Username>
<wsse:Password>	Password for the specified <Username> sent as plain text <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">########</wsse:Password>
<wsse:Nonce>	Randomly generated cryptographic token to prevent theft and replay attacks <wsse:Nonce EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary">P1W25ZNQ4RLlS2FkqX22NQ==</wsse:Nonce>
<wsu:Timestamp>	Identifies when message was created and is validated against xsd:dateTime type defined in the XML schema Must be formatted in UTC format <wsu:Timestamp wsu:Id="TS-BBB4D9312FCBD984BE15753056690802"> <wsu:Created>2019-12-02T16:54:29.080Z</wsu:Created> <wsu:Expires>2019-12-02T16:59:29.080Z</wsu:Expires> </wsu:Timestamp>

Available eCRV Web Services [+]

The eCRV Web Services offered are listed below. More details for each Web Service (including the purpose, sample code, and URLs to access both the test and production region) are found in the relevant page in this guide.

Web Service Name	Description	Action Type
Download	Download up to 100 eCRVs through a request by either eCRV ID or Parcel ID.	Read
Search	Return a list of eCRV IDs matching search parameters provided in the request.	Read
Lookup	Look up data values related to eCRV, such as Property Type codes or active workflow codes at your organization.	Read
Upload Parcel	Add one or more Parcel IDs to an existing eCRV.	Update (Insert)
Upload	Add parcel-specific data to a Parcel ID that already exists on an eCRV. Cannot be used to add a Parcel to an eCRV.	Update (Modify)
Upload County Data	Add or modify data elements of the County Data for an eCRV, including: Water influence, sales adjustments, and study indicators.	Update (Modify)
Update Property Attribute	Currently being phased out. It will be replaced by Upload County Data.	Update (Modify)
Route	Change the Workflow Step an eCRV is assigned to.	Update (Modify)
Delete Parcel	Delete one or more Parcel IDs from an existing eCRV.	Update (Delete)

Technical Agreement [+]

Revenue offers eCRV Web Services as an additional tool for processing eCRVs.

Technical Updates and Communication

Revenue has agreed to the following:

The eCRV Web Services are available on business days between 7:00 a.m. and 4:30 p.m.
- Exceptions include monthly system patching or downtime as part of application updates.
Updates to eCRV Web Services and planned downtime are announced using GovDelivery.
Changes to eCRV Web Services are available in the Test Region for 30 days before a production release.
- Exceptions are made for urgent issues, and details will be communicated through GovDelivery.

Technical Support

The information provided is supplemental to the contents of the WSDL and XML schemas.

Any local government agency choosing to use the Web Services offered should have the tools and staff available to support their process. Revenue does not provide training or implementation services related to the eCRV Web Services.

If you suspect a problem or have a question about a Web Service you are using, contact eCRV Support.

Download Service

lexi.hafften Mon, 11/25/2019 - 06:52

field_block:node:guide:title

Download Service

field_block:node:guide:body

eCRV Web Services offers the Download service to return a list of up to 100 eCRVs per request. The entire eCRV version is returned in the request response.

A user is only able to download 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/DownloadService.wsdl
End Point: https://www.mndor.state.mn.us/ecrv_ws_c5/services/DownloadService

Test Region

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

Input [+]

The request has two input options, allowing the user to download data by eCRV ID or Parcel ID.

For each input option, the user must declare which version to download:

O = Original version
C = County version
M = Muni (City) version
S = State version

The remainder of the request specifies the data to download:

DownloadRequest

Field	Required	Type	Notes
CrvId	Required	Int
Type	Required	String	Values: O, C, M, or S

DownloadParRequest

Field	Required	Type	Notes
ParcelId	Required	String
Type	Required	String	Values: O, C, M, or S

Output [+]

Sample Requests and Responses [+]

Sample Requests

Download request for the County version of an eCRV:

Sample Response

Successful download response (partial results):

Search Service

lexi.hafften Mon, 11/25/2019 - 14:51

field_block:node:guide:title

Search Service

field_block:node:guide:body

The eCRV Web Services application offers the Search service to return data related to your local government organization. The request returns a list of eCRV IDs that match the search criteria provided in the request.

A unique Search Service is available for all four versions (types of data) available in eCRV:

Original
County
Muni (Municipal, or City)
State

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

Test Region

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

Input [+]

The inputs required for each request type vary based on the information available for each version.

County and Muni (City)

In addition to other search criteria below, the request type must be specified as:

CountySearchRequest type CountySearchRequest
MuniSearchRequest type MuniSearchRequest

Field	Type	Notes
CurrentWorkflowStepID	Int
CurrentWorkflowStepString	String
TagId	Int
TagString	String
PropertyTypeGroup	String	See schema ecrvBaseTypes
PropertyType	String	See schema ecrvBaseTypes
StudyYear	gYear
ParcelId	String
AuditorId	String

Original

In addition to other search criteria below, the request type must be specified as:

OriginalSearchRequest type OriginalSearchRequest

Field	Required	Type	Notes
ParcelId		String
CountyCode	Yes	String	Enum (two-digit County code)
PropertyUseCodeCodeLevel1		String	See schema ecrvBaseTypes
PropertyUseCodeCodeLevel2		String	See schema ecrvBaseTypes
PropertyUseCodeCodeLevel3		String	See schema ecrvBaseTypes
AcceptedDate		Date	gYearMonth
SaleDate		Date	gYearMonth

State

In addition to other search criteria below, the request type must be specified as:

StateSearchRequest type StateSearchRequest

Field	Required	Type	Notes
PropertyTypeGroup		String	See schema ecrvBaseTypes
PropertyType		String	See schema ecrvBaseTypes
StudyYear		gYear
ParcelId		String
CountyCode	Required	String	Enum (two-digit County code)

Output [+]

The output from the Search Service returns the list of eCRV IDs with matching data on the version requested. The responses are specified as:

CountySearchResponse type CountySearchResponse
MuniSearchResponse type MuniSearchResponse
StateSearchResponse type StateSearchResponse
OriginalSearchResponse type OriginalSearchResponse

For all request types, the response includes:

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

Sample Requests and Responses [+]

Sample Requests

County version search based on Workflow Step and Property Type Group:

Original version search based on Property Use:

Sample Responses

Partial successful response returning results:

Failed response caused by an incorrect search parameter:

Lookup Service

lexi.hafften Tue, 11/26/2019 - 06:46

field_block:node:guide:title

Lookup Service

field_block:node:guide:body

eCRV Web Services offers the Lookup service to return a list of valid values and descriptions for a local government agency.

A user is only able to lookup values for their local government agency.

field_block:node:guide:field_paragraph

URLs [+]

The URLs needed for this service are:

Production URLs

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

Test Region URLs

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

Input [+]

In the request, the Lookup type is a string with the possible ENUM values below.

ENUM	Description
PROPERTY_TYPE_GROUP	Returns a list of valid Property Type Group codes.
PROPERTY_TYPE	Returns a list of valid Property Type codes.
PROPERTY_USE	Returns a list of valid Property Use codes.
ACTIVE_WORKFLOW_STEPS	Returns a list of valid Active Workflow Steps for the user's local government organization.
ACTIVE_TAGS	Returns a list of valid Active Tags for the user's local government organization.
CITY_CODES	Returns a list of valid City codes for the user's local government organization.

Output [+]

The Lookup Service output returns a list of values for the code requested.

LookupResponse type LookupResponse

The response includes:

Field	Return Values	Type	Notes
CodeValue	Unbounded	String	codeDescription
ParentCode	Optional	String
Code	Optional	String
Description	Optional	String

Sample Requests and Responses [+]

Sample Requests

Lookup of the Active Tags:

Sample Responses

Successful response for Active Tags:

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:

Sample Response

Successful response for a county update:

Failure response due to an invalid data type:

Failure response due to an invalid Parcel ID:

Update Property Attribute Service

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

field_block:node:guide:title

Update Property Attribute Service

field_block:node:guide:body

eCRV Web Services will be phasing out the Update Property Attribute service in the future. The service is currently available for counties and cities using it. We recommend using the Upload County Data Service.

The Update Property Attribute service allows a user to add or update property data to an existing eCRV. Only one eCRV can be updated per request. This service updates data elements located on the County/County Data sub-tab in the user interface.

The service is available for either a County or Muni (City). A user can only modify an eCRV for their local government organization.

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

Test Region:

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

Input [+]

The user must specify the type of request:

CountyUpdateProprtyAttributeRequest
MuniUpdateProprtyAttributeRequest

The remainder of the request specifies the data to update:

Field	Required	Type
CrvId	Required	Int
YrBuiltYr	Optional	Int
NewConstructionPct	Optional	Int
GrossBuildingArea	Optional	Int
WaterCde	Optional	String
DeededAcres	Optional	Decimal
ExemptWetlandIndicator	Optional	Boolean
ExemptPrairieIndicator	Optional	Boolean
WaterName	Optional	String
WaterId	Optional	String
ShorelineFeet	Optional	Int

Output [+]

The service output returns the number of parcel IDs updated for the eCRV ID with errors that occurred (if any).

The responses are specified, to match the initial request type:

UpdatePropertyAttributeResponseType type CountyUpdatePropertyAttributeResponse
UpdatePropertyAttributeResponseType type MuniUpdatePropertyAttributeResponse

The response includes:

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

Sample Requests and Responses [+]

Upload County Data Service

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

field_block:node:guide:title

Upload County Data Service

field_block:node:guide:body

eCRV Web Services offers the Upload County Data service to add data to an existing eCRV. The request is divided into four parts that can be updated together or separately:

Deed type
Sales adjustment
Property attributes
County and/or State study indicators.

We recommend including all desired data (even if it already exists in the database) in the new request since existing values will be overwritten. Only one eCRV can be updated per request. Refer to the Schemas for more information.

A service is available for a County or Muni (City). A user can only modify an eCRV for their local government organization.

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

Test Region

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

Input [+]

In this service, the same request type is used for County and Muni (City):

CountyUploadCountyDataRequest

The remainder of the request specifies the data to update:

Field	Required	Type	Parent	Notes
CrvId	Required	Int
DeedType	Optional	String
SalesAdjustment	Unbounded			Multiple adjustments can be added to a single eCRV.
AdjustmentType_code	Required	Enum	SalesAdjustment	adjustmentType
AdjustmentAmount	Optional	Decimal	SalesAdjustment
Notes	Optional	String	SalesAdjustment
PropertyAttribute	Optional
YrBuiltYr	Optional	String	PropertyAttribute
NewConstructionPct	Optional	String	PropertyAttribute
GrossBuildingArea	Optional	Int	PropertyAttribute
WaterCde	Optional	String	PropertyAttribute
DeededAcres	Optional	Decimal	PropertyAttribute
NeighborhoodCde	Optional	String	PropertyAttribute
ExemptWetlandIndicator	Optional	Boolean	PropertyAttribute
ExemptPrairieIndicator	Optional	Boolean	PropertyAttribute
WaterName	Optional	String	PropertyAttribute
WaterId	Optional	String	PropertyAttribute
ShorelineFeet	Optional	Int	PropertyAttribute
StudyIndicator	Optional
StateStudyRecommendedIndicator	Optional	Boolean	StudyIndicator
CountyStudyRecommendedIndicator	Optional	Boolean	StudyIndicator
StateStudyRecommendedComment	Optional	String	StudyIndicator
StudyRejectionReason	Unbounded			Multiple Rejection Reasons can be added to a single eCRV.
StudyLevel_code	Required	String	StudyRejectionReason
RejectionReason_code	Required	Enum	StudyRejectionReason	rejectionReason
Comments	Optional	String	StudyRejectionReason

Output [+]

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

CountyUploadCountyDataResponse

The response includes:

Field	Return Values	Type	Parent	Notes (If Any)
CrvId	Yes	Int
ResponseCode	Yes	Int		Success = 0, Fail = 1
RequestErrors	Optional
RequestError	Unbounded		RequestErrors
ErrorString	Optional	String	RequestErrors

Sample Requests and Responses [+]

Sample Request

Request to update Property Attributes and the State Study Rejection Reason:

Sample Response

Success response for a request:

Failure response for a request with an error caused by business rules:

Route Service

lexi.hafften Tue, 11/26/2019 - 08:32

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:

Sample Responses

Successful response for an updated workflow step:

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

Upload Parcel County Service

lexi.hafften Tue, 11/26/2019 - 10:53

field_block:node:guide:title

Upload Parcel County Service

field_block:node:guide:body

eCRV Web Services offers the Upload County Parcel service to add Parcel IDs to an eCRV. Only one eCRV can be updated per request and must include values for the parcel's Jurisdiction and School District. Refer to the Schemas for more information.

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

WDSL: https://www.mndor.state.mn.us/ecrv_ws_c5/services/UploadParcelCountyService.wsdl
End Point: https://www.mndor.state.mn.us/ecrv_ws_c5/services/UploadParcelCountyService

Test Region

WDSL: https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/UploadParcelCountyService.wsdl
End Point: https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/UploadParcelCountyService

Input [+]

The user must specify the type of request:

CountyUploadParcelCounty
MuniUploadParcelCounty

The remainder of the request specifies the data to update:

Field	Required	Type	Parent
CrvId	Required	Int
UploadParcelCounty	Required	Unbounded
Parcel_id	Required	String	UploadParcelCounty
ParcelSequence_id	Optional	String	UploadParcelCounty
Municipality_id	Required	String	UploadParcelCounty
SchoolDistrict_id	Required	String	UploadParcelCounty
CropEquivalency_rating	Optional	Decimal	UploadParcelCounty
CropProductivity_index	Optional	Decimal	UploadParcelCounty
Primary_ind	Optional	Boolean	UploadParcelCounty

Output [+]

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

CountyUploadParcelCountyResponse
MuniUploadParcelCountyResponse

The response includes:

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

Sample Requests and Responses [+]

Sample Request

Add two parcels to an eCRV:

Sample Response

Successful response for an upload request:

Failure response returning an error because the eCRV is already transferred to the State:

Delete County Parcel Service

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

field_block:node:guide:title

Delete County Parcel Service

field_block:node:guide:body

eCRV Web Services offers the Delete County Parcel service to delete Parcel IDs from an eCRV. 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/DeleteParcelCountyService.wsdl
End Point: https://www.mndor.state.mn.us/ecrv_ws_c5/services/DeleteParcelCountyService

Test Region

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

Input [+]

The user must specify the type of request:

CountyDeleteParcelCounty
MuniDeleteParcelCounty

The remainder of the request specifies the parcels to be deleted:

Field	Required	Type	Notes (If Any)
CrvId	Required	Int
Parcel_id	Required	String	Unbounded

Output [+]

The Delete Parcel County Service output returns the request response for the modified eCRV ID with errors that occurred (if any).

The responses are specified to match the initial request type:

CountyDeleteParcelCountyResponse
MuniDeleteParcelCountyResponse

The response includes:

Field	Return Values	Type	Parent	Notes
CrvId	Yes	Int
ResponseCode	Yes	Int		Success = 0, Fail = 1
RequestErrors	Optional
RequestError	Unbounded		RequestErrors
ErrorString	Optional	String	RequestErrors

Sample Requests and Responses [+]

Sample Request

Delete a single parcel from an eCRV:

Sample Response

Successful response for a delete request:

Failure response when the Parcel ID isn't found on the eCRV:

Upload Property Types Service

annie.brooks Fri, 07/15/2022 - 13:57

field_block:node:guide:field_last_updated

Last Updated

July 22, 2022

field_block:node:guide:title

Upload Property Types Service

field_block:node:guide:body

eCRV Web Services offers the Upload service to add property type data to an existing eCRV. This service updates data elements located on the Property Types sub-tab in the user interface. To add Parcel IDs to an eCRV, use Upload County Parcel Service.

A service is available for a County or Muni (City). A user can only modify an eCRV for their local government organization.

field_block:node:guide:field_paragraph

URLs [+]

The URLs needed for this service are:

Production Region

WDSL: https://www.mndor.state.mn.us/ecrv_ws_c5/services/UploadPropertyTypeCountyService.wsdl
End Point: https://www.mndor.state.mn.us/ecrv_ws_c5/services/UploadPropertyTypeCountyService

Test Region

WDSL: https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/UploadPropertyTypeCountyService.wsdl
End Point: https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/UploadPropertyTypeCountyService

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
UploadPropertyTypeCounty	Required	Unbounded
PropertyTypeGroup_cd	Required	String
PropertyType_cd	Optional	String
PrimaryType_ind	Optional	Boolean
YearLandAssessed	Optional	String
PreviousLandValueAmount	Optional	Integer
PreviousBuildingValueAmount	Optional	Integer
LandValueAmount	Optional	Integer
PreviousBuildingValueAmount	Optional	Integer
NumberOfParcels	Optional	Int
Notes	Optional	String
UploadedAgriClassification	Optional
TilledAcres2aNbr	Optional	Decimal
TilledEMV2aAmt	Optional	Integer
PastureAcres2aNbr	Optional	Decimal
PastureEMV2aAmt	Optional	Integer
MeadowAcres2aNb	Optional	Decimal
MeadowAcres2a Amt	Optional	Integer
WasteAcres2aNbr	Optional	Decimal
WasteEMV2aAmt	Optional	Integer
WoodsAcres2aNbr	Optional	Decimal
WoodsEMV2aAmt	Optional	Integer
ExpWetlandAcres2aNbr	Optional	Decimal
ExpWetlandEMV2aAmt	Optional	Integer
ExpNativeAcres2aNbr	Optional	Decimal
ExpNativeEMV2aAmt	Optional	Integer
DitchRoadAcres2aNbr	Optional	Decimal
DitchRoadEMV2aAmt	Optional	Integer
OtherAcres2aNbr	Optional	Decimal
OtherEMV2aAmt	Optional	Integer
FirstAcres2aNbr	Optional	Decimal
FirstEMV2aAmt	Optional	Integer
NonHGASiteAcres2aNbr	Optional	Decimal
NonHGASiteEMV2aAmt	Optional	Integer
UploadedRuralClassification	Optional
TilledAcres2bNbr	Optional	Decimal
TilledEMV2bAmt	Optional	Integer
PastureAcres2bNbr	Optional	Decimal
PastureEMV2bAmt	Optional	Integer
MeadowAcres2bNb	Optional	Decimal
MeadowAcres2b Amt	Optional	Integer
WasteAcres2bNbr	Optional	Decimal
WasteEMV2bAmt	Optional	Integer
WoodsAcres2bNbr	Optional	Decimal
WoodsEMV2bAmt	Optional	Integer
ExpWetlandAcres2bNbr	Optional	Decimal
ExpWetlandEMV2aAmt	Optional	Integer
ExpNativeAcres2aNbr	Optional	Decimal
ExpNativeEMV2aAmt	Optional	Integer
DitchRoadAcres2aNbr	Optional	Decimal
DitchRoadEMV2aAmt	Optional	Integer

Output [+]

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

CountyUploadParcelCountyResponse
MuniUploadParcelCountyResponse

The response includes:

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

Sample Requests and Responses [+]

Sample Request

Sample Response

Successful response for an upload request:

Failure response returning an error because eCRV is not found:

Failure response returning an error because the eCRV has bad data types:

All Services URL and Schema List

lexi.hafften Mon, 11/25/2019 - 07:30

field_block:node:guide:title

All Services URL and Schema List

field_block:node:guide:body

Below are links to all URLs, end points, and schemas used in the eCRV Web Services.

Revenue releases changes to the eCRV Web Services interface in the Test Region before publishing to Production.

You should review the information available on the eCRV Home Page frequently so you are familiar with changes to Web Services in the Test Region. If you maintain a system using eCRV Web Services, you should sign up for GovDelivery updates related to eCRV.

field_block:node:guide:field_paragraph

Production Region URLs [+]

The URLs needed for eCRV Web Services in the Production region are:

WSDLs

Service Name	URL
DownloadService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/DownloadService.wsdl
SearchService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/SearchService.wsdl
LookupService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/LookupService.wsdl
UploadService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/UploadService.wsdl
UpdatePropertyAttributeService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/UpdatePropertyAttributeService.wsdl
RouteService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/RouteService.wsdl
UploadParcelCountyService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/UploadParcelCountyService.wsdl
DeleteParcelCountyService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/DeleteParcelCountyService.wsdl
UploadCountyDataService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/UploadCountyDataService.wsdl
UploadPropertyTypesService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/UploadPropertyTypeCountyService.wsdl

End Points

Service Name	URL
DownloadService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/DownloadService
SearchService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/SearchService
LookupService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/LookupService
UploadService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/UploadService
UpdatePropertyAttributeService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/UpdatePropertyAttributeService
RouteService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/RouteService
UploadParcelCountyService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/UploadParcelCountyService
DeleteParcelCountyService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/DeleteParcelCountyService
UploadCountyDataService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/UploadCountyDataService
UploadPropertyTypesService	https://www.mndor.state.mn.us/ecrv_ws_c5/services/UploadPropertyTypeCountyService

Schemas

Most of the web services offered use a specific XSD; however, some are shared or referenced within other services. It is important to be familiar with all of the available XSDs.

Schema Name	URL	Used for:
ecrvBaseTypes	https://www.mndor.state.mn.us/ecrv_ws_c5/schema/ecrvBaseTypes.xsd	Download, Search
ecrvTypes	https://www.mndor.state.mn.us/ecrv_ws_c5/schema/ecrvTypes.xsd	Download
downloadService	https://www.mndor.state.mn.us/ecrv_ws_c5/schema/downloadService.xsd	Download
searchService	https://www.mndor.state.mn.us/ecrv_ws_c5/schema/searchService.xsd	Search
lookupService	https://www.mndor.state.mn.us/ecrv_ws_c5/schema/lookupService.xsd	Lookup
uploadService	https://www.mndor.state.mn.us/ecrv_ws_c5/schema/uploadService.xsd	Update
updatePropertyAttributeService	https://www.mndor.state.mn.us/ecrv_ws_c5/schema/updatePropertyAttributeService.xsd	Update
uploadParcelCountyService	https://www.mndor.state.mn.us/ecrv_ws_c5/schema/uploadParcelCountyService.xsd	Update
deleteParcelCountyService	https://www.mndor.state.mn.us/ecrv_ws_c5/schema/deleteParcelCountyService.xsd	Update
uploadCountyDataService	https://www.mndor.state.mn.us/ecrv_ws_c5/schema/uploadCountyDataService.xsd	Update
routeService	https://www.mndor.state.mn.us/ecrv_ws_c5/schema/routeService.xsd	Route
MN County Code	https://www.mndor.state.mn.us/ecrv_ws_c5/schema/mnCounties.xsd	Other ID Lookup
MN CityTown Code	https://www.mndor.state.mn.us/ecrv_ws_c5/schema/cityTownShips.xsd	Other ID Lookup
School District ID	https://www.mndor.state.mn.us/ecrv_ws_c5/schema/schoolDistricts.xsd	Other ID Lookup

Test Region URLs [+]

The services and schemas listed here are for the Test Region and may contain changes that are not published to Production.

The URLs needed for eCRV Web Services in the Test Region are:

WSDLs

Service Name	URL
DownloadService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/DownloadService.wsdl
SearchService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/SearchService.wsdl
LookupService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/LookupService.wsdl
UploadService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/UploadService.wsdl
UpdatePropertyAttributeService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/UpdatePropertyAttributeService.wsdl
RouteService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/RouteService.wsdl
UploadParcelCountyService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/UploadParcelCountyService.wsdl
DeleteParcelCountyService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/DeleteParcelCountyService.wsdl
UploadCountyDataService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/UploadCountyDataService.wsdl
UploadPropertyTypesService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/UploadPropertyTypeCountyService.wsdl

End Points

Service Name	URL
DownloadService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/DownloadService
SearchService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/SearchService
LookupService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/LookupService
UploadService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/UploadService
UpdatePropertyAttributeService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/UpdatePropertyAttributeService
RouteService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/RouteService
UploadParcelCountyService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/UploadParcelCountyService
DeleteParcelCountyService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/DeleteParcelCountyService
UploadCountyDataService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/UploadCountyDataService
UploadPropertyTypesService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/UploadPropertyTypeCountyService

Schemas

Most of the web services offered use a specific XSD; however, some are shared or referenced within other services. It is important to be familiar with all of the available XSDs.

Schema Name	URL	Used for:
ecrvBaseTypes	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/schema/ecrvBaseTypes.xsd	Download, Search
ecrvTypes	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/schema/ecrvTypes.xsd	Download
downloadService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/schema/downloadService.xsd	Download
searchService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/schema/searchService.xsd	Search
lookupService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/schema/lookupService.xsd	Lookup
uploadService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/schema/uploadService.xsd	Update
updatePropertyAttributeService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/schema/updatePropertyAttributeService.xsd	Update
uploadPracelCountyService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/schema/uploadParcelCountyService.xsd	Update
deleteParcelCountyService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/schema/deleteParcelCountyService.xsd	Update
uploadCountyDataService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/schema/uploadCountyDataService.xsd	Update
routeService	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/schema/routeService.xsd	Route
MN County Code	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/schema/mnCounties.xsd	Other ID Lookup
MN CityTown Code	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/schema/cityTownShips.xsd	Other ID Lookup
School District ID	https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/schema/schoolDistricts.xsd	Other ID Lookup