Create an Account

post

/bcws/webresources/v1.0/accounts

Creates an account along with the address, contacts, and billing profiles associated with the account.

Request

There are no request parameters for this operation.

Supported Media Types
Request Body - application/xml ()
Root Schema : schema
Type: object
Show Source
Nested Schema : billUnits
Type: array
Show Source
Nested Schema : contacts
Type: array
An account's contact information.
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : schema
Type: object
Show Source
Nested Schema : Notes
Type: object
Show Source
Nested Schema : ResourceRef
Type: object
Show Source
Nested Schema : paymentMethod
Type: array
Show Source
Nested Schema : profiles
Type: array
Show Source
Nested Schema : services
Type: array
Show Source
Nested Schema : Wallet
Type: object
Show Source
Nested Schema : NewBillUnits
Type: object
Show Source
Nested Schema : balanceGroups
Type: array
Show Source
Nested Schema : forServiceGroup
Type: array
Show Source
Nested Schema : PaymentMethod
Type: object
Show Source
Nested Schema : BalanceGroup
Type: object
Show Source
Nested Schema : balances
Type: array
The list of balances associated with the balance group.
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : services
Type: array
Show Source
Nested Schema : Balances
Type: object
The list of balances associated with the balance group.
Show Source
Nested Schema : subBalances
Type: array
Show Source
Nested Schema : tempCreditLimit
Type: array
Show Source
Nested Schema : SubBalances
Type: object
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : TempCreditLimit
Type: object
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : ServiceType
Type: object
Show Source
Nested Schema : aliasList
Type: array
The list of aliases associated with the service.
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : AliasList
Type: object
The list of aliases associated with the service.
Show Source
Nested Schema : ServiceGroupIndex
Type: object
Show Source
Nested Schema : CreditCardType
Type: object
Show Source
Nested Schema : DirectDebitType
Type: object
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : InvoiceType
Type: object
Show Source
Nested Schema : SepaType
Type: object
Show Source
Nested Schema : Details
Type: object
The offer details.
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : contacts
Type: object
An account's contact information.
Show Source
Nested Schema : phonenumbers
Type: array
The list of associated phone numbers.
Show Source
Nested Schema : Phonenumbers
Type: object
The list of the account's phone numbers.
Show Source
Nested Schema : customizedChargeOffers
Type: array
The list of customized charge offers in the bundle.
Show Source
Nested Schema : customizedDiscountOffers
Type: array
The list of customized discount offers.
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : CustomizedChargeOffers
Type: object
The list of customized charge offers in the bundle.
Show Source
Nested Schema : EndingType
Type: object
Show Source
Nested Schema : StartingType
Type: object
Show Source
  • The starting type mode for a product. Can be one of the following:
    • immediately: The start date is set to today. This mode can be used with the purchaseStart, cycleStart, and usageStart parameters.
    • absolute: The start date is a calendar date. This mode can be used with the purchaseStart, cycleStart, and usageStart parameters.
    • relativeToPurchase: The start date is relative to the purchase date, such as a specified number of billing cycles, months, days, hours, minutes, or seconds after activation. This mode can be used with the cycleStart and usageStart parameters.
    • firstUsage: The start day is the day of the first recorded usage.
  • The date and time the cycle starts.
  • RelativeSettings
Nested Schema : overriddenCharges
Type: array
The overridden charges.
Show Source
Nested Schema : RelativeSettings
Type: object
Show Source
Nested Schema : overriddenCharges
Type: object
Show Source
Nested Schema : charges
Type: array
The charge details.
Show Source
Nested Schema : Charges
Type: object
The charge details.
Show Source
Nested Schema : charge
Type: array
The charges.
Show Source
Nested Schema : Charge
Type: object
The charges.
Show Source
Nested Schema : CustomizedDiscountOffers
Type: object
The list of customized discount offers.
Show Source
Nested Schema : overriddenCharges
Type: array
The overridden charges.
Show Source
Nested Schema : comments
Type: array
The list of comments associated with the note.
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : Comments
Type: object
The list of comments associated with the note.
Show Source
Nested Schema : Discriminator: @class
Type: object
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : PurchasingService
Type: object
Show Source
Nested Schema : customizedBundles
Type: array
Show Source
Nested Schema : devices
Type: array
The list of devices associated with the service.
Show Source
Nested Schema : profiles
Type: array
Show Source
Nested Schema : Discriminator: @class
Type: object
Show Source
Nested Schema : Devices
Type: object
The list of devices associated with the service.
Show Source
Nested Schema : aliasList
Type: array
The list of aliases associated with the service.
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : paymentInstrument
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : name
Type: object
Show Source
Nested Schema : PaymentInstrumentType
Type: object
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
Nested Schema : billUnits
Type: array
Show Source
Nested Schema : contacts
Type: array
An account's contact information.
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : schema
Type: object
Show Source
Nested Schema : Notes
Type: object
Show Source
Nested Schema : ResourceRef
Type: object
Show Source
Nested Schema : paymentMethod
Type: array
Show Source
Nested Schema : profiles
Type: array
Show Source
Nested Schema : services
Type: array
Show Source
Nested Schema : Wallet
Type: object
Show Source
Nested Schema : NewBillUnits
Type: object
Show Source
Nested Schema : balanceGroups
Type: array
Show Source
Nested Schema : forServiceGroup
Type: array
Show Source
Nested Schema : PaymentMethod
Type: object
Show Source
Nested Schema : BalanceGroup
Type: object
Show Source
Nested Schema : balances
Type: array
The list of balances associated with the balance group.
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : services
Type: array
Show Source
Nested Schema : Balances
Type: object
The list of balances associated with the balance group.
Show Source
Nested Schema : subBalances
Type: array
Show Source
Nested Schema : tempCreditLimit
Type: array
Show Source
Nested Schema : SubBalances
Type: object
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : TempCreditLimit
Type: object
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : ServiceType
Type: object
Show Source
Nested Schema : aliasList
Type: array
The list of aliases associated with the service.
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : AliasList
Type: object
The list of aliases associated with the service.
Show Source
Nested Schema : ServiceGroupIndex
Type: object
Show Source
Nested Schema : CreditCardType
Type: object
Show Source
Nested Schema : DirectDebitType
Type: object
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : InvoiceType
Type: object
Show Source
Nested Schema : SepaType
Type: object
Show Source
Nested Schema : Details
Type: object
The offer details.
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : contacts
Type: object
An account's contact information.
Show Source
Nested Schema : phonenumbers
Type: array
The list of associated phone numbers.
Show Source
Nested Schema : Phonenumbers
Type: object
The list of the account's phone numbers.
Show Source
Nested Schema : customizedChargeOffers
Type: array
The list of customized charge offers in the bundle.
Show Source
Nested Schema : customizedDiscountOffers
Type: array
The list of customized discount offers.
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : CustomizedChargeOffers
Type: object
The list of customized charge offers in the bundle.
Show Source
Nested Schema : EndingType
Type: object
Show Source
Nested Schema : StartingType
Type: object
Show Source
  • The starting type mode for a product. Can be one of the following:
    • immediately: The start date is set to today. This mode can be used with the purchaseStart, cycleStart, and usageStart parameters.
    • absolute: The start date is a calendar date. This mode can be used with the purchaseStart, cycleStart, and usageStart parameters.
    • relativeToPurchase: The start date is relative to the purchase date, such as a specified number of billing cycles, months, days, hours, minutes, or seconds after activation. This mode can be used with the cycleStart and usageStart parameters.
    • firstUsage: The start day is the day of the first recorded usage.
  • The date and time the cycle starts.
  • RelativeSettings
Nested Schema : overriddenCharges
Type: array
The overridden charges.
Show Source
Nested Schema : RelativeSettings
Type: object
Show Source
Nested Schema : overriddenCharges
Type: object
Show Source
Nested Schema : charges
Type: array
The charge details.
Show Source
Nested Schema : Charges
Type: object
The charge details.
Show Source
Nested Schema : charge
Type: array
The charges.
Show Source
Nested Schema : Charge
Type: object
The charges.
Show Source
Nested Schema : CustomizedDiscountOffers
Type: object
The list of customized discount offers.
Show Source
Nested Schema : overriddenCharges
Type: array
The overridden charges.
Show Source
Nested Schema : comments
Type: array
The list of comments associated with the note.
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : Comments
Type: object
The list of comments associated with the note.
Show Source
Nested Schema : Discriminator: @class
Type: object
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : PurchasingService
Type: object
Show Source
Nested Schema : customizedBundles
Type: array
Show Source
Nested Schema : devices
Type: array
The list of devices associated with the service.
Show Source
Nested Schema : profiles
Type: array
Show Source
Nested Schema : Discriminator: @class
Type: object
Show Source
Nested Schema : Devices
Type: object
The list of devices associated with the service.
Show Source
Nested Schema : aliasList
Type: array
The list of aliases associated with the service.
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : paymentInstrument
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : name
Type: object
Show Source
Nested Schema : PaymentInstrumentType
Type: object
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Back to Top

Response

Supported Media Types

201 Response

The account was created successfully.
Body ()
Root Schema : resource
Type: object
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : ResourceRef
Type: object
Show Source

500 Response

An internal server error occurred.
Back to Top

Examples

This example shows how to create an account by submitting a POST request on the REST resource using cURL. For more information about cURL, see "Use cURL".

cURL Command

curl -X POST 'http://hostname:port/bcws/webresources/version/accounts' -H 'content-type: application/json' -d @createAccount.json

where:

  • hostname is the URL for the Billing Care REST server.
  • port is the port for the Billing Care REST server.
  • version is the version of the API you're using, such as v1.0.
  • createAccount.json is the JSON file that specifies the account to create.

Example of Request Body

This example shows the contents of the createAccount.json file sent as the request body.

{
   "locale": "en_US",
   "customerTypeCode": "",
   "organizationHierarchyTypeCode": "-1",
   "securityCode1": "question",
   "securityCode2": "answer",
   "contacts": [
      {
         "firstName": "Ashish",
         "lastName": "Patel",
         "middleName": "",
         "salutation": "Mr.",
         "address": "500 Oracle Parkway",
         "city": "Redwood Shores",
         "company": "Vision Corporation",
         "emailAddress": "email@example.com",
         "state": "CA",
         "zip": "94065",
         "deleted": false,
         "newlyCreated": true,
         "elem": 1,
         "contactType": "Work",
         "country": "US",
         "phonenumbers": []
      }
   ],
   "purchasingPlanRef": "0.0.0.1+-plan+58935",
   "services": [
      {
          "service": {
             "login": "email_ashish",
             "@class": "com.oracle.communications.brm.cc.model.ServiceBase"
          },
          "serviceType": "/service/email",
          "serviceKey": "custom-0.0.0.1+-plan+58935-0.0.0.1+-deal+58423-/service/email0",
          "balGrpIndex": 0,
          "customizedBundles": [
             {
                "name": "Deal 2b - Discounted Email Access",
                "id": "0.0.0.1+-deal+58423",
                "customizedChargeOffers": [
                   {
                      "name": "Product 2b - Email Account, No Fees",
                      "description": "",
                      "baseChargeOfferRef": {
                         "id": "0.0.0.1+-product+59863",
                         "uri": null
                      }
                   }
                ],
                "customizedDiscountOffers": []
             }
          ],
          "subscriptionIndex": 0,
          "groupParent": false
       },
       {
          "service": {
             "login": "ip_derek",
             "@class": "com.oracle.communications.brm.cc.model.ServiceBase"
          },
          "serviceType": "/service/ip",
          "serviceKey": "custom-0.0.0.1+-plan+58935-0.0.0.1+-deal+60471-/service/ip1",
          "balGrpIndex": 0,
          "customizedBundles": [
             {
                "name": "Deal 3a - Unlimited Internet Service, Recurring Discounts",
                "id": "0.0.0.1+-deal+60471",
                "customizedChargeOffers": [
                   {
                      "name": "Product 3a - Pre-Paid Internet Service with Free Period",
                      "description": "",
                      "baseChargeOfferRef": {
                         "id": "0.0.0.1+-product+58327",
                         "uri": null
                      }
                   }
                ],
                "customizedDiscountOffers": []
             }
          ],
          "subscriptionIndex": 0,
          "groupParent": false
       }
   ],
   "genericBundle": {},
   "billUnits": [
      {
         "name": "Bill Unit(1)",
         "billingFrequencyInMonths": 1,
         "accountingType": 2,
         "accountingCycleDom": 29,
         "currency": "840",
         "balanceGroups": [
            {
               "services": [
                  {
                     "login": "email_ashish",
                     "name": "Email",
                     "balGrpIndex": 0
                  },
                  {
                     "login": "ip_ashish",
                     "name": "Ip",
                     "balGrpIndex": 0
                  }
               ]
            }
         ],
         "paymentType": "10001",
         "walletPaymentInstrumentIndex": 0
      }
   ],
   "paymentMethod": [
      {
         "invoice": {
            "details": {
               "invoiceId": "8097890",
               "deliveryPrefer": "1",
               "emailAddr": "email@example.com",
               "name": "Ashish Patel",
               "address": "500 Oracle Parkway",
               "city": "Redwood Shores",
               "state": "CA",
               "zip": "94065",
               "country": "US"
            }
         },
         "paymentType": "10001"
      }
   ]
}

Example of Response Body

This example shows the contents of the response body in JSON format.

{
    "extension": null,
    "reference": {
        "id": "0.0.0.1+-account+255881",
        "uri": "http://hostname:port/bcws/webresources/v1.0/accounts/0.0.0.1+-account+255881"
    }
}
Back to Top