CreateCustomer

This API is used to create a lifeline subscriber in Telgoo5.

End Point https://www.vcareapi.com/vcareOssApi/CreateCustomer/
Field (Short Description) value/Tag Name Format Field Example Type Notes Validation rules
VENDOR ID string Vcarecorporation Required A unique Vendor ID is associated with the MVNO/OSS partner. This is used for authorization purpose and can be obtained by contacting your account manager.
USER NAME string Vcarecorporation Required A unique User name is associated with the MVNO/OSS partner. This is used for authorization purpose and can be obtained by contacting your account manager.
PASSWORD string Vcarecorporation Required This is a random string which is generated by Vcare and is tied to the MVNO/OSS user name. This is specifically used for authentication purpose and can be obtained by contacting your account manager.
PIN string 123456789 Required This is generated by Vcare to provide an additional layer of security in the Interim API. This is used for authentication purpose and can be obtained by contacting your account manager.
REFERENCE NUMBER string 123456789 Required Auto generated unique reference number is required to be passed with each transaction.
COMPANYID Numeric 28 Required This can be obtained using another api called GetCompany.
Enrollmentid string A12345 Conditional The enrollment id is returned in the CheckServiceAvailability call and you are required to pass the same enrollment id for the enrollment you are attempting
SUFFIX NAME string Jr. Optional This is the suffix name of the applicant. Only allow Jr. or Sr. or II or III or IV or V.
FIRST NAME string John Required This is the first name of the applicant. Only English alphabet letters, space, apostrophe, Accent Grave ("`") and hyphen.Max length - 50 symbols.Space characters at the start or end of the name should be cut off.
MIDDLE NAME string A Optional This is the middle name of the applicant. Only English alphabet letters, space, apostrophe, Accent Grave ("`"), period and hyphen.Max length - 50 symbols.Space characters at the start or end of the name should be cut off.
LAST NAME string Doe Required This is the last name of the applicant. Only English alphabet letters, space, apostrophe, Accent Grave ("`") and hyphen.Max length - 50 symbols.Space characters at the start or end of the name should be cut off.
BIRTH DATE string 1985-12-01 Required This is the date of birth of the applicant. YYYY-MM-DD is expected. hyphen allowed.
SOCIAL SECURITY NUMBER Numeric 1234 Required This is the social security number of the applicant. You may pass 4 or 9 digits based on the state requirement configured in Telgoo5. No hyphen allowed
QUALIFYING BENEFICIARY SAME AS CUSTOMER string N Required This determines the qualifying beneficiary details same as customer. 'Y' or 'N'
BENEFICIARY SUFFIX NAME string Jr. Optional This is the suffix name of the beneficiary. Only allow Jr. or Sr. or II or III or IV or V.
BENEFICIARY FIRST NAME string John Conditional if qualifying beneficiary same as customer then Y then required. This is the first name of the qualifying beneficiary Only English alphabet letters, space, apostrophe, Accent Grave ("`") and hyphen. Max length - 50 symbols. Space characters at the start or end of the name should be cut off.
BENEFICIARY MIDDLE NAME string A Optional This is the middle name of the qualifying beneficiary Only English alphabet letters, space, apostrophe, Accent Grave ("`") and hyphen. Max length - 50 symbols. Space characters at the start or end of the name should be cut off.
BENEFICIARY LAST NAME string Doe Conditional if qualifying beneficiary same as customer then Y is required. This is the last name of the qualifying beneficiary. Only English alphabet letters, space, apostrophe, Accent Grave ("`") and hyphen. Max length - 50 symbols. Space characters at the start or end of the name should be cut off.
BENEFICIARY BIRTHDATE string 1985-12-01 Conditional if qualifying beneficiary same as customer then Y is required. This is the date of birth of the applicant. YYYY-MM-DD is expected.
BENEFICIARY SOCIAL SECURITY NUMBER Numeric 1234 Conditional if qualifying beneficiary same as customer then Y is required. This is the social security number of the beneficiary. You may pass 4 or 9 digits based on the state requirement configured in Telgoo5. No hyphen allowed. beneficiary SSN/Tribal ID is required.
BENEFICIARY TRIBAL ID string 242343 Conditional if qualifying beneficiary same as customer then Y is required. This is the tribal ID of the beneficiary. No hyphen allowed. beneficiary SSN/Tribal ID is required
BEST WAY TO REACH YOU? string phone Required Email, phone, text message, mail enter anyone same text or all same text with comma Separated for the best way to reach you. email, phone, text message, mail
ALTERNATE EMAIL ADDRESS string noemail@gmail.com Optional This is the email address of the applicant.
ALTERNATE CONTACT PERSON string John Doe Optional This is the name of a friend or family of which alternate contact person is provided space is allowed
ALTERNATE CONTACT NUMBER string 1234567890 Optional This is alternate telephone number of the applicant. hyphen not allowed
SERVICE ADDRESS1 string 123 Main St Required This is the service address line 1 of the applicant. Should allow only letters, numbers, space and: hyphen ; forward slash Max length for the fields - 50 symbols. Cannot contain phrases "PO Box" or "P.O. Box".
SERVICE ADDRESS2 string Apt 1 Optional This is the service address line 2 of the applicant. Should allow only letters, numbers, space and: hyphen ; forward slash Max length for the fields - 50 symbols. Cannot contain phrases "PO Box" or "P.O. Box".
SERVICE CITY string Houston Required This is the service address city of the applicant. Should allow only letters, hyphen and space.
SERVICE STATE string TX Required This is the service address state of the applicant. State should be standard abbreviated form.
SERVICE ZIPCODE Numeric 73001 Required This is the service address zipcode of the applicant. Should not allow letters and special characters, only numbers. Should be exactly 5 digits.
MAILING ADDRESS1 string 123 Main St Required This is the mailing address line 1 of the applicant. Should allow only letters, numbers, space and: hyphen ; forward slash Max length for the fields - 50 symbols. Cannot contain phrases "PO Box" or "P.O. Box".
MAILING ADDRESS2 string Apt 1 Optional This is the mailing address line 2 of the applicant. Should allow only letters, numbers, space and: hyphen ; forward slash Max length for the fields - 50 symbols. Cannot contain phrases "PO Box" or "P.O. Box".
MAILING CITY string Houston Required This is the mailing address city of the applicant. Should allow only letters, hyphen and space.
MAILING STATE string TX Required This is the mailing address state of the applicant. State should be standard abbreviated form.
MAILING ZIPCODE Numeric 73001 Required This is the service address zipcode of the applicant. Should not allow letters and special characters, only numbers. Should be exactly 5 digits.
PROGRAM CODE string SNAP Conditional These are returned in getProgramIncomeList XML API. If an applicant qualify on low income basis, you may pass empty tag and INCOMECERTIFY tag becomes Required. Multiple values example FPH::MEDIC::SNAP
INCOME BASE Numeric 135 Conditional This needs to be passed if ProgramCode is income '135' or '150'
ADDRESS TYPE string N Required This is used to determine if the applicants address is temporary or permanent.'Y' is considered as the temporary address and 'N' is for the permanent address 'Y' or 'N'
TRIBAL string N Required This determines the tribal flag status. 'Y' or 'N'
HOUSEHOLD COUNT Numeric 2 Optional This determines the number of individuals living in the same household. This is require when applicant qualify based on low income. This tag becomes Required when INCOMECERTIFY has a value. Numeric
HOUSEHOLD? string Y Optional This determines if there are mulitiple households on the address or not. If this then Y is you are required to pass the values all the Household requirements in different household tags.. 'Y' or 'N'
CLAIM NUMBER OR PROOF ID NUMBER string 854AB21214 Optional Claim number from the qualifying proof document applicant showcased during the enrollment.
ISSUE DATE ON PROOF string 1987-02-25 Optional Proof issue date of the proof document applicant showcased during enrollment. YYYY-MM-DD
EXPIRATION DATE ON PROOF string 1987-02-25 Optional Eligibility proof expiration date of the proof document applicant showcased during enrollment. YYYY-MM-DD
PLAN ID string 1315 Conditional This is the plan id on which subscriber will be on. The plan id list is returned in API GetPlanService api.  
EnrollmentType string Handover Required This determines the type of enrollment. Handover: if enrollment type is handover then status should be approved and you need to pass the ESN/MDN/IMEI
Shipment: if enrollment type is shipment then status should be either pending/approved and you don't need to pass ESN/MDN/IMEI. Those will be attached to the account via dropship process
HOUSEHOLD LIFE LINE string Y Conditional This is the response to the IEH worksheet question. Y or N
ADULT string Y Conditional This is the response to the IEH worksheet question. If an adult lives on the address Y or N These are to be dermined by ETC on the basis of IEH worksheet
SHARE string N Conditional If you share the income and expenses with the adult who lives with you then Y else N These are to be dermined by ETC on the basis of IEH worksheet
CERTIFI1 string Y Conditional If IEH worksheet questions answers are compliant then you need to pass the responses to the IEH certification statement Y or N These are to be dermined by ETC on the basis of IEH worksheet
CERTIFI2 string Y Conditional If IEH worksheet questions answers are compliant then you need to pass the responses to the IEH certification statement Y or N These are to be dermined by ETC on the basis of IEH worksheet
DSHS CLIENT ID # Numeric 555698789 Optional This is only applicable when subscriber is from the state of WA (washington). should be 9 digits
CUSTOMER INFOMATR / DCN ID # Numeric 5556987890 Optional This is only applicable when subscriber is from the state of MO (Missouri). Should be min 6 or max 20 digits
DRIVER LICENSE NUMBER Numeric DL01235 Optional This is only applicable when subscriber have driver license number.
IS MELISSA CHECK REQUIRED string N Optional This determines the isMellisaCheck flag. 'Y' or 'N'
RURAL string N Optional This determines if the subscriber is on rural address. 'Y' or 'N'
IS WEB PARTNER characters Y Optional If Y => 'SU' prefix for the EID. 'Y' or 'N'
IP ADDRESS string 110.110.110.2 Optional ip address of your system
CUSTOMER CLASSIFICATION ID Numeric 2 Optional This is customer classification id returned in another API response called "CustomerClassification". This is returned in api response tag = id. Example ::
ID=>CATEGORY ::
2=>Gold Customer
3=>Privileged Customer
4=>Silver Customers
CUSTOMER PASSWORD string John@Doe Conditional The password have to be number, letter, following special charector -_%$#*,.;=<>?:{}|+)(&^@!~ and 4 to 8 characters Example : John@Doe
SERVICE TYPE string LIFELINE, ACO and COMBO Required This determines the type of service type. Service type should be LIFELINE,ACP and COMBO. Default value LIFELINE
AGENTID string John Doe Required
This is the Telgoo5 user id.For the Agent/Employee who is sending the API request.
  
AGENTPASSWORD string JohnDoe Conditional This is the password for the Agent Id mentioned above. This is configuration level field. If you have set the permissions for the Agent Id for the requirement of the password in API transactions then you will need to pass the Agent Password in all the XML API transaction, else if you have set the permissions to password not required then you don't need to pass the Agent Password in the XML API.  
SOURCE string API Optional Source of the order/application/API call Expected Value:API, TABLET, IVR, WEBSITE, CSR
Sample Request
<?xml version="1.0" encoding="utf-8"?>
<VCAREOSSAPI xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<CREDENTIALS>
<VENDORID></VENDORID>
<USERNAME></USERNAME>
<PASSWORD></PASSWORD>
<PIN></PIN>
<REFERENCENUMBER></REFERENCENUMBER>
</CREDENTIALS>
<VCAREOSS>
<CREATECUSTOMER>
	<COMPANY_ID></COMPANY_ID>
	<ENROLLMENTID></ENROLLMENTID>
	<SUFFIX_NAME></SUFFIX_NAME>
	<FIRSTNAME></FIRSTNAME>
	<MIDDLENAME></MIDDLENAME>
	<LASTNAME></LASTNAME>
	<DOB></DOB>
	<SSN></SSN>
	<BENEFICIARYSAMEASCUSTOMER></BENEFICIARYSAMEASCUSTOMER>
	<BENEFICIARYSUFFIX></BENEFICIARYSUFFIX>
	<BENEFICIARYFIRSTNAME></BENEFICIARYFIRSTNAME>
	<BENEFICIARYMIDDLENAME></BENEFICIARYMIDDLENAME>
	<BENEFICIARYLASTNAME></BENEFICIARYLASTNAME>
	<BENEFICIARYDOB></BENEFICIARYDOB>
	<BENEFICIARYSSN></BENEFICIARYSSN>
	<BENEFICIARYTRIBALID></BENEFICIARYTRIBALID>
	<BESTWAYTOREACH></BESTWAYTOREACH>
	<ALTERNATIVEEMAIL></ALTERNATIVEEMAIL>
	<ALTERNATIVECONTACTNUMBER></ALTERNATIVECONTACTNUMBER>
	<ALTERNATIVECONTACTNAME></ALTERNATIVECONTACTNAME>
	<PHYSICALADDRESS>
		<ADDRESS1></ADDRESS1>
		<ADDRESS2></ADDRESS2>
		<CITY></CITY>
		<STATE></STATE>
		<ZIP></ZIP>
	</PHYSICALADDRESS>
	<MAILINGADDRESS>
		<ADDRESS1></ADDRESS1>
		<ADDRESS2></ADDRESS2>
		<CITY></CITY>
		<STATE></STATE>
		<ZIP></ZIP>
	</MAILINGADDRESS>
	<LIFELINE>
		<PROGRAMCODE></PROGRAMCODE>
		<INCOMECERTIFY></INCOMECERTIFY>
		<TEMPORARYADDRESS></TEMPORARYADDRESS>
		<TRIBAL></TRIBAL>
		<HOUSEHOLDCOUNT></HOUSEHOLDCOUNT>
		<MULTIPLEHOUSEHOLDS></MULTIPLEHOUSEHOLDS>
	</LIFELINE>
	<CLAIMNUMBER></CLAIMNUMBER>
	<ISSUEDATEONPROOF></ISSUEDATEONPROOF>
	<EXPIRATIONDATEONPROOF></EXPIRATIONDATEONPROOF>
	<PLANID></PLANID>
	<ENROLLMENTTYPE></ENROLLMENTTYPE>
	<HOUSEHOLDLIFELINE></HOUSEHOLDLIFELINE>
	<ADULT></ADULT>
	<SHARE></SHARE>
	<CERTIFI1></CERTIFI1>
	<CERTIFI2></CERTIFI2>
	<DSHSCLIENTID></DSHSCLIENTID>
	<CUSTOMERINFOMATR></CUSTOMERINFOMATR>
	<ADDRESSVALIDATION></ADDRESSVALIDATION>
	<DRIVER_LICENSE_NUMBER></DRIVER_LICENSE_NUMBER>
	<ISRURAL></ISRURAL>
	<ISWEBPARTNER></ISWEBPARTNER>
	<IPADDRESS></IPADDRESS>
	<CUSTOMERCLASSIFICATION_ID></CUSTOMERCLASSIFICATION_ID>
	<CUSTOMERPASSWORD></CUSTOMERPASSWORD>
	<SERVICETYPE></SERVICETYPE>
	<AGENTLOGIN></AGENTLOGIN>
	<AGENTPASSWORD></AGENTPASSWORD>
	<SOURCE></SOURCE>
  </CREATECUSTOMER>
</VCAREOSS>
</VCAREOSSAPI>
List of status code, description and resolution.
Status Code Description How to Resolve?
00 SUCCESS SUCCESS
10 You cannot enroll with this resident address because it has the maximum number of allowable households with active Lifeline service. You are exceeding max number of lifeline enrollemt for this resident address.
13 Password is invalid. Provide a valid Password.
16 Vendor not found. Wrong credentials. Please enter valid vendor credentials.
19 Service is not available for this Zip Code. No service for the provided Zip Code. Please enter the right Zip code.
43 Multiple input errors. Please check description. This is providing multiple dynamic errors.
44 Input error. Please check description. This is provided dynamic error.
46 Internal duplicate. Provide another data.
55 Invalid agent login. Please provide valid agent login.
56 Internal duplicate checking API is down. Please try again later. Internal duplicate checking API is down. Please try again later.
59 Invalid Enrollment ID. Please provide valid Enrollment ID.
68 Invalid income base level. Please provide valid income base level.
84 Invalid program code. Please provide a valid program code.
85 Invalid Proof ID. Please provide a valid Proof ID.
230 Address is unconfirmed from Melissa. Please provide a different address which can be unconfirmed from Melissa.
244 NLAD verification failed. NLAD verification failed.
273 Service address is business address. Please provide different Service address as given address is business address.
287 System error found please verify your data and retry again. Please verify your data and retry again.
356 Agent ID cannot be blank. Please provide Agent ID as it cannot be blank.
457 Invalid Source. Please provide a valid Source. Given value is invalid for Source.
595 should be Y OR N. <VALUE> should be Y OR N. <VALUE> is a dynamic value.
678 Service and mailing address state should be same. Service and mailing address state should be same.
683 Duplicate claim number. Please try again as It is a duplicate claim number.
732 Please enter valid suffix. example : Jr. OR Sr. OR II OR III OR IV OR V. Provide correct suffix. Please enter valid suffix. example : Jr. OR Sr. OR II OR III OR IV OR V.
Sample Response
	Response I [Without Enrolled in NLAD]
	<?xml version="1.0" encoding="utf-8"?>
 <VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
   <vendorId></vendorId>
   <referenceNumber></referenceNumber>
</credentials>
<createCustomer>
   <statusCode>00</statusCode>
   <description>SUCCESS</description>
   <errorDescription>SUCCESS</errorDescription>
   <enrollmentId></enrollmentId>
   <customerId></customerId>
   <mdn></mdn>
</createCustomer>

</VcareOssApi>

Response II [With Enrolled in NLAD]

<?xml version="1.0" encoding="utf-8"?>
   <VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <credentials>
	   <vendorId></vendorId>
	   <referenceNumber></referenceNumber>
   </credentials>
   <CreateCustomer>
	   <statusCode>00</statusCode>
	   <description>SUCCESS</description>
	   <errorDescription>SUCCESS</errorDescription>
	   <enrollmentId></enrollmentId>
	   <nladstatus></nladstatus>
	   <nladresponse></nladresponse>
	   <DUMMY_MDN_FORM_TABLE></DUMMY_MDN_FORM_TABLE>
	   <nlad_status_enroll><nlad_status_enroll>
   </CreateCustomer>
 </VcareOssApi>
SUCCESS
Sample Fail Response: 1
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>10</statusCode>
	<description>FAIL</description>
	<errorDescription>You cannot enroll with this resident address because it has the maximum number of allowable households with active Lifeline service.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: You cannot enroll with this resident address because it has the maximum number of allowable households with active Lifeline service.
How to Resolve?: You are exceeding max number of lifeline enrollemt for this resident address.
Sample Fail Response: 2
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>13</statusCode>
	<description>FAIL</description>
	<errorDescription>Password is invalid.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: Password is invalid.
How to Resolve?: Provide a valid Password.
Sample Fail Response: 3
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>16</statusCode>
	<description>FAIL</description>
	<errorDescription>Vendor not found. Wrong credentials.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: Vendor not found. Wrong credentials.
How to Resolve?: Please enter valid vendor credentials.
Sample Fail Response: 4
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>19</statusCode>
	<description>FAIL</description>
	<errorDescription>Service is not available for this Zip Code.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: Service is not available for this Zip Code.
How to Resolve?: No service for the provided Zip Code. Please enter the right Zip code.
Sample Fail Response: 5
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>43</statusCode>
	<description>FAIL</description>
	<errorDescription>Multiple input errors.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: Multiple input errors.
How to Resolve?: Please check description. This is providing multiple dynamic errors.
Sample Fail Response: 6
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>44</statusCode>
	<description>FAIL</description>
	<errorDescription>Input error.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: Input error.
How to Resolve?: Please check description. This is provided dynamic error.
Sample Fail Response: 7
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>46</statusCode>
	<description>FAIL</description>
	<errorDescription>Internal duplicate.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: Internal duplicate.
How to Resolve?: Provide another data.
Sample Fail Response: 8
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>55</statusCode>
	<description>FAIL</description>
	<errorDescription>Invalid agent login.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: Invalid agent login.
How to Resolve?: Please provide valid agent login.
Sample Fail Response: 9
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>56</statusCode>
	<description>FAIL</description>
	<errorDescription>Internal duplicate checking API is down. Please try again later.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: Internal duplicate checking API is down. Please try again later.
How to Resolve?: Internal duplicate checking API is down. Please try again later.
Sample Fail Response: 10
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>59</statusCode>
	<description>FAIL</description>
	<errorDescription>Invalid Enrollment ID.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: Invalid Enrollment ID.
How to Resolve?: Please provide valid Enrollment ID.
Sample Fail Response: 11
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>68</statusCode>
	<description>FAIL</description>
	<errorDescription>Invalid income base level.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: Invalid income base level.
How to Resolve?: Please provide valid income base level.
Sample Fail Response: 12
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>84</statusCode>
	<description>FAIL</description>
	<errorDescription>Invalid program code.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: Invalid program code.
How to Resolve?: Please provide a valid program code.
Sample Fail Response: 13
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>85</statusCode>
	<description>FAIL</description>
	<errorDescription>Invalid Proof ID.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: Invalid Proof ID.
How to Resolve?: Please provide a valid Proof ID.
Sample Fail Response: 14
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>230</statusCode>
	<description>FAIL</description>
	<errorDescription>Address is unconfirmed from Melissa.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: Address is unconfirmed from Melissa.
How to Resolve?: Please provide a different address which can be unconfirmed from Melissa.
Sample Fail Response: 15
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>244</statusCode>
	<description>FAIL</description>
	<errorDescription>NLAD verification failed.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: NLAD verification failed.
How to Resolve?: NLAD verification failed.
Sample Fail Response: 16
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>273</statusCode>
	<description>FAIL</description>
	<errorDescription>Service address is business address.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: Service address is business address.
How to Resolve?: Please provide different Service address as given address is business address.
Sample Fail Response: 17
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>287</statusCode>
	<description>FAIL</description>
	<errorDescription>System error found please verify your data and retry again.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: System error found please verify your data and retry again.
How to Resolve?: Please verify your data and retry again.
Sample Fail Response: 18
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>356</statusCode>
	<description>FAIL</description>
	<errorDescription>Agent ID cannot be blank.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: Agent ID cannot be blank.
How to Resolve?: Please provide Agent ID as it cannot be blank.
Sample Fail Response: 19
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>457</statusCode>
	<description>FAIL</description>
	<errorDescription>Invalid Source.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: Invalid Source.
How to Resolve?: Please provide a valid Source. Given value is invalid for Source.
Sample Fail Response: 20
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>595</statusCode>
	<description>FAIL</description>
	<errorDescription> should be Y OR N.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: should be Y OR N.
How to Resolve?: <VALUE> should be Y OR N. <VALUE> is a dynamic value.
Sample Fail Response: 21
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>678</statusCode>
	<description>FAIL</description>
	<errorDescription>Service and mailing address state should be same.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: Service and mailing address state should be same.
How to Resolve?: Service and mailing address state should be same.
Sample Fail Response: 22
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>683</statusCode>
	<description>FAIL</description>
	<errorDescription>Duplicate claim number.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: Duplicate claim number.
How to Resolve?: Please try again as It is a duplicate claim number.
Sample Fail Response: 23
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
	<CreateCustomer>
	<statusCode>732</statusCode>
	<description>FAIL</description>
	<errorDescription>Please enter valid suffix. example : Jr. OR Sr. OR II OR III OR IV OR V.</errorDescription>
</CreateCustomer>
</VcareOssApi>
Error Description: Please enter valid suffix. example : Jr. OR Sr. OR II OR III OR IV OR V.
How to Resolve?: Provide correct suffix. Please enter valid suffix. example : Jr. OR Sr. OR II OR III OR IV OR V.

All the status codes are listed under the status code sections. Please click here to go to the status code.