Method GetMeterNumber

Summary

Get Meter Number

Remarks

Get the meter number, reading, and last read date for a utility account.

Requires

Input Parameters

NameTypeLengthDescription
customerNumber numeric 9 [Required] Customer Number. See Account Search methods.
locationNumber numeric 9 [Required] Location Number. See Account Search methods.
serviceCode System.String 2 [Required] Service Code. Use the ServiceCode field returned by GetCurrentCharges

Example

GET http://localhost/FusionServices/v3/Naviline/Utilities/{customerNumber}/{locationNumber}/service/{serviceCode}/meterNumber

Return Values

NameDescription
Service Two letter code indicating the type of utility service. Example: WA for water
Sequence The three digit sequence number assigned to the meter. This is the order in which the meter reader reads the meter within her route. This is used to identify the meter internally.
MeterNumber Identification number used to identify the meter to the customer.
LastReadDate Date the last meter read was taken. Format: mmddyyyy
Units Description of the units the reading is measured in.
Reading The reading from the meter.
RDGFD

Sample Responses

Sample Code

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

public void MethodName(parms)
{
    string uri = "http://localhost/FusionServices/v3/Naviline/Utilities/101/33028/service/WA/meterNumber";
    WebClient wc = new WebClient();
    wc.Headers.Set("X-APPID", "YOURID");
    wc.Headers.Set("X-APPKEY", "YOURKEY");
    string stringResult = wc.DownloadString(new Uri(uri));
    
    JObject response = JObject.Parse(stringResult);
    string error = response["OutputParms"]["ErrorCode"].ToString();
    if (error == "0000")
    {
        JArray jRows = (JArray)response["Rows"];
        foreach (JObject row in jRows)
        {
             string Service = row["Service"].ToString();
             string Sequence = row["Sequence"].ToString();
             string MeterNumber = row["MeterNumber"].ToString();
             string LastReadDate = row["LastReadDate"].ToString();
             string Units = row["Units"].ToString();
             string Reading = row["Reading"].ToString();
             string RDGFD = row["RDGFD"].ToString();
             // TODO - YOUR CODE HERE
        }
    }
}

$.get('http://localhost/FusionServices/v3/Naviline/Utilities/101/33028/service/WA/meterNumber', function(response) {
    $('#resultDiv).html(response); 
 });

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 GetMeterNumber
   {
       // 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;}

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

       public GetMeterNumber()
       {
           //Set any defaults here
           customerNumber = DefaultData.Get("customerNumber");
           locationNumber = DefaultData.Get("locationNumber");
           serviceCode = DefaultData.Get("serviceCode");
       }
   }
}
@* NOTE: Use Add->View to add the View. *@
@* NOTE: Check the 'Create strongly-typed view checkbox, and select the GetMeterNumber 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.GetMeterNumber

@{
   ViewBag.Title = "GetMeterNumber";
   string myUrl = "http://localhost/FusionServices/v3/Naviline/Utilities/" + Model.customerNumber + "/" + Model.locationNumber + "/service/" + Model.serviceCode + "/meterNumber";
}

<h2>GetMeterNumber</h2>
@using (Html.BeginForm()) {
   @Html.AntiForgeryToken()
   @Html.ValidationSummary(true)
   <fieldset>
   <legend>GetMeterNumber</legend>
       <div class="editor-label">Use the fields below to change the values and resubmit.</div>
       <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.serviceCode)
       </div>
       <div class="editor-field">
           @Html.EditorFor(model => model.serviceCode)
           @Html.ValidationMessageFor(model => model.serviceCode)
       </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/GetMeterNumber
public ActionResult GetMeterNumber()
{
   // Create a new instance of the model to pick up any default values.
   GetMeterNumber model =  new GetMeterNumber();

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

// 
// POST: /MyController/GetMeterNumber
[HttpPost]
public ActionResult GetMeterNumber(FormCollection collection)
{
   string url = "v3/Naviline/Utilities/{customerNumber}/{locationNumber}/service/{serviceCode}/meterNumber";
   // Get the value from each input field
   NameValueCollection inputParms = new NameValueCollection();
   inputParms.Add("customerNumber", collection["customerNumber"]);
   inputParms.Add("locationNumber", collection["locationNumber"]);
   inputParms.Add("serviceCode", collection["serviceCode"]);

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

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