State Codes and Country Strings

When submitting address information through the SOLO Server web services, it is necessary to validate certain information to ensure it is a valid value to input into SOLO Server. If invalid values are submitted, SOLO Server will accept them, but they may cause issues later on within the administration interface, since the values in the database will not match the values in SOLO Server's drop down lists. If your web service application is a web site, you can use the functions in the SOLO Server Client Validation Script to validate the values on the client side. You should also incorporate similar validation on the server side. You can also convert the javascript from this file into the language of your application if it is a non web application.

State Codes:

If an address is a US address, the state/province passed into the web service should be a valid US state code. Click here for a list of valid state codes.

SOLO Server Country Strings:

The country drop downs in SOLO Server use specific strings to insert country information into the database and display it in the drop downs. When entering a country passed into the web service should match these strings, or when viewing the address in edit mode in SOLO Server the system will not find a matching country to preselect in the drop down. If you don't catch this, it is easily possible to delete the address country. To see the latest set of SOLO Server country strings, simply navigate to a page in SOLO Server with a country drop down (the customer edit page works) and view the source of the page, looking for the html code for the country drop down. In each of the <option> tags, the "value" parameter is the country string for the country. The country string in SOLO Server conform to the ISO-3166 standard, and the codes are available on the Online Browsing Platform. Note that full country name is used in SOLO Server, and not the two character country code.