UpdateInvoiceWithSpdStsInfo

A/R Speed Status Change

Minor Business Rule

Object Name: B03B0018

Parent DLL: CFIN

Location: Client/Server

Language: C

Functional Description

Purpose

This function is used to update Customer Ledger (F03B11) records through applications other than 
Invoice Entry applications, primarily through Speed Status Change (P03B114). The application will blindly 

update the fields specified by the user therefore the user should ensure that the values of the fields 

being updated are correct.  


Setup Notes and Prerequisites

None.


Special Logic

In cases where discount available amounts are updated, if one of the two discount available amounts 

(foreign or domestic) is zero and the other one is not, and an exchange rate or the triangulation rates 

are passed, then the function will calculate the missing discount available amount.



Technical Specification



Parameters

Item DescriptionI/OReq?Notes

KCOszCompanykeyIYDocument Company.
DOCmnDocvoucherinvoiceeIYDocument Number.

DCTszDocumenttypeIYDocument Type.

SFXszDocumentpayitemIYDocument Pay Item.

PSTcPaystatuscodeI/ONDocument Pay Status.

DDNJjdDatediscountduejulianI/ONDiscount due date.

ADSCmnAmtdiscountavailableI/ONDomestic discount available.

COszCompanyI/ON

CRCDszCurrencycodefromI/ONTransaction currency.

CRRmnCurrencyconverrateovI/ONExchange rate.

CDSmnForeigndiscountavailI/ONForeign discount available.

RMKszNameremarkI/ONCustomer remark.

AN8JmnAddnoalternatepayeeI/ONAlternate payee.

DDJjdDateduejulianI/ONDue date.

PYINcPaymentinstrumentI/ONPayment Instrument.

CTLszApcheckscontrolfieldI/ONCheck/Draft number.

PIDszProgramidI/ONProgram updating record.

CCT1szBaseCurrencycodeI/ONBase Currency.

ATXAmnAmountTaxableI/ONTaxable amount.

ATXNmnAmountTaxExemptI/ONTax exempt amount.

STAMmnAmtTaxI/ONTax amount.

CTXAmnForeignTaxableAmountI/ONForeign taxable amount.

CTXNmnForeignTaxExemptI/ONForeign tax exempt amount.

CTAMmnForeignTaxAmountI/ONForeign tax amount.

TXA1szTaxRateAreaI/ONTax rate area.

EXR1szTaxExplanationCodeI/ONTax explanation code.

DSVJjdDateServiceTaxI/ONService tax date.

PYRmnPayorAddressNumberI/ONPayor address number.

DNLTcDelinquencyLetterI/ONYes or No.

AFCcApplyFinChargesI/ONYes or No.

CRRmnTriangulationRate1I/ON

CRRmnTriangulationRate2I/ON

CRCMcCurrencyCoversionMethodI/ON

EFTjdTransactionDateI/ONTransaction date.


Related Tables

F03B11Customer Ledger File


Related Functions

B0000027CurrencyConvForAndDom
B9800100Get Audit Information


Processing

Perform Initializations.

Open F03B11.

If Open Table failed,

Return error.

Endif.

If (Currency = 'ON') AND (Exchange Rates exist) AND 

(One of discount available amounts is zero while the other is not),

Calculate the missing discount available amount.

If function call failed,

Return error.

Endif.

Endif.

Get Audit Information.

Load update values.

Perform the update to F03B11.

If Update failed,

Close F03B11.

Return error.

Enfif.

Close F03B11.

Return success.  


^

Data Structure

D03B0018 - AR Speed Status Update

Parameter NameData ItemData TypeReq/OptI/O/Both
szCompanykeyKCOcharNONENONE

A number that, with the document number, document type and G/L date, uniquely identifies an original document, such as invoice, voucher, 
or journal entry. If you use the Next Numbers by Company/Fiscal Year feature, the Automatic Next Numbers program (X0010) uses the 
document company to retrieve the correct next number for that company. If two or more original documents have the same document number and 
document type, you can use the document company to locate the desired document.

mnDocvoucherinvoiceeDOCMATH_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.

szDocumenttypeDCTcharNONENONE

A user defined code (00/DT) that identifies the origin and purpose of the transaction.  PeopleSoft reserves several prefixes for document 
types, such as, vouchers, invoices, receipts, and timesheets. The reserved document type prefixes for codes are: P Accounts payable 
documents R Accounts receivable documents  T Time and Pay documents I Inventory documents  O Purchase order documents  S Sales order 
documents 

szDocumentpayitemSFXcharNONENONE

A number that identifies the pay item for a voucher or an invoice. The system assigns the pay item number. If the voucher or invoice has 
multiple pay items, the numbers are sequential.

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.

jdDatediscountduejulianDDNJJDEDATENONENONE

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.

mnAmtdiscountavailableADSCMATH_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.

szCompanyCOcharNONENONE

A code that identifies a specific organization, fund, or other reporting entity. The company code must already exist in the Company 
Constants table (F0010) and must identify a reporting entity that has a complete balance sheet. At this level, you can have intercompany 
transactions. Note: You can use company 00000 for default values such as dates and automatic accounting instructions. You cannot use company 00000 
for transaction entries.

szCurrencycodefromCRCDcharNONENONE

A code that identifies the currency of a transaction. 

mnCurrencyconverrateovCRRMATH_NUMERICNONENONE

A number (exchange rate) that a foreign currency amount is multiplied by to calculate a domestic currency amount.  The number in this field 
can have a maximum of seven decimal positions. If more are entered, the system adjusts to the nearest seven decimal positions. 

mnForeigndiscountavailCDSMATH_NUMERICNONENONE

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

szNameremarkRMKcharNONENONE

A generic field that you use for a remark, description, name, or address.

mnAddnoalternatepayeeAN8JMATH_NUMERICNONENONE

An alternate address to which accounts payable can send payments due.

jdDateduejulianDDJJDEDATENONENONE

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.

cPaymentinstrumentPYINcharNONENONE

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.

szApcheckscontrolfieldCTLcharNONENONE

Accounts Payable - A code the system uses to determine the order in which A/P payments are printed. The value of the field differs 
depending on how you print checks. For example, if checks are printed by job, the field contains the job number. If checks are printed by contract 
number, the field contains the contract number.  Accounts Receivable - A number that identifies the statement on which the invoice appears.

szProgramidPIDcharNONENONE

The number that identifies the batch or interactive program (batch or interactive object). For example, the number of the Sales Order Entry 
interactive program is P4210, and the number of the Print Invoices batch process report is R42565. The program ID is a variable length value. 
It is assigned according to a structured syntax in the form TSSXXX, where: T The first character of the number is alphabetic and identifies the 
type, such as P for Program, R for Report, and so on. For example, the value P in the number P4210 indicates that the object is a 
program. SS The second and third characters of the number are numeric and identify the system code. For example, the value 42 in the number P4210 
indicates that this program belongs to system 42, which is the Sales Order Processing system. XXX The remaining characters of the numer are 
numeric and identify a unique program or report. For example, the value 10 in the number P4210 indicates that this is the Sales Order Entry 
program.

szBaseCurrencycodeCCT1charNONENONE

Enter the currency code of the common currency used to calculate the cross rate. The program copies the currency code you enter to the 
From Currency 2 field. The currency codes in the To Currency 1 and From Currency 2 fields must match.

mnAmountTaxableATXAMATH_NUMERICNONENONE

The amount on which taxes are assessed.

mnAmountTaxExemptATXNMATH_NUMERICNONENONE

The amount upon which taxes are not assessed. This is the portion of the transaction not subject to sales, use, or VAT taxes because the 
products are tax-exempt or zero-rated.

mnAmtTaxSTAMMATH_NUMERICNONENONE

The amount assessed and payable to tax authorities. It is the total of the VAT, use, and sales taxes (PST).

mnForeignTaxableAmountCTXAMATH_NUMERICNONENONE

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

mnForeignTaxExemptCTXNMATH_NUMERICNONENONE

The foreign amount associated with this document which is not subject to sales, use or value-added tax due to the nature of the transaction 
and not due to the nature of the parties to the transaction (as in tax exemption).

mnForeignTaxAmountCTAMMATH_NUMERICNONENONE

The tax amount in foreign currency.  This can be the sales, use, or VAT tax. 

szTaxRateAreaTXA1charNONENONE

A code that identifies a tax or geographic area that has common tax rates and tax authorities. The system validates the code you enter 
against the Tax Areas table (F4008). The system uses the tax rate area in conjunction with the tax explanation code and tax rules to calculate tax 
and G/L distribution amounts when you create an invoice or voucher.

szTaxExplanationCodeEXR1charNONENONE

A hard-coded user defined code (00/EX) that controls the algorithm that the system uses to calculate tax and G/L distribution amounts. The 
system uses the tax explanation code in conjunction with the tax rate area and tax rules to determine how the tax is calculated. Each 
transaction pay item can be defined with a different tax explanation code.

jdDateServiceTaxDSVJJDEDATENONENONE

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

mnPayorAddressNumberPYRMATH_NUMERICNONENONE

The address book number of the person or company that sends the payment.

cDelinquencyLetterDNLTcharNONENONE

An option that specifies whether to print delinquency notices for the customer or company based on the notification instructions that are set 
up for the policy that you assign to the customer.  On Print delinquency notices. Off Do not print delinquency notices. Note: This option exists in 
both the Customer Master Information program (P03013) and the Accounts Receivable Constants program (P0000). In the Accounts 
Receivable Constants program, the option controls whether notices are printed for invoices that are entered for a specific company. In the Customer 
Master Information program, the option controls whether notices are printed for a customer.

cApplyFinChargesAFCcharNONENONE

An option to specify whether to process delinquency fees for the customer. On Process delinquency fees  Off Do not process delinquency 
fees

mnTriangulationRate1CRRMATH_NUMERICOPTNONE

A number (exchange rate) that a foreign currency amount is multiplied by to calculate a domestic currency amount.  The number in this field 
can have a maximum of seven decimal positions. If more are entered, the system adjusts to the nearest seven decimal positions. 

mnTriangulationRate2CRRMATH_NUMERICOPTNONE

A number (exchange rate) that a foreign currency amount is multiplied by to calculate a domestic currency amount.  The number in this field 
can have a maximum of seven decimal positions. If more are entered, the system adjusts to the nearest seven decimal positions. 

cCurrencyConversionMethodCRCMcharOPTNONE

A value that specifies which method to use when converting from one currency to another. Valid values are:  Y  Multiplier method. The 
system multiplies the foreign amount by the multiplier exchange rate to calculate the domestic amount. Z Divisor method. The system divides the 
foreign amount by the divisor exchange rate to calculate the domestic amount.

jdTransactionDateEFTJDEDATEOPTNONE

The date that identifies when a date is first valid. The effective date is used generically. It can be a lease effective date, a price or cost 
effective date, a currency effective date, a tax rate effective date, or whatever is appropriate.

szPaymentTermsCodePTCcharOPTNONE

A code that specifies the terms of payment, including the percentage of discount available if the invoice is paid by the discount due date. 
Use a blank code to indicate the most frequently-used payment term. You define each type of payment term on the Payment Terms Revisions 
form. Examples of payment terms include: Blank Net 15 001      1/10 net 30 002      2/10 net 30 003      Due on the 10th day of every month 006     
Due upon receipt  This code prints on customer invoices.

szCostCenterMCUcharOPTNONE

An alphanumeric code that identifies a separate entity within a business for which you want to track costs. For example, a business unit 
might be a warehouse location, job, project, work center, branch, or plant. You can assign a business unit to a document, entity, or person for 
purposes of responsibility reporting. For example, the system provides reports of open accounts payable and accounts receivable by 
business unit to track equipment by responsible department. Business unit security might prevent you from viewing information about business units 
for which you have no authority.

mnTotalSentRemindersRMDSMATH_NUMERICOPTNONE

This field specifies the number of delinquency notices that have been generated for an invoice pay item. 

cNetStatusCodeNETSTcharOPTNONE

A user defined code (00/NS) that indicates the current netting status for a voucher or an invoice. Valid values are: 0 Ineligible for 
Netting 1 Approved for Netting

Related Functions

B0000027 CurrencyConvForAndDom
B0000033 Get Exchange Rate
B9800100 Get Audit Information

Related Tables

F03B11 Customer Ledger