Name
RecordChange Update a customer record
Description
RecordChange updates the customer record associated with a given number. The following are the allowed fields in reqparams:
* dialedNumber The number containing the customer record, sent in the SMS/800 num field.
* dateTime The effective date/time of the record. The format of this value is:
mm/dd/yy hh:mmX/Y
where X is the meridiem (A or P), and Y is the SMS/800 timezone indicator. An example of a valid date/time would be: 07/01/98 10:15A/C.
Be aware that Somos only allows schedule date/times where the minute on the quarter hour :00, :15, :30, or :45.

Any other value for minute will cause the record to fail validation.

This field may also contain the value NOW to request an immediate change.

resporg The RespOrg, sent in the SMS/800 newro field. This field allows a RespOrg change to be sent.
interLATACarrier The numeric CIC code of the primary InterLATA carrier, sent in the SMS/800 iec field.
intraLATACarrier The numeric CIC code of the primary IntraLATA carrier, sent in the SMS/800 iac field.
potsTermination A POTS number to which SMS/800 will direct calls, sent in the SMS/800 tel field. Also see interLATAPOTSValue below.
interLATAPOTSValue Allows InterLATA POTS to be specifed. If a value is specified in the potsTermination field, and the value of interLATAPOTSValue is 0, both the POTS and Toll Free (dialedNumber) values will be sent as tels. If the value is 1, only the given POTS number will be sent.
orderNumber The Service Order Number, sent in the SMS/800 so field. Must be from 4-13 bytes, where the first character is alphabetic, the second through twelfth characters are alphanumeric, and the thirteenth character is alphabetic.
sfNumber The Supplemental Form Number, sent in the SMS/800 sf field. Must be 1-6 alphanumeric characters. Required if Service Order Number is not specified.
planDN The dialed number serving as the source of the complex routing plan. Also see complexRecord below.
complexRecord The name of the entry in the RPLAN or TRPLAN table that contains the complex routing for this record. If planDN was specified, then this value and complexRecord are used as an index into RPLAN. If planTemplatename was specified, then this value and complexRecord are used as an index into TRPLAN. If neither planDN nor planTemplatename are specified then complexRecord is assumed to be a local SMS Template plan and that value alone is used as an index into TRPLAN.
notes Commentary to be sent in the SMS/800 note field. Can be up to 151 characters.
lns The number of terminating lines sent in the SMS/800 lns field. The format of this value is:
num^numlines,num^numlines,...
where num is a POTS or toll-free number and numlines is the actual number of lines. The number of lines must be 1 to 4 digits. Since a CPR allows multiple POTS terminations to be specified along with the toll-free number, this value can be a comma-separated field that allows each individual POTs term plus the toll-free number term to have unique values.

In the case where lns is set and no CPR is to be used, the complexRecord field must still be specified, but with no value, as shown in the following example:

complexRecord~;lns~8005551212^888;
duedate The Due Date, sent in the SMS/800 dd field. Format is MM/DD/YY. If not specified, SMS/800 will generate a value.
holdValue The Hold Due Date indicator, sent in the SMS/800 hdd field. Allowable values are 0 and 1.
rao The Revenue Accounting Office, sent in the SMS/800 rao field. Must be 3 bytes, decimal numerals. The following rules apply to this field:
  • If the Bill To Number (billToNumber) is 9999999999, then rao must be 999. If it is not specified, SMS/800 will generate a default value of 999.
  • If complex routing is specified, then rao is required, and cannot be 999.
billToNumber The Bill To, or Alternate Billing Number, sent in the SMS/800 abn field. Must be 10 alphanumeric characters. If rao is 999, then billToNumber must be 9999999999.
customer The On-Line Access Customer, sent in the SMS/800 cus field. Must be 5 alphanumeric characters.
agent The On-Line Agent for Customer, sent in the SMS/800 agent field. Must be 5 alphanumeric characters.
telco The company that sold SMS access, sent in the SMS/800 telco field. Must be 4 alphanumeric characters.
icecBilling The IC/EC Billing Indicator, sent in the SMS/800 cbi field. Must be 3 alphabetic characters for an Interexchange Carrier, 4 alphabetic characters for an Exchange Carrier.
contactName The name of the contact person, sent in the SMS/800 ncon field. Maximum of 30 characters.
contactPhone The Contact Phone Number, sent in the SMS/800 ctel field. Must be 10 decimal numerals.
interceptDate The End Intercept Date, sent in the SMS/800 eint field. Format is MM/DD/YY. An End Intercept Date is used for disconnect records. Specifying a value for interceptDate will cause a disconnect rather than a change to be sent.
referralOption The Referral Option, sent in the SMS/800 refer field, and used for disconnect records. Allowable values are 0 and 1.
network Network Area of Service, sent in the SMS/800 anet field. The value is a comma-separated list of valid SMS/800 network codes.
state State Area of Service, sent in the SMS/800 asta field. The value is a comma-separated list of valid SMS/800 state codes.
areacode Area Code Area of Service, sent in the SMS/800 aac field. The value is a comma-separated list of valid area codes.
lata LATA Area of Service, sent in the SMS/800 alat field. The value is a comma-separated list of valid LATAs.
labels Label Area of Service, sent in the SMS/800 albl field. The value is a comma-separated list of valid SMS/800 AOS label names. The SMS/800 MGI provides no means to define AOS labels; they must previously exist.
directoryAssistanceType The Directory Assistance Type, sent in the SMS/800 dat field. The valid values are N (Normal), G (Government), and F (Frequently Called).
updateValue The Directory Assistance Update indicator, sent in the SMS/800 dau field. The valid values are 0 and 1.
listingType The Listing Type, sent in the SMS/800 li field. The valid values are BL (BLocked), LI (Published), and NP (Non-published).
address The Listing Address, sent in the SMS/800 la field. Can be up to 75 characters.
names The Listing Names, sent in the SMS/800 ln field. Up to nine listing names can be specified, each up to 75 characters, separated by the ^ character.
highpriority This parameter provides access to the SMS/800 High Priority Update feature. Setting it to 1 will tell SMS to place this customer record at the front of the SCP queue. Only a small number of these updates can be done each day. After that, if this parameter is set to 1 the message will fail. You may check the Activity Log to see how many such updates remain for the current day.
MGI Messages
RecordChange sends a REQ-CRC message with an action code of N, C or D. The response message is a RSP-CRC.
Example
The following request parameters will send an immediate change to 8005551212. The InterLATA carrier will be set to 0432, the order number to ORDER1, the area of service to US, and the listing name to CSF:
dialedNumber~8005551212;dateTime~NOW;interLATACarrier~0432; orderNumber~ORDER1;names~CSF;network~US