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 ()
The account to create. The minimum required parameters are:
  • contacts
    • address
    • city
    • country
    • firstName
    • lastName

    You can optionally include:

    • Bill unit assignments for the balance groups defined by the package. The account payload can include a list of bill unit definitions, but if it doesn't, one will be created.
    • Customized details about the products and discounts in each bundle. If you don't customize the bundles, the account won't contain references to the bundles. If you override the product's prices and dates, they are included in the CustomizedBundleForPurchase parameter.

    Note: Set the purchasingPlanRef and notes parameters to null if they don't have any value.

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 : CustomizedBundleForPurchase
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 ()
The account to create. The minimum required parameters are:
  • contacts
    • address
    • city
    • country
    • firstName
    • lastName

    You can optionally include:

    • Bill unit assignments for the balance groups defined by the package. The account payload can include a list of bill unit definitions, but if it doesn't, one will be created.
    • Customized details about the products and discounts in each bundle. If you don't customize the bundles, the account won't contain references to the bundles. If you override the product's prices and dates, they are included in the CustomizedBundleForPurchase parameter.

    Note: Set the purchasingPlanRef and notes parameters to null if they don't have any value.

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 : CustomizedBundleForPurchase
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