VoidJournalEntry

Void Journal Entry

Major Business Rule

Object Name: B0900026

Parent DLL: CFIN

Location: Client/Server

Language: C

Functional Description

Purpose
The purpose of this business function is to allow the user to void a posted or unposted general
ledger transaction. This transaction can be voided on the same date as the origial transaction or on a
different date. This function writes the reversing entry to the F0911 and also updates the batch header
file F0011 if desired.

Setup Notes and Prerequisites

• In order to void a transaction, the key to the transaction needs to be acquired and passed over in
the parameters. These keys include: Document Type(DCT), Document Number(DOC), Key Company(KCO), ,G/L
Date(DGJ), and Ledger Type(LT).
• You need to decide if this business function should be responsible for updating the batch header or
if the application will do the updates.  If you wish to bypass all the batch header updates in this
business function then a '1' must be passed in the "cMode" parameter.  Also, with a '1' in the "cMode"
field any transactions that are unposted and are to be voided will be deleted rather than a reversing
entry written.
• The transaction being voided can be voided on a different G/L date than the date of the original
transaction.  The void date must be filled in, if it is left blank it will not be defaulted in.

Special Logic
The "cMode" parameter was added to this business function because Journal Entries reacts a bit
differently then A/R and A/P when voiding F0911's.  In Journal entries if the transaction is unposted the
void business function still needs to write the reversing record, and also the batch header needs to be
updated by the business function.  A/R and A/P on the other hand delete unposted transactions and
need to handle the batch  header updates through the appropriate application.  Therefore A/R and A/P need
to pass a '1' in the "cMode" parameter.  An additional value for cMode has been added.  By passing a
'2' into cMode the transaction will be reversed regardless of the posted code and and the batch header
file will not be updated.

Technical Specification

• If the void date is different than the G/L date then begin numbering the new entries with 1.0.
Otherwise retrieve the last line number used in the transaction being voided and begin numbering the new
entries on the next line.
• Open the batch if  "cMode" is not equal to 1 and not equal to 2.
• Read  a F0911 record from the document and place it into a work structure.
• Reverse the amount and replace the line number.  If this is a CA record then subtract 1 from the
line number so it will be correctly tied to it's associated AA.  If this is an unposted transaction and
if "cMode" is equal to 1 then just delete the record.
• If the amount is a debt and "cMode" isn't equal to 1 or 2 and if this isn't a CA record  then
increment the batch amount total.
• Write the work structure to the F0911 and  increment the line number.
• Return to step 3 and continue until EOF.
• Update the batch header file if  "cMode" is not equal to 1 and not equal to 2.

^

Data Structure

D0900026 - Void Journal Entry

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
szDocumentType	DCT	char	NONE	NONE
Special Input Expected Document type of the transaction being voided. ^
mnDocumentNo	DOC	MATH_NUMERIC	NONE	NONE
Special Input Expected Document number of the transaction being voided. ^
szCompanyKey	KCO	char	NONE	NONE
Special Input Expected Key Company of the transaction being voided. ^
jdGLDate	DGJ	JDEDATE	NONE	NONE
Special Input Expected G/L Date of the transaction being voided. ^
cSetError	EV01	char	NONE	NONE
Special Input Expected Future Use. ^
szErrorMessage	EKY1	char	NONE	NONE
Special Input Expected Future Use. ^
jdDateVoid	DGJ	JDEDATE	NONE	NONE
Special Input Expected Date transaction will be voided on.ab ^
cMode	EV02	char	NONE	NONE
Special Input Expected This parameter is used to determine if we reverse or delete unposted entries as well as whether or not we update the batch header (F0011). Significant Data Values '1' - Delete unposted entries and do not update the batch header. '2' - Do not delete unposted entries and do not update the batch header record ' ' - Do not delete unposted entries and update the batch header. ^
szLedgerType	LT	char	NONE	NONE
Special Input Expected The ledger of the transaction being voided. Note: when voiding a foreign entry to the 'AA' ledger the 'CA' ledger entries will be voided as well. ^
cCurrencyFlag	CRYR	char	NONE	NONE
Special Input Expected This is the currency conversion flag set to Y, Z, or N in the General Accounting Constants. ^
cPaymentInstrument	PYIN	char	OPT	NONE
A user defined code (00/PY) that determines the means by which a payment is issued to a supplier or received from the customer. Examples of payment instruments include check, electronic funds transfer, lockbox, and EDI.
szInterOpVersion	VER	char	OPT	NONE
Identifies a specific set of data selection and sequencing settings for the application. Versions may be named using any combination of alpha and numeric characters. Versions that begin with 'XJDE' or 'ZJDE' are set up by J.D. Edwards.
cReversalFlag	RP3	char	OPT	NONE
In Accounts Receivable, a code to designate whether cash records from cash receipts are written in detail or summary. All records within a batch have the same value. Valid values are: Blank Cash records are written in summary. 1 Cash records are written in detail. In Accounts Payable, a code to designate the status of a voucher that was created by a software module other than Accounts Payable. Valid values are: P Preliminary Invoice (without redistribution) R Redistribution complete C Credit tied to debit business unit M Voucher match L Logged voucher for a purchase order

Related Functions

B0000004 Batch - Open On Initialization
B0000007 Batch - Revise On Transaction Commitment

Related Tables

F0911 Account Ledger