Overview

Required plan

This feature or setting is available to all customers on any Recurly subscription plan.

Definition

The Doc Stage Report displays billing transactions that are currently stuck in the doc stage of Recurly Revenue Recognition. By default, the report includes the Processed Flag and Error Message columns. This guide explains the steps to access, customize, and download the report to help diagnose and resolve issues with billing transactions in the doc stage.

Guide

Accessing and configuring the report

To access and configure the Doc Stage Report:

Navigate to the Report:
- Go to Reports and select Doc Stage Details Report from the menu.
Access the Mapper:
- Locate and open the report's Mapper tool.
Add Required Columns:
- Within the Mapper, select and add the specific attributes you wish to include. Note that only doc level attributes are available in the mapper, in addition to the contract ID, subscription, and order line.
Run the Report:
- Click the Run button to generate the report.
- Optionally, click the Download button to save the report locally.

Report columns

Processed Flag: Indicates whether a transaction has been successfully completed. A flag of "E" indicates that the transaction has encountered an error, while "N" indicates that it has not been processed.
Error Message: Provides details about any errors encountered during processing.

Doc stage errors

The following table outlines the possible error messages and their potential causes within the Doc Stage Report:

Error Message	Possible Reason
Invalid References on INV	Please correct the invalid references in the invoice to process these lines.
Invalid INV. INV belongs to Material Right Contract	The invoice is invalid as it belongs to the material right contract. This cannot be collected.
Bill Amount is incorrect	The bill amount mentioned in the file is incorrect.
Original Credit Memo does not exist or already Cancelled	When a credit memo cancellation is uploaded with incorrect reference invoice details that do not exist in the system, this error occurs. The solution is to reupload the file with correct reference invoice details.
Original Invoice does not exist or already Cancelled	When a credit memo is uploaded with incorrect reference invoice details that do not exist in the system, this error occurs. The solution is to reupload the file with correct reference invoice details.
Original Invoice does not exist	When a credit memo is uploaded with incorrect reference invoice details that do not exist in the system, this error occurs. The solution is to reupload the file with correct reference invoice details.
Invalid INV. SO not present in System	When the invoice is loaded for a sales order that does not exist in the system, this error occurs.
CM cannot be processed as INV is in error	This will occur when the original invoice is in error status in the stage area. The solution is to review the reason for the invoice error.
Cumulative bill amount is over sell price	This error occurs when overage is not allowed under profiles and the sum of invoice values for the subscription exceeds the sell price. The solution is to navigate to profiles → Overage and enable overage.

FAQ

Q: What should I do about an “Invalid References on INV” error? A: The reference invoice number or invoice line number is incorrect. Check and correct the reference invoice details, then reprocess.

Q: Why did I get “Invalid INV. INV belongs to Material Right Contract”? A: An invoice is associated with a Material Right contract line, which isn’t allowed. Remove the invoice information from the Material Right line.

Q: How do I resolve a “Bill Amount is incorrect” error? A: The bill amount is wrong. Validate the amount on the bill and correct it before reprocessing.

Q: What does “Original Credit Memo does not exist or already Cancelled” mean? A: You attempted to cancel a credit memo using reference details that don’t match an existing, active credit memo. Re-upload the cancellation with the correct reference details.

Q: How do I fix “Original Invoice does not exist or already Cancelled” or “Original Invoice does not exist”? A: A credit memo references an invoice that doesn’t exist or was already cancelled. Correct the reference invoice details in your upload and reprocess.

Q: Why am I seeing “Invalid INV. SO not present in System”? A: The invoice references a Sales Order (SO) that isn’t in the system. Reprocess the file using a valid, existing SO number.

Q: How do I resolve “CM cannot be processed as INV is in error”? A: You’re processing a Credit Memo (CM) against an invoice currently in an error state. Fix the invoice error first; once the invoice processes successfully, submit the CM.

Q: What causes “Cumulative bill amount is over sell price”? A: Total invoiced value for the subscription exceeds the sell price, and over-billing isn’t allowed. Go to Profiles → Overage and enable the overage setting (if appropriate for your policy).