Oracle® Monetization Cloud

What's New

Release 1.1

E96408-07

October 2018

Discover new features and enhancements in Oracle Monetization Cloud 1.1.

Topics in this document

Release 1.1.0.0.14 — October 2018

Oracle Monetization Cloud 1.1.0.0.14 includes fixed issues, enhancements, and documentation updates.

Enhancements and fixed issues

This table lists enhancements that have been made and issues reported by users that have been fixed in Oracle Monetization Cloud 1.1.0.0.14.

Service Request (SR) number Bug number Description
3-17194348376 28056589 You can now create rate tiers for usage charged based on balances of resources, such as gigabytes or loyalty points.
3-17630011251 27425701 The invoices now include start and end dates for cycle events.
N/A 27559347 BI Publisher has an enhanced look and feel.
N/A 28213729 For deferred actions, the Subscriber Management news feed now displays details about the action in addition to the fact that an action was scheduled.
3-17784389791 28255680 Invoice XML files now include the PRICE_LIST_NAME field.
3-17859139701 28511748

28745782

Oracle now creates read-only users for your SFTP server in addition to the administrative user.
N/A 28526945

28792709

Audit objects are now disabled in the Oracle Monetization Cloud database.
N/A 28549854 The default shared memory and big size has been increased for the Oracle Monetization Cloud data mangers.
N/A 28674004 You can now use SOAP web services to generate bills and invoices with these operations:
  • pcmOpBillMakeBill

  • pcmOpInvMakeInvoice

N/A 28704649

28738662

Invoicing performance has been improved.
3-17354112111 27978464 Extended service attributes are now available in web service operations.
3-17483735961 28028091 Cycle forward arrears charges are now processing successfully.
3-17831242331 28769418

28295819

An error no longer occurs when you delete changesets in Business Configuration.
3-18251151391 28596588 You can now make SOAP web service requests that use Unix epoch timestamps. Previously ISO 8610 format was required for date-times.
3-17903711001 28704612 Performance issues with invoicing have been resolved.
3-18223035661 28704630 Customers are no longer being charged for suspended services.
N/A 28704658 To prevent duplicate invoices, invoices are now processed sequentially rather than in parallel.
3-18063142281 28704666

28704676

Recurring deferred actions job are now running as scheduled.
N/A 28248368 Offer Design no longer rounds ratable usage metrics (RUM) quantities up to the nearest whole number.

Documentation updates

This table describes documentation updates for Oracle Monetization Cloud 1.1.0.0.14.

Topic Description
Transferring files securely with SFTP Added information about the read-only SFTP users
pcmOpBillMakeBill

pcmOpInvMakeInvoice

Oracle Monetization Cloud SOAP API Reference

New topics about the new SOAP web service operations for creating bills and invoices.
Processing payments in batches Added samples of batch payments files and described the formats.
Contracts management operations

Oracle Monetization Cloud SOAP API Reference

The following SOAP API operation names have been corrected:
  • brmcOpContractCreateContract is now pcmOpContractCreateContract

  • brmcOpContractCancelContract is now pcmOpContractCancelContract

  • brmcOpContractModifyContract is now pcmOpContractModifyContract


Release 1.1.0.0.13 — August 2018

Oracle Monetization Cloud 1.1.0.0.13 includes new features and fixed issues.

New features

This table lists features that were added in Oracle Monetization Cloud 1.1.0.0.13.

Feature Description
Deferred actions Using Business Operations, you can create on-demand or repeating jobs for performing deferred actions, for retrying failed deferred actions, and for purging successful deferred actions. See About performing deferred actions before running billing.

You can also manage deferred actions using the SOAP API. See Activity operations.

Time zone designators in SOAP operations Oracle Monetization Cloud supports using time zone designators for times in SOAP web service requests, as specified by ISO 8601.

See About web service request date and time format.

Finer control over Business Operations access The Business Operations functional roles have been replaced with the following new roles to allow finer control over access to different Business Operations tasks:
  • BOC_SUPER_ADMIN

  • OPERATIONS_VIEW

  • FINANCIALS_VIEW

  • OPERATIONS_BILLING_ADMIN

  • OPERATIONS_FINANCE_ADMIN

  • OPERATIONS_PRICING_SYNC_ADMIN

See Business Operations functional roles for more information about these roles.


Fixed issues

This table lists issues reported by users that have been fixed in Oracle Monetization Cloud 1.1.0.0.13.

Service Request (SR) number Bug number Description
3-17531835957 28065949 You can now map bill items to cycle tax events (/event/billing/cycle/tax) in Business Configuration.

Release 1.1.0.0.12 — July 2018

Oracle Monetization Cloud 1.1.0.0.12 includes an enhancement.

Service Request (SR) number Enhancement number Description
3-17916692241 28368038 You can choose to consider short cycles complete accounting cycles, regardless of the subscription date.

See About short accounting cycles.


Release 1.1.0.0.11 — June 2018

Oracle Monetization Cloud 1.1.0.0.11 includes fixed issues.

Service Request (SR) number Bug number Description
3-17201878151 27795897 Logins to Oracle BI Publisher now have improved performance times.
3-17407537929 27958847 Calls to data export operations in BRMDataExportServices_v2 now have improved performance times.

Release 1.1.0.0.10 — July 2018

Oracle Monetization Cloud 1.1.0.0.10 includes fixed issues.

Service Request (SR) number Bug number Description
N/A 28128721 Business Operations can now create trial bills and trial invoices for accounts in a billing hierarchy.
N/A 28157035 When copying rejected external records into the /reject directory on the SFTP server, instead of recopying all rejected records, Oracle Monetization Cloud now only copies the records rejected since the last time records were copied.

Release 1.1.0.0.6 — May 2018

Oracle Monetization Cloud 1.1.0.0.6 includes new features and fixed issues.

New features

This table lists features that were added in Oracle Monetization Cloud 1.1.0.0.6.

Feature Description
Trial billing You can now create trial bills and trial invoices to validate your billing results. To do so, you run a Trial Billing job in Business Operations.

For more information, see About trial billing.

Charge offers For recurring charges, you can now charge different amounts based on a customer's counter balance. For example, counter balances of up to 10 Points could have a $50 monthly cycle fee, but counter balances of 11 Points or higher could have a $40 monthly cycle fee.

For more information, see Charging by quantity used.

Usage record processing You now have access to the error messages that Oracle Monetization Cloud generates when rating your usage records. An error XML file is now created for each rejected usage record and saved to your SFTP server.

For more information, see Rating usage in Oracle Monetization Cloud and Transferring files securely with SFTP.


Fixed issues

This table lists issues reported by users that have been fixed in Oracle Monetization Cloud 1.1.0.0.6.

Service Request (SR) number Bug number Description
N/A 27259802 When you add a charge to a charge selector, Offer Design no longer generates an error when you configure the tax before saving the new charge.
N/A 27980045 When a billing-time discount credits or debits based on a noncurrency balance, you no longer need to create a quantity tier when you don't want tiered rating.
3-17200708211 27882923 When rating usage records, Oracle Monetization Cloud now creates an error XML file for each usage record and saves it to your SFTP server. See Usage record processing.
N/A 27948976 The log file for the Oracle Monetization Cloud server now displays more compact error messages.
N/A 27757543 The credit limit and credit floor for counters both now have a default of unlimited.
N/A 27756691 Temporary counters now correctly reset to 0 after an event has been discounted.

Release 1.1.0.0.5 — May 2018

Oracle Monetization Cloud 1.1.0.0.5 includes new features and fixed issues.

New features

This table lists features that were added in Oracle Monetization Cloud 1.1.0.0.5.

Feature Description
Log files available in Business Operations You can now view log files for Oracle Monetization Cloud applications and components, such as Subscriber Management, SOAP web services, billing processing, and usage processing. Business Operations includes a new Log Files tab that displays the most recent lines from your system's log files.

For more information, see Using log files to troubleshoot Oracle Monetization Cloud.

Charge offers You can now assign priorities to your charge offers. For example, this allows you to create a special, limited-time offer that has a higher priority than an existing base offer.

For more information, see Creating charge offers.

Discount offers Oracle Monetization Cloud includes enhancements that give you greater flexibility when designing your discount offers. You can now:
  • Create discounts that debit or credit your customer's account balance. Previously, discounts were always credits.

  • Create tiers for usage discounts that are based on the balance of a noncurrency resource in the account. Previously, you could create discount tiers based on the quantity or charge only.

  • Specify whether the discount offer applies to the original charge, the remaining charge, or the remaining charge and quantity.

  • Apply taxes to billing-time discounts.

For more information, see Creating discounts offers.


Fixed issues

This table lists issues reported by users that have been fixed in Oracle Monetization Cloud 1.1.0.0.5.

Service Request (SR) number Bug number Description
3-17378092471 27911893 You can now create discounts that debit (or increase) your customer's account balance.
3-17378092437 27911116 You can now assign tax codes to your billing-time discounts.
3-17072204181 27834802 When reactivating a suspended service with a past date, billing now applies all applicable cycle forward charges.
3-17059748061 27657039 You can now access the log files for Oracle Monetization Cloud by using Business Operations.

Release 1.1.0.0.4 — April 2018

Oracle Monetization Cloud 1.1.0.0.4 includes bug fixes and performance improvements.

Fixed issues

This table lists issues reported by users that have been fixed in Oracle Monetization Cloud 1.1.0.0.4.

Service Request (SR) number Bug number Description
3-17194348281 27797257 When creating an event mapping template in Business Configuration, an error no longer occurs when you map data from external records to multiple internal records in Oracle Monetization Cloud events.
3-17194348314 27798356 An error no longer occurs when you attempt to add multiple users and assign multiple roles in a single request in Oracle Identity Manager.
3-17210194581 27804093 Calls to data export operations in BRMDataExportServices_v2 now succeed with OAuth tokens.
3-17277638101 27834721 You can now request Oracle to run a script that removes test accounts and their related data from an Oracle Monetization Cloud development environment.

Release 1.1.0.0.3 — April 2018

Oracle Monetization Cloud 1.1.0.0.3 includes new features, fixed issues, and documentation updates.

New features

This table lists features that were added in Oracle Monetization Cloud 1.1.0.0.3.

Feature Description
Charge offer change payload contains pricing information. The publishing event that's sent when a charge offer is created or updated now contains pricing information. The pricing information is in the new <RatePlan> element of the ProductInfoChange message payload in the /event/notification/price/products/modify publishing event.
Invoice output format can be changed. You can now change the output format for all of your customers' invoices by using Business Intelligence (BI). For example, you can change the output format from the default of PDF to XML or HTML.

For more information, see Setting the Output Format for Invoices.

Charging and discounting enhancements. Charging and discounting include these enhancements:
  • Trackers can now be added to bundles. Trackers contain counters, which track balances such as the amount spent or megabytes downloaded by a customer. This enables you to vary your prices and discounts based on a counter's total.

  • Counters can now be added to your charge offers and discount offers.

  • Expression builders can now be used when defining when to apply discounts, apply charges, or increment counters.

  • Discounts can now be valid for multiple billing cycles.

For more information, see Creating trackers, Creating discount offers, and Creating charge offers.

SOAP API operation changes These SOAP API operations have added fields:
  • pcmOpCustCommitCustomer:

    ACTG_CYCLE_DOM

  • pcmOpCustModifyCustomer:

    ACTG_CYCLE_DOM

    PLAN_OBJ

See Oracle Monetization Cloud SOAP API Reference.


Fixed issues

This table lists issues reported by users that have been fixed in Oracle Monetization Cloud 1.1.0.0.3.

Service Request (SR) number Bug number Description
3-16628815136, 3-16835784401 27655799 Offer Design no longer generates an error when you submit a changeset that contains both a bundle name change and a package name change.
N/A 27713148 Subscriber Management now displays balances properly after a temporary counter is enabled.
N/A 27741240 Offer Design now retains a tracker's priority setting.
N/A 27765909 Offer Design contains corrected labels for quantity ranges in billing time discounts.
N/A 27756863 In Offer Design, the expression builder for billing time discounts now includes the Quantity and StepQuantity expressions.
3-17018093251 27775161 When you run bill now and then an invoicing job, the job now creates invoices for all of the newly created bills.
3-17027313663 27775176 In Business Operations, invoicing jobs no longer generate multiple instances of the same invoice.

Documentation updates

This table describes significant documentation updates for Oracle Monetization Cloud 1.1.0.0.3.

Update Description
WSDL files Added information about accessing WSDL files from an Oracle Monetization Cloud instance. See About web service WSDL files.
Web services samples Fixed issues with the SOAP API sample requests and responses in the Oracle Monetization Cloud Integration Guide.

Release 1.1.0.0.2 — March 2018

Oracle Monetization Cloud 1.1.0.0.2 includes fixed issues.

Fixed issues

This table lists issues reported by users that have been fixed in Oracle Monetization Cloud 1.1.0.0.2.

Service Request (SR) number Bug number Description
3-16821479275 27650086 You can set an account's billing day of month (DOM) to a future date.
3-16446934611 27349626 The /event/notification/price/products/modify publishing event now includes pricing information.
3-16760987343 27573960 After enabling an OAuth client, the WSDL content is now visible and can be imported into a SOAP UI client for development.
3-16453422483 27649987 Invoicing jobs now successfully publish invoices to the SFTP server.
3-16684751161 27650007 Invoicing jobs now successfully generate invoices for all bills.
3-16462628263 27650036 Billing jobs now perform deferred actions, such as account and service status changes, on their specified execution date.
3-16783790031 27650067 Oracle Monetization Cloud now supports multiple OAuth clients in development and production environments.

Release 1.1 — March 2018

Learn about new features in Oracle Monetization Cloud 1.1.

New features

See the following categories for descriptions of new features:

Account and subscriber management

Feature Description
Accounting types for bill units You now set the accounting type at the bill unit level rather than at the account level. This enables accounts with multiple bill units to have a different accounting type for each bill. For example, an account with two bill units can have one bill unit with an open item accounting type and another bill unit with a balance forward accounting type.

For more information, see About accounting types.

Billing hierarchies You can now create billing hierarchies by assigning one customer's bill unit to a different customer's account. This lets the second customer pay for some or all of the first customer's bills.

For more information, see Managing billing hierarchies.

Customer asset management Assets are the services, including related charge and discount offers, that your customers subscribe to. You can now use Subscriber Management to view details about assets and temporarily inactivate and reactivate them or terminate them completely.

For more information, see Managing customer assets.

Organization hierarchies You can now create organization hierarchies to group accounts within an organization's structure. You can label accounts in an organization hierarchy as sites, legal entities, billing accounts, and service accounts.

For more information, see Managing organization hierarchies.


Change management

Feature Description
Project codes for grouping changesets You can now group changesets into a project by adding a project code to them. This makes it easier for you to find related changesets when you're ready to transfer them from the development environment to the production environment.

For more information, see Managing configuration changes in the cloud.

Transfer requests for moving data to production environments You can now transfer pricing components and business configuration data from the development environment to the production environment. To do so, you create a transfer request in Offer Design or Business Configuration, and then your transfer administrator can export and import the data for you.

For more information, see Managing configuration changes in the cloud.


Charging and discounting

Feature Description
Custom event and service attributes You can now add custom attributes to your services and events. For example, you can add a custom event attribute for tracking the number of bonus points a customer earned during a movie download.

For more information, see Adding custom attributes to services and events.

Pricing component synchronization You can now synchronize pricing component data between Oracle Monetization Cloud and your external applications, such as assisted customer care applications or customer self-service applications. This ensures that your external applications show the most recent changes to your product offerings so they can be seen and purchased by your customers.

For more information, see Running pricing synchronization jobs.

Usage rating When your customers use a service, their usage data is stored in an external record. To enable Oracle Monetization Cloud to process the record and charge your customers, the data in the record must be mapped to events in Oracle Monetization Cloud. To do that, you can now use Business Configuration to create your own event mapping templates instead of relying on Oracle to create them for you.

For more information, see Rating usage in Oracle Monetization Cloud.

Charge selection for events You can now charge different rates or apply different discounts for the same event based on the values of event, service, or account attributes. For example, you could apply a higher rate to the purchase of a premium movie (with a premium attribute) and a lower rate to the purchase of a classic movie (with a classic attribute). To do so, you create a charge selector and add it to your charge offer or discount offer.

For more information, see Creating charge selectors.


Payments

Feature Description
Additional payment gateways For payment processing, you can now choose from the Chase Paymentech or PayPal payment gateways, as well as the existing Chase Paymentech and Cielo payment gateways.

For more information, see Connecting to payment gateways.

Automated processing for batch payments Banks and payment processors collect payments from your customers and then bundle the payment information into a batch file before sending it to your company. Oracle Monetization Cloud can now process these batch payment files automatically and apply the payments to your customers' bills.

For more information, see Processing payments in batches.

Payment distribution to multiple accounts You can now apply a payment to more than one account. This allows your customers to make one large payment for all of their accounts.

For more information, see Distributing a payment among multiple accounts.


Other

Feature Description
Access management Oracle Monetization Cloud now enables you to implement the following access management mechanisms without contacting Oracle support:
Business operations Oracle Monetization Cloud includes enhancements that give you greater control over your business operations jobs. You can now:
  • Modify existing jobs

  • Delete existing jobs

  • Deactivate and reactivate jobs

  • Rerun jobs that have failed

  • Prevent jobs from running during a specified time frame by creating a blackout period

  • View overview or detailed information about jobs

  • Receive an email notification when a job completes

  • Schedule jobs to run on the last day of the month, regardless of whether the month ends on the 29th, 30th, or 31st

  • Run a refund job to return money directly to your customers' credit card, debit card, and direct debit accounts

For more information, see About running business operations jobs.

Taxation gateways You can now connect to the Vertex Indirect Tax O Series On-Demand taxation gateway. For more information, see Connecting to taxation gateways.

You can now use taxation gateways to calculate the amount of taxes that your customers owe. This allows you to handle more complex tax structures across multiple jurisdictions. For more information, see Calculating taxes.


Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.


Oracle Monetization Cloud Release Notes, Release 1.1

E96408-07

Copyright © 2017, 2018, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.