EIPP Admin
EIPP Admin
2016-11
You define and import invoicing and payment data for all Ariba Procurement and Invoicing Solutions.
Before you begin you need to know about the data import process in general, entering data in comma-separated-
value (CSV) files, downloading and using the Data Dictionary, and using Ariba Administrator.
Additional References
Additional References
Additional References
The functionality of managing taxes on invoices in Ariba Procurement and Invoicing Solutions varies based on
whether you are using the enhanced tax computation engine or the basic tax computation engine for calculating
taxes on invoices. The enhanced tax tables provide greater flexibility in defining tax data and more comprehensive
compliance with tax rules. This chapter provides information on defining tax data when using the basic tax
computation engine with Ariba Procure-to-Pay and Ariba Invoice Professional.
For information on defining tax data for the enhanced tax computation engine, see the Common Data Import and
Administration Guide.
The following table highlights the differences in the functionalities provided by the basic and enhanced tax
computation engines:
Supports application of taxes using tax types only Supports application of taxes using tax types as well as tax co
des
You need to manually specify the tax amount. Tax amounts are automatically calculated for tax codes.
Does not support complex taxes Supports complex taxes, such as tax on tax and tax on the
sum of net amount and another tax
You can enable the enhanced tax computation engine using the site configuration option
Application.Invoicing.UseTLCTaxEngine. Contact your Ariba customer support administrator to enable
this functionality.
The tax calculation process in invoice reconciliation documents varies based on whether you are using the basic
tax computation engine or the enhanced tax computation engine.
● Complex tax calculations, such as tax applied on another tax or tax applied on the sum of the net amount of
the line and another tax.
● Tax calculation for withholding taxes.
When tax calculations are completed for all the taxable line items in the invoice, the pre-validation process is
complete and the invoice reconciliation document is passed on to the validation process.
Header-level tax is considered only during the reconciliation phase. Tax is calculated on each taxable line item and
then aggregated to give a total header-level tax amount. This amount is applied to the default line item and is used
during reconciliation if header-level reconciliation is required.
With the basic tax computation engine, Ariba Procurement and Invoicing Solutions use the following two-step
approach to calculate tax rates.
1. Ariba Procurement and Invoicing Solutions identify a tax code applicable on the invoice line item based on the
tax code lookup. The tax code lookup lists the tax codes applicable for different combinations of line item
commodity code, ship from address (country and state), and ship to address (country and state).
2. Ariba Procurement and Invoicing Solutions look up the tax rate from the tax rate by tax code lookup table
based on the tax code obtained from the tax code lookup table, the tax type of the tax line, and the plant (SAP
only). The tax rate lookup by tax code table uses these values to determine the final tax amount.
With the enhanced tax computation engine, Ariba Procurement and Invoicing Solutions use the following three-
step approach to calculate taxes on invoices:
1. Ariba Procurement and Invoicing Solutions identify a tax code applicable on the invoice line item based on the
tax code lookup. The tax code lookup lists the tax codes applicable for different combinations of line item
commodity code, ship from address (country and state), and ship to address (country and state).
2. Ariba Procurement and Invoicing Solutions identify the tax components that are part of the tax codes.
3. Ariba Procurement and Invoicing Solutions filter the tax components based on the purchasing units, set IDs, or
plants as per the ERP system used. Then, they calculate taxes based on the tax rates and tax types specified
for the tax components.
When using the basic tax computation engine, multiple tax rates can be attached to one tax code if the invoice line
item references multiple tax types. Each tax rate has an associated rank, which is used to determine which tax rate
to use when a line item matches more than one tax rate. The tax rate with the highest rank (lowest number) is
used.
Wildcard Matching
When using the basic tax computation engine, you can configure entries in the tax code table to specify which tax
codes and rates allow wildcard matching by leaving the value empty (null). You can also configure a default rate
when no other matches apply. The values are case-sensitive. For example, a state value of “CA” does not match
“Ca”.
The tax calculation examples use sample tax code and tax rate lookup tables to illustrate how tax is calculated for
line items. A line item’s commodity code and rank are used to determine the initial tax code, and then the tax rate
is determined in the tax rate lookup table using the tax code and rank. This process is applicable only for the basic
tax computation engine.
Rank Commodity Code Ship From Country Ship From State Ship To Coun Ship To Tax Code
try State
0 OFFICE:CALENDAR US MI US CA TC1
1 MFG:CABLE GB GB TC4
1 OFFICE:CALENDAR GB US CA TC6
2 DE TC8
2 CA TC9
3 TC10
The next table shows examples of tax rate lookup by tax code table entries:
● Partial matching: A line item with commodity code OFFICE:CALENDAR and Ship to Country DE matches to tax
code TC8 in the tax code lookup table and tax rate 0.195 in the tax rate lookup by tax code table. This line item
is a partial match because only the Ship To Country value is matched.
● Multiple row matching: A line item with commodity code OFFICE:CALENDAR and Ship From Country GB
matches rows with tax code TC6 and TC7 in the tax code lookup table. The row with the highest rank (lowest
number) is used. Therefore, from the tax rate lookup by tax code table, the tax rate 0.08 is used.
● Multiple tax types: A line item with commodity code OFFICE:CALENDAR, Ship To Country Canada, and Ship
From Country Canada matches tax code TC5 in the tax code lookup table. In the tax rate lookup by tax code
table, TC5 with tax type GST uses the tax rate 0.07. Similarly, for the same line item, in the tax rate lookup by
tax code table, TC5 with tax type PST uses the tax rate 0.08.
● Use of effective date: A line item with commodity code OFFICE:CALENDAR, Ship From Country US, Ship To
Country US, Ship From State MI, and Ship To State CA matches one row in the tax code lookup table (TC1)
and two rows in the tax rate lookup by tax code table (0.10 and 0.15). The row with the later effective date is
used (0.15).
Task Name Required for Basic Tax Com Required for Enhanced Tax
putation Engine? Computation Engine?
Information on the data import tasks required for the enhanced tax computation engine has been provided in the
Common Data Import and Administration Guide as the same tax information is also used to apply taxes on
requisitions and purchase orders.
Related Information
SalesTax (SAP and Generic only) Sales tax. A tax that is imposed on retail sales of tangible personal prop
erty and certain services.
UseTax (SAP and Generic only) Use tax. A tax that is imposed on the use, storage, or consumption of
tangible personal property.
SUTTax (PeopleSoft only) Sales/use tax. Sales tax is a tax that is imposed on retail sales of tangible per
sonal property and certain services. Use tax is a tax that is imposed on the use, storage, or con
sumption of tangible personal property.
VATTax Value-added tax (VAT). A general consumption tax that is assessed on the value added to
goods and services at each stage in the production and distribution chain.
GSTTax Goods and services tax (GST). A value-added tax on the sale of goods and services that exists in
a number of countries.
PSTTax Provincial sales tax (PST). A tax imposed on the consumers of goods and services in Canadian
provinces.
HSTTax Harmonized sales tax. A single harmonized value-added tax that replaced the provincial sales
taxes and the federal goods and services taxes in Nova Scotia, New Brunswick, Newfoundland,
and Labrador.
QSTTax Quebec provincial sales tax (QST). A sales tax imposed on retail sales in Quebec.
WHTTax Withholding tax. In certain countries, this type of tax is required for self-employed suppliers and
is generally paid by the buying organization to the state or government tax authorities on behalf
of the supplier. The tax percentage rate or tax amount must be entered as a negative amount.
Withholding taxes are subtracted from the invoice total. Withholding taxes cannot be applied at
the header level and accruals do not apply to withholding tax, therefore, accrual payments are
not created.
TaxRateLookupByTaxCode.csv has six columns: SETID_TAX_CD_, TAX_PCT, SETID, Rank, EFFDT, and
TAX_TYPE.
UTF8
SETID_TAX_CD_,TAX_PCT,SETID,Rank,EFFDT,TAX_TYPE
FEDRL:ALC,0.02500000,FEDRL,0,1/1/1900,SUTTax
FEDRL:BOS,0.05000000,FEDRL,0,1/1/1900,SUTTax
FEDRL:CA,0.06000000,FEDRL,0,1/1/1900,SUTTax
FEDRL:CCC,0.01500000,FEDRL,0,2/25/2002,SUTTax
TaxRateLookupByTaxCode.csv has seven columns: Rank, TaxCode, Country, TaxType, Plant, TaxRate, and
EffectiveDate.
UTF8
Rank,TaxCode,Country,TaxType,Plant,TaxRate,EffectiveDate
0,I0,US,SalesTax,,0,Wed Mar 01 00:00:00 GMT+05:30 2000
0,I1,US,SalesTax,3000,0.04,Wed Mar 01 00:00:00 GMT+05:30 2000
0,I1,US,SalesTax,3002,0.06,Wed Mar 01 00:00:00 GMT+05:30 2000
0,I1,US,SalesTax,3500,0.0625,Wed Mar 01 00:00:00 GMT+05:30 2000
0,U0,US,UseTax,,0,Wed Mar 01 00:00:00 GMT+05:30 2000
0,U1,US,UseTax,3000,0.04,Wed Mar 01 00:00:00 GMT+05:30 2000
0,V1,JP,VATTax,,0.05,Wed Mar 01 00:00:00 GMT+05:30 2000
0,V0,JP,VATTax,,0,Wed Mar 01 00:00:00 GMT+05:30 2000
UTF8
Rank,TaxCode,TaxType,TaxRate,EffectiveDate,TaxName,PurchasingUnit
0,CA - Sales Tax,SalesTax,0.0825,Wed Mar 01 00:00:00 GMT+05:30 2000,CA - Sales Tax,
600:OU
0,CA VAT TAX,VATTax,0.05,Wed Mar 01 00:00:00 GMT+05:30 2002,CA VAT TAX,600:OU
0,SEN SALES TAX10,SalesTax,0.1,Wed Mar 01 00:00:00 GMT+05:30 2000,SEN SALES
TAX10,600:OU
The invoicing process can result in discrepancies between the data on the supplier invoice and the order, contract,
or receipt data in Ariba Procurement and Invoicing Solutions. These invoice exceptions are handled through a
reconciliation process.
An invoice is a request for payment, typically sent by a supplier. Invoices are usually created by the supplier, to
reflect an amount due for a purchase order or a contract. In the most typical case, invoices are sent electronically
to your company as cXML documents, over Ariba Network.
For each invoice, the reconciliation process creates an additional approvable document, called an invoice
reconciliation document, that lists any invoice exceptions on that document. An invoice exception represents a
single discrepancy between the data on the supplier invoice and the order, contract or receipt data in Ariba
Procurement and Invoicing Solutions. Exceptions can represent a variety of issues, such as missing receipts,
mismatched quantities or prices, duplicate invoices, or tax variances.
About Forcing Reconciliation to Manually Change the Status of an Invoice [page 17]
About Data Import Tasks for Invoice Exception Types [page 35]
For example, in the default configuration, users who are members of the:
The default approval rules use the groups associated with exception types to determine the set of approvers. The
approval rules look over the invoice reconciliation document, find all exceptions on that document, and define as
approvers those users who have permission to reconcile the specified exceptions. These approvers are typically
the first approvers on the flow, and are the users who are expected to reconcile any listed exceptions.
Ariba Invoice Professional and Ariba Procure-to-Pay include a standard set of invoice exception types.
Related Information
Related Information
Tax tables are used to verify the tax amount on invoice line items. When the tax amount on the invoice does not
match the calculated tax amount, a tax exception occurs.
If both the invoice and calculated taxes exist, the UnderTaxVariance, OverTaxVariance,
WHTUnderTaxVariance, and WHTOverTaxVariance exceptions are used to compare the two tax amounts and
validate the difference against the tolerances defined in your configuration. These exceptions use only a
percentage tolerance. Absolute tolerances are not appropriate for these exception types. For withholding taxes,
the absolute values of the taxes are considered. For example, a withholding tax of USD -20 if considered greater
than a withholding tax of USD -10.
If your company uses accrual accounting, the differences in tax amounts might reflect accounting differences
rather than actual exceptions. For example, if the vendor does not record tax at the point of sale, the tax amount
on the invoice might differ from the calculated tax amount. In this situation, your Ariba application includes the
ability to accumulate accrued taxes as an expected payment, and to recognize the difference in tax amounts as an
accrued tax amount.
Also, if sales tax was included for a line item on the invoice that was meant for accrual, an AccrualTaxVariance
exception is returned.
The date based on which taxes are calculated in invoice reconciliation documents is customizable. By default,
Ariba Procurement and Invoicing Solutions use the creation date of the invoice reconciliation document; but for
more acurate tax calculations, Ariba recommends you to use the invoice date. Contact your Ariba customer
support administrator to set this date.
The default configuration defines exception types based on received quantities. The behavior of these exception
types depends on how receiving is set up for your site.
The received quantity variance exception checks the OrderLineItem.NumberAcceptedInvoiceable field. This
field is set during receiving, and updated when receipts are generated.
When comparing invoice amounts for partial invoicing, a cumulative amount invoiced accumulator is used to
calculate invoice exceptions for partial invoicing.
In exceptions such as the reject amount variance, this accumulator is used to make sure that the percentage
variance does not become artificially high as the amount left to be invoiced decreases. For calculating such
exceptions, the cumulative amount invoiced is compared to the amount ordered. This comparison ensures that
the percentage tolerance remains constant, even as the amount left to be invoices decreases.
Unmatched Exceptions
Exceptions of type UnmatchedInvoice occur when the invoice reconciliation document cannot be matched to
the order or contract.
The FieldPathToValidate value is ignored during the validation, but is used for formatting the exception
description, for example:
Ariba Invoice is unable to match a purchase order to the invoice of amount {1}
Unmatched exceptions have a higher priority than other exception types. If an invoice reconciliation document has
an unmatched exception, no other exceptions are initially generated. Header exceptions and line item exceptions
are ranked separately—if an unmatched line item exception occurs, it does not prevent other header-level
exceptions from being generated.
PO Variance Exceptions
Exceptions of type POAmountVariance occur when the POAmountInvoiced field on the invoice does not match
the Order.AmountOrderedInvoiceable field on the order. The POAmountInvoiced field includes regular line
invoiced amounts as well as charge amounts, if any, such as taxes, shipping, and handling.
If your site supports taxes, charges, and discounts on purchase orders, the
Order.AmountOrderedInvoiceable field includes any taxes, charges, and discounts applied on the purchase
order. In this case, the default configuration for the POAmountVariance exception is correct.
For example:
Cp1252
"UniqueName","HeaderOnly","InvoiceCategory","LineCategory","LineType","FieldPathToVa
lidate",
"FieldPathTarget","FieldPathToValidateAgainst","FieldPathSourceOnDispute","NullAllow
ed",
"ToleranceOperation","AbsoluteTolerance","PercentageTolerance","AbsoluteRank","Relat
iveRank",
"AutoReject","QuantifiableOnly","SpendCategoryDriver","SpendCategory","IgnoreAutoAcc
ept"
"POAmountVariance",true,3,0,"","POAmountInvoicedLessCharges","TotalCost",
"Order.AmountOrderedInvoiceable","POAmountOrderedLessPreviouslyInvoiced",false,"or",
10,1.20,10,2,false,false,"","",false
POAmountInvoicedLessCharges is the amount that is already invoiced on the matched purchase order,
including the current invoice amount, but excluding any tax and shipping amounts.
Exceptions of type POPriceVariance are filtered by line category, and apply to standard line items only, not to
items assigned to line-type categories. When your Ariba application extracts line items to validate, it filters the set
of line items and checks only those that are of line category 1 (exception line items). This exception specifies that a
line item has an exception when the Description.Price field does not match the ExpectedPrice field within
the defined tolerances.
Exceptions of type POCatalogPriceVariance are filtered both by line category and by line type. Your Ariba
application validates only line items that are procure line items and then filters again to select only line items that
are of line type _CatalogItem.
If your site supports taxes, charges, and discounts on purchase orders, you can activate the
POTaxAmountVariance, POTaxLineAmountVariance, POChargeAmountVariance, and
POChargeLineAmountVariance invoice exception types to generate invoice exceptions when the tax or charge
amounts on the purchase order do not match the tax and charge amounts on the invoice. To resolve these
exceptions, you can only accept the invoice tax or charge amounts.
● POTaxAmountVariance: This exception is displayed if the total tax amount on the invoice and the total tax
amount on the purchase order vary by a value greater than the tolerance set.
● POTaxLineAmountVariance: This exception is displayed if the line-level tax amount on the invoice and the
line-level tax amount on the purchase order vary by a value greater than the tolerance set.
● POChargeAmountVariance: This exception is displayed if the total charge amount on the invoice and the
total charge amount on the purchase order vary by a value greater than the tolerance set.
If your site is enabled for Requester Defaulting, you can use the Invalid Requester invoice exception to autoreject
non-PO invoices submitted from Ariba Network.
Note
Autorejection does not apply to non-PO invoices submitted through an invoice conversion service. For
information about working with an invoice conversion service, see the Ariba Guide to Invoice Conversion.
In sites enabled after Release 10s2, Requester Defaulting is enabled by default. In sites enabled prior to Release
10s2, Requester Defaulting must be configured. Ask your Designated Support Contact to log a service request with
Ariba if you want to change the default behavior for your site.
In addition to allowing to autoreject non-PO invoices with invalid email addresses, the Requester Defaulting feature
defaults the requester (on behalf of) on an invoice to the requester of the order for manually entered PO-based
invoices or PO-based invoices submitted from Ariba Network and validates the requester on all invoices.
Use the Invalid Requester invoice exception to configure autorejection for non-PO supplier entered invoices that
have invalid Sold To addresses. If you want to disable autorejection, you must deactivate the invoice exception,
which allows members of the Invoice Agent group to correct any invalid email addresses.
Non-PO invoices that have been entered manually by the supplier or submitted through EDI or cXML
(SubmissionMethod = Online or EDI or cXML and InvoiceOrigin = Supplier) are auto-rejected.
This also applies to non-PO invoices that reference invalid purchase order IDs or invalid contract IDs (Customer
Order # or Contract # field in the Create Invoice supplier user interface in Ariba Network).
The email address (Sold To) <email address> on the invoice is invalid.
All other types of non-PO invoices with invalid or missing requester (Sold To) addresses including non-PO invoices
that have been submitted through an invoice conversion service (ICS invoices identified by SubmissionMethod =
PaperViaICS) generate a validation error and the Invoice Agent group is added to the approval flow to choose a
valid requester and process the invoice reconciliation. The requester is set to ‘aribasystem’.
Regardless of the submission method or origin, the invoice is forwarded to an exception handler to resolve the
invalid requester validation error. The requester is set to ‘aribasystem’.
The Invoice Exception Type Override feature allows you to define tolerances at the supplier level and the
commodity code level for each invoice exception type.
This allows for more efficient invoice reconciliation and exception handling, where, for example, a greater tolerance
is more suitable for some suppliers, while for others, a more narrow tolerance is desirable.
The absolute tolerance setting is evaluated first. The absolute tolerance values can be either based on the invoice
amount or quantity only (invoice-based absolute tolerance) or based on the difference between the invoice and the
PO or contract amount or quantity (difference-based absolute tolerance).
Absolute tolerance threshold exceeded means the absolute tolerance threshold is not met.
If the tolerance operation is And, the percentage tolerance does not have to be evaluated, and an exception is
triggered by having exceeded the absolute tolerance value alone. If the tolerance operation is Or, the percentage
tolerance is evaluated to determine if the values on the invoice are within the percentage tolerance calculation (no
exception) or if the values on the invoice exceed the percentage tolerances (exception is triggered).
Absolute tolerance threshold met means that the values on the invoice (for invoice-based absolute tolerance
configuration) or the difference between the values on the invoice and PO or contract (for difference-based
absolute tolerance configuration) are below the threshold settings.
If the tolerance operation is Or, no further calculations are necessary and the invoice line or invoice is accepted. If
the tolerance operation is And, the percentage tolerance is evaluated. If the percentage tolerance is met, no
invoice exception is triggered. If the percentage tolerance is not met, an invoice exception is triggered.
If the absolute tolerance value is 0 (zero), the tolerance operation is always evaluated, and the percentage
tolerance setting determines exception handling.
If the percentage tolerance is 0, invoice amount or quantities are evaluated using the absolute tolerance values
alone.
Tolerance threshold examples are based on this scenario: an absolute tolerance value of 50 is set on the PO Line
Amount Variance exception, and the tolerance is applied to the difference between the invoice and the PO. The
percentage tolerance value is 1.03 (3%).
The PO line item amount is 1,000.00 and the invoice line item amount is 1,045.00. The tolerance operation is Or.
Result: The absolute tolerance (the difference between the PO line amount and invoice amount, 45, is less than the
tolerance threshold of 50) is met, and the tolerance operation is evaluated. The invoice line is accepted because
the tolerance operation is Or.
The PO line item amount is 1,000.00 and the invoice line item amount is 1,045.00. The tolerance operation is And.
Result: The absolute tolerance (the difference between the PO line amount and invoice amount, 45, is less than the
tolerance threshold of 50) is met, and the tolerance operation is evaluated. The percentage tolerance is evaluated
because the tolerance operation is And. The percentage tolerance threshold (3% of PO line amount of 1,000.00 =
30) is not met. An invoice exception is triggered.
The PO line item amount is 1,000.00 and the invoice line item amount is 1,055.00. The tolerance operation is Or.
The PO line amount is 5,000.00, invoice line amount is 5,065.00. Tolerance operation is Or.
Result: The absolute tolerance difference threshold (50) is exceeded, and the tolerance operation is evaluated.
The percentage tolerance (3% of 5,000.00 = 150.00) is met (i.e. the difference between the line item invoice
amount and PO line item amount is within the threshold set by the percentage tolerance setting). The invoice line
is accepted.
The PO line amount is 5,000.00, invoice line amount is 5,065.00. Tolerance operation is And.
Result: The absolute tolerance difference threshold (50) is exceeded, and the tolerance operation is evaluated.
Since the tolerance operation is And, and the absolute tolerance is not met, an invoice exception is triggered.
When defining a contract request, contract managers can set a percent tolerance value on the contract’s
maximum limit. That tolerance is checked during exception calculation to decide if an invoice triggers an exception
or not.
Suppose a contract of USD 10,000.00 has a percentage tolerance of 2%. If the invoice line amount is for USD
10,150.00, the invoice is accepted because the amount is within the allowable tolerance limit.
If the contract line item variance exception is configured for an absolute variance tolerance of 100, and the
contract tolerance limit is not a hard limit, then only invoice line item amount values greater than 10,300 will
trigger an exception. In effect, the allowable tolerance values of the contract and the invoice exception are
combined to determine the maximum allowable amount that does not trigger an exception.
If the contract limit is defined as a hard limit, the variance tolerance defined for the exception is disregarded. In this
example, any invoice amount over USD 10,200.00 will lead to an automatic rejection of the invoice.
● If you specify Field Path To Validate, but not Field PathTo Validate Against or Tolerance Operation, the validity
check tests only the specified Field Path to Validate to see if it is null.
● If you specify Field Path To Validate and Field Path To Validate Against, but not ToleranceOperation, the
validity check tests to see if the two fields are equal.
● If you specify Tolerance Operation of or or and, the validity check tests the absolute tolerance first and then
the percentage tolerance (if necessary).
● If you specify Tolerance Operation of any, the validity check tests for the existence of a field.
● If you specify Tolerance Operation of boolean, the validity check tests for the Boolean value of the field Field
Path To Validate Against, which can be set to any Boolean field. If the boolean is set to True, no exception will
be generated.
● If you specify Tolerance Operation of boolean, the validity check skips NullAllowed.
● First, the reconciliation engine generates exceptions for the header. A higher-ranked header exception
prevents any lower-ranked header exceptions from being generated.
● Next, the reconciliation engine executes the same logic for lines. It uses any previously generated header
exceptions in the comparison. A higher-ranked header exception can supersede all line-level exceptions.
If an invoice has multiple exceptions with the same absolute rank, the relative rank value determines the relative
precedence of those exceptions.
The reconciliation engine does not re-check lower-ranked exceptions when higher-ranked exceptions are
reconciled. The ranking is used only as a filtering mechanism during the exception generation phase.
If an invoice exception has multiple overrides defined for them, and both overrides apply to the invoice line, it uses
the override rank to determine which override takes precedence.
For example, suppose the invoice exception PO Quantity Variance has both a commodity code override and a
supplier override applied to it:
In this example, because the rank of the Supplier override is higher than the commodity code override, the PO
Quantity Variance for the Supplier takes precedence.
1 Line Item For all line items, including non-catalog, catalog, and PunchOut
4 Shipping Charge For all charge lines with the out-of-the-box shipping charge type
8 Special Handling Charge For all charge lines with the out-of-the-box special handling charge type
32 Discount For all discount lines. Discount lines have a negative amount.
64 Withholding Tax For withholding tax lines. These lines have a negative amount.
The Line Type value (LineType column in InvoiceExceptionTypeValidation.csv) specifies the unique
internal identifier of a procurement line type. This field is used to restrict validation to line items of a certain type.
The following table describes the internal identifiers and user-visible descriptions of the default procurement line
types.
Discount Discount
FreightCharge Shipping
Note
The leading underscore character (_) in an internal identifier for a procurement line type indicates that the
procurement line type is required.
If you need to add or modify multiple invoice exception types, Ariba recommends you define your data in CSV files
and run the Import Invoice Exception Types and Import Invoice Exception Type Validation Data data import tasks.
About Data Import Tasks for Invoice Exception Types [page 35]
You can create a new invoice exception type or modify an existing invoice exception type.
Prerequisites
You must be a member of the Invoice Administrator, Payment Administrator, Invoice Manager, Payment Manager,
Procurement Manager, and Customer Administrator groups to add or modify exception types.
Procedure
Note
Certain fields, such as Field Path To Validate, specify field names. You will need to work with your Ariba
Customer Support representative when specifying field names.
Field Description
Adapter Source The adapter source, which can be one of the following values:
○ AribaManaged—The object is not maintained in an external system. Objects with
this data source are maintained in Ariba Administrator.
○ External—The object and all its data fields are maintained in an external system,
such as an ERP system or a set of CSV files. Objects with this adapter source can be
overwritten or deleted when data is imported from the external system.
○ ManuallyMaintained—The source of the object is an external system, but the object
cannot be overwritten or deleted when data is imported from the external system.
You cannot modify this field in edit mode.
Unique Name The unique internal identifier for the invoice exception type. You cannot modify this field
in edit mode.
Description The user-visible description for the invoice exception type. The string can take parame
ters, indicated as {0} and {1}, where:
○ {0} is the field designated in the Field Path To Validate Against field.
○ {1} is the field designated in the Field Path To Validate field.
Group The Group field specifies the unique identifier of a group. Members of this group are au
thorized to reconcile exceptions of the invoice exception type.
Depending on the group assigned to reconcile an invoice exception and the users’ group
memberships, users may be required to correct validation errors before they can submit
the IR. For example, users of the Invoice Agent group have full editing access and are
therefore required to correct all validation errors. Users of the Invoice Exception Pro
cessor group have no editing access to the IR and can only reconcile exceptions (and vali
dation errors will need to be corrected by subsequent approvers or other exception han
dlers with editing capabilities). Create custom invoice exception groups, for example
combining the Invoice Exception Processor, Invoice Header Editor, and Invoice Rejection
Specialist group, if you want to give exception handlers limited editing capabilities while
ensuring an efficient invoice exception handling workflow.
You can also associate an exception type with an approval queue by creating an approval
queue for the group specified in the Group field. When an approval queue exists for a
group, the invoice exception appears as an item in the approval queue instead of on the
To Do page of the users who belong to the group.
For information on configuring approval queues, see the Ariba Common Data Import and
Administration Guide.
Requester Allowed A Boolean value that determines if the requester is granted temporary permission to re
solve this exception type. In the default implementation, the following invoice exceptions
have the Requester Allowed flag set to Yes:
○ Contract Received Line Amount Variance
○ Contract Milestone Amount Variance
○ Contract Received Quantity Variance
○ PO Received Line Amount Variance
○ PO Received Quantity Variance
○ Item Unmatched.
If during reconciliation any of these invoice exceptions are found, the requester is
added as a watcher to the approval flow. They can then reconcile the exception that
they have been granted permission to resolve.
How the requester on the order is determined depends on your site’s configuration
and integration with your ERP:
○ On orders created in the Ariba procurement solution, the requester is the requester
on the original requisition.
○ On copy orders imported from an ERP system, the requester on the last order line is
used to determine the requester on the order.
Header Only A Boolean value that specifies whether the validation considers only header-level fields. If
set to No, the validation iterates through the line items on the invoice. Header-only ex
ceptions are not generated for summary invoices.
Invoice Category The invoice category to which the exception type applies. A value of Applies to all
documents means the exception type applies to all categories of invoices. Any other
value means the exception type applies only to invoices of the specified category.
Line Category The line category used to filter line items to validate. A value of Applies to all line types
means no filtering is performed. Any other value means that the validation applies only to
lines of the specified line category. This value is not relevant for header-level exceptions.
Line Type The procurement line type used to restrict validation to line items of a certain type. To
validate all line types, leave the field blank.
Field Path To Validate The invoice field being validated. If the Header Only field is set to Yes, the field path
starts from the invoice reconciliation object. Otherwise, the field path starts from the in
voice reconciliation line item.
If you are defining a custom exception type, the value of the Field Path To Validate field
must name an extrinsic, which you compute and maintain. Do not specify an internal
field. Using internal fields can change the value of those fields, disrupting the logic of the
application and causing errors.
Field Path Target The invoice field to be set when the invoice reconciliation is accepted or disputed. This
field is particularly useful when Field Path To Validate is a derived field and cannot be
used as the target field. If Field Path Target is null, Field Path To Validate is used as the
default target.
Field Path To Validate The invoice field to be used for comparison. This path often names a field on the pur
Against chase order, accessible from the invoice reconciliation document.
Field Path Source On Dispute The path of the field on the invoice reconciliation document or invoice reconciliation
document line item that is used to select the value to test on the target field when the
invoice exception is disputed.
Null Allowed A Boolean value that indicates whether a null is allowed in the Field To Validate Against
field. This field is useful for comparing limits associated with contracts.
Tolerance Operation A value that specifies how the tolerance is chosen. If the tolerance operation is not speci
fied, the tolerance is not checked and only an exact match is valid.
Apply Absolute Tolerance to If set to Yes, applies the value in Absolute Tolerance to the difference between the in
Difference voice (Field Path to Validate) and the purchase order or contract amount or quantify
(Field Path to Validate Against) (difference-based absolute tolerance).
If set to No, the value in Absolute Tolerance is applied to the invoice amount or quantity
(Field Path to Validate) only (invoice-based absolute tolerance).
Percentage Tolerance A floating-point number that defines the percentage of the field validated against. If the
value in Percentage Tolerance is 0, only the value in Absolute Tolerance is applied.
Absolute Rank An integer that is used to determine the order for checking exceptions when multiple ex
ceptions exist on the invoice. Exceptions with lesser values have higher rank and are
given precedence.
For example, the reconciliation engine checks exceptions of rank 1 first. If the reconcilia
tion engine generates a higher-rank exception due to a discrepancy, it does not check the
lower-rank exceptions. Only the higher-rank exception is presented to the user. The
header exceptions and line exceptions are ranked separately.
Relative Rank An integer that describes how to rank two exceptions with the same absolute rank on the
same field. If an invoice has multiple exceptions with the same absolute rank, the
Relative Rank field determines the relative precedence of those exceptions and the rank
with the lowest precedence is ignored.
Auto Reject A Boolean value that indicates whether failure of the validation causes the automatic rec
onciliation engine to reject the invoice reconciliation document. A value of Yes means an
exception of this type causes the invoice to be auto-rejected.
Ignore Auto Accept A Boolean value that indicates whether the exception type disables auto-accept. If this
field is set to Yes, auto-accept is disabled when exceptions of this type are present. If this
field is No, exceptions of this type have no effect on auto-accept.
3. Click Save to save your changes, or Cancel to return to the previous page without saving your changes.
Related Information
Configuring invoice exception type overrides is a two step process: creating the override, and applying it.
1. Create available exception type overrides by suppliers, commodity code, purchasing unit, or currency. You can
create these overrides on the Invoice Exception Types page for any invoice exception type.
2. Apply the override to the invoice exception type and specify the absolute and percentage tolerances, and
whether to automatically reject invoices that trigger exceptions.
Note
You cannot create invoice exception type overrides for boolean (yes/no) or field type (Supplier, Commodity)
checks on PO Payment Terms mismatched exceptions.
Invoice exception overrides by currency are applied in one of two ways, depending on site configuration:
Context
The numerical ranking of exception type overrides determines which override takes precedence when an
exception type has multiple overrides defined for it. Lower numbers denote a higher priority; higher numbers
denote a lower priority.
Procedure
1. On the Invoice Exception Types page, either click List All to show all invoice exceptions, or use the search
filters to search for an exception.
2. Choose any invoice exception type and select Edit from the Actions button on the right to display the details
page for the exception type.
3. On the exception type details page, click the Override tab to display the Overrides page.
4. In the Available Overrides section, click Create New.
5. Enter a unique name for the override, then choose the override type from the dropdown menu. Depending on
your choice, you are prompted to make further selections:
○ Supplier: choose a supplier from the list. You can also specify more than one supplier for the override.
○ Commodity Code: choose a code from the list of available codes on the dropdown menu. You can also
specify more than one commodity code for the override.
Related Information
Prerequisites
Procedure
1. On the Invoice Exceptions Type page, use List All to show all invoice exceptions types, or use the search filter
to find the invoice exception type you want to apply an override for. Select Edit from the Actions button.
2. Click the Overrides tab.
3. Click Create New in the Applied Overrides section.
4. Select one of the available overrides from the pull-down menu.
5. Assign the user group responsible to resolve any invoice exceptions for this override (for example, Invoice
Agent).
6. Specify the percentage tolerance and absolute tolerance values.
7. Specify whether or not to auto-reject the invoice when this invoice exception occurs for the supplier or
commodity code on the invoice.
8. Click Save.
Related Information
Procedure
The following table describes the columns on the Invoice Exception Types page:
Column Description
Header Only When checked, this column indicates that the validation considers only header-level fields.
When unchecked, this column indicates that the validation iterates through the line items on the
invoice.
Invoice Category The invoice category to which the exception type applies.
2. To view the details for an exception type, click its name in the Name column.
3. Click Done to return to the previous page.
Prerequisites
Before deleting any invoice exception types, Ariba recommends you export your invoice exception type data to
CSV files by running the Export Invoice Exception Types and Export Invoice Exception Type Validation Data data
export tasks.
Procedure
The following table lists data import task in the recommended order of use.
You can use the Import Invoice Exception Types data import task to define your own set of invoice
exception types. This task reads data from the CSV file named InvoiceExceptionType.csv.
UTF8
UniqueName,Name,Description,Group,RequesterAllowed
UnmatchedInvoice,Invoice Unmatched,Ariba Invoice is unable to match a purchase
order to the invoice of amount {1}.,Invoice Manager
For example:
UTF8
UniqueName,Name,Description,Language
UnmatchedInvoice,Invoice Not Matched,Ariba Invoice is unable to match a purchase
order to the invoice of amount {1}.,English
UnmatchedInvoice,Rechnungsabstimmung nicht moeglich,Ariba Invoice kann keine
Bestellung mit der Rechnungssumme {1} abstimmen.,English
● Which fields to compare when determining if an exception exists. For example, you can specify that an amount
variance exception occurs when the field TotalInvoiced on the invoice does not match the field
Order.AmountOrderedLessInvoiced on a purchase order.
● Whether the exception applies to the header or to line items, and whether it applies to all line items or only line
items of a certain line item type or category.
● Whether the exception is filtered by document type, so that it applies only to purchase orders, or to contracts
without release orders, or whether no filtering applies.
● Whether the exception includes a tolerance buffer. You can define tolerances either as absolute amounts, or
percentage amounts, or both. You can combine tolerance values with the operators AND, OR and ANY.
● Whether an exception type is related to other exception types, and which takes precedence when the same
exception can potentially be described in several ways. For example, if an invoice has unmatched item
exceptions, it probably also has quantity exceptions, amount exceptions, and price exceptions. Displaying the
unmatched item exception first makes sense, because resolving the first exception might resolve the other
exceptions as well.
● Whether an exception triggers an automatic rejection during the automatic reconciliation phase.
The Import Invoice Exception Type Validation Data data import task reads data from the CSV file
named InvoiceExceptionTypeValidation.csv.
UTF8
UniqueName,HeaderOnly,InvoiceCategory,LineCategory,LineType,FieldPathToValidate,Fiel
dPathTarget,
FieldPathToValidateAgainst,FieldPathSourceOnDispute,NullAllowed,ToleranceOperation,
AbsoluteTolerance,PercentageTolerance,AbsoluteRank,RelativeRank,AutoReject,Quantifia
bleOnly,
SpendCategoryDriver,SpendCategory,IgnoreAutoAccept,ApplyAbsoluteToleranceToDifferenc
e
UnmatchedInvoice,TRUE,0,0,TotalCost,IsMatched,IsMatched,FALSE,boolean,
0,0,1,1,FALSE,FALSE,,,FALSE
The PercentageTolerance column specifies a percentage of the field path to validate against
(FieldPathToValidateAgainst column).
"UniqueName","HeaderOnly","InvoiceCategory","LineCategory","LineType","FieldPathToVa
lidate",
"FieldPathTarget","FieldPathToValidateAgainst","FieldPathSourceOnDispute","NullAllow
ed",
"ToleranceOperation","AbsoluteTolerance","PercentageTolerance","AbsoluteRank","Relat
iveRank",
"AutoReject","QuantifiableOnly","SpendCategoryDriver","SpendCategory","IgnoreAutoAcc
ept",
”ApplyAbsoluteToleranceToDifference”
"POLineReceivedAmountVariance",false,3,1,"","OrderLineItem.AmountInvoiced","Amount",
"OrderLineItem.AmountAcceptedInvoiceable","RLIAmountAcceptedLessPreviouslyInvoiced",
true,
"or",1,1.1,4,3,false,false,"","",false
In this exception:
Suppose the accepted amount is 116,169.90 and the invoiced amount is 124,690.20. In this case, multiplying the
accepted amount by 110 percent results in 127,786.89:
Because 124,690.20 (the invoiced amount) is less than 127,786.89 (the accepted amount multiplied by 110
percent), the exception is not generated. In other words, the POLineReceiveAmountVariance exception is
generated only if the invoiced amount is more than 10 percent larger than the accepted amount.
Use the Import Invoice Exception Overrides by Common Commodity Code data import task to define
your own set of invoice exception overrides by commodity codes. This task reads data from the CSV file named
InvoiceExceptionTypeCCCOverride.csv.
UTF8
Rank,CommodityCodeDomain,DriverName,CommodityCodeId
3,unspsc,OverrideforComputers,4321
Use the Import Invoice Exception Overrides by Suppliers data import task to define your own set of
invoice exception overrides by suppliers. This task reads data from the CSV file named
InvoiceExceptionTypeSupplierOverride.csv.
UTF8
Rank,SupplierUniqueName,DriverName
3,11,OverrideforJCN
Use the Import Invoice Exception Overrides data import task to define your own set of invoice exception
overrides by purchasing unit and currency. This task reads data from the CSV file named
InvoiceExceptionTypeOverrideDriver.csv.
DriverName A name for either the purchasing unit or currency override; for
example, PUOverride.
Rank The numerical rank for the override, which determines which
override takes precedence when an exception has multiple
overrides defined for it. Lower numbers denote a higher prior
ity; higher numbers denote a lower priority.
For purchasing units, as for commodities, if you define an invoice exception override for a purchasing unit in one
part of a hierarchy, the override applies for all purchasing units underneath it in the hierarchy. For example, an
override for a purchasing unit for the entire United States applies to any state-specific purchasing units
underneath it in the hierarchy.
UTF-8
DriverName,FieldPath,Rank,Key
CurrencyOverride,Currency,10,BHD
PUOverride,PurchasingUnit,20,US100
Use the Import Invoice Exception Type Override Validation Data data import task to define the
specific tolerance override values to apply to an invoice exception for specific suppliers or specific commodity
codes. For each invoice exception, you can override the following values:
This task reads data from the CSV file named InvoiceExceptionTypeOverrideValidation.csv. The
following shows an example of this file:
UTF-8
UniqueName,IgnoreAutoAccept,PercentageTolerance,DriverName,RelativeRank,AutoReject,G
roup,AbsoluteRank,AbsoluteTolerance
POPriceVariance,No,3,OverrideforJCN,1,No,Invoice Agent,3,1
POPriceVariance,No,2,OverrideforComputer,1,No,Invoice Agent,3,1
Related Information
Invoices originating from Ariba Procurement and Invoicing Solutions are routed to your supplier, but by default
they are not tracked on Ariba Network. Your Ariba Network account might be configured to store a copy of the
invoice originating from Ariba Procurement and Invoicing Solutions and route it to your supplier. The supplier can
then view the status of their invoices and monitor their progress through your invoice reconciliation process.
If the system fails to route the invoice copy, the invoice could stall and remain in the CCInvoicetoAN status. In that
case, a Force Reconcile button is displayed when you view the details of an invoice. Click Force Reconcile to
manually change the status from CCInvoicetoAN to Reconciling.
Note
● To force reconciliation for an invoice document, you must belong to either the Invoice Administrator group
or the Customer Administrator group.
● When you use Force Reconcile to change the status of an invoice to Reconciling, the status of all related
invoices also changes to Reconciling.
A payment method defines how a buying organization makes a payment to a supplier. Typical payment methods
include check, Automatic Clearing House (ACH) electronic transfer, wire transfer, and credit card (purchasing
card).
When a payment request is created, the Ariba system sets a default payment method. Users viewing payments
can see and possibly modify the payment method from the user interface.
● Ariba Procure-to-Pay
● Ariba Invoice Professional
Additional References
Related Information
Additional References
You can view, add, modify, delete, and import payment methods.
Procedure
The following table describes the columns on the Payment Methods page:
Column Description
Clearance The number of days after which a payment made with this payment method is considered
cleared.
Payment Method Type The Ariba Network canonical payment method that corresponds to the payment method. You
choose a value from the list, which includes ach, creditCard, wire, check, and other.
These method types are mandated by the cXML protocol.
You can create new payment methods and modify existing payment methods.
Procedure
Field Description
Payment Method Name The unique internal identifier of the payment method. You cannot modify this field in edit
mode.
Preference Rank The numeric rank of the payment method, which is used to select a preferred payment
method when several are available. Lower numbers have higher precedence.
Clearance The number of days after which a payment made with this payment method is considered
cleared.
Preferred Indicates whether this is the preferred payment method to be used if a payment method can
not be determined from the remittance location. You can only set a preferred payment
method on the Payment Methods administration interface.
Payment Method Type The Ariba Network canonical payment method that corresponds to the payment method.
Choose other for third-party financing payment methods.
3. Click Save to save your changes, or Cancel to return to the previous page without saving your changes.
Prerequisites
Before deleting any payment methods, Ariba recommends you export your payment method data to a CSV file by
running the Export Payment Method Types data export task.
Procedure
The Import Payment Method types data import task reads data from the CSV file named
PaymentMethodType.csv. You manually enter data in this CSV file for PeopleSoft and Generic. For SAP, this file
can be manually maintained, or you can retrieve the data from your SAP system.
Note
If you want to configure a default (preferred) payment method, you must edit the payment method you want to
configure as the default payment method on the Payment Methods administration workspace.
UTF8
UTF8
UniqueName,Name,Description,Rank,Electronic,ClearancePeriod,CanonicalName
A,ACH,Payment via Automated Clearing House,2,TRUE,3,ach
C,Check,Payment through check,1,FALSE,15,check
S,Single Check,Payment through check,3,FALSE,15,check
T,Bank Transfer,Payment via Bank Transfer,4,TRUE,3,wire
U,International Bank Transfer,Payment via International Bank Transfer,5,TRUE,3,wire
wire,Fed WIRE,Payment via WIRE,6,TRUE,3,wire
Orbian,Orbian Financing,Payment via Orbian 3rd Party Financing,7,TRUE,3,other
Zorbian,3rd Party Financing via Zorbian,Payment via Zorbian 3rd Party Financing,
8,TRUE,3,other
UTF8
UniqueName,Name,Description,Rank,Electronic,ClearancePeriod,CanonicalName
ach,ACH,Payment via Automated Clearing House,1,true,3,ach
check,Check,ERP payment through check,2,false,15,check
wire,WIRE,Payment via WIRE,3,true,3,wire
creditCard,Credit Card,Payment via Credit Card,4,true,5,creditCard
You can use the Import Payment Method Type Translations data import task to import translations for
payment method names and descriptions.
The CSV file contains the following columns: UniqueName, Name, Description, Rank, Electronic,
ClearancePeriod, CanonicalName, Language.
For example:
UTF8
UniqueName,Name,Description,Rank,Electronic,ClearancePeriod,CanonicalName,Language
ach,ACH,Payment via Automated Clearing House,1,true,3,ach,English
ach,ACH,Bezahlung durch ACH,1,true,3,ach,German
The CSV contains the following columns: UniqueName, Name, Description, Rank, Electronic,
ClearancePeriod, CanonicalName, Language.
For example:
UTF8
UniqueName,Name,Description,Rank,Electronic,ClearancePeriod,CanonicalName,Language
A,ACH,Payment via Automated Clearing House,2,TRUE,3,ach,English
ach,ACH,Bezahlung durch ACH,1,true,3,ach,German
The CSV contains the following columns: UniqueName, Name, Description, Rank, Electronic,
ClearancePeriod, CanonicalName, Language.
For example:
UTF8
UniqueName,Name,Description,Rank,Electronic,ClearancePeriod,CanonicalName,Language
ach,ACH,Payment via Automated Clearing House,1,true,3,ach,English
ach,ACH,Bezahlung durch ACH,1,true,3,ach,German
Supplier payment information consists of the supplier’s bank information, payment model and payment method
used to pay the supplier, and the remittance location where payment is sent.
Additional References
Related Information
To obtain information about suppliers (including profile settings about the payment methods that each supplier
remittance location supports, bank names, and bank account IDs), the Ariba solution downloads supplier profile
information from Ariba Network by running a scheduled task.
You can associate a payment model with a specific supplier or supplier location.
The remit to address on an invoice is validated against the remittance address location configured in your site. By
default, for sites enabled on Release 10s2 or later, if the remit to address on an invoice received from Ariba
Network does not match any configured address, an ad hoc remit to address is created. Users must resolve an ad
On sites enabled prior to Release 10s2, if the remit to address on the invoice is different from any of the remittance
locations for the supplier location, then the remit to address is defaulted to the first remittance location found for
the supplier location. If no remittance locations are configured, the remit to address on the invoice is set to blank.
Additional References
Related Information
If you pay your suppliers through an external system (External System payment model), remittance location
information validation can be disabled, and defining a master list of valid remittance locations is optional.
Contact Ariba Customer Support if you want to disable remittance location validation. By default, remittance
location validation is enabled for all payment models.
The Ariba Pay payment model is not available to new implementations of Ariba Procurement and Invoicing
Solutions.
To prevent suppliers from adding additional remittance addresses and receiving payments to those addresses
fraudulently, you must define a master list of valid remittance locations. The Ariba solution uses that list to verify
the remittance locations defined by the suppliers on Ariba Network.
The remittance location for the supplier must match the remittance location configured in Ariba Network for that
supplier. If the values do not match, validation errors occur in the user interface.
If your site is configured to send payments to your suppliers through Ariba Network, the remittance address
chooser in the user interface shows only the valid addresses pulled from your master list. The Ariba system sends
payments to Ariba Network only if the remittance address selected from the chooser matches a remittance
address read from Ariba Network.
For suppliers with multiple supplier locations, the following happens if the supplier location on the cXML invoice is
invalid or missing:
1. If the invoice includes a remittance address, then this remittance address information is used to determine the
supplier location and the Remit To ID configured for the supplier location. That Remit To ID becomes the
Remit To on the invoice header (this effectively overwrites any incorrect addressID on the cXML invoice).
2. If no matching remittance address is found for any supplier location for the supplier, a default supplier location
based on zip code distances will be used for the invoice, and an ad-hoc remittance location is created for the
remittance address on the cXML invoice.
Additional References
The following diagram illustrates how you associate payment information with supplier locations for PeopleSoft.
The following diagram illustrates how you associate payment information with supplier locations for SAP.
The following diagram illustrates how you associate payment information with supplier locations for Generic.
RemittanceLocation.csv
RemittanceLocation.csv defines the address to which a remittance is made.
The following example defines a remittance location for the Schafer Office in Hamburg called RL1.
UTF8
RemittanceLocationDetails.csv
UTF8
Parent.UniqueName,PaymentMethod,BankInfo,RemittancePCardNumber
RL1,C,SupplierBankLocation-1,
The value in the PaymentMethod column is a payment method defined in PaymentMethod.csv. The value in the
BankInfo column links a supplier payment bank location to the remittance location.
Additional References
Related Information
SLRemittanceInformation.csv
SLRemittanceInformation.csv associates a supplier locations with Ariba Network payment information. The
value in the UniqueName column is a supplier location defined in SupplierLocation.csv.
For example:
UTF8
UniqueName,ContactID,ANPayEnabled
0000000001,0000000001,NO
When you have different contacts within the same supplier location, you use the contact ID to differentiate
between the locations.
SLRemittanceInformationDetails.csv
For example:
UTF8
Parent.UniqueName,Parent.ContactID,RemittanceLocation
0000000001,0000000001,RL1
When you have different contacts within the same supplier location, you use the contact ID to differentiate
between the locations.
You can examine payment information for all suppliers or you can use search filters to view payments for one or
more specific suppliers.
Procedure
Procedure
You can add or modify the name and address information for the remittance location. You can also add or edit
the payment method associated with a remittance location. .
Note
When a supplier uses the Ariba Network payment model, the remittance location for the supplier must
match the remittance location configured in Ariba Network for that supplier. If the values do not match,
validation errors occur in the user interface.
3. Click OK to save your changes, or Cancel to return to the previous page without saving your changes.
Related Information
You can create new supplier payment methods or modify the information about existing methods.
Procedure
If no payment methods exist in the chooser, you have not created any payment methods.
4. To choose or modify the bank information, click Select.
If no bank information exists in the chooser, you have not created any supplier bank locations.
In Ariba Procure-to-Pay, if you choose a credit card as the payment method, the Bank Information menu
changes to Buyer PCard Number and you can select a ghosted purchasing card number.
5. Click OK to save your changes, or Cancel to return to the previous page without saving your changes.
Related Information
Prerequisites
You can also add or modify payment models for supplier locations.
If you need to modify the payment model for a supplier, ensure that all of your payments are processed completely
before you modify the payment model.
○ Default: The payment model defaults to the payment model configured for your site. Ariba Customer
Support configures the payment model for your site during the site enablement process using the
Application.Settlement.PaymentModel parameter.
○ Ariba Network: Ariba Pay payment model. Payment requests are sent to Ariba Network, which makes the
payment.
Note
The Ariba Pay payment model will be de-supported in a future release, and is not available to new
implementations of Ariba Procurement and Invoicing Solutions.
○ External System: Payment requests are handled in an external system, such as an ERP system. This is
the default setting of the Application.Settlement.PaymentModel parameter.
3. Click Save to save your changes, or Cancel to return to the previous page without saving your changes.
You can add or modify supplier payment models for individual supplier locations.
Prerequisites
If you need to modify the payment model for a supplier location, ensure that all of your payments are processed
completely before you modify the payment model.
Procedure
Note
The Ariba Pay payment model will be de-supported in a future release, and is not available to new
implementations of Ariba Procurement and Invoicing Solutions.
○ External System: Payment requests are handled in an external system, such as an ERP system.
3. Click Save to save your changes, or Cancel to return to the previous page without saving your changes.
The following table lists the data import tasks and CSV files that define remittance location information. Tasks
appear in the recommended data import order.
Import Remittance Locations reads data from the following CSV files:
UTF8
UniqueName,AddressUniqueName,Name,Lines,City,State,PostalCode,CountryUniqueName
UTF8
Parent.UniqueName,PaymentMethod,BankInfo,RemittancePCardNumber
sid480-be,ach,sid480-be-ach,
sid480-be,CHK,sid480-be-check,
sid480-be,EFT,sid480-be-wire,
sid480-hq,ach,sid480-hq-ach,
sid480-hq,CHK,sid480-hq-check,
Import Supplier Location Remittance Information reads data from the following CSV files:
SLRemittanceInformationDetails. Associates supplier locations with remittance locations. Each supplier location
csv must have its own remittance location. You cannot associate multiple supplier
locations with the same remittance location.
For information on defining and importing supplier locations, see the Ariba
Common Data Import and Administration Guide.
UTF8
UniqueName,ContactID,ANPayEnabled
9,9,NO
9,64,YES
13,13,NO
14,63,YES
15,14,NO
UTF8
Parent.UniqueName,Parent.ContactID,RemittanceLocation
9,9,RL6-1
9,64,RL6-2
13,13,RL10-1
14,63,RL11-1
15,14,RL10-2
The Funds Management accounting functionality enables you to include accounting information for Funds
Management account assignment fields on approvable documents, such as requisitions and invoice reconciliation
documents for encumbrance accounting and budget availability control on fund-based budgets. This functionality
is supported only on Ariba Procurement and Invoicing Solutions integrated with SAP ERP.
When the Funds Management accounting functionality is enabled, you can perform the following tasks:
● Include Funds Management account assignment fields as standard Flexible Master Data (FMD) fields on
approvable documents based on pre-configured FMD templates.
● Derive accounting values from the SAP ERP for Funds Management account assignment fields on requisitions
based on other accounting information that is included in such documents.
When you perform procurement transactions, Funds Management processes run in the SAP ERP using the data
sent by the Ariba Procurement Solution to validate the Funds Management accounting information on the
approvable documents.
The Funds Management accounting feature is not enabled on your site in the default configuration.
To enable this feature, have your Designated Support Contact log a service request, and an Ariba Customer
Support representative will contact you. Additionally, include a request for the following:
● Add visibility conditions for specific Funds Management account assignment fields that you do not want to
include for your site.
● Add visibility conditions for specific approvable documents for which you do not want to include Funds
Management account assignment fields.
Note
If visibility conditions are not configured, there is no action possible to remove the Funds Management account
assignment fields that are already added to any approvable document.
Additional References
See the Purchasing Unit Administration Guide for more information about the visibility control feature.
Note
There is no synchronization with SAP ERP to support organic data growth for the Funds Management account
assignment fields. As a result, Funds Management accounting master data in Ariba Procurement and Invoicing
Solutions is not automatically updated if there are changes to the master data in the SAP ERP. In addition, Ariba
Procurement and Invoicing Solutions do not maintain or validate the relationship between Funds Management
account assignment fields.
Procedure
1. Run the data import tasks to import Funds Management accounting information for your site. For more
information, see Importing Flexible Master Data Templates for Funds Management Account Assignment
Fields [page 62].
Procedure
1. For SAP, PeopleSoft, and Generic ERP systems, build the integration using an Enterprise Application
Integration (EAI) tool to support web services-based integration of transactional data between the Ariba
Procurement and Invoicing Solutions and the ERP system.
Note
For SAP NetWeaver PI, the Ariba Procurement and Invoicing Solutions provides an end-to-end integration
with SAP ERP using SAP NetWeaver PI.
2. Depending on your Ariba solution, configure the end points for the following web services:
○ Export Requisitions to Derive the Accounting Information for Funds Management
○ Export Invoice Reconciliation Documents to External System to Add Funds Management Accounting
Information
3. Enable the web services.
Procedure
You can use Flex as a keyword to perform a search for Funds Management accounting data import tasks.
3. Click Import for the appropriate task.
Related Information
This following table lists the simplified data import tasks and the corresponding CSV files for the Funds
Management account assignment fields:
The Import Flex Master Data EarmarkedFundsDocument data import task defines the Earmarked Funds
Document field and related information and reads from the EarMarkExport.csv file.
Sample Code
UTF-8,,,,,,,
UniqueName,Name,CompanyCode,PurchasingUnit,cus_FMArea,cus_FMValidfromdate,cus_FMVa
lidtodate,cus_Description
10,Item Nozzle,,,Atlanta,1/1/2015,1/1/2016,Nozzle for Rocket IVX
The Import Flex Master Data EarmarkedFundsLineItem data import task defines the Earmarked Funds Line
Item # field and related information and reads from the EarmarkedFundsDocumentExport.csv file.
Sample Code
UTF-8
UniqueName,Name,CompanyCode,PurchasingUnit,cus_DocumentItem,cus_ItemText,Amount,Un
iqueName,ApproxAmountInBaseCurrency,ConversionDate,UniqueName
10,Roket Nozzle,,,10,Fund For Nozzle,2000,,,,
11,Oxidizer,,,11,Fund for Oxidizer,2001,,,,
12,Propulsion pumps,,,12,Fund for propulsion Systems,2002,,,,
The Import Flex Master Data Fund data import task defines the Fund field and related information and reads from
the FundExport.csv file.
Sample Code
"UTF-8"
UniqueName,Name,CompanyCode,PurchasingUnit,cus_FundAREA,cus_ValidStartDate,cus_Val
idEndDate,cus_Description
10,Space Discovery,,,Atlanta,01/01/2014,01/01/2016,Fund for Space Discovery
11,Space Station,,,Toronto,01/01/2015,01/01/2017,Fund for Space Station
12,Mars project,,,Columbia,01/01/2013,01/01/2018,Fund for Mars project
The Import Flex Master Data BudgetPeriod data import task defines the Budget Period field and related
information and reads from the BudgetPeriodExport.csv file.
Sample Code
"UTF-8"
The Import Flex Master Data FundsCenter data import task defines the Funds Center field and related
information and reads from the FundsCenterExport.csv file.
Sample Code
"UTF-8"
UniqueName,Name,CompanyCode,PurchasingUnit,cus_FMArea,cus_FundsCenter,cus_FMValidf
romdate,cus_FMValidtodate,cus_Description
10,R&D,,,Atlanta,R&D,01/01/2015,01/01/2016,Research and Development
11,Space Exploration,,,Toronto,Space Exploration,01/01/2015,01/01/2016,Space
Exploration
12,Propulsion Systems,,,Columbia,Propulsion Systems,
01/01/2015,01/01/2016,Propulsion Systems
The Import Flex Master Data CommitmentItem data import task defines the Commitment field and related
information and reads from the CommitExport.csv file.
Sample Code
"UTF-8"
UniqueName,Name,CompanyCode,PurchasingUnit,cus_FMArea,cus_CommitmentItem,cus_FMVal
idfromdate,cus_FMValidtodate,cus_SuperiorCommitmentItem,cus_Descriptionline1,cus_D
escriptionline2,cus_Descriptionline3
10,R&D,,,Atlanta,R&D,
01/01/2015,01/01/2016,ReasearchOnMars,Research&Development,Mars Project,Ongoing
11,SpaceShuttle,,,Toronto,SpaceShuttle,
01/01/2015,01/01/2016,SpaceShuttle,SpaceShuttle,Shuttle Project,Final Stage
The Import Flex Master Data FunctionalArea data import task defines the Functional Area field and related
information and reads from the FuncAreaExport.csv file.
Sample Code
"UTF-8"
UniqueName,Name,CompanyCode,PurchasingUnit,cus_FMValidfromdate,cus_FMValidtodate,c
us_Functionalareatext
10,Engineering,,,01/01/2015,01/01/2016,Engineering
11,Applied Science,,,01/01/2015,01/01/2016,Applied Science
12,Opearations,,,01/01/2015,01/01/2016,Opearations
The Import Flex Master Data Grant data import task defines the Grant field and related information and reads
from the GranteeExport.csv file.
Sample Code
"UTF-8"
UniqueName,Name,CompanyCode,PurchasingUnit,cus_Sponsor,cus_Validfromdate,cus_Valid
todate,cus_GrantName,cus_GrantDescription,cus_GrantType,cus_GrantTypeDescription
10,COFAR,,,Financial Reform Dept,01/01/2015,01/01/2016,COFAR,Council on Financial
Assistance Reform,Finance,Nasa's Exisiting Fund
11,PMS,,,Payment Managemt System,01/01/2015,01/01/2016,PMS,Payment Management
System,Payment,USA Govt Allocation
The Import Flex Master Data FMArea data import task defines the FM Area field and related information and
reads from the FMAreaExport.csv file.
Sample Code
"UTF-8"
UniqueName,Name,CompanyCode,PurchasingUnit,cus_FMAreatext,cus_FMAreaCurrency
10,Atlanta,,,Atlanta,USD
11,Toronto,,,Toronto,USD
12,Columbia,,,Columbia,USD
Invoices that have been transmitted to Ariba Procure-to-Pay solutions configured for the Generic, SAP, and
PeopleSoft variants and integrated with your ERP through the Ariba Integration Toolkit, but have not yet had
reconciliations approved are processing invoices.
Processing invoices are preliminary and are subject to a number of changes during reconciliation. For example, the
reconciliation process might adjust an invoice total downwards because some invoiced goods were not actually
received. Once the reconciliations are approved, the invoices are then “OK to Pay.”
The Export Invoices task exports header, detail, and split accounting data for all invoices that are processing
but have not yet had reconciliations approved. You can use this preliminary invoice data in a number of different
accounting processes. For example, some companies want to account for, or book, all outstanding invoices
preliminarily so that they have accurate data on all potential accounts payable at a given time. They distinguish
these preliminary bookings from final reconciled, approved invoice bookings.
Each invoice that Ariba Procure-to-Pay is currently processing generates a record for invoice export. When a
processing invoice is rejected or cancelled, that event generates another record for invoice export. The Status
and StatusDate fields in the exported data file show when an invoice is marked as processing, rejected or
canceled. After an invoice reconciliation is approved, it is no longer included in the invoice export. Instead, it is
included in the payment request export.
The following table describes how invoices with different statuses are included in data exports:
Status Export
Processing Data for the invoice is added to the invoice export with a status of Processing. In most
sites, invoices automatically go straight into reconciliation. However, some sites are
configured to require manual approval of all processing invoices before they can be
reconciled; the invoice is not added to the export until it has been manually or auto
matically approved for reconciliation.
Rejected or Cancelled Data for the invoice is added to the invoice export with a status of Rejected or Cancel
led. This data is only added if the invoice was already Processing. Data for invoices
that are rejected or cancelled before entering Processing status are not added to the
export.
Approved Data for approved invoice reconciliations are not included in the invoice export; in
stead, they are added to the payment request (OK-to-Pay) export.
Note
● Invoice export is an optional feature and is disabled by default; an Ariba Customer Support representative
must enable it in your site by setting the Application.Invoicing.InvoiceExport.Enabled parameter
to Yes. Once the export is enabled, the exported invoice data only includes new invoices. It does not include
any invoices that are in the process of or have completed reconciliation, approval of invoice reconciliation, or
payment at the time of enablement.
● Ariba recommends that you configure your integrations to pull invoice export data before payment request
data so that it can be used for preliminary invoice bookings.
Related Information
Additional References
Exporting Invoices
You can export invoices by running the Export Invoices data export task in Ariba Administrator.
Procedure
1. Choose Site Manager Data Import/Export and click the Export tab.
2. Find the Export Invoices task and click Export.
3. Select a date range for the export by choosing dates in the From and To fields. Ariba Administrator exports all
the invoices that register a status of Processing, Rejected, or Cancelled within that time range. Invoices that
are reconciled and approved during the specified date range are not included in the export.
4. Click Run to export the data.
After the data has finished downloading, click Open to view the contents of the ZIP file or Save to save the file to
your local hard drive.
The Export Invoices data export task exports a ZIP file containing the following CSV files:
● InvoiceHeaderExport.csv
● InvoiceDetailExport.csv
● InvoiceSplitAccountingExport.csv
InvoiceRequester The unique name of the user who requested the invoice. This field String (255)
does not appear on the invoice in Ariba Procure-to-Pay.
StatusDate The date on which the invoice is received/approved, rejected, or String (100)
cancelled. This field does not appear on the invoice in Ariba Procure-
to-Pay.
InvoiceType The type of the invoice: standard invoice, header-level credit memo, String (32)
line-level credit memo, or debit memo. This field does not appear on
the invoice.
TaxExchangeRate The exchange rate captured when a cXML invoice comes in from Decimal
Ariba Network and has tax lines in different currency than the item
lines. The alternate amount/currency for the tax lines is calculated
using this exchange rate. This field does not appear on the invoice in
Ariba Procure-to-Pay.
SupplierLocationContactI The ID of the contact person at the specified supplier location. String (50)
D
SupplierLocation The unique internal identifier of the supplier location to which the String (50)
payment is made.
Supplier The unique identifier for the supplier that generated the invoice. String (50)
GrossAmountCurrency The currency code for the gross amount of the invoice. String (50)
Status The status of the invoice: Processing for received/approved (but not String (100)
yet reconciled) invoices, Rejected for rejected invoices, and Cancel
led for cancelled invoices. This field does not appear on the invoice in
Ariba Procure-to-Pay.
InvoiceDate The date on which the invoice was created. String (100)
PurchasingUnit The unique identifier for the purchasing unit that placed the order. String (50)
InvoiceId,PurchasingUnit,InvoiceNumber,InvoiceDate,InvoiceType,Status,StatusDate,Sup
plier,
GrossAmount,GrossAmountCurrency,PaymentTerms,TaxExchangeRate,SupplierLocation,
SupplierLocationContactID,InvoiceRequester,RemittanceLocation
"INVINV159-159","US100","INV159","02/20/2013 11:08:48-0800","standard","Processing",
"02/20/2013 11:13:44-0800","11","6.9500","USD","PT1","0","14","63","ghalas","RA11-1"
"INVINV159-159","US100","INV159","02/20/2013 11:09:48-0800","standard","Cancelled",
"02/20/2013 11:13:44
-0800","11","6.9500","USD","PT1","0","14","63","ghalas","RA11-1"
ERPOrderLineNumber The purchase order line number associated with the invoice rec Integer
onciliation line number.
LineTypeCategory The category of the invoice line item. Line categories separate Integer
procurement line items from various special handling catego
ries such as tax and freight. The line categories are as follows:
Amount The amount of the invoice line item, such as the amount for a Decimal
commodity or a tax charge.
UnitPrice The unit price for the invoice line item or, for tax line items, the Decimal
tax charge.
LineNumber The unique identifier for an individual or grouped invoice line. Integer
ERPCommodityCode The ERP commodity code for the invoice line item. If your site String (50)
does not use ERP commodity codes, this field is blank.
ParentLineNumber The unique identifier for an invoice item group that contains Integer
child grouped items.
TaxCode The tax code for the invoice line item. String (50)
TaxType The tax type for the invoice line item; for example, SalesTax. String (50)
ERPOrderID The purchase order ID associated with the invoice reconciliation String (50)
line number.
Purchasing Unit The unique identifier for the purchasing unit that generated the String (50)
order.
InvoiceId,PurchasingUnit,LineNumber,ParentLineNumber,LineTypeCategory,TaxCode,TaxTyp
e,Description,Amount,UnitPrice,AmountCurrency,ERPCommodityCode,ERPOrderID,ERPOrderLi
neNumber
"INVINV159-159","US100","1",,"1",,,"Mac Angled Keyboard Adapter MD4M/
F","6.9500","6.9500","USD",,,
"INVINV159-159","US100","1",,"1",,,"Mac Angled Keyboard Adapter MD4M/
F","6.9500","6.9500","USD",,,
AccountingCombinationID The unique identifier for the accounting combination defined in String (50)
Ariba Procure-to-Pay.
Account The unique identifier for the account; for example, Expense. String (50)
CostCenter The unique identifier for the cost center. String (50)
Region The unique identifier for the accounting region. String (50)
LineNumber The unique identifier for an individual or grouped invoice line Integer
item.
BusinessUnit The unique identifier for the general ledger business unit. String (50)
Purchasing Unit The unique identifier for the purchasing unit that generated the String (50)
order.
InvoiceId,PurchasingUnit,LineNumber,SplitLineNumber,Company,BusinessUnit,CostCenter,
Account,
SubAccount,Product,Project,Quantity,Amount,Region,AccountingCombinationID
"INVINV159-159","US100","1","1","GD","US100","3100","7520","5008",,,"1.0000","6.9500
",,"298"
"INVINV159-159","US100","1","1","GD","US100","3100","7520","5008",,,"1.0000","6.9500
",,"298"
In SAP variants, the Export Invoices task exports an InvoiceExport.zip file containing the following invoice
data CSV files:
● InvoiceHeaderExport.csv
● InvoiceDetailExport.csv
● InvoiceAccountDetails.csv
StatusDate The date on which the invoice was approved, canceled, or rejected. String (100)
This field does not appear on the invoice.
InvoiceType The type of the invoice: standard invoice, header-level credit memo, String (32)
line-level credit memo, or debit memo. This field does not appear on
the invoice.
Status The status of the invoice for export. This field does not appear on the String (100)
invoice.
REF_DOC_NO The invoice number as reference document number. The maximum String (16)
permissible length for this field is 16 characters. This field does not
appear on the invoice.
InvoiceDate The date on which the invoice was created. String (100)
URL URL to access the site. This field does not appear on the invoice. String (100)
InvoiceId,REF_DOC_NO,COMP_CODE,CURRENCY,DOC_DATE,PMNTTRMS,InvoiceDate,DIFF_INV,Invoi
ceType,Status,StatusDate,URL,GROSS_AMT
“INVINV-4853-INV856566678-20”,”INV-4853-INV8565”,”3000”, “USD”, “20140601”,”PT1”,
“6/1/2014”, “6:20”, “100”, “standard”, “Processing”, URL, “695”
ORDERID The unique value of internal order account assignment category String (50)
for that line item.
LINE_TYPE_LOOKUP_CODE The category of line item. This field does not appear on the in Integer
voice.
COSTCENTER The unique value of the cost center account assignment cate String (50)
gory for each line item.
GL_ACCOUNT The unique value of the general ledger accounting type for each String (50)
line item.
PLANT The unique code of the ship-to location for each line item. String (50)
PBQ_DESC The price basis quantity fields for each item in the requisition String (2000)
line items.
ITEM_AMOUNT_ROUNDED The amount for the line item in ERP precision. BigDecimal
IS_COMPOSITE The flag indicating if the line is composite or not. Composite Boolean
lines may consist of child lines for a regular line item. This field
does not appear on the invoice.
LINE_COMP_CODE The unique value of the Company Code for the line item. This String(50)
field will be populated for non-purchase order invoices and
Application.Invoicing.AllowLegalEntityCodeA
tSplitLevel parameter is set to Yes.
HDR_LEVEL This field determines whether a line item is at the header level. Boolean
This field does not appear on the invoice.
PO_NUMBER The unique ID of every purchase order the invoice belongs to. In String(50)
case of an ERP order, the field provides a reference to the ERP
order ID.
WBS_ELEM The unique code of the WBS element account assignment cate String(50)
gory for that line item.
ASSET_NO The unique value of the Asset account assignment category for String(50)
each line item.
ORDERID The unique value of internal order account assignment category String(50)
for the line item.
CATEGORY The category of the line item. This field does not appear on the Integer(50)
invoice.
COSTCENTER The unique value of the cost center account assignment cate String(4)
gory for each line item.
SUB_NUMBER The asset SubNumber for the asset account assignment cate String(50)
gory for each line item. This field does not appear on the in
voice.
LINE_COMP_CODE The unique value of the company code for the line item. This String(50)
field will be populated for non-purchase order invoices and
Application.Invoicing.AllowLegalEntityCodeA
tSplitLevel parameter is set to Yes.
PO_PR_UOM The unit of measure for the quantity defined by price, basis, and String(50)
quantity.
GL_ACCOUNT The unique value of the general ledger accounting type for each String(50)
line item.
PO_NUMBER The unique ID of every purchase order the invoice belongs to. In String(50)
case of an ERP Order, the field provides a reference to the ERP
Order ID.
WBS_ELEM The unique code of the WBS element account assignment cate String(50)
gory for that line item.
ITEM_AMOUNT_ROUNDED The amount for the line item in ERP precision. BigDecimal
ASSET_NO The unique value of the Asset account assignment category for String(50)
each line item.
Item_Amount,Item_Amount_Rounded,WBS_Elem,Asset_No,CostCenter,Quantity,PO_Unit,Serial
_
No,Invoice_Doc_Item,OrderID,GL_Account,Tax_Code,InvoiceID,Category,Order,Line_Comp_C
ode,Sub_Number,PO_PR_UOM,
PO_Number
“695”,”695”,,,”2100”,”100”,”EA”,,”1”,,”405000”,,”INVINV-4853-
INV856566678-20”,”1”,,”3000”,,,
In PeopleSoft variants, the Export Invoices task exports an InvoiceExport.zip file that contains the
following invoice data CSV files:
● InvoiceHeaderExport.csv
● InvoiceDetailExport.csv
● InvoiceSplitAccountingExport.csv
VENDOR_SETID The set ID of the supplier. This field does not appear on the in String(50)
voice.
● Standard invoice
● Header-level credit memo
● Line-level credit memo
● Debit memo
This field does not appear on the invoice.
VENDOR_ID The vendor ID of the supplier. This field does not appear on the String(10)
invoice.
StatusDate The date on which the invoice was approved, canceled, or re String(100)
jected.
VENDOR_ADDR_SEQ_NUM The sequence number of the supplier's location. This field does String(10)
not appear on the invoice.
VOUCHER_LINE_NUM The voucher line number. This field does not appear on the in Integer
voice.
PARENT_LINE_NUM The parent line number for each line in the invoice. This field Integer
does not appear on the invoice.
LINE_TYPE_LOOKUP_CODE The line type lookup code that distinguishes each line with tax Integer
codes. This field does not appear on the invoice.
TAX_CODE The tax code. This field does not appear on the invoice. String(25)
LINE_NBR The ERP purchase order line number associated with the in Integer
voice line number.
ConversionFactor The quantity on which the price is quoted. This field does not BigDecimal
appear on the invoice.
PriceBasisQuantityDesc The price basis quantity fields for each item in requisition line String(2000)
items.
IsComposite Indicates whether this line is composite or not. Composite lines Boolean
may consist of child lines for a regular line. This field does not
appear on the invoice.
INV_ID,BUSINESS_UNIT,VOUCHER_LINE_NUM,PARENT_LINE_NUM,LINE_TYPE_LOOKUP_CODE,TAX_CODE
,TAX_TYPE,DESCR,UNIT_PRICECURRENCY_CD,PO_ID,SHIPTO,UNIT_OF_MEASURE,LINE_NBR,BUSINESS
_UNIT_PO,PriceBasisQuantity,PriceBasisQuantityUOM,ConversionFactor,PriceBasisQuantit
yDesc,IsComposite
“INVINV-4853-INV159566299-10”,”US003”,”1”,”1”,,”Adapter DB9F/MD8M Mac
Serial”,”6.95”,”USD”,,”US013”,”EA”,”0”,,,,,”No”
VOUCHER_LINE_NUM The voucher line number of each line item. This field does not Integer
appear on the invoice.
DISTRIB_LINE_NUM The distribution line number of each line item. This field does Integer
not appear on the invoice.
MERCHANDISE_AMT The merchandise amount of each line item. This field does not BigDecimal
appear on the invoice.
PO_ID The purchase order number of the purchase order-based in String(50)
voice. In case of ERP Order, the field provides a reference to the
ERP order ID.
INV_ID,BUSINESS_UNIT,VOUCHER_LINE_NUM,DISTRIB_LINE_NUM,BUSINESS_UNIT_GL,ACCOUNT,DEPT
ID,QTY_VCHR,MERCHANDISE_AMT,SPLIT_TYPE,PO_ID
“INVINV-4853-
INV159566299-10”,”US003”,”1”,”1”,”US003”,”131000”,”10200”,”100”,”695”,”_Percentage”
After an invoice has been approved in Ariba Procure-to-Pay, the final step is to send a payment to the supplier.
When it creates an invoice reconciliation document, Ariba Procure-to-Pay also creates a new approvable
document, called a payment request, to track the payment process.
Most payment requests represent amounts due to a supplier, such as for an unpaid invoice. Ariba Procure-to-Pay
also provides support for payment requests associated with credit memos. A credit memo is an invoice that
represents a refund owed to your company by the supplier.
For example, if your company purchased equipment that was later returned, the supplier might first issue an
invoice and then (after the return) a credit memo, which represents the amount due to be refunded to you. Ariba
Procure-to-Pay creates credit payment requests to represent credit memos.
Note
Ariba Procure-to-Pay exports payment requests that use the External System payment model only. The
External System payment model specifies that payments are handled in an external system, such as an ERP
system. Ariba Procure-to-Pay does not export payment requests that use the Ariba Network payment model.
Note
This information only applies to Ariba Procure-to-Pay. In Ariba Invoice Professional, reconciled and approved
invoices are transmitted from Ariba Network to your ERP through an Ariba Network adapter. For more
information, see the documentation for the respective adapter.
About Loading Payment Requests Into Your ERP System [page 81]
Additional References
Related Information
The Export Payment Requests data export task, which exports data to five CSV files, can be used with the SAP
and PeopleSoft as well as Generic ERP systems that can handle line item details and split accounting information
in separate files.
The Export Payment Requests in 3 File Format data export task, which exports data to three CSV files, is
only available for Generic variants. Export Payment Requests in 3 File Format does not include any tax
information. Customers who use the Generic variant can configure their ERP to export tax data as needed.
Note
Ariba provides the Export Payment Requests in 3 File Format data export task for ERP systems that
cannot handle line item details and split accounting information in separate files (i.e. Oracle).
Ariba Procure-to-Pay supports export of payment requests to the SAP ERP in real time (triggered when the
transactions are ready to be sent to the ERP) using the Web Services channel and SAP Netweaver.
Note
Ariba Procure-to-Pay exports payment requests that use the External System payment model only. Ariba
Procure-to-Pay does not export partial payments, even if you import a partial remittance from your SAP
system.
Additional References
Procedure
1. Choose Site Manager Data Import/Export and click the Export tab.
2. Find the Export Payment Requests data import task, or the Export Payment Requests in 3 File
Format data export task (Generic only), and click Export.
3. Select a date range for the export by choosing dates in the From and To fields. Ariba Administrator exports all
the payment requests that were marked “OK-to-Pay” during the specified date range. A payment request is
marked “OK-to-Pay” when the associated invoice reconciliation document has been fully approved and the
invoice is reconciled.
4. Click Run to export the data.
Ariba Procure-to-Pay does not export partial payments, even if you import a partial remittance from your ERP
system.
Next Steps
After the data has finished downloading, click Open to view the contents of the ZIP file or Save to save the file to
your local hard drive.
● PaymentHeaderExport.csv
● PaymentDetailExport.csv
● PaymentBankExport.csv
● PaymentSplitAccountingExport.csv
● AdvancePaymentDetailExport.csv
ECQUEUEINSTANCE The unique name of the electronic document in your ERP system. String (50)
PAYMENT_TERMS The unique internal identifier of the payment terms selected for the invoice. String (50)
Payment terms specify the time period in which a supplier requests payment
and any discounts that the supplier chooses to make available for early pay
ment.
TAX_ACCRUAL_PMNT A value that indicates whether the payment is an accrual payment. Boolean
REMIT_ADDR_SEQ_NUM The unique internal identifier of the remittance location. When sending a pay String (50)
ment to a given supplier location, Ariba Procure-to-Pay sends to the remit
tance location associated with that supplier location.
PMNT_ID,ECQUEUEINSTANCE,BUSINESS_UNIT,INVOICE_ID,INVOICE_DT,VENDOR_SETID,VENDOR_ID,G
ROSS_AMT,
PMNT_ID The unique reference ID of the payment. This value matches a payment de String (50)
fined in PaymentHeaderExport.csv.
ECQUEUEINSTANCE The unique name of the electronic document in your ERP system. String (50)
PARENT_LINE_NUM The voucher line number of the parent for a charge line on the invoice. Numeric
LINE_TYPE_LOOKUP_COD The line category. Line categories separate procurement line items from Numeric
E the various special handling categories, such as tax and freight. The line
categories are as follows:
● 1 - Line Item (for all line items, including non-catalog, catalog and
PunchOut)
● 2 - Tax Charge (for all tax-related charges)
● 4 - Freight Charge (for all freight-related charges)
● 8 - Handling Charge (for all handling-related charges)
● 32 - Discount (for discounts related to invoicing)
TAX_CODE The line item tax code. Ariba Procure-to-Pay initially sets the tax code String (25)
based on invoice information and the tax code it obtains from the tax code
lookup table. However, if a business user modifies the tax code during in
voice reconciliation, the modified tax code, not the initial tax code, appears
in this column.
TAX_TYPE The tax type, for example, SUTTax (Sales/Use tax). String (50)
TAX_ACCRUAL A value on the invoice tax line that indicates a tax accrual line. Boolean
MERCHANDISE_AMT For a line item, the value in this column is the amount charged for the com Numeric
modity. For a tax line item, the value in this column is the tax amount to pay
to the supplier.
CURRENCY_CD The currency code for the invoice line item amount. String (50)
PRICEBASISQUANTITY The quantity corresponding to the unit price of the item specified by the Big Decimal
supplier. The unit price is based on the price unit quantity of the item.
CONVERSIONFACTOR The ratio used to convert the ordered unit to the price unit. The unit price is Big Decimal
based on the price unit quantity and the price unit.
PRICEBASISQUANTITYDESC Any information for the advanced pricing details. String (2000)
PRICEBASISQUANTITYUOM The unit of measure for the unit price. String (50)
PMNT_ID,ECQUEUEINSTANCE,BUSINESS_UNIT,VOUCHER_LINE_NUM,PARENT_LINE_NUM,LINE_TYPE_LOO
KUP_CODE,
TAX_CODE,TAX_TYPE,TAX_ACCRUAL,DESCR,MERCHANDISE_AMT,UNIT_PRICE,CURRENCY_CD,PRICEBASI
SQUANTITY,PRICEBASISQUANTITYUOM,CONVERSIONFACTOR,PRICEBASISQUANTITYDESC
PAYNPOINv-67, IRNPOINv-67, US003, 1, , 1, CA, , No, Composite Monitor Ext. RCA M/F,
6950.0000, 6.9500, USD,"2.0000","GAL","1","Gallon price"
PAYNPOINv-67, IRNPOINv-67, US003, 2, 1, 2, CA, SUTTax, No, Sales/Use tax (auto-
generated), 0.0000, 0.0000, USDPayment Bank Data
PMNT_ID The unique reference ID of the payment. This value matches a payment de String (50)
fined in PaymentHeaderExport.csv.
ECQUEUEINSTANCE The unique name of the electronic document in your ERP system. String (50)
PYMNT_METHOD The unique internal identifier of the payment method. A payment method de String (50)
fines how a buying organization makes a payment to a supplier.
COMPOSITE_ACCT_KEY The unique internal identifier of the Ariba Procure-to-Pay buyer bank pay String (50)
ment location.
PAYMENT_CURRENCY_CD The transaction currency code for the payment. String (50)
PMNT_ID,ECQUEUEINSTANCE,BUSINESS_UNIT,PYMNT_METHOD,BANK_ACCT_KEY,
COMPOSITE_ACCT_KEY,
SCHEDULED_PAY_DT,BANK_CD,PAYMENT_AMT,PAYMENT_GROSS_AMT,PAYMENT_DISC_AMT,PAYMENT_CURR
ENCY_CD
PAYNPOINv-67, IRNPOINv-67, US003, ach, chec, BuyerBankLocation-1, 04/24/2006
12:43:48 -0700, 77777, 6950.0000, 6950.0000, 0.0000, USD
PMNT_ID The unique reference ID of the payment. This value matches a payment de String (50)
fined in PaymentHeaderExport.csv.
ECQUEUEINSTANCE The unique name of the electronic document in your ERP system. String (50)
PMNT_ID,ECQUEUEINSTANCE,BUSINESS_UNIT,VOUCHER_LINE_NUM,DISTRIB_LINE_NUM,BUSINESS_UNI
T_GL,ACCOUNT,DEPTID,QTY_VCHR,MERCHANDISE_AMT
PAYNPOINv-67, IRNPOINv-67, US003, 1, 1, USBC3, 156000, 105000, 1000.0000, 6950.0000
PAYNPOINv-67, IRNPOINv-67, US003, 2, 1, USBC3, 156000, 105000, 1.0000, 0.0000
AdvancePaymentDetailExport.csv contains the details of the advance payments adjusted against the invoice
for which the payment request is generated.
PMNT_ID The unique identifier of the payment request created for String (50)
the invoice
PAY101ECQUEUEINSTANCE The unique identifier of the invoice reconciliation docu String (50)
ment for the invoice
ORDER_ID The unique identifier of the purchase order associated String (50)
with the invoice and advance payment documents
ADVANCEPAYMENT_ID The unique identifier of the advance payment adjusted String (50)
against the invoice
ERPADVANCEPAYMENT_ID The unique identifier of the payment request created in String (50)
the ERP for the advance payment
CONSUMEDAMOUNT_AMOUNT The advance payment amount adjusted against the in Numeric
voice, in the user's currency
CONSUMEDAMOUNT_INBASECURR The advance payment amount adjusted against the in Numeric
ENCY voice, in the site base currency
ADVANCEPAYMENT_ID,ECQUEUEINSTANCE,PMNT_ID,ORDER_ID,ERPADVANCEPAYMENT_ID,CONSUMEDAMOU
NT_AMOUNT,CONSUMEDAMOUNT_CURRENCY,CONSUMEDAMOUNT_INBASECURRENCY
"APMT10","INV-IR101","PAY101","PO101","ERPAPMT10",10.00,"USD",10.00
Note
Ariba Procure-to-Pay exports payment requests that use the External System payment model only, and does
not export partial payments, even if you import a partial remittance from your SAP system.
This section describes the SAP data that Ariba Administrator exports when you run the Export Payment Requests
data export task. The data is stored in a ZIP file containing the following CSV files:
● PaymentHeaderExport.csv
● PaymentLineItemDet.csv
● PaymentAccountDet.csv
● PaymentDetailExport.csv
● PaymentTaxExport.csv
● AdvancePaymentDetailExport.csv
You can run the SAP function module ZARIBA_SSP_INVOICELOAD to transfer payment information from CSV files
into the SAP database.
Additional References
REF_DOC_NO The unique name of the invoice. Invoice numbers exceeding 16 characters are String (16)
truncated to 16 characters during export.
COMP_CODE The unique internal identifier of the SAP company code. String (4)
GROSS_AMOUNT The invoice’s gross amount to be paid to the supplier. For credit memos and neg Numeric
ative amounts, this value is positive.
PMNTTRMS The unique internal identifier of the payment terms selected for the invoice. Pay String (4)
ment terms specify the time period in which a supplier requests payment and any
discounts that the supplier chooses to make available for early payment.
PYMT_METH The unique internal identifier of the payment method. A payment method defines String (50)
how a buying organization makes a payment to a supplier.
ITEM_TEXT The unique name of the invoice reconciliation document. String (50)
URL A direct action URL. When external users click this URL, they are authenticated String (100)
and taken directly to the invoice reconciliation document in Ariba Procure-to-Pay.
ACCRUAL_PMNT_AMT The accrual payment amount determined by Ariba Procure-to-Pay to be paid sep Numeric
arately.
PAYMENTID,REF_DOC_NO,COMP_CODE,GROSS_AMOUNT,CURRENCY,DOC_DATE,PAYMENT_TERMS,DIFF_INV
,INVOICE_IND,PYMT_METH,ITEM_TEXT,BLINE_DATE,URL,ACCRUAL_PMNT_AMT
PAYPO10Invoice-LineLevel-10,PO10Invoice-Line,3000,8920,USD,
20060726,NT60,1000,X,IRPO10Invoice-LineLevel-10,20060726,https://sampleurl,125
ITEM_AMOUNT The amount for each line item. For credit memos and negative line item amounts, Numeric
this value is negative.
PO_NUMBER The unique ID of every purchase order for the ERP it belongs to. String (50)
PO_ITEM The line number of the corresponding line item. String (50)
LINE_TYPE The unique internal identifier of the line type of the line item. This field holds the tax String (50)
type for indirect and withholding tax lines. For charges, this field holds the values
FreightCharge, HandlingCharge, or Charge. For discount lines, this field
holds the value Discount. For other line items, this field holds the values
CatalogItem or NonCatalogItem.
PRICEBASISQUANTITY The quantity corresponding to the unit price of the item specified by the supplier. Big Decimal
The unit price is based on the price unit quantity of the item.
CONVERSIONFACTOR The ratio used to convert the ordered unit to the price unit. The unit price is based Big Decimal
on the price unit quantity and the price unit.
PRICEBASISQUANTITY Any information for the advanced pricing details. String (2000)
DESC
PRICEBASISQUANTI The unit of measure for the unit price. String (50)
TYUOM
PAYMENTID,TAX_CODE,POLINERECEIVINGTYPE,ITEM_AMOUNT,QUANTITY,PO_UNIT,INVOICE_DOC_ITEM
,PO_NUMBER,
PO_ITEM,ITEM_TEXT,CATEGORY,ORDER,PRICEBASISQUANTITY,PRICEBASISQUANTITYUOM,CONVERSION
FACTOR,
PRICEBASISQUANTITYDESC
PAYsap01-20,I1,2,25.79,3,EA,1,4700000860,10,Sales tax (auto-generated),
1,EPCK24,"2.0000","GAL","1","Gallon price"
Note
Adding a custom flex field to an IR results in pre-pending the label InvoiceReconciliation_LineItems_ to the
custom field label when exported to PaymentLineItemDet.csv. For example, if you create a column named
cat.IRLI.inv2343, the resulting column heading is displayed as
InvoiceReconciliation_LineItems_cus_catIRLIinv2343.
ITEM_AMOUNT The amount for each line item. For credit memos and negative line item amounts, this Numeric
value is negative.
WBS_ELEM The unique code of the WBS element account assignment category for that line item. String (50)
ASSET_NO The unique value of the asset account assignment category for each line item. String (50)
COSTCENTER The unique value of the cost center account assignment category for each line item. String (50)
ORDERID The unique value of the internal order account assignment category for the line item. String (50)
GL_ACCOUNT The unique value of the general ledger accounting type for each line item. Numeric
LINE_TYPE The unique internal identifier of the line type of the line item. This field holds the tax String (50)
type for indirect and withholding tax lines. For charges, this field holds the values
FreightCharge, HandlingCharge, or Charge. For discount lines, this field
holds the value Discount. For other line items, this field holds the values
CatalogItem or NonCatalogItem.
PAYMENTID The unique ID of each payment that has a status displayed. String (50)
ITEM_AMOUNT,WBS_ELEM,ASSET_NO,COSTCENTER,POLINERECEIVINGTYPE,QUANTITY,PO_UNIT,SERIAL
_NO,
INVOICE_DOC_ITEM,ORDERID,GL_ACCOUNT,TAX_CODE,PAYMENTID,CATEGORY,ORDER,PO_NUMBER
12.50,3-1200/31,1005,2100,2,3,EA,
1,1,400046,404000,I0,PAYsap01-20,1,EPCK24,4700000860
PAYMENTID The unique reference ID of the payment. This value matches a payment defined in String (50)
PaymentHeaderExport.csv.
ITEM_AMOUNT The item amount. For credit memos and negative line item amounts, this value is Numeric
positive.
WBS_ELEM The unique internal identifier of the SAP work breakdown structure (WBS) element. String (50)
ASSET_NO The unique internal identifier of the SAP asset number. String (50)
COSTCENTER The unique internal identifier of the SAP cost center. String (50)
GL_ACCOUNT The unique internal identifier of the SAP general ledger account. String (50)
COMP_CODE The unique internal identifier of the SAP company code. String (50)
LINE_TYPE The unique internal identifier of the line type of the line item. This field holds the tax String (50)
type for indirect and withholding tax lines. For charges, this field holds the values
FreightCharge, HandlingCharge, or Charge. For discount lines, this field
holds the value Discount. For other line items, this field holds the values
CatalogItem or NonCatalogItem.
TAX_CODE The line item tax code. Ariba Procure-to-Pay initially sets the tax code based on in String (50)
voice information and the tax code it obtains from the tax code lookup table. How
ever, if a business user modifies the tax code during invoice reconciliation, the
modified tax code, not the initial tax code, appears in this column.
PLANT The unique internal identifier of the SAP plant, which is the ship-to address. String (50)
DB_CR_IND A value that specifies whether the item is a debit or a credit as follows: String (10)
● S - debit
● H - credit
LINE_TYPE_LOOKUP The line category. Line categories separate procurement line items from the vari Numeric
_CODE ous special handling categories, such as tax and freight. The line categories are as
follows:
● 1 - Line Item (for all line items, including non-catalog, catalog and PunchOut)
● 2 - Tax Charge (for all tax-related charges)
● 4 - Freight Charge (for all freight-related charges)
● 8 - Handling Charge (for all handling-related charges)
● 32 - Discount (for discounts related to invoicing)
HDR_LEVEL A value that specifies whether the item is a header-level or line-level item as follows: Boolean
PRICEBASISQUANTITY The quantity corresponding to the unit price of the item specified by the supplier. Big Decimal
The unit price is based on the price unit quantity of the item.
CONVERSIONFACTOR The ratio used to convert the ordered unit to the price unit. The unit price is based Big Decimal
on the price unit quantity and the price unit.
PRICEBASISQUANTI Any information for the advanced pricing details. String (2000)
TYDESC
PRICEBASISQUANTI The unit of measure for the unit price. String (50)
TYUOM
PAYMENTID,ITEM_AMOUNT,WBS_ELEM,ASSET_NO,COSTCENTER,INVOICE_DOC_ITEM,ORDERID,
GL_ACCOUNT,COMP_CODE,TAX_CODE,PLANT,ITEM_TEXT,DB_CR_IND,LINE_TYPE_LOOKUP_CODE,HDR_LE
VEL,PRICEBASISQUANTITY,PRICEBASISQUANTITYUOM,CONVERSIONFACTOR,PRICEBASISQUANTITYDESC
PAYPO10Invoice-LineLevel-10,8800,,,2100,1,,445000,3000,I1,3000,Adapter SUN Monitor
4-BNCF/13W3M,S,1,No,"2.0000","GAL","1","Gallon price"
PAYMENTID The payment’s unique ID. This value matches a payment defined in String (50)
PaymentHeaderExport.csv.
TAX_AMOUNT The invoice line item tax amount. For credit memos and negative line item amounts, Numeric
this value is positive.
TAX_CODE The line item tax code. Ariba Procure-to-Pay initially sets the tax code based on in String (50)
voice information and the tax code it obtains from the tax code lookup table. How
ever, if a business user modifies the tax code during invoice reconciliation, the modi
fied tax code, not the initial tax code, appears in this column.
REF_LINE_NUM The reference line number on the invoice. For header taxes, this is the item line. For Numeric
line-level taxes, this is the actual tax line.
PAYMENTID,TAX_AMOUNT,TAX_CODE,REF_LINE_NUM,ITEM_TEXT
PAYPO10Invoice-LineLevel-10,30,I1,2,Sales tax - line level
AdvancePaymentDetailExport.csv contains the details of the advance payments adjusted against the invoice
for which the payment request is generated.
PAYMENTID The unique identifier of the payment request created for String (50)
the invoice
INVOICERECONCILIATIONID The unique identifier of the invoice reconciliation docu String (50)
ment for the invoice
ORDERID The unique identifier of the purchase order associated String (50)
with the invoice and advance payment documents
ADVANCEPAYMENTID The unique identifier of the advance payment adjusted String (50)
against the invoice
ERPADVANCEPAYMENTID The unique identifier of the payment request created in String (50)
the ERP for the advance payment
CONSUMEDAMOUNT_AMOUNT The advance payment amount adjusted against the in Numeric
voice, in the user's currency
CONSUMEDAMOUNT_INBASECURR The advance payment amount adjusted against the in Numeric
ENCY voice, in the site base currency
ADVANCEPAYMENTID,INVOICERECONCILIATIONID,PAYMENTID,ORDERID,ERPADVANCEPAYMENTID,CONSU
MEDAMOUNT_AMOUNT,CONSUMEDAMOUNT_CURRENCY,CONSUMEDAMOUNT_INBASECURRENCY
"APMT10","INV-IR101","PAY101","PO101","ERPAPMT10",10.00,"USD",10.00
The Export Payment Requests data export task exports a ZIP file containing the following CSV files:
● PaymentHeaderExport.csv
● PaymentBankExport.csv
● PaymentDetailExport.csv
● PaymentSplitAccountingExport.csv
● AdvancePaymentDetailExport.csv
● PaymentHeaderExport.csv
● PaymentBankExport.csv
● PaymentDetailWithSplitAccountingExport.csv
PurchasingUnit The unique internal identifier of the purchasing unit. String (50)
PaymentTerms The unique internal identifier of the payment terms selected for the in String (50)
voice. Payment terms specify the time period in which a supplier requests
payment and any discounts that the supplier chooses to make available
for early payment.
ForTaxAccrual A value that specifies whether the payment is an accrual payment. Boolean
SupplierLocation The unique internal identifier of the supplier location. String (50)
SupplierLocationContact The contact ID of the contact person at the supplier location specified in String (50)
ID the SupplierLocation column.
RemittanceLocation The unique internal identifier of the remittance location. When sending a String (50)
payment to a given supplier location, Ariba Procure-to-Pay sends to the
remittance location associated with that supplier location.
PaymentId,InvoiceReconciliationId,PurchasingUnit,InvoiceNumber,InvoiceDate,Supplier,
GrossAmount,
GrossAmountCurrency,PaymentTerms,ForTaxAccrual,SupplierLocation,SupplierLocationCont
actID,
RemittanceLocation
"PAYSUPPLIER_INVOICE_NUM-11","IRSUPPLIER_INVOICE_NUM-11","US005","SUPPLIER_INVOICE_N
UM","07/22/2006 00:00:00
-0700","prid515","29.9700","USD","PT1","No","10151,63,RL515"
PaymentId The payment’s unique reference ID. This value matches a payment defined String (50)
in PaymentHeaderExport.csv.
PurchasingUnit The unique internal identifier of the purchasing unit. Purchasing units keep String (50)
different sets of data separate.
PaymentMethod The unique internal identifier of the payment method. A payment method String (50)
defines how a buying organization makes a payment to a supplier.
BankAccountType The unique internal identifier of the bank account type, such as checking String (50)
or savings.
BuyerBankLocation The unique internal identifier of the Ariba Procure-to-Pay buyer bank pay String (50)
ment location.
AmountCurrency The transaction currency code for the payment. String (50)
PaymentId,InvoiceReconciliationId,PurchasingUnit,PaymentMethod,BankAccountType,Buyer
BankLocation,ScheduledPaymentDate,BankId,Amount,GrossAmount,DiscountAmount,AmountCur
rency
"PAYSUPPLIER_INVOICE_NUM-11","IRSUPPLIER_INVOICE_NUM-11","US005","check","checking",
"BuyerBankLocation-1","08/11/2006 11:18:47
-0700","TRBNK","29.9700","29.9700","0.3891","USD"
PaymentId The payment’s unique reference ID. This value matches a payment defined String (50)
in PaymentHeaderExport.csv.
PurchasingUnit The unique internal identifier of the purchasing unit. Purchasing units keep String (50)
different sets of data separate.
ParentLineNumber The voucher line number of the parent for a charge line on the invoice. Numeric
LineTypeCategory The line category. Line categories separate procurement line items from the String
various special handling categories, such as tax and freight. The line catego
ries are as follows:
● 1 - Line Item (for all line items, including non-catalog, catalog and
PunchOut)
● 2 - Tax Charge (for all tax-related charges)
● 4 - Freight Charge (for all freight-related charges)
● 8 - Handling Charge (for all handling-related charges)
● 32 - Discount (for discounts related to invoicing)
TaxCode The line item tax code. Ariba Procure-to-Pay initially sets the tax code based String (50)
on invoice information and the tax code it obtains from the tax code lookup
table. However, if a business user modifies the tax code during invoice rec
onciliation, the modified tax code, not the initial tax code, appears in this
column.
TaxType The line item tax type, for example, SalesTax. String (50)
IsAccrual A value that indicates whether the line item is a tax accrual line item. Boolean
IsAccrual is set to Yes if:
● an ‘Accrual Tax Variance’ exception is disputed: The reconciler agrees
to pay the supplier no tax and accrues the entire calculated tax amount
to be paid to the government authority.
● an ‘Under Tax Variance’ exception is disputed: The reconciler agrees to
pay the supplier the charged tax amount and accrue the remaining dif
ference (calculated – charged) to be paid to the government authority.
● Reconcilers check the Accrual check box for a tax detail line during rec
onciliation.
Amount For a line item, the value in this column is the amount charged for the com Numeric
modity. For a tax line item, the value in this column is the tax amount to pay
to the supplier.
UnitPrice For goods or services lines, UnitPrice represents the line item unit price. Numeric
For tax lines that are disputed (but reconcilers have not checked the Ac
crual flag), UnitPrice contains the expected tax amount (the total tax
amount for the reconciled line item, including both the tax amount paid to
the supplier and the accrual amount to be paid separately to the govern
ment authority).
For tax lines that have been manually flagged as accruals, UnitPrice is
set to 0 (zero).
For all other tax lines, UnitPrice contains the tax amount.
AmountCurrency The currency code for the line item amount. String (50)
ERPCommodityCode The ERP commodity code for the line item. This column is blank if your site Numeric
does not use ERP commodity codes.
TaxAdjustmentAmount The accrued tax amount to be paid separately to the government authority. Numeric
For tax line items with Under Tax Variance exceptions that are disputed,
TaxAdjustmentAmount is calculated as the difference between
UnitPrice (total expected tax amount) and Amount (tax amount to pay
to supplier).
ERPOrderLineNumber The unique identifier of each line in an ERP purchase order Numeric
PRICEBASISQUANTITY The quantity corresponding to the unit price of the item specified by the Big Decimal
supplier. The unit price is based on the price unit quantity of the item.
CONVERSIONFACTOR The ratio used to convert the ordered unit to the price unit. The unit price is Big Decimal
based on the price unit quantity and the price unit.
PRICEBASISQUANTITYDESC Any information for the advanced pricing details. String (2000)
PRICEBASISQUANTITYUOM The unit of measure for the unit price. String (50)
PaymentId,InvoiceReconciliationId,PurchasingUnit,LineNumber,ParentLineNumber,LineTyp
eCategory,
TaxCode,TaxType,IsAccrual,Description,Amount,UnitPrice,AmountCurrency,ERPCommodityCo
de,
TaxAdjustmentAmount,ERPOrderID,ERPOrderLineNumber,,PriceBasisQuantity,PriceBasisQuan
tityUOM,ConversionFactor,PriceBasisQuantityDesc,
"PAYSUPPLIER_INVOICE_NUM-11","IRSUPPLIER_INVOICE_NUM-11","US005","1","","1","TC16","
","No",
"Maps & Globes, Map Measurer, Simply run it along the route to be measured. One
pride shows miles and kilometers. The other pride shows statute miles, kilometers
and nautical miles. Attached magnifier, zippered
case.","12.9700","12.9700","USD","","3.52","2.0000","GAL","1","Gallon price"
"PAYSUPPLIER_INVOICE_NUM-11","IRSUPPLIER_INVOICE_NUM-11","US005","2","1","2","TC16",
"SalesTax",
"No","Sales tax - line level","2.0000","2.0000","USD","","2.64",,
PaymentId The payment’s unique reference ID. This value matches a payment defined String (50)
in PaymentHeaderExport.csv.
PurchasingUnit The unique internal identifier of the purchasing unit. String (50)
BusinessUnit The unique internal identifier of the business unit. String (50)
CostCenter The unique internal identifier for the cost center. String (50)
Account The unique internal identifier of the account, for example, Expense, String (50)
Region The unique internal identifier of the accounting region. String (50)
AccountingCombination The unique internal identifier of an accounting combination defined in Ariba String (50)
ID Procure-to-Pay.
PaymentId,InvoiceReconciliationId,PurchasingUnit,LineNumber,SplitLineNumber,Company,
BusinessUnit,CostCenter,Account,SubAccount,Product,Project,Quantity,Amount,Region,Ac
countingCombinationID
"PAY545-21","IR545-21","US005","1","1","GD","US005","3300","7720","1210",,,"5.0000",
"359.9500",,
"PAY545-21","IR545-21","US005","2","1","GD","US005","3300","7720","1210",,,"1.0000",
"0.0000"
"PAY24324-29","IR24324-29","US100","1","1","GD","US100","3100","7720","5008",,,"10.0
000","25.7000",,
AdvancePaymentDetailExport.csv contains the details of the advance payments adjusted against the invoice
for which the payment request is generated.
PaymentID The unique identifier of the payment request created for String (50)
the invoice
InvoiceReconciliationID The unique identifier of the invoice reconciliation docu String (50)
ment for the invoice
OrderID The unique identifier of the purchase order associated String (50)
with the invoice and advance payment documents
AdvancePaymentID The unique identifier of the advance payment adjusted String (50)
against the invoice
ERPAdvancePaymentID The unique identifier of the payment request created in String (50)
the ERP for the advance payment
ConsumedAmount_Amount The advance payment amount adjusted against the in Numeric
voice, in the user's currency
ConsumedAmount_InBaseCurr The advance payment amount adjusted against the in Numeric
ency voice, in the site base currency
AdvancePaymentID,InvoiceReconciliationID,PaymentID,OrderID,ERPAdvancePaymentID,Consu
medAmount_Amount,ConsumedAmount_Currency,ConsumedAmount_InBaseCurrency
"APMT10","INV-IR101","PAY101","PO101","ERPAPMT10",10.00,"USD",10.00
PaymentId The payment’s unique reference ID. This value matches a payment defined String (50)
in PaymentHeaderExport.csv.
PurchasingUnit The unique internal identifier of the purchasing unit. Purchasing units keep String (50)
different sets of data separate.
ParentLineNumber The voucher line number of the parent of the charge line on the invoice. Numeric
LineTypeCategory The line category. Line categories separate procurement line items from the String
various special handling categories, such as tax and freight. The line catego
ries are as follows:
● 1 - Line Item (for all line items, including non-catalog, catalog and
PunchOut)
● 2 - Tax Charge (for all tax-related charges)
● 4 - Freight Charge (for all freight-related charges)
● 8 - Handling Charge (for all handling-related charges)
● 32 - Discount (for discounts related to invoicing)
TaxCode The line item tax code. Ariba Procure-to-Pay initially sets the tax code based String (50)
on invoice information and the tax code it obtains from the tax code lookup
table. However, if a business user modifies the tax code during invoice rec
onciliation, the modified tax code, not the initial tax code, appears in this col
umn.
For more information on the tax code lookup table, see the Ariba Procure
ment Data Import and Administration Guide. For more information on in
voice reconciliation, see the Ariba Invoice Professional Invoicing User Guide.
TaxType The line item tax type, for example, SalesTax. String (50)
IsAccrual A value (always False) that indicates whether the line item is a tax accrual Boolean
line item.
AmountCurrency The currency code for the line item amount. String (50)
BusinessUnit The unique internal identifier of the business unit. String (50)
CostCenter The unique internal identifier for the cost center. String (50)
Account The unique internal identifier of the account, for example, Expense, String (50)
SubAccount The unique internal identifier of the subaccount. Subaccounts are account String (50)
ing entities that are subordinate to the accounts.
Region The unique internal identifier of the accounting region. String (50)
AccountingCombination The unique internal identifier of an accounting combination defined in Ariba String (50)
ID Procure-to-Pay.
PRICEBASISQUANTITY The quantity corresponding to the unit price of the item specified by the sup Big Decimal
plier. The unit price is based on the price unit quantity of the item.
CONVERSIONFACTOR Ratio used to convert the ordered unit to the price unit. The unit price is Big Decimal
based on the price unit quantity and the price unit.
PRICEBASISQUANTITYUOM The unit of measure for the unit price. String (50)
PaymentId,InvoiceReconciliationId,PurchasingUnit,LineNumber,ParentLineNumber,LineTyp
eCategory,
TaxCode,TaxType,IsAccrual,Description,UnitPrice,AmountCurrency,SplitLineNumber,Compa
ny,
BusinessUnit,CostCenter,Account,SubAccount,Product,Project,Region,AccountingCombinat
ionID,
Quantity,Amount,,PriceBasisQuantity,PriceBasisQuantityUOM,ConversionFactor,PriceBasi
sQuantityDesc
"PAYtestgreaerinv-91","IRtestgreaerinv-91","US005","1",,"1","TC21",,"No","Enter a
description for this
item.","1.0000","USD","1","GD","US005","3300","7752","1210",,,,"261","150.0000","150
.0000","2.0000","GAL","1","Gallon price"
Amounts are rounded to the precision specified in the configuration parameter. If rounding of the amount fields in
the split accounting records or line level records during payment request export results in a discrepancy with
the line level total or header level total respectively, then the amount values of the last line level or split accounting
level are adjusted so that the total equals the line level or header level total based on the specified precision.
Example: Split amounts are 3.33333, 3.33333, 3.33334, and the line level amount is 10.00000. During export, with
precision set to 3, the split amounts are exported as: 3.333, 3.333 and 3.334. If precision is set to 2, then the split
amount values are: 3.33, 3.33 and 3.34.
The amount values in the exported CSV files are always exported with 4 decimal places regardless of the precision
setting. If the precision is set to 3, amount values are exported as 1.2340. If the precision is set to 2, amount values
are exported as 1.2300.
PeopleSoft:
● MERCHANDISE_AMT in PaymentDetailExport.csv
● GROSS_AMT in PaymentHeaderExport.csv
● AMOUNT in PaymentSplitAccountingExport.csv
● PAYMENT_AMT, PAYMENT_GROSS_AMT, PAYMENT_DISC_AMT in PaymentBankExport.csv
Generic:
● Amount in PaymentDetailExport.csv
● GrossAmount in PaymentHeaderExport.csv
● Amount in PaymentSplitAccountingExport.csv
● Amount, GrossAmount, DiscountAmount in PaymentBankExport.csv
SAP:
Precision adjustment is not required in SAP integrated sites. SAP provides its own rounding handling.
Note
Contact Ariba Customer Support if you need to change the amount precision to be able to import payment
request files into an ERP system that cannot handle the default amount precision.
Importing remittances applies to existing customers using the remittance import tasks in Ariba Procure-to-Pay or
Ariba Invoice Professional, or you are an existing or new customer and do not have all of your suppliers either
enabled or configured for quick enablement on Ariba Network.
The Ariba Network Payment Integration Toolkit only loads remittance information for invoices that are recognized
on Ariba Network. Therefore, it does not load remittance information for invoices that were created manually by a
buyer user in Ariba Procure-to-Pay for a supplier who is not enabled on Ariba Network, since those invoices are not
copied to the associated Ariba Network buyer account. Therefore, you must use the remittance import tasks in
Ariba Procure-to-Pay.
Additional References
When sending a payment to a given supplier location, the Ariba system uses the remittance location associated
with that supplier location.
Each supplier location must have its own remittance location. You cannot associate multiple supplier locations
with the same remittance location, but you can associate multiple remittance locations with the same supplier
location.
● Ariba Procure-to-Pay
● Ariba Invoice Professional
Additional References
Ariba recommends that all customers use the Ariba Network Payment Integration Toolkit to import remittance
information.
Existing customers can also use the data import tasks provided in Ariba Procure-to-Pay or Ariba Invoice
Professional, but be aware this option is deprecated and may be removed in a future release.
New customers or customers who have not yet implemented remittance import must import remittances to Ariba
Network using the Ariba Network Payment Integration Toolkit, which sends a copy of the remittance advice
(Payment Remittance document) to Ariba Procurement and Invoicing Solutions.
If remittance data is not successfully pulled from Ariba Network or an external system, Payment Administrators
receive an email notification message indicating that there is a problem.
Additional References
You can run the SAP function module ZARIBA_SSP_REMITTANCE_PULL to transfer remittance transaction
information from the SAP database into CSV files.
You can use the DB Connector to extract remittance transaction information from the following ERP system
databases:
● Oracle
● DB2
● SQL Server
Additional References
When importing remittance information from your Enterprise Resource Planning (ERP) system, note the following:
● Ariba Procure-to-Pay does not consider accrual payments in determining if an invoice is completely paid.
● Importing accrual remittances in Ariba Procure-to-Pay is not supported.
● Payment documents generated in SAP do not specify a payment method by default. However, Ariba Procure-
to-Pay cannot import remittance transaction data unless you specify a payment method value in the
Remittance.csv file. Before you import remittance transaction data from SAP, be sure to include the
payment method type used (for example, check).
Ariba Procure-to-Pay supports the export of payment requests to SAP in real time (triggered when the
transactions are ready to be sent to the ERP) using the Web Services channel and SAP Netweaver.
Additional References
The following table lists the data import task and the CSV files that define remittance information:
You manually enter data in the CSV files. You use the Ariba Data Transfer Tool to run the Import Remittance Data
event and import the Remittance.csv and RemittanceDetails.csv files in ZIP format.
Additional References
UTF8
LOOKUPID,COMP_CODE,PAYDOC,FISCALYEAR,VENDOR,CHECKNO,STAT,VERSION,POSTINGDATE,CREATIO
NDATE,
CURRENCY,PAYMENTMETHOD,NAME1,NAME2,NAME3,NAME4,STREET,CITY,STATE,COUNTRY,POSTALCODE,
POBOX,PSLT2,
PAYEEBANKNAME,PAYEEBANKACCNO,PAYEEBANKNO,PAYEESWIFT,PAYERBANKNAME,PAYERBANKACCNO,PAY
ERBANKNO,
NETAMOUNT
PMT_77_IRSAP-
Invoice-03-22,3000,78,2006,500004,79,0,001,20060822,20060822,USD,C,RL6,,,,
300 10th Avenue,San Francisco,CA,US,94111,,,Bank of America,
10004912,121000358,abaRoutingNumber,
Citibank,30050021,134329042,109.04
PMT_81_IRSAP-
Invoice-04-23,3000,82,2006,500004,83,0,000,20060822,20060822,USD,C,RL6,,,,
300 10th Avenue,San Francisco,CA,US,94111,,,Bank of America,
10004912,121000358,abaRoutingNumber,
Citibank,30050021,134329042,109.04
PMT_85_IRAK-SAP-
John-01-24,3000,86,2006,1000,87,0,001,20060822,20060822,USD,A,RL3,,,,
Kolping Str. 15,Berlin,CA,US,12001,,,Mellon Bank,
10003230,238100235,abaRoutingNumber,
Citibank,30050021,134329042,66.4
PMT_89_IRAK-
Credit-666-25,3000,90,2006,500004,91,0,001,20060822,20060822,USD,C,RL6,,,,
300 10th Avenue,San Francisco,CA,US,94111,,,Bank of America,
10004912,121000358,abaRoutingNumber,
Citibank,30050021,134329042,-20
UTF8
LookupID,SupplierLocation,SupplierLocationContactID,PurchasingUnit,TransactionType,C
HECK_ID,
PaymentNumber,PaymentDate,CanceledDate,NetAmount,NetAmountDefaultCurrency,PaymentMet
hodType,
ExternalProcessedState,CreatedDate,VENDOR_ID,SupplierRemitToAddressName,VENDOR_SITE_
CODE,
SupplierRemitToAddressStreet,SupplierRemitToAddressCity,SupplierRemitToAddressState,
SupplierRemitToAddressCountry,RemitToAddressPostalCode,BuyerBankID,BuyerBankAccountI
D,
BuyerBankAccountType,BuyerBankName,BUYER_BANK_BRANCH_NAME,BUYER_ROUTING_NUMBER,BUYER
_BANK_NUMBER,SupplierBankID,SupplierBankAccountID,SupplierBankName,SupplierBankAccou
ntType,
SUPPLIER_BANK_BRANCH_NAME,SUPPLIER_ROUTING_NUMBER,SUPPLIER_BANK_NUMBER,PAYMENT_UPDAT
E_DATE,
GrossAmount,AdjustmentAmount,DiscountAmount,GrossAmountDefaultCurrency,AdjustmentDef
aultCurrency,DiscountAmountDefaultCurrency,BuyerRemitFromAddressName,BuyerRemitFromA
ddressStreet,
UTF8
LookupID,NumberInCollection,PayableDate,PayableReferenceNumber,PayableType,
ExternalPayableReferenceNumber,SupplierPayableReferenceNumber,SecondaryPayableRefere
nceNumber,
SecondaryPayableType,ExternalSecondaryPayableReferenceNumber,GrossAmountDefaultCurre
ncy,
GrossAmount,DiscountAmountDefaultCurrency,DiscountAmount,AdjustmentAmountDefaultCurr
ency,
AdjustmentAmount,NetAmountDefaultCurrency,NetAmount
R6,1,9/12/2006,IR66666-12,1,MyRef1,INVNPO2-68,,2,,USD,42.75,USD,1.2825,USD,0,USD,
41.4675
UTF8
LOOKUPID,COMP_CODE,PAYDOC,FISCALYEAR,DOC_NO,ITEM_NO,DOCDATE,REFDOC,PONUMBER,DEBITCRE
DIT,
GROSSAMOUNT,CASHDISCOUNT,NETAMOUNT,ITEMTEXT,CURRENCY
3000:1500000023:2008,3000,1500000023,2008,5100000840,1,20080401,INV_123,,H,
100,0,100,
IRINV_123-10,USD
Members of the Payment Agent and Payment Manager groups can create advance payments for purchase
orders in Ariba Procure-to-Order and Ariba Procure-to-Pay.
Though the advance payments are created in Ariba Procurement Solution, the actual payment for these happens
in the external system using the External System payment model.
Advance payments can be exported to external systems using the file channel as well as the web services channel.
Before using the web services channel, ensure that your site is configured to use web services for data integration.
The table below lists the data import and export tasks that enable you to import and export advance payment data
to the external ERP system. The following table lists the tasks in the sequence in which they need to be run.
Import Document Types DocumentType.csv Imports ERP document types that are File channel
for Advance Payment used for advance payments. This task is
required and available only for sites inte
grated with SAP ERP systems.
Import GL Indicators for GLIndicator.csv Imports ERP GL indicators that are used File channel
Advance Payment for advance payments. This task is re
quired and available only for sites inte
grated with SAP ERP systems.
Import Translations for DocumentType.csv Imports translations for ERP document File channel
Advance Payment types that are used for advance pay
Document Types ments. This task is required and availa
ble only for sites integrated with SAP
ERP systems.
Import Translations for GLIndicator.csv Imports translations for ERP GL indica File channel
Advance Payment GL tors that are used for advance payments.
Indicators This task is required and available only
for sites integrated with SAP ERP sys
tems.
Export Advance AdvancePaymentExpo Exports approved advance payments for File channel
Payments
rt.csv integration with external systems
Web Services channel
AdvancePaymentLine
ItemExport.csv
Import Advance Payment AdvancePaymentIDIm Imports IDs returned by the ERP after File channel
ID
port.csv successful upload of advance payments
Web Services channel: In
from Ariba Procurement Solution
ternally invoked in re
sponse to the Export
Advance Payments task
Import Advance Payment AdvancePaymentErro Imports errors generated by the external File channel
Errors
rImport.csv system while uploading advance pay
Web Services channel: In
ment documents sent by the Ariba Pro
ternally invoked in re
curement Solution
sponse to the Export
Advance Payments task
Import Advance Payment AdvancePaymentRemi Imports remittance information for ad File channel
Remittance
ttance.csv vance payment documents exported to
Web Services channel:
AdvancePaymentRemi external systems Real-time import triggered
ttanceDetail.csv by payments made in the
external ERP system
Export Cancel Advance CancelAdvancePayme Exports advance payments with status File channel
Payments
ntExport.csv Canceling for integration with external
Web Services channel
systems
Import Advance Payment AdvancePaymentExpo Imports a list of reasons for cancellation File channel
Cancellation Reasons rt.csv of advance payments.
Import Cancel Advance CancelAdvancePayme Imports IDs of canceled advance pay File channel
Payment ID
ntIDImport.csv ments returned by the external system
Web Services channel: In
after successful upload of canceled ad
ternally invoked in re
vance payments from Ariba Procure
sponse to the Export
ment Solution
Cancel Advance
Payments task
Export ERP Document DocumentTypeExport Exports the ERP document types that File channel
Types for Advance
.csv are used for advance payments. This
Payment task is available only for sites integrated
with SAP ERP systems.
Import Cancel Advance CancelAdvancePayme Imports the errors generated by the ERP File channel
Payment Errors ntErrorImport.csv system while uploading advance pay
ment documents marked for cancella
tion in the Ariba Procurement Solution.
Export GL Indicators for GLIndicatorExport. Exports the ERP GL indicators that are File channel
Advance Payments
csv used for advance payments. This task is
available only for sites integrated with
SAP ERP systems.
Export Advance Payment AdvancePaymentCanc Exports IDs and descriptions associated File channel
Cancellation Reasons elReasonCodesExpor with the reasons for cancellation of ad
t_sap.csv (For SAP vance payments to the ERP system.
ERP)
AdvancePaymentCanc
elReasonCodesExpor
t_psoft.csv (For Peo
pleSoft ERP)
AdvancePaymentCanc
elReasonCodesExpor
t_generic.csv (For
Generic ERP)
This task is available using only the file channel. You can import document types for advance payments using the
Import Document Types for Advance Payment task on the Data Import/Export page in Ariba Administrator.
The Export Document Types for Advance Payment task enables you to export the ERP document types being
used in the site for advance payments. It uses the same fields as that used for the Import Document Types for
Advance Payment task.
The table below provides descriptions and sample values for fields in the DocumentType.csv file required to
import ERP document types for advance payments. This file is required only for sites integrated with SAP ERP
systems.
You can import translations for document types using the Import Translations for Advance Payment Document
Types task on the Data Import/Export page in Ariba Administrator.
This task is available using only the file channel. You can import GL indicators for advance payments using the
Import GL Indicators for Advance Payment task on the Data Import/Export page in Ariba Administrator.
The Export GL Indicators for Advance Payments task enables you to export the ERP GL indicators being used in
the site for advance payments. It uses the same fields as that used for the Import GL Indicators for Advance
Payment task.
You can import translations for general ledger names using the Import Translations for Advance Payment GL
Indicators task on the Data Import/Export page in Ariba Administrator.
After you export advance payments, you need to import the advance payment IDs generated by the external
system using the Import Advance Payment ID task. An advance payment document proceeds to the Paying
status only when an advance payment ID is received for it from the external system.
The following table provides descriptions and sample values for the fields in the AdvancePaymentExport.csv file
generated by exporting header-level advance payments for integration with Generic and PeopleSoft ERP systems:
Payment Due Date Yes Date. The due date for making 12/31/2015 12:00:00 AM
the advance payment.
The following table provides descriptions and sample values for fields in the
AdvancePaymentLineItemExport.csv file generated by exporting line-level advance payments for integration
with Generic and PeopleSoft ERP systems:
The following table provides descriptions and sample values for fields in the AdvancePaymentExport.csv file
generated by exporting header-level advance payments for integration with SAP ERP system:
Creation Date Yes Date. The date when the ad 20160518
vance payment document is
created.
Payment Due Date Yes Date. The due date for making 12/31/2015 12:00:00 AM
the advance payment.
The Export Advance Payments task on the Web Service Status tab uses web services to export advance
payment documents to external systems. On receiving the advance payment document, the external system
sends the advance payment ID back to Ariba Procurement Solution. The status of the advance payment document
in Ariba Procurement Solution changes to Paying when this ID is received. Payments are then made for these
advance payments in the external system.
If the export fails, the external system sends an error message to Ariba Procurement Solution. In this case, the
status of the advance payment document in Ariba Procurement Solution changes back to Composing and an
email notification is sent to the requester, with details of the error. For more information on this email notification,
see Notifications Reference Guide: Messages for Payments.
AdvancePaymentExportRequest Elements
AdvancePayment_AdvancePaymentExportWS_Item
NetDueDate Yes Date. The due date for making 12/31/2015 12:00:00 AM
the advance payment.
AdvancePaymentExportReply Elements
When advance payment documents are exported from Ariba Procurement Solution to external systems, the
external system sends either an acknowledgement on receiving the advance payment document or the details of
the errors that occured while receiving the advance payment document. The acknowledgement or error details are
sent in an AdvancePaymentExportReply in the AdvancePayment_AdvancePaymentIDImport_Item or
AdvancePaymentError_AdvancePaymentErrorImport_Item item.
AdvancePayment_AdvancePaymentIDImport_Item
AdvancePaymentError_AdvancePaymentErrorImport_Item
The Export Payment Requests with Advance Payments task exports payment request details including
details of advance payments and Funds Management accounting information (if enabled for SAP ERP) to the
external ERP system. Use this task only if your site is configured to export approved invoices for payment directly
from the Ariba Procurement Solution to the ERP system in CSV file format, and not from Ariba Network.
The Export Payment Requests with Advance Payments task for SAP ERP uses the following CSV files:
● PaymentHeaderExport.csv
● PaymentLineItemDet.csv
● EnhancedPaymentAccountDet.csv
● PaymentDetailExport.csv
● PaymentTaxExport.csv
● AdvancePaymentDetailExport.csv
The Export Payment Requests with Advance Payments task for PeopleSoft ERP uses the following CSV
files:
● PaymentHeaderExport.csv
● PaymentDetailExport.csv
● PaymentSplitAccountingExport.csv
● PaymentBankExport.csv
● AdvancePaymentDetailExport.csv
The Export Payment Requests with Advance Payments task for Generic ERP uses the following CSV files:
● PaymentHeaderExport.csv
● PaymentDetailExport.csv
● PaymentSplitAccountingExport.csv
● PaymentBankExport.csv
● AdvancePaymentDetailExport.csv
InvoiceDate Yes String. The date on which the 02/19/2008 16:13:29 +0530
invoice is created.
To import advance payment IDs using the file channel, run the Import Advance Payment ID task on the Data
Import/Export page in Ariba Administrator.
In case of the Web Services channel, advance payments IDs are imported in response to the exported advance
payments and you do not need to manually invoke any task.
The table below provides descriptions and sample values for fields in the AdvancePaymentIDImport.csv file
required to import advance payment IDs generated by the external systems. This file can be used for all types of
ERP systems.
To import advance payment errors using the file channel, run the Import Advance Payment Errors task on the
Data Import/Export page in Ariba Administrator.
In case of the Web Services channel, advance payments errors are imported in response to the exported advance
payments and you do not need to manually invoke any task.
To import advance payment remittance using the file channel, run the Import Advance Payment Remittance task
on the Data Import/Export page in Ariba Administrator.
In case of the Web Services channel, advance payments remittance information is imported as and when the
payments are made by the external system. You do not need to manually invoke any task to import this
information.
You can export cancel advance payments to the external system using the Export Cancel Advance Payments
task on the Data Import/Export page in Ariba Administrator.
After you export cancel advance payments, you need to import the IDs of the advance payments canceled in the
external system, using the Import Cancel Advance Payment ID task. The status of an advance payment
document changes from Canceling to Canceled only when a canceled advance payment ID is received for it from
the external system.
The table below provides descriptions and sample values for fields in the CancelAdvancePaymentExport.csv
file generated by exporting canceled advance payments for integration with external systems. This file is used for
all types of ERP systems.
The Export Cancel Advance Payments task on the Web Service Status tab uses web services to export the
canceled advance payment documents to external systems. On receiving these details, the external system
cancels the advance payments and sends the IDs of the canceled advance payments to Ariba Procurement
Solution. The status of the advance payment document in Ariba Procurement Solution changes from Canceling to
Canceled when these IDs are received. If an error occurs in the external system while canceling an advance
payment, the advance payment document in Ariba Procurement Solution stays in the Canceling state until it is
manually marked as canceled.
CancelAdvancePaymentExportWS_Item
CancelAdvancePaymentExportReply Elements
AdvancePayment_CancelAdvancePaymentIDImport_Item
When canceled advance payment documents are exported from Ariba Procurement Solution to external systems,
the external system sends back the IDs of the advance payment documents canceled in the external system. The
IDs are sent in AdvancePayment_CancelAdvancePaymentIDImport_Item in the
CancelAdvancePaymentExportReply item.
To import canceled advance payment IDs using the file channel, run the Import Cancel Advance Payment ID task
on the Data Import/Export page in Ariba Administrator.
In case of the Web Services channel, cancel advance payments IDs are imported in response to the exported
cancel advance payments and you do not need to manually invoke any task.
The table below provides descriptions and sample values for fields in the
CancelAdvancePaymentIDImport.csv file required to import IDs of advance payments canceled in the external
systems. This file can be used for sites integrated with all ERP systems.
This task imports the errors generated by the external ERP system while uploading advance payment documents
marked for cancellation in the Ariba Procurement Solution.
The Import Cancel Advance Payment Errors task uses the CancelAdvancePaymentErrorImport.csv file to
import the errors generated while uploading the cancelled advance payments.
The following table provides the descriptions and sample values for the fields in the
CancelAdvancePaymentErrorImport.csv file for integration with SAP ERP:
The following table provides the descriptions and sample values for the fields in the
CancelAdvancePaymentErrorImport.csv file for integration with the PeopleSoft ERP:
The following table provides the descriptions and sample values for the fields in the
CancelAdvancePaymentErrorImport.csv file for integration with the Generic ERP:
The Import Advance Payment Cancellation Reasons task enables you to import the IDs and descriptions
associated with the reasons for cancellation of advance payments. The reasons for cancellation imported by this
task are listed on the Cancel Advance Payment popup on the advance payment page to enable users choose a
reason for cancellation of an advance payment.
This task exports IDs and descriptions associated with the reasons for cancellation of advance payments to the
external ERP system.
The Export Advance Payment Cancellation Reasons task uses the following CSV files:
The following table provides the descriptions and sample values for the fields used in the CSV files for the Export
Advance Payment Cancellation Reasons task:
There are individual and batch data import tasks for invoicing and payment data. In Ariba Invoice Professional the
data import task order depends on your ERP system.
Data Import Tasks for Invoicing and Payment Data [page 155]
Import Batch Data Batch data import tasks import CSV files from a ZIP file.
For more information, see the Ariba Administration and
Data Maintenance Fundamentals Guide.
Import CSV Lookup Tables Used By Approval Rules Batch data import tasks import CSV files from a ZIP file.
For more information, see the Ariba Administration and
Data Maintenance Fundamentals Guide.
TaxCodeDetails.csv
Import Tax Code Lookup Field Map for Withholding Taxes WHTLookupFieldMapping.csv
The tables in this section show the order in which the Import Batch Data data import task imports data for
Ariba Invoice Professional. You can use this information as a guide when running individual data import tasks.
A table lists the Import Batch Data data import sequence for data in PeopleSoft.
Import Tax Code Lookup Field Map for Withholding Taxes WHTLookupFieldMapping.csv
A table lists the Import Batch Data data import sequence for data in SAP.
Import Tax Code Lookup Field Map for Withholding Taxes WHTLookupFieldMapping.csv
The following table shows the Import Batch Data data import sequence for data in Generic.
Import Tax Code Lookup Field Map for Withholding Taxes WHTLookupFieldMapping.csv
The invoicing and payment data CSV file reference table lists all CSV files, describes them, and indicates if they are
required. A CSV file is required if the data it contains is required for Ariba Procurement and Invoicing Solutions to
function properly. Unless otherwise noted, required files should not be empty.
BankAccountType.csv Defines all supported types of bank account types, such as See Notes
checking accounts and savings accounts.
BuyerPaymentBankLocation.csv Defines general bank payment information, such as bank See Notes
names and addresses, for buyer bank accounts. It also asso
ciates each bank payment location with a bank identifier type,
bank account type, and bank account number type.
ChargeType.csv Defines charge types that can be used to apply charges on in No
voices. It also defined the mapping between charge types
used in Ariba Procurement and Invoicing Solutions and
charge types used in Ariba Network.
DocumentType.csv This file is required only for sites integrated with SAP ERP Yes, only
systems. It defines the ERP document types that can be used for SAP var
for advance payments. iants
GLIndicator.csv This file is required only for sites integrated with SAP ERP Yes, only
systems. It defines the ERP general ledgers that can be used for SAP var
for advance payments. iants
InvoiceExceptionTypeValidation.cs Defines validation data for the invoice exception types de No
v fined in InvoiceExceptionType.csv. Invoice excep
tion type validation data defines exactly which fields to com
pare and what tolerances to allow for each type of invoice ex
ception.
PaymentTermStepDetails.csv Contains details about the specific discounts you define in Yes
PaymentTermSteps.csv. You can define several possi
ble discount schedules.
PaymentTermSteps.csv Contains installment levels for each payment term you define Yes
in PaymentTerms.csv.
SLRemittanceInformation.csv Defines Ariba Network payment information for supplier loca Yes
tions.
SupplierPaymentBankLocation.csv Defines general bank payment information, such as bank See Notes
names and addresses, for supplier bank accounts. It also as
sociates each bank payment location with a bank identifier
type, bank account type, and bank account number type.
TaxCodeHeader.csv and Defines tax codes that Ariba Procurement and Invoicing Solu Yes
TaxCodeDetails.csv tions use to calculate tax rates.
TaxCodeLookupFieldMapping.csv Defines the mapping between tax code lookup fields and line Yes
item fields.
TaxComponent.csv Defines tax components that can assigned to tax codes, to Yes
apply taxes on invoices.
TaxRateLookupByTaxCode.csv Defines the tax rate lookup by tax code table, Yes
TaxType.csv Defines tax types that can be used to apply taxes on invoices Yes
in Ariba Procurement and Invoicing Solutions.
TaxTypeMap.csv Maps the common tax names found on invoices to tax-re Yes
lated procurement line types.
WHTLookupFieldMapping.csv Defines the mapping between tax code lookup fields and line Yes
item fields for withholding taxes.
Note
The following table provides a brief history of the updates to this guide. Ariba updates the technical documentation
for its On Demand solutions if:
● software changes delivered in service packs or hot fixes require a documentation update to correctly reflect
the new or changed functionality
● the existing content is incorrect or user feedback indicated that important content is missing
Ariba reserves the right to update its technical documentation without prior notification. Most documentation
updates will be made available in the same week as the software service packs are released, but critical
documentation updates may be released at any time.
To provide feedback on this guide or any Help@Ariba resources, click the Submit Feedback link on any
Help@Ariba page.
1 December 2014 n/a Reset revision history to Ariba 13s Procurement Release.
2 December 2014 Invoice Excep Added a note about the exception overrides that cannot be created
tions/Maintaining for the PO Payment Terms mismatch exception.
Invoice Exception
Types in Ariba Ad
ministrator
Importing Remit Added information about the applicability of remittance import tasks
tances for some invoices with some suppliers.
4 March 2016 About Taxes on In Moved the common tax information to the Common Data Import and
voices Administration Guide. Retained and updated invoicing-specific tax
information.
About Invoice Ex Added information about new invoice exception types
ceptions and Rec
onciliations
About Importing Created chapter and added information about advance payment ad
and Exporting Ad ministration tasks.
vance Payment
Data
Data Import Tasks Updated based on the changes made to the data import order
Reference
Invoicing and Pay Updated with information about the CSV files introduced for the new
ment Data CSV data import tasks
Files Reference
5 September 2016 About Invoice Ex Clarified conflicting information about how values of 0 in Percentage
ceptions and Rec Tolerance are applied.
onciliations/Main
taining Invoice Ex
ception Types in
Ariba Administra
tor
6 November 2016 About Invoice Ex Added information about invoice exception overrides by purchasing
ceptions and Rec unit and currency, including a new data import task.
onciliations/Main
taining Invoice Ex
ception Types in
Ariba Administra
tor
Multiple topics Updated the sample files for the line-level advance payment data im
port tasks to include new fields.
Coding Samples
Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system
environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and
completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, unless damages were caused by SAP
intentionally or by SAP's gross negligence.
Accessibility
The information contained in the SAP documentation represents SAP's current view of accessibility criteria as of the date of publication; it is in no way intended to be a
binding guideline on how to ensure accessibility of software products. SAP in particular disclaims any liability in relation to this document. This disclaimer, however, does
not apply in cases of wilful misconduct or gross negligence of SAP. Furthermore, this document does not result in any direct or indirect contractual obligations of SAP.
Gender-Neutral Language
As far as possible, SAP documentation is gender neutral. Depending on the context, the reader is addressed directly with "you", or a gender-neutral noun (such as "sales
person" or "working days") is used. If when referring to members of both sexes, however, the third-person singular cannot be avoided or a gender-neutral noun does not
exist, SAP reserves the right to use the masculine form of the noun and pronoun. This is to ensure that the documentation remains comprehensible.
Internet Hyperlinks
The SAP documentation may contain hyperlinks to the Internet. These hyperlinks are intended to serve as a hint about where to find related information. SAP does not
warrant the availability and correctness of this related information or the ability of this information to serve a particular purpose. SAP shall not be liable for any damages
caused by the use of related information unless damages have been caused by SAP's gross negligence or willful misconduct. All links are categorized for transparency (see:
http://help.sap.com/disclaimer).