Lines_PackageChange

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

Input Fields

FieldTypeNotesRequired?
LineIdIntegerThe Rev.io ID of the service that is having the package changed performed.Required
PackageIDIntegerThe Rev.io ID of the package being changed on the service.Required
EffectiveDateDateThe effective date of the package change. If not specified, today's date is used.Optional
CarrierAccountIDIntegerThe 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
ProgramIDIntegerThe 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

FieldTypeNotesRequired?
CustomerIDList/IntegerOne or more Rev.io Customer IDs. Multiple Customer IDs can be used in one request to save round-trips.Optional
LineIDList/IngeterOne or more Rev.io Service IDs. Multiple Service IDs can be used in one request to save round-trips.Optional
NumberStringThis is the built-in "TN" field on a Service in Rev.io. See notes below in the Output section for this field.Optional
CircuitNumberStringThis is the built-in "Circuit Number" field on a Service in Rev.io. See notes below in the Output section for this field.Optional
CarrierCustomerIDStringThis 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

FieldTypeNotes
Line_IDIntegerRev.io-generated unique identify for each Service.
Customer_IDIntegerIf you use Customer Account Numbers, this will not reflect that, but instead is the Rev.io-generated ID.
NumberStringThis 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_NumberStringAnother built-in field that can be used for identifying a service. It is similar to Number & Carrier_Customer_ID.
Carrier_Customer_IDStringAnother built-in field that can be used for identifying a service. It is similar to Number & Circuit_Number.
DescriptionStringPrints 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.
StatusStringOne of the following values:
PENDING
ACTIVE
DENIED
DISCONNECTED
CarrierStringDescription 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_IDIntegerID of above
Carrier_AccountStringDepends 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_IDIntegerID of above
PackageStringDescription of the Package assigned if applicable. Packages are configured under Settings > Packages.
Package_IDIntegerID of above
ProgramStringDescription 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_IDIntegerID of above
Line_TypeStringDescription of Service Type - e.g. Fiber Internet, POTS Service, Conference Service, etc. Configured under Settings > Service Types.
Line_Type_IDIntegerID of above
FieldsListList of all custom fields on this service. Configured under Settings > Service Types.
Fields > LabelStringLabel from Rev.io that is displayed with the field's value
Fields > ValueStringValue 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

FieldTypeNotesRequired?
Line_IDIntegerRev.io Service ID of the Service to be updated.Required
Number / UpdatedBooleanTrue to indicate this field is being updated.Optional
Number / ValueStringThis is the built-in "TN" field on a Service in Rev.io.Optional
CircuitNumber / UpdatedBooleanTrue to indicate this field is being updated.Optional
CircuitNumber / ValueStringThis is the built-in "Circuit Number" field on a Service in Rev.io.Optional
CarrierCustomerId / UpdatedBooleanTrue to indicate this field is being updated.Optional
CarrierCustomerId / ValueStringThis is the built-in "Provider Account Number" field on a Service in Rev.io.Optional
Program_ID / UpdatedBooleanTrue to indicate this field is being updated.Optional
Program_ID / ValueIntegerRev.io ID of a usage plan group to be updated on the service.Optional
Line_Type_ID / UpdatedBooleanTrue to indicate this field is being updated.Optional
Line_Type_ID / ValueIntegerRev.io Service Type ID of a service type to be updated on the service.Optional
Fields / FieldOne or more custom fields to be updated.Optional
Fields / Field / UpdatedBooleanTrue to indicate this field is being updated.Optional
Fields / Field / ValueStringValue 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>