====== UpdateCustomerRq (Request) ======

The UpdateCustomerRq request allows users to update customer accounts in the Fortune3 database. It can only be used to update a single customer account with each request. 

===== Updating Customer Accounts =====

In order to update an account you will need to provide a Filter (so the system knows which customer account to update), and all required fields. You may also import any optional customer account fields and/or custom checkout fields you have added to the billing or shipping address. Proceed as Follows:

**Sample Code** (creating customer account with Email "martha.brady@hotmail.com"):

<code>
<sendRequestXML>
<authenticate>
<APIUsername>TWmY6WBft</APIUsername>
<APIPassword>SKW8ssAmDu6xTGDl</APIPassword>
</authenticate>
<UpdateCustomerRq RequestID="1">
        <Filters>
        <Filter>
        <EmailAddress>martha.brady@hotmail.com</EmailAddress>
        </Filter>
        </Filters>
	<Customer>
		<EmailAddress>martha.brady@hotmail.com</EmailAddress>
		<Password>MyNewPass123</Password>
		<CustomerFName>Martha</CustomerFName>
   		<CustomerLName>Brady</CustomerLName>
		<BillingAddress>
			<CustomerLName>Brady</CustomerLName>
			<CustomerFName>Martha</CustomerFName>
			<Addr1>11433 Arvida Rd</Addr1>
			<Addr2>Unit 203</Addr2>
			<City>Hollywood</City>
			<State>California</State>
			<PostalCode>90208</PostalCode>
			<Country>US</Country>
			<CommercialAddr>false</CommercialAddr>
			<Phone>555-309-2222</Phone>
			<CompanyPhone>555-908-2212</CompanyPhone>
			<Fax>555-908-2213</Fax>
		</BillingAddress>
		<ShippingAddress>
			<CustomerLName>Brady</CustomerLName>
			<CustomerFName>Martha</CustomerFName>
			<Company>The Brady Outlet</Company>
			<Addr1>1982 NE 22 Ave</Addr1>
			<Addr2></Addr2>
			<City>Miami</City>
			<State>Florida</State>
			<PostalCode>33122</PostalCode>
			<Country>US</Country>
			<CommercialAddr>true</CommercialAddr>
			<Phone>555-309-2222</Phone>
		</ShippingAddress>
	</Customer>
</UpdateCustomerRq>
</sendRequestXML>
</code>

===== Available Filters for UpdateCustomerRq =====

^ Tag Name ^ Sub-Tag Of ^ Description                      ^ Field Type ^ Is Required ^
| Filters | UpdateCustomerRq | The Filters Activation Node | Single Node | True |
| Filter  | Filters | The Current Filter Node | Single Node | True |
| EmailAddress      | Filter    | Matches the Customer's Email Address  | String | True if CustomerID not Provided|
| CustomerID | Filter    | Matches the internal Customer ID    | String | True if EmailAddress not Provided |

===== Available Fields for UpdateCustomerRq =====

^ Tag Name ^ Sub-Tag Of ^ Description                      ^ Field Type ^ Is Required ^
| Customer | AddCustomerRq | The Customer Account Node | Node | True |
| EmailAddress  | Customer | The Customer's Email Address (or username) | String\\ Max: 250 Characters | True |
| Password | Customer | The Customer's Account Password | String\\ Min: 5 Characters\\ Max: 30 Characters | Only if CustomerType = Wholesale |
| CustomerFName | Customer | The Customer's First Name | String\\ Max: 100 Characters | True |
| CustomerLName | Customer | The Customer's Last Name | String\\ Max: 100 Characters | True |
| CustomerMName | Customer | The Customer's Middle Name Initial | String\\ Max: 50 Characters | False |
| CustomerType | Customer | The Customer Account Type | String:\\ * Individual\\ * Corporate\\ * Education\\ * Government\\ * Fortune 1000\\ * Wholesale | False\\ (Default: Individual) |
| PriceLevel | Customer | The Customer's Price Level | String:\\ * Retail\\ * Price Level 1\\ * Price Level 2\\ * Price Level 3\\ * Price Level 4\\ * Price Level 5 | False\\ (Default: Retail) |
| TaxExempt | Customer | Defines if the Customer is Tax Exempt | Boolean\\ * true\\ * false | False\\ (Default: false) |
| TaxID | Customer | The Customer's Federal Tax ID | String\\ Max: 16 Characters | False |
| URL | Customer | The Customer's Website URL | String\\ Max: 50 Characters | False |
| CustomFields | Customer | Node for Custom Checkout Fields\\ in the Final Step | Node | False |
| $CustomField | CustomFields | Any Custom Checkout Fields\\ in the Final Step | String\\ (Must Match Existing Custom Field\\ Name on store's Final Step) | False |
| BillingAddress | Customer | The Billing Address Node | Node | False |
| CustomerFName | BillingAddress | The Billing Address First Name | String\\ Max: 100 Characters | True\\ *(If BillingAddress Node Present) |
| CustomerLName | BillingAddress | The Billing Address Last Name | String\\ Max: 100 Characters | True\\ *(If BillingAddress Node Present) |
| CustomerMName | BillingAddress | The Billing Address Middle Name Initial | String\\ Max: 50 Characters | False |
| Company | BillingAddress | The Billing Address Company Name | String\\ Max: 25 Characters | False |
| Addr1 | BillingAddress | The Billing Address Line 1 | String\\ Max: 60 Characters | True\\ *(If BillingAddress Node Present) |
| Addr2 | BillingAddress | The Billing Address Line 2 | String\\ Max: 60 Characters | False |
| City | BillingAddress | The Billing Address City | String\\ Max: 40 Characters | True\\ *(If BillingAddress Node Present) | 
| State | BillingAddress | The Billing Address State | String\\ (Use the full state/province name or the 2-Letter state code for US and Canada) | True\\ *(If BillingAddress Node Present) |
| PostalCode | BillingAddress | The Billing Address Zip/Postal Code | String | True\\ *(If BillingAddress Node Present) |
| Country | BillingAddress | The Billing Address Country | String\\ (Use the full country name or the 2-Letter country code) | True\\ *(If BillingAddress Node Present) |
| CommercialAddr | BillingAddress | Defines if the Billing Address is a Commercial Address | Boolean\\ * true\\ * false | False\\ (Default: false) |
| Phone | BillingAddress | The Billing Address Phone Number | String\\ Max: 22 Characters | False | 
| CompanyPhone | BillingAddress | The Billing Address Company Phone Number | String\\ Max: 22 Characters | False |
| Fax | BillingAddress | The Billing Address Fax Number | String\\ Max: 22 Characters | False |
| CustomFields | BillingAddress | Node for Custom Checkout Fields\\ in the Billing Address | Node | False |
| $CustomField | BillingAddress->CustomFields | Any Custom Checkout Fields\\ in the Billing Address | String\\ (Must Match Existing Custom Field\\ Name on store's Billing Address) | False |
| ShippingAddress | Customer | The Shipping Address Node | Node | False |
| CustomerFName | ShippingAddress | The Shipping Address First Name | String\\ Max: 100 Characters | True\\ *(If ShippingAddress Node Present) |
| CustomerLName | ShippingAddress | The Shipping Address Last Name | String\\ Max: 100 Characters | True\\ *(If ShippingAddress Node Present) |
| CustomerMName | ShippingAddress | The Shipping Address Middle Name Initial | String\\ Max: 50 Characters | False |
| Company | ShippingAddress | The Shipping Address Company Name | String\\ Max: 25 Characters | False |
| Addr1 | ShippingAddress | The Shipping Address Line 1 | String\\ Max: 60 Characters | True\\ *(If ShippingAddress Node Present) |
| Addr2 | ShippingAddress | The Shipping Address Line 2 | String\\ Max: 60 Characters | False |
| City | ShippingAddress | The Shipping Address City | String\\ Max: 40 Characters | True\\ *(If ShippingAddress Node Present) | 
| State | ShippingAddress | The Shipping Address State | String\\ (Use the full state/province name or the 2-Letter state code for US and Canada) | True\\ *(If ShippingAddress Node Present) |
| PostalCode | ShippingAddress | The Shipping Address Zip/Postal Code | String | True\\ *(If ShippingAddress Node Present) |
| Country | ShippingAddress | The Shipping Address Country | String\\ (Use the full country name or the 2-Letter country code) | True\\ *(If ShippingAddress Node Present) |
| CommercialAddr | ShippingAddress | Defines if the Shipping Address is a Commercial Address | Boolean\\ * true\\ * false | False\\ (Default: false) |
| Phone | ShippingAddress | The Shipping Address Phone Number | String\\ Max: 22 Characters | False | 
| CustomFields | ShippingAddress | Node for Custom Checkout Fields\\ in the Shipping Address | Node | False |
| $CustomField | ShippingAddress->CustomFields | Any Custom Checkout Fields\\ in the Shipping Address | String\\ (Must Match Existing Custom Field\\ Name on store's Shipping Address) | False |

**Sample Code 2 ** (creating a wholesale customer account with Email "martha.brady@hotmail.com", all possible fields submitted):

<code>
<sendRequestXML>
<authenticate>
<APIUsername>TWmY6WBft</APIUsername>
<APIPassword>SKW8ssAmDu6xTGDl</APIPassword>
</authenticate>
<UpdateCustomerRq RequestID="1">
        <Filters>
        <Filter>
        <CustomerID>11943</CustomerID>
        </Filter>
        </Filters>
	<Customer>
		<EmailAddress>martha.brady@hotmail.com</EmailAddress>
		<Password>GoodLuck23</Password>
		<CustomerFName>Martha</CustomerFName>
   		<CustomerLName>Brady</CustomerLName>
		<CustomerMName>H</CustomerMName>
		<CustomerType>Wholesale</CustomerType>
		<PriceLevel>Price Level 1</PriceLevel>
		<TaxExempt>true</TaxExempt>
		<TaxID>95-1111989</TaxID>
		<URL>http://www.thebradyoutlet.com</URL>
		<CustomFields>
			<HowDidYouHearOfUs>Magazine Ad</HowDidYouHearOfUs>
		</CustomFields>
		<BillingAddress>
			<CustomerLName>Brady</CustomerLName>
			<CustomerFName>Martha</CustomerFName>
			<CustomerMName>H</CustomerMName>
			<Company></Company>
			<Addr1>11433 Arvida Rd</Addr1>
			<Addr2>Unit 203</Addr2>
			<City>Hollywood</City>
			<State>California</State>
			<PostalCode>90208</PostalCode>
			<Country>US</Country>
			<CommercialAddr>false</CommercialAddr>
			<Phone>555-309-2222</Phone>
			<CompanyPhone>555-908-2212</CompanyPhone>
			<Fax>555-908-2213</Fax>
			<CustomFields>
				<CellPhoneNumber>555-221-1221</CellPhoneNumber>
				<BestTimeToCall>Morning</BestTimeToCall>
			</CustomFields>
		</BillingAddress>
		<ShippingAddress>
			<CustomerLName>Brady</CustomerLName>
			<CustomerFName>Martha</CustomerFName>
			<CustomerMName>H</CustomerMName>
			<Company>The Brady Outlet</Company>
			<Addr1>1982 NE 22 Ave</Addr1>
			<Addr2></Addr2>
			<City>Miami</City>
			<State>Florida</State>
			<PostalCode>33122</PostalCode>
			<Country>US</Country>
			<CommercialAddr>true</CommercialAddr>
			<Phone>555-309-2222</Phone>
		</ShippingAddress>
	</Customer>
</UpdateCustomerRq>
</sendRequestXML>
</code>

Next: [[UpdateCustomerRs|Reading the Response (UpdateCustomerRs)]]