3. Diseño PI
- Beatriz Manjarres Gonzalez
Las interfaces necesarias para el proyecto pueden implementadas vía PI son todas síncronas, empleando los siguientes protocolos de comunicación:
Web service: Si el origen es el TCI y el destino ECC.
Abap proxy : si se origen ECC para conectar con TCI.
Desde el ECC siempre se implementará la interfaz creada en PI, utilizando la transacción sproxy.
Por lo tanto, para el proyecto es necesario definir estas 7 interfaces:
Envío de asiento de alta/anulación al TCI
Respuesta de alta/anulación del TCI
Actualización de estado y errores en ECC (Asíncrona)
Además, hay que considerar que la AEAT publica distintos servicios para los distintos tipos de productos:
Establecimientos relacionados con Impuestos de Alcohol y Bebidas Alcohólicas
Establecimientos relacionados con el Impuesto sobre las Labores del Tabaco
Establecimientos relacionados con el Impuesto sobre hidrocarburos
Establecimientos que almacenen y comercialicen productos afectados por Impuestos de bebidas alcohólicas y Labores del Tabaco en el mismo establecimiento. Sin soporte del producto de momento.
Con lo cual para las interfaces 3, 5 y 6 de la lista de interfaces será necesario crear 3 interfaces, una para cada tipo de establecimiento.
1. Envío asiento de alta/anulación al TCI
Sirve para enviar un alta/anulación de asiento al TCI. Esta interfaz se implementará de manera común para los 4 tipos de establecimientos a los que hay que dar soporte. Será una comunicación asíncrona basada en SOAP entre SAP ECC y TCI:
SAP ECC (ABAP PROXY) à SAP PI à (SOAP) TCI
Nomenclatura ESR
SWCV: SC_SII_SILICIE
Namespace: urn:techedgegroup.com:sii:silicie:envios:tci
SI Outbound: SI_OS_EnviaAsiento
SI Inbound: SI_IS_EnviaAsiento
Tipos de datos
La petición recibida desde SAP tendrá el siguiente formato:
Elemento mensaje | Cardinalidad | Descripción |
|---|---|---|
versionSilicie | 1..1 | Versión del Silicie de la AEAT |
tenant | 1..1 | Tenant del cliente |
agrupación | 1..1 | Sociedad / CAE emisor |
origen | 1..1 | ID sistema Origen |
etiqueta | 1..1 | Identificador en SAP |
tipoDocumento | 1..1 | Tipo de Documento de la AEAT enviado. Se podrán indicar cualquiera de los documentos de alta o el de anulación *Ver anexo de documentos posibles |
formatoDocumento | 1..1 | Formato original CSV, XML |
completo | Boolean de archivo completo | |
payload | Base64 del XML Silicie en el formato indicado. |
Nomenclatura IB
Carpetas: SII SILICIE -> ECC -> EnvioAsiento
SAP ECC: Business System que corresponda.
TCI: Crear Business Component BC_TCI_SILICIE
2. Respuesta envío asiento alta/anulación del TCI
Una vez que se ha ejecutado el job de TCI que realiza el envío a la AEAT, TCI debe enviar la respuesta de la AEAT al aplicativo origen que envió el asiento. Esta interfaz se implementará de manera común para los 4 tipos de establecimientos a los que hay que dar soporte. Será una comunicación asíncrona basada en SOAP entre TCI y SAP ECC:
TCI (SOAP) à SAP PI à (ABAP PROXY) SAP ECC
Nomenclatura ESR
SWCV: SC_SII_SILICIE
Namespace: urn:techedgegroup.com:sii:silicie:envios:tci
SI Outbound: SI_OS_Resp_Envio_Asiento
SI Inbound: SI_IS_Resp_Envio_Asiento
Tipos de datos
La respuesta enviada desde TCI tendrá el siguiente formato:
Elemento mensaje | Cardinalidad | Descripción |
|---|---|---|
versionSilicie | 1..1 | Versión del Silicie de la AEAT |
agrupación | 1..1 | Sociedad / CAE emisor |
origen | 1..1 | ID sistema Origen |
etiqueta | 1..1 | Identificador en SAP |
tipoDocumento | 1..1 | Tipo de Documento de la AEAT enviado. Se podrán indicar cualquiera de los documentos de alta o el de anulación *Ver anexo de documentos posibles |
payload | 1..1 | Base64 del XML devuelto por Silicie en el formato indicado. |
bloqueStatus | 1..1 | Bloque con información del estado del proceso |
bloqueStatus-status | 1..1 | Estado de la factura |
bloqueStatus-errorCode | 0..1 | Identificador Error |
bloqueStatus-errorDesc | 0..1 | Descripción de Error |
Nomenclatura IB
Carpetas: SII SILICIE -> ECC -> EnvioAsiento
TCI: Crear Business Component BC_TCI_SILICIE
SAP ECC: Business System que corresponda.
3. Actualización de estado en SAP
Desde el TCI se puede informar de errores y actualizaciones de estados de asientos. Con tal fin se implementa esta interfaz. Será una comunicación asíncrona basada en SOAP entre TCI y SAP ECC:
TCI (SOAP) à SAP PI à (ABAP PROXY) SAP ECC
Nomenclatura IB
SWCV: SC_SII_SILICIE
Namespace: urn:techedgegroup.com:sii:silicie:estados
SI Outbound: SI_OA_ActualizacionEstados
SI Inbound: SI_IA_ActualizacionEstados
Tipos de datos
El mensaje enviado desde TCI tendrá el siguiente formato:
Elemento mensaje | Cardinalidad | Descripción |
|---|---|---|
guid | 1..1 | Identificador único de proceso |
tenant | 1..1 | Tenant del cliente |
group | 1..1 | Sociedad / CAE emisor |
origen | 1..1 | ID sistema Origen |
producto | 1..1 | Identificador del producto |
Status | 1..1 | Estado del proceso |
idError | 0..1 | ID Error |
mensaje | 0..1 | Descripción corta Error |
trace | 0..1 | Traza completa del error |
Nomenclatura IB
Carpeta: SII SILICIE -> ECC -> ActualizaEstado
TCI: Crear Business Component BC_SII_SILICIE
SAP ECC: Business System que corresponda
Avvale 2024