Lines

Lines_PackageChange

Used to change the package of a service in Rev.io.

Input Fields

Field	Type	Notes	Required?
LineId	Integer	The Rev.io ID of the service that is having the package changed performed.	Required
PackageID	Integer	The Rev.io ID of the package being changed on the service.	Required
EffectiveDate	Date	The effective date of the package change. If not specified, today's date is used.	Optional
CarrierAccountID	Integer	The Rev.io ID of the provider account to be changed along with the package change. If not specified, the default using the package provider and service address is used.	Optional
ProgramID	Integer	The Rev.io ID of the usage plan group to be used with the new package change. If not specified, the usage plan group on the package is used.	Optional

Output Fields

No fields other than the standard output fields are provided.

Example Requests

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
        <Lines_PackageChange xmlns="http://api.myh2o.com/v20">
            <Request>
                <Credentials>
                    <Username>rev.io_username</Username>
                    <Password>rev.io_password</Password>
                    <Client>rev.io_client_code</Client>
                </Credentials>
                <LineID>123456</LineID>
                <PackageID>1001</PackageID>
                <ProgramID>0</ProgramID>
            </Request>
        </Lines_PackageChange>
    </soap:Body>
</soap:Envelope>

Example Responses

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Body>
    <Lines_PackageChangeResponse xmlns="http://api.myh2o.com/v20">
      <Lines_PackageChangeResult>
        <Header>
          <Success>true</Success>
          <SessionKey>ABC123939AkD9kD9303odfABC123939AkD9kD9303odf</SessionKey>
          <Impersonated>false</Impersonated>
        </Header>
      </Lines_PackageChangeResult>
    </Lines_PackageChangeResponse>
  </soap:Body>
</soap:Envelope>

Lines_Query

Use to retrieve information regarding services on a customer's account in Rev.io.

Input Fields

Field	Type	Notes	Required?
CustomerID	List/Integer	One or more Rev.io Customer IDs. Multiple Customer IDs can be used in one request to save round-trips.	Optional
LineID	List/Ingeter	One or more Rev.io Service IDs. Multiple Service IDs can be used in one request to save round-trips.	Optional
Number	String	This is the built-in "TN" field on a Service in Rev.io. See notes below in the Output section for this field.	Optional
CircuitNumber	String	This is the built-in "Circuit Number" field on a Service in Rev.io. See notes below in the Output section for this field.	Optional
CarrierCustomerID	String	This is the built-in "Provider Account Number" field on a Service in Rev.io. See notes below in the Output section for this field.	Optional

Output Fields

Field	Type	Notes
Line_ID	Integer	Rev.io-generated unique identify for each Service.
Customer_ID	Integer	If you use Customer Account Numbers, this will not reflect that, but instead is the Rev.io-generated ID.
Number	String	This is the built-in "TN" field in Rev.io. Regardless of the type of service in Rev.io, this field is used to store the primary identifier for the service represented by this service. It should be unique throughout your system. (e.g. two customers should not have the same phone number or MAC address, etc). For example, for a calling card, this would be the calling card number; for email service, this would be the email address, etc. In our instance of Rev.io that we use for our internal billing, we store the client code in this field as that is how we uniquely identify each customer's service.
Circuit_Number	String	Another built-in field that can be used for identifying a service. It is similar to Number & Carrier_Customer_ID.
Carrier_Customer_ID	String	Another built-in field that can be used for identifying a service. It is similar to Number & Circuit_Number.
Description	String	Prints on a customer's bill. Typically used for a customer-facing friendly name to help the customer recognize the service. E.g. Alarm Service, Rebecca's Office Service, etc. With the Enterprise Customer Portal customers can maintain these and use them to help organize services.
Status	String	One of the following values: PENDING ACTIVE DENIED DISCONNECTED
Carrier	String	Description of the Provider assigned. If this is a service you are buying from a wholesale provider, that is what goes here typically (e.g. AT&T, Verizon, Sprint, Broadvox, etc). This can also be internal systems - e.g. Metaswitch, Asterisk, LD Switch, Acme Packet, etc. When orders are created in Rev.io, they will be split up by provider so it is an important part of your workflow to have this set appropriately.
Carrier_ID	Integer	ID of above
Carrier_Account	String	Depends on the Provider above, but will often be a sub-account - e.g. if Provider is AT&T, this may be AT&T Florida account. If Provider is Metaswitch, this may be the specific Metaswitch this Service is on - e.g. Metaswitch Boston 01, etc.
Carrier_Account_ID	Integer	ID of above
Package	String	Description of the Package assigned if applicable. Packages are configured under Settings > Packages.
Package_ID	Integer	ID of above
Program	String	Description of the usage plan group. Usage plan groups are configured under Settings > Usage Plan Groups. Usage plan groups contains plans, and plans contain rates. Rates are used in usage rating to charge for an individual call/event/message/etc.
Program_ID	Integer	ID of above
Line_Type	String	Description of Service Type - e.g. Fiber Internet, POTS Service, Conference Service, etc. Configured under Settings > Service Types.
Line_Type_ID	Integer	ID of above
Fields	List	List of all custom fields on this service. Configured under Settings > Service Types.
Fields > Label	String	Label from Rev.io that is displayed with the field's value
Fields > Value	String	Value of the field stored in Rev.io.

Example Requests

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
        <Lines_Query xmlns="http://api.myh2o.com/v20">
            <Request>
                <Credentials>
                    <Username>rev.io_username</Username>
                    <Password>rev.io_password</Password>
                    <Client>rev.io_client_code</Client>
                </Credentials>
                <CustomerID>1200</CustomerID>
                <CustomerID>1201</CustomerID>
                <CustomerID>1202</CustomerID>
                <CustomerID>3500</CustomerID>
            </Request>
        </Lines_Query>
    </soap:Body>
</soap:Envelope>

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
        <Lines_Query xmlns="http://api.myh2o.com/v20">
            <Request>
                <Credentials>
                    <Username>rev.io_username</Username>
                    <Password>rev.io_password</Password>
                    <Client>rev.io_client_code</Client>
                </Credentials>
                <LineID>9898</LineID>
            </Request>
        </Lines_Query>
    </soap:Body>
</soap:Envelope>

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
        <Lines_Query xmlns="http://api.myh2o.com/v20">
            <Request>
                <Credentials>
                    <Username>rev.io_username</Username>
                    <Password>rev.io_password</Password>
                    <Client>rev.io_client_code</Client>
                </Credentials>
                <Number>1200</Number>
            </Request>
        </Lines_Query>
    </soap:Body>
</soap:Envelope>

Example Responses

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Body>
    <Lines_QueryResponse xmlns="http://api.myh2o.com/v20">
      <Lines_QueryResult>
        <Header>
          <Success>true</Success>
          <SessionKey>ABC123939AkD9kD9303odfABC123939AkD9kD9303odf</SessionKey>
          <Impersonated>false</Impersonated>
        </Header>
        <Lines>
          <Line>
            <Line_ID>25001</Line_ID>
            <Customer_ID>9999</Customer_ID>
            <Number>4045551234</Number>
            <Circuit_Number/>
            <Carrier_Customer_Id/>
            <Description/>
            <Status>ACTIVE</Status>
            <Carrier>Inhouse</Carrier>
            <Carrier_ID>1000</Carrier_ID>
            <Carrier_Account>Default</Carrier_Account>
            <Carrier_Account_ID>1001</Carrier_Account_ID>
            <Package/>
            <Package_ID>0</Package_ID>
            <Program>Business Basic</Program>
            <Program_ID>100</Program_ID>
            <Line_Type>Virtual Extension</Line_Type>
            <Line_Type_ID>4</Line_Type_ID>
            <Fields/>
          </Line>
          <Line>
            <Line_ID>25000</Line_ID>
            <Customer_ID>9999</Customer_ID>
            <Number>192.31.214.65</Number>
            <Circuit_Number>68.118.33.50</Circuit_Number>
            <Carrier_Customer_Id/>
            <Description>Primary Internet</Description>
            <Status>ACTIVE</Status>
            <Carrier>Inhouse</Carrier>
            <Carrier_ID>1000</Carrier_ID>
            <Carrier_Account>Default</Carrier_Account>
            <Carrier_Account_ID>1001</Carrier_Account_ID>
            <Package>Fiber 10 Gbps</Package>
            <Package_ID>25</Package_ID>
            <Program>Business Basic</Program>
            <Program_ID>100</Program_ID>
            <Line_Type>Dedicated Internet Access</Line_Type>
            <Line_Type_ID>16</Line_Type_ID>
            <Fields>
              <Field>
                <Label>Speed</Label>
                <Value>10000</Value>
              </Field>
              <Field>
                <Label>Primary DNS</Label>
                <Value>8.8.4.4</Value>
              </Field>
              <Field>
                <Label>Secondary DNS</Label>
                <Value>4.4.4.4</Value>
              </Field>
            </Fields>
          </Line>
        </Lines>
      </Lines_QueryResult>
    </Lines_QueryResponse>
  </soap:Body>
</soap:Envelope>

Lines_Update

Update a Service in Rev.io by ID.

Input Fields

Field	Type	Notes	Required?
Line_ID	Integer	Rev.io Service ID of the Service to be updated.	Required
Number / Updated	Boolean	True to indicate this field is being updated.	Optional
Number / Value	String	This is the built-in "TN" field on a Service in Rev.io.	Optional
CircuitNumber / Updated	Boolean	True to indicate this field is being updated.	Optional
CircuitNumber / Value	String	This is the built-in "Circuit Number" field on a Service in Rev.io.	Optional
CarrierCustomerId / Updated	Boolean	True to indicate this field is being updated.	Optional
CarrierCustomerId / Value	String	This is the built-in "Provider Account Number" field on a Service in Rev.io.	Optional
Program_ID / Updated	Boolean	True to indicate this field is being updated.	Optional
Program_ID / Value	Integer	Rev.io ID of a usage plan group to be updated on the service.	Optional
Line_Type_ID / Updated	Boolean	True to indicate this field is being updated.	Optional
Line_Type_ID / Value	Integer	Rev.io Service Type ID of a service type to be updated on the service.	Optional
Fields / Field		One or more custom fields to be updated.	Optional
Fields / Field / Updated	Boolean	True to indicate this field is being updated.	Optional
Fields / Field / Value	String	Value to set on the custom field specified.	Optional

Output Fields

There are no additional fields beyond the standard header fields.

Example Requests

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Body>
    <Lines_Update xmlns="http://api.myh2o.com/v20">
      <Request>
        <Credentials>
          <Username>rev.io_username</Username>
          <Password>rev.io_password</Password>
          <Client>rev.io_client_code</Client>
        </Credentials>
        <Line_ID>1393</Line_ID>
        <Number>
          <Updated>true</Updated>
          <Value>8509998877</Value>
        </Number>
      </Request>
    </Lines_Update>
  </soap:Body>
</soap:Envelope>

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Body>
    <Lines_Update xmlns="http://api.myh2o.com/v20">
      <Request>
        <Credentials>
          <Username>rev.io_username</Username>
          <Password>rev.io_password</Password>
          <Client>rev.io_client_code</Client>
        </Credentials>
        <Line_ID>1393</Line_ID>
        <Number>
          <Updated>true</Updated>
          <Value>8509998877</Value>
        </Number>
        <Fields>
          <Field>
            <Label>Primary DNS</Label>
            <Value>
              <Updated>true</Updated>
              <Value>8.8.4.4</Value>
            </Value>
          </Field>
          <Field>
            <Label>Secondary DNS</Label>
            <Value>
              <Updated>true</Updated>
              <Value>4.4.4.4</Value>
            </Value>
          </Field>
        </Fields>
      </Request>
    </Lines_Update>
  </soap:Body>
</soap:Envelope>

Example Responses

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Body>
    <Lines_UpdateResponse xmlns="http://api.myh2o.com/v20">
      <Lines_UpdateResult>
        <Header>
          <Success>false</Success>
          <Message>Field Primary DNS was not found.</Message>
          <Impersonated xsi:nil="true"/>
          <Error_Code>S2010</Error_Code>
          <Error_Description>Invalid input received.</Error_Description>
        </Header>
      </Lines_UpdateResult>
    </Lines_UpdateResponse>
  </soap:Body>
</soap:Envelope>

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Body>
    <Lines_UpdateResponse xmlns="http://api.myh2o.com/v20">
      <Lines_UpdateResult>
        <Header>
          <Success>true</Success>
          <SessionKey>ABCdk38oeh30e9fABCdk38oeh30e9fABCdk38oeh30e9fABCdk38oeh30e9fABCdk38oeh30e9f</SessionKey>
          <Impersonated>false</Impersonated>
        </Header>
      </Lines_UpdateResult>
    </Lines_UpdateResponse>
  </soap:Body>
</soap:Envelope>