The Zuora Usage Record Forwarder is used to send usage data to Zuora Billing using the Zuora Post Usage API or with the Active Rating Post Usage API. You map fields from a source to specific target fields, and Zuora Usage Record Forwarder then compiles and forwards the mapped fields accordingly.
The options are available under the Parameters and Configuration tabs. The Parameters tab allows you to set the values for how the Zuora Usage Record Forwarder would behave when communicating with the Zuora Billing system. The Configuration tab allows you to configure options to send the usage data and allows you to enable the use of Active Rating on the Zuora Usage Record Forwarder.
Parameters
Under Parameters, you get the Environment, Credentials, and Entity options to configure your connection settings.
Environment
Credentials
Entity
Configuration
Under Configuration, you get the Request, Field mapping, Required fields, Optional fields, Operational Settings, and Response handling options to set for the Zuora Usage Record Forwarder. The configuration fields will be different if you have toggled on Use Active Rating described below.
Request
To send usage data to a Zuora Billing system, toggle off Use Active Rating. The Active Rating option is only applicable to Zuora customers that have the Active Rating feature activated, and the Use Active Rating toggle should always be off if this is not the case.
| Rw ui tabs macro | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
 Required fieldsIn Required fields, the field mapping is done for the mandatory fields for the usage record. You must specify the Source Field based on the input from the previous function for the appropriate Required fields. There are three Required fields that must be mapped to the source fields: Quantity, StartDateTime, and UOM. Optional fieldsIn Optional fields, you add the remaining optional fields or you may add additional fields to compile the usage record. There are eight Optional fields and those are AccountId, AccountNumber, ChargeId, ChargeNumber, Description, EndDateTime, SubscriptionId, and SubcriptionNumber. To add a custom field mapping, type the custom field name into Add field. Added custom fields will automatically be appended with the suffix ___c, you do not need to include this suffix in the field name.
Operational settingsIn the Operational settings, you can take the following optional steps to configure the Zuora Usage Record Forwarder:
Response handlingToggling the Response handling on will allow you to Select Interconnect receiver. The Zuora Usage Record Forwarder has a built-in Interconnect Sender which will forward the status ID, request and records details received from Zuora. A second stream can use the Interconnect Receiver to accept the status ID, request and records details forwarded by the Zuora Usage Record Forwarder to track the status of the submitted usage record in Zuora. If the stream fails for any reason, Zuora Usage Record Forwarder will not send anything through the Interconnect Sender.
 Required fieldsIn Required fields, the field mapping is done for the mandatory fields for the usage record. You must specify the Source Field based on the input from the previous function for the appropriate Required fields. There are three Required fields that must be mapped to the source fields: accountNumber, tag, unitOfMeasure, startDateTime, and quantity. Optional fieldsIn Optional fields, you add the remaining optional fields or you may add additional fields to compile the usage record. There are three Optional fields and those are description, groupId, and uniqueKey. To add a custom field mapping, type the custom field name into Add field. Added custom fields will automatically be appended with the suffix ___c, you do not need to include this suffix in the field name. Operational settingsIn the Operational settings, you can take the following optional steps to configure Zuora Usage Record Forwarder:
Response handlingToggling the Response handling on will allow you to Select Interconnect receiver. The Zuora Usage Record Forwarder has a built-in Interconnect Sender which will forward the status ID, request and records details received from Zuora. A second stream can use the Interconnect Receiver to accept the status ID, request and records details forwarded by the Zuora Usage Record Forwarder to track the status of the submitted usage record in Zuora. If the stream fails for any reason, Zuora Usage Record Forwarder will not send anything through the Interconnect Sender.
|