Use the Customer Interface program to import and validate customer information from other systems. Country-specific global descriptive flexfield content is imported and validated during this process.
You use SQL*Loader, or other import program, to load customer information into the interface tables. When you import customer information, the Customer Interface program validates the global attribute columns in the interface tables and transfers those values into the customer tables.
Before the Customer Interface program can properly validate your data file, you must:
Assign the appropriate context code for your country to the appropriate global attribute category column.
Map your global attribute columns from the interface tables to the corresponding global descriptive flexfield segment columns in the customer tables.
This table shows how the global attribute columns in the interface tables map to the global descriptive flexfield segment columns in the corresponding customer tables:
Interface Table.Global Attribute Column | Customer Table.Global Attribute Column |
---|---|
RA_CUSTOMERS_INTERFACE_ALL. GLOBAL_ATTRIBUTE1-20 | HZ_CUST_ACCOUNTS. GLOBAL_ATTRIBUTE1-20 |
RA_CUSTOMERS_INTERFACE_ALL. GDF_ADDRESS_ATTRIBUTE1-20 | HZ_CUST_ACCT_SITES_ALL. GLOBAL_ATTRIBUTE1-20 |
RA_CUSTOMERS_INTERFACE_ALL. GDF_SITE_USE_ATTRIBUTE1-20 | HZ_CUST_SITE_USES_ALL. GLOBAL_ATTRIBUTE1-20 |
RA_CUSTOMER_PROFILES_INT_ALL. GDF_CUST_PROF_ATTRIBUTE1-20 | HZ_CUSTOMER_PROFILES. GLOBAL_ATTRIBUTE1-20 |
After you map your global attribute columns, run the Customer Interface program. The Customer Interface program will:
Validate a customer's public sector company reporting designation in the GLOBAL_ATTRIBUTE1 column in the RA_CUSTOMERS_INTERFACE_ALL table and populate that information into the GLOBAL_ATTRIBUTE1 column in the HZ_CUST_ACCOUNTS table (for Greece only).
Validate a customer site's receipt acknowledgment designation in the GDF_SITE_USE_ATTRIBUTE1 column in the RA_CUSTOMERS_INTERFACE_ALL table and populate that information into the GLOBAL_ATTRIBUTE1 column in the HZ_CUST_SITE_USES_ALL table (for Greece and Portugal only).
The following sections describe in detail how to import country-specific attributes into the customer tables in Receivables using the Customer Interface program.
Related Topics
Customer Interface, Oracle Receivables User Guide
To use the Customer Interface program to import and validate global descriptive flexfield content, you must first assign the appropriate global descriptive flexfield context code for your country to one of the global attribute category columns in the RA_CUSTOMERS_INTERFACE_ALL table.
For a given context code, the Customer Interface program confirms that the values of the global attribute columns in the interface table match the value sets that are defined for the global descriptive flexfield segments in the corresponding customer table. In other words, if the global attribute category has a context code, the required global attribute columns for that country must have the correct data.
For example, if your country is Greece and you want to import information for the JG_HZ_CUST_ACCOUNTS global descriptive flexfield from the interface tables to standard Receivables customer tables, then you must enter the JE.GR.ARXCUDCI.CUSTOMER context code in the GLOBAL_ATTRIBUTE_CATEGORY column and enter either Yes or No in the GLOBAL_ATTRIBUTE1 column.
This table shows you how to map this global descriptive flexfield context code for Greece to the GLOBAL_ATTRIBUTE_CATEGORY column in the RA_CUSTOMERS_INTERFACE_ALL table.
For this country | For this flexfield | Map this global descriptive flexfield context code |
---|---|---|
Greece | JG_HZ_CUST_ACCOUNTS | JE.GR.ARXCUDCI.CUSTOMER |
This table shows you how to map these global descriptive flexfield context codes for your country to the GDF_SITE_USE_ATTR_CAT column in the RA_CUSTOMERS_INTERFACE_ALL table.
For this country | For this flexfield | Map this global descriptive flexfield context code |
---|---|---|
Greece | JG_HZ_CUST_SITE_USES | JE.GR.ARXCUDCI.RA |
Portugal | JG_HZ_CUST_SITE_USES | JE.PT.ARXCUDCI.RA |
Map these global attribute columns in the interface tables to the corresponding global descriptive flexfield segments. For each context code that you assign to a global attribute category column, confirm that the values of the matching global attribute columns are compatible with the designated value sets.
This table shows the valid values with descriptions for the JE.GR.ARXCUDCI.CUSTOMER Greek context.
Context Code: JE.GR.ARXCUDCI.CUSTOMER
In this column... | Oracle Receivables stores... | For this location... |
---|---|---|
RA_CUSTOMERS_INTERFACE_ALL.GLOBAL_ATTRIBUTE1 | Public sector company reporting. Valid values are Yes or No. | HZ_CUST_ACCOUNTS.GLOBAL_ ATTRIBUTE1 |
This table shows the valid values with descriptions for the JE.GR.ARXCUDCI.RA Greek context.
Context Code: JE.GR.ARXCUDCI.RA
In this column... | Oracle Receivables stores... | For this location... |
---|---|---|
RA_CUSTOMERS_INTERFACE_ALL.GDF_SITE_USE_ATTRIBUTE1 | Receipt acknowledgment designation. Valid values are Yes or No. | HZ_CUST_SITE_USES_ALL.GLOBAL_ ATTRIBUTE1 |
This table shows the valid values with descriptions for the JE.PT.ARXCUDCI.RA Portuguese context.
Context Code: JE.PT.ARXCUDCI.RA
In this column... | Oracle Receivables stores... | For this location... |
---|---|---|
RA_CUSTOMERS_INTERFACE_ALL.GDF_SITE_USE_ATTRIBUTE1 | Receipt acknowledgment designation. Valid values are Yes or No. | HZ_CUST_SITE_USES_ALL.GLOBAL_ ATTRIBUTE1 |
Each time you run Customer Interface program, Receivables generates the Customer Interface Transfer report. If any validation fails, the Customer Interface program populates the INTERFACE_STATUS column in the interface tables with the concatenated error codes for the Customer Interface Transfer report. This report shows the rows with problems and related error descriptions.
Related Topics
Customer Interface Transfer Report, Oracle Receivables User Guide
The RA_INTERFACE_LINES_ALL interface table stores invoice information. You use SQL*Loader to load invoice information into the interface table for each invoice that you create.
When you initiate importing invoices, the AutoInvoice open interface validates global attribute columns in the RA_INTERFACE_LINES_ALL table according to country-specific requirements. AutoInvoice then transfers global attribute columns from the RA_INTERFACE_LINES_ALL table to the RA_CUSTOMER_TRX_ALL table and the RA_CUSTOMER_TRX_LINES_ALL table.
Before the AutoInvoice program can properly validate your data file and create invoice and invoice lines in Oracle Receivables, you must:
Assign the appropriate context code for your country to the appropriate global attribute category column
Map your global attribute columns from the interface table to the corresponding global descriptive flexfield segment columns in the transaction tables
This table shows how the global attribute columns in the interface table maps to the global descriptive flexfield segment columns in the corresponding transaction tables:
Interface Table.Global Attribute Column | Transaction Table.Global Attribute Column |
---|---|
RA_INTERFACE_LINES_ALL. HEADER_GDF_ATTRIBUTE1-30 | RA_CUSTOMER_TRX_ALL. GLOBAL_ATTRIBUTE1-30 |
RA_INTERFACE_LINES_ALL. LINE_GDF_ATTRIBUTE1-20 | RA_CUSTOMER_TRX_LINES_ALL. GLOBAL_ATTRIBUTE1-20 |
Related Topics
Importing Invoice Information Using AutoInvoice, Oracle Receivables User Guide
To use the AutoInvoice program to import and validate global descriptive flexfield content, you must first assign the appropriate global descriptive flexfield context code for your country to one of the global attribute category columns in the RA_INTERFACE_LINES_ALL table.
For a given context code, the AutoInvoice program confirms that the values of the global attribute columns in the interface table match the value sets that are defined for the global descriptive flexfield segments in the corresponding transaction tables. In other words, if the global attribute category has a context code, the required global attribute columns for that country must have the correct data.
This table shows you how to map these global descriptive flexfield context codes for your country to the HEADER_GDF_ATTR_CATEGORY column in the RA_INTERFACE_LINES_ALL table.
For this country | For this flexfield | Map this global descriptive flexfield context code |
---|---|---|
Poland | JG_RA_CUSTOMER_TRX | JE.PL.ARXTWMAI.TAX_DATE |
Spain | JG_RA_CUSTOMER_TRX | JE.ES.ARXTWMAI.MODELO347PR |
Spain | JG_RA_CUSTOMER_TRX | JE.ES.ARXTWMAI.MODELO349 |
Spain | JG_RA_CUSTOMER_TRX | JE.ES.ARXTWMAI.MODELO415_347PR |
Map these global attribute columns in the interface table to the corresponding global descriptive flexfield segments. For each context code that you assign to a global attribute category column, confirm that the values of the matching global attribute columns are compatible with the designated value sets.
This table shows the valid values with descriptions for the JE.PL.ARXTWMAI.TAX_DATE Polish context.
Context Code: JE.PL.ARXTWMAI.TAX_DATE
In this column | Oracle Receivables stores | For this location |
---|---|---|
RA_INTERFACE_LINES_ALL. HEADER_GDF_ATTRIBUTE3 | Bank account number. The value set for this segment is JGZZ_AR_BANK_ACT_NUM. | RA_CUSTOMER_TRX_ALL.GLOBAL_ATTRIBUTE3 |
This table shows the valid values with descriptions for the JE.ES.ARXTWMAI.MODELO347PR Spanish context.
Context Code: JE.ES.ARXTWMAI.MODELO347PR
In this column | Oracle Receivables stores | For this location |
---|---|---|
RA_INTERFACE_LINES_ALL. HEADER_GDF_ATTRIBUTE2 | Rental location. The value set for this segment is JEES_RENTED_LOCATION. | RA_CUSTOMER_TRX_ALL.GLOBAL_ATTRIBUTE2 |
This table shows the valid values with descriptions for the JE.ES.ARXTWMAI.MODELO349 Spanish context.
Context Code: JE.ES.ARXTWMAI.MODELO349
In this column | Oracle Receivables stores | For this location |
---|---|---|
RA_INTERFACE_LINES_ALL. HEADER_GDF_ATTRIBUTE3 | Correction year. The value set for this segment is JEES_YEARYYYY. | RA_CUSTOMER_TRX_ALL.GLOBAL_ATTRIBUTE3 |
RA_INTERFACE_LINES_ALL. HEADER_GDF_ATTRIBUTE4 | Correction period. The value set for this segment is JEES_PERIOD_349. | RA_CUSTOMER_TRX_ALL.GLOBAL_ATTRIBUTE4 |
This table shows the valid values with descriptions for the JE.ES.ARXTWMAI.MODELO415_347PR Spanish context.
Context Code: JE.ES.ARXTWMAI.MODELO415_347PR
In this column | Oracle Receivables stores | For this location |
---|---|---|
RA_INTERFACE_LINES_ALL. HEADER_GDF_ATTRIBUTE2 | Property location. The value set for this segment is JEES_RENTED_LOCATION. | RA_CUSTOMER_TRX_ALL.GLOBAL_ATTRIBUTE2 |
In Release 12, you cannot create new bills of exchange automatic receipts. You can continue to remit previously existing bills of exchange receipts using these Bills of Exchange receipt formats:
French Receivables Bank Remittance
Italian Remittance EFT
Use the Italian Remittance EFT Format to produce a file that contains an automatic remittance for bills of exchange Italy for the open bills of exchange. This remittance format is sent to the bank to initiate the transfer of funds.
This EFT format is made up of a header record, detail records that describe the receipts, and an end record.
This table is a summary of the detail records:
Record Type | Description |
---|---|
14 | Receipt Details |
20 | Supplier Name |
30 | Customer Name |
40 | Customer Address |
50 | Invoice Details |
51 | Supplier Details |
70 | Additional information for the bank |
You can generate the Italian Remittance EFT Format by running the Italian Remittance EFT concurrent program once the Remittance batch has been approved.
For the Czech Republic, Hungary, and Poland, use the Regional Invoice Format to print all Receivable documents for a given document type, document number range, and customer name. To assist in packaging and delivering your billings, you can order your printed transactions by document number, customer name, or postal code.
Based on your responsibility, you may print either original or duplicate invoice documents.
Use the Standard Request Submission windows to submit the Regional Invoice Format.
For the Czech Republic, Hungary, and Poland, set the JG: Duplicate profile option at the responsibility level. This profile option value populates the Duplicate parameter in the Regional Invoice Format. The parameter lets you print either original or duplicate Receivables documents based on the profile option setting for your responsibility.
Yes - Enables the responsibility to print only duplicate Receivables documents with the Regional Invoice Format
No - Enables the responsibility to print only original Receivables documents with the Regional Invoice Format
Before running the Regional Invoice Format, you must complete these tasks:
You can assign product fiscal classifications to inventory items or tax product categories to standard memo lines, to represent statistical codes as determined by the Hungarian or Polish government.
When you define transaction types for the Czech Republic, Hungary, or Poland, ensure that your naming standards comply with official document types as printed on the invoice.
Enter one of the following:
Customer - The report is sorted by customer name.
Postal Code - The report is sorted by postal code of customer address.
Transaction Number - The report is sorted by document number.
The default is Transaction Number.
Enter the batch number for the invoices you want to report on.
Enter one of the active transaction types defined in Oracle Receivables.
Enter the lowest invoice number that you want to print.
Enter the highest invoice number that you want to print.
Enter the earliest invoice date that you want to print.
Enter the latest invoice date that you want to print.
Enter a specific customer name or leave this parameter blank for all customers.
In this heading | Oracle Receivables prints |
---|---|
Bill To | The billing site customer name, address, tax registration number, and purchase order number |
Ship To | The shipping site address |
Remit To | Your company's name, remittance address, tax registration number, and company number |
VAT Date | The tax invoice date |
Invoice Date | The invoice date |
Invoice Num | The invoice number |
Invoice Type | The name of the transaction type |
In this column | Oracle Receivables prints |
---|---|
Num | The line number of the invoice. |
Description | The line item description. |
Item Code | The item statistical code associated with the line item. This column is not used in the Czech Republic. |
UOM | The unit of measure for a given line. |
Unit Price | The unit selling price of the line item. |
Qty | The quantity billed of the item. |
Amount | The net invoice line amount |
VAT% | The tax rate for any tax rate codes that do not have a zero rate. The report prints the tax name for any tax rate codes that have a zero rate. |
VAT | The VAT amount for the invoice line. |
Total | The total invoice line amount. |
VAT by Rate Amount | The total net invoice amount for each tax rate. |
VAT by Rate VAT% | The tax rate for any tax rate codes that do not have a zero rate. The report prints the tax name for any tax rate codes that have a zero rate. |
VAT by Rate VAT | The total tax amount for each tax rate. |
VAT by Rate Total Amount | The total invoice amount for each tax rate. |
Invoice Amount | The total invoiced amount. |
In Words | The total invoiced amount in words. |
Payment Terms | The payment terms for the invoice |
Due Date | The due date for the invoice. |
Invoice Amount | The total invoiced amount. |
Curr | The currency of the invoice. |
Remittance Bank | The remittance bank name. |
Branch | The remittance bank branch. |
Bank Num | The remittance bank number. |
Bank Account Num | The remittance bank account number. |
Issuer | A line for the issuer's signature. |
Receiver | A line for the receiver's signature. |
Comments | Optional additional invoice information. |
Related Topics
Running Reports and Programs, Oracle Applications User Guide
Use the Receipt Acknowledgment Letter report to confirm the receipt of any payment from a customer.
Note: This functionality is only used and active for Greece and Portugal.
Oracle Receivables produces a separate receipt acknowledgment for each receipt currency. You can produce:
A receipt acknowledgment on request
A copy of receipt acknowledgment
You can match a receipt in a different currency to the invoice that the receipt is applied to when you manually enter a receipt.
Use the Standard Request Submission windows to submit the Receipt Acknowledgment Letter report.
Before submitting the Receipt Acknowledgment Letter report, you must:
Define appropriate receipt classes, such as one manual and one automatic class for clearing receipts.
Define at least one Receipt Acknowledgment document category. You can have more than one category for receipt acknowledgments.
Define an appropriate document sequence and assign the sequence to the Receipt Acknowledgment document category.
Set up company address details, including tax office, location and number in location, and reporting entities.
Enable receipt acknowledgment at the customer site level.
Clear the receipts that you want to acknowledge. You must clear receipts before you can produce a receipt acknowledgment.
If you want to reprint receipt acknowledgments, use the global descriptive flexfield off the Receipts window to find the receipt acknowledgment numbers that you enter in the report parameters.
Related Topics
Running Reports and Programs, Oracle Applications User Guide
Defining Document Categories, Oracle Applications System Administrator's Guide
Defining a Document Sequence, Oracle Applications System Administrator's Guide
Assigning a Document Sequence, Oracle Applications System Administrator's Guide
Use the Regional Dunning letter as a statement that you can send to customers advising them about open balances.
Use the Standard Request Submission windows to submit the Regional Dunning letter.
To use the Regional Dunning letter, you must set up at least one dunning letter in the Dunning Letters window. Specify &F_AS_OF_DATE in the message text for the as of date and &F_TOTAL_BALANCE in the message text for the customer site total balance in the ledger currency.
Enter the effective date of the letter.
Choose the dunning letter that you would like to send.
Enter the customer that you would like to run the letter from.
Enter the customer that you would like to run the letter to.
Choose the currency for the letter.
Choose Yes to include receipts at risk in the letter. Choose No not to include at risk receipts.
This table shows the report headings.
In this heading... | Oracle Receivables prints... |
---|---|
Customer | The customer's name |
Tax ID | The customer's tax identification number |
Customer Site | The customer's bill to site |
<Note to Customer> | The user-defined note that you specified in the dunning letter that you choose |
This table shows the column headings.
In this column... | Oracle Receivables prints... |
---|---|
Invoice Number | The invoice number for this transaction. Only invoices with outstanding balances are printed. |
Invoice Date | The date of the invoice. |
Invoice Type | The type of the invoice. |
Original Amount | The original amount of the transaction in the entered currency. The currency code for the entered currency is shown in parentheses. |
Amount Due Remaining | The remaining amount due of the transaction in the entered currency. The currency code for the entered currency is shown in parentheses. |
Original Amount | The original amount of the transaction in the ledger currency. The currency code for the ledger currency is shown in parentheses. |
Amount Due Remaining | The remaining amount due of the transaction in the ledger currency. The currency code for the ledger currency is shown in parentheses. |
Due Date | The date that the transaction balance is due. |
Days Late | The number of days that payment of this invoice is overdue. A negative number indicates that the payment is not yet due. |
Related Topics
Running Reports and Programs, Oracle Applications User Guide
Use the Portuguese Receivables Taxpayer ID Exception report to produce a list of all customers without a taxpayer ID. You can run this report by the legal entity, ledger, or balancing segment value. The report only selects the suppliers for whom you inserted at least one transaction.
Use the Standard Request Submission windows to submit the Portuguese Receivables Taxpayer ID Exception report.
Add a Legal or Contencioso line in each Customer Business Purpose Address Site.
In this heading | Oracle Receivables prints |
---|---|
<Report Title> | Portuguese Receivables Taxpayer ID Exception Report |
Report Date | The date that the report is run |
Page | The current and total pages of the report |
In this column | Oracle Receivables prints |
---|---|
Customer Name | The customer's name |
Customer Number | The customer's number |
Related Topics
Running Reports and Programs, Oracle Applications User Guide
Portuguese legislation requires that all billing invoices, along with their original electronic signatures and quick responses (QR) be reported as part of the Standard Audit File for Tax (SAFT) standard. This billing information must be submitted regardless of where the billing invoices were issued.
Externally generated invoices that are created and signed outside of the Oracle E-Business Suite must be imported.
Note: The Oracle E-Business Suite does not regenerate the signature and QR code.
The Oracle E-Business Suite Financials for Portugal complies with this legislation by meeting the following requirements:
Imports Externally Signed Invoices (including the e-Signature and related elements)
Autoinvoice imports the signature and related elements for invoices billed and signed externally (for example, legacy systems).
The following elements must be imported:
Signature (encrypted in the legacy system)
QR Code
Certification number (store one per private key)
Private Key Version (sequential integer starting on 1 used to generate the Signature)
Hash Key (signature of the previous document in same sequence)
System Entry Date
External Transaction Date
External Transaction Number
External Transaction Amount
External Reference Link
Stores the e-Signature and Related Elements
The import process physically stores the imported elements in E-Business Suite (to enable generation of the SAFT report).
Imports and stores a link to the original transaction in the legacy system
The import process imports a link to the original transaction in the legacy system (for example, transaction number)
Enables Flow Validations for Imported and Signed Invoices
The imported invoices have certain validations similar to what is done for internally signed transactions in E-Business Suite.
Some important validations are:
Prevent imported, externally signed transactions from being in-completed and or updated.
For internally signed invoices, users cannot enter adjustments for externally signed transactions (they can utilize CM/Void instead).
The following components enable the import of externally signed transactions for Portugal.
JE_PT_INTERFACE_LINES_EXTS
New extension table to import the signature and related elements when creating externally signed transactions through Autoinvoice (refer to Appendix I for details).
JE_PT_TRX_API_EXT_T
New temporary extension table to import the signaute and related elements, when creating externally signed transactions through Create Invoice API and Create Credit Memo API.
JE_PT_RA_CUST_TRX_EXTS
New columns added to capture the imported signature and elements (refer to Appendix I for details).
Allow Incomplete Process (Changed procedure)
To prevent externally signed invoices from being in-completed
STEP 1 - Set Up the Sequential Numbering Profile Option
Mandatory for transactions created and signed in the Oracle E-Business Suite and transactions imported in which the Already Billed option is set to No
Setup required (even for imported signed transactions)
STEP 2 - Activate Document Sequence at the Transaction Completion Time
Mandatory for transactions created and signed in the Oracle E-Business Suite and transactions imported with the Already Billed option set to No
Setup required (even for imported signed transactions)
STEP 3 - Define Document Sequences
Mandatory for transactions created and signed in the Oracle E-Business Suite and transactions imported in which the Already Billed option is set to No
Mandatory for transactions imported into the Oracle E-Business Suite with the Already Billed checkbox set to Yes (for example, externally signed)
Additional Information: You must define different sequences to differentiate between internally signed transactions versus externally signed ones.
Important: Refer to the Oracle Receivables Implementation Guide for information about document sequence definition.
STEP 4 - Assign Document Sequence at Transaction Type level
Transaction types that that are eligible for signature generation must be assigned with a sequential, gapless numbering sequence. This is achieved by assigning a sequence to a Category via the Document Assignments window. Before assigning Sequences to Categories, you must define the Categories; they indicate the table name where the sequence is enabled.
Mandatory for transactions created and signed in the Oracle E-Business Suite and transactions imported in which the Already Billed option is set to No
Mandatory for transactions imported into the Oracle E-Business Suite with the Already Billed option set to Yes (for example, externally signed)
Additional Information: You must define different Categories and assign distinct Sequences to each one of them.
STEP 5 - Set Up Manual and Imported Transaction Sources
This is an existing setup for Internally Signed Transactions:
Define as many Transaction Sources type Manual and/or Imported as needed for the Signature generation process.
Enable the Active checkbox
Enable the Automatic Transaction Numbering checkbox
Enable the Copy Document Number to Transaction Number checkbox
For Externally Signed Transactions with the Already Billed checkbox set to Yes:
Enable the Active checkbox
Clear the Automatic Transaction Numbering checkbox
Clear the Copy Document Number to Transaction Number checkbox
Additional Information: The system must be configured so that all batch sources used for a given transaction type have the same setup for the Already Billed GDF.
Tip: For a detailed explanation see Portuguese Billing Software Certification.
Externally Signed Transactions (for example, Already Billed set to Yes) are imported as completed transactions and do not trigger the signature generation process. These transactions cannot be incompleted or updated. You cannot incomplete the transaction or make any changes to it, because it may invalidate the signature imported from the legacy system.
Additional Information: Completed and signed transactions cannot be incompleted and/or changed. Use the Credit Memo type VOID functionality to cancel a transaction, whenever necessary.
Incomplete Process
Completed and signed transactions (whether the signature was generated by the Oracle E-Business Suite or imported from external sources) cannot be incompleted. This is to prevent signature issues because neither the document sequence nor the data elements involved can change in the signature generation
For these cases, the following warning message appears: Transaction cannot be incomplete because an encrypted signature has been assigned to it. Use Credit Memo Void functionality to cancel this transaction and enter a new one, if necessary.
Autoinvoice
You must populate the newly introduced columns in the extension interface table JE_PT_INTERFACE_LINES_EXTS to import the externally certified transactions, including the signature, certificate number and related elements.
Refer to Appendices I and II for more details about the import process and respective data model changes.
Important: You must populate all records of a transaction with the same Signature information in the extension table. The system takes the Signature information from the lowest interface_line_id.
Additional Information: When importing invoice information from Legacy Systems through AutoInvoice, you must load the Signature and related elements into the extension table JE_PT_INTERFACE_LINES_EXTS and populate the link column JE_PT_INTERFACE_LINK_ID with the ROWID from RA_INTERFACE_LINES_ALL.
Additional Information: When entering inconsistent information, the system will take the signature related information from the lowest interface_line_id without any cross-checking validation. It is your responsibility to populate the interface table correctly.
Copy Transactions (when source is an externally signed transaction)
The signature and related elements will NOT be copied from the source transaction to target transaction.
Create Invoice API/Create Credit Memo API
This processes uses the JE_PT_TRX_API_EXT_T, which is a temporary table introduced to capture the Signature details at the header level when creating externally signed transactions via the Create Invoice API or Create Credit Memo API.
Refer to Appendices I and II for more details.
Additional Information: When importing invoice information from Legacy Systems through the Create Invoice API/Create Credit Memo API, you must load the Signature and related elements into the extension table JE _PT_TRX_API_EXT_T and populate the TRX_HEADER_ID column for the Invoice API and populate the PREVIOUS_CUSTOMER_TRX_ID column for the Credit Memo API.
The Portuguese QR code and ATCUD of receivables invoices solution provides a concurrent program to generate a QR code that meets the specific requirements in accordance with guidelines:
The Portugal: Invoice Print Selected Invoices concurrent program generates selected invoices with an electronic signature and QR code and ATCUD.
The solution meets the following requirements:
Generates QR code and ATCUD after creating the signature for transactions in Oracle Receivables for the following:
Manual creation of transaction
Imported transactions
Transactions created by AR_INVOICE_API_PUB.create_single_invoice
Ensures that the Portugal – Billing Software Certification is available in the target instance.
Provides a field in the template to show the QR Code and ATCUD.
Automatically updates the QR Code, ATCUD and Concatenated Value fields in the JE_PT_RA_CUST_TRX_EXTS.
This solution is contingent upon the following setups:
Portugal - Billing Software Certification, My Oracle Support Document 1274628.1.
Portugal - Import Externally Signed Transactions, Release 12, My Oracle Support Document 1597808.1.
Necessary patches for Portugal QR Code were applied in the instance:
New Fields QR_Code, ATCUD and QR_CONCAT_VALUE are available in JE_PT_RA_CUST_TRX_EXTS, JE_PT_TRX_API_EXT_T, and JE_PT_INTERFACE_LINES_EXTS tables.
New Package CLE_PT_QRCODE_PKG is available.
New Compound Trigger CLE_PT_CMPD_TRG_GenQRCode is available for JE_PT_RA_CUST_TRX_EXTS.
Updated data definition and RTF template for Portugal: Invoice Print Selected Invoices Report.
The diagram shows the QR Code and ATCUD Generation process, including the following areas:
AP transaction creation flow
Transaction workbench - invoice completion
Transaction workbench CopyTo flow.
AutoInvoice flow
Invoice API
GDF setup at transaction header
JE signature-related processing
Signature process
CLE code hook - compound trigger in Signature table
ATCUD validation
QR code validation
QR code generation
Java APIs for signature generation
QR Code and ATCUD Generation Process
After the signature process, the QR code and ATCUD generation is triggered and created as follows:
Gathers all related transaction information where the signature was created. Following are the structure and content of the QR Code Concatenation field/QR code.
Code | Description | MaxLength | Instructions | Example | Mandatory | Mapping with SAFT Tags |
A | Issuer Tax Identification Number/Tax Registration Number (NIF/TRN) | 9 | NIF/TRN without spaces and without country prefixes. | A:123456789 | + | TaxRegistrationNumber (Field 1.3.) |
Separator | 1 | * | + | |||
B | Customer NIF/TRN | 30 | Customer NIF/TRN without spaces and without country prefixes. If Customer is Consumidor Final (Generic Customer), 999999990 should be used. | B:999999990 | + | CustomerTaxID (Field 2.2.3.) |
Separator | 1 | * | + | |||
C | Customer Country | 12 | Customer Country as exported on field Country on SAF-T(PT) | C:PT | + | Country (field 2.2.6.7.) |
Separator | 1 | * | + | |||
D | Document Type | 2 | Document Type as exported on SAF-T(PT) | D:FT | + | InvoiceType (Field 4.1.4.8.) MovementType (Field 4.2.3.8.) WorkType (Field 4.3.4.8.) PaymentType (Field 4.4.4.6.) |
Separator | 1 | * | + | |||
E | Document Status | 1 | Document Status as exported on SAF-T(PT) | E:N | + | InvoiceStatus (Field 4.1.4.3.1.) MovementStatus (Field 4.2.3.3.1.) WorkStatus (Field 4.3.4.3.1.) PaymentStatus (Field 4.4.4.9.1.) |
Separator | 1 | * | + | |||
F | Document Date | 8 | Document's date. Use Format YYYYMMDD. | F:20191231 | + | InvoiceDate (Field 4.1.4.7.) MovementDate (Field 4.2.3.7.) WorkDate (Field 4.3.4.7) PaymentDate (Field 4.4.4.9.1.) |
Separator | 1 | * | + | |||
G | Document's Unique Identification | 60 | Document's Identification as exported on SAF-T(PT) | G:FT AB2019/0035 | + | InvoiceNo (Field 4.1.4.1.) DocumentNumber (Field 4.2.3.1.) DocumentNumber (Field 4.3.4.1.) PaymentRefNo (Field 4.4.4.1.) |
Separator | 1 | * | + | |||
H | ATCUD | 70 | Unique Document code as exported on SAF-T(PT). Concatenation of the document's sequence validation code provided by TA, character -, document's sequential number within the sequence. | H:CSDF7T5H- 0035 | + | ATCUD (Field 4.1.4.2.) ATCUD (Field 4.2.3.2.) ATCUD (Field 4.3.4.2.) ATCUD (Field 4.4.4.2.) |
Separator | 1 | * | + | |||
I1 | Tax Country Region | 5 | TaxCountryRegion as per format on SAF- T(PT), however if document does not have/is not Subject to VAT on table 4.2 (MovementOfGoods), 4.3 (WorkingDocuments) or 4.4 (Payments) of SAF-T(PT), It should be filled with «0» (I1:0). | I1:PT | + | TaxCountryRegion (Field 4.1.4.19.15.2.) TaxCountryRegion (Field 4.2.3.21.12.2.) TaxCountryRegion (Field 4.3.4.14.15.2.) TaxCountryRegion (Field 4.4.4.14.6.2.) |
Separator | 1 | * | ++ | |||
I2 | Taxable Amount for Exempt VAT rate | 16 | Total value of the taxable base amount exempt from VAT (including taxable transactions under Stamp Duty, whether or not they are exempt from Stamp Duty). Format to two decimal places, with character . as decimal separator and without thousands separator. | I2:12000.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) CreditAmount/DebitAmount (Field 4.2.3.22.2.) CreditAmount/DebitAmount (Field 4.3.4.15.2.) CreditAmount/DebitAmount (Field 4.4.4.15.2.) For lines having TaxType VAT, TaxCode ISE, and TaxCountryRegion PT or For lines having TaxType SELO and TaxCountryRegion PT |
Separator | 1 | * | ++ | |||
I3 | Taxable Amount for Reduced VAT rate | 16 | Total taxable base amount for Reduced VAT rate (when TaxCode is RED). Format to two decimal places, with character . as decimal separator and without thousands separator. | I3:15000.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) CreditAmount/DebitAmount (Field 4.2.3.22.2.) CreditAmount/DebitAmount (Field 4.3.4.15.2.) CreditAmount/DebitAmount (Field 4.4.4.15.2.) For lines having TaxType VAT, TaxCode RED, and TaxCountryRegion PT |
Separator | 1 | * | ++ | |||
I4 | Total tax amount for Reduced VAT rate | 16 | Total tax amount for Reduced VAT rate (when TaxCode is RED) Format to two decimal places, with character . as decimal separator and without thousands separator. | I4:900.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) * Tax rate CreditAmount/DebitAmount (Field 4.2.3.22.2.) * Tax rate CreditAmount/DebitAmount (Field 4.3.4.15.2.) * Tax rate CreditAmount/DebitAmount (Field 4.4.4.15.2.) * Tax rate For lines having TaxType VAT, TaxCode RED, and TaxCountryRegion PT |
Separator | 1 | * | ++ | |||
I5 | Taxable Amount for Intermediate VAT rate | 16 | Total taxable base amount for Intermediate VAT rate (when TaxCode is INT). Format to two decimal places, with character . as decimal separator and without thousands separator. | I5:50000.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) CreditAmount/DebitAmount (Field 4.2.3.22.2.) CreditAmount/DebitAmount (Field 4.3.4.15.2.) CreditAmount/DebitAmount (Field 4.4.4.15.2.) For lines having TaxType VAT, TaxCode INT, and TaxCountryRegion PT |
Separator | 1 | * | ++ | |||
I6 | Total tax amount for intermediate VAT | 16 | Total tax amount for Intermediate VAT rate (when TaxCode is INT) Format to two decimal places, with character . as decimal separator and without thousands separator. | I6:6500.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) * Tax rate CreditAmount/DebitAmount (Field 4.2.3.22.2.) * Tax rate CreditAmount/DebitAmount (Field 4.3.4.15.2.) * Tax rate CreditAmount/DebitAmount (Field 4.4.4.15.2.) * Tax rate For lines having TaxType VAT, TaxCode NOR, and TaxCountryRegion PT |
Separator | 1 | * | ++ | |||
I7 | Taxable Amount for Normal VAT rate | 16 | Total taxable base amount for Intermediate VAT rate (when TaxCode is NOR). Format to two decimal places, with character . as decimal separator and without thousands separator. | I7:80000.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) CreditAmount/DebitAmount (Field 4.2.3.22.2.) CreditAmount/DebitAmount (Field 4.3.4.15.2.) CreditAmount/DebitAmount (Field 4.4.4.15.2.) For lines having TaxType VAT, TaxCode NOR, and TaxCountryRegion PT |
Separator | 1 | * | ++ | |||
I8 | Total tax amount for normal VAT | 16 | Total tax amount for Intermediate VAT rate (when TaxCode is NOR) Format to two decimal places, with character . as decimal separator and without thousands separator. | I8:18400.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) * Tax rate CreditAmount/DebitAmount (Field 4.2.3.22.2.) * Tax rate CreditAmount/DebitAmount (Field 4.3.4.15.2.) * Tax rate CreditAmount/DebitAmount (Field 4.4.4.15.2.) * Tax rate For lines having TaxType VAT, TaxCode NOR, and TaxCountryRegion PT |
Separator | 1 | * | ++ | |||
J1 | Tax Country Region | 5 | TaxCountryRegion as per format on SAF- T(PT). | J1:PT-AC | ++ | TaxCountryRegion (Field 4.1.4.19.15.2.) TaxCountryRegion (Field 4.2.3.21.12.2.) TaxCountryRegion (Field 4.3.4.14.15.2.) TaxCountryRegion (Field 4.4.4.14.6.2.) |
Separator | 1 | * | ++ | |||
J2 | Taxable Amount for Exempt VAT rate | 16 | Total value of the taxable base amount exempt from VAT (including taxable transactions under Stamp Duty, whether or not they are exempt from Stamp Duty). Format to two decimal places, with character . as decimal separator and without thousands separator. | J2:10000.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) CreditAmount/DebitAmount (Field 4.2.3.22.2.) CreditAmount/DebitAmount (Field 4.3.4.15.2.) CreditAmount/DebitAmount (Field 4.4.4.15.2.) For lines having TaxType VAT, TaxCode ISE, and TaxCountryRegion PT-AC or For lines having TaxType SELO and TaxCountryRegion PT-AC |
Separator | 1 | * | ++ | |||
J3 | Taxable Amount for Reduced VAT rate | 16 | Total taxable base amount for Reduced VAT rate (when TaxCode is RED). Format to two decimal places, with character . as decimal separator and without thousands separator. | J3:25000.56 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) CreditAmount/DebitAmount (Field 4.2.3.22.2.) CreditAmount/DebitAmount (Field 4.3.4.15.2.) CreditAmount/DebitAmount (Field 4.4.4.15.2.) For lines having TaxType VAT, TaxCode RED, and TaxCountryRegion PT-AC |
Separator | 1 | * | ++ | |||
J4 | Total tax amount for Reduced VAT rate | 16 | Total tax amount for Reduced VAT rate (when TaxCode is RED) Format to two decimal places, with character . as decimal separator and without thousands separator. | J4:1000.02 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) * Tax rate CreditAmount/DebitAmount (Field 4.2.3.22.2.) * Tax rate CreditAmount/DebitAmount (Field 4.3.4.15.2.) * Tax rate CreditAmount/DebitAmount (Field 4.4.4.15.2.) * Tax rate For lines having TaxType VAT, TaxCode RED, and TaxCountryRegion PT-AC |
Separator | 1 | * | ++ | |||
J5 | Taxable Amount for Intermediate VAT rate | 16 | Total taxable base amount for Intermediate VAT rate (when TaxCode is INT). Format to two decimal places, with character . as decimal separator and without thousands separator. | J5:75000.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) CreditAmount/DebitAmount (Field 4.2.3.22.2.) CreditAmount/DebitAmount (Field 4.3.4.15.2.) CreditAmount/DebitAmount (Field 4.4.4.15.2.) For lines having TaxType VAT, TaxCode INT, and TaxCountryRegion PT-AC |
Separator | 1 | * | ++ | |||
J6 | Total tax amount for intermediate VAT | 16 | Total tax amount for Intermediate VAT rate (when TaxCode is INT) Format to two decimal places, with character . as decimal separator and without thousands separator. | J6:6750.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) * Tax rate CreditAmount/DebitAmount (Field 4.2.3.22.2.) * Tax rate CreditAmount/DebitAmount (Field 4.3.4.15.2.) * Tax rate CreditAmount/DebitAmount (Field 4.4.4.15.2.) * Tax rate For lines having TaxType VAT, TaxCode INT, and TaxCountryRegion PT-AC |
Separator | 1 | * | ++ | |||
J7 | Taxable Amount for Normal VAT rate | 16 | Total taxable base amount for Intermediate VAT rate (when TaxCode is NOR). Format to two decimal places, with character . as decimal separator and without thousands separator. | J7:100000.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) CreditAmount/DebitAmount (Field 4.2.3.22.2.) CreditAmount/DebitAmount (Field 4.3.4.15.2.) CreditAmount/DebitAmount (Field 4.4.4.15.2.) For lines having TaxType VAT, TaxCode NOR, and TaxCountryRegion PT-AC |
Separator | 1 | * | ++ | |||
J8 | Total tax amount for normal VAT | 16 | Total tax amount for Intermediate VAT rate (when TaxCode is NOR) Format to two decimal places, with character . as decimal separator and without thousands separator. | J8:18000.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) * Tax rate CreditAmount/DebitAmount (Field 4.2.3.22.2.) * Tax rate CreditAmount/DebitAmount (Field 4.3.4.15.2.) * Tax rate CreditAmount/DebitAmount (Field 4.4.4.15.2.) * Tax rate For lines having TaxType VAT, TaxCode NOR, and TaxCountryRegion PT-AC |
Separator | 1 | * | ++ | |||
K1 | Tax Country Region | 5 | TaxCountryRegion as per format on SAF- T(PT) | K1:PT-MA | ++ | TaxCountryRegion (Field 4.1.4.19.15.2.) TaxCountryRegion (Field 4.2.3.21.12.2.) TaxCountryRegion (Field 4.3.4.14.15.2.) TaxCountryRegion (Field 4.4.4.14.6.2.) |
Separator | 1 | * | ++ | |||
K2 | Taxable Amount for Exempt VAT rate | 16 | Total value of the taxable base amount exempt from VAT (including taxable transactions under Stamp Duty, whether or not they are exempt from Stamp Duty). Format to two decimal places, with character . as decimal separator and without thousands separator. | K2:5000.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) CreditAmount/DebitAmount (Field 4.2.3.22.2.) CreditAmount/DebitAmount (Field 4.3.4.15.2.) CreditAmount/DebitAmount (Field 4.4.4.15.2.) For lines having TaxType VAT, TaxCode ISE, and TaxCountryRegion PT-AC or For lines having TaxType SELO and TaxCountryRegion PT-MA |
Separator | 1 | * | ++ | |||
K3 | Taxable Amount for Reduced VAT rate | 16 | Total taxable base amount for Reduced VAT rate (when TaxCode is RED). Format to two decimal places, with character . as decimal separator and without thousands separator. | K3:12500.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) CreditAmount/DebitAmount (Field 4.2.3.22.2.) CreditAmount/DebitAmount (Field 4.3.4.15.2.) CreditAmount/DebitAmount (Field 4.4.4.15.2.) For lines having TaxType VAT, TaxCode RED, and TaxCountryRegion PT-MA |
Separator | 1 | * | ++ | |||
K4 | Total tax amount for Reduced VAT rate | 16 | Total tax amount for Reduced VAT rate (when TaxCode is RED) Format to two decimal places, with character . as decimal separator and without thousands separator. | K4:625.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) * Tax rate CreditAmount/DebitAmount (Field 4.2.3.22.2.) * Tax rate CreditAmount/DebitAmount (Field 4.3.4.15.2.) * Tax rate CreditAmount/DebitAmount (Field 4.4.4.15.2.) * Tax rate For lines having TaxType VAT, TaxCode RED, and TaxCountryRegion PT-MA |
Separator | 1 | * | ++ | |||
K5 | Taxable Amount for Intermediate VAT rate | 16 | Total taxable base amount for Intermediate VAT rate (when TaxCode is INT). Format to two decimal places, with character . as decimal separator and without thousands separator. | K5:25000.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) CreditAmount/DebitAmount (Field 4.2.3.22.2.) CreditAmount/DebitAmount (Field 4.3.4.15.2.) CreditAmount/DebitAmount (Field 4.4.4.15.2.) For lines having TaxType VAT, TaxCode INT, and TaxCountryRegion PT-MA |
Separator | 1 | * | ++ | |||
K6 | Total tax amount for intermediate VAT | 16 | Total tax amount for Intermediate VAT rate (when TaxCode is INT) Format to two decimal places, with character . as decimal separator and without thousands separator. | K6:3000.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) * Tax rate CreditAmount/DebitAmount (Field 4.2.3.22.2.) * Tax rate CreditAmount/DebitAmount (Field 4.3.4.15.2.) * Tax rate CreditAmount/DebitAmount (Field 4.4.4.15.2.) * Tax rate For lines having TaxType VAT, TaxCode INT, and TaxCountryRegion PT-MA |
Separator | 1 | * | ++ | |||
K7 | Taxable Amount for Normal VAT rate | 16 | Total taxable base amount for Intermediate VAT rate (when TaxCode is NOR). Format to two decimal places, with character . as decimal separator and without thousands separator. | K7:40000.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) CreditAmount/DebitAmount (Field 4.2.3.22.2.) CreditAmount/DebitAmount (Field 4.3.4.15.2.) CreditAmount/DebitAmount (Field 4.4.4.15.2.) For lines having TaxType VAT, TaxCode NOR, and TaxCountryRegion PT-MA |
Separator | 1 | * | ++ | |||
K8 | Total tax amount for normal VAT Rate | 16 | Total tax amount for Intermediate VAT rate (when TaxCode is NOR) Format to two decimal places, with character . as decimal separator and without thousands separator. | K8:8800.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) * Tax rate CreditAmount/DebitAmount (Field 4.2.3.22.2.) * Tax rate CreditAmount/DebitAmount (Field 4.3.4.15.2.) * Tax rate CreditAmount/DebitAmount (Field 4.4.4.15.2.) * Tax rate For lines having TaxType VAT, TaxCode NOR, and TaxCountryRegion PT-MA |
Separator | 1 | * | ++ | |||
L | Not subject to VAT / non-taxable amount | 16 | Total amount related to transactions not subject to VAT/ not taxable (when TaxCode is NS). Format to two decimal places, with character . as decimal separator and without thousands separator. | L:100.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) CreditAmount/DebitAmount (Field 4.2.3.22.2.) CreditAmount/DebitAmount (Field 4.3.4.15.2.) CreditAmount/DebitAmount (Field 4.4.4.15.2.) For lines having TaxType NS and TaxCode NS |
Separator | 1 | * | ++ | |||
M | Stamp Duty Amount | 16 | Total Tax Amount of Stamp duty on the document. Format to two decimal places, with character . as decimal separator and without thousands separator. |
M:25.00 | ++ | Sum of CreditAmount/DebitAmount (Field 4.1.4.20.2.) * Tax rate CreditAmount/DebitAmount (Field 4.2.3.22.2.) * Tax rate CreditAmount/DebitAmount (Field 4.3.4.15.2.) * Tax rate CreditAmount/DebitAmount (Field 4.4.4.15.2.) * Tax rate For lines having TaxType SELO |
Separator | 1 | * | + | |||
N | Total Tax | 16 | Total VAT and Stamp Duty amount - TaxPayable field of SAF-T (PT) Format to two decimal places, with character . as decimal separator and without thousands separator. | N:64000.02 | + | TaxPayable (Field 4.1.4.20.1.) TaxPayable (Field 4.2.3.22.1.) TaxPayable (Field 4.3.4.15.1.) TaxPayable (Field 4.4.4.15.1.) |
Separator | 1 | * | + | |||
O | Total Document Amount including Tax | 16 | Total document amount including Tax - GrossTotal field of SAF-T (PT) Format to two decimal places, with character . as decimal separator and without thousands separator. | O:513600.58 | + | GrossTotal (Field 4.1.4.20.3.) GrossTotal (Field 4.2.3.22.3.) GrossTotal (Field 4.3.4.15.3.) GrossTotal (Field 4.4.4.15.3.) |
Separator | 1 | * | ++ | |||
P | Withholding Tax Amount | 16 | Total document Withholding Tax Amount - WithholdingTaxAmount field of SAF-T (PT) Format to two decimal places, with character . as decimal separator and without thousands separator. | P:100.00 | ++ | Withholding Tax Amount (Field 4.1.4.21.3.) Withholding Tax Amount (Field 4.4.4.16.3.) |
Separator | 1 | * | + | |||
Q | 4 characters of Hash | 4 | According with Ordinance n. 363/2010, of 23rd June, 1st, 11th,21st and 31st character of document Signature | Q:kLp0 | + | Hash (Field 4.1.4.4.) Hash (Field 4.2.3.4.) Hash (Field 4.3.4.4.) |
Separator | 1 | * | + | |||
R | Software Certificate number | 4 | Certified Software number granted by AT | R:9999 | + | SoftwareCertificateNumber (Field 1.15.) |
Separator | 1 | * | ++ | |||
S | Other Optional Information | 65 | Free text that may include for example payment information (ex: from IBAN or Ref MB, with «;» as a separator). This field cannot contain the asterisk character (*). | S:TB;PT00000000000000000000000;513500.58 (or S:MB;Entity;reference;amount) | ++ | Hkdhkafhhflsfjasçjfsç (rcta.global_attribute9) |
ATCUD code is a unique document code as exported on SAF-T(PT).
ATCUD code structure is a concatenation of the document's sequence validation code provided by Tax Authority (8 positions) + character - + document sequential number within the sequence, for example, CSDF7T5H-0035.
Generates the ATCUD Code and QR Code Concatenated string. The setup for ATCUD sequence must be done in the Document Sequences window. From the menu, select Actions, and then select CLE: Additional Info on Doc Sequence.
For Code S, adds to the QR Code Optional Information field of the Additional Information for Portugal window.
Generates the QR code based on the concatenated strings.
Three fields are available in the signature table, which store the encrypted QR code and concatenated values as well as the ATCUD code.
Similarly, the existing process of signature, the QR Code and ATCUD can be generated by:
Manual Entry: QR code and ATCUD must be triggered at transaction completion time (for manually entered invoices). The routine must be invoked for all applicable receivables transactions whose transaction types have document sequencing assigned at that level and transaction sources do not indicate that billing has already been generated.
Note: This process does not include receipts and bills receivables.
Copied Transaction: QR code and ATCUD generation must be triggered at transaction completion time for copied transactions. The routine must be invoked for all applicable receivable transactions whose transaction types have document sequencing assigned at that level and transaction sources do not indicate that billing has already been generated.
Note: This process does not include receipts and bills receivables.
The Transaction Copy process must not copy the encrypted and concatenated values from source transaction to target. New concatenated values are generated for the new transaction normally, upon completion and validation of the newly copied transaction.
To achieve this requirement, if the complete flag is set to Yes for the transaction, then a new QR code, ATCUD and the concatenated values are generated and assigned to the copied transaction.
A signature is generated upon completion.
Imported Transaction by API or Interface: QR code and ATCUD generation must be triggered at transaction validation time for imported invoices and transactions created by invoice APIs. The routine must be invoked for all applicable receivables transactions whose transaction types have document sequencing assigned at that level and transaction sources do not indicate that billing has already been generated.
Note: This process does not include receipts and bills receivables.
For internally signed: Requires populating the Transaction Interface Table RA_INTERFACE_LINES_ALL or the Table Types in ar_invoice_api_pub before calling the API AR_INVOICE_API_PUB.create_single_invoice.
FIELDS TO POPULATE IN RA_INTERFACE_LINES_ALL | SAMPLE DATA |
INTERFACE_LINE_CONTEXT | LEGACY |
INTERFACE_LINE_ATTRIBUTE1 | AYIEX102 |
INTERFACE_LINE_ATTRIBUTE2 | AYIE-630 |
BATCH_SOURCE_NAME | Internal Source RAXTRX |
SET_OF_BOOKS_ID | 520 |
LINE_TYPE | LINE |
DESCRIPTION | Sample Imported |
CURRENCY_CODE | EUR |
AMOUNT | 1100 |
CUST_TRX_TYPE_NAME | Invoice Internal RAX |
CUST_TRX_TYPE_ID | 32731 |
TERM_NAME | N30 |
TERM_ID | 1062 |
ORIG_SYSTEM_BILL_CUSTOMER_ID | 140790 |
ORIG_SYSTEM_BILL_ADDRESS_ID | 11949 |
CONVERSION_TYPE | User |
CONVERSION_DATE | 44161 |
CONVERSION_RATE | 1 |
TRX_DATE | <sysdate> |
GL_DATE | <sysdate> |
DOCUMENT_NUMBER | |
TRX_NUMBER | |
LINE_NUMBER | |
QUANTITY | 1 |
TAX_CODE | PT RD OTH PUR |
DOCUMENT_NUMBER_SEQUENCE_ID | 3596 |
CREATED_BY | |
CREATION_DATE | <sysdate> |
LAST_UPDATED_BY | 1318 |
LAST_UPDATE_DATE | <sysdate> |
LAST_UPDATE_LOGIN | 6621445 |
ORG_ID | 3944 |
HEADER_GDF_ATTRIBUTE10 | Some Open Text 0 A 00 0 A A A 0 0.00 |
LINE_GDF_ATTRIBUTE1 | 212 |
LINE_GDF_ATTRIBUTE2 | 00000000 |
LINE_GDF_ATTRIBUTE3 | COMERCIAL/INDUSTRIALIZ |
LINE_GDF_ATTRIBUTE4 | 0 |
LINE_GDF_ATTRIBUTE5 | A |
LINE_GDF_ATTRIBUTE6 | 00 |
LINE_GDF_ATTRIBUTE7 | 0 |
LINE_GDF_ATTRIBUTE8 | A |
LINE_GDF_ATTRIBUTE9 | A |
LINE_GDF_ATTRIBUTE10 | A |
LINE_GDF_ATTRIBUTE11 | 0 |
LINE_GDF_ATTRIBUTE12 | 0.00 |
For externally signed: Requires populating the following:
Transaction interface table RA_INTERFACE_LINES_ALL or the table types in ar_invoice_api_pub before calling the API AR_INVOICE_API_PUB.create_single_invoice.
JE_PT_INTERFACE_LINES_EXTS if the data was populated in RA_INTERFACE_LINES_ALL.
JE_PT_TRX_API_EXT_T if the process runs the API AR_INVOICE_API_PUB.create_single_invoice.
Use the global descriptive flexfield in the Transaction workbench to capture QR code information.
Select the Invoice-QR type from the Type list of values.
Select a Portuguese legal entity from the Legal Entity field.
Enter information in the QR Code Optional Information field in the Additional Information for Portugal window.
Define the transaction line tax classification code. In the transaction line, select a value in the Tax Classification Code list.
Complete the transaction. After you complete the details and select Complete, the system generates the signature in the JE_PT_RA_CUST_TRX_EXTS table, and populates the ATCUD, the QR code and its equivalent concatenated codes in the same table.
Run the Portugal: Invoice Print Selected Invoices concurrent program to generate the invoices report document for the legal entity running the program. This program shows the transaction data and generates the ATCUD and QR code.
Navigate to the Submit Request window, and the Parameter window appears.
Define the following parameters:
Order By (Default - Transaction Number)
Transaction Class
Transaction Type
Transaction Number Low
Transaction Number High
Print Date Low
Print Date High
Customer Class
Customer
Installment Number
Open Invoices Only (Default - No)
Tax Registration Number
Bill of Lading (Default - No)
The Italian Law 244/2007 states that all invoices issued against all Italian public sector entities must be electronic and the electronic invoices must guarantee the issued date, the authenticity of the origin and integrity of the content by means of digital signature and time reference.
Technical Standards published by the Italian authority:
All invoices issued against the Italian public sector entities must be in the XML format as defined by the Italian authorities;
The electronic invoices must be transmitted to the Exchange System which collects and distributes the electronic invoices to the appropriate entity;
Each public sector entity is identified by a receiver code.
Before reading this section, refer to the Italian B2G Electronic Invoicing Appendix.
The Italian B2G Electronic Invoicing process includes the following components:
Setup Steps
Additional setup information at Legal Entity level
Additional setup information at Bill-to site level
New Global Descriptive Flexfields
Receivables Transactions Workbench (Header level)
Customer Account Site Uses window (Bill-to)
New Concurrent Programs
Italian B2G Electronic Invoices Generation
Italian B2G Electronic Invoices XML File Output
The Italian B2G Electronic Invoicing process includes the following steps:
Define or update Legal Entity by setting up the newly introduced attributes (one-time setup);
This information is reported in the First Party Identification a. section;
Example: Fiscal Regime, REA Number, Share Capital, Single Member, etc..
Define or update Bill-To sites by assigning the newly introduced B2G Bill-to Received Code;
You must define the Bill To Sites that represent the third party office location codes and assign proper B2G Received Codes to each one of them.
Define or implement the Descriptive Flexfield (DFF) segments at the invoice header and/or line levels in order to handle the additional pieces of information required, if applicable (Example: Withholding, Stamp Duty, etc.)
Perform the eventual changes to the default XML template in order to include or exclude the additional pieces of information required, if applicable (Example: Withholding, Stamp Duty, etc).
Enter and complete the B2G Receivables transactions (Example: invoices, credit memos, debit memos, etc.);
Run the Italian B2G Electronic Invoices Generation for a given Customer Bill-to site, Transaction Number or Date Range.
Verify the accuracy of the XML output file.
Repeat Step 6 as necessary by making sure the B2G Electronic Invoice Generation Option is entered properly (Example: Original generation or regeneration).
Name the XML output file as per the naming convention defined by the Italian Exchange System.
Execute the next steps required: Apply a qualified electronic signature, transmit the signed XML, and electronically store the signed XML file.
The following setup steps must be performed before entering new Receivables B2G transactions:
STEP 1 - Define/Update Legal Entity Reporting Attributes (Mandatory)
Five new attributes have been introduced as part of the Legal Entity Identification Information region. Those attributes are required to generate the B2G electronic Invoice and are reported under the first party identification section of the XML layout.
Fiscal Regime
REA Number
Share Capital
Single Member
Liquidation Status
STEP 2 - Assign Received Code to B2G Bill-to Sites (Mandatory)
The attribute B2G Bill-to Received Code was introduced in the Account Site - Business Purpose tab. This attribute is required to generate the B2G electronic Invoice and is reported under the Transmission Identification section of the XML layout.
New Global Descriptive Flexfields were added at the header level for the Receivables B2G transactions to capture some important reporting information and the electronic invoice status. The attributes are available and handled by the following transaction entry flows:
Receivables
Transactions Workbench
Autoinvoice
Create Invoice API
Create CM API
Copy Transaction
The newly added Global Descriptive Flexfields are:
B2G Electronic Invoice Document Type
This is a mandatory reporting attribute to identify the transaction.
The value is automatically defaulted by the system according to the Receivables Transaction Class of the transaction. For example:
TD01 - Invoice
TD04 - Credit Memo
TD05 - Debit Memo
Additional Information: You can define new values by accessing the JEIT_B2G_DOC_TYPES lookup type.
B2G Electronic Invoice Status
Captures the actual status of the electronic invoice;
For both Original generation and Regeneration of the electronic invoice, the system will update this field with status Generated. All other statutes can be manually maintained by the user, based on the XML files received from the government.
B2G Transmission Progressive Number
Unique sequential number taken from Database Sequence for every file generated for a given Legal Entity.
Each legal entity will have a separate DB sequence created.
The Transmission Progressive Number is assigned per file, irrespective of the number of invoices within each file or if the file gets transmitted or not;
When the file is not transmitted, gaps will occur, but are acceptable as long as the numbers remain sequential within the sequence.
Manually Entered Transactions
New Global Descriptive Flexfields were added at the transaction header level. They can be viewed and optionally updated.
Imported Transactions
The newly added header level invoice attributes can also be imported by populating the corresponding Global Attribute columns in the following interface table:
Table: RA_INTERFACE_LINES_ALL
GDF Context: JE.IT.ARXTWMAI.INVOICE_INFO
New Attribues | Mapped Global Attribute | Values to be Populated |
---|---|---|
B2G Electronic Invoice Document Type | Header_GDF_Attribute7 | TD01, TD04, TD05 (Example: most common Receivables transactions) |
B2G Electronic Invoice Status | Header_GDF_Attribute8 | NULL, GEN, TRAN, REJ, FAIL, REC, ACC, REF, UND, PASS (see lookup codes seeded in JEIT_B2G_INV_STATUS) |
B2G Transmission Progressive Number | Header_GDF_Attribute9 | (DO NOT POPULATE) This field is populated automatically by the Concurrent Program. |
Italian B2G Electronic Invoices Generation
You can run the Italian B2G Electronic Invoices Generation concurrent program at any time to generate one of more electronic invoices (in XML format) belonging to the LE running the program, according to the selection criteria. The program is responsible for extracting the data according to the selection criteria provided in the Parameters window. If successful, the program will launch another concurrent program, Italian B2G Electronic Invoices XML File Output, that will actually generate the output file in XML format.
Parameters:
Legal Entity
First Party Legal Entity, owner of the B2G sales transaction. The first party information is reported in the First Party Identification section of the XML output file.
Customer Name
Customer Bill To Site
The XML file is generated per Customer Bill To Site and its corresponding B2G Received Code.
B2G Electronic Invoice Generation Option
Original generation (for invoices not yet generated)
Regeneration with same Transmission Progressive Number
Regeneration with new Transmission Progressive Number
Additional Information: The regeneration can be for a single invoice or for a given Transmission Progressive Number. Please refer to the Regeneration Scenarios section right after this section.
Transaction Date From
Transaction Date To
Transaction Number
Can be entered either for Original generation or Regeneration options.
Transmission Progressive Number
Enabled when Regeneration option is selected.
Transmission File Version
Value SDI10 defaults, but you can update it.
Number of Invoices per File
Enabled if B2G Electronic Invoice Generation Option is equal to Original. Valid options are:
One Invoice per File
Multiple Invoices per File
B2G Electronic Invoice Number of Invoices per File
Use One Invoice per File when there are just a few invoices in the selected date range. Otherwise, the Italian B2G Electronic invoices XML File Output concurrent program will spawn multiple times and you will have to save all output files.
When the program is entered without entering the transaction number, it is recommended to use the Multiple Invoices per File option. In this case, only one output file is generated with all invoices that fall in the date range.
Electronic Invoice Regeneration Scenarios
Scenario 1 - The electronic file is lost
To regenerate the same electronic file, you can run the program by selecting the option Regeneration with same Transmission Progressive Number and by entering the Transmission Progressive Number parameter.
Scenario 2 - Single invoice rejected from a file with multiple invoices
You can run the program by selecting the option Regeneration with new Transmission progressive Number and by entering the required transaction number.
Oracle has modified the Oracle E-Business Suite and Oracle Financials for Spain to comply with the Spanish B2G Electronic Invoicing legislation. The solution meets the following requirements:
Enable Electronic Invoice Generation for B2G transactions entered in Oracle Receivables, irrespective of the invoice entry method utilized;
Ensure the Electronic Invoice file is comprised of all mandatory data elements handled by the Oracle E-Business Suite and meets the technical specifications;
Enables you to handle and capture (example: manually enter or update) the Electronic Invoice Status at transaction header level;
Automatically updates the Electronic Invoice Status with the status Generated when the electronic invoice is generated for the first time or regenerated;
Provides an XML template in accordance to the XML layout defined by the Spanish authorities for B2G transactions, limited to the invoice data elements handled within the Oracle E-Business Suite.
In Spain, electronic invoices are regulated by Royal Decree 1619/2012. The law 25/2013 of December 27 later imposed electronic invoicing as the sole invoicing method to be used by organizations and professionals when issuing invoices against all Spanish public sector entities.
Order HAP/1074/2014 of June 24 defines the latest technical and functional requirements of electronic invoices.
This documentation describes the solution provided to comply with the Spanish B2G Electronic Invoicing requirements on the sales invoice side (example: Oracle Receivables).
Lookup Type: JEES_B2G_INV_STATUS (seeded, non user-definable)
Description: Spanish B2G Invoice Statuses
Code | Meaning | Description |
---|---|---|
CAN | Cancelled | Cancelled |
GEN | Generated | Generated |
TBR | To Be Regenerated | To Be Regenerated |
TRAN | Transmitted | Transmitted |
ACC | Accepted | Accepted |
REF | Refused | Refused |
Additional Information: This lookup type is not user-definable to preserve the invoice status consistency checks (refer to the Invoice Status Transition Scenarios for details).
LLookup Type: JEES_B2G_ NUM_INVOICES (seeded, non user-definable)
Description: Spanish B2G Number of Invoices per File
Code | Meaning | Description |
---|---|---|
1 | One | One Invoice Per File |
2 | One or More | One or More Invoices Per File |
LLookup Type: JEES_B2G_ ISSUER_TYPE (seeded, user-definable)
Description: Spanish B2G Document Type
Code | Meaning | Description |
---|---|---|
EM | Issued by Company | Invoice Issued by Company |
RE | Issued by the Receiver | Invoice issued by the Receiver |
TE | Issued by an Intermediary | Invoice issued by an Intermediary |
LLookup Type: JEES_B2G_DOC_TYPE (seeded, non user-definable)
Description: Spanish B2G Document Type
Code | Meaning | Description |
---|---|---|
FC | Complete Invoice | Complete Invoice |
FA | Abbreviated Invoice | Abbreviated Invoice |
AF | Self Invoice | Self Invoice |
LLookup Type: JEES_B2G_ GEN_OPTIONS (seeded, non user-definable)
Description: Spanish B2G Generation Options
Code | Meaning | Description |
---|---|---|
O | Original | Original |
C | Copy | Copy of Original Accepted |
LLookup Type: JEES_B2G_ INV_TYPE (seeded, non user-definable)
Description: Spanish B2G Invoice Class
Code | Meaning | Description |
---|---|---|
O | Original | Original |
R | Corrective | Corrective |
C | Consolidated | Consolidated |
Lookup Type: JEES_B2G_ REASON_CODES (lookup codes not seeded, user-definable)
Description: Spanish B2G Reason Codes
The Codes and Description must be defined by the user (example: legal content):
From 01 to 16 errors according to regulation RD 1496/2003
From 8 to 85 errors according to Art. 80 Law 37/92 on the VAT
LLookup Type: JEES_B2G_CORR_METHODS (seeded, user-definable)
Description: Spanish B2G Correction Methods
Code | Meaning | Description |
---|---|---|
01 | Full items | Full items |
02 | Corrected items only | Corrected items only |
03 | Bulk deal | Bulk deal in a given period |
04 | Authorized | Authorized by the Tax Agency |
The Spanish B2G Electronic Invoicing Process includes the following:
Review and update the Legal Entity information that must be reported under the Seller Party section.
Perform the required one-time setup (example: Lookups, Reporting Types and Codes);
Enter and complete B2G Receivables transactions (example: invoices, credit memos);
Run the Spanish B2G Electronic Invoices Generation program as per the parameters criteria:
Verify the accuracy of the XML output file;
Repeat step 4 as necessary, by ensuring that the'B2G Electronic Invoice Generation Option is entered properly (example: Original generation or regeneration);
Name the XML output file as per the naming convention defined by the Spanish Government;
Execute the next steps (outside of the Oracle E-Business Suite solution):
Apply a qualified electronic signature;
Transmit the signed XML
to the FACe if the third party B2G is a Central Administration;
to a fiscal partner if the third party B2G is a Local Administration;
Electronically store the signed XML file;
The following setup steps must be performed prior to entering new Receivables B2G transactions.
STEP 1 - Define Lookup Codes for the Following Seeded Lookup Type (Mandatory)
Lookup Type: JEES_B2G_ REASON_CODES (codes not seeded, user-definable)
Description: Spanish B2G Reason Codes
Additional Information: Lookup Codes, Meaning, and Description must be defined by the user (example: obtain legal content from Spanish Authority).
Example:
Codes from '01' to '16' errors according to regulation RD 1496/2003
Codes from '80' to '85' errors are according to Art. 80 Law 37/92 on the VAT.
STEP 2 - Define/Update Legal Entity Attributes (Mandatory)
Review and update (if required) the attributes that are reported under the <SellerParty> section of the XML file, such as Taxpayer ID, Corporate Name, and Address information.
STEP 3 - Define Tax Reporting Types and Codes (Mandatory)
The overall setup for the Spanish B2G solution assumes you are using Oracle E-Business Tax to define two specific Tax Reporting Types and respective Tax Reporting Codes that can be associated with the appropriate taxes and ultimately reported as part of the Tax sections of the XML file.
Within Oracle E-Business Tax, navigate to the Default and Controls tab and define two Tax Reporting Types and their respective Reporting Codes as follows:
B2G_TaxTypeCode - (Define Reporting Type and Codes, and Enable at Tax level)
Taxes are reported by TaxTypeCode, which are specific codes defined by the Spanish Authority (example: '01' = IVA). Define those codes as Tax Reporting Codes and associate them with the all Spanish taxes (example: IVA) that are required to be reported in the Spanish B2G XML file.
B2G_Additional_Info - (Define Reporting Type and Codes, and Enable at Tax Level)
When a transaction is 'not liable for tax' or 'exempt from tax', this justification must be reported under XML elements 3.1.9 and 3.1.9.3. Therefore, the association of the Tax Reporting Code belonging to the 'B2G_Additional_Info' Reporting Type to relevant Taxes is conditionally required; it is only required if this situation happens
The 'Description' field of the Tax Reporting Code belonging to the 'B2G_Additional_Info' Reporting Type is the actual text that appears in XML element 3.1.9.3, if the Tax Reporting Code was previously associated with the reported Tax.
Using the same page flow (demonstrated above), define the Tax Reporting Type 'B2G_Additional_Info', its corresponding Tax Reporting Codes, and enable it at the Tax level.
Additional Information: Both Tax Reporting Types ('B2G_TaxTypeCode' and 'B2G_Additional_Info') must be enabled at the 'Tax' level only.
Associate Tax Reporting Codes with Required Taxes
Within Oracle E-Business Tax, navigate to the Tax Configuration tab, and then the Taxes sub tab. Search for the desired Tax (example: IVA). Navigate to the Tax Reporting Codes region and locate the B2G Reporting Types (example: B2G_TAXTYPECODE) and ultimately make the association between the Tax and the Reporting Code value required for that Tax.
Additional Information: The association of Tax Reporting Codes belonging to B2G_TaxTypeCode with the appropriate Taxes is a mandatory setup step to have required tax information properly reported by TaxTypeCode. Refer to Spain Appendix for tax reporting details.
New Global Descriptive Flexfields were added at the header level for the Receivables B2G transactions, to capture important reporting information and the electronic invoice status.
The attributes are available and handled by the following transaction entry flows:
Receivables
Transactions Workbench
Autoinvoice
Create Invoice API
Create CM API
Copy Transaction
The new Global Descriptive Flexfields are:
B2G Electronic Invoice Status
Intended to capture the actual status of the electronic invoice;
For both first time, Original generation or Regeneration, the system updates this field with the status Generated. You can manually maintain all other statutes, based on the XML files received from the government;
Refer to the Spain Appendix to review all Status Transition scenarios.
B2G Electronic Invoice Type
Automatically populated with the value O for Invoices and R for Credit Memo
B2G Electronic Invoice Document Type
Automatically populated with the value FC (example: Complete Invoice)
B2G Electronic Invoice Language
Automatically populated with the value ES (example: Spanish language)
B2G Correction Invoice Reason Code
Select the proper value for Credit Memo transactions.
B2G Correction Method
Select the proper value for Credit Memo transactions.
Manually Entered Transactions
The new Global Descriptive Flexfields were added at the transaction header level. They can be viewed and updated.
Imported Transactions
The new header level invoice attributes can also be imported by populating the corresponding Global Attribute columns in the following interface table:
Table: RA_INTERFACE_LINES_ALL
GDF Contexts:
JE.ES.ARXTWMAI.MODELO340
JE.ES.ARXTWMAI.MODELO347
JE.ES.ARXTWMAI.MODELO347PR
JE.ES.ARXTWMAI.MODELO349
JE.ES.ARXTWMAI.MODELO415_347
JE.ES.ARXTWMAI.MODELO415_347PR
New Attributes | Mapped Global Attribute | Values to be Populated |
---|---|---|
B2G Electronic Invoice Status | Header_GDF_Attribute16 | NULL, CAN, GEN, REF, TBR, TRAN, ACC (Refer to the lookup codes in JEES_B2G_INV_STATUS) Values: O, R or C |
B2G Electronic Invoice Type | Header_GDF_Attribute1 | (Refer to the lookup codes in JEES_B2G_INV_TYPE) Values: FC, FA or AF |
B2G Electronic Invoice Document Type | Header_GDF_Attribute17 | (Refer to the lookup codes in JEES_B2G_DOC_TYPE) |
B2G Electronic Invoice Language | Header_GDF_Attribute18 | Value ES for Spanish language Values: <user definable as per legislation> |
B2G Correction Invoice Reason Code | Header_GDF_Attribute19 | (Refer to the lookup codes in JEES_B2G_REASON_CODES) Values: 01,02,03,04 |
B2G Correction Method | Header_GDF_Attribute20 | (Refer to the lookup codes in JEES_B2G_CORR_METHODS) |
Spanish B2G Electronic Invoices Generation
The Spanish B2G Electronic Invoices Generation' concurrent program was added under the Spanish AR Localizations responsibility. You can run it at any time to generate one of more electronic invoices (in XML format) belonging to the LE running the program, according to the selection criteria.
The program extracts the data according to the selection criteria provided in the Parameters window. If successful, the program will launch another concurrent program, Spanish B2G Electronic Invoices XML File Output, that actually generates the output file in a XML format
Parameter | Description |
---|---|
Legal Entity | First Party Legal Entity, owner of the B2G sales transaction. The first party information is reported in the Seller section of the XML output file. |
Invoice Issuer Type | Select from the list of values. Default value: Issued by the Company |
Customer Name | - |
Customer Bill To Site | The XML file is generated per Customer Bill To Site |
B2G Electronic Invoice Generation Option | Select from the list of values. Default Value: Original
Additional Information: Select Copy upon request, to generate a copy of an Electronic Invoice already submitted and marked as Accepted. |
Transaction Date From | - |
Transaction Date To | - |
Number of Invoices per File | Select either: 1- One invoice per file, or 2 - One or More Invoices per file, from the list of values When the B2G Electronic Invoice Generation Option is equal to Copy, the value 1 is defaulted and cannot be changed. |
Transaction Number | When the B2G Electronic Invoice Generation Option is equal to: Original: The list of values displays completed invoices where the invoice status is either equal to NULL or To Be Regenerated. Copy: The list of values displays completed invoices where the invoice status is equal to Accepted. |
Maximum Number of Invoices per File | Enabled if Number of Invoices per File is equal to 2 (One or More Invoices per File). The defaulted and maximum allowed value is 100. If there are more eligible transactions than Maximum Number of Invoices per File, the log file shows the following message: The reporting criteria provided identified more eligible invoices than the maximum number of invoices per file. Run the Concurrent Program again to report remaining invoices in a separate file. |
Below is an outline of the complete list of user procedures related to the Spanish B2G Soluution
Refer to Setup Steps for more detail on some of these procedures.
1 - Manually Update the Electronic Invoice Status
For each XML message received from the Government, you should manually update the Electronic Invoice Status (GDF at the invoice header level) to ensure that the latest status is captured.
2 - File Naming
Name and save the Output file in your local directory. The file name must follow the instructions provided by the Spanish Public Administration.
3 - Daily Exchange Rate
Define and maintain Daily Exchange Rate details, according to government exchange rate guidelines.
4 - Steps to Cancel an Erroneous B2G Invoice and Prevent Both Invoice and Credit Memo from Being Reported
Retrieve the B2G invoice to be cancelled and set the invoice status to CANCELLED, to prevent the invoice from being selected.
Enter a Credit Memo (type VOID) against that B2G invoice and set the Credit Memo invoice status to CANCELLED, to prevent the Credit Memo from being selected.
5 - Setup Steps to Define Tax Reporting Types, Tax Reporting Codes and Associate Them at the Tax Level
Refer to Setup Steps, Step 3 for more details.
Example:
01 = IVA (Value Added Tax) - (Impuesto sobre el valor anadido)
02 = IPSI (Tax on production, services and imports) - (Impuesto sobre producciones, servicios e importaciones)
03 = IGIC (General indirect Canary Island tax) - (Impuesto general indirecto de canarias)
Descriptive Reporting Codes for the B2G_Addit_Info Reporting Type:
Within ZX_REPORT_CODES_ASSOC, associate the Tax Reporting Type (example: B2G_TaxTypeCode) and the Tax Reporting Code (example: 01) with a specific record in ZX_TAXES (example: VAT). This is the same for the reporting codes defined for the B2G_Addit_Info reporting type.
Effective July 1, 2017, the delivery of VAT Register information to the Spanish Tax Authorities must be performed electronically via a predefined xml-format and up to four days after the issuance or reception date. This is accomplished by sending all invoice and ticket information to the Tax Authorities. The requirement also has a component for processing the confirmation messages sent from the authority, updating the submitted data with the necessary details.
The following setup steps must be performed before entering new Payables or Receivables transactions:
New Customer and Supplier master file information: Taxpayer Identification Number Type, Special Regime and Exclude from SII Reporting.
There is a Global Descriptive Flexfield to indicate the taxpayer identification number type, which must be included in the xml file. This Global Descriptive Flexfield must not be populated when the Supplier or Customer has a Spanish or European Union-assigned Taxpayer Number; in this case, this value is inferred and automatically populated by EBS. If the Taxpayer Number NOT be a Spanish or European Union number, one of the following values must be indicated in the customer / supplier master file:
Passport
Official document issued by the country of residence
Certificate of Residence
Other documents
Not in Census
Note: The actual number is retrieved from the Tax Registration Number field on the Customer / Supplier master file.
02 is derived when applicable: 02 is automatically populated in the SII file, when it is an EU TRN.
Special Regime: Select the special regime code that is applicable for the supplier/customer. This special regime code is used as the default value in the XML message for transactions created for the supplier/customer. You can change this value manually for each transaction, using the Global Descriptive flexfield. The Special Regime entered at the transaction level is given the highest priority.
To indicate the Taxpayer Identification Number Type and Special Regime, you must first select Spanish Customers Information for AR and Spanish Suppliers Information for AP, in the Context Value field of Global Details window. These values can also be provided at the supplier/customer site. The value provided at the site level is given a higher priority than the value at the supplier/customer level.
Exclude from SII Reporting: Select Yes for Exclude from SII reporting to exclude all transactions of a supplier/customer or sites.
Tax Setup:
The Tax Reporting Type Codes and Reporting Codes must be created and assigned to Tax Rate level to identify whether the transaction is subject to VAT (S1 or S2) or Non Subject (0% rate).
Define Tax Reporting Types: JE-ES-SII-SUB-NON-EXEMPT
Enable the Reporting Type Use at Tax Rate level
Define the corresponding Tax Reporting Codes as follows:
Reporting Code | Description |
---|---|
S1 | Subject -Not Exempt |
S2 | Subject -Not Exempt - Reverse |
NS | Non Subject - if the attachment is for the art. 7, 14, others |
NS_LOC | Non Subject - if the attachment is for operations not subject to the TAI for localization rules |
There is no additional setup required to have S3 in the report output. It is derived from code logic.
If the 0% rate is assigned to NS, the amount will display in the SII ImportePor Articulos7_ 14_Otros field.
If the 0% rate is assigned to NS_LOC, the amount wil display in the SII ImporteTAI ReglasLocalizacion field.
Assign the appropriate Reporting Code to the Tax Rate: Navigate to EBTax > Tax Configuration > Tax Rates > search for the Tax Rate > Update > Rate details > Tax Reporting Codes
Add values in the Exemption Reasons table:
The following lookup codes and descriptions must be added to the lookup type ZX_EXEMPTION_REASON_CODE, to populate the field CausaExencion (table L9 in the the Tax Agency XML message specifications): Navigation: Application Developer > Application > Lookups > Application Object Library > Search for ZX_EXEMPTION_REASON_CODE
Code | Description |
---|---|
E1 | Exempt due to article 20 |
E2 | Exempt due to article 21 |
E3 | Exempt due to article 22 |
E4 | Exempt due to article 23 and 24 |
E5 | Exempt due to article 25 |
E6 | Exempt due to other |
These exemption reason codes should be used in the Exemption reason during the tax exemption setup.
Navigation: EBTax > Parties > Party Tax Profiles > Party Type = Third Party Site > Exemptions
Document Sequence Setup (Mandatory): For Receivables (Issued Invoice) transactions, complete the Document Sequence setup for Invoice Identification. The Invoice identification of Issued invoice value depends on the Copy Document Number to Transaction Number check box.
If the Copy Document Number to Transaction Number check box is selected, Invoice Identification will be Document Sequence Name <Delimiter>Document Number
Delimiter is identified using LOOKUP JEES_SII_DELIMITER. By default, / is enabled. You can modify this lookup and choose/enter any other value.
Only one value should be enabled for LOOKUP JEES_SII_DELIMITER.
If this check box is not selected, Invoice Identification will be the transaction number.
Supplier/Customer Taxpayer id and Tax registration Number (Mandatory): Set up the Taxpayer ID and Tax Registration Number for the Spanish Supplier and the Customer, in Tax and Financial Information .
You can enter your tax registrations at third party and/or third party sites. First preference is given to tax registration at the site level.
Set up the Tax Registration Number in Parties: Party Tax Profiles > Party Tax Profiles > Party Type = Third Party > Query for the Party Name > Update Tax Profile > Tax Registrations > Default Reporting Registration Number
Note: The actual number is retrieved from the Tax Registration Number field on the Customer / Supplier master file (billing site). Tax numbers commencing with a Spanish (ES) or another EU country code prefix are considered Spanish or EU tax numbers, respectively.
Setup for Cash Collections Register
Receipt Class Setup
Create a Receipt class exclusively for Cash Collection. Mark the Segment: Cash Collection as Yes to pick receipts for the Cash Collection Register.
Lookup code: JEES_SII_CASH_RECEIPT_METHOD
If multiple receipt methods are attached to a Receipt Class and few receipt methods are used for Cash Collections.
Enter the Code as RECEIPT_METHOD_ID and Meaning as Name.
Example: SELECT receipt_method_id,name FROM ar_receipt_methods WHERE name LIKE Cash%
Setup for Payment Method Code
Define a payment method with code JE_ES_SII_DD.
Navigation: Payables Responsibility > Setup > Payment > Payment Administrator > Payment Methods
Setup for Investment Goods Register
Set JG: Territory profile option to Spain
Set up Global Descriptive Flexfield at Asset Category
Navigation: Asset Vision Spain >Setup > Asset System > Asset Categories
Setup for Received Invoice Register for Periodo Tag
The Online VAT Reporting Received Invoices template has a mandatory Periodo tag. Businesses can either use the Invoice Date or Accounting Date to determine the period value for an invoice.
Available options:
TRX - Invoice Date
GL - Accounting Date
Enable the preferred value: Navigation: Application Developer > Application > Lookups > Application Object Library > Search for JEES_SII_AP_PERIOD_OPTION
TRX Invoice Date is enabled by default.
Specify defaults for mandatory values per your business need (Optional).
Navigation: Application Developer > Application > Lookups > Application Object Library > Search for JEES_SII_DEFAULT_RECEIVED_REG or JEES_SII_DEFAULT_ISSUED_REG
You can enter other defaults in the description field across the corresponding field type. This is a free-entry text field; no list of values is provided.
Enter the exact value that will be entered on the xml file.
Note: Special Regime default and override values can be specified at multiple levels, therefore the hierarchy is followed to identify the Special Regime value to use for an invoice in the xml.
Value specified at the invoice header level in the Global Descriptive Flexfield: Online VAT Reporting for Spain
Value specified at the Party Site Level in the Global Descriptive Flexfield: Special Regime
Value specified at the Party Level in the Global Descriptive Flexfield: Special Regime
Description specified in JEES_SII_DEFAULT_ISSUED_REG OR JEES_SII_DEFAULT_RECEIVED_REG
The Invoice Type entered at the invoice header level in the Global Descriptive Flexfield is given the highest priority.
Exclude Received Invoices from Reporting (Optional)
Enter the Payable Source Code and Meaning in the lookup, to exclude the Payable Source from reporting.
Navigation: Application Developer > Application > Lookups > Application Object Library > Search for JEES_SII_EXCLUDE_AP_SOURCE
Exclude Issued Invoices from Reporting for Transaction Source (Optional)
Define Exclude from SII Reporting as Yes in the Transaction Source Global Descriptive Flexfield, to exclude the transaction of the entire source from reporting.
Issued Invoices: fields to be populated for SII invoices
The following additional/modified fields are available in the EBS SII solution for Issued Invoices, which must be populated when appropriate.
Comments field:
The description of the transaction being recorded must be included in this existing field on the AR Transaction form.
It is a mandatory field to show the correct description of the transaction.
If you do not populate this field, the description of the first line will appear as the transaction description.
It will be used to populate the SII field DescripcionOperacion.
The following Global Descriptive Flexfields must be populated, when pertinent.
Navigation: Receivables Responsibility > Transactions > Trasactions > Select GDFF ( )
The system dispplays the Additional Information for Spain window:
In the Context Value field select Online VAT Reporting for Spain. This value will trigger the following SII fields to appear.
Special Regime: Select the Special Regime, according to the below table.
This is a mandatory field in the report output file and will populate the SII field ClaveRegimenEspecialOTrascendencia.
Special Regime Code | Description |
---|---|
01 | Operation of the general scheme |
02 | Export |
03 | Operations to which the special regime of used goods, art objects, antiques and collectors objects apply - 135-139 LIVA |
04 | Special investment gold regime |
05 | Special regime travel agencies |
06 | Special regime group of entities in VAT - Advanced Level |
07 | Special regime cash criterion |
08 | Operations subject to IPSI / IGIC |
09 | Purchase of travel agencies |
10 | Collection on behalf of third parties of professional fees |
11 | Business premises lease transactions subject to withholding |
12 | Non-retention business premises lease operations |
13 | Lease transactions of business premises subject to and not subject to withholding |
14 | Invoice with tax pending of accrual |
15 | Invoice with VAT pending accrual - operations of successive tract |
16 | First Semester 2017 and other invoices former to adhering to SII |
Append lookup Type JEES_SII_IIR_SPECIAL_REGIME, to report invoices that contain transactions with a different special regime.
Navigation: Application Developer > Application > Lookups > Application Object Library > Search for JEES_SII_IIR_SPECIAL_REGIME
Invoice Type: Select the Invoice type, according to the below table. This is mandatory and will populate the SII field TipoFactura. The default value can be set to F1.
Values | Description |
---|---|
F1 | Invoice art. 6, 7.2, and 7.3 |
F2 | Simplified Invoice and invoices with no addressee art. 6.1.d |
R1 | Rectification invoice (Art 80.1 y 80.2 y error fundado en derecho) (Rectification Invoice - Art 80.1 y 80.2 and legal errors) |
R2 | Rectification invoice (art. 80.3) ) |
R3 | Rectification invoice (Resto art. 80.4) |
R4 | Factura Rectificativa (Resto) (Recification Invoice) (Rest) |
R5 | Factura Rectificativa en facturas simplificadas (Rectification Invoice for Simplified Invoices) |
F3 | Factura emitida en sustitucion de facturas simplificadas facturadas y declaradas (Invoice issued instead of invoiced and declared |
F4 | Asiento resumen de facturas (Summary journal of invoices) |
F5 | Importaciones (DUA) (Imports) (DUA) |
F6 | Otros justificantes contables (Other accounting) |
LC | Cutoms |
Note: Rectification invoice (Applicable on Payables and Receivables transactions
Rectification Type | Method | User Action |
---|---|---|
By Substitution/ Replacement S | A new invoice is created that substitutes the original invoice | Populate the Original Invoice Number (case sensitive) in New Invoice Global Descriptive Flexfield. |
By difference I | A Credit Memo is created and applied on Invoice | Not required. The system will identify this type of rectification. |
The proposed solution design only submits invoices that are un-erasable, that is, completed / validated. These invoices can only be corrected by means of a correction on the invoice (of non critical data, because we cannot change critical data on a posted invoice) which would result in a modification transaction, or by means of a rectification transaction (example: credit memo) which would result in an addition transaction.
Note: If Invoice Type is F4, the first number of the series will be entered in the Transaction Number field (Transaction workbench) and the last number of the series in the new Global Descriptive Flexfield segment Last Document Number of Summary Invoice.
Original Invoice Number:
This field must be entered when the Invoice Type (TipoFactura)=Rectificativa (Rectification).
Enter the invoice number(case Sensitive) of the invoice being rectified.
This corresponds to the SII field NumSerieFacturaEmisor.
The rectified invoice date will be populated automatically from the original invoice selected.
Last Document Number of Summary Invoice
This field must be entered when the Invoice Type (TipoFactura)=F4 (Summary Journal of Invoices).
Enter the Last Document number of the Summary invoices.
This corresponds to the SII field NumSerieFacturaEmisorResumenFin.
Intra-Community Type
Only used in the Selected Intracommunity Transactions Register.
The default value for this field is blank.
Values A or B can be selected.
If you populates the Intracommunity Type, the Transaction will appear in the Selected Intra-EU Transactions Register.
L12 Intracommunity Transaction Type
Values | Description |
---|---|
A | El envio o recepcion de bienes para la realizacion de los informes parciales o trabajos mencionados en el articulo 70, apartado uno, numero 7, de la Ley del Impuesto (Ley 37/1992). (The sending or receipt of goods for the execution of the partial reports or works mentioned in article 70, section one, Number 7, of the Tax Law 37/1992) |
B | Las transferencias de bienes y las adquisiciones intracomunitarias de bienes comprendidas en los articulos 9, apartado 3, y 16, apartado 2, de la Ley del Impuesto (Ley 37/1992). (Transfers of goods and intra-Community acquisitions of goods covered by In articles 9, paragraph 3, and 16, section 2, of the Tax Law (Law 37/1992).) |
Invoice Register Type: This field is optional and is to be entered if the invoice:
is of type insurance transaction or
is of type insurance transaction and Issued invoice or
has been issued by another party other than the first party (the other party need not be identified)
If no value is selected in the Invoice Register Type, it is considered as Issued invoice.
Values | Description |
---|---|
Insurance Transaction | Insurance Transaction |
Issued Invoice and Insurance Transaction | Issued Invoice and Insurance Transaction |
Issued Invoice | Issued Invoice |
Issued Third Party Invoice | Issued Third Party Invoice |
Transaction Date
This field is mandatory only when it is different than the invoice date.
It populates the SII field FechaOperacion.
If the period or year is other than the invoice period or year, the value in this field will be used to populate the transaction Period (Periodo) and Year (Ejercicio) fields.
Transaction Deadline: This optional GDF is for the Intra EU transaction registers (PlazoOperacion); it is present in both AP and AR invoices / transactions.
Transmission of Property
This GDF field is optional and can contain a Y/N value.
When Y is selected, the field ImporteTransmisionSujetoAIVA (Transmission / sale amount subject to VAT) is populated with Invoice Total Amount (Tax Amount + Taxable Amount).
Property Location
This optional GDF field shows the below list of values which depicts the property location.
Define locations and designate the locations that are property rentals.
The list of values will display values only if the global Descriptive field for Context Value Property Rented in the Location window.
Rates Reference fields will be used for Referencia Catastral.
The following status fields were added to invoices to control the submission process.
Submission Status
This field is utilized to control the submission status to the Tax Agency.
The following submission statuses are provided: Ready to be submitted, Submitted, On hold, Modified, Externally (already) Submitted
The default value, after an invoice is entered and completed, is R = Ready.
The report will pick transactions having R or M statuses.
The status will change to S if the Online VAT Data Extraction Program Spain program runs in the Final report mode.
Tax Authority Status
Validation return code from the tax authorities
The following tax authority statuses are provided: Correct, Incorrect and Accepted With Errors
Message Code
This field contains the error code and returned by the Tax Agency, when applicable.
Refer tot he list of error codes and descriptions in the SII Technical Specifications on the Tax Agency website.
Message Description
This field contains the error code description and returned by the Tax Agency, when applicable.
Reference the list of error codes and descriptions in the SII Technical Specifications on the Tax Agency website.
Late Submission: This field contains the values Yes and No. If Yes is selected, the tag value S is populated. If No is selected, the tag value N is populated. If you do not select any value, the tag value defaults as N.
Simplified Invoice: This field contains the values Yes and No. If Yes is selected, the tag value S is populated. If No is selected, the tag value N is populated. If you do not select any value, the tag value defaults as N.
Invoice with No Counterpart: This field contains the values Yes and No. If Yes is selected, the tag value S is populated. If No is selected, the tag value N is populated. If you do not select any value, the tag value defaults as S.
Received Invoices - fields to be populated for SII invoices
The following additional/modified fields are available in the EBS SII solution for Received Invoices, which must be populated when appropriate.
Description field at Header Level
The description of the Invoice being recorded must be included in this existing field on header level.
It is a mandatory field.
It is used to populate the SII field DescripcionOperacion.
Internal Recording Date
This field is mandatory only when the period or year is different than the invoice date.
If the period or year in the Tax Invoice Date is other than the invoice period or year, the value in this field will be used to populate the invoice Year (Ejercicio) field.
It is used to populate the SII field FechaOperacion.
The following Global Descriptive Flexfields must be populated, when pertinent:
Navigation: Payables Responsibility > Invoices > Entry > Invoices > Click on GDFF ( )
Context Value
Select Online VAT Reporting for Spain.
This is mandatory if the invoice is to be reported via SII.
Special Regime
Select the Special Regime, according to the below table.
This is a mandatory field in the report output file and will populate the SII field ClaveRegimenEspecialOTrascendencia.
Special Regime Code | Description |
---|---|
01 | Operation of the general scheme |
02 | Operations by which employers pay compensation REAGYP |
03 | Operations to which the special regime of used goods, art objects, antiques and collectors objects apply - 135-139 LIVA |
04 | Special investment gold regime |
05 | Special regime travel agencies |
06 | Special regime group of entities in VAT - Advanced Level |
07 | Special regime cash criterion |
08 | Operations subject to IPSI / IGIC |
09 | Intra-Community acquisitions of goods and service |
12 | Leasing operations of premises of business |
13 | Invoice corresponding to an import |
14 | First Semester 2017 and other invoices former to adhering to SII |
Append lookup Type JEES_SII_RIR_SPECIAL_REGIME, to report invoices that contain transactions with a different special regime.
Navigation: Application Developer > Application > Lookups > Application Object Library > Search for JEES_SII_RIR_SPECIAL_REGIME
Invoice Type
Select the Invoice type, according to the below table.
This is mandatory and will populate the SII field TipoFactura.
The default value can be set to F1.
Values | Description |
---|---|
F1 | Invoice art. 6, 7.2, and 7.3 |
F2 | Simplified Invoice and invoices with no addressee art. 6.1.d |
R1 | Rectification invoice (Art 80.1 y 80.2 y error fundado en derecho) (Rectification Invoice - Art 80.1 y 80.2 and legal errors) |
R2 | Rectification invoice (art. 80.3) |
R3 | Rectification invoice (Resto art. 80.4)) |
R4 | Factura Rectificativa (Resto) (Recification Invoice) (Rest) |
R5 | Factura Rectificativa en facturas simplificadas (Rectification Invoice for Simplified Invoices) |
F3 | Factura emitida en sustitucion de facturas simplificadas facturadas y declaradas (Invoice issued instead of invoiced and declared |
F4 | Asiento resumen de facturas (Summary journal of invoices) |
F5 | Importaciones (DUA) (Imports) (DUA) |
F6 | Otros justificantes contables (Other accounting) |
LC | Cutoms |
Note: Rectification invoice (Applicable on Payables and Receivables transactions
Rectification Type | Method | User Action |
---|---|---|
By Substitution/ Replacement S | A new invoice is created that substitutes the original invoice | Populate the Original Invoice Number (case sensitive) in New Invoice Global Descriptive Flexfield. |
By difference I | A Credit Memo is created and applied on Invoice | Not required. The system will identify this type of rectification. |
The proposed solution design only submits invoices that are un-erasable, that is, completed / validated. These invoices can only be corrected by means of a correction on the invoice (of non critical data, because we cannot change critical data on a posted invoice) which would result in a modification transaction, or by means of a rectification transaction (example: credit memo) which would result in an addition transaction.
Note: If Invoice Type is F4, the first number of the series will be entered in the Transaction Number field (Transaction workbench) and the last number of the series in the new Global Descriptive Flexfield segment Last Document Number of Summary Invoice.
Original Invoice Number
This field must be entered when the Invoice Type (TipoFactura)=Rectificativa (Rectification).
Enter the invoice number (case sensitive) of the invoice being rectified.
The recitified invoice date will be populated automatically from the original invoice selected.
This corresponds to the SII field NumSerieFacturaEmisor.
Original Invoice Number
This field must be entered when the Invoice Type (TipoFactura)=Rectificativa (Rectification).
Enter the invoice number (case Sensitive) of the invoice being rectified.
This corresponds to the SII field NumSerieFacturaEmisor.
The rectified invoice date will be populated automatically from the original invoice selected.
Intra Community Type
Only used in the Selected Intracommunity Transactions Register.
The default value for this field is blank.
Values A or B can be selected.
If you populates the Intracommunity Type, the Transaction will appear in the Selected Intra-EU Transactions Register.
L12 Intracommunity Transaction Type
Values | Description |
---|---|
A | El envio o recepcion de bienes para la realizacion de los informes parciales o trabajos mencionados en el articulo 70, apartado uno, numero 7, de la Ley del Impuesto (Ley 37/1992). (The sending or receipt of goods for the execution of the partial reports or works mentioned in article 70, section one, Number 7, of the Tax Law 37/1992) |
B | Las transferencias de bienes y las adquisiciones intracomunitarias de bienes comprendidas en los articulos 9, apartado 3, y 16, apartado 2, de la Ley del Impuesto (Ley 37/1992). (Transfers of goods and intra-Community acquisitions of goods covered by In articles 9, paragraph 3, and 16, section 2, of the Tax Law (Law 37/1992).) |
Invoice Register Type: This field is optional and is to be entered if the invoice:
is of type insurance transaction or
is of type insurance transaction and Issued invoice or
has been issued by another party other than the first party (the other party need not be identified)
If no value is selected in the Invoice Register Type, it is considered as Issued invoice.
Values | Description |
---|---|
Insurance Transaction | Insurance Transaction |
Received Invoice | Received Invoice |
Received Invoice and Insurance Transaction | Received Invoice and Insurance Transaction |
Received Invoice and Travel Agency | Received Invoice and Travel Agency |
Received Third Party Invoice | Received Third Party Invoice |
Travel Agency Transaction | Travel Agency Transaction |
Transaction Deadline: This optional GDF is for the Intra EU transaction registers (PlazoOperacion), so it is present in both AP and AR invoices / transactions.
Invoice Recording Date
This optional GDF for Date supplier invoice is recorded in the system for field (FechaRegContable).
If a date is provided in the GDF field, FechaRegContable will display that date; otherwise it will display the GL date.
Reporting Period: Enter a period if you need to change the period calculated from the invoice date or accounting date, based on the value assigned via the lookup. Valid calendar periods: MM-RRRR example 01-2018
The following status fields were added to invoices to control the submission process.
Submission Status
This field is utilized to control the submission status to the Tax Agency.
The following submission statuses are provided: Ready to be submitted, Submitted, On hold, Modified, Externally (already) Submitted
The default value, after an invoice is entered and completed, is R = Ready.
The report will pick transactions having R or M statuses.
The status will change to S if the Online VAT Data Extraction Program Spain program runs in the Final report mode.
Tax Authority Status
Validation return code from the tax authorities
The following tax authority statuses are provided: Correct, Incorrect and Accepted With Errors
Message Code
This field contains the error code and returned by the Tax Agency, when applicable.
Refer tot he list of error codes and descriptions in the SII Technical Specifications on the Tax Agency website.
Message Description
This field contains the error code description and returned by the Tax Agency, when applicable.
Reference the list of error codes and descriptions in the SII Technical Specifications on the Tax Agency website.
Late Submission: This field contains the values Yes and No. If Yes is selected, the tag value S is populated. If No is selected, the tag value N is populated. If you do not select any value, the tag value defaults as N.
Simplified Invoice: This field contains the values Yes and No. If Yes is selected, the tag value S is populated. If No is selected, the tag value N is populated. If you do not select any value, the tag value defaults as N.
Payment Entry
For all Direct Debit Payments, select the payment method with code JE_ES_SII_DD.
Payments completed using the above payment method have the value 05 populated for tag Medio, within Received Invoices Register (Payments).
Navigation: Payables Responsibility > Payments > Entry > Payments
Receipt Entry
Note: For all Direct Debit Receipts, you must use Oracle Receivables Direct Debit functionality. Refer to Oracle Receivables User Guide.
All Direct Debit Receipts are populated with the value 05 for the tag Medio, within the Issued Invoices Register (collections).
If a receipt method is used for cash collection along with another purpose, each receipt should be marked 'Yes' as the Cash Collection, for the Cash Collection Register.
Note: Setting the 'Cash Collection' Global Descriptive Flexfield as Receipt Class is the recommended approach. The Receipt Method lookup and the receipt level Global descriptive flexfield are provided only for historical data.These will not be supported in the future.
Asset Entry
Enter the Global Descriptive Flexfield for Investment Goods Reporting.