Professional Documents
Culture Documents
Version 15
01 Dec 2022
DISCLAIMER:
This guide may contain screen shots and output reports to facilitate the user comprehension about the
topic. The content represents a fictitious sample. Any similarity to actual persons, living or dead, or
company names, active or inactive, is purely coincidental and not intended in any manner.
LACLS Costa Rica – XM Canonical for Electronic Invoice – User and Functional Implementation Guide
1
TABLE OF CONTENTS
TABLE OF CONTENTS ..............................................................................................................................................2
INTRODUCTION TO XML CANONICAL FOR ELECTRONIC INVOICE FOR COSTA RICA ................................................5
INTENDED AUDIENCE...................................................................................................................................................... 5
ASSUMPTIONS .............................................................................................................................................................. 5
MACRO FLOW .............................................................................................................................................................. 6
CONCATENATE SPECIAL INFORMATION .............................................................................................................................. 7
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
2
VALUE SETS ................................................................................................................................................................ 26
Document Type: LACLS_CR_DOCUMENT_TYPE ................................................................................................. 26
Reference Document Code: LACLS_CR_REF_CODE ............................................................................................ 26
Payment Condition: LACLS_CR_PAYMENT_CONDITION .................................................................................... 27
Reference Doc Type: LACLS_CR_REF_DOC_TYPE ............................................................................................... 27
Establishment Number: LACLS_CR_ESTABLISH_NUMBER ................................................................................. 27
Billing Point: LACLS_CR_BILLING_POINT ............................................................................................................ 28
Incoterm Codes: LACLS_CR_INCONTERMS ......................................................................................................... 28
Invoice Status: LACLS_CR_EFD_STATUS ............................................................................................................. 29
Payment Term: LACLS_CR_PAYMENT_TERMS ................................................................................................... 29
CABYS Code: LACLS_CR_CABYS_CODE ............................................................................................................... 29
Duty Item: LACLS_CR_DUTY_ITEM ..................................................................................................................... 30
Einvoice Condition: LACLS_CR_EINVOICE_CONDITION ...................................................................................... 30
DESCRIPTIVE FLEXFIELDS ............................................................................................................................................... 31
Receivables Transaction Header ........................................................................................................................ 31
Receivables Transaction Type ............................................................................................................................ 32
Party Sites........................................................................................................................................................... 34
Locations ............................................................................................................................................................ 35
Memo Line.......................................................................................................................................................... 35
Invoice Line ......................................................................................................................................................... 36
FND Lookups – Payment Term ........................................................................................................................... 37
ITEM TYPE – INVENTORY CATALOG ................................................................................................................................. 38
CABYS Code: LACLS_CR_CABYS_CODE ............................................................................................................... 38
Duty Item: LACLS_CR_DUTY_ITEM ..................................................................................................................... 38
GEOGRAPHY LOOKUP ................................................................................................................................................... 39
Geography Code: LACLS_CR_GEOGRAPHY_CODES ............................................................................................ 39
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
3
REVISION HISTORY
This document will continue to evolve as existing sections change and new information is added. All updates are
logged below:
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
4
INTRODUCTION TO XML CANONICAL FOR ELECTRONIC INVOICE FOR COSTA
RICA
Latin America Cloud Local Solution (LACLS) for Costa Rica is a set of components that complements the core
functionalities providing new features used to meet legal requirements requested by government agencies.
For Costa Rica, the government agency responsible to establish the legal requirements is named MH (Ministerio de
Hacienda).
LACLS released “XML Canonical for Electronic Invoice” solution for Costa Rica providing BI Publisher extractor to
generate canonical XML file containing information about Oracle Receivables (AR) transactions eligible to generate
electronic fiscal document (EFD). The XML file can be consumed by the third party software providers to create
electronic fiscal document files to be sent to the government agency (MH).
Important: The information contained into the canonical XML file is extracted from the Oracle ERP Cloud tables
considering the database model. The extractor does not perform calculation, sum or any other data manipulation
over the extracted information. If a data transformation be required, it must be done by the Third Party or custom.
Macro Flow;
The Additional Information required in order to issue Electronic Invoice;
The steps describing how to setup and enter these Additional Information;
The steps to upload the BI Publisher artifacts in the Cloud instance;
How to monitor the process.
INTENDED AUDIENCE
Welcome to LACLS XML Canonical for Electronic Invoice solution for Costa Rica. This guide is intended to be used
by the Oracle ERP Cloud functional implementers and key users.
ASSUMPTIONS
The solution will be seen here assume that the following functionalities have been set up in Oracle ERP:
Data Security
Geographies
Enterprise Structure
Tax Regime information
Tax Party Profiles
LACLS Costa Rica – XM Canonical for Electronic Invoice – User and Functional Implementation Guide
5
Tax Rules
Customers
Reference Data Sets
Common Options for Receivables
MACRO FLOW
The solution is based on transactions created under Oracle Receivables (AR) in the ERP Cloud.
The solution is composed by BI Publishers that expose the AR information in a canonical XML and two Web Services
(WS):
one to execute the BI extractors and
other to update information in AR
o Status
o Message
o UUID Number
o UUID Date
The third party is responsible for the governance of the integration process: requesting the transactions file,
consuming the file, controlling which transaction was already captured and sent to MHI, validating, transforming
and formatting the information according government layout, and returning the set of information to Oracle ERP
Cloud. In general the print process for ‘factura’ is also part of the third party scope, or an ERP custom report, since
the standard report in Oracle ERP is for global purpose and might not present specific information required by the
country.
The flow starts by the third party calling a WS to run the BI Publisher Extractor (1). This BI will return select all
Receivables transactions eligible to generate an electronic voucher (2). A transaction is eligible to generate an
electronic voucher when:
The transaction status in Oracle ERP is completed. That means the information cannot be changed.
The type of transaction is flagged as "electronic invoice". All transactions are associated to a
transaction type, the transaction type has a flag to identify if the transactions generated under
that type must be issued electronically.
The transaction E-Invoice Status is NULL or “3-ERROR”. E-Invoice Status as NULL means this is a
new transaction, and E-Invoice Status as 3-ERROR means this transaction once was rejected by
MH and now might be fixed and needs to be processed by MH again, since for Costa Rica the
Electronic Invoice is not gapless.
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
6
Once third party has the xml file in its possession, he is responsible to decompose the file into individual transaction
(3) in order call the WS to update the CFE Status as “SENT” (captured by third party) (4). This field should be updated
with “SENT”, preventing that the transaction be retrieved again in the next execution of the extractor;
After the update at MH status, the third party must process each transaction: validating, transforming and
formatting (5) the new pay load to send to MH (7). Including digital signature (6), when required, according to MH
specifications. The control regarding which transaction has already been processed and communicated with MH is
under third party responsibility as well.
Once MH has answered, the third party needs to return these information to Oracle ERP Cloud (9).
The return information required are:
KEY Status:
1-FINISHED – Indicates the electronic voucher was processed and approved by MH;
2-WARNING – Indicates the electronic voucher was processed and approved with warnings
by MH;
3-ERROR – Indicates the electronic voucher was processed and rejected by MH.
KEY Number – Number of Key assigned by MH;
KEY Date – Date of Key generation.
KEY Message – Relevant messages (optional).
Key Number
- The first three digits correspond to the country code (506).
- From the fourth to the fifth digit, it corresponds to the day the electronic invoice is generated.
- From the sixth to the seventh digit, it corresponds to the month in which the electronic invoice is
generated.
- From the eighth to the ninth digit, it corresponds to the year in which the electronic invoice is
generated.
- From the tenth to the twenty-first digit, it corresponds to the issuer's identification number. NIT
legal entity
- From the twenty-second to the forty-first digit, it corresponds to the consecutive numbering of the
electronic invoice. trx number with leading zeros
- The forty-second corresponds to the situation of the electronic invoice.
- From the forty-third to the fiftieth digit, it corresponds to the security code generated by the
taxpayer's system. Last 8 digits of the invoice id
Sequence Number
- Establishment Number
- Billing Point
- Transaction Type
- Invoice Number
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
7
PREPARING TO INSTALL/UPDATE
This chapter provides instructions for obtaining the latest version of Costa Rica solution and assists in
creating a stage area for installation.
To download the latest Costa Rica Update Pack available, please refer to the Note Latin America Cloud
Local Solutions (LACLS) - How to get the latest Pack (Doc ID 2588752.1) and search for Costa Rica
component in Table 3.1.1. "Latest quarterly cumulative pack" column contains the link to download the
latest Pack released. Example:
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
8
INSTALLATION/UPDATE TASKS
This chapter provides a guide for Installing/Updating Costa Rica XML Canonical for Electronic Invoice
solutions artifacts. Mandatory for all customers who are installing/upgrading Costa Rica solution.
For customers using Maintenance Assistant (MNT), please skip this chapter since all manual procedures
will be replaced by MNT processing.
After apply the Pack manually or using MNT please follow to "Configuration Tasks" chapter.
Important:
It is mandatory do not create or update any report or folder below the Shared Folders Custom
Local Solution CR since updates from Latin America Cloud Local Solution for Costa Rica will overwrite
the files in this folder, every time the upload process be executed.
Verify if BI folders structure required for Costa Rica is already available. In this case, the steps describe in
this section can be skipped and you can follow to the “BI Files Upload to Cloud” steps.
1. Access BI Publisher Enterprise Tool (including /xmlpserver after URL used to access the Cloud
environment). Example: https://XXXX.XX.XXX>.oraclecloud.com/xmlpserver
2. Click on Catalog option
3. Click on Expand Shared Folders option
4. Click on Expand Custom option
5. Under the Custom folder, verify if there is a folder called Local Solution
6. Under the Local Solution folder, verify if there is a folder called CR
/Custom/Local Solution/CR/E-INVOICE
/Custom/Local Solution/CR/E-INVOICE/Process
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
9
CREATE BI FOLDERS STRUCTURE
If the structure required for Costa Rica is not available, create it. The steps below assumes the Local
Solution folder is not available but you must follow the steps according the structure available in your
environment.
5. Under the folder Custom, create a new folder called Local Solution. To do that, click on Create
icon.
6. Choose the Folder option
Enter the name exactly as bellow and press Create button.
Create Local Folder Solution
*Folder Name Local Solution
BI PUBLISHER FILES
This step requires you have downloaded the pack, has created the Pack stage area and had the BI Folders
Structure created.
Who are installing or updating LACLS for Costa Rica must upload files with the extension “xdoz” and
“xdmz” files in order to have BI Reports running successfully.
XML Canonical for Electronic Invoice – Control Panel Layout Template “xdoz”:
1. Pack source files: <PACK_PATH>\CR\E-INVOICE\CA\BI\template\ESA
2. BI destination Folder: /Shared Folders/Custom/Local Solution/CR/E-INVOICE
XML Canonical for Electronic Invoice – Control Panel Data Model “xdmz”:
1. Pack source files: <PACK_PATH>\CR\E-INVOICE\CA\BI\datamodel
2. BI Destination Folder: /Shared Folders/Custom/Local Solution/CR/E-INVOICE/Data Models
XML Canonical for Electronic Invoice – XML Extractor Layout Template “xdoz”:
3. Pack source files: <PACK_PATH>\CR\E-INVOICE\CA\BI\Process\template
4. BI destination Folder: /Shared Folders/Custom/Local Solution/CR/E-INVOICE/Process
XML Canonical for Electronic Invoice – XML Extractor Data Model “xdmz”:
3. Pack source files: <PACK_PATH>\CR\E-INVOICE\CA\BI\Process\datamodel
4. BI Destination Folder: /Shared Folders/Custom/Local Solution/CR/E-INVOICE/Process/Data
Models
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
11
BI FILES UPLOAD TO CLOUD
1. Access BI Publisher Enterprise Tool (including /xmlpserver after URL used to access the Cloud
environment). Example: https://XXXX.XX.XXX>.oraclecloud.com/xmlpserver
2. Go to /Shared Folders/Custom/Local Solution/CR/E-INVOICE folder and click on Upload
Resource icon
3. Press “Choose File” button and select the file to be uploaded in the following path:
<PACK_PATH>\CR\E-INVOICE\CA\BI\template\ESA\<File Name>.xdoz
Check the “Overwrite existing file” and then Click on the Upload button
IMPORTANT:
In case of a New Installation repeat the previous step for all .xdoz files available in the folder
<PACK_PATH>\CR\E-INVOICE\CA\BI\template\ESA;
In case of Pack Update you may apply only the modified files since your last installation or
update. Make sure to read carefully the Packs’s readme to identify the list of files to be uploaded.
If you don’t have all the packs applied so far then you may need to evaluate the delivered packs
since your last install or update to build a list of files to be updated. In case of doubts upload all
the files available in the folder <PACK_PATH>\CR\E-INVOICE\CA\BI\template\ESA.
4. Click on Expand the folder E-INVOICE to confirm the files were successfully uploaded.
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
12
5. Go to /Shared Folders/Custom/Local Solution/CR/E-INVOICE/Data Models folder and click on
Upload Resource icon
6. Press “Choose File” button and select the file to be uploaded in the following path:
<PACK_PATH>\CR\E-INVOICE\CA\BI\datamodel\<File Name>.xdmz
Check the “Overwrite existing file” and then Click on the Upload button
IMPORTANT:
In case of a New Installation repeat the previous step for all .xdoz files available in the folder
<PACK_PATH>\CR\E-INVOICE\CA\BI\datamodel;
In case of Pack Update you may apply only the modified files since your last installation or
update. Make sure to read carefully the Packs’s readme to identify the list of files to be uploaded.
If you don’t have all the packs applied so far then you may need to evaluate the delivered packs
since your last install or update to build a list of files to be updated. In case of doubts upload all
the files available in the folder <PACK_PATH>\CR\E-INVOICE\CA\BI\datamodel.
7. Click on Expand the folder Data Models to confirm the files were successfully uploaded.
Check the “Overwrite existing file” and then Click on the Upload button
IMPORTANT:
In case of a New Installation repeat the previous step for all .xdoz files available in the folder
<PACK_PATH>\CR\E-INVOICE\CA\BI\Process\template;
In case of Pack Update you may apply only the modified files since your last installation or
update. Make sure to read carefully the Packs’s readme to identify the list of files to be uploaded.
If you don’t have all the packs applied so far then you may need to evaluate the delivered packs
since your last install or update to build a list of files to be updated. In case of doubts upload all
the files available in the folder <PACK_PATH>\CR\E-INVOICE\CA\BI\Process\template.
10. Click on Expand the folder Process to confirm the files were successfully uploaded.
12. Press “Choose File” button and select the file to be uploaded in the following path:
<PACK_PATH>\CR\E-INVOICE\CA\BI\Process\datamodel\<File Name>.xdmz
Check the “Overwrite existing file” and then Click on the Upload button
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
13
IMPORTANT:
In case of a New Installation repeat the previous step for all .xdoz files available in the folder
<PACK_PATH>\CR\E-INVOICE\CA\BI\Process\datamodel;
In case of Pack Update you may apply only the modified files since your last installation or
update. Make sure to read carefully the Packs’s readme to identify the list of files to be uploaded.
If you don’t have all the packs applied so far then you may need to evaluate the delivered packs
since your last install or update to build a list of files to be updated. In case of doubts upload all
the files available in the folder <PACK_PATH>\CR\E-INVOICE\CA\BI\Process\datamodel.
13. Click on Expand the folder Data Models to confirm the files were successfully uploaded.
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
14
CONFIGURATION TASK
In order to provide some specific country legal requirement, some additional information, not available originally
on Oracle ERP Cloud are required. Follow setup details describing how to define each information.
Attention: Some of those Tax Reporting Types may be being shared by other Costa Rica solutions. So, before you
create them check if it already exists.
This tax reporting type will identify the VAT type applied on the Receivables transactions. For MH this information
will identify the Billing Indicator.
Tax
Tax Reporting Type Reporting Data Minimum Maximum Reporting
Tax Reporting Type Code Country
Name Type Type Length Length Type Uses
Purpose
Tax
Costa
LACLS_CR_VAT_CODE LACLS_CR_VAT_CODE reporting Text 1 30 Tax Rate
Rica
type
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
15
MH RATE CODES: LACLS_CR_RATE_CODE
This tax reporting type will classify the tax rate applied on the Receivables transaction.
Tax
Reporting Data Minimum Maximum Reporting
Tax Reporting Type Code Tax Reporting Type Name Country
Type Type Length Length Type Uses
Purpose
Tax
Costa
LACLS_CR_RATE_CODE LACLS_CR_RATE_CODE reporting Text 1 30 Tax Rate
Rica
type
This additional information identify the tax type and must be entered for each tax rate defined to Costa Rica.
Tax
Reporting Data Minimum Maximum Reporting
Tax Reporting Type Code Tax Reporting Type Name Country
Type Type Length Length Type Uses
Purpose
Tax
Costa
LACLS_CR_PRODUCT_TYPE LACLS_CR_PRODUCT_TYPE reporting Text 1 30 Tax Rate
Rica
type
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
16
MH ENVIRONMENT: LACLS_CR_EFD_ENVIRONMENT
Tax Dat
Reportin
Reporting Countr a Minimu Maximu
Tax Reporting Type Code Tax Reporting Type Name g Type
Type y Typ m Length m Length
Uses
Purpose e
Tax Party
LACLS_CR_EFD_ENVIRONMEN LACLS_CR_EFD_ENVIRONMEN Costa Tex
reportin 1 30 tax
T T Rica t
g type profile
COMMON LOOKUPS
The “XML Canonical for Electronic Invoice” solution requires new lookup types to setup and control the process.
Lookup Codes
Lookup Code Enabled Meaning Description Tag
01 Yes Factura Electronica Factura Electronica
04 Yes Tiquete Electronico Tiquete Electronico
03 Yes Nota Credito Electronica Nota Credito Electronica
02 Yes Nota Debito Electronica Nota Debito Electronica
05 Yes Nota de despacho Nota de despacho
06 Yes Contrato Contrato
07 Yes Procedimiento Procedimiento
Yes Comprobante emitido en Comprobante emitido en
08 contigencia contigencia
Yes Factura electrónica de Factura electrónica de
09 exportación exportación
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
17
REFERENCE DOCUMENT CODE: LACLS_CR_EFD_REF_CODE
Determine the reference code for credit memo’s transaction.
Functional
LACLS_CR_EFD_REF_CODE LACLS_CR_EFD_REF_CODE LACLS_CR_EFD_REF_CODE Setup
Manager
Lookup Codes
Lookup Code Enabled Meaning Description Tag
Anula Documento de
Yes
1 Referencia. Anula Documento de Referencia.
Corrige texto documento
Yes
2 de referencia. Corrige texto documento de referencia.
3 Yes Corrige monto. Corrige monto.
Referencia a otro
Yes
4 documento. Referencia a otro documento.
Sustituye comprobante
Yes provisional por Sustituye comprobante provisional por
5 contingencia. contingencia.
99 Yes Otro Otro
Functiona
LACLS_CR_PAYMENT_CONDITION LACLS_CR_PAYMENT_CONDITION LACLS_CR_PAYMENT_CONDITION l Setup
Manager
Lookup Codes
Lookup Code Enabled Meaning Description Tag
01 Yes Efectivo. Efectivo.
02 Yes Tarjeta. Tarjeta.
03 Yes Cheque. Cheque.
Transferencia – depósito
Yes
04 bancario. Transferencia – depósito bancario.
05 Yes Recaudado por terceros. Recaudado por terceros.
Otros (se debe indicar el
Yes
99 medio de pago). Otros (se debe indicar el medio de pago).
Functional
LACLS_CR_REF_DOC_TYPE LACLS_CR_REF_DOC_TYPE LACLS_CR_REF_DOC_TYPE Setup
Manager
Lookup Codes
Lookup Code Enabled Meaning Description Tag
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
18
01 Yes Factura electrónica Factura electrónica
02 Yes Nota de débito electrónica Nota de débito electrónica
03 Yes Nota de crédito electrónica Nota de crédito electrónica
04 Yes Tiquete electrónico Tiquete electrónico
05 Yes Nota de despacho Nota de despacho
06 Yes Contrato Contrato
07 Yes Procedimiento Procedimiento
Yes Comprobante emitido en
08 contingencia Comprobante emitido en contingencia
09 Yes Devolución mercadería Devolución mercadería
Yes Sustituye factura rechazada Sustituye factura rechazada por el Ministerio
10 por el Ministerio de Hacienda de Hacienda
Yes Sustituye factura rechazada
por el Receptor del Sustituye factura rechazada por el Receptor
11 comprobante del comprobante
Yes Sustituye Factura de
12 exportación Sustituye Factura de exportación
13 Yes *Facturación mes vencido *Facturación mes vencido
Yes Comprobante aportado por
contribuyente del Régimen Comprobante aportado por contribuyente del
14 de Tributación Simplificado Régimen de Tributación Simplificado
Yes Sustituye una Factura
15 electrónica de Compra Sustituye una Factura electrónica de Compra
99 Yes Otro Otro
Functional
LACLS_CR_ESTABLISH_NUMBER LACLS_CR_ESTABLISH_NUMBER LACLS_CR_ESTABLISH_NUMBER Setup
Manager
Lookup Codes
Lookup Code Enabled Meaning Description Tag
001 Yes Establecimiento 001 Establecimiento 001
002 Yes Establecimiento 002 Establecimiento 002
003 Yes Establecimiento 003 Establecimiento 003
004 Yes Establecimiento 004 Establecimiento 004
005 Yes Establecimiento 005 Establecimiento 005
Functional
LACLS_CR_BILLING_POINT LACLS_CR_BILLING_POINT LACLS_CR_BILLING_POINT Setup
Manager
Lookup Codes
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
19
Lookup Code Enabled Meaning Description Tag
00001 Yes Punto 00001 Punto 00001
00002 Yes Punto 00002 Punto 00002
00003 Yes Punto 00003 Punto 00003
00004 Yes Punto 00004 Punto 00004
00005 Yes Punto 00005 Punto 00005
Functional
LACLS_CR_INCONTERMS LACLS_CR_INCONTERMS LACLS_CR_INCONTERMS Setup
Manager
Lookup Codes
Lookup Code Enabled Meaning Description Tag
EXW Yes EXW Ex Works (insert place of delivery)
FCA Yes FCA Free Carrier (Insert named place of delivery)
FAS Yes FAS Free Alongside Ship (insert name of port of
loading)
FOB Yes FOB Free on Board (insert named port of loading)
CFR Yes CFR Cost and Freight (insert named port of
destination)
CIF Yes CIF Cost Insurance and Freight (insert named port
of destination)
CPT Yes CPT Carriage Paid to (insert place of destination)
CIP Yes CIP Carriage and Insurance Paid To (insert place of
destination)
DDP Yes DDP Delivered Duty Paid (Insert place of
destination)
DAP Yes DAP Delivered at Place (insert named place of
destination)
DAT Yes DAT
ZZZ Yes ZZZ
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
20
Lookup Type Meaning Description Module
Functional
LACLS_CR_EFD_STATUS LACLS_CR_EFD_STATUS LACLS_CR_EFD_STATUS Setup
Manager
Lookup Codes
Lookup Code Enabled Meaning Description Tag
SENT Yes Enviado Enviado
APPROVED WITH Aceptación parcial Aceptación parcial
Yes
WARNING
APPROVED Yes Aceptado Aceptado
ERROR Yes Rechazado Rechazado
REJECTED Yes Rechazado Rechazado
FIXED Yes Solucionado Solucionado
PROCESSING Yes Procesando Procesando
Example:
Functional
LACLS_CR_EFD_STATUS LACLS_CR_EFD_STATUS LACLS_CR_EFD_STATUS Setup
Manager
Lookup Codes
Lookup Code Enabled Meaning Description Tag
SENT Yes Enviado Enviado
APPROVED WITH Aceptación parcial Aceptación parcial
Yes
WARNING
ERROR Yes Rechazado Rechazado Y
In the example above, the transactions with status ERROR will be captured by the BI Extractor along with the
new transactions.
Functional
LACLS_CR_PAYMENT_TERMS LACLS_CR_PAYMENT_TERMS LACLS_CR_PAYMENT_TERMS Setup
Manager
Lookup Codes
Lookup Code Enabled Meaning Description Tag
01 Yes Contado Contado
02 Yes Credito Credito
03 Yes Consignacion Consignacion
04 Yes Apartado Apartado
Arrendamiento con opción
Yes
05 de compra. Arrendamiento con opción de compra.
Yes Arrendamiento en función
06 financiera. Arrendamiento en función financiera.
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
21
Yes Otros (se debe indicar la Otros (se debe indicar la condición de la
99 condición de la venta). venta).
Functional
LACLS_CR_MH_PAYMENT_TERM LACLS_CR_MH_PAYMENT_TERM LACLS_CR_MH_PAYMENT_TERM Setup
Manager
Lookup Codes
Lookup Code Enabled Meaning Description Tag
<Value
<Enter a Payment Valid for
Term Name or a Yes MH>
Transaction Class <Meaning for the information Exemplo:
Name> entered in the lookup code> 01, 02
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
22
E-INVOICE CONDICTION: LACLS_CR_EINVOICE_CONDITION
Determine the condition accord MH list.
Functional
LACLS_CR_EINVOICE_CONDITION LACLS_CR_EINVOICE_CONDITION LACLS_CR_EINVOICE_CONDITION Setup
Manager
Lookup Codes
Lookup Code Enabled Meaning Description Tag
1 Yes Normal Normal
2 Yes Contingencia Contingencia
3 Yes Sin internet Sin internet
Functional Setup
LACLS_CR_UOM_CODES LACLS_CR_UOM_CODES LACLS_CR_UOM_CODES
Manager
Lookup Codes
Lookup Code Enabled Meaning Description Tag
<ERP UOM Code> Yes <ERP UOM Code> <MH Description> <MH UOM Code>
Functional
LACLS_CR_PRODUCT_CODE_MH LACLS_CR_PRODUCT_CODE_MH LACLS_CR_PRODUCT_CODE_MH Setup
Manager
Lookup Codes
Lookup Code Enabled Meaning Description Tag
<Código de la Lookup Code
Yes del Cross Reference del
01 Item> Codigo del Producto del Vendedor
<Código de la Lookup Code
Yes del Cross Reference del
02 Item> Codigo del Producto del Comprador
<Código de la Lookup Code
Yes del Cross Reference del
03 Item> Codigo de Producto Asignado por la Industria
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
23
04 Yes INV Item Code Codigo de Uso Interno
<Código de la Lookup Code
Yes del Cross Reference del
99 Item> Otros
Example:
In the example below the Inventory Item Code will be identified in the XML by the code “04” value
“100SMCH1JET2ML” and the Cross Reference BARCODE value will be identified in the XML by the code “03” value
“123456789”.
This Lookup information is necessary to identify the Descriptive FlexField (DFF) context chosen by the
implementation project to segregate the Costa Rica information that need be store in DFFs.
It will be the context entered on this lookup that will be used to write DFFs for the solutions that
generate DFF automatically. For example: XML Canonical for Electronic Invoice.
For the DFFs already created using a different context value from the one entered on this lookup, the
solution will keep the original context during the process that update the DFFs.
Important:
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
24
Considering a specific Descriptive Flexfield, it is possible to have as many Contexts as desired, however,
in this situation, all LACLS_CR information need to be configured to be store in the same ATTRIBUTE
column, in all different Contexts created.
Lookup Type Meaning Description Module
Descriptive Flexfield
LACLS_DEFAULT_CONTEXT LACLS_DEFAULT_CONTEXT Default
Functional Setup Manager
Lookup Codes
Lookup Code Enabled Meaning Description Tag
CR Yes Costa Rica Costa Rica
Our suggestion is use the Country name “Costa Rica” as context; however, it can be chosen any value
according project specification. In this case, the context chose must be entered on the fields “Meaning”
and “Description”. The fields “Lookup Code” must be entered as “CR” and the “Display Sequence” a
unique value.
STANDARD LOOKUPS
The information will be used to identify the customer and Supplier registration type.
Attention: Some of these Lookup Types may be being shared by other Costa Rica solutions. So before you create
them check if it already exists.
Warning:
If accessing ERP using English language use “Manage Standard Lookups” task to create/update
ZX_REGISTRATIONS_TYPE Lookup Type.
If accessing ERP using any other language different from English, use “Manage Tax Lookup Codes” task to
create/update ZX_REGISTRATIONS_TYPE Lookup Type.
Common
Type to indicate if the party is
ZX_REGISTRATIONS_TYPE Party Registration Type
registered with the tax authority
Tax
Components
Lookup Codes
Lookup Code Enabled Meaning Description Tag
Note: The “Tag” field should be filled with the document code considered by the MH.
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
25
VALUE SETS
Some value sets will be required for the Descriptive Flexfield creation.
Attention: Some of these Value Sets may be being shared by other Costa Rica solutions. So before you create check
if it already exists.
To create a new value set execute the following steps:
1) Open the application and select the “Setup and Maintenance” task group.
2) Search and select the task “Manage Value Sets”.
3) Click on the “Create” button, insert a new value set fields and “Save”.
The following Value Sets are required:
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
26
PAYMENT CONDITION: LACLS_CR_PAYMENT_CONDITION
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
27
ID Column Named LOOKUP_CODE
WHERE Clause LOOKUP_TYPE = 'LACLS_CR_ESTABLISH_NUMBER'
AND TRUNC(SYSDATE) BETWEEN
TRUNC(NVL(START_DATE_ACTIVE,SYSDATE)) AND
TRUNC(NVL(END_DATE_ACTIVE,SYSDATE)) AND ENABLED_FLAG = 'Y'
Order By LOOKUP_CODE
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
28
INVOICE STATUS: LACLS_CR_EFD_STATUS
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
29
ID Column Named substr(ecv.CATEGORY_CODE,1,20)
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
30
DESCRIPTIVE FLEXFIELDS
Given the dynamic characteristic of some legal information the LACLS use the Descriptive Flexfield (DFF)
concepts to configure the tax authority requirements. One highlight point that needs to keep in mind is
that the flexfield name must define according to the LACLS guidelines.
IMPORTANT:
1) You must enter the Descriptive Flexfield Name exactly as requested since it is used to identify the
additional information.
After Descriptive Flexfield has been created, save it and press button Deploy Flexfield.
6. Select the context “Costa Rica” in the “Context Sensitive Segments” area click on the “Create” button to
add new segments:
Context Code Costa Rica or use some According Project Team definition
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
31
Data Type Character Character Character
Table Column Any Available Attribute column Any Available Attribute column Any Available Attribute column
Value Set GL_20_CHARACTERS GL_150_CHARACTERS LACLS_CR_EFD_STATUS
Required No No No
Prompt Fecha de Recibo Clave Estado Electronic Invoice
Display Type Text Box Text Box List of Values
Display Size 12 20 10
Read Only Yes Yes Yes
BI Enabled Yes Yes Yes
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
32
3. On the field “Flexfield Code” inform “RA_CUST_TRX_TYPES” and press search button.
4. On Search Results area Press Edit icon.
5. Check if the context “Costa Rica” already exists in the “Context Sensitive Segments” area. If the context
“Costa Rica” does not exists yet, create a new context clicking on the “Manage Contexts” and “Create”
buttons. If the context “Costa Rica” already exists go to the next step. To create a new context fill the fields
as follow:
Display Name Costa Rica
Description Costa Rica
Context Code Costa Rica
API Name Maintain the name create by the application
Enabled Yes
6. Select the context “Costa Rica” in the “Context Sensitive Segments” area click on the “Create” button to
add new segments:
SEGMENT 7 SEGMENT 8
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
33
Sequence 70 80
Name LACLS_CR_ESTABLISH_NUMBER LACLS_CR_BILLING_POINT
Code LACLS_CR_ESTABLISH_NUMBER LACLS_CR_BILLING_POINT
Description Numero Establecimiento Terminal o Punto de Emisión
API Name Maintain the suggested name Maintain the suggested name
Enabled Yes Yes
Data Type Character Character
Table Column Any Available Attribute column Any Available Attribute column
Value Set LACLS_CR_ESTABLISH_NUMBER LACLS_CR_BILLING_POINT
Required No No
Prompt Numero Establecimiento Terminal o Punto de Emisión
Display Type List of Values List of Values
Display Size 20 20
Read Only Yes Yes
BI Enabled Yes Yes
PARTY SITES
SEGMENT 1 SEGMENT 2
Sequence 10 20
Name LACLS_CR_ECONOMIC_ACTIVITY LACLS_CR_INCONTERMS
Code LACLS_CR_ECONOMIC_ACTIVITY LACLS_CR_INCONTERMS
Description Actividad Economica Codigo Incoterm
API Name Maintain the suggested name Maintain the suggested name
Enabled Yes Yes
Data Type Character Character
Table Column Any Available Attribute column Any Available Attribute column
Value Set GL_20_CHARACTERS LACLS_CR_INCONTERMS
Required No No
Prompt Actividad Economica Codigo Incoterm
Display Type Text List of Values
Display Size 10 20
Read Only Yes Yes
BI Enabled Yes Yes
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
34
NOTE: The economic activities must loaded writing the activity code delivery by INEC.
Example: 4721
For review all economic activities please go to INEC ‘INSTITUTO NACIONAL DE ESTADÍSTICA Y CENSOS’ web site
https://www.inec.cr/documento/inec-2011-clasificacion-de-actividades-economicas-de-costa-rica-manual-de-
rama-de
*always confirm review the website because INEC can be updated the list or update the link
LOCATIONS
SEGMENT 1 SEGMENT 2
Sequence 10 20
Name LACLS_CR_PHONE_NUMBER LACLS_CR_ISSUER_EXP_CODE
Code LACLS_CR_PHONE_NUMBER LACLS_CR_ISSUER_EXP_CODE
Description Número Teléfono Codigo Exportador
API Name Maintain the suggested name Maintain the suggested name
Enabled Yes Yes
Data Type Character Character
Table Column Any Available Attribute column Any Available Attribute column
Value Set GL_20_CHARACTERS GL_20_CHARACTERS
Required No No
Prompt Número Teléfono Codigo Exportador
Display Type Text Box Text Box
Display Size 20 20
Read Only Yes Yes
BI Enabled Yes Yes
MEMO LINE
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
35
1. Go to “Setup and Maintenance” task.
2. Search and select the task “Manage Descriptive Flexfields”.
3. On the field “Flexfield Code” inform “c” and press search button.
4. On Search Results area Press Edit icon.
5. Context Code
If a Memo Line can be used in different Countries, it is not possible create the DFFs under a “Costa Rica”
Context since one country can subscribe the DFFs from other country.
Please verify the best approach according customer characteristics to decide if the DFF Context DFF can be
used or not.
6. After have decided for create Context or not, create the segments as follow:
Flexfield Name Flexfield Code Description
Memo Lines AR_MEMO_LINES Fields for memo line details on the memo line age.
Context Code Use or Not According Project Team definition
SEGMENT 1 SEGMENT 2
Sequence 10 20
Name LACLS_CR_CABYS_CODE LACLS_CR_DUTY_ITEM
Code LACLS_CR_CABYS_CODE LACLS_CR_DUTY_ITEM
Description Categoria Cabys Partida Arancelaria
API Name Maintain the suggested name Maintain the suggested name
Enabled Yes Yes
Data Type Character Character
Table Column Any Available Attribute column Any Available Attribute column
Value Set LACLS_CR_CABYS_CODE LACLS_CR_DUTY_ITEM
Required No No
Prompt Categoria Cabys Partida Arancelaria
Display Type List of Values List of Values
Display Size 20 20
Read Only Yes Yes
BI Enabled Yes Yes
INVOICE LINE
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
36
API Name Maintain the name create by the application
Enabled Yes
6. Select the context “Costa Rica” in the “Context Sensitive Segments” area click on the “Create” button to
add new segments:
Flexfield Name Flexfield Code Description
SEGMENT 1 SEGMENT 2
Sequence 10 20
Name LACLS_CR_CABYS_CODE LACLS_CR_DUTY_ITEM
Code LACLS_CR_CABYS_CODE LACLS_CR_DUTY_ITEM
Description Categoria Cabys Partida Arancelaria
API Name Maintain the suggested name Maintain the suggested name
Enabled Yes Yes
Data Type Character Character
Table Column Any Available Attribute column Any Available Attribute column
Value Set LACLS_CR_CABYS_CODE LACLS_CR_DUTY_ITEM
Required No No
Prompt Categoria Cabys Partida Arancelaria
Display Type List of Values List of Values
Display Size
Read Only No No
BI Enabled No No
In this topic will be treated a flexfield define at FND Lookups level. Information setup in this flexfield will
be used to store the Payment Term valid according MH values.
8. Save
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
37
9. After Context Code has been created, start creating the flexfields under FND_LOOKUPS_VALUES_B.
10. Select the context “LACLS_CR_MH_PAYMENT_TERM” in the “Context Sensitive Segments” area click on the
“Create” button to add new segments:
Flexfield Name Flexfield Code Description
Lookup values
descriptive FND_LOOKUP_VALUES_B Fields for lookup information.
flexfield
Context LACLS_CR_MH_PAYMENT_TERM
SEGMENT 1
Sequence 10
Name LACLS_CR_MH_PAYMENT_TERM
Code LACLS_CR_MH_PAYMENT_TERM
Description Termino de Pago MH
API Name Maintain the suggested name
Enabled Yes
Data Type Character
Table Column ATTRIBUTE1
Value Set LACLS_CR_PAYMENT_TERMS
Required No
Prompt Termino de Pago MH
Display Type List of Values
Display Size
Read Only No
BI Enabled No
In order to identify the Inventory Item Type, Cabys and duty is necessary indicating item type catalogs. LACLS for
Costa Rica will use the Catalog functionality.
Creating Catalog:
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
38
Start Date 1/1/01 1/1/01
End Date
Assign items to leaf level
Y Y
categories only
Allow multiple item category
Y Y
assignments
Public Y Y
Example:
GEOGRAPHY LOOKUP
Costa Rica requirements may require some kind of information not available in the ERP UIs. Thinking of
it, Oracle created the Manage Geography Lookups solution, which allows to treat specifics requirements
and use them to control anything you need.
Lookup Code
Lookup Code LACLS_CR_GEOGRAPHY_CODES
Enabled Yes
Meaning Costa Rica Codigo MH
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
39
Description Costa Rica Codigo MH
Tag C
Repeat these actions for all Province, Canton, District and Neighborhood required.
Example:
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
40
ENTERING LACLS ADDITIONAL INFORMATION
After create the application components required by the “XML Canonical for Electronic Invoice” solution (DFFs,
value sets, lookup types and tax reporting types) is necessary to assign those components to the taxes, transactions,
invoices, customers and suppliers, at the end, assign value to each level where additional information will be stored.
This activities should be performed by the Oracle ERP users.
DESCRIPTIVE FLEXFIELDS
RECEIVABLES TRANSACTION
Descriptive flexfields were created on the header of the Receivables Transaction to be used to generate and control
Electronic Invoice process.
Clave Autorización
This DFF will be filled automatically when the transaction is retrieved by third party.
Fecha Autorización
This DFF will be filled automatically when the transaction is retrieved by third party. The format
accepted is something like this: 2020-10-16 15:05:34.
Status
This DFF storages the process status having the following valid values:
Null – Indicates that it is a new transaction; that has not been captured by the EFD
Electronic Invoice process yet.
SENT - Indicates that the transaction has been sent to third party.
PROCESSING – Indicates that the transaction is under processing by third party.
ERROR - Indicates that the transaction has been rejected by MH. In this case the “EFD
Message” will be filled with the error explanation (just the first 150 characters).
FIXED – Status created just to indicate that the transaction has already been setup with
ERROR status, however was changed and may be sent once again.
APPROVED WITH WARNING - Indicates that the electronic fiscal document has been
approved by MH with warnings.
APPROVED - Indicates that the electronic fiscal document has been approved by MH. In
this case the Clave Autorización has been filled with a valid UUID.
REJECTED - Indicates that the transaction was cancelled and should be discarded by the
EFD Electronic Invoice process.
This DFF will be filled auto automatically when the electronic fiscal document be approved by MH.
Mensaje CFE
This DFF must be filled with the error message, in cases the EFD be rejected by MH, or with other
relevant message. This DFF will be filled automatically when the transaction is retrieved by third party.
Condicion de Pago
This descriptive flexfield must be informed for Transactions and indicate the payment condition.
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
41
Codigo Documento Referencia
Incoterms
Each Receivables Transaction Type should have registered in the additional information fields if it will be considered
or not as an electronic invoice to be sent to MH.
Electronic Invoice
Indicates transaction that must be considered an electronic fiscal document. It means that
transaction assigned with Yes in this flexfields will be eligible to be retrieved in the BI
Extractor.
Condicion de Pago
This descriptive flexfield must be informed for Transactions and indicate the payment condition.
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
42
Correo Notificacion Errores
This descriptive flexfield must be informed for send an email with MH errors. This must delivered by
third party.
Numero Establecimiento
This descriptive flexfield must be informed for indicate the invoice establishment number.
Punto de Emision
This descriptive flexfield must be informed for indicate the invoice billing point.
LOCATIONS
This flexfield must be configured to provide Legal Entity information related to Exportation transactions.
Codigo Exportador
It indicates the Code assigned by MH to Legal Entity, allowing the company acts as a Exporter.
PARTY SITES
Descriptive Flexfields defined at Customer Sites level.
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
43
This information will be used for indicate the economic activity.
MEMO LINES
It indicates if the Memo Line represents a specify duty, use only for export.
It indicates if the Line represents a specify duty, use only for export.
NOTE: The References Line Discount ‘Linea Referencia del Descuento’ will selected accord lines with same
description, same inventory item and different sign amount:
Invoice STANDAR/ DEBIT line with negative amount and CREDIT lines with positive amount.
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
44
TAX REPORTING TYPES
This tax reporting type will identify the tax code, please follow the steps:
This tax reporting type must be assigned to Tax Rate in order to classified the Rate Code is being setup:
This tax reporting type must be assigned to Tax Rate in order to identify the Product Type.
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
45
5. Navigate to Tax Reporting Type Code folder
6. Click on Add Row icon. Then, enter with Tax Reporting information
This tax reporting type must be assigned to legal entity in order to classify the environment:
In order to identify the Inventory CABYS and Duty codes, will be necessary to link Catalogs LACLS_CR_CABYS_CODE
and LACLS_CR_DUTY_ITEM with Inventory Items Catalog setup.
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
46
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
47
MONITORING PROCESS
It is possible monitoring the Receivables transactions handled by the “XML Canonical for Electronic Invoice”
solution. The monitoring can be done individually through transaction descriptive flexfields or through the Panel
tool.
To monitoring the Receivables transactions individually:
1. Go to Receivables > Billing.
2. Search and edit the desired transaction.
3. The EFD descriptive flexfields can be viewed under Miscellaneous area
The monitoring of the cycle of creation, sending and return of electronic vouchers can be done through report Panel
E-INVOICE.
1. Open the Oracle ERP Cloud application and select the Reports and Analytics task of Tools group
2. Expand the directory where the panel is available (All Folders/Shared Folders/Custom/Local Solution/CR/E-
INVOICE)
3. Click on the object “Panel E-INVOICE.xdoz”
4. Inform the parameters and click on the “Apply” button:
PARAMETERS
OUTPUT
When the process finishes successfully an output file is generated containing information about the
Receivables transactions involved in the XML Canonical for Electronic Invoice process.
The first part of the output file shows a chart with the total of the Receivables transactions retrieved
grouped by the electronic voucher status.
The second part of the output file shows a table containing details of the Receivables transactions.
This output can be exported to the formats PDF, HTML, RTF, Excel or PowerPoint.
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
48
THIRD PARTY INTEGRATION USER AND ROLES
It is mandatory to have a user in Oracle ERP Cloud to allow third party execute:
We recommend be created a specific user to be used as “ERP Third Party Integration User” instead of use
a regular natural person user.
Job Roles
After assign the roles to the third party Integration User, execute the following processes:
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
49
Copyright © 2022, Oracle and/or its affiliates. All rights reserved.
This document is provided for information purposes only, and the contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject
to any other warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or fitness for a particular purpose.
We specifically disclaim any liability with respect to this document, and no contractual obligations are formed either directly or indirectly by this document. This document may not
be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without our prior written permission.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of
SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered
trademark of The Open Group.
LACLS Costa Rica – XML Canonical for Electronic Invoice – User and Functional Implementation Guide
50