InsertRecurringVoucherRecord

Insert Recurring Voucher Record

Major Business Rule

Object Name: B0400074

Parent DLL: CFIN

Location: Client/Server

Language: C

Functional Description

Purpose

The purpose of this business function is to insert a record in the Voucher Detail Table (F0411).

 

The key fields should be passed to the function (Company Key, Document Number, Document Type, Pay 

Item, and Pay Item Extension), along with several other fields (listed in 'Technical Specifications'), 

before inserting a F0411 record.  


This business function calls an external function (GetAuditInfo) to grab information such as User ID, 

Program ID, Date and Time the table is updated, before performing an insert.


Setup Notes and Prerequisites

The Key fields must be passed (Company Key, Document Number, Document Type, Pay Item, Pay Item 

Extension)


Special Logic

None


Technical Specification

The following fields should be passed to the function only if they are to be updated:
RecurFrequencyOfPaym

PayStatusCode

GLDate

PeriodNumber

BatchNumber

BatchType

InvoiceDate

VendorInvoiceNumber

DueDate

DiscountDueDate

ServiceTaxDate

DocumentNumber

RecurringFrequency

PaymentAmount

DiscountAvailable

ForeignAmount

PostStatus

FiscalYear

Century


Data Structure

D0400074 - Insert Recurring Voucher Record

Special Input Expected
 

The key fields should be passed to the function: 

Company Key

Document Number 

Document Type 

Pay Item 

Pay Item Extension


The following fields should be passed to the function only if they are to be updated:
RecurFrequencyOfPaym

PayStatusCode

GLDate

PeriodNumber

BatchNumber

BatchType

InvoiceDate

VendorInvoiceNumber

DueDate

DiscountDueDate

ServiceTaxDate

DocumentNumber

RecurringFrequency

PaymentAmount

DiscountAvailable

ForeignAmount

PostStatus

FiscalYear

Century



^

Parameter NameData ItemData TypeReq/OptI/O/Both
szCompanyKeyKCOcharNONENONE


^

mnDocvoucherInvoiceeDOCMATH_NUMERICNONENONE


^

szDocumentTypeDCTcharNONENONE


^

szDocumentPayItemSFXcharNONENONE


^

mnPayItemExtensionNumberSFXEMATH_NUMERICNONENONE


^

mnRecurFrequencyOfPaymDRFMATH_NUMERICNONENONE

The number of recurring invoices or vouchers that you want the system to process. This number includes the original transaction that you 
enter. For example, if you enter 12, the system will process the transaction 11 additional times, reducing the value of the number of payments 
by 1 each time it creates a new transaction. When this field contains 1, the system does not create a new transaction, it clears the field.

cPayStatusCodePSTcharNONENONE

A user defined code (00/PS) that indicates the current payment status for a voucher or an invoice. Examples of codes include: A Approved 
for payment but not yet paid   H Held pending approval   P Paid   Note: Some of the payment status codes are hard coded; the system assigns 
the code.

GLDateDGJJDEDATENONENONE

A date that identifies the financial period to which the transaction will be posted. You define financial periods for a date pattern code that you 
assign to the company record. The system compares the date that you enter on the transaction to the fiscal date pattern assigned to the 
company to retrieve the appropriate fiscal period number, as well as to perform date validations.

mnPeriodNumberPNMATH_NUMERICNONENONE

A number indicating the current accounting period.  This number, used in conjunction with the Company Constants table (F0010) and the 
General Constants table (F0009), allows the user to define up to 14 accounting periods. See General Ledger Date.  The current period number 
is used to determine posted before and posted after cut off warning messages.  It is also used as the default accounting period in the 
preparation of financial reports.

mnBatchNumberICUMATH_NUMERICNONENONE

A number that identifies a group of transactions that the system processes and balances as a unit. When you enter a batch, you can either 
assign a batch number or let the system assign it using the Next Numbers program.

szBatchTypeICUTcharNONENONE

A code that specifies the system and type of transactions entered in a batch. The system assigns the value when you enter a transaction. 
Valid values are set up in user defined code table 98/IT. You cannot assign new values. All batch types are hard coded.

InvoiceDateDIVJJDEDATENONENONE

The date that either you or the system assigns to an invoice or voucher. This can be either the date of the supplier's invoice to you or the 
date of your invoice to the customer.

szVendorInvoiceNumberVINVcharNONENONE

The supplier's invoice number that is used for voucher entry. Voucher entry allows only one invoice per voucher number. If multiple invoice 
numbers exist on a voucher, you must set them up as multiple vouchers or combine the invoices and enter them as one voucher. Depending 
on how you have your accounts payable constants set, the system can do one of the following:   o  Accept a duplicate invoice number 
without warning or error   o  Generate a warning message in which the duplicate invoice number can still be accepted   o  Generate an error 
message Blank values are treated in the same manner as any other invoice number. Two blank invoice numbers are treated as duplicates. To test 
for duplicate invoice numbers that might have been entered in error, run the Suspected Duplicate Payments report (R04601). Note: The 
duplicate invoice number validation is not run for vouchers with document type NO. These vouchers are created by the Generate Reimbursements 
program (R03B610).

DueDateDDJJDEDATENONENONE

In Accounts Receivable, the date that the net payment is due. In Accounts Payable, the date that the payment is due to receive a discount 
or, if no discount is offered, the net due date. The system calculates the due date based on the payment term entered, or you can enter it 
manually. If you enter a negative voucher or invoice (debit or credit memo), the system might use the G/L date as the due date regardless of the 
payment term entered. A processing option in the master business function (P0400047 for vouchers and P03B0011 for invoices) controls how 
the system calculates the due date for debit and credit memos.

DiscountDueDateDDNJJDEDATENONENONE

In the Accounts Receivable system, the date that the invoice must be paid to receive the discount. The system calculates the discount due 
date based on the payment term. If the payment term does not specify a discount, the system completes this field with the net due date. In the 
Accounts Payable system, the date that the voucher is due.

ServiceTaxDateDSVJJDEDATENONENONE

A date that indicates when you purchased goods or services, or when you incurred a tax liability. 

mnDocumentNumberDOCMATH_NUMERICNONENONE

A number that identifies the original document, such as a voucher, invoice, or journal entry. On entry forms, you can assign the document 
number or let the system assign it using the Next Numbers program (P0002). Matching document numbers (DOCM) identify related documents 
in the Accounts Receivable and Accounts Payable systems. Examples of original and matching documents are: Accounts Payable     o 
Original document - voucher     o Matching document - payment  Accounts Receivable     o Original document - invoice     o Matching document - 
receipt  Note: In the Accounts Receivable system, the following transactions simultaneously generate original and matching documents: 
deductions, unapplied receipts, chargebacks, and drafts.

szRecurringFrequencyRFcharNONENONE

A code to specify the time interval between transactions that the system creates. Valid recurring frequency values 
are: MO Monthly AN Annually WK Weekly QT Quarterly SA Semiannually BW Biweekly

mnPaymentAmountPAAPMATH_NUMERICNONENONE

In the Accounts Payable system, the amount of the payment. In the Accounts Receivable system, the amount of the receipt. This amount 
must balance to the total amount applied to the invoice pay items.

mnDiscountAvailableADSCMATH_NUMERICNONENONE

The amount of the invoice or voucher pay item that is eligible to be subtracted from the gross amount when the transaction is paid. The 
system calculates discount amounts based on the payment term entered on the transaction.  Note: If the system calculates the discount, verify 
that it applies to the pay item specified. Usually, freight, sales tax, and labor charges that are included in the gross amount do not qualify for 
discounts.

mnForeignAmountFAPMATH_NUMERICNONENONE

The unpaid foreign amount of a transaction.

cPostStatusPOSTcharNONENONE

A code the system uses to determine whether a transaction is available for the post process. Valid codes 
are: Blank Unposted. D Posted. P Posted or posting. Depending on the type of transaction, this code has different meanings. If the code is assigned to an Account Ledger 
record (F0911), it indicates a posted status. If the code is assigned to any other transaction, it indicates that the system attempted to post the 
record but failed, due to an error it encountered.    M Model. The transaciton is a model journal entry.     

mnFiscalYearFYMATH_NUMERICNONENONE

A number that identifies the fiscal year. Generally, you can either enter a number in this field or leave it blank to indicate the current fiscal 
year (as defined on the Company Setup form). Specify the year at the end of the first period rather than the year at the end of the fiscal period. 
For example, a fiscal year begins October 1, 1998 and ends September 30, 1999. The end of the first period is October 31, 1998. Specify the 
year 98 rather than 99.

mnCenturyCTRYMATH_NUMERICNONENONE

The calendar century associated with the year. Enter is the first two digits of the year. For example, 19 indicates any year beginning with 19 
(1998, 1999), 20 indicates any year beginning with 20 (2000, 2001), and so on.

mnForeignDiscountAvailCDSMATH_NUMERICOPTNONE

The foreign amount of the discount available as opposed to the amount of the discount actually taken.

mnAmountTaxableATXAMATH_NUMERICOPTNONE

The amount on which taxes are assessed.

mnForeignTaxableAmountCTXAMATH_NUMERICOPTNONE

That portion of the sale that is subject to tax in foreign currency.

Related Functions

B9800100 Get Audit Information
N7000910 B0400074 - Plug & Play - 04
X0903 Fiscal Date Edits +

Related Tables

F0411 Accounts Payable Ledger