= Development Server =

Requests are RESTful URL calls combined with XML sent as raw Standard Input (non-urlencoded POST Requests). To reach the Web Service, use this URL:
http://signals.thewhiteroom.com/cgi-bin/ws
The URL must be combined with a command such as '''login''', '''shipping''', '''tax''', or '''checkout'''. So a full request will look like one of these:
* http://signals.thewhiteroom.com/cgi-bin/ws/login
* http://signals.thewhiteroom.com/cgi-bin/ws/shipping
* http://signals.thewhiteroom.com/cgi-bin/ws/tax
* http://signals.thewhiteroom.com/cgi-bin/ws/checkout

= User Login =

Allow access to membership database so mobile app can authenticate existing accounts. Calls will be made directly to MySQL database to authenticate user login. Response will be name, address, phone, etc of customer table.

Here is an example of how to make this call:

* '''RESTful Request'''

<code>http://signals.thewhiteroom.com/cgi-bin/ws/login</code>

* '''XML Request'''
<code>
<MemberRequest>
<Email>johnsmith@example.com</Email>
<Password>12345</Password>
</MemberRequest>
</code>

* '''XML Response'''
<code>
<?xml version="1.0" encoding="utf-8" ?>
<MemberResponse>
<MemberID>5</MemberID>
<Addresses>
<Address type="billing">
<Email>johnsmith@example.com</Email>
<FirstName>John</FirstName>
<LastName>Smith</LastName>
<Street1>72 Cascade Dr</Street1>
<Street2>Ste 2</Street2>
<City>Rochester</City>
<State>NY</State>
<Zip>14614</Zip>
<DayPhone>585-232-5670</DayPhone>
<EveningPhone></EveningPhone>
</Address>
</Addresses>
</MemberResponse>
</code>

= Shipping Info =

Allow access to Hazel's shipping cost calculator (a custom Hazel template). Web service will allow for remotely calling Hazel with given products and address information with filtered response of shipping options and costs. This is specific to the customer. Currently, only the products themselves are used in the calculation (not the address).

* '''RESTful Request'''

<code>http://signals.thewhiteroom.com/cgi-bin/ws/shipping</code>

* '''XML Request'''
<code>
<ShippingRequest>
<Zip>80007</Zip>
<ProductIDs>
<ProductID qty="1">HK6614</ProductID>
<ProductID qty="3">HJ2722</ProductID>
</ProductIDs>
</ShippingRequest>
</code>

* '''XML Response'''
<code>
<?xml version="1.0" encoding="utf-8" ?>
<ShippingResponse>
<ShippingCost>
<Method type="Standard">11.99</Method>
<Method type="Rush (Continental US Only)">20.98</Method>
<Method type="2-Day (Continental US Only)">24.98</Method>
<Method type="Canada">24.94</Method>
</ShippingCost>
</ShippingResponse>
</code>

= Tax Calculator =

Only the '''state''' is used to calculate tax (on the store used on the devel site). We may need to expand this in a later revision. Other options can be sent, but only '''<State>''' is read from the Tax Request.

* '''RESTful Request'''

<code>http://signals.thewhiteroom.com/cgi-bin/ws/tax</code>

* '''XML Request'''
<code>
<TaxRequest>
<State>OH</State>
<Zip>45431</Zip>
<ProductIDs>
<ProductID qty="1">7326</ProductID>
<ProductID qty="1">15283</ProductID>
</ProductIDs>
<PromotionCode>CODE123</PromotionCode>
</TaxRequest>
</code>

* '''XML Response'''
<code>
<?xml version="1.0" encoding="utf-8" ?>
<TaxResponse>
<Tax>6.50</Tax>
</TaxResponse>
</code>

= Checkout =

The order will travel the "normal" process once submitted to Hazel in this way. All emails will be sent, and order information added to the database. The only difference will be the custom response (in XML) back mobile client.

* '''RESTful Request'''

<code>http://signals.thewhiteroom.com/cgi-bin/ws/checkout</code>

* '''XML Request'''
<code>
<OrderRequest>
<Addresses>
<Address type="billing">
<Email>brandon@scooby.netsville.com</Email>
<FirstName>James</FirstName>
<LastName>Camire</LastName>
<Street1>1111 Washington St</Street1>
<Street2>Suite 200</Street2>
<City>Golden</City>
<State>CO</State>
<Zip>80401</Zip>
<DayPhone>720-260-4768</DayPhone>
<EveningPhone></EveningPhone>
</Address>
<Address type="shipping">
<Email>brandon@scooby.netsville.com</Email>
<FirstName>Mary</FirstName>
<LastName>Camire</LastName>
<Street1>15602 West 79th Pl</Street1>
<Street2> </Street2>
<City>Arvada</City>
<State>CO</State>
<Zip>80007</Zip>
<DayPhone>303-123-4567</DayPhone>
<EveningPhone></EveningPhone>
</Address>
</Addresses>
<Shipping type="Standard">5.22</Shipping>
<PromotionCode>THX10</PromotionCode>
<OrderSubtotal>99.37</OrderSubtotal>
<OrderTax>99.37</OrderTax>
<OrderDiscount>10.00</OrderDiscount>
<MemberID>12345</MemberID>
<CustomerIP>74.100.182.104</CustomerIP>
<CreditCard>
<Name>James Camire</Name>
<Number>5105105105105100</Number>
<ExpMonth>09</ExpMonth>
<ExpYear>09</ExpYear>
<CSC>123</CSC>
</CreditCard>
<ProductIDs>
<ProductID qty="1">HK6614</ProductID>
<ProductID qty="2">HJ2722</ProductID>
<ProductID qty="4" opt="S-RED">HJ2722</ProductID>
</ProductIDs>
</OrderRequest>
</code>

* '''XML Response'''
<code>
<?xml version="1.0" encoding="utf-8" ?>
<OrderReponse>
<ShippingTotal>9.09</ShippingTotal>
<TaxTotal>11.82</TaxTotal>
<ProductTotal>145.00</ProductTotal>
<DiscountTotal>10.00</DiscountTotal>
<GrandTotal>155.91</GrandTotal>
<OrderNumber>1090386</OrderNumber>
<ClientID>12345</ClientID>
<MSG>Thank you for your order! You should be receiving an email shortly.</MSG>
</OrderReponse>
</code>

= Order Status =

General System Information

2012-02-03T17:35:39Z

Netsville Support: /* Postini IP Ranges */ Added NOTE

= Client Mail Server =
{| class="wikitable" border="1"
|securemail.netsville.com
|}

= Device Network Configuration Nameservers =
At least two of:
{| class="wikitable" border="1"
|69.55.64.18
|-
|69.55.64.231
|-
|69.55.77.11
|}

= Authoritative Nameservers =
When you register a domain name, add these into the DNS records:
{| class="wikitable" border="1"
|NS1.NETSVILLE.COM
|-
|NS2.NETSVILLE.COM
|}

= Postini IP Ranges =

This data for the range of Postini's server IPs is linked from [http://www.postini.com/webdocs/admin_ee_cu/wwhelp/wwhimpl/common/html/wwhelp.htm?context=EEHelp&file=secur_range.html Postini Webdocs on IP Range].

The following are the IP ranges for the email protection service systems.

'''Note:''' for system 20 customers, both sets of IP ranges are applicable.

{| class="wikitable" border="1"
!System||IP Range||CIDR Range||IP/Subnet Mask Pair
|-
|5, 6, 7, 8, 20||64.18.0.0 - 64.18.15.255||64.18.0.0/20||64.18.0.0 mask 255.255.240.0
|-
|20, 200, 201||207.126.144.0 - 207.126.159.255||207.126.144.0/20||207.126.144.0 mask 255.255.240.0
|}

'''NOTE: Netsville is currently on System 5 so if you need to allow Postini IPs in your router, just allow the first block (64.18.0.0/20)'''

General System Information

2012-02-03T17:31:41Z

Netsville Support: /* Authoritative Nameservers */

IPhone

2012-01-26T15:32:44Z

Netsville Support: Added a little detail

[[Category:Email]]
This page details how to configure your iPhone or iPad to to receive email from Netsville and send it to Apple.

# After you click the '''Settings''' icon, you'll be at this page. Choose: '''Mail, Contact, Calendars''':
#: [[File:200px-Iphone_settings_01.png]]
# Mail, Contact, Calendars
#: [[File:200px-Iphone_mailcontactcal_02.png]]
# Add Account (Other)
#: [[File:200px-Iphone_addaccount_03.png]]
# Other / Add Mail Account
#: [[File:200px-Iphone_addother_04.png]]
# Filling out the Account information. The import parts on this screen are the '''User Name''' and '''Hostname'''.
#: * You must use your '''full''' email address as the '''User Name'''
#: * The Host Name of the Incoming Server is '''securemail.netsville.com'''
#: * Fill in whatever your password is
#: [[File:200px-Iphone_newaccount_05p1.png]] [[File:200px-Iphone_newaccount_05p2.png]]
# SMTP - setting up SMTP Authentication for the Primary Server
#: * Create an Outgoing Mail Server called '''securemail.netsville.com'''
#: [[File:200px-Iphone_smtp_06p1.png‎]]
# Primary (SMTP) Server
#: * Make sure the Authentication type is '''Password'''
#: * Turn '''SSL ON'''
#: * The Outgoing Server Port is '''587'''
#: [[File:200px-Iphone_smtp_06p2.png]]
# Advanced (Incoming Settings)
#: * Turn '''SSL ON'''
#: * Authentication is '''Password'''
#: * Incoming Server Port should be '''993''' for IMAP. For POP3 it should be '''995'''
#: [[File:200px-Iphone_advanced_07.png]]

Contact Netsville

2012-01-25T20:24:03Z

Netsville Support: /* Mailing Address */ Just added ste 2

If you need help or have a question, try searching the wiki for it. If you still cannot find an answer to your question, please contact us.

= Departments =

{| style="border: 1px solid black; border-collapse: collapse; width: 65em; text-align: left;"
|- style="background-color: #CCCC65; color: #003300; border-bottom: 1px solid black;"
! Name !! Position !! Phone !! Fax !! E-Mail
|-
| '''General Support''' || Support || 585.232.5670 || 585.232.4512 || support@netsville.com
|- style="background-color: #DEDE9A;"
| '''Sales Inquiries''' || Sales Inquiries || 585.232.5670 || 585.232.4512 || sales@netsville.com
|-
| '''Netsville Main Info''' || General Information || 585.232.5670 || 585.232.4512 || support@netsville.com
|}

= Phone and Fax Numbers =

{| style="border: 1px solid black; border-collapse: collapse; width: 45em; text-align: left;"
|- style="background-color: #CCCC65; color: #003300; border-bottom: 1px solid black;"
! Name !! Number
|-
| '''Toll-Free Number''' || 1-888-NETSVILLE
|- style="background-color: #DEDE9A;"
| '''Main Line''' || (585) 232-5670
|-
| '''Office Fax''' || (585) 232-4512
|}

= Mailing Address =

'''Netsville, Inc.'''
72 Cascade Drive
Ste 2
Rochester, New York
14614 USA

= Websites =

{| style="border: 1px solid black; border-collapse: collapse; width: 45em; text-align: left;"
|- style="background-color: #CCCC65; color: #003300; border-bottom: 1px solid black;"
! Name !! URL
|-
| '''Netsville Main Page''' || http://www.netsville.com
|- style="background-color: #DEDE9A;"
| '''Netsville Support Wiki''' || http://support.netsville.com
|-
| '''Netsville Email''' || see [[Webmail]]
|}

USA Web Service

2012-01-20T19:38:44Z

Netsville Support:

= Development Server =

Requests are RESTful URL calls combined with XML sent as raw Standard Input (non-urlencoded POST Requests). To reach the Web Service, use this URL:
http://signals.thewhiteroom.com/cgi-bin/ws
The URL must be combined with a command such as '''login''', '''shipping''', '''tax''', or '''checkout'''. So a full request will look like one of these:
* http://signals.thewhiteroom.com/cgi-bin/ws/login
* http://signals.thewhiteroom.com/cgi-bin/ws/shipping
* http://signals.thewhiteroom.com/cgi-bin/ws/tax
* http://signals.thewhiteroom.com/cgi-bin/ws/checkout

= User Login =

Allow access to membership database so mobile app can authenticate existing accounts. Calls will be made directly to MySQL database to authenticate user login. Response will be name, address, phone, etc of customer table.

Here is an example of how to make this call:

* '''RESTful Request'''

<code>http://signals.thewhiteroom.com/cgi-bin/ws/login</code>

* '''XML Request'''
<code>
<MemberRequest>
<Email>johnsmith@example.com</Email>
<Password>12345</Password>
</MemberRequest>
</code>

* '''XML Response'''
<code>
<?xml version="1.0" encoding="utf-8" ?>
<MemberResponse>
<MemberID>5</MemberID>
<Addresses>
<Address type="billing">
<Email>johnsmith@example.com</Email>
<FirstName>John</FirstName>
<LastName>Smith</LastName>
<Street1>72 Cascade Dr</Street1>
<Street2>Ste 2</Street2>
<City>Rochester</City>
<State>NY</State>
<Zip>14614</Zip>
<DayPhone>585-232-5670</DayPhone>
<EveningPhone></EveningPhone>
</Address>
</Addresses>
</MemberResponse>
</code>

= Shipping Info =

Allow access to Hazel's shipping cost calculator (a custom Hazel template). Web service will allow for remotely calling Hazel with given products and address information with filtered response of shipping options and costs. This is specific to the customer. Currently, only the products themselves are used in the calculation (not the address).

* '''RESTful Request'''

<code>http://signals.thewhiteroom.com/cgi-bin/ws/shipping</code>

* '''XML Request'''
<code>
<ShippingRequest>
<Zip>80007</Zip>
<ProductIDs>
<ProductID qty="1">HK6614</ProductID>
<ProductID qty="3">HJ2722</ProductID>
</ProductIDs>
</ShippingRequest>
</code>

* '''XML Response'''
<code>
<?xml version="1.0" encoding="utf-8" ?>
<ShippingResponse>
<ShippingCost>
<Method type="Standard">11.99</Method>
<Method type="Rush (Continental US Only)">20.98</Method>
<Method type="2-Day (Continental US Only)">24.98</Method>
<Method type="Canada">24.94</Method>
</ShippingCost>
</ShippingResponse>
</code>

= Tax Calculator =

Only the '''state''' is used to calculate tax (on the store used on the devel site). We may need to expand this in a later revision. Other options can be sent, but only '''<State>''' is read from the Tax Request.

* '''RESTful Request'''

<code>http://signals.thewhiteroom.com/cgi-bin/ws/tax</code>

* '''XML Request'''
<code>
<TaxRequest>
<State>OH</State>
<Zip>45431</Zip>
<ProductIDs>
<ProductID qty="1">7326</ProductID>
<ProductID qty="1">15283</ProductID>
</ProductIDs>
<PromotionCode>CODE123</PromotionCode>
</TaxRequest>
</code>

* '''XML Response'''
<code>
<?xml version="1.0" encoding="utf-8" ?>
<TaxResponse>
<Tax>6.50</Tax>
</TaxResponse>
</code>

= Checkout =

The order will travel the "normal" process once submitted to Hazel in this way. All emails will be sent, and order information added to the database. The only difference will be the custom response (in XML) back mobile client.

* '''RESTful Request'''

<code>http://signals.thewhiteroom.com/cgi-bin/ws/checkout</code>

* '''XML Request'''
<code>
<OrderRequest>
<Addresses>
<Address type="billing">
<Email>brandon@scooby.netsville.com</Email>
<FirstName>James</FirstName>
<LastName>Camire</LastName>
<Street1>1111 Washington St</Street1>
<Street2>Suite 200</Street2>
<City>Golden</City>
<State>CO</State>
<Zip>80401</Zip>
<DayPhone>720-260-4768</DayPhone>
<EveningPhone></EveningPhone>
</Address>
<Address type="shipping">
<Email>brandon@scooby.netsville.com</Email>
<FirstName>Mary</FirstName>
<LastName>Camire</LastName>
<Street1>15602 West 79th Pl</Street1>
<Street2> </Street2>
<City>Arvada</City>
<State>CO</State>
<Zip>80007</Zip>
<DayPhone>303-123-4567</DayPhone>
<EveningPhone></EveningPhone>
</Address>
</Addresses>
<Shipping type="Standard">5.22</Shipping>
<PromotionCode>THX10</PromotionCode>
<OrderSubtotal>99.37</OrderSubtotal>
<OrderTax>99.37</OrderTax>
<OrderDiscount>10.00</OrderDiscount>
<MemberID>12345</MemberID>
<CustomerIP>74.100.182.104</CustomerIP>
<CreditCard>
<Name>James Camire</Name>
<Number>5105105105105100</Number>
<ExpMonth>09</ExpMonth>
<ExpYear>09</ExpYear>
<CSC>123</CSC>
</CreditCard>
<ProductIDs>
<ProductID qty="1">HK6614</ProductID>
<ProductID qty="2">HJ2722</ProductID>
</ProductIDs>
</OrderRequest>
</code>

* '''XML Response'''
<code>
<?xml version="1.0" encoding="utf-8" ?>
<OrderReponse>
<ShippingTotal>9.09</ShippingTotal>
<TaxTotal>11.82</TaxTotal>
<ProductTotal>145.00</ProductTotal>
<DiscountTotal>10.00</DiscountTotal>
<GrandTotal>155.91</GrandTotal>
<OrderNumber>1090386</OrderNumber>
<ClientID>12345</ClientID>
<MSG>Thank you for your order! You should be receiving an email shortly.</MSG>
</OrderReponse>
</code>

= Order Status =

USA Web Service

2012-01-20T19:37:20Z

2011-10-24T19:18:12Z

Netsville Support: Initial creation of the Mac Mail config page

Here are some instructions and screen shots for setting up your mail under Mac OS X's Mac Mail.

# From the menu choose '''Mail''' then '''Preferences...''' then click [+] to add an account.
#:Type in your name, email address and password into the dialog and hit '''CONTINUE'''
#:[[File:Mac_Mail_Add_Account.png]]
# Now choose Account Type. You can choose either '''POP''' or '''IMAP'''. We recommend '''IMAP'''.
#: Description: Netsville Email
#: Incoming Mail Server: '''securemail.netsville.com'''
#: Username: '''user@example.com''' (your full email address, not just the user portion)
#: Password: (may already be filled in)
#: [[File:Mac_Mail_Incoming_Mail.png]]
# For Incoming Mail Security, check '''Use Secure Sockets Layer''' and Authentication Type of '''PASSWORD'''.
#: [[File:Mac_Mail_Incoming_Mail_Security.png]]
# For Outgoing Mail Server, type '''securemail.netsville.com'''. You must have '''Use Authentication''' checked and use the same User Name ('''your full email address!''') and Password you did previously. It may already be filled out.
#: [[File:Mac_Mail_Outgoing_Mail_Server.png]]
# This page is a summary showing your configuration. Make sure the email address and User Name are the same. And make sure the Incoming and Outgoing servers are both '''securemail.netsville.com'''. And finally, make sure SSL is '''on''' for both incoming and outgoing servers.
#: [[File:Mac_Mail_Account_Summary.png]]

File:Mac Mail Account Information Outbound Advanced.png

2011-10-24T18:30:50Z

Netsville Support: The Outgoing Server's Advanced tab

The Outgoing Server's Advanced tab

File:Mac Mail Account Summary Advanced.png

2011-10-24T18:29:07Z

Netsville Support: The Advanced tab of the Mail Account Information page.

The Advanced tab of the Mail Account Information page.

File:Mac Mail Account Information.png

2011-10-24T18:27:46Z

Netsville Support: The Mail Account Information page (after mail has been set up)

The Mail Account Information page (after mail has been set up)

File:Mac Mail Account Summary.png

2011-10-24T18:26:38Z

Netsville Support: Account Summary dialog

Account Summary dialog

File:Mac Mail Outgoing Mail Server.png

2011-10-24T18:25:25Z

Netsville Support: Outgoing Mail Server dialog

Outgoing Mail Server dialog

File:Mac Mail Incoming Mail Security.png

2011-10-24T18:24:35Z

Netsville Support: Incoming Mail Server Security Dialog

Incoming Mail Server Security Dialog

File:Mac Mail Incoming Mail.png

2011-10-24T18:23:17Z

Netsville Support: Incoming Mail Server Dialog

Incoming Mail Server Dialog

File:Mac Mail Add Account.png

2011-10-24T18:21:52Z

Netsville Support: Add Account Dialog

Add Account Dialog