Financials Manager Web Service

This chapter provides an overview of the Financials Manager web service, lists prerequisites, and discusses these web service operations:

Click to jump to parent topicUnderstanding the Financials Manager Web Service

The Financials web service (JP090000) manages the processing of financial-related web service operations. This table includes a description of the financial web service operations:

Operation

Description

getGLAccount (J0900001)

Use this operation to retrieve account master information from the JD Edwards EnterpriseOne General Accounting system.

insertBatchJournalEntry (J0900002)

Use this operation to insert a batch of journal entries into the JD Edwards EnterpriseOne General Accounting system.

Accessing Javadoc for the Financials Manager Web Service Operations

To access Javadoc for the Financials Manager web service and its related operations, review these Javadoc packages:

See Accessing Javadoc for Business Services.

Reviewing Input and Response Interfaces

To review information about the classes and fields that are used by these web service operations, you can review the input and response interface tables. Input and response interface tables list the classes and fields used by each operation, the key fields, the data types of each fields, and which fields or classes are required for each action.

See Accessing Additional Information about Business Services, Appendix A: Input and Response Interfaces.

Click to jump to parent topicPrerequisites

Before you can use the Financials Manager web service or any of its related operations, you must install and set up the JD Edwards EnterpriseOne General Accounting system.

See Getting Started with JD Edwards EnterpriseOne General Accounting.

Click to jump to parent topicgetGLAccount

This section provides an overview of the getGLAccount web service operation and lists prerequisites.

Click to jump to top of pageClick to jump to parent topicUnderstanding the getGLAccount Web Service Operation

The getGLAccount web service operation is a database query operation that enables consumers to retrieve and review general ledger account records from the Account Master table (F0901) in the JD Edwards EnterpriseOne General Accounting system. If the operation encounters errors during processing, the operation does not complete and the errors are returned to the consumer.

Setup Considerations

Before you use this operation, you can set business service properties to specify how the operation retrieves records from the Account Master table (F0901). This table includes information about the business service properties that the getGLAccount operation uses:

Group

Key

Description

Default Value

J0900001

J0900001_MAX_ROWS

Use this business service property to specify the maximum number of records that the operation can return to the consumer.

1000

Note. It is strongly recommended that consumers set this business service property to a value other than 0 and that search criteria is specified when sending a query. Entering 0 in this property will allow the operation to retrieve all records that match the search criteria. Though the operation allows a query without search criteria, sending in such a query without limiting the number of rows that the operation returns could result in significant performance issues.

Implementation Details

This table includes information that can help determine whether the getGLAccount operation is functioning correctly:

Question

Answer

How can I tell if the operation completes successfully?

If the operation completes successfully, the system displays general ledger account records that match the search criteria. The records that are returned to the consumer include all of the fields that are listed in the response interface for this operation. However, some of those fields can contain blank or zero values, depending on the data that exists in the JD Edwards EnterpriseOne system.

At a minimum, the system returns non-zero values for the accountId field.

If I encounter errors while process a transaction, do I need to reverse the transaction?

This operation does not update data in the JD Edwards EnterpriseOne system. If you encounter errors during processing, review your search criteria and business service property settings and retry your query. No manual updates are necessary if errors are encountered.

Does this operation use record reservation?

No. The operation does not reserve records within the JD Edwards EnterpriseOne system during processing.

Click to jump to parent topicinsertBatchJournalEntry

This section provides an overview of the insertBatchJournalEntry web service operation and lists prerequisites.

Click to jump to top of pageClick to jump to parent topicUnderstanding the insertBatchJournalEntry Web Service Operation

The insertBatchJournalEntry web service operation is a database insert operation that enables consumers to add journal entry records to the Journal Entry Transactions – Batch table (F0911Z1). The F0911Z1 is a temporary table in the JD Edwards EnterpriseOne General Accounting system. After records have been added to this table, consumers can use JD Edwards EnterpriseOne programs to update and process the journal entries that have been added to the temporary table.

If the operation encounters any errors while attempting to insert records into the F0911Z1 table, those errors are returned to the consumer. Additionally, the F0911Z1 table is restored to its original state and no records are inserted into the table.

Supported Functionality

This section discusses the functionality that the insertBatchJournalEntry operation supports.

Note. If functionality is not explicitly documented as supported functionality, it is to be understood that the functionality is not supported by the integration solution.

The insertBatchJournalEntry operation supports only the insertion of journal entry records into the F0911Z1 table. The operation does not support changing, deleting, or processing those records. Consumers must use JD Edwards EnterpriseOne programs to change, delete, or process records that this operation inserts into the table.

See Processing Batch Journal Entries.

Implementation Details

This table includes information that can help determine whether the insertBatchJournalEntry operation is functioning correctly:

Question

Answer

How can I tell if the operation completes successfully?

If the operation completes successfully, the system returns a confirmation message the includes the number of rows that were inserted into the F0911Z1 table.

If I encounter errors while process a transaction, do I need to reverse the transaction?

This operation uses standard transaction processing. If the system encounters errors during processing, the F0911Z1 table is returned to its original state and all errors are returned to the consumer. No manual updates are necessary.

Does this operation use record reservation?

No. The operation does not reserve records within the JD Edwards EnterpriseOne system during processing.