How You Set Up Receivables for OAGIS 10.1 XML Transaction Delivery

Set up Receivables for OAGIS 10.1 XML transaction delivery, as part of the implementation to enable sending transactions to customers in OAGIS 10.1 XML format.

Along with completing the setups in Receivables, you must also complete the related setups in Collaboration Messaging Framework. Once you complete the setups in both products, you can make use of XML transaction delivery.

To set up Receivables for OAGIS 10.1 XML transaction delivery, complete these tasks:

• Set up XML invoicing on customer account profiles.

• Set up an attachment category for XML transactions (optional).

Note: You must first use the Feature Opt-in page in Functional Setup Manager to enable Receivables Invoice Delivery in Open Applications Group Integration Specification (OAGIS) 10.1 XML Format before completing these setups. Enabling OAGIS 10.1 XML transaction delivery also enables the Universal Business Language (UBL) 2.1 XML transaction delivery.

Set Up XML Invoicing on Customer Account Profiles

Set up the Receivables customer account profiles of customers that you intend to define as trading partners for XML transaction delivery. The settings that you use apply to all sites belonging to the customer account.

To set up a customer account for XML transaction delivery:

1. Navigate to the Billing work area.

2. Select the Manage Customers task.

3. In the Manage Customers page, search for the customer that you want to enable for XML transaction delivery.

4. In the Edit Account page, click the Profile History tab.

5. In the Invoicing section, set the Preferred Delivery Method to XML.

6. Select the Enable for XML Invoicing check boxes for the applicable transactions for this customer: Invoice, Debit Memo, Chargeback, Credit Memo.

   Receivables selects all eligible transactions whenever you run the Generate and Transfer XML Transactions process for this customer account.

7. Save your work.

8. Repeat steps 3 to 7 for each applicable customer account.

You can optionally enhance XML invoice delivery in the customer profile to limit the delivery of transactions in XML format to all customer sites belonging to a customer account that don't have a preferred delivery method of Paper, Email, Portal Upload, or any custom delivery method. You define this enhancement by creating and enabling the AR_XML_INVOICE_ENHANCED lookup code under the AR_FEATURES lookup type.

To set up for this XML delivery enhancement:

1. Navigate to the Setup and Maintenance work area.
2. Search for the setup task Manage Receivables Lookups.
3. In the Manage Receivables Lookups page, search for the AR_FEATURES lookup type.
4. Enter a new row for the lookup code.
5. In the Lookup Code field, enter AR_XML_INVOICE_ENHANCED.
6. In the Reference Data Set field, select Common Set.
7. Select the Enabled option.
8. In the Meaning field, enter a description of this lookup code.
9. Save your work.

When you run the Generate and Transfer XML Transactions process, the process selects transactions for delivery in XML format belonging to customer sites of the customer account that don't have a site-level delivery method setting. The process ignores customer sites with a preferred delivery method setting of Paper, Email, Portal Upload, or any custom delivery method.

Note: If you create the AR_XML_INVOICE_ENHANCED lookup code but don't select the Enabled option, the Generate and Transfer XML Transactions process ignores the site-level delivery method settings and selects all transactions for delivery in XML format belonging to the customer account and its customer sites.

Set Up an Attachment Category for XML Transactions

You can optionally define an attachment category for including transaction header attachments in the XML transaction.

During a run of the Generate and Transfer XML Transactions process, attachments to the transaction associated with the XML attachment category you define are embedded in the OAGIS 10.1 XML.

To set up an attachment category for XML transactions:

1. Navigate to the Setup and Maintenance work area.

2. Select the Manage Attachment Categories task.

3. In the Manage Attachment Categories page, click the Plus (+) icon to create a new attachment category.

   Note: You can also use an existing attachment category.

4. Complete the fields for the XML transaction attachment category. For example:

   • Category Name: XML_INVOICE

   • User Name: XML invoice

   • Description: Attachments embedded in the XML invoice header

5. In the Attachment Entities section, click the Plus (+) icon.

6. In the Entity Name field, enter RA_CUSTOMER_TRX_ALL to associate attachments with the transaction header.

7. Save your work.

8. Select the Manage Receivables Profile Options task.

   Now associate the attachment category with the Bill Presentment profile option for printing attachments (AR_BPA_PRINT_ATTACH_CATEGORY).

9. In the Manage Receivables Profile Options page, search for the AR_BPA_PRINT_ATTACH_CATEGORY profile option.

10. In the Profile Values section, click the Plus (+) icon.

11. In the Profile Level field, enter Site.

12. In the Profile Value field, enter the name of the attachment category that you defined in step 4.

13. Save your work.

    This site profile value allows attachments belonging to the AR_BPA_PRINT_ATTACH_CATEGORY category on the transaction header to be embedded in the XML transaction.

14. In the Attachments window of Create Transaction pages, use the attachment category that you created and associated with the AR_BPA_PRINT_ATTACH_CATEGORY profile option to add an attachment intended for inclusion in an XML transaction.