Skip to main content

Error messages in Zuora Revenue

Zuora

Error messages in Zuora Revenue

Zuora Revenue displays error codes with messages to help you find the root cause and fix the errors. The following content provides you with a detailed explanation and corrective action for each error message.

RPRO-00600 - The transaction line is not processed as the SO RPRO-00601 - The INV line is not processed due to the incorrect signage. The signage of the INV and the signage of the associated SO must be the same.

Scenario

Expectation

Recommended solution 

The SO lIne  has an Extended Selling Price (ESP) of $1000, and the invoice line is -$200.

If the SO has a positive ESP, the invoice line must be a positive value.

  • Identify the root cause of opposite signage 

  • Reverse the transaction in the source system

  • Resend a new transaction with the correct signage to ZR 

  • Delete the errored transactions from the inbound data

The SO Line has an ESP of -$1000, and the invoice line is $200.

The invoice line must be a negative value if the SO has a negative ESP.

RPRO-00601 - The INV line is not processed due to the incorrect signage. The signage of the INV and the signage of the associated SO must be the same.

Scenario

Expectation

Recommended solution 

The SO lIne  has an Extended Selling Price (ESP) of $1000, and the invoice line is -$200.

If the SO has a positive ESP, the invoice line must be a positive value.

  • Identify the root cause of opposite signage.
  • Reverse the transaction in the source system
  • Resend a new transaction with the correct signage to ZR 
  • Delete the errored transactions from the inbound data.

The SO Line has an ESP of -$1000, and the invoice line is $200.

The invoice line must be a negative value if the SO has a negative ESP.

RPRO-00602 - Encountered Internal error - Please contact the support team for further assistance.

The transaction encounters an internal error. Please contact  Zuora Global Support for further assistance.

RPRO-00603 - The upload file is not processed due to special characters “=”, “+”, “@”
 

This error occurs when the profile ENABLE_CSV_DATA_SANITIZATION is set to Block

Remove the special characters from the upload file and reprocess it. Alternatively, you can review and update the profile set up as follows to process the upload file again.

  1. Navigate to Setups > Application > Profiles and search for the profile ENABLE_CSV_DATA_SANITIZATION
  2. Hover the mouse above the ENABLE_CSV_DATA_SANITIZATION line.
  3. Click the edit icon 
  4. Select the applicable value from the System Level Value drop-down field.

Field values

Expected Behavior

Block

The system will display an error if the special characters are not removed

Raw

The system will accept the special characters and process the file

Sanitize

The system will remove the special characters and process the file

RPRO-00604 - Total SSP for the RC is $0

The sum of the Extended SSP in the revenue contract is $0. Analyze the error further to confirm if the Extended SSP of $0 is accurate.

A common scenario may drive a $0 Ext SSP in the revenue contract.

Scenario

Based on the SSP setup, $0 extended SSPs are derived in each line for a total of $0 SSP.

SO Line ID

Items

Extended List Price

Extended Sell Price

Extended SSP

SO1.1

HW

1000

600

0

SO2.1

SW1

500

200

0

SO3.1

SW2

500

200

0

Total

 

700

400

0

RPRO-00605 - Second level allocation is not performed as the second level allocation identifier does not exist in the transaction

Second-Level Allocation error occurs when the ENABLE_LVL2_ALLOCATION profile is configured to Yes due to the transaction's absence of a second-level allocation identifier. for further information.

Scenario

Recommended solution

The second-level identifier field is mapped incorrectly in the profile.

Complete the following steps to review if the second-level identifier is configured correctly:

  • Navigate to Setups > Application > Profiles and search for the LVL2_ALLOC_IDENTIFIER profile
  • Hover the mouse above the LVL2_ALLOC_IDENTIFIER line
  • Click the edit icon
  • Review the System Level Value field to see if your configuration is accurate
  • Change the configuration if needed
  • Reallocate the revenue contract

The second-level identifier field is mapped correctly, but the identifier field is missing from the transaction.

  • Identify why the identifier field is not populated
  • Reverse the transaction in the source system
  • Resend a new transaction with accurate values to ZR for processing

The transaction is sent incorrectly with the CV Eligible LVL2 Flag as Y. Second-level allocation is not expected in this scenario. 

  • Identify the root cause of the incorrect flag
  • Reverse the transaction in the source system
  • Resend a new transaction to ZR with the correct flag for processing

RPRO-00606 - Second level allocation is not performed as the sum of second level allocation % is not equal to 100%

Second-Level Allocation is turned on but the total percentage of the second-level allocation within the same second-level allocation group does not equal to 100%. 

Scenario

Recommended solution

The percentage of the allocation is sent incorrectly

  • Review the Lvl2 Allocated Percent field within the second-level allocation group and identify the root cause of the incorrect percentage in the source system
  • Reverse the transaction in the source system
  • Resend a new transaction with correct values to ZR for processing

A second-level allocation eligible line is not processed due to an error in inbound data.

  • Identify the errored second-level allocation eligible line  in the inbound
  • Review and resolve the errored transaction in the inbound data
  • Re-collect the transaction to populate the second-level allocation

RPRO-00607 - SSP allocation is not performed as unable to derive SSP.

This error occurs when ZR cannot derive the SSP from a transaction. See  SSP setup for additional information.

Scenario

Description

Recommended solution

The SSP template is not active for the current period

Each template has a start date and end date. Confirm the dates on templates related to the impacted transactions and ensure they are still active for the current period.

  • If the templates are incorrectly ended:
    • Update or clear the end date
    • Re-allocate the revenue contract

When the template is reactivated, this update may impact other transactions.

  • If the templates are ended correctly:
    • Create a new template
    • Re-allocate the revenue contract

ZR considers a period or an extra space an exception, resulting in an SSP error. 

The values to define the SSP grouping are not valid or do not exist

For each attribute used for SSP determination, you must define the expected values for ZR to look up the SSP

  • Review the values specified in the SSP template. Confirm and match the values in the transactions to the SSP template.
  • If the values do not exist or are misspelled in the template, insert the end date to deactivate the impacted SSP template
  • Copy the previous SSP template and set a new start date
  • Add or correct the values in the template.
  • Reallocate the revenue contract

ZR considers a period or an extra space an exception, resulting in an SSP error. 

 RPRO-00608 - The transaction is not processed due to other errors in the bundle. Review and fix the errors on the bundle line(s) for further processing

This error occurs when any lines within the bundle encounter another error. Review and fix the error on the bundle line  and re-collect the lines in ZR.

The following example shows bundle lines using the  Bundle Parent Line ID. The parent and child transaction lines have the same ID values.

Item

Bundle Parent Line ID

Parent sku

SO123-1

Child sku 1

SO123-1

Child sku 2

SO123-1

RPRO-00609 - Discount charge line is not processed due to missing parent charge line in the system

Scenario

Description

Recommended solution

Incorrect configuration in Zuora Billing for a parent charge.

The Exclude item booking from revenue field in Zuora Billing is configured as Yes for a parent charge resulting in the parent charge not being synced to ZR.

  • Update the Exclude item booking from revenue field in Zuora Billing for the parent charge
  • Contact the Zuora support team to re-sync the parent charge to ZR

The parent and discount charges should be excluded from ZR.

The Exclude item booking from the revenue field in Zuora Billing is incorrectly configured to No for a discount charge and synced to ZR.

  • Update the Exclude item booking from revenue field in Zuora Billing for the discount charge
  • Delete the discount charge from the inbound

The parent charge line has not been processed due to other errors.

Use Parent Charge Num and Parent Charge Segment to identify the parent charge line in the inbound. Both parent and discount charges have the same values in both fields. 

  • Identify the error on the parent charge line in the inbound 
  • Review and resolve the errors on the parent charge
  • Re-collect both parent charge and discount charge

The parent charge line from the source system is missing.

Technical errors have caused the parent charge line not to sync to ZR.

 RPRO-00610 - The SO cancellation line is not processed due to outstanding billed quantity on the line

The SO cancellation line with a cancel flag configured as Y is not processed because the billed quantity on the SO line in the system is not fully canceled. To consume the SO cancellation line, the net billed quantity on the line must be zero.

Scenario

Description

Recommended solution

The SO cancellation line is not valid 

Incorrect cancellation sent from the source system

  • Review and investigate the intent of the cancellation from the source system If the SO line in ZR still has the outstanding billed quantity 
  • Delete the errored SO cancellation record from the inbound data
  • Correct the booking in the source system

The SO cancellation line is valid, but the billed quantity is not fully canceled

See example below

  • Identify why the billed quantity on the SO line in the system is not offset to zero
  • Generate the credit memo (CM-C) to ZR
  • Collect the SO cancellation

Scenario 2 Example: 

The original SO has a quantity of 10, and two billed invoices with a total quantity of 7. When the SO cancellation is processed, the total billed quantity is 7, as no credit memo is processed to reduce the billed quantity.

Type

SO Line ID

INV Num

INV Line ID

Orig INV Line ID

Quantity

SO

SO123-1

     

10

INV

SO123-1

INV1

INV1.1

 

5

INV

SO123-1

INV2

INV2.1

 

2

Solution: 

Create a credit memo (Tran Type is CM-C) to reduce the billed quantity.

Type

SO Line ID

INV Num

INV Line ID

Orig INV Line ID

Quantity

CM-C

SO123-1

CM1

CM1.1

INV1.1

5

CM-C

SO123-1

CM2

CM2.1

INV2.1

2

RPRO-00611 - The SO update line is not processed because the Ext Sell Price (ESP) of the SO update line is less than the total invoiced (INV and CM-C) amount in the system

To consume the SO update line, its ESP must be equal to or greater than the total invoiced amount (INV and CM-C) in the system.

Scenarios

Descriptions

Recommended solution

SO update line is not valid

Incorrect update sent from the source system

  • Review and investigate the intent of the ESP update from the source system.
  • Delete the errored SO record from the inbound data
  • Update the line from the inbound data
  • Correct the booking in the source system

The new ESP on the SO update line is valid but the invoiced amount (INV and CM-C) is greater than the new value.

A credit memo must be created to reduce the billed amount

  • Process the credit memo before collecting the SO update line.

    See the below examples for further details.

Example A: 

The original SO has an ESP of $1000, and two invoices totaling $700 have been billed. 

An SO update line with an ESP of $500 is sent to ZR, and this error appears. The ESP is less than the total billed amount of $700.

In this situation, ZR only accepts a SO update with an ESP of $700 or above.

Type

SO Line ID

INV Num

INV Line ID

Orig INV Line ID

Amount

SO

SO123-1

     

$1000

INV

SO123-1

INV1

INV1.1

 

$500

INV

SO123-1

INV2

INV2.2

 

$200

Solution: If the intent is to update the SO with an ESP of $500, generate a credit memo(Tran type CM-C) to cancel the invoice, which reduces the invoiced amount to $500 ($500+$200-$200). The SO update with an ESP of $500 will then be processed.

Type

SO Line ID

INV Num

INV Line ID

Orig INV Line ID

Amount

CM-C

SO123-1

CM1

CM1.1

INV2.2

-$200

Example B:

The original SO has an ESP of $1000. Two invoices totaling $700 and a CM-C of—$200 have been billed, for a total invoiced amount of $500. 

An SO update line with ESP of $300 is sent to ZR and this error appears. The SO update line has $300 ESP, which is less than the total billed amount of $500.

In this situation, ZR only accepts an SO update with an ESP of $500 or above.

Type

SO Line ID

INV Num

INV Line ID

Orig INV Line ID

Amount

SO

SO123-1

     

$1000

INV

SO123-1

INV1

INV1.1

 

$500

INV

SO123-1

INV2

INV2.2

 

$200

CM-C

SO123-1

CM1

CM1.1

INV2.2

-$200

Solution: If the intent is to update the SO with an ESP of $300, generate a credit memo (Tran type CM-C) to cancel the invoice, which reduces the invoiced amount to $0 ($500+$200-$200-$500). ZR will then process the SO update with an ESP of $300.

Type

SO Line ID

INV Num

INV Line ID

Orig INV Line ID

Amount

CM-C

SO123-1

CM2

CM2.1

INV1.1

-$500

RPRO-00612 - The SO update line is not processed because the Ext Sell Price (ESP) of the SO update line is less than the total credit memo (CM and CM-R) amount in the system

This error occurs when the new ESP exceeds the total SO-based CM/CM-R amount on the line. A credit memo referencing the SO by using SO Line ID (Orig INV Line ID is blank) is considered an SO-based credit memo.

Example A: 

Month 1 —  The original SO has an ESP of $1000 and an invoice of $500 has been issued.

Type

SO Line ID

Ext Sell Price

Net Sell Price

 

Type

SO Line ID

INV Num

INV Line ID

Invoice Amount

SO

SO123-1

$1000

$1000

 

INV

SO123-1

INV1

INV1.1

$500

Month 2 — A SO-based CM of $-700 is generated.

The credit memo ($700) is more than the invoice ($500), assuming the $200 invoice will be processed in the future.

Type

SO Line ID

Ext Sell Price

Net Sell Price

 

Type

SO Line ID

INV Num

INV Line ID

Invoice Amount

SO

SO123-1

$1000

$300

 

CM

SO123-1

CM1

CM1.1

-$700

If the new ESP is $600 on the SO update, the line will not be processed. In this scenario, ZR will accept only an SO update with an ESP of $700 or above.

Solution:  If the intent is to update the SO with an ESP of $600, complete the following steps:

  1. Reverse the CM1 in the source system.

 The CM and CM-R reversal transaction types also have the Tran type as CM and CM-R, respectively, with a cancel flag configured as Y.

  1. Reverse the $200 Invoice pending processing.
  2. Process the SO update with the ESP of $600.

As a result, the current ESP on the booking is $600. The net invoiced amount is $500. $100 is pending for billing.

The above example and the suggested solutions also apply to SO-based CM-R scenarios.

RPRO-00613 - The SO update line is not processed because the Ext Sell Price (ESP) of the SO update line is less than the revenue recognized in the system

The error is only applicable for transactions relevant to consumption POBs.

Scenarios

Description

Recommended solution

The new ESP on the SO update line is valid but the revenue recognized is greater than the new ESP value.

Consumption revenue is overstated.

  • Reverse the overstated revenue by processing negative usage before collecting the SO update line

Manually deferring revenue on a consumption POB line is not allowed.

SO update line is NOT valid.

Incorrect update sent from the source system.

  • Review and investigate the intent of the ESP update from the source system
  • Delete the errored SO Update line from the inbound data
  • Correct the booking in the source system

RPRO-00614 - The SO update line is not processed due to the start date mismatch between the SO update line and the SO line in the system

This error occurs when the start date of the SO update line does not match the start date of the SO line in the system. 

If the SO line in the system has not yet released revenue, an SO update line with a new start date will be processed. This error only applies to the lines with revenue released.

Scenario

Description

Recommended solution

The new start date on the SO update line is valid

The revenue recognition started with an incorrect date from the previous SO line

  • Manually defer the revenue
  • Re-collect the SO update line and the revenue will be released accordingly

The new start date on the SO update line is not valid

Incorrect update sent from the source system

  • Review and investigate the intent of the update from the source system
  • Delete the errored SO update line from the inbound
  • Correct the booking start date in the source system 
  • Resend the SO update line to ZR if needed

RPRO-00615 - The SO update line is not processed due to the RTB flag mismatch between the SO update line and the SO line in the system

The Right to Bill (RTB) flag on the SO update line and the SO line in the system must be the same. If the SO line in the system does not have any released revenue, the SO update line with a new RTB value will be processed. The error applies to the lines with released revenue.

See SO accounting entries with RTB flag for more information. 

Scenarios

Description

Recommended solution

RTB flag was sent incorrectly in the past. The SO update line is to change the RTB flag. 

RTB flag defines unbill AR vs. CA/CL classification. Due to the incorrect RTB flag sent in the past, the current accounting on Unbill AR vs CA/CL classification in the RC is not correct. 


 
  • Debook the entire order in the source system
  • Rebook a new order with the correct RTB flag

An SO update to change the RTB flag is not recommended, as the accounting results on the Unbill AR vs. CA/CL classification may not be as you expect. 

RTB flag on an SO update line is not valid. 

Incorrect update sent from the source system.

  • Review and investigate the intent of the update from the source system
  • Delete the errored SO update line from the inbound
  • Correct the RTB flag in the source system

RPRO-00616 - The SO update line is not processed due to different signage of the Ext Sell price between the SO update line and the SO line in the system

The Extended Sell price (ESP) signage on an SO update line and the SO line in the system must be the same.

Scenarios

Description

Recommended solution

The new ESP signage on the SO update line is not valid.

Incorrect update sent from the source system.

  • Review and investigate the intent of the update from the source system
  • Delete the errored SO update line from the inbound 
  • Correct the ESP in the source system

The new ESP signage on the SO update line is valid.

It is rare to send a SO update with different signage on ESP. For example, change the value of the  ESP from +$1,000 to -$1,000.

  • Delete the errored SO update line from the inbound
  • Debook the line in the source system
  • Rebook a new line with the correct ESP in the source system

RPRO-00617 - The SO update line is not processed as the original line was a system-generated SO line

A system-generated SO line has the SO Line ID beginning with REVPRO and is created when an invoice or a credit memo does not reference to any SO. This error occurs when the SO Line ID is blank.

Currently, the system does not support any SO update line on a system-generated SO line. If an update is needed, complete the following steps:

  • Delete the errored SO update line from the inbound data.
  • Reverse the invoice or credit memo in the source system and collect them in  ZR to offset the existing transaction.
  • Resend the invoice or credit memo with the correct values on the attributes or flags to ZR for processing.

RPRO-00619 - The INV line is not processed as the associated SO line in the system is canceled

This error occurs when the associated SO line is already canceled. 

Scenarios

Recommended solution

The invoice line is not needed

  • Review and investigate the intent of the invoice transaction from the source system.
  • Reverse the INV from the source system
  • Delete the errored transaction from the inbound table

No subsequent billings are expected on the line as the SO line is canceled. 

The invoice line is needed but has an incorrect reference ID to the canceled SO

  • Identify the correct reference ID
  • Reverse the invoice from the source system
  • Resend the invoice with the correct reference to an active SO
  • Delete the errored transactions from the inbound

The invoice line is needed, but the SO line was incorrectly canceled in ZR previously

  • Identify why the SO line was previously canceled in the system
  • Reverse the invoice 
  • Rebook a new SO and generate INVs from it.

Once an SO is canceled, ZR does not support reversing the SO cancellation.

RPRO-00620 - The RORD line is not processed as the associated SO line in the system is canceled

Scenarios

Recommended solution

The RORD line is not needed or duplicate.

  • Review and investigate the intent of the RORD transaction from the source system
  • Reverse the RORD from the source system
  • Delete the errored transaction from the inbound table

No additional RORD is expected on the line after the cancellation of SO.

The RORD line is needed but has an incorrect reference ID to the canceled SO.

  • Identify the valid SO line for the RORD in the source system
  • Reverse the de-booking action from the source system
  • Re-send the RORD line with the correct reference to an active SO
  • Delete the errored transactions from the inbound table

RPRO-00621/RPRO-00657 - The credit memo line is not processed as the credit memo amount is greater than the amount of the associated INV

This is a data issue in the upstream system when the credit memo amount exceeds the referenced invoice amount. Review and confirm the credit memo amount against the associated invoices. Correct the credit memo in the source system and re-send it to ZR.

For Zuora’s OTR customers, this error occurs when the applicable invoice was previously fully or partially offset by other ad-hoc credit memos. Please contact Zuora Global Support for further assistance.

It is recommended that an ad-hoc credit memo from ZB be treated as a standalone credit memo in ZR.  This is to prevent data corruption.  By setting the original invoice line ID as null on the ad-hoc credit memo before ZR collection will ensure proper data and accounting results.

RPRO-00622 - The INV line is not processed as this INV transaction will overstate the SO sell price

The ALLOW_OVERSTATED_INVOICE profile is configured for handling your company’s policy on the allowance or disallowance of overbilling on a stated booking. Once the profile is updated, ZR applies the rule setting to all future transactions.  

This error occurs when the ALLOW_OVERSTATED_INVOICE profile is configured to No. Based on the profile configuration, the system will not collect any invoice transactions if the total billed amount exceeds the original booking amount (net selling price).

Scenarios

Recommended solution

The invoice line is not needed

  • Identify why the invoice was created in the source system.

  • Reverse the invoice from the source system.

  • Delete the errored invoice transaction from the inbound table.

ALLOW_OVERSTATED_INVOICE profile configuration is not correct

  • Navigate to Setups > Application > Profiles and search for the ALLOW_OVERSTATED_INVOICE profile.

  • Click the edit icon.

  • Toggle the System Level Value field to Yes.

RPRO-00623 - The INV line is not processed as this INV transaction will overstate the SO quantity

The ALLOW_OVERSTATED_INVOICE profile is configured for handling your company’s policy on the allowance or disallowance of overbilling on a stated booking. Once the profile is updated, ZR applies the rule setting to all future transactions.  

This error occurs when the ALLOW_OVERSTATED_INVOICE profile is configured to No. Based on the profile configuration, the system will not collect any invoice transactions if the total billed quantity exceeds the original quantity on the SO.

Scenarios

Recommended solution

The invoice is not needed

  • Identify why the invoice was created in the source system

  • Reverse the invoice from the source system

  • Delete the errored invoice transaction from the inbound table

ALLOW_OVERSTATED_INVOICE profile configuration is not correct

  • Navigate to Setups > Application > Profiles and search for the ALLOW_OVERSTATED_INVOICE profile.

  • Click the edit icon.

  • Toggle the System Level Value field to Yes.

RPRO-00624/RPRO-00654 - The credit memo line is not processed as the referenced INV does not exist in the system

This error occurs when the original Invoice Line ID on the credit memo does not exist in the system. 

Scenarios

Recommended solution

The credit memo line is needed, but the reference ID is not correct

  • Identify the correct reference ID in the source system.
  • Reverse the credit memo in the source system
  • Re-send the credit memo with the correct reference to ZR
  • Delete the errored transactions from the inbound table

The referenced invoice is in inbound due to other errors

  • Identify the errored invoice transaction in the inbound file
  • Review and resolve the errors on the referenced invoice
  • Collect the invoice to process the credit memo accordingly

The referenced invoice is not sent or synced into ZR

  • For OTR customers, please contact  Zuora Global Support for further assistance.
  • For non OTR, complete the following steps:
    • Identify why the invoice line was not sent or synced to ZR
    • Re-send or sync the invoice to ZR
    • Collect the invoice to process the credit memo accordingly.

RPRO-00625 - The CST line is not processed as the cost type does not match with the cost type for the specific POB template of the SO line

Scenarios

Description

Recommended solution

The cost type value is not properly configured in ZR.

Correct cost type value is sent from the source system but the value is not set up correctly in ZR.

  • Navigate to Policies > Performance Obligations
  • Select the applicable POB template and edit the template as required
  • Under the Cost Treatment tab, add the cost type
  • Collect the CST line accordingly

The cost type value on the CST line is not valid.

Incorrect cost type value sent from the source system.

  • Identify the root cause of the incorrect values in the source system
  • Delete the errored transaction from the inbound table
  • Re-send the transaction with the correct values from the source system to ZR
  • Collect the CST line accordingly

RPRO-00626 - Encountered Internal error - Please contact the support team for further assistance

This error occurs when a transaction encounters internal errors. Please contact  Zuora Global Support for further assistance.

RPRO-00627 - The transaction line is not processed as the revenue end date is before the revenue start date

The revenue start date must be before or equal to the revenue end date.

Type

Recommended solution

OTR customer

  • Please contact  Zuora Global Support or your system administrator for further assistance to review if the error is due to customizations or data augmentation.

Standalone Zuora Revenue customer 

  • Identify the root cause of the incorrect dates in the source system
  • Delete the errored transaction from the inbound table.
  • Re-send the transaction with the correct dates from the source system to ZR.

RPRO-00628 - The transaction is not processed as both Def Offset and Rev Offset segments have values

Under offset accounting setup and requirements, only one type of offset segment (Def Offset or Rev Offset) is allowed. See Offset accounting for additional information.  

Complete the following steps to resolve the error:

  • Identify why both the segment values are sent to ZR for an impacted line.

  • Reverse the transaction in the source system.

  • Re-send the transaction with the proper segment values from the source system to ZR.

RPRO-00629 - The transaction line is not processed as the "Tran Type" value is not valid

Scenario

Description

Recommended Solution

The value of the transaction type is not valid. 

The following are the supported transaction types:

  • SO
  • INV
  • CM
  • CM-C
  • CM-R
  • CM-D
  • CM-VC
  • INV-VC
  • CST
  • RORD
  • CM-RO
  • Identify the root cause of the incorrect transaction type in the source system  
  • Reverse the transaction in the source system
  • Re-book the transaction and send it to ZR
  • Delete the errored records in the inbound table 

RPRO-00630 - The SO line is not processed due to missing SO line id

Scenarios

Description

Recommended solution

Missing SO Line ID

All SO lines must have an SO Line ID value.

For Non-OTR: 

  • Identify the root cause of the missing SO Line ID in the source system. 
  • Delete the errored transaction from the inbound table. 
  • Re-send the transaction with the correct SO Line ID from the source system.

For OTR:

Please contact  Zuora Global Support for further assistance.

RPRO-00631 - The CST line is not processed due to missing Cost amount

Scenario

Description

Recommended solution

The Cost amount is missing

Cost amount is required for all CST lines.

  • Identify the root cause of the missing cost amount in the source system.
  • Delete the errored transaction from the inbound table. 
  • Re-send the transaction with the correct cost amount from the source system.

RPRO-00632 - The CST line is not processed due to missing Cost Type Name

Scenarios

Description

Recommended solution

Cost Type Name is missing

CST line requires to have Cost Type Name

  • Identify the root cause of the missing Cost Type Name
  • Delete the errored transaction from the inbound
  • Re-send the transaction with the correct values on Cost Type Name from the source system

RPRO-00633/RPRO-00634 - The CST line is not processed due to invalid Cost type name

All CST lines require a valid Cost Type Name. Cost Type ID should be blank.

Scenarios

Description

Recommended solution

The Cost Type Name value is invalid

Cost Type Name should match with the names already set up in ZR for all CST lines

Note: ZR considers a period or an extra space as an exception

  • Identify the root cause of the invalid Cost Type Name in the source system
  • Delete the errored transaction from the inbound
  • Re-send the transaction with the correct name from the source system

RPRO-00635 - The transaction is not processed due to missing INV line ID
 

Scenarios

Description

Recommended solution

The INV Line ID is missing

INV Line ID is required for the below Tran Types:

  • INV
  • CM
  • CM-C
  • CM-R
  • RORD
  • CM-RO

For Non-OTR:

  • Identify the root cause of the missing INV Line ID in the source system.
  • Reverse the transaction in the source systems
  • Re-process the transaction with the correct ID
  • Delete the errored transactions from the inbound table.

For OTR:

Please contact  Zuora Global Support for further assistance.

RPRO-00636 - The INV line is not processed as Orig SO line ID should be blank
 

Scenarios

Description

Recommended solution

The Orig SO Line ID contains a reference.

The INV Tran Type lines do not require any Orig SO Line ID’s reference.

For Non-OTR:

  • Identify why the Orig SO Line ID is populated in the INV transaction. 
  • Reverse the INV transaction in the source system.
  • Re-process the INV transaction without any Org SO Line ID.
  • Delete the errored transactions from the inbound table.

For OTR::

Please contact  Zuora Global Support for further assistance.

 RPRO-00637 - The credit transaction line is not processed as both Orig INV line ID and Orig SO line ID have references. Only one reference is allowed on a credit transaction

Scenarios

Description

Recommended solution 

Both Orig INV Line ID and Orig SO Line ID have references.

Only one reference (Orig INV Line ID or Orig SO Line ID) is needed for credit transactions.

For Non-OTR: 

  • Identify why both reference IDs are populated on the credit transactions in the source system
  • Determine which reference ID is needed on the transaction. 
  • Reverse the transaction in the source system and re-process the credit transaction with the correct reference ID.
  • Delete the errored transactions from the inbound

For OTR: Please contact  Zuora Global Support for further assistance.

RPRO-00638 - The CMC line is not processed due to missing references. Either Orig INV line ID and Orig SO line ID should have a reference
 

Scenario

Description

Recommended solution 

The line is either missing an Orig INV Line ID or an Orig SO Line ID

A reference to the originating transaction (Orig INV Line ID or Orig SO Line ID) is required for credit transactions.

For Non-OTR:

  • Identify why the reference IDs are not populated on the credit transactions in the source system
  • Determine which reference ID is needed on the transaction
  • Reverse the transaction in the source system and re-process the credit transaction with the correct reference ID
  • Delete the errored transactions from the inbound table

Note: For Non-OTR, referencing a CM-C to a SO (using the Orig SO Line ID) may result in incorrect accounting from future transactions. Zuora recommends you reference a CM-C to an invoice (using Orig INV Line ID). 

For OTR: contact  Zuora Global Support for further assistance
 

RPRO-00639 - The SO line is not processed due to invalid impairment type values

Scenario

Description

Recommended solution 

Impairment type value is invalid

To process a contract impairment accounting, the system requires an Impairment type. The value on the Impairment type field must be blank or should contain one of the following:

  1. Contract Impairment
  2. New POB
  3. R AND R within SSP
  4. Retrospective
  5. New POB Immediate
  6. New POB Ratable
  • Identify the root cause of the incorrect impairment type
  • Re-send the transaction with the correct impairment type to ZR
  • Delete the errored transactions from the inbound table

See Contract Impairment for further details.

RPRO-00641 - The CST line is not processed as the cost management module is not enabled
 

Scenario

Description

Recommended solution

The cost management module is not enabled

The CST lines are used for cost accounting.

The cost management module must be enabled to process CST lines. 

Note: Cost management is an add-on module. 

  • Contact your Customer Success Manager for more information about the Cost module
  • Delete the errored transaction from the inbound if the CST line was sent by mistake

 

RPRO-00642 - The SO line with cost amount is not processed as the cost management module is not enabled

Scenarios

Description

Recommended solution

The cost management module is not enabled

Cost Amount is used for cost accounting. The cost management module must be enabled to process the SO lines with cost amounts.

Cost management is an add-on module

  • Contact your Customer Success Manager for more information about the Cost module

  • Delete the errored transaction from the inbound if the CST amount was sent by mistake


 

RPRO-00643 - Revenue on the child POB is not released as the revenue on the parent POB is not released

The revenue on a parent's POB must first be released before a Child POB can be released. Under the POB template setup, the child POB is set up with a POB dependency and links to a parent POB. 

Navigate to Policies > Performance Obligations to locate the applicable POB template and access the POB dependency to review the setup.

Scenarios

Recommended solution 

Revenue on parent POB is not released

  • Identify why the revenue on the parent POB is not released
  • Release the parent POB if applicable
  • After the revenue of the Parent POB is released, release the child POB accordingly

The POB dependency setup is not correct

  • If the impacted line is not expected to link with other POBs, review the POB dependency setup and adjust it accordingly
  • After fixing the dependency, release the impacted line accordingly

RPRO-00644 - Revenue is not released as both revenue start date and revenue end date are outside of the ZR accounting calendar

Navigate to Setups > Applications > Accounting Calendar to review the calendar. To release the revenue, the periods associated with the start date and end date must be set up correctly in ZR to release the revenue.

Scenarios

Recommended solution 

The revenue start and end dates are not correct

  • Identify the root cause of the incorrect dates in the source system
  • Reverse the transaction in the source system
  • Resend a new transaction to ZR for processing
  • Delete the errored transactions from the inbound table

The revenue start and end dates are accurate, but the periods are not available in the ZR accounting calendar

  • Contact the Zuora Global Support for further assistance to extend the accounting calendar
  • Process the line again once the calendar is extended

RPRO-00645 - Encountered Internal error - Please contact the support team for further assistance

The transaction encounters internal errors. Contact the Zuora Global Support for further assistance.

RPRO-00646 - The SO for the deleted amendment is not processed as the same deleted amendment was previously processed in ZR

This error applies to OTR only and is applicable if the CONSUME_DELETED_TRANSACTION profile is configured to Yes.   
 

Scenario

Description

Recommended solution

Duplicate deleted amendment SO

The deleted amendment SO line was previously processed in ZR

Delete the duplicated line from the inbound table.

RPRO-00647 - The SO with previous charge version is not processed and the same charge version was previously processed in ZR

This error applies to OTR only.

Scenario

Description

Recommended solution

A duplicate SO line with the previous charge version was sent to ZR

The SO line with the previous charge version was already processed in ZR

Delete the duplicate line from the inbound table.

RPRO-00648 - The transaction is not processed as it is associated with the charge version not existed in ZR

This error normally occurs when the associated SO lines have a future SO book date. ZR does not collect any transactions beyond the current open period. 

Scenario 1 - Invoiced in the current period but it is associated with a version not collected into ZR. 

This scenario is applicable when the Past End-of-Term profile is turned on in ZB. See billing rules to understand the implications of billing transactions. 

Example:

On Jan 1, 2024, a subscription is booked and is partially billed.

Tran Type

SO Line ID

Version

Book Date

Invoice Date

Amount

Revenue Start Date

Revenue End Date

SO

SO1.1

1

1/1/24

 

1000

1/1/24

12/31/24

INV

SO1.1

1

 

1/1/24

500

1/1/24

6/30/24

On July 1, 2024, a new charge to the subscription was added, and version 2 was created with August 2024 as the booking date. In the open period of July 2024, the system will not consume these SO transactions as the booking date is in the future.

Tran Type

SO Line ID

Version

Book Date

Invoice Date

Amount

Revenue Start Date

Revenue End Date

SO

SO1.1

2

8/1/24 *

 

1000

1/1/24

12/31/24

SO

SO2.1

2

8/1/24 *

 

800

8/1/24

12/31/24

 Note -  These transactions are not collected in ZR in the month of July 2024.

In the same period in July 2024, a bill run generates an invoice on the first charge. As the Past End-of-Term profile is turned on for the invoice, the invoice on the first charge can bill more than the initial booking values for the period beyond the initial term end date of the charge.

Tran Type

SO Line ID

Version

Book Date

Invoice Date

Amount

Revenue Start Date

Revenue End Date

INV

SO1.1

2

 

7/15/24

550

1/1/24

1/31/25

During the current period of July 2024, the system will error out the INV even if the invoice date is in the current period. The INV is referenced to SO1.1 (Version 2), where the Book Date is in August 2024, which is not collected in ZR in July 2024

Scenario 2—The proration credit memo is for the current period, but the amendment date is in the future. 

On January 1, 2024, a subscription is booked and fully billed.

Tran Type

SO Line ID

Version

Book Date

Invoice Date

Amount

SO

SO1.1

1

1/1/24

 

1000

INV

SO1.1

1

 

1/1/24

 

On February 1, 2024, amend the subscription to reduce the price to $600 with the book date of March 1 2024. However, a proration credit memo is generated for $400 on February 1 2024

Tran Type

SO Line ID

Version

Book Date

Invoice Date

Amount

SO

SO1.1

2

3/1/24 *

 

600

CM-C

SO1.1

2

 

2/1/24

-400

Note - This transaction is not collected in ZR in the month of February 2024.

During the current period of February 2024, the system will not process the SO with the future book date. Although the credit memo has the date in February 2024, the system will error out the credit memo as it is tied to Version 2 amendment.

For both scenarios above, it is not recommended that amendments be made with a future date as the system would not consume such bookings. For the impacted line,

  • Recommended Solution 1—Do not take action in the current period on future SO bookings and the associated invoice or credit memo. Postpone the collection until the respective SO period is open. 

Postponing the collection on both SO and invoice/credit memo will result in discrepancies in different areas.

  • Reconciliation of discrepancies in the booking and billing between ZB and ZR.

  • Reconciling variances between revenue contract roll forward report and general ledger.

  • Billed and unbilled revenue classification discrepancies may lead to different CA/CL netting or unbilled AR results.

  • Revenue recognition discrepancies depend on the POB types. For example, upon billing POB.

  • Recommended Solution 2 - If waiting for the future date to mature is not an option, contact the Zuora Global Support for further assistance to resolve the SO book date issue.

For other scenarios not listed above, contact the Zuora Global Support for further assistance.

RPRO-00650 - The ramp allocation is not performed due to inconsistent average pricing methods under the same ramp group

Term and Volume are two average pricing methods for ramp allocation. Under the same Ramp group defined by you using the RAMP_DEAL_REF, only one method is allowed for the ramp calculation. 

Scenario

Recommended solution

Inconsistent methods under the same ramp group

  • Identify the root cause of the incorrect method sent to ZR
  • Re-send the transaction with the correct AVG_PRCING_MTHD value to ZR to populate the ramp allocation

If the transaction has no value under the AVG_PRCING_MTHD, ZR will consider the method based on the setup under the AVERAGE_PRICING_METHOD profile. If the transaction uses the Term or Volume method from the source system, the transaction values will supersede the defaulted method.

See Ramp allocation for more information about the ramp configuration and calculations.

RPRO-00651- Ramp allocation under the same ramp deal does not result in straight-line revenue. A hold is applied to the RC

This error occurs when the per-day-per-unit rate is not the same across all the ramp lines. Revenue is not recognized on a straight-line basis under the same ramp group. A hold is applied to the RC for you to review further.

Scenarios

Recommended solution

Rounding issues 

  • Review the Net Revenue waterfall for the differences on the ramp lines.
  • If the differences are acceptable, release the hold in the revenue contract. 

Note: The RAMP_HOLD_THRESHOLD profile is to set the threshold for rounding differences. This error will not appear if the per-day-per-unit difference is within the defined threshold.

Other scenarios 

  • Contact the Zuora Global Support for further assistance.
  • After the issue is resolved, release the hold in the RC


See Ramp allocation for more information about unit rate calculation.

RPRO-00664 - The transaction line is not processed due to invalid book ID

Scenario

Recommended solution

The value of the Book ID is blank or invalid

  • Identify the root cause of the invalid value in the source system.
  • Re-send the transaction with the correct value to ZR.
  • Delete the errored transaction in the inbound table.