eDocuments

Descripción general de eDocuments

Esta solución se utiliza para crear documentos electrónicos, es decir, para transformar los datos
transaccionales que se crean en el sistema SAP en formatos de intercambio predefinidos y transferirlos
electrónicamente a sistemas externos, como los sistemas de las autoridades judiciales o fiscales.
La solución eDocument le permite cumplir con los requisitos legales en países donde las empresas están
obligadas a generar documentos electrónicamente, como facturas, notas de crédito o débito que se
intercambian entre socios comerciales y/o con las autoridades fiscales locales. Algunos países requieren que
las empresas intercambien datos en un formato específico de intercambio de datos, en la mayoría de los
casos se trata de un archivo XML con estructura y campos predefinidos.
Un procesamiento típico de un documento electrónico consta de los siguientes pasos:
1. Generación de documentos fuente
Los documentos de origen se crean en aplicaciones SAP ERP, como en la Gestión financiera (FI)
o en Comercial (SD).
2. Generación de documentos electrónicos
Una vez contabilizado el documento de origen, el sistema crea una instancia de eDocument en la
base de datos para cada documento de origen.
3. Transmisión de documentos electrónicos a sistemas externos
El proceso de envío de los documentos electrónicos a sistemas externos varía en función de la
variante de solución de documentos electrónicos que implemente y configure en el sistema. Una
vez que envíe el documento electrónico a los sistemas externos, el sistema llamará a un conector
de interfaz para implementar la variante de solución configurada, así como cualquier cambio
específico del cliente que implemente en su sistema.
4. Supervisión del estado de procesamiento de documentos electrónicos
En cualquier etapa del procesamiento de documentos electrónicos, puede verificar el estado de
sus documentos electrónicos. Además, el sistema ofrece una funcionalidad de gestión de errores
que le permite rastrear los problemas que ocurrieron con sus documentos electrónicos durante
los procesos de creación o transmisión.
5. Actualización de SAP ERP con datos de sistemas externos
Una vez que sus documentos han sido procesados por las autoridades fiscales y/o los socios
comerciales, el sistema actualiza la base de datos de SAP ERP con los datos procedentes de los
sistemas externos, como los sellos de tiempo (envío, recepción y aprobación) o los números de
autorización.
Los pasos descritos anteriormente cubren el procesamiento de extremo a extremo de un documento
electrónico. Tiene la opción de implementar todo el proceso utilizando aplicaciones SAP, o puede optar por
implementar partes del proceso utilizando sus propias soluciones o aplicaciones específicas del cliente. Para
obtener más información, consulte Variantes de soluciones de documentos electrónicos.
Los requisitos para la generación de documentos electrónicos varían de un país a otro. Las diferencias suelen
estar relacionadas con el tipo de documentos que se admiten y también con los requisitos legales que existen
para los formatos de archivo de intercambio y el intercambio de mensajes con sistemas externos. Por lo tanto,
para algunos países hay que tener en cuenta diferentes configuraciones y procesos antes y durante la
implementación de la solución seleccionada. Para obtener más información, consulte la documentación de la
solución de documentos electrónicos para los países admitidos.
Variantes de la solución eDocument
Todo el proceso de creación de un documento electrónico comprende pasos de proceso, algunos de los
cuales pueden o deben llevarse a cabo en aplicaciones distintas a SAP ERP. La combinación de estos pasos
del proceso da como resultado variantes de soluciones de documentos electrónicos.
La siguiente tabla muestra las funciones que están disponibles con las diferentes variantes de la solución de
documentos electrónicos.
Funciones Variante de la solución eDocument
Solución básica Solución completa

Manejo de documentos electrónicos Disponible Disponible

Aprovisionamiento de datos en SAP ERP Disponible Disponible

Mapeo de datos al formato de Posible gracias al Disponible

intercambio de datos requerido por la ley desarrollo específico del
cliente

Exportar documentos XML asignados Posible gracias al Disponible

desde SAP ERP desarrollo específico del
cliente

Manejo del estado del proceso Posible gracias al Disponible

desarrollo específico del
cliente

Manejo de errores Posible gracias al Disponible

desarrollo específico del
cliente

Servicio de comunicación con sistemas Posible gracias al Disponible

externos desarrollo específico del
cliente

Firma digital No disponible Disponible

Reenvío de mensajes al receptor No disponible Disponible

correcto

Persistencia de datos en ERP Posible gracias al Disponible

desarrollo específico del
cliente

Disponibilidad por países Chile Chile

Croacia Hungría
Hungría Italia (con capacidades de
Italia comunicación específicas para el
Perú cliente)
Eslovenia Perú
 Funciones Variante de la solución eDocument
España España

Más información
Solución básica de eDocument
Solución completa de documentos electrónicos

Solución básica de eDocument

La solución eDocument Basic le permite crear documentos electrónicos basados en documentos de origen
creados previamente en otras aplicaciones SAP, como la Gestión financiera (FI) o la Distribución comercial
(SD). El sistema hace que el documento electrónico esté disponible para su descarga y posterior
procesamiento por sus propias soluciones.

Nota
Esta variante de la solución de documentos electrónicos requiere la implementación de una solución
específica para el cliente para gestionar la asignación de los datos al formato XML requerido y el envío del
documento electrónico a sistemas externos, como las autoridades fiscales o los socios comerciales.

Para obtener más información, consulte SAP Note 2002415 .

Prerrequisitos
 Ha realizado las parametrizaciones del Customizing necesarias en SAP ERP para el país que
está implementando; Para obtener más información, consulte el Customizing específico de cada
país.
 Ha implementado su propia solución para convertir los datos de los documentos electrónicos al
formato XML requerido y para gestionar la comunicación y el envío de los archivos XML a los
sistemas externos.

Proceso
El procesamiento del documento electrónico cuando se utiliza la solución eDocument Basic se muestra en la
siguiente figura:
1. El documento de origen se crea utilizando una aplicación SAP, como en FI o en SD. Una vez
guardado el documento de origen, el sistema crea una instancia del documento electrónico en la
base de datos.
2. El documento electrónico se envía ejecutando la transacción eDocument
Cockpit (EDOC_COCKPIT).
Para obtener más información, consulte la documentación de ayuda de la aplicación directamente
en el cockpit.
3. El sistema recupera el documento electrónico de la base de datos y llama al conector de interfaz
para implementar el conector de interfaz de documento
electrónico ( EDOC_INTERFACE_CONNECTOR) BAdI. Esta BAdI contiene la implementación
que se conecta a la solución específica del cliente.
4. Su solución específica para el cliente recupera el documento electrónico de la interfaz BAdI, lo
convierte al formato XML requerido y establece la comunicación con los sistemas de las
autoridades fiscales o de los socios comerciales para enviar los archivos XML.
5. También puede implementar su propio proceso para actualizar los documentos electrónicos en la
base de datos SAP con datos procedentes de los sistemas de las autoridades fiscales o de los
socios comerciales. Para ello, utilice el método COMMUNICATE_ACTION de la instancia de
eDocument proporcionada en el conector de interfaz (EDOC_INTERFACE_CONNECTOR BAdI).
2002415 - Electronic Document Processing Framework:
Additional Information about the Basic Solution for
electronic document processing (custom implementation)
SAP Note, Version: 25, Released On: 18.10.2023
Show Changes
DescriptionSoftware Components
References
AttachmentsAvailable Languages
Activar elemento para ir a la sección en la página

Symptom

The Electronic Document Processing Framework (formely known as eDocument

Framework and later Document Compliance Framework) is a generic approach to
create, process, and manage electronic documents. The framework handles
country/region specific requirements for electronic documents regarding format of
messages, processing steps in the end-to-end scenarios of the documents. Source
for the documents may be various documents in the standard applications such as
Sales and Finance.

SAP delivers two approaches to comply with the requirements above mentioned:

 The end-to-end solution that covers the entire process, like collecting the
data, exchanging messages and processing of the responses sent from the
authorities. The end-to-end solution requires a license for SAP Document
and Reporting Compliance.
 The basic solution, which this note is about, enables you to develop your
own logic to generate and process the electronic documents. In this case,
only the data structures relevant to the generation of the electronic
document are made available in an enhancement spot. The customer must
then build the XML file required by the authorities following the official
structure and decide on how to send and track the document.

The list of processes in this SAP Note is final and no new processes will be added.
The basic solution is available only for the following processes of the following
countries/regions:

Country/Region Process Technical Process Description

Name

Chile CLDELNOTE Chile Delivery Note

CLDTE Chile DTE

CLDTESUM Chile Summary DTE

 CLGRDTE Chile Goods Receipt

CLIRDTE Chile Invoice Receipt DTE

CLLEDGER Chile eLedger

CLPULEDG Chile Purchase Ledger

CLSDLEDG Chile Sales Ledger

Croatia HRINV Croatia eInvoice

HRINVOUT Croatia eInvoice (Generic)

France FRINV France eInvoice (Basic)

*B2G only - covering the

requirements from 2018.

Hungary HUTRREG Transport Registration

Italy ITFATTURA eDocument XML Generation

*B2G only - covering the

requirements from 2014.

Kazakhstan KZEWBOUT Kazakhstan eWaybill Outbound

KZMMR Kazakhstan Material Movement

Mexico MXDELN Mexico Delivery Note

MXINVOICE Mexico eInvoice

MXIWTC Mexico Withholding Tax Doc.

MXWTC Mexico Withholding Tax Cert.

Peru PEBOL Peru Boleta

PEBOLSUM Peru Daily Summary Boleta

PECTC Peru Tax Perception Certif.

PEINV Peru eInvoice

 PEVOID Peru Void Document

PEWTC Peru WitholdingTax Certificate

Slovenia SVNCINV Slovenia Cash Invoice

SVNCINVMAS Slovenia Cash Inv mass submiss

SVNCISUM Slovenia Cash Invoice Summary

SVNINV eDocument Slovenia: eInvoice

Spain ESINV Spain eInvoice (Download)

*B2G only

ESWSINV Spain eInvoice (Webservice)

*B2G only

Taiwan TWCERT Taiwan eInvoice

Turkey TRBINV Turkey Basic eInvoice

TRCINV Turkey Commercial eInvoice

TRCONINV Turkey Consumer eInvoice

TRDELN Turkey Delivery Note

TRDLUN Turkey Dlvry Note Unregis. Usr

Regardless which communication option you choose (web services, upload via
website, FTP, etc...), the invoice XML file must always be generated before being
transmitted. This note aims at giving information on how to implement the basic
solution.

Be aware that proxy generation must be repeated and mapping must be adapted
when governments release new versions of the XML.

In the attachment of this note, you find instructions how to install the basic solution
in case you haven't installed the Support Package.

Other Terms
eDocument; electronic Invoice; e-invoice; basic solution; custom implementation;
document compliance, document and reporting compliance, basic enablement

Reason and Prerequisites

Reason:

Several countries and regions have legal requirements that oblige companies to
generate documents such as invoices, credit or debit memos that are to be
exchanged between business partners and/or with the local tax authorities by
electronic means.

Country/Region-Specific Prerequisites:

Italy:

 Create the customizing tables for Italy as described in the attachment

CustTabBasic_Italy.pdf. These tables are necessary for mapping the values
required for the FatturaPA document.

Solution

1) Configuring the system to use the custom implementation

Once the Framework is active for one or more source types, it is necessary to
specify what kind of implementation is being used in the system. This depends on
the company code, as you might want to use different implementations for different
companies:

1. Go to transaction SM30.
2. Choose the Table/View "EDOINTTYPEV".
3. For each company code that will use the customer-specific implementation
add an entry with the country-specific eDocument type and the Interface
Type "CUSTOM" (Customer Specific). This will guarantee that for this
company code and eDocument type, the implementation being used is
customer-specific development.

Note that some countries require multiple eDocument types. You must assign each
document type that is relevant for the country of the company code. Please refer to
the value help of field "eDocument Type" to see a list of all eDocument Types
available.

2) Creating the custom implementation

The Enhancement Spot "ES_EDOCUMENT" was developed to allow customer-

specific implementations to process eDocuments. This enhancement spot contains
the BAdI definition "EDOC_INTERFACE_CONNECTOR". To use this BAdI, you
create a class implementing the interface "IF_EDOC_INTERFACE_CONNECTOR"
and add it to the BAdI Implementations.

1. Go to transaction SE19.
2. Enter “ES _EDOCUMENT” in the Enhancement Spot field and
choose the “Create” button.
3. Enter a name for the Enhancement Implementation and a short text.
4. On the next screen, choose the package and continue. Enter a name
for the BAdI implementation, a class name and select the
“EDOC_INTERFACE_CONNECTOR” BAdI definition. Continue.
5. Enter the package and continue.
6. On the next screen you can find the BAdI Implementations list for the
newly created Enhancement Implementation.
7. Open the Enhancement Implementation that was just created and
click on "Filter Val.". Create a Filter Combination with Filter
"INTERFACE_TYPE", Comparator "=" and Value 1 “CUSTOM”.
8. Combine the previous filter with a second filter using the "AND"
operator. Choose Filter “COUNTRY”, Comparator "=" and choose the
country from the value help that you are implementing. This is to
ensure that this implementation will be custom and valid only for the
country that you have entered.
9. Double click on "Implementing Class". Here the interface methods
can be found. The implementation of method
"IF_EDOC_INTERFACE_CONNECTOR~TRIGGER" is where the
data collected from the source document can be processed. With a
double click on this method, a pop up asks if the implementation
should be created. By choosing "Yes", the code editor opens.

The parameters available on this method are passed by the eDocument

Framework. You have to retrieve the source document data from the eDocument
by calling the "GET_SOURCE" method on the input parameter
"IO_EDOCUMENT". This will return an instance of class "CL_EDOC_SOURCE".
The class "CL_EDOC_SOURCE" contains the method "GET_DATA”, which
returns the actual source document content. Call method "GET_HEADER" to read
the source document header. In the header, the field "SOURCE_TYPE" defines
the source document type. The possible values for this field can be found in table
"EDOSRCTYPE". This table also lists the data structure used for each source
document type. By implementing the "TRIGGER" method and using the
"SOURCE_TYPE" from the header to read the correct data structure, it is possible
to assign the return value of the method "GET_DATA” to that data type (for
example "EDOC_SRC_DATA_FI_INVOICE" for source type "FI_INVOICE"). With
this structure the SD/FI data is available for further processing.

In your implementation, you can call a custom interface to a middleware, a service

provider, a partner software, etc. The parameter "IV_TEST_MODE" indicates if
your implementation is allowed to call the custom interface or not. In case the
parameter "IV_TEST_MODE" is not initial, you must not call the custom interface,
because the interface connector is only executed in test mode. In this case you
should only do a simulation, for example perform basic checks for consistency
on the content of the mapped structures.

The coding to process the source document data might look like this:

DATA: lo_source TYPE REF TO cl_edoc_source,

ls_source_header TYPE edoc_src_header,
ls_fi_invoice TYPE edoc_src_data_fi_invoice,
ls_sd_invoice TYPE edoc_src_data_sd_invoice.

* Get source document data

lo_source = io_edocument->get_source( ).
ls_source_header = lo_source->get_header( ).

CASE ls_source_header-source_type.
WHEN cl_edoc_source_fi_invoice=>gc_src_fi_invoice. "FI Invoice

lo_source->get_data( IMPORTING es_data = ls_fi_invoice ).

* Map from FI structure into custom interface source.

WHEN cl_edoc_source_sd_invoice=>gc_src_sd_invoice. "SD Invoice

lo_source->get_data( IMPORTING es_data = ls_sd_invoice ).

* Map from SD structure into custom interface source.

* [... include other source document types ...]

WHEN OTHERS.

* Error handling for unexpected source document type

ENDCASE.

Afterwards, you can send the eDocument to the interface and/or generate the XML
file:

IF iv_test_mode IS NOT INITIAL.

* Do not call custom interface! Only simulation!

ELSE.
* Call custom interface with mapped source structure

ENDIF.

If you only want to store the generated XML message for the eDocument, you can
include the following coding snippets in the implementation of this method:

1. Define this local variable:

DATA: lv_xml TYPE xstring.
2. [Generate the XML message in the local variable lv_xml (of type xstring)]
3. Use this code to export and store the XML message to the eDocument
table:
GET REFERENCE OF lv_xml INTO ld_data.

io_edocument->communicate_process_step(
EXPORTING iv_process_step = 'SENDEDOC'
iv_interface_guid = 'CUSTOM_XML' "(or use any other ID
that you prefer)
id_data = ld_data ).

Note: Country-specific SAP Notes contain further information on the custom

implementation, if necessary.

3) Generating the XML

Using ABAP Proxies, it is possible to quickly generate an ABAP structure

containing all the fields that must be mapped to the XML document. Using the
official schema (.xsd) from the authorities it is possible to generate a proxy
automatically in the system. You can use report SPROX_XSD2WSDL to generate
a web service definition file (.wsdl). This report is available as of release
SAP_BASIS 700, Support Package 14.

After you have generated a .wsdl file with the report, you must do some small
modifications to the file to be able to use it for the proxy generation:

1. Move the <wsdl:message>...</wsdl:message> section before the

<wsdl:portType>...</wsdl:portType> section.
2. Remove the <xs:import ... /> tag.
3. Remove the <xs:element ref="ds:Signature" minOccurs="0"/> tag.

To generate the ABAP proxy from the .wsdl file, do the following:

1. Go to transaction SE80.
2. Select your customer package where you want to create the proxy object.
3. Right-click on the package and choose Create > Enterprise Service. The
wizard opens.
 4. Select object type 'Service Consumer'. Continue.
5. Select 'External WSDL/Schema'. Continue. (This step might not be
requested, depending on your release.)
6. Select 'Local file'. Continue.
7. Navigate to the .wsdl file you want to upload. Continue.
8. Enter package, prefix and task. Continue.
9. Choose the 'Complete' button.

Once you have generated the proxy from the .wsdl file, you have the target
structure ready and also the transformation objects that convert XML to ABAP and
vice-versa. To get the final XML, it is necessary to process the data retrieved from
the enhancement points and map them to the generated ABAP Proxy structure
accordingly. Finally, the XML transformation objects can be used to convert the
ABAP structure into the final XML. The attachment to this note explains how to
create the tables necessary to complete the mapping.

You can find further information concerning ABAP Proxy generation for Web
Service consumption in the SAP Help Portal: Go to SAP Business Suite > SAP ERP
> 6.0 > ABAP Workbench Tools >Web Services >Consuming a Web Service
>ABAP Proxy Generation or use the link: ABAP Proxy Generation

Please keep in mind that consulting issues (like mapping or proxy issues) fall
outside the scope of SAP Active Global Support under the SAP maintenance
agreement. You can find further details in SAP Note 83020.

Solución completa de documentos

electrónicos
La solución eDocument Full le permite crear documentos electrónicos basados en documentos de origen
creados previamente en otras aplicaciones SAP, como la Gestión financiera (FI) o la Distribución comercial
(SD) y transmitirlos a sistemas externos utilizando el formato requerido.
La solución eDocument Full requiere que implemente el ERP, opción para el complemento de
procesamiento de documentos electrónicos. Este complemento tiene un derecho de uso de tiempo de
ejecución limitado para Application Interface Framework (AIF) y se utiliza para asignar los datos
transaccionales al formato XML requerido.

Nota
Tenga en cuenta que necesita una licencia separada para el complemento. Para obtener más información,
consulte el 2378414 de notas de SAP o póngase en contacto con su ejecutivo de cuentas de SAP.

Hay dos opciones de solución de eDocument Full:

 Solución completa con HCI
Utilice la plataforma de integración en la nube de SAP HANA, el servicio de integración
(HCI) para establecer la comunicación con el sistema externo mediante el uso de servicios web
 para enviar datos desde SAP ERP/SAP AIF y para recibir datos de los sistemas externos. HCI
también da formato a los datos para cumplir con los parámetros del servicio web, firma el
documento digitalmente y establece una conexión segura mediante SSL. Es necesario
suscribirse a la HCI. Para obtener más información, póngase en contacto con su ejecutivo de
cuentas de SAP.
Esta solución está disponible actualmente para Chile, Hungría, Perú y España
 Solución completa con capacidades de comunicación específicas del cliente
Usted implementa su propia solución específica para el cliente para gestionar la comunicación
con los servicios externos.
Actualmente, esta solución solo está disponible para Italia.

Solución completa de documentos

electrónicos con HCI
La solución eDocument Full le permite crear documentos electrónicos basados en documentos de origen
creados previamente en otras aplicaciones SAP, como la Gestión financiera (FI) o la Distribución comercial
(SD) y transmitirlos a sistemas externos utilizando el formato de archivo requerido.
Esta solución de eDocument Full requiere la implementación de lo siguiente:
 ERP, opción para el complemento de procesamiento de documentos electrónicos. Este
complemento tiene un derecho de uso de tiempo de ejecución limitado para Application Interface
Framework (AIF) y se utiliza para asignar los datos transaccionales al formato XML necesario.
Esta solución está disponible actualmente para Chile, Hungría, Perú y España.

Nota
Tenga en cuenta que necesita una licencia separada para el complemento. Para obtener más
información, consulte el 2378414 de notas de SAP o póngase en contacto con su ejecutivo de
cuentas de SAP.
 Plataforma de integración en la nube SAP HANA, servicio de integración (HCI) para
gestionar la comunicación con sistemas externos, así como la mensajería de notificaciones.
Actualmente, esta solución solo está disponible para Italia.

Nota
Tenga en cuenta que debe suscribirse a la plataforma de integración SAP HANA Cloud para
poder utilizar sus servicios. Para obtener más información, póngase en contacto con su ejecutivo
de cuentas de SAP.

Prerrequisitos
Para el país que está implementando, ha hecho lo siguiente:
1. Ha realizado las parametrizaciones del Customizing necesarias para SAP ERP.
2. Ha realizado los ajustes necesarios para AIF.
3. Ha realizado la configuración necesaria para HCI
Para obtener más información, consulte la configuración específica del país para su país.
Proceso
El procesamiento del documento electrónico cuando se utiliza la solución eDocument Full se muestra en la
siguiente figura:

1. El documento de origen se crea utilizando una aplicación SAP, como en FI o en SD. Una vez
guardado el documento de origen, el sistema crea una instancia del documento electrónico en la
base de datos.
2. Para enviar el documento electrónico, ejecute la transacción Crear y enviar documentos
electrónicos (EDOC_COCKPIT).
Para obtener más información, consulte la documentación de ayuda de la aplicación directamente
en el informe.
3. El sistema recupera el documento electrónico de la base de datos y llama al conector de interfaz
para implementar el conector de interfaz de documento electrónico BAdI
(EDOC_INTERFACE_CONNECTOR). Este BAdI llama al tipo de interfaz AIF_PROXY que
permite que el sistema se conecte a AIF.
4. AIF asigna los datos transaccionales al formato XML requerido y guarda los archivos XML.
5. El sistema llama a HCI a través de un proxy ABAP y establece la comunicación con los sistemas
de las autoridades fiscales o de los socios comerciales.
6. HCI procesa el XML para cumplir con los requisitos de comunicación oficiales (como la
codificación y la firma digital del documento electrónico) y activa los servicios web
correspondientes para enviar el archivo XML al sistema externo.
 7. HCI recibe información sobre el estado de la solicitud de los sistemas externos, la transforma en
un formato consumible (decodificando y mapeando el resultado) y la reenvía junto con el
documento electrónico firmado (si corresponde) a AIF y al sistema SAP.
8. El sistema actualiza el documento electrónico en la base de datos con la información enviada
desde los sistemas externos.

Más información
Para obtener más información sobre AIF, consulte la ayuda de la aplicación
en [Link] .
Para obtener más información acerca de HCI, consulte en el portal de ayuda de SAP en http://
[Link] debajo Plataforma Tecnológica SAP HANA Cloud Integration para servicios de datos
.