Method PostUpdateAddress

Summary

Update address

Remarks

This updates the address and phone number of a utility account.

NOTE: If you do not send the phone number, it will reset any existing phone number to 000-000-0000.

Input Parameters

NameTypeLengthDescription
customerNumber numeric 9 [Required] Customer Number. See Account Search methods.
locationNumber numeric 9 [Required] Location Number. See Account Search methods.
address2 System.String 30 Address line 2. Send blank (" ") to clear previous address line
address3 System.String 30 Address line 3. Send blank (" ") to clear previous address line
address4 System.String 30 Address line 4. This is normally the city, state, zip. It will update this line only if the zip code matches.
zipCode System.String 9 Zip code. Can include Zip+4 or Canadian zip codes.
areaCode numeric 3 Phone area code
phoneNumber numeric 10 Phone number. If the area code is included, it will fill in the areaCode value.

Example

POST http://localhost/FusionServices/v2/Naviline/Utilities/address

Return Values

NameDescription
ErrorCode 0000 = Successful. 0092=Invalid Zip Code
ErrorMessage error message if any error occurred.

Sample Responses

Sample Code

using System.Net;
using Newtonsoft.Json.Linq;

public void MethodName(parms)
{
   string uri = "http://localhost/FusionServices/v2/Naviline/Utilities/address";
   System.Collections.Specialized.NameValueCollection postParms = 
     new System.Collections.Specialized.NameValueCollection(); 
   // Set paramater values
   postParms.Add("customerNumber",System.Web.HttpUtility.UrlEncode("000000339"));
   postParms.Add("locationNumber",System.Web.HttpUtility.UrlEncode("000012588"));
   postParms.Add("name",System.Web.HttpUtility.UrlEncode("Central Square"));
   postParms.Add("address2",System.Web.HttpUtility.UrlEncode("1000 Business Center Drive"));
   postParms.Add("address3",System.Web.HttpUtility.UrlEncode("Suite 403"));
   postParms.Add("address4",System.Web.HttpUtility.UrlEncode("Lufkin TX"));
   postParms.Add("zipCode",System.Web.HttpUtility.UrlEncode("32746"));
   postParms.Add("areaCode",System.Web.HttpUtility.UrlEncode("407"));
   postParms.Add("phoneNumber",System.Web.HttpUtility.UrlEncode("7652323"));

   WebClient req = new WebClient();
   wc.Headers.Add("Content-Type", "application/x-www-form-urlencoded");
   wc.Headers.Set("X-APPID", "YOURID");
   wc.Headers.Set("X-APPKEY", "YOURKEY");

   byte[] responseBytes = wc.UploadValues(new Uri(uri), "POST", postParms);
   string stringResult = Encoding.UTF8.GetString(responseBytes); 
   JObject response = JObject.Parse(stringResult);
   string error = response["OutputParms"]["ErrorCode"].ToString();
   if (error == "0000")
   {
         // TODO - YOUR CODE HERE
   }
}

C# Razor MVC Sample Code

using System;
using System.Linq;
using System.Web;
using System.ComponentModel.DataAnnotations;
using System.Collections.Specialized;
using FusionServiceHelper.Models;

// NOTE: Use the namespace generated when you add the class, so that it is correct.
namespace FusionRazor.Models
{
   public class PostUpdateAddress
   {
       // Add property for each input param in order to map a field to it
       [Required(ErrorMessage = "Required")]
       [RegularExpression("[0-9]{0,9}", ErrorMessage = "Numeric values only. Must be 9 digits or less. ")]
       public string customerNumber{get; set;}

       [Required(ErrorMessage = "Required")]
       [RegularExpression("[0-9]{0,9}", ErrorMessage = "Numeric values only. Must be 9 digits or less. ")]
       public string locationNumber{get; set;}

       [RegularExpression("^(?=.{0,30}$).*", ErrorMessage = "Must be 30 characters or less. ")]
       public string address2{get; set;}

       [RegularExpression("^(?=.{0,30}$).*", ErrorMessage = "Must be 30 characters or less. ")]
       public string address3{get; set;}

       [RegularExpression("^(?=.{0,30}$).*", ErrorMessage = "Must be 30 characters or less. ")]
       public string address4{get; set;}

       [RegularExpression("^(?=.{0,9}$).*", ErrorMessage = "Must be 9 characters or less. ")]
       public string zipCode{get; set;}

       [RegularExpression("[0-9]{0,3}", ErrorMessage = "Numeric values only. Must be 3 digits or less. ")]
       public string areaCode{get; set;}

       [RegularExpression("[0-9]{0,10}", ErrorMessage = "Numeric values only. Must be 10 digits or less. ")]
       public string phoneNumber{get; set;}

       public PostUpdateAddress()
       {
           //Set any defaults here
       }
   }
}
@* NOTE: Use Add->View to add the View. *@
@* NOTE: Check the 'Create strongly-typed view checkbox, and select the PostUpdateAddress class. *@
@* NOTE: Select Edit as the Scaffold template. *@
@* NOTE: Use the @model line that is generated at the top.  Replace the rest with the lines below.
@model FusionRazor.Models.PostUpdateAddress

@{
   ViewBag.Title = "PostUpdateAddress";
}

<h2>PostUpdateAddress</h2>
@using (Html.BeginForm()) {
   @Html.AntiForgeryToken()
   @Html.ValidationSummary(true)
   <fieldset>
   <legend>PostUpdateAddress</legend>
       <div class="editor-label">
           @Html.LabelFor(model => model.customerNumber)
       </div>
       <div class="editor-field">
           @Html.EditorFor(model => model.customerNumber)
           @Html.ValidationMessageFor(model => model.customerNumber)
       </div>
       <div class="editor-label">
           @Html.LabelFor(model => model.locationNumber)
       </div>
       <div class="editor-field">
           @Html.EditorFor(model => model.locationNumber)
           @Html.ValidationMessageFor(model => model.locationNumber)
       </div>
       <div class="editor-label">
           @Html.LabelFor(model => model.address2)
       </div>
       <div class="editor-field">
           @Html.EditorFor(model => model.address2)
           @Html.ValidationMessageFor(model => model.address2)
       </div>
       <div class="editor-label">
           @Html.LabelFor(model => model.address3)
       </div>
       <div class="editor-field">
           @Html.EditorFor(model => model.address3)
           @Html.ValidationMessageFor(model => model.address3)
       </div>
       <div class="editor-label">
           @Html.LabelFor(model => model.address4)
       </div>
       <div class="editor-field">
           @Html.EditorFor(model => model.address4)
           @Html.ValidationMessageFor(model => model.address4)
       </div>
       <div class="editor-label">
           @Html.LabelFor(model => model.zipCode)
       </div>
       <div class="editor-field">
           @Html.EditorFor(model => model.zipCode)
           @Html.ValidationMessageFor(model => model.zipCode)
       </div>
       <div class="editor-label">
           @Html.LabelFor(model => model.areaCode)
       </div>
       <div class="editor-field">
           @Html.EditorFor(model => model.areaCode)
           @Html.ValidationMessageFor(model => model.areaCode)
       </div>
       <div class="editor-label">
           @Html.LabelFor(model => model.phoneNumber)
       </div>
       <div class="editor-field">
           @Html.EditorFor(model => model.phoneNumber)
           @Html.ValidationMessageFor(model => model.phoneNumber)
       </div>
       <p>
       <input type="submit" value="Submit"/>
       </p>
   </fieldset>

}

@section Scripts {
   @Scripts.Render("~/bundles/jqueryval")
}
using System;
using System.Collections.Specialized;
using System.Linq;
using System.Web;
using System.Web.Mvc;
using FusionServiceHelper.Models;

// NOTE: Replace 'MyController' with the name of your controller.

// 
// GET: /MyController/PostUpdateAddress
public ActionResult PostUpdateAddress()
{
   // Create a new instance of the model to pick up any default values.
   PostUpdateAddress model =  new PostUpdateAddress();

   // pass model to set to default values
   // NOTE: Change 'MyFolderPath' to the path to the .cshtml file.
   return View("~/Views/MyFolderPath/PostUpdateAddress.cshtml", model);
}

// 
// POST: /MyController/PostUpdateAddress
[HttpPost]
public ActionResult PostUpdateAddress(FormCollection collection)
{
   string url = "v2/Naviline/Utilities/address";
   // Get the value from each input field
   NameValueCollection inputParms = new NameValueCollection();
   inputParms.Add("customerNumber", collection["customerNumber"]);
   inputParms.Add("locationNumber", collection["locationNumber"]);
   inputParms.Add("address2", collection["address2"]);
   inputParms.Add("address3", collection["address3"]);
   inputParms.Add("address4", collection["address4"]);
   inputParms.Add("zipCode", collection["zipCode"]);
   inputParms.Add("areaCode", collection["areaCode"]);
   inputParms.Add("phoneNumber", collection["phoneNumber"]);

   try
   {
       // Send the request
       FusionServiceRequest request = new FusionServiceRequest();
       FusionServiceResult result = request.Post(url, inputParms);

       return View("Result", result);
   }
   catch(Exception e)
   {
       HandleErrorInfo info = new HandleErrorInfo(e, "MyController", "PostUpdateAddress");
       return View("Error", info);
   }
}