dxp-ux
TMF-666
Retrieve Account Details(TMF666)
/billingAccount/{id}
[GET]
This operation retrieves a billing account entity used by billingAccountNumber or msisdn or client account id or BAN-CAN.
Key considerations for DC markets.
Account status will be derived using the offers linked to account. if any of the Suspended offers are present in account, then the account state would be considered as "Suspended". Below are the offers list.
|OFFER_ID |DISPLAY_VALUE |
|---------|-----------------|
|51002454 |CUR Wireline Barring|
|51006038 |CUR Wireless Barring |
|51006040 |CUR Wireless CHCO Barring |
|51006047 |SXM Wireless Barring |
|51006143 |CUR Data Connectivity Barring |
|51007682 |CUR Wireless CHCO Barring up to 10 Members |
|51007683 |CUR Wireless CHCO Barring 11 to 50 Members |
|51007688 |BES Wireless CHCO Barring up to 10 Members |
|51009190 |CUR Wireless Disconnection Fees for Collections |
|51009192 |BES Wireless Disconnection Fees for Collections |
|51009694 |SXM Wireless Disconnection Fees for Collections |
|51009695 |FSXM Wireless Disconnection Fees for Collections |
|51010077 |CUR Disconnection Fees for Collections |
|51010078 |BES Wireline Disconnection Fees for Collections |
|51010079 |SXM Wireline Disconnection Fees for Collections |
|51010080 |FSXM Wireline Disconnection Fees for Collections
URL
```http
```
URL PARAMS
| name | type | description | required |
| ---------- | ------ | ------------------------------------------------------------ | -------- |
| businessId | string | 2 letter ISO 3166 country code (TT, BB, JM, PA, PR etc.) identifying the business unit. Expected one is "PR"-Puerto Rico | Y |
| id | string | To retrieve 'account' information provide Billing Account Number or msisdn To retrieve 'balance' information provide account number. Example: msisdn: 17874047209,billingAccountNumber: 33541396-33542750 | Y |
Header
**Note:**
1.To retrieve 'balance' information need to pass 'targetSystem'.
2.To retrieve 'account' information need to pass 'lob'.
| name | value | description | required |
| ---------------- | ------ | ------------------------------------------------------------ | -------- |
| client_id | string | The client_id identifying the channel. | Y |
| client_secret | string | Password associated with the client_id. | Y |
| X-Correlation-ID | string | An identifier for the current call chain that can be used to tie together log entries on multiple layers (e.g. client, server, mainframe). This identifier must be designed to be unique across all applications. **Note** - Mule default behavior creates a sample x-correlation-id field if value is not passed from client, API will use this value in case value is not passed in API request| N It is Mandatory for business |
|channelId |string | Expected value APP | Y |
| lob | String | Enum: PREPAID, POSTPAID,FIXED Expected value : PREPAID, POSTPAID | Y |
|targetSystem | String | Expected value "aria". | Y |
Query Parameters
**Note:**
- To retrieve 'account' information need to pass 'extendedCharacteristics.name', 'extendedCharacteristics.value', 'type'.
| name | value | description | required |
| ---------------- | ------ | ------------------------------------------------------------ | -------- |
|extendedCharacteristics.name| string |Expected value is sourceSystem|Y |
|extendedCharacteristics.value| string | Expected value is Digital | Y |
|type | string | Need to pass 'billingAccountNumber' or 'msisdn' | Y |
[GET] Retrieve Balance Response - CSG FIXED
From this operation we can fetch Auto Pay is enabled or disabled, auto-pay date and day, Delinquency status, payment status and payment method EFT or Card.
**Note** In the response if PaymentPlan.planType is AutoPay Enable, AutoPay Date can be displayed in the extended Characteristics else AutoPay Date cannot be displayed.
**AutoPay Date Enable**
```json
{
"id": "8211990010018869",
"accountType": "RES",
"description": "MARIA VICTORIA MURILLO",
"lastModified": "2023-01-16T00:00:00.000Z",
"name": "MARIA VICTORIA MURILLO",
"paymentStatus": "",
"state": "NORMAL",
"accountBalance": [
{
"amount": {
"unit": "USD",
"value": -76.98
},
"balanceType": "ReceivableBalance",
"validFor": {
"startDateTime": "2023-01-16T00:00:00.000Z",
"endDateTime": "2023-02-15T00:00:00.000Z"
}
},
{
"amount": {
"unit": "USD",
"value": 80.00
},
"balanceType": "LastPaymentAmount",
"validFor": {
"endDateTime": "2022-12-26T00:00:00.000Z"
}
}
],
"accountRelationship": [
{
"relationshipType": "contains",
"account": {
"id": "8211990010018869",
"description": "RES MARIA VICTORIA MURILLO",
"name": "MARIA VICTORIA MURILLO",
"@type": "BillingAccount"
},
"validFor": {
"startDateTime": "2021-01-16T00:00:00.000Z",
"endDateTime": "2021-02-14T00:00:00.000Z"
}
}
],
"billStructure": {
"cycleSpecification": {
"name": "monthly Billing",
"dateShift": 16,
"frequency": "monthly"
},
"presentationMedia": [
{
"name": "Mail"
}
]
},
"contact": [
{
"contactName": "MARIA VICTORIA MURILLO",
"contactType": "Primary",
"partyRoleType": "Owner",
"contactMedium": [
{
"mediumType": "PostalAddress",
"preferred": true,
"ulmCharacteristic": {
"city": "SAN JUAN",
"country": "USA",
"postCode": "009171920",
"street1": "279 AVE PONCE DE LEON APT 2001"
},
"characteristic": {
"city": "SAN JUAN",
"country": "USA",
"postCode": "00917",
"street1": "279 AVE PONCE DE LEON APT 2001"
}
},
{
"mediumType": "Phone",
"characteristic": {
"contactType": "Home",
"phoneNumber": "7876552030"
}
},
{
"mediumType": "Phone",
"characteristic": {
"contactType": "Business",
"phoneNumber": "9059334010"
}
}
],
"relatedParty": {
"id": "6789",
"name": "MARIA VICTORIA MURILLO",
"role": "Owner",
"@type": "relatedParty"
}
}
],
"creditLimit": {
"unit": "USD",
"value": 100.00
},
"defaultPaymentMethod": {
"id": "E",
"name": "EFT"
},
"financialAccount": {
"id": "2063",
"accountBalance": {
"balanceType": "ReceivableBalance",
"amount": {
"unit": "USD",
"value": 16
},
"validFor": {
"startDateTime": "2023-01-16T00:00:00.000Z",
"endDateTime": "2023-02-15T00:00:00.000Z"
}
},
"@referredType": "financialAccount"
},
"paymentPlan": [
{
"paymentFrequency": "01",
"planType": "Auto Pay Enable"
}
],
"characteristic": [
{
"name": "DunningGroup",
"value": "090"
},
{
"name": "autoPayDate",
"value": "2023-02-03T00:00:00.000Z"
},
{
"name": "DebitDay",
"value": "03"
},
{
"name": "CreditScore",
"value": "A"
},
{
"name": "LocationId",
"value": "00917192001084"
}
],
"relatedParty": [
{
"id": "1101521721766",
"name": "MARIA VICTORIA MURILLO",
"role": "Customer",
"@referredType": "Customer"
}
],
"@type": "BillingAccount"}
```
**AutoPay Disable**
```json
{
"id": "8211990010018869",
"accountType": "RES",
"description": "MARIA VICTORIA MURILLO",
"lastModified": "2023-01-16T00:00:00.000Z",
"name": "MARIA VICTORIA MURILLO",
"paymentStatus": "",
"state": "NORMAL",
"accountBalance": [
{
"amount": {
"unit": "USD",
"value": -76.98
},
"balanceType": "ReceivableBalance",
"validFor": {
"startDateTime": "2023-01-16T00:00:00.000Z",
"endDateTime": "2023-02-15T00:00:00.000Z"
}
},
{
"amount": {
"unit": "USD",
"value": 80.00
},
"balanceType": "LastPaymentAmount",
"validFor": {
"endDateTime": "2022-12-26T00:00:00.000Z"
}
}
],
"accountRelationship": [
{
"relationshipType": "contains",
"account": {
"id": "8211990010018869",
"description": "RES MARIA VICTORIA MURILLO",
"name": "MARIA VICTORIA MURILLO",
"@type": "BillingAccount"
},
"validFor": {
"startDateTime": "2021-01-16T00:00:00.000Z",
"endDateTime": "2021-02-14T00:00:00.000Z"
}
}
],
"billStructure": {
"cycleSpecification": {
"name": "monthly Billing",
"dateShift": 16,
"frequency": "monthly"
},
"presentationMedia": [
{
"name": "Mail"
}
]
},
"contact": [
{
"contactName": "MARIA VICTORIA MURILLO",
"contactType": "Primary",
"partyRoleType": "Owner",
"contactMedium": [
{
"mediumType": "PostalAddress",
"preferred": true,
"characteristic": {
"city": "SAN JUAN",
"country": "USA",
"postCode": "009171920",
"street1": "279 AVE PONCE DE LEON APT 2001"
}
},
{
"mediumType": "Phone",
"characteristic": {
"contactType": "Home",
"phoneNumber": "7876552030"
}
}
],
"relatedParty": {
"id": "6789",
"name": "MARIA VICTORIA MURILLO",
"role": "Owner",
"@type": "relatedParty"
}
}
],
"creditLimit": {
"unit": "USD",
"value": 100.00
},
"defaultPaymentMethod": {
"id": "E",
"name": "EFT"
},
"financialAccount": {
"id": "2063",
"accountBalance": {
"balanceType": "ReceivableBalance",
"amount": {
"unit": "USD",
"value": 16
},
"validFor": {
"startDateTime": "2023-01-16T00:00:00.000Z",
"endDateTime": "2023-02-15T00:00:00.000Z"
}
},
"@referredType": "financialAccount"
},
"paymentPlan": [
{
"paymentFrequency": "01",
}
],
"characteristic": [
{
"name": "DunningGroup",
"value": "090"
},
{
"name": "CreditScore",
"value": "A"
},
{
"name": "LocationId",
"value": "00917192001084"
}
],
"relatedParty": [
{
"id": "1101521721766",
"name": "MARIA VICTORIA MURILLO",
"role": "Customer",
"@referredType": "Customer"
}
],
"@type": "BillingAccount"}
```
Response Data Model:
Each of the response parameters is detailed.
| name | type | description | required |
| ----------------------------------------------------- | ------- | ------------------------------------------------------------ | -------- |
| id | string | Billing Account Number (Salesforce Record Id) | N |
| accountType | string | A categorization of an account, Possible Value - RES | N |
| description | string | name of the account owner | N |
| name | string | name of the billing account | N |
| state | string | Contains the lifecycle state such as: "voluntary disconnect","Non-Pay Disc","Chard Off","NORMAL" | N |
|paymentStatus | string |The account's delinquency status or payment status may have the following values:, Possible Delinquency status values are NORMAL, C - VOLUNTARY DISC, E - NON-PAY DISC, A - OPEN NP EQPTACT, F - OPEN NP EQPT FT, P - PEND NP SVC RES,S - PND CHG SERV WO, T - PPV RESTRICTED, U - DWNGRD-SVCS, V - OPEN VOL DISC, W - OPEN NP EQPTDIS, Z -CHARGED OFF,OR payment status are "NORMAL","S" : Suspend, "B" : Balance is less than EFT minimum debit amount. The API will return a single character, such as "C" or "NORMAL," as obtained from CSG. The meaning of each character is given here for reference. | N |
| lastModified | string | Date of last modification of the account | N |
| accountBalance | array | Balances linked to the account | N |
| accountBalance.balanceType | string | Type of the balance ; DelinquentBalance, LastPaymentAmount, ReceivableBalance| N |
| accountBalance.amount | string | Balance amount| N |
| accountBalance.amount.unit | string | USD | N|
| accountBalance.validFor | object |A period, either as a deadline (endDateTime only) a startDateTime only, or both| N |
| accountBalance.validFor.endDateTime |datetime | End of the time period, using ISO 8601 format | N |
| accountBalance.validFor.startDateTime | datetime | Start of the period, using ISO 8601 format. If you define a start, you must also define an end | N|
| accountRelationship | array | Significant connection between accounts. For instance an aggregating account for a list of shop branches each having its billing account | N |
| accountRelationship.relationshipType | string | Type of relationship. | N |
| accountRelationship.account | object | An account may be a party account or a financial account. | N |
| accountRelationship.account.id | string | Unique identifier Id of the EntityDescriptionRef. | N |
| accountRelationship.account.description | string |Detailed description of the EntityDescriptionRef | N |
| accountRelationship.account.name | string | Name of the account. | N |
| accountRelationship.account.@type | string | When sub-classing, this defines the sub-class entity name | N |
| accountRelationship.validFor.endDateTime | datetime| End of the time period, using ISO 8601 format | N |
| accountRelationship.validFor.startDateTime | datetime| Start of the period, using ISO 8601 format. If you define a start, you must also define an end | N|
| billStructure | object | The structure of the bill for party accounts (billing or settlement). | N |
| billStructure.cycleSpecification | object | An attachment by value or by reference. | N |
| billStructure.cycleSpecification.name | string | Expected value "monthly Billing" "bi-monthly billing" | N |
| billStructure.cycleSpecification.dateShift | string | An offset of a billing/settlement date. The offset is expressed as number of days with regard to the start of the billing/settlement period. | N |
| billStructure.cycleSpecification.frequency | string | Possible values are "monthly" or "bi-monthly billing". | N |
| billStructure.presentationMedia.name | string | Possible values are "Mail""Email | N |
| contact | array | Contact point for a given account and accessed via some contact medium. | N |
| contact.name | string | name of the contact | N |
| contact.partyRoleType | string | Identifies what kind of party role type is linked to the contact Ex: Owner | N |
| contact.contactMedium | array | Indicates the contact medium that could be used to contact the party. Possible values are | N |
| contact.contactMedium.mediumType | string | Type of the contact medium, possible values are: "Phone" or "PostalAddress". | N |
| contact.contactMedium.preferred | boolean | If true, it indicates that it is the preferred contact medium. Ex: true,false | N |
| contact.contactMedium.characteristic | object | Any additional characteristic(s) of this contact medium. | N |
| contact.contactMedium.characteristic.contactType | string | if mediumType = "Phone" then possible values are "Home","Business" | N |
| contact.contactMedium.characteristic.city | string | The city | N |
| contact.contactMedium. characteristic.country | string | The country | N |
| contact.contactMedium. characteristic.postCode | string | Postcode | N |
| contact.contactMedium. characteristic.stateOrProvince | string | State or province | N |
| contact.contactMedium. characteristic.street1 | string | Describes the street | N |
| contact.contactMedium. characteristic.phoneNumber | string | phone number of the customer | N |
| contact.contactMedium. characteristic.emailAddress | string | email address of the customer | N |
| contact.relatedParty | object | Related Entity reference | N |
| contact.relatedParty.id | string | last 4 digits of SSN number | N |
| contact.relatedParty.name | string | name of the customer account | N |
| contact.relatedParty.@type | string | hard-coded as "relatedParty" | N |
| creditLimit | object | The maximum amount of money that may be charged to an account| N |
| creditLimit.unit | string | USD | N |
| creditLimit.value | integer | value | N |
| defaultPaymentMethod | object | The maximum amount of money that may be charged on an account| N |
| defaultPaymentMethod.id | string | Unique identifier ID of the default payment method. Possible values are "C" "E" "" | N |
| defaultPaymentMethod.name | integer | Payment Method Name.Possible values are "Credit Card" "EFT" "Non Default Payment Method" | N |
| financialAccount | array | AccountReceivable reference. An account of money owed by a party to another entity in exchange for goods or services that have been delivered or used. An account receivable aggregates the amounts of one or more party accounts (billing or settlement) owned by a given party. | N |
| financialAccount.id | string | Hard coded as "2063" | N |
| financialAccount.accountBalance | object |
| financialAccount.accountBalance.balanceType | string | Type of the balance ; DelinquentBalance, LastPaymentAmount, ReceivableBalance | N |
| financialAccount.accountBalance.amount | string | Balance amount| N |
| financialAccount.accountBalance.amount.unit | string | USD | N|
| financialAccount.accountBalance.validFor | object |A period, either as a deadline (endDateTime only) a startDateTime only, or both | N |
| financialAccount.accountBalance.validFor.endDateTime |datetime | End of the time period, using ISO 8601 format | N |
| financialAccount.accountBalance.validFor.startDateTime | datetime| start of the time period | N |
| financialAccount.@referredType | string | possible value is "financialAccount" | N |
| paymentPlan | array | A list of payment plans | N |
| paymentPlan.paymentFrequency | string | Frequency of the payments, such as monthly and bimonthly | N |
| paymentPlan.planType | string | status of autopsy. possible values are "Auto Pay Enable" , "Auto Pay Disable | N |
| characteristic | array | Describes a given characteristic of an object or entity through a name/value pair. | N |
| characteristics.name | string | Name of the characteristic."LocationId" "DunningGroup" "DelinquencyDays" "autoPayDate "DebitDay" "CreditScore" | N |
| characteristics.value | any | Value of the characteristic | N |
| relatedParty | array | Related Entity reference | N |
| relatedParty.id | string | CSG Customer Id | N |
| relatedParty.name | string | Customer name | N |
| relatedParty.role | string | role of the party. "customer" | N |
| relatedParty.@referredType | string | Reference type. "customer" | N |
| @type | string | Type of the reference. "BillingAccount" | N |
[ 200 ] **PREPAID Salesforce**
**Retrieving account details and autopay status for a PREPAID account from Salesforce using billingAccountNumber:**
Below is the response:
```json
{
"id": "31515070-31513558",
"href": "https://cwc--propeac01.sandbox.my.salesforce.com/0016300001MwDHbAAN",
"ratingType": "Prepaid",
"name": "Connection Fee Prepaid",
"state": "Active",
"contact": [
{
"contactType": "BillingAddress",
"contactMedium": [
{
"preferred": true,
"characteristic": {
"city": "San Juan",
"country": "US",
"postCode": "00921",
"stateOrProvince": "PR",
"street1": "767 Calle 31 S O",
"emailAddress": "mobileconnectionfee@gmail.com"
}
}
]
},
{
"contactType": "customerAccount",
"contactMedium": [
{
"preferred": true,
"characteristic": {
"city": "San Juan",
"country": "US",
"postCode": "00921",
"stateOrProvince": "PR",
"street1": "767 Calle 31 S O"
}
}
],
"relatedParty": {
"id": "0016300001MwDHaAAN",
"name": "Connection Fee Prepaid",
"@type": "CustomerAccountRef"
}
},
{
"name": "Connection Fee Prepaid",
"contactType": "Primary",
"contactMedium": [
{
"preferred": true,
"characteristic": {
"phoneNumber": "3765786457",
"emailAddress": "mobileconnectionfee@gmail.com"
}
}
]
}
],
"paymentPlan": [
{
"planType": "Auto Pay disabled",
"paymentMethod": {
"id": "a6I63000000DV0xEAG"
},
"extendedCharacteristic": [
{
"name": "methodType",
"value": "BrainTreeToken"
},
{
"name": "externalCustomerIdentifier",
"value": "639338417"
},
{
"name": "token",
"value": "cGF5bWVudG1ldGhvZF9jY19hOWFxemd0aA"
},
{
"name": "externalPaymentMethodIdentifier",
"value": "2"
},
{
"name": "isPrimary",
"value": "Y"
}
]
}
],
"billStructure": {
"presentationMedia": [
{
"name": "eBill disabled"
}
]
},
"extendedCharacteristics": [
{
"name": "msisdn",
"valueType": "array",
"value": [
"12112221058"
]
}
],
"@type": "BillingAccount",
"relatedParty": [
{
"id": "0016300001MwDHbAAN",
"@type": "SalesforceBillingAccountRef"
}
]}
```
Response Data Model:
Each of the request parameters is detailed.
| name | type | description | required |
| ----------------------------------------------------- | ------- | ------------------------------------------------------------ | -------- |
| id | string | Billing Account Number (Salesforce Record Id) | N |
| href | string | URL reference of the billing account in Salesforce | N |
| ratingType | string | payment type of the billing account and the options are:Prepaid Postpaid | N |
| name | string | name of the billing account | N |
| state | string | Status of the account:ActiveSuspendDisconnected | N |
| autopayEnabled | string | indicator of the Auto Pay enabled | N |
| extendedCharacteristics | array | A list of characteristics that characterize this billingAccount | N |
| extendedCharacteristics.name | string | Name of the characteristic Example: methodType,token,externalPaymentMethodIdentifier | N |
| extendedCharacteristics.value | any | The value of the characteristic Example: BrainTreeToken,639338417,2 | N |
| contact | array | Contact point for a given account and accessed via some contact medium. | N |
| contact.partyRoleType | string | Identifies what kind of party role type is linked to the contact Ex:Owner | N |
| contact.contactMedium | array | Indicates the contact medium that could be used to contact the party. | N |
| contact.contactMedium.preferred | boolean | If true, indicates that is the preferred contact medium. Ex: true,false | N |
| contact.contactMedium.characteristic | object | Any additional characteristic(s) of this contact medium. | N |
| contact.contactMedium.characteristic.city | string | The city | N |
| contact.contactMedium. characteristic.country | string | The country | N |
| contact.contactMedium. characteristic.postCode | string | Postcode | N |
| contact.contactMedium. characteristic.stateOrProvince | string | State or province | N |
| contact.contactMedium. characteristic.street1 | string | Describes the street | N |
| contact.contactMedium. characteristic.phoneNumber | string | phone number of the customer | N |
| contact.contactMedium. characteristic.emailAddress | string | email address of the customer | N |
| contact.relatedParty | object | Related Entity reference | N |
| contact.relatedParty.id | string | Customer Account Number (Salesforce Record Id) | N |
| contact.relatedParty.name | string | name of the Customer account | N |
| contact.relatedParty.@type | string | type of reference | N |
| contact.name | string | name of the contact | N |
| paymentPlan | array | A list of payment plans | N |
| paymentPlan.planType | string | status of autopay | N |
| paymentPlan.paymentMethod | object | A payment method reference | N |
| paymentPlan.paymentMethod.id | string | internal reference id of the payment method in Salesforce | N |
| paymentPlan.extendedCharacteristics | array | A list of characteristics that characterize the payment method details | N |
| paymentPlan.extendedCharacteristics.name | string | Name of the characteristic | N |
| paymentPlan.extendedCharacteristics.value | string | Value of the characteristic | N |
| @type | string | Type of the reference | N |
| relatedParty | array | Related Entity reference | N |
| relatedParty.id | string | Salesforce reference Id of the billing account | N |
| relatedParty.@type | string | Referencetype | N |
| relatedParty.id | string | consumerPIN value | N |
| relatedParty.role | string | role of the party | N |
| relatedParty.@type | string | Reference type | N |
**Retrieving account details for a PREPAID account from Salesforce using MSISDN:**
Below is the response:
```json
{
"contact": [
{
"name": "GUILHERME CLEVELAND",
"contactType": "Secondary",
"contactMedium": [
{
"preferred": true,
"characteristic": {
"city": "San Juan",
"country": "Colombia",
"postCode": "00907",
"stateOrProvince": "PR",
"street1": "1479 Ashford Avenue",
"phoneNumber": "+55 24 2104 8708",
"emailAddress": "guilherme.cleveland@orange.com"
}
}
]
}
],
"billStructure": {
"presentationMedia": [
{
"name": "eBill disabled"
}
]
},
"@type": "BillingAccount",
"relatedParty": [
{
"@type": "SalesforceBillingAccountRef"
}
]}
```
Response Data Model:
| name | type | description | required |
| ----------------------------------------------------- | ------- | ------------------------------------------------------------ | -------- |
| contact | array | Contact point for a given account and accessed via some contact medium. | N |
| contact.contactType | string | Indicates the type of contact | N |
| contact.contactMedium | array | Indicates the contact medium that could be used to contact the party. | N |
| contact.contactMedium.preferred | boolean | If true, indicates that is the preferred contact medium. | N |
| contact.contactMedium.characteristic | object | Any additional characteristic(s) of this contact medium. | N |
| contact.contactMedium.characteristic.city | string | The city | N |
| contact.contactMedium. characteristic.country | string | The country | N |
| contact.contactMedium. characteristic.postCode | string | Postcode | N |
| contact.contactMedium. characteristic.stateOrProvince | string | State or province | N |
| contact.contactMedium. characteristic.street1 | string | Describes the street | N |
| contact.contactMedium. characteristic.phoneNumber | string | phone number of the customer | N |
| contact.contactMedium. characteristic.emailAddress | string | email address of the customer | N |
| contact.name | string | name of the contact | N |
| @type | string | Type of the reference | N |
| relatedParty | array | Related Entity reference | N |
| relatedParty.id | string | Salesforce reference Id of the billing account | N |
| relatedParty.@type | string | Referencetype | N |
| billStructure | Object | | N |
| billStructure.presentationMedia | Array | | N |
| billStructure.presentationMedia.name | String | ebill flag indicator | N |
[ 200 ] **POSTPAID Salesforce**
**Retrieving account details and autopay status for a POSTPAID account from Salesforce using billingAccountNumber:**
Below is the response:
```json
{
"id": "21003695-21003694",
"href": "https://cwc--propeac01.sandbox.my.salesforce.com/0016300001MhqRXAAZ",
"ratingType": "Postpaid",
"name": "Prakash Prakash",
"state": "Active",
"contact": [
{
"contactType": "BillingAddress",
"contactMedium": [
{
"preferred": true,
"characteristic": {
"city": "San Juan",
"country": "US",
"postCode": "00907",
"stateOrProvince": "PR",
"street1": "1479 Ashford Avenue",
"emailAddress": "pra@com.com"
}
}
]
},
{
"contactType": "customerAccount",
"contactMedium": [
{
"preferred": true,
"characteristic": {
"city": "San Juan",
"country": "US",
"postCode": "00907",
"stateOrProvince": "PR",
"street1": "1479 Ashford Avenue"
}
}
],
"relatedParty": {
"id": "0016300001MhqRWAAZ",
"name": "Prakash Prakash",
"@type": "CustomerAccountRef"
}
},
{
"name": "Prakash Prakash",
"contactType": "Primary",
"contactMedium": [
{
"preferred": true,
"characteristic": {
"phoneNumber": "7655454545",
"emailAddress": "pra@com.com"
}
}
]
}
],
"paymentPlan": [
{
"planType": "Auto Pay enabled",
"paymentMethod": {
"id": "a6I63000000DTq7EAG"
},
"extendedCharacteristic": [
{
"name": "methodType",
"value": "BrainTreeToken"
},
{
"name": "externalCustomerIdentifier",
"value": "163429995"
},
{
"name": "token",
"value": "cGF5bWVudG1ldGhvZF9jY18yZ3NjZ2Zzeg"
},
{
"name": "isPrimary",
"value": "Y"
}
]
}
],
"billStructure": {
"presentationMedia": [
{
"name": "eBill disabled"
}
]
},
"extendedCharacteristics": [
{
"name": "msisdn",
"valueType": "array",
"value": [
"17874031934"
]
}
],
"@type": "BillingAccount",
"relatedParty": [
{
"id": "0016300001MhqRXAAZ",
"@type": "SalesforceBillingAccountRef"
}
]}
```
Response Data Model:
Each of the request parameters is detailed.
| name | type | description | required |
| ----------------------------------------------------- | ------- | ------------------------------------------------------------ | -------- |
| id | string | Billing Account Number (Salesforce Record Id) | N |
| href | string | URL reference of the billing account in Salesforce | N |
| ratingType | string | payment type of the billing account and the options are:Prepaid Postpaid | N |
| name | string | name of the billing account | N |
| state | string | Status of the account:ActiveSuspendDisconnected | N |
| autopayEnabled | string | indicator of the Auto Pay enabled | N |
| extendedCharacteristics | array | A list of characteristics that characterize this billingAccount | N |
| extendedCharacteristics.name | string | Name of the characteristic | N |
| extendedCharacteristics.value | any | The value of the characteristic | N |
| contact | array | Contact point for a given account and accessed via some contact medium. | N |
| contact.partyRoleType | string | Identifies what kind of party role type is linked to the contact | N |
| contact.contactMedium | array | Indicates the contact medium that could be used to contact the party. | N |
| contact.contactMedium.preferred | boolean | If true, indicates that is the preferred contact medium. | N |
| contact.contactMedium.characteristic | object | Any additional characteristic(s) of this contact medium. | N |
| contact.contactMedium.characteristic.city | string | The city | N |
| contact.contactMedium. characteristic.country | string | The country | N |
| contact.contactMedium. characteristic.postCode | string | Postcode | N |
| contact.contactMedium. characteristic.stateOrProvince | string | State or province | N |
| contact.contactMedium. characteristic.street1 | string | Describes the street | N |
| contact.contactMedium. characteristic.phoneNumber | string | phone number of the customer | N |
| contact.contactMedium. characteristic.emailAddress | string | email address of the customer | N |
| contact.relatedParty | object | Related Entity reference | N |
| contact.relatedParty.id | string | Customer Account Number (Salesforce Record Id) | N |
| contact.relatedParty.name | string | name of the Customer account | N |
| contact.relatedParty.@type | string | type of reference | N |
| contact.name | string | name of the contact | N |
| paymentPlan | array | A list of payment plans | N |
| paymentPlan.planType | string | status of autopay | N |
| paymentPlan.paymentMethod | object | A payment method reference | N |
| paymentPlan.paymentMethod.id | string | internal reference id of the payment method in Salesforce | N |
| paymentPlan.extendedCharacteristics | array | A list of characteristics that characterize the payment method details | N |
| paymentPlan.extendedCharacteristics.name | string | Name of the characteristic | N |
| paymentPlan.extendedCharacteristics.value | string | Value of the characteristic | N |
| @type | string | Type of the reference | N |
| relatedParty | array | Related Entity reference | N |
| relatedParty.id | string | Salesforce reference Id of the billing account | N |
| relatedParty.@type | string | Referencetype | N |
| relatedParty.id | string | consumerPIN value | N |
| relatedParty.role | string | role of the party | N |
| relatedParty.@type | string | Reference type | N |
**Retrieving account details and autopay status for a POSTPAID account from Salesforce using MSISDN:**
Below is the response:
```json
{
"href": "https://cwc--qapeac.sandbox.my.salesforce.com/0013K000012fb7dQAA",
"ratingType": "Postpaid",
"name": "Hilda C. Alvarez",
"state": "Active",
"characteristic": [
{
"value": "Y",
"name": "autoPaymentEnabled"
}
],
"contact": [
{
"contactType": "BillingAddress",
"contactMedium": [
{
"preferred": true,
"characteristic": {
"city": "San Juan",
"country": "US",
"postCode": "00911",
"stateOrProvince": "PR",
"street1": "110 Calle del Parque",
"emailAddress": "testconsentaddline5@care.com"
}
}
]
},
{
"contactType": "customerAccount",
"contactMedium": [
{
"preferred": true,
"characteristic": {
"city": "San Juan",
"country": "US",
"postCode": "00911",
"stateOrProvince": "PR",
"street1": "110 Calle del Parque"
}
}
],
"relatedParty": {
"id": "23540074",
"name": "Hilda C. Alvarez",
"@type": "CustomerAccountRef"
}
},
{
"name": "Hilda Alvarez",
"contactType": "Primary",
"contactMedium": [
{
"preferred": true,
"characteristic": {
"phoneNumber": "13453454364",
"emailAddress": "testconsentaddline5@care.com"
}
}
]
}
],
"paymentPlan": [
{
"paymentMethod": {
"id": "PM-a6I3K0000009JgzUAE"
},
"extendedCharacteristic": [
{
"name": "methodType",
"value": "BrainTreeToken"
},
{
"name": "externalCustomerIdentifier",
"value": "19553474953"
},
{
"name": "token",
"value": "cGF5bWVudG1ldGhvZF9jY184amYzaDVneA"
},
{
"name": "externalPaymentMethodIdentifier",
"value": "PM-a6I3K0000009JgzUAE"
},
{
"name": "isPrimary",
"value": "Y"
}
]
},
{
"paymentMethod": {
"id": "PM-MWJkZmQ4ZDUtYjRlNS"
},
"extendedCharacteristic": [
{
"name": "methodType",
"value": "BrainTreeToken"
},
{
"name": "externalCustomerIdentifier",
"value": "88822287153"
},
{
"name": "token",
"value": "cGF5bWVudG1ldGhvZF9jY19xOXpleWd0cg"
},
{
"name": "externalPaymentMethodIdentifier",
"value": "PM-MWJkZmQ4ZDUtYjRlNS"
},
{
"name": "isPrimary",
"value": "N"
}
]
},
{
"paymentMethod": {
"id": "PM-a6I3K0000009JiMUAU"
},
"extendedCharacteristic": [
{
"name": "methodType",
"value": "Bank Account"
},
{
"name": "externalCustomerIdentifier",
"value": "89213959036"
},
{
"name": "token",
"value": "cGF5bWVudG1ldGhvZF91c2JfajBzcDJqOWg"
},
{
"name": "externalPaymentMethodIdentifier",
"value": "PM-a6I3K0000009JiMUAU"
},
{
"name": "isPrimary",
"value": "N"
}
]
}
],
"billStructure": {
"presentationMedia": [
{
"name": "eBill disabled"
}
]
},
"extendedCharacteristics": [
{
"name": "msisdn",
"valueType": "array",
"value": [
"12218000634",
"12218000752"
]
}
],
"@type": "BillingAccount",
"relatedParty": [
{
"id": "0013K000012fb7dQAA",
"@type": "SalesforceBillingAccountRef"
},
{
"id": "1234",
"role": "CustomerSecurity",
"@type": "ConsumerPIN"
}
]}
```
Response Data Model:
Each of the request parameters is detailed.
| name | type | description | required |
| ----------------------------------------------------- | ------- | ------------------------------------------------------------ | -------- |
| href | string | URL reference of the billing account in Salesforce | N |
| ratingType | string | payment type of the billing account and the options are:Prepaid Postpaid | N |
| name | string | name of the billing account | N |
| state | string | Status of the account:ActiveSuspendDisconnected | N |
| autopayEnabled | string | indicator of the Auto Pay enabled | N |
| extendedCharacteristics | array | A list of characteristics that characterize this billingAccount | N |
| extendedCharacteristics.name | string | Name of the characteristic | N |
| extendedCharacteristics.value | any | The value of the characteristic | N |
| contact | array | Contact point for a given account and accessed via some contact medium. | N |
| contact.partyRoleType | string | Identifies what kind of party role type is linked to the contact | N |
| contact.contactMedium | array | Indicates the contact medium that could be used to contact the party. | N |
| contact.contactMedium.preferred | boolean | If true, indicates that is the preferred contact medium. | N |
| contact.contactMedium.characteristic | object | Any additional characteristic(s) of this contact medium. | N |
| contact.contactMedium.characteristic.city | string | The city | N |
| contact.contactMedium. characteristic.country | string | The country | N |
| contact.contactMedium. characteristic.postCode | string | Postcode | N |
| contact.contactMedium. characteristic.stateOrProvince | string | State or province | N |
| contact.contactMedium. characteristic.street1 | string | Describes the street | N |
| contact.contactMedium. characteristic.phoneNumber | string | phone number of the customer | N |
| contact.contactMedium. characteristic.emailAddress | string | email address of the customer | N |
| contact.relatedParty | object | Related Entity reference | N |
| contact.relatedParty.id | string | Customer Account Number (Salesforce Record Id) | N |
| contact.relatedParty.name | string | name of the Customer account | N |
| contact.relatedParty.@type | string | type of reference | N |
| contact.name | string | name of the contact | N |
| paymentPlan | array | A list of payment plans | N |
| paymentPlan.paymentMethod | object | A payment method reference | N |
| paymentPlan.paymentMethod.id | string | internal reference id of the payment method in Salesforce | N |
| paymentPlan.extendedCharacteristics | array | A list of characteristics that characterize the payment method details | N |
| paymentPlan.extendedCharacteristics.name | string | Name of the characteristic | N |
| paymentPlan.extendedCharacteristics.value | string | Value of the characteristic | N |
| @type | string | Type of the reference | N |
| relatedParty | array | Related Entity reference | N |
| relatedParty.id | string | Salesforce reference Id of the billing account | N |
| relatedParty.@type | string | Referencetype | N |
| relatedParty.id | string | consumerPIN value | N |
| relatedParty.role | string | role of the party | N |
| relatedParty.@type | string | Reference type | N |
[ 200 ] **ARIA Retrieve Balance Response**
**Retrieve the client account balance from Aria:**
Below is the response:
```json
{
"@type": "BillingAccount",
"relatedParty": [
{
"id": "123456-MA",
"@type": "MigratedAccountRef",
"name": "BAN"
}
],
"accountBalance": [
{
"amount": {
"unit": "USD",
"value": 0
}
}
],
"billStructure": {
"cycleSpecification": {
"paymentDueDateOffset": 0
}
},"extendedCharacteristics": [
{
"name": "billDate",
"value": "2023-03-10"
},
{
"name": "autoPayDate",
"value": "2023-03-10"
}
]}
```
Response data model:
| name | type | description | required |
| ----------------------------------------------------- | ------------- | ------------------------------------------------------------ | -------- |
| @type | string | When sub-classing, this defines the sub-class entity name and value refers to "BillingAccount" | Y |
| accountBalance | object Array | Balances linked to the account | Y |
| accountBalance.amount | object | Balance amount | Y |
| accountBalance.amount.unit | string | Currency (ISO4217 norm uses 3 letters to define the currency) | Y |
| accountBalance.amount.value | number, float | A positive floating point number | Y |
| relatedParty | Array | Related Entity reference | Y |
| relatedParty.id | string | Aria reference Id of the billing account | Y |
| relatedParty.@type | string | Referencetype | Y |
| relatedParty.name | string | relatedParty Name | Y |
| billStructure | Object | | Y |
| billStructure.cycleSpecification | object | | Y |
| billStructure.cycleSpecification.paymentDueDateOffset | number | number of days between bill date and current date | Y |
| extendedCharacteristics | array | extendedCharacteristics. Example: billDate, autoPayDate | Y |
| extendedCharacteristics.value | any | name of the characteristics | Y |
| extendedCharacteristics.name | string | value of the characteristics | Y |
Possible Error Scenarios: :
IF WE ARE PASSING INVALID MSISDN IN URIPARAMS
```json
{
"errors": [
{
"code": 400,
"message": "SF:GET_BillingAccount_BY_ID",
"description": "MSISDN provided is not valid"
}
]}
```
INVALID URL
```json
{
"errors": [
{
"code": 404,
"message": "APIKIT:NOT_FOUND",
"description": "/PR/billingAccounts/CUSTOMER_8011"
}
]}
```
INVALID CHANNELID
```json
{
"errors": [
{
"code": 501,
"message": "Not implemented",
"description": "Operation GET for Business Id: PR and channelId:ECOM not implemented"
}
]}
```
Expected values for CSG FIXED Auto Pay
For paymentStatus below are expected fields Delinquency Status or Payment Status
**Delinquency Status**
|Mule Field Value |BSS Field Value| Description|
|----|----|---|
|NORMAL |“” or null| NORMAL|
|C| C |VOLUNTARY DISC|
|E| E |NON-PAY DISC|
|A| A| OPEN NP EQPTACT|
|F| F |OPEN NP EQPT FT|
|P| P| PEND NP SVC RES|
|S| S |PND CHG SERV WO|
|T| T |PPV RESTRICTED|
|U| U |DWNGRD-SVCS|
|V| V |OPEN VOL DISC|
|W| W |OPEN NP EQPTDIS|
|Z| Z| CHARGED OFF|
**Payment Status**
|Mule Field Value |BSS Field Value| Description|
|-------------------|---------------|-------------|
|NORMAL |“” or null| NORMAL|
|S | S | Suspended |
|B | B | Balance is less than EFT minimum debit amount |
|D | D | Debit Error |
|E | E | Prenote Error |
|G | G | EFT debit had been sent to ACH processor |
|P | P | Prenote Error |
|W | W | Waiting |
List billingAccount (TMF666)
/billingAccount
[GET]
This operation retrieves a billing account entity used by identityType & identityNumber or locationId.
URL
https://[localhost]:[port]/dxp-ux/v1/{businessId}/billingAccountURL PARAMS
| name | type | description | required |
|---|---|---|---|
| businessId | string | 2 letter ISO 3166 country code (PR, JM, PA, etc.) identifying the business unit. | Y |
Header
NOTE: To retrieve debit check details based on SSN need to pass "x-tax-identifier"
| name | value | description | required |
|---|---|---|---|
| client_id | string | The client_id identifying the channel. Minimum characters: 5 | Y |
| client_secret | string | Password associated with the client_id. Minimum characters: 5 | Y |
| x-tax-identifier | string | Tax identifier value/ SSN. This is encrypted value. | N |
| channeId | string | Channel to identify the business group. Can be: "APP" | M |
| Correlation-ID | string | An identifier for the current call chain that can be used to tie together log entries on multiple layers (e.g. client, server, mainframe). This identifier must be designed to be unique across all applications. Pattern: ^[a-zA-Z0-9-+/=_]{16,64}$ Minimum characters: 16 Maximum characters: 64 | N |
| lob | String | Enum: PREPAID, POSTPAID,FIXED Expected value : FIXED | O |
Query Param
NOTE: To retrieve debit check details based on Location ID need to pass "locationId "
| name | type | description | required |
|---|---|---|---|
| identityType | string | Describes the type of the id. Eg: "SSN" | N |
| balanceCheck | boolean | Flag for customer account debt information. API will return customer accounts balance if this flag is true. | N |
Response
In this section all the possible data structures received by the client at the moment of responding the method are defined.
Possible response success
[ 200 ]
From this operation we can fetch Auto Pay is enabled or disabled, auto pay date and day, Delinquency status, payment status.
Note In the response if PaymentPlan.planType is AutoPay Enable, AutoPay Date can be dislpayed in the extended Characteristics else AutoPay Date cannot be displayed.
By SSN (x-tax-idenitfier)
AutoPay Enable for debtCheck by SSN
[
{
"id": "8211990010009223",
"name": "TIVO APP TEST LIBERTY GO",
"@type": "BillingAccount",
"accountType": "RES",
"state": "E",
"paymentStatus": "E",
"paymentPlan": [
{
"planType": "Auto Pay Enable"
}
],
"accountBalance": [
{
"amount": {
"unit": "USD",
"value": -135.33
},
"balanceType": "AccountBalance",
"validFor": {
"startDateTime": "2022-12-13",
"endDateTime": "2023-01-12"
}
},
{
"amount": {
"unit": "USD",
"value": 0.00
},
"balanceType": "DelinquentBalance"
}
],
"creditLimit": {
"unit": "USD",
"value": 100.00
},
"contact": [
{
"contactName": "TIVO APP TEST LIBERTY GO",
"contactMedium": [
{
"mediumType": "Address",
"preferred": true,
"characteristic": {
"contactType": "BillingAddress",
"stateOrProvince": "PR",
"city": "SAN JUAN",
"street1": "279 AVE PONCE DE LEON",
"street2": "APT 8",
"postCode": "009171920"
}
},
{
"mediumType": "Phone",
"characteristic": {
"contactType": "Home",
"phoneNumber": "7879257001"
}
},
{
"mediumType": "Phone",
"characteristic": {
"contactType": "Business",
"phoneNumber": "9059334010"
}
}
]
}
],
"relatedParty": [
{
"id": "1101520693636",
"name": "TIVO APP TEST LIBERTY GO",
"role": "Customer",
"@referredType": "Individual"
}
],
"characteristic": [
{
"name": "autoPayDate",
"value": "2023-01-07T00:00:00.000Z"
},
{
"name": "DebitDay",
"value": "03"
},
{
"name": "CreditScore",
"value": "A"
},
{
"name": "LocationId",
"value": "00917192001084"
}
]
}
]AutoPay Disable for debtCheck by SSN
[
{
"id": "8211990010013175",
"name": "FABIAN DIAZ",
"@type": "BillingAccount",
"accountType": "RES",
"state": "E",
"paymentStatus": "E",
"paymentPlan": [
{
"planType": "Auto Pay Disable"
}
],
"accountBalance": [
{
"amount": {
"unit": "USD",
"value": 194.78
},
"balanceType": "AccountBalance",
"validFor": {
"startDateTime": "2022-12-26",
"endDateTime": "2023-01-25"
}
},
{
"amount": {
"unit": "USD",
"value": 194.78
},
"balanceType": "DelinquentBalance"
}
],
"creditLimit": {
"unit": "USD",
"value": 100.00
},
"contact": [
{
"contactName": "FABIAN DIAZ",
"contactMedium": [
{
"mediumType": "Address",
"preferred": true,
"characteristic": {
"contactType": "BillingAddress",
"stateOrProvince": "PR",
"city": "SAN JUAN",
"street1": "279 AVE PONCE DE LEON",
"street2": "APT 2004",
"postCode": "009171920"
}
},
{
"mediumType": "Phone",
"characteristic": {
"contactType": "Home",
"phoneNumber": "3184337043"
}
}
]
}
],
"relatedParty": [
{
"id": "1101521367339",
"name": "FABIAN DIAZ",
"role": "Customer",
"@referredType": "Individual"
}
],
"characteristic": [
{
"name": "CreditScore",
"value": "A"
},
{
"name": "LocationId",
"value": "00917192001084"
}
]
}
]By locationId
[
{
"id": "8211990010026953",
"@type": "BillingAccount",
"accountType": "RES",
"state": "NORMAL",
"paymentStatus": "NORMAL",
"accountBalance": [
{
"amount": {
"unit": "USD",
"value": 70.22
},
"balanceType": "AccountBalance"
},
{
"amount": {
"unit": "USD",
"value": 50.22
},
"balanceType": "DelinquentBalance"
}
],
"relatedParty": [
{
"id": "1101523725161",
"role": "Customer",
"@referredType": "Individual"
}
],
"characteristic": [
{
"valueType": "string",
"value": "917000000385",
"name": "locationId"
}
]
},
{
"id": "8211990010024400",
"@type": "BillingAccount",
"accountType": "RES",
"state": "E",
"paymentStatus": "E",
"accountBalance": [
{
"amount": {
"unit": "USD",
"value": 30.22
},
"balanceType": "AccountBalance"
},
{
"amount": {
"unit": "USD",
"value": 20.22
},
"balanceType": "DelinquentBalance"
}
],
"relatedParty": [
{
"id": "1101522746259",
"role": "Customer",
"@referredType": "Individual"
}
],
"characteristic": [
{
"valueType": "string",
"value": "917000000385",
"name": "locationId"
}
]
}
]Expected values for CSG FIXED Auto Pay
| Field Name | Description |
|---|---|
| paymentStatus | blank - Active or Normal S - Suspended B - Balance is less than EFT minimum debit amount D - Debit Error E - Prenote Error G - EFT debit had been sent to ACH processor P - Prenote Error W - Waiting |
Enable or Disable or change Autopay ( TMF666 PATCH)
Request to enable or disable auto pay
URL
https://[localhost]:[port]/dxp-ux/v1/{businessId}/billingAccount/{id}Base URI Parameter
URL PARAMS
| name | type | description | required |
|---|---|---|---|
| businessId | string | 2 letter ISO 3166 country code (PR) identifying the business unit. | Y |
| id | string | Billing Account Number. | Y |
Headers
| name | value | description | required |
|---|---|---|---|
| client_id | string | The client_id identifying the channel. Minimum characters: 5 | Y |
| client_secret | string | Password associated with the client_id. Minimum characters: 5 | Y |
| X-Correlation-ID | string | An identifier for the current call chain that can be used to tie together log entries on multiple layers (e.g. client, server, mainframe). This identifier must be designed to be unique across all applications.Note - Mule default behavior creates a sample x-correlation-id field if value is not passed from client, API will use this value in case value is not passed in API request Pattern: ^[a-zA-Z0-9-+/=_]{16,64}$ Minimum characters: 16 Maximum characters: 64 | Y |
Request
curl --location --request PATCH 'https://nonprod.esb.cloud.lla.com/dev/dxp-ux/dxp-ux/v1/PR/billingAccount/31516278-31514752' \
--header 'X-Correlation-ID: 644e1dd7-2a7f-18fb-b8ed-ed78c3F92c2gk' \
--header 'client_id: abcd' \
--header 'client_secret: 12345' \
--header 'Content-Type: application/json' \
--data-raw '{
"defaultPaymentMethod": {
"@referredType": "Autopay",
"id": "PM-a6Idq00000005FpEAI"
},
"extendedCharacteristic": [
{
"value": "Digital",
"name": "sourceSystem"
},
{
"value": "true",
"name": "restrictOrder"
},
{
"value": "9",
"name": "autopayConsentTextVersion"
}
],
"relatedParty": [
{
"id": "12218008051",
"@type": "msisdn"
}
]
}'Definitions
| name | value (length) | description | required |
|---|---|---|---|
| defaultPaymentMethod | object | Details of payment method | Y |
| defaultPaymentMethod.@referredType | String | type of payment. Allowed Values To enable: Autopay To disable: Non-Autopay To change: ChangeAutopay | Y |
| defaultPaymentMethod.id | String (30) | unique identifier of payment type | Y |
| extendedCharacteristic | Array | details of characteristic | Y |
| extendedCharacteristic.value | String | value of characteristic | Y* |
| extendedCharacteristic.name | String | name of characteristic | Y* |
| relatedParty | Array | details of relatedParty | N |
| relatedParty.id | String (20) | id of relatedParty, Mobile Device number | N |
| relatedParty.@type | String | type of relatedParty, expecting static value 'msisdn' | N |
extendedCharacteristic values
| name | value | description | required |
|---|---|---|---|
| sourceSystem | string (30) | Source System information for tracking purpose: possible value IVR/Digital | Y |
| restrictOrder | boolean | Restrict the order submission if it is call center flow | N |
[ 200 ]
OK - updateBillingAccount request processed successfully, response body contains an entity corresponding to the requested resource.
Response
{
"status": 200,
"description": "Autopay change request received"
}Definitions
| name | value | description | required |
|---|---|---|---|
| status | number | status code of the response | N |
| description | string | status description of the response | N |
Update billing address ( TMF666 PATCH)
Request to update billing address
URL
https://[localhost]:[port]/dxp-ux/v1/{businessId}/billingAccount/{id}Base URI Parameter
URL PARAMS
| name | type | description | required |
|---|---|---|---|
| businessId | string | 2 letter ISO 3166 country code (PR) identifying the business unit. | Y |
| id | string | Billing Account Number. | Y |
Headers
| name | value | description | required |
|---|---|---|---|
| client_id | string | The client_id identifying the channel. Minimum characters: 5 | Y |
| client_secret | string | Password associated with the client_id. Minimum characters: 5 | Y |
| X-Correlation-ID | string | An identifier for the current call chain that can be used to tie together log entries on multiple layers (e.g. client, server, mainframe). This identifier must be designed to be unique across all applications.Note - Mule default behavior creates a sample x-correlation-id field if value is not passed from client, API will use this value in case value is not passed in API request Pattern: ^[a-zA-Z0-9-+/=_]{16,64}$ Minimum characters: 16 Maximum characters: 64 | Y |
Request
curl --location --request PATCH 'https://nonprod.esb.cloud.lla.com/dev/dxp-ux/dxp-ux/v1/PR/billingAccount/21519514-21517998' \
--header 'X-Correlation-ID: 644e1dd7-2a7f-18fb-b8ed-ed78c3F92c2gk' \
--header 'client_id: xxx' \
--header 'client_secret: yyy' \
--header 'Content-Type: application/json' \
--data-raw '{
"relatedParty": [
{
"id": "15468766786",
"@type": "msisdn"
},
{
"@type": "channel",
"name": "Digital"
}
],
"contact": [
{
"contactMedium": [
{
"characteristic": {
"emailAddress": "test@test.com",
"street1": "123 Calle Juan Pablo Duarte",
"stateOrProvince": "PR",
"postCode": "0907",
"country": "US",
"city": "San Juan"
},
"@referredType": "billingAccount"
}
]
}
]
}'Definitions
| name | value (length) | description | required |
|---|---|---|---|
| relatedParty | array | related party array, refer below relatedParty table for more info | Y |
| relatedParty.id | string | unique identifier of related party | Y* |
| relatedParty.@type | string | type of the related party | Y* |
| relatedParty.name | string | name of the related party | Y* |
| contact | Array | Contact array | Y |
| contact.contactMedium | Array | details of contact medium | Y |
| contact.contactMedium.characterstic | Object | Characterstic Object | Y |
| contact.contactMedium.characterstic.stateOrProvince | string (70) | billing address state/province | Y* |
| contact.contactMedium.characterstic.city | string (70) | billing address city | Y* |
| contact.contactMedium.characterstic.emailAddress | string (50) | required on requestType is EMAIL | Y* |
| contact.contactMedium.characterstic.country | string (70) | billing address country | Y* |
| contact.contactMedium.characterstic.street1 | string (70) | billing address street | Y* |
| contact.contactMedium.characterstic.postCode | string (30) | billing address postal code | Y* |
| contact.contactMedium.@referredType | string | type of the account, status value like "billingAccount" | N |
relatedParty Values
| name | value (length) | description | required |
|---|---|---|---|
| msisdn | string (20) | related party array | Y |
| channel | string (20) | Source System information for tracking purpose, Possible values IVR, Digital | Y |
[ 200 ]
OK - updateBillingAccount request processed successfully, response body contains an entity corresponding to the requested resource.
Response
{
"status": 200,
"description": "Email or Address change request received"
}Definitions
| name | value | description | required |
|---|---|---|---|
| status | Number | status code of the response | N |
| description | string | status description of the response | N |
Patch BillingAccount (TMF666) Update ebill flag
CASE 1 Unitary Test
Request to enable the ebill
URL
https://[localhost]:[port]/dxp-ux/v1/{businessId}/billingAccount/{id}Base URI Parameter
URL PARAMS
| name | type | description | required |
|---|---|---|---|
| businessId | string | 2 letter ISO 3166 country code (PR, JM, PA, etc.) identifying the business unit. | Y |
| id | string | Billing Account Number. | Y |
Headers
| name | value | description | required |
|---|---|---|---|
| client_id | string | The client_id identifying the channel. Minimum characters: 5 | Y |
| client_secret | string | Password associated with the client_id. Minimum characters: 5 | Y |
| X-Correlation-ID | string | An identifier for the current call chain that can be used to tie together log entries on multiple layers (e.g. client, server, mainframe). This identifier must be designed to be unique across all applications.Note - Mule default behavior creates a sample x-correlation-id field if value is not passed from client, API will use this value in case value is not passed in API request Pattern: ^[a-zA-Z0-9-+/=_]{16,64}$ Minimum characters: 16 Maximum characters: 64 | Y |
Request
curl --location --request PATCH 'https://nonprod.esb.cloud.lla.com/dev/dxp-ux/dxp-ux/v1/PR/billingAccount/21519514-21517998' \
--header 'X-Correlation-ID: 644e1dd7-2a7f-18fb-b8ed-ed78c3F92c2gk' \
--header 'client_id: xxx' \
--header 'client_secret: yyy' \
--header 'Content-Type: application/json' \
--data-raw '{
"relatedParty": [
{
"id": "15468766786",
"@type": "msisdn"
},
{
"@type": "channel",
"name": "Digital"
}
],
"billStructure": {
"presentationMedia": [
{
"@type": "non-eBill"
}
]
}
}'Definitions
| name | value | description | required |
|---|---|---|---|
| relatedParty | array | related party array | Y |
| relatedParty.id | string | unique identifier of related party | N |
| relatedParty.@type | string | type of the related party | Y* |
| relatedParty.name | string | name of the realted party | Y* |
| billStructure | Object | bill structure object | Y |
| billStructure.presentationMedia | Array | details of presentation media | Y |
| billStructure.presentationMedia.@type | String | type of bill subscription | Y |
[ 200 ]
OK - updateBillingAccount request processed successfully, response body contains an entity corresponding to the requested resource.
Response
{
"status": 200,
"description": "Request to update the Ebill Flag received"
}Definitions
| name | value | description | required |
|---|---|---|---|
| status | number | status code of the response | N |
| description | string | status description of the response | N |
[ 200 ] FIXED
OK - updateBillingAccount request processed successfully, response body contains an entity corresponding to the requested resource.
Request
{
"billStructure": {
"presentationMedia": [
{
"name": "email"
}
]
}
}Response
{
"id": "8211990010042315",
"state": "acknowledged",
"billStructure": {
"presentationMedia": [
{
"name": "email"
}
]
}
}FIXED Definitions
| name | value | description | required |
|---|---|---|---|
| id | string | unique identifier | Y |
| state | string | state of the operation | Y |
| billStructure | Object | bill structure object | Y |
| billStructure.presentationMedia | Array | details of presentation media. | Y |
| billStructure.presentationMedia.name | String | Name of the referred entity.Possible values are | Y |
Get BillingAccountByServiceById
billingAccount/service/{id}
[GET]
This operation gets the account details based on service number for resources with operations that allow fetching of Account Details
URL
https://[localhost]:[port]/dxp-ux/v1/{businessId}/billingAccount/service/{id}URL PARAMS
| name | type | description | required |
|---|---|---|---|
| businessId | string | 2 letter ISO 3166 country code (TT, BB, JM, PA, PR etc.) identifying the business unit. Expected one is "PR"-Puerto Rico | Y |
| id | string | customer phone number | Y |
Header
| name | type | description | required |
|---|---|---|---|
| client_id | string | The client_id identifying the channel. | Y |
| client_secret | string | Password associated with the client_id. | Y |
| X-Correlation-ID | string | An identifier for the current call chain that can be used to tie together log entries on multiple layers (e.g. client, server, mainframe). This identifier must be designed to be unique across all applications. Note - Mule default behavior creates a sample x-correlation-id field if value is not passed from client, API will use this value in case value is not passed in API request | N It is mandatory for Business |
| channelId | string | Expected value 'APP' | Y |
| lob | enum | The Line of Business Identifier currently available are: FIXED PREPAID POSTPAID | N |
Response [ 200 ]
LCPR Success Response
This is non-tmf response, which is used to retrieve the migration status from DynamoDB.
OK - request processed successfully, response body contains an entity corresponding to the requested resource.
{
"subscriptionId": "165682573434",
"accountType": "B2C",
"state": "Active",
"recurringFlag": false,
"fraudFlag": false,
"pin": "3472163402",
"migrationStatus": "success",
"salesforceAccountNumber": "169338844735",
"migrationETA": "testing",
"bssSourceSystem": "Anatares"
}Possible response error
HTTP Status response is 400
with Response
[ 400 ]
Bad Request - the request could not be understood by the server due to malformed syntax. The client SHOULD NOT repeat the request without modifications.
{
"errors": [
{
"code": 400,
"message": "APIKIT:BAD_REQUEST",
"description": "Invalid value 'M' for uri parameter businessId. M is not a valid enum value"
}
]
}[ 401 ]
Unauthorized - The request has not been applied because it lacks valid authentication credentials for the target resource.
{
"errors" : [{
"code" : 401,
"message" : "The user could not be authenticated for this request.",
"description" : "The request has not been applied because it lacks valid authentication credentials for the target resource"
}]
}[ 403 ]
Forbidden - Indicates that the server understood the request but refuses to fulfill it. If authentication credentials were provided in the request, the server considers them insufficient to grant access. The client SHOULD NOT automatically repeat the request with the same credentials. The client MAY repeat the request with new or different credentials.
[ 404 ]
Not Found - server has not found a resource with that URI. This may be temporary and permanent condition. This status code is commonly used when the server does not wish to reveal exactly why the request has been refused, or when no other response is applicable.
{
"errors": [
{
"code": 404,
"message": "DYNAMO_DB :Account details not found for serviceNumber: 7872000007",
"description": "NOACCTSFOUND-No Accounts found"
}
]
}[ 405 ]
Method Not Allowed - HTTP method not allowed for this resource. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI.
{
"errors": [
{
"code": 405,
"message": "APIKIT:METHOD_NOT_ALLOWED",
"description": "HTTP Method post not allowed for : /{businessId}/billingAccount/service/{id}"
}
]
}[ 500 ]
Internal Server Error - server encountered an error processing request. This should not happen normally, but it is a generic error message, given when no more specific message is suitable.
{
"errors" : [{
"code" : 500,
"message" : "The request failed due to an internal error.",
"description": "error description"
}]
}[ 501 ]
Check for the other BU Flows, if not implemented then throw a standard error message as below.
{
"errors": [
{
"code": 501,
"message": "NOT IMPLEMENTED",
"description": "Operation GET /billingAccount/service/id for Business Id: JM not implemented"
}
]
}[ 503 ]
Service Unavailable
{
"errors": [
{
"code": 503,
"message": "HTTP:SERVICE_UNAVAILABLE",
"description": "HTTP POST on resource 'http://0.0.0.0:9091/nontmf-biz/v1/{businessId}/customerMigrationInfo?serviceNumber' failed: service unavailable (503)."
}
]
}Definitions
TMF 666
| name | type | description | required |
|---|---|---|---|
| id | string | Unique identifier of the account | N |
| href | string | Unique reference of the account | N |
| accountType | string | A categorization of an account, such as individual, joint, and so forth, whose instances share some of the same characteristics. Note: for flexibility we use a String here but an implementation may use an enumeration with a limited list of valid values | N |
| description | string | Detailed description of the party account | N |
| lastModified | datetime | Date of last modification of the account | N |
| name | string | Name of the account | N |
| paymentStatus | string | The condition of the account, such as due, paid, in arrears | N |
| ratingType | string | Indicates whether the account follows a specific payment option such as prepaid or postpaid | N |
| state | string | Contains the lifecycle state such as: Active, Closed, Suspended and so on. | N |
| accountBalance | object Array | Balances linked to the account | N |
| accountBalance.balanceType | string | Type of the balance ; deposit balance, disputed balance, loyalty balance, receivable balance... | N |
| accountBalance.amount | object | Balance amount | N |
| accountBalance.amount.unit | string | Currency (ISO4217 norm uses 3 letters to define the currency) | N |
| accountBalance.amount.value | number, float | A positive floating point number | N |
| accountBalance.validFor | object | 'A period of time, either as a deadline (endDateTime only) a startDateTime only, or both | N |
| accountBalance.validFor.endDateTime | datetime | End of the time period, using IETC-RFC-3339 format | N |
| accountBalance.validFor.startDateTime | datetime | Start of the time period, using IETC-RFC-3339 format. If you define a start, you must also define an end | N |
| accountBalance.@baseType | string | When sub-classing, this defines the super-class | N |
| accountBalance.@schemaLocation | string | A URI to a JSON-Schema file that defines additional attributes and relationships | N |
| accountBalance.@type | string | When sub-classing, this defines the sub-class entity name | N |
| accountRelationship | object Array | Significant connection between accounts. For instance an aggregating account for a list of shop branches each having its own billing account | N |
| accountRelationship.relationshipType | string | Type of relationship. | N |
| accountRelationship.account | object | .An account may be a party account or a financial account. | N |
| accountRelationship.account.id | string | Unique identifier Id of the EntityDescriptionRef. | N |
| accountRelationship.account.href | string | Unique reference of the EntityDescriptionRef | N |
| accountRelationship.account.description | string | Detailed description of the EntityDescriptionRef | N |
| accountRelationship.account.name | string | Name of the account. | N |
| accountRelationship.account.@baseType | string | When sub-classing, this defines the super-class | N |
| accountRelationship.account.@schemaLocation | string | A URI to a JSON-Schema file that defines additional attributes and relationships | N |
| accountRelationship.account.@type | string | When sub-classing, this defines the sub-class entity name | N |
| accountRelationship.account.@referredType | string | The actual type of the target instance when needed for disambiguation | N |
| accountRelationship.validFor | accountBalance.validFor | 'A period of time, either as a deadline (endDateTime only) a startDateTime only, or both | N |
| accountRelationship.@baseType | string | When sub-classing, this defines the super-class | N |
| accountRelationship.@schemaLocation | string | A URI to a JSON-Schema file that defines additional attributes and relationships | N |
| accountRelationship.@type | string | When sub-classing, this defines the sub-class entity name | N |
| billStructure | object | The structure of the bill for party accounts (billing or settlement). | N |
| billStructure.cycleSpecification | object | An attachment by value or by reference. | N |
| billStructure.cycleSpecification.id | string | Unique identifier of the billing cycle specification | N |
| billStructure.cycleSpecification.href | string | Reference of the billing cycle specification | N |
| billStructure.cycleSpecification.billingDateShift | integer | An offset of a billing/settlement date. The offset is expressed as number of days with regard to the start of the billing/settlement period. | N |
| billStructure.cycleSpecification.billingPeriod | string | A billing time period. It can be recurring, for example: week, month, quarter of year, year . | N |
| billStructure.cycleSpecification.chargeDateOffset | integer | An offset of a date through which charges previously received by the billing system will appear on the bill. The offset is expressed as number of days with regard to the start of the BillingPeriod | N |
| billStructure.cycleSpecification.creditDateOffset | integer | An offset of a date through which charges previously received by the billing system will appear on the bill. The offset is expressed as number of days with regard to the start of the BillingPeriod | N |
| billStructure.cycleSpecification.dateShift | integer | An offset of a billing/settlement date. The offset is expressed as number of days with regard to the start of the billing/settlement period. | N |
| billStructure.cycleSpecification.description | string | An explanation regarding this billing cycle specification | N |
| billStructure.cycleSpecification.frequency | string | Frequency of the billing cycle (monthly for instance) | N |
| billStructure.cycleSpecification.mailingDateOffset | integer | An offset of a customer bill mailing date. The offset is expressed as number of days with regard to the start of the BillingPeriod. | N |
| billStructure.cycleSpecification.name | string | A short descriptive name | N |
| billStructure.cycleSpecification.paymentDueDateOffset | integer | An offset of a payment due date. The offset is expressed as number of days with regard to the start of the BillingPeriod. | N |
| billStructure.cycleSpecification.@baseType | string | When sub-classing, this defines the super-class | N |
| billStructure.cycleSpecification.@schemaLocation | string | A URI to a JSON-Schema file that defines additional attributes and relationships | N |
| billStructure.cycleSpecification.@type | string | When sub-classing, this defines the sub-class entity name | N |
| billStructure.cycleSpecification.@referredType | string | The actual type of the target instance when needed for disambiguation | N |
| billStructure.format | accountRelationship.account | An attachment by value or by reference. | N |
| billStructure.presentationMedia | accountRelationship.account | A list of bill presentation media ref or values | |
| billStructure.@baseType | string | When sub-classing, this defines the super-class | N |
| billStructure.@schemaLocation | string | A URI to a JSON-Schema file that defines additional attributes and relationships | N |
| billStructure.@type | string | When sub-classing, this defines the sub-class entity name | N |
| contact | object Array | An individual or an organization used as a contact point for a given account and accessed via some contact medium. | N |
| contact.contactName | string | A displayable name for that contact | N |
| contact.contactType | string | Type of contact (primary, secondary...) | N |
| contact.partyRoleType | string | Identifies what kind of party role type is linked to the contact (a account manager...) | N |
| contact.contactMedium | object Array | Indicates the contact medium that could be used to contact the party. | N |
| contact.contactMedium.mediumType | string | Type of the contact medium, such as: email address, telephone number, postal address | N |
| contact.contactMedium.preferred | boolean | If true, indicates that is the preferred contact medium | N |
| contact.contactMedium.characteristic | object | Any additional characteristic(s) of this contact medium | N |
| contact.contactMedium.characteristic.city | string | City | N |
| contact.contactMedium.characteristic.contactType | string | The type of contact, for example; phone number such as mobile, fixed home, fixed office. postal address such as shipping installation | N |
| contact.contactMedium.characteristic.country | string | N | |
| contact.contactMedium.characteristic.emailAddress | string | Full email address in standard format | N |
| contact.contactMedium.characteristic.faxNumber | string | The fax number of the contact | N |
| contact.contactMedium.characteristic.phoneNumber | string | The primary phone number of the contact | N |
| contact.contactMedium.characteristic.postCode | string | Postcode | N |
| contact.contactMedium.characteristic.socialNetworkId | string | Identifier as a member of a social network | N |
| contact.contactMedium.characteristic.stateOrProvince | string | State or province | N |
| contact.contactMedium.characteristic.street1 | string | Describes the street | N |
| contact.contactMedium.characteristic.street2 | string | Complementary street description | N |
| contact.contactMedium.characteristic..@baseType | string | When sub-classing, this defines the super-class | N |
| contact.contactMedium.characteristic..@schemaLocation | string | A URI to a JSON-Schema file that defines additional attributes and relationships | N |
| contact.contactMedium.characteristic..@type | string | When sub-classing, this defines the sub-class entity name | N |
| contact.contactMedium.characteristic.geoCode | string | GeoCode | N |
| contact.contactMedium.validFor | accountRelationship.validFor | N | |
| contact.contactMedium.@baseType | string | When sub-classing, this defines the super-class | N |
| contact.contactMedium.@schemaLocation | string | A URI to a JSON-Schema file that defines additional attributes and relationships | N |
| contact.contactMedium.@type | string | When sub-classing, this defines the sub-class entity name | N |
| contact.relatedParty | relatedParty | N | |
| contact.validFor | accountRelationship.validFor | N | |
| contact.@baseType | string | When sub-classing, this defines the super-class | N |
| contact.@schemaLocation | string | A URI to a JSON-Schema file that defines additional attributes and relationships | N |
| contact.@type | string | When sub-classing, this defines the sub-class entity name | N |
| creditLimit | object | The maximum amount of money that may be charged on an account | N |
| defaultPaymentMethod | object | N | |
| defaultPaymentMethod.id | string | Unique identifier Id of the EntityRef. | N |
| defaultPaymentMethod.href | string | Unique reference of the EntityRef | N |
| defaultPaymentMethod.name | string | Name of the EntityRef. | N |
| defaultPaymentMethod.@baseType | string | When sub-classing, this defines the super-class | N |
| defaultPaymentMethod@schemaLocation | string | A URI to a JSON-Schema file that defines additional attributes and relationships | N |
| defaultPaymentMethod.@type | string | When sub-classing, this defines the sub-class entity name | N |
| defaultPaymentMethod.@referredType | string | The actual type of the target instance when needed for disambiguation | N |
| financialAccount | object | AccountReceivable reference. An account of money owed by a party to another entity in exchange for goods or services that have been delivered or used. An account receivable aggregates the amounts of one or more party accounts (billing or settlement) owned by a given party. | N |
| financialAccount.id | string | Unique identifier Id of the EntityRef. | N |
| financialAccount.href | string | Unique reference of the EntityRef | N |
| financialAccount.name | string | Name of the EntityRef. | N |
| financialAccount.accountBalance | accountBalance | n | |
| financialAccount.@baseType | string | When sub-classing, this defines the super-class | N |
| financialAccount@schemaLocation | string | A URI to a JSON-Schema file that defines additional attributes and relationships | N |
| financialAccount.@type | string | When sub-classing, this defines the sub-class entity name | N |
| financialAccount.@referredType | string | The actual type of the target instance when needed for disambiguation | N |
| paymentPlan | object Array | Defines a plan for payment (when a party wants to spread his payments) | N |
| paymentPlan.numberOfPayments | integer | Number of payments used to spread the global payment | N |
| paymentPlan.paymentFrequency | string | Frequency of the payments, such as monthly and bimonthly | N |
| paymentPlan.planType | string | Type of payment plan | N |
| paymentPlan.priority | integer | Priority of the payment plan | N |
| paymentPlan.status | string | Status of the payment plan (effective, ineffective) | N |
| paymentPlan.paymentMethod | defaultPaymentMethod | ||
| paymentPlan.totalAmount | accountBalance.amount | Amount paid | |
| paymentPlan.validFor | accountRelationship.validFor | ||
| paymentPlan.@baseType | string | When sub-classing, this defines the super-class | N |
| paymentPlan.@schemaLocation | string | A URI to a JSON-Schema file that defines additional attributes and relationships | N |
| paymentPlan.@type | string | When sub-classing, this defines the sub-class entity name | N |
| characteristic | object Array | Describes a given characteristic of an object or entity through a name/value pair. | N |
| characteristic.name | string | Name of the characteristic | N |
| characteristic.valueType | string | Data type of the value of the characteristic | N |
| characteristic.value | any | The value of the characteristic | N |
| characteristic.@baseType | string | When sub-classing, this defines the super-class | N |
| characteristic.@schemaLocation | string | A URI to a JSON-Schema file that defines additional attributes and relationships | N |
| characteristic.@type | string | When sub-classing, this defines the sub-class entity name | N |
| relatedParty | object Array | N | |
| relatedParty.id | string | Unique identifier Id of the EntityRef. | N |
| relatedParty.href | string | Unique reference of the EntityRef | N |
| relatedParty.name | string | Name of the EntityRef. | N |
| relatedParty.role | role played by the related party | ||
| relatedParty.@baseType | string | When sub-classing, this defines the super-class | N |
| relatedParty@schemaLocation | string | A URI to a JSON-Schema file that defines additional attributes and relationships | N |
| relatedParty.@type | string | When sub-classing, this defines the sub-class entity name | N |
| relatedParty.@referredType | string | The actual type of the target instance when needed for disambiguation | |
| taxExemption | object Array | Proof of freedom from taxes imposed by a taxing jurisdiction. | N |
| taxExemption.certificateNumber | string | Identifier of a document that shows proof of exemption from taxes for the taxing jurisdiction. | N |
| taxExemption.issuingJurisdiction | string | Name of the taxing jurisdiction for which taxes are exempt. | N |
| taxExemption.reason | string | Reason of the tax exemption | N |
| taxExemption.validFor | accountRelationship.validFor | N | |
| taxExemption.@baseType | string | When sub-classing, this defines the super-class | N |
| taxExemption.@schemaLocation | string | A URI to a JSON-Schema file that defines additional attributes and relationships | N |
| taxExemption.@type | string | When sub-classing, this defines the sub-class entity name | N |
| @baseType | string | When sub-classing, this defines the super-class | N |
| @schemaLocation | string | A URI to a JSON-Schema file that defines additional attributes and relationships | N |
| @type | string | When sub-classing, this defines the sub-class entity name | N |
| fraudFlag | boolean | fraud flag which indicates the flag | N |
| recurringFlag | boolean | recurringFlag which indicates the caller frequency | N |
| pin | string | pin of the device | N |
| migrationStatus | string | indicates the migration status of the customer | N |
| salesforceAccountNumber | string | associated salesforce account numbe | N |
| migrationETA | string | ETA of the migration | N |
| bssSourceSystem | string | If(migrationStatus == "In Progress" or "Failed" or "Success") "Anatares" else if("Not Started") ATT else "" | N |
| subscriptionId | string | Unique identifier of the account | N |
| money.unit | string | Unit of money | N |
Administration and data management
In this section you define all the transformations, temporary and final repositories of the data within the method flow.
Transformation Request
nontmf-biz
URL
http://0.0.0.0:9091/nontmf-api/v1/{businessId}/customerMigrationInfo?serviceNumber=XXXXXXHeaders
| name | value | description | required |
|---|---|---|---|
| X-Correlation-ID | string | This is a unique identifier for the current call chain that can be used to tie together log entries on multiple layers. Example: 644e1dd7-2a7f-18fb-b8ed-ed78c3F92c2b | O |
| lob | String | PREPAID | O |
| client_id | string | Client Id value for Client Id Enforcement policy. Environment Specific Value. Eg:6f0ed16a7b494d76b2d60e05bc3b3332 | M |
| client_secret | string | Client secret value for Client Id Enforcement policy. Environment Specific Value Eg: e4CD4D43449846aA9D8Cb9c43fAd324a | M |
| channelId | string | Channel to identify the business group. Eg:APP | O |
QueryParameters
| Original Parameter | Mulesoft | transformation |
|---|---|---|
| serviceNumber | attributes.uriParams.id |
Services dependencies
This section defines all the connections to the web services and the methods that are used within the method.
nontmf-biz
| Method | Type |
|---|---|
| /customerMigrationInfo | GET |