Revenue Management API Developer Reference

ffrr.RRTCreateJournalsService

global with sharing class RRTCreateJournalsService

Methods

createRRTToJournalAsync

global static Set<Id> createRRTToJournalAsync(ffrr.RRTCreateJournalsService.CreateJournalRequest integrationRequest)

This method creates accounting journals for specified recognition transactions. Information is passed between Revenue Management and Accounting via Foundations using the Journal.Create message type. NOTE: Journal lines can be created from recognition transaction lines or from recognition transaction summaries depending on the createJournalUsingSummaries boolean parameter passed into the integrationRequest.

Input Parameters

Name Type Description
integrationRequest ffrr.RRTCreateJournalsService.CreateJournalRequest Structure containing the IDs of recognition transactions that accounting journals will be created for, and the boolean createJournalUsingSummaries which determines whether journal lines are created from recognition transaction lines or recognition transaction summaries.

Return Value

This method returns the IDs of the batch jobs that will create the accounting journal.

Sample Code

1
2
3
4
5
//Note: This sample code is for demonstration purposes only. It is not intended for
//use in a production environment, is not guaranteed against defects or errors, and
//is in no way optimized or streamlined.
 
You need to provide some sample code

validateRevenueRecognitionTransactions

global static Map<Id, String> validateRevenueRecognitionTransactions(ffrr.RRTCreateJournalsService.CreateJournalRequest integrationRequest)

This method validates recognition transactions and either their transaction line items or their recognition transaction summaries for accounting journal creation. To validate a recognition transaction with recognition transaction summaries, please call an appropriate constructor of integrationRequest. Return any invalid recognition transactions in a map with the relevant error message. Journals can only be created for recognition transactions that have the status Committed, a valid Grouped By value, and that do not already have lookup to an accounting journal. To create journals using summary records, recognition transactions must also have recognition transaction summaries.

Input Parameters

Name Type Description
integrationRequest ffrr.RRTCreateJournalsService.CreateJournalRequest Structure containing the IDs of recognition transactions to be validated, and the boolean createJournalUsingSummaries which determines whether journal lines are to be created from recognition transaction lines or recognition transaction summaries.

Return Value

This method returns a map containing the IDs of invalid recognition transactions with their validation error messages. If all the recognition transactions are valid, this method returns an empty map.

Sample Code

1
2
3
4
5
//Note: This sample code is for demonstration purposes only. It is not intended for
//use in a production environment, is not guaranteed against defects or errors, and
//is in no way optimized or streamlined.
 
You need to provide some sample code

createRRTToJournal

global static Map<Id, ffrr.RRTCreateJournalsService.CreateJournalResponse> createRRTToJournal(ffrr.RRTCreateJournalsService.CreateJournalRequest integrationRequest)

This method creates accounting journals for specified recognition transactions synchronously. Information is passed between Revenue Management and Accounting via Foundations using the Journal.Create message type.
NOTE: Journal lines can be created from recognition transaction lines or from recognition transaction summaries depending on the createJournalUsingSummaries boolean parameter passed into the integrationRequest.

Input Parameters

Name Type Description
integrationRequest ffrr.RRTCreateJournalsService.CreateJournalRequest Structure containing the IDs of recognition transactions that accounting journals will be created for, and the boolean createJournalUsingSummaries which determines whether journal lines are created from recognition transaction lines or recognition transaction summaries.

Return Value

This method returns a map containing the IDs of recognition transactions with information about the revenue and cost journals that you attempted to create and whether or not they were created successfully.

Sample Code

1
2
3
4
5
//Note: This sample code is for demonstration purposes only. It is not intended for
//use in a production environment, is not guaranteed against defects or errors, and
//is in no way optimized or streamlined.
 
You need to provide some sample code

ffrr.RRTCreateJournalsService.CreateJournalRequest

global with sharing class CreateJournalRequest

Class containing information regarding RT to Journal creation.

Properties

Name Type Description
revenueRecognitionIds Set<Id> Set of Recognition Transaction Ids.
shouldCreateJournalFromSummary Boolean When true journals will be created from Revenue Recognition Summary records otherwise Journals will be created from Recognition Transaction Line Items. The default is false.

Methods

CreateJournalRequest

global CreateJournalRequest(Set<Id> revenueRecognitionIds)

Sample Code

1
2
3
4
5
6
7
8
9
10
//Note: This sample code is for demonstration purposes only. It is not intended for
//use in a production environment, is not guaranteed against defects or errors, and
//is in no way optimized or streamlined.
 
//IDs of Recognition Transactions that Accounting Journals will be created for. In order to be eligible for journal creation,
//the records associated with these IDs must have a Status of Committed, a GroupBy field which contains an Accounting usercompany value,
//and the Journal field must be empty.
Set<Id> revenueRecognitionIds = new Set<Id>{'a1ga00000111sg1', 'a1ga00000111sg2'};
//Create the CreateJournalRequest for Journal creation using Recognition Transactions and its line items
ffrr.RRTCreateJournalsService.CreateJournalRequest request = new ffrr.RRTCreateJournalsService.CreateJournalRequest(revenueRecognitionIds);

CreateJournalRequest

global CreateJournalRequest(Set<Id> revenueRecognitionIds, Boolean shouldCreateJournalFromSummary)

Sample Code

1
2
3
4
5
6
7
8
9
10
11
12
13
//Note: This sample code is for demonstration purposes only. It is not intended for
//use in a production environment, is not guaranteed against defects or errors, and
//is in no way optimized or streamlined.
 
//IDs of Recognition Transactions that Accounting Journals will be created for. In order to be eligible for journal creation,
//the records associated with these IDs must have a Status of Committed, a GroupBy field which contains an Accounting usercompany value,
//the Journal field must be empty, and summary records must exist.
Set<Id> revenueRecognitionIds = new Set<Id>{'a1ga00000111sg1', 'a1ga00000111sg2'};
//Determines whether journal lines are created from recognition transaction lines or revenue transaction summaries.
Boolean shouldCreateJournalFromSummary = true;
//Create the CreateJournalRequest for Journal creation using Recognition Transactions and its summary records
//Boolean property shouldCreateJournalFromSummary with true value should be passed only if journal need to be created using Recognition Transactions and its summary records
ffrr.RRTCreateJournalsService.CreateJournalRequest request = new ffrr.RRTCreateJournalsService.CreateJournalRequest(revenueRecognitionIds, shouldCreateJournalFromSummary);

ffrr.RRTCreateJournalsService.CreateJournalResponse

global with sharing class CreateJournalResponse

Class containing the response for the RT to Journal creation process.

Properties

Name Type Description
revenueJournalId Id ID of a revenue journal that has been created..
costJournalId Id ID of a cost journal that has been created.
revenueJournalCreationStatus String Status of the process to create the revenue journal, e.g. OK or Error.
costJournalCreationStatus String Status of the process to create the cost journal, e.g. OK or Error.
revenueJournalCreationError String Error message (if any) resulting for the revenue journal creation process.
costJournalCreationError String Error message (if any) resulting for the cost journal creation process.

Methods

CreateJournalResponse

global CreateJournalResponse()

© Copyright 2009–2023 Certinia Inc. All rights reserved. Various trademarks held by their respective owners.