Especificación Diseño

DISEÑO FUNCIONAL

Detalles del Requerimiento

Descripción ERI-PTP-N-239 Devolución a Consultor Ileana D’ Lima
breve Proveedores PMM
Modulo MM
ID INT. PTP-N-239 Fecha 05/02/2020

BPD BPD-PTP-Logística de Inventario

Como trabajara la integración.

Anexo Perú 05/02/2020
1. Descripción
En esta Integración el Legado PMM enviará a SAP los “Ajustes de Cantidad” (F2Q) sobre aquellas
Recepciones informadas previamente en valor negativo.

Los Ajustes de Cantidad informados por esta Integración deben rebaja la cantidad de recepción, recibida
previamente.

2. Tablas de Homologación
Se deberá trabajar en las siguientes homologaciones, para considerar los valores propios Perú:

Tabla: ZCENTROCORREO

NOMBRE_LEGADO PAIS CORREO NOMBRE

PMM PE correo@Falabella.cl Nombre

3. Detalle
Este Documento representa un Anexo para ampliar la Funcionalidad Actual Sobre PMM Chile a PMM
Perú.

Se requiere el uso de la integración existente en PMM Chile hacia S4HANA sobre los “Ajustes de
Cantidad” (F2Q) para recepciones de proveedores nacionales en valor negativo (rebajan cantidad de
recepción)

Este proceso se realiza en PMM e inicia al momento de registrar el N° de recepción (sesión) en donde el
sistema localiza y despliega todos los datos de esta recepción (N° OC- local - proveedor - detalle de
 Diseño - Integración

productos recibidos, entre otros), al momento de desplegar esta información, se identifica el SKU a
ajustar y se ingresa manualmente en el sistema las unidades realmente recibidas, en donde PMM de
forma automática presenta el ajuste de las unidades a rebajar, mostrando el valor total del ajuste para
esta recepción, una vez realizado el ajuste, PMM de forma interna modifica el inventario realizando los
ajustes al stock.

Una vez realizado el ajuste de cantidad en PMM la Orden de Compra NO libera la cantidad del ajuste
realizado, no cambia su status ni permite seguir recibiendo artículos por la cantidad del ajuste.

4. Alcance
Esta Integración actualmente está siendo utilizada por la Sociedad C059 Chile, se debe extender para la
siguiente Sociedad:
SOC FI RUT DESCRIPCION SAP PAIS
P009 20508565934 HIPERMERCADOS TOTTUS S.A PE
P010 20393864886 HIPERMERCADOS TOTTUS ORIENTE S.A.C PE

5. Validación
Se continúan usando todas las validaciones actuales que existen en PRD, para la integración.

6. TAG – Proxi

Grabación para pruebas en 120:

PMM 239 AJUSTE PERÚ 05.02.2020 15:52:11

Request
 Diseño - Integración

Confirmation

Notification

7. Notificación – Correo
Se continua con el usa de la lista de distribución de correos que será actualizable en el futuro. Esta lista de
distribución debe ser utilizada por la integración para notificar a los usuarios responsables del proceso por
cada sociedad FI respecto del resultado de la integración, este control debe ser supervisado por quien
genere el envío de la Orden de Compra con la finalidad de resguardar que todas hayan sido traspasadas a
SAP. SE USARÁ EL FORMATO ACTUAL DE CORREO QUE EXISTE PARA CHILE.
 Diseño - Integración

Se Solicita que en el asunto del Correo con error se informe: Nro Integración – Sociedad y el Nro.OC, este
último campo se colocará a nivel de detalle debido a que pueden venir varias OC en un mismo envió.

Usuario Mail

Carmen Segura CLSEGURA@falabella.com.pe

Ronald Mayaute RMAYAUTE@falabella.com.pe

Jesus Cordova JCORDOVA@tottus.com.pe

María Pellon mpellony@falabella.com.pe

Mery Camavilca mcamavilcap@falabella.com.pe

Juan Adrian Chavez

Noemi Diaz Quispe

Actualmente el mensaje de error es el siguiente:

Nota: En la solicitud de la ERI de ajustar el mensaje de correo podemos evidenciar que el actual solo
cumple con el NRO. OC, Se Solicita la modificación del asunto del Correo donde se agreguen los siguientes
campos: Nro Integración(<codigoInterfaz>) Sociedad(<Sociedad>) y el Nro.OC(<NumeroPO>).

Asunto: Error en integración NRO INTEGRACIÓN – LEGADO – SOCIEDAD – FECHA

Ejemplo:
Asunto: Error en integración PTP-M-239-PMM-P002-20200205
Detalle Correo:
Id N.
Guid Texto Mensaje
Mensaje Mensaje
911B496744BC0118E0530A170EA180E1 /
ZMM 048 El pedido T000000860 no está registrado en SAP
NRO OC

8. Resultado del Proceso

Se debe almacenar en PO el estado de envío (exitoso o con errores) a SAP
 Diseño - Integración

Si durante el proceso de conversión y validación de datos se identifican errores, el proceso debe ser
suspendido solamente para los ajustes que presenten problemas (no debe contabilizarse nada) y los
errores reportados a los usuarios de la lista de distribución de correos creada para tal fin.

Se usará la gestión de errores actualmente definida en PRD para Chile.

9. Alcance Técnico

Nota:En la ERI piden el campo Centro (Tienda-sucursal) el cual no esta mapeado a nivel del
documento de ajuste de cantidad y no esta visible en la clase de movimiento Y07, por lo que
resulta un cambio de alcance.

C.17 Centro (Tienda-Sucursal) C04 NO Almacenado actualmente en Texto de Posición.

<ORG_LVL_NUMBER>
Para las OC de CrossDockin, en la Recepción (F2)
Legado podrá informar el Código de la Tienda que
tiene el Ajuste según la predistribución.

Si el campo se informa, SAP debe almacenar.

Indicar en Documento DI donde se almacenará

El dato Centro Tienda-Sucursal será enviado en el TAG < Posicion>- <ORG_LVL_NUMBER> y es

opcional.

Lógica:

Si el Centro Tienda-Sucursal es enviado en el Nodo-TAG < Posicion>- <ORG_LVL_NUMBER> se debe

asignar al Campo a GOODSMVT_ITEM-SGTXT de la BAPI_GOODSMVT_CREATE.

Transacción MIGO:
 Diseño - Integración

1.- Comunicación de mensajes empaquetados.

2.- Se debe enviar SYS_GUID hexadecimal por mensaje (Empaquetado)
3.- Cada registro debe tener un identificador estándar del tipo GUID/UUID no superior a 32 caracteres
4.- Si se reenvía el mismo SYS_GUID hexadecimal de Ajuste de cantidad no se contabilizará nuevamente
y se responderá que ya está procesado con el número del ajuste de cantidad generado en SAP
5.- En caso de errores en algún registro del paquete, se contabilizarán todos los ajustes que estén sin
errores y se entregara el detalle del error de aquel ajuste que no se pudo contabilizar, el que puede ser
reenviado desde el legado en otro paquete.
6.- El mensaje de confirmación es a través de un SP publicado en la base del legado

10. Información del sistema legado

Responsable del Jesus Córdova (X) Entrada ( ) Salida
Tipo Interfaz
sistema legado

( ) Síncrona (Ej.: Una consulta) 257 Documentos Mes

(X) Asíncrona Cantidad de
Espera Respuesta (X) Con respuesta Registros
( ) Sin respuesta aproximados

Modo de ejecución () Batch (X) Online Reproceso de errores ( ) Total (X) Delta

Sistema Frecuencia ( ) Anual ( ) Mensual

( ) Semanal ( ) Diario
( ) File (X ) A Pedido
(X) JDBC (Respuesta) ( ) Otro cada 5 minutos
(X) SOAP (Request)
( ) Otros ________________
Cantidad de 17 Campos a ( ) SI
Campos (X) NO
Homologar RCV_DTL_TECH_KEY
 Diseño - Integración

Acción en SAP ( ) NO (X) Nueva ( ) A Convertir

Tipo
(X) SI

Datos Adicionales

Se debe generar una alerta por email en caso de una excepción en la ejecución del WS en una lista de distribución por definir.

Se requiere que si existe una anomalía en la comunicación de PMM con PO se debe enviar un email al responsable del
proceso, con ello se pueden realizar acciones de mitigación.

Se requiere que si existe una anomalía en la comunicación de PO con SAP se debe enviar un email al responsable del proceso,
con ello se pueden realizar acciones de mitigación.

En caso de error funcional se debe guardar un LOG SLG1

Dentro de SAP PO, se debe guardar los documentos con error de manera tal de permitir la re-ejecución de estos documentos
de forma unitaria o masiva.

Se requiere que si existe una anomalía en la comunicación de PMM con PO se debe enviar un email al responsable del
proceso, con ello se pueden realizar acciones de mitigación.

Se requiere que si existe una anomalía en la comunicación de PO con SAP se debe enviar un email al responsable del proceso,
con ello se pueden realizar acciones de mitigación.

Para el caso de los reintentos que son por fallas que no sean funcionales se definirá el siguiente lineamiento
(Guaranteed Delivery)

• Se debe garantizar el envío del Ajuste de Cantidad a SAP. Esto permitirá automatizar el proceso de ajuste,
asegurando el flujo del proceso. Para lograr esto, se almacena un SYS_GUID de mensaje y campo de Status para
determinar que se debe volver a enviar el ajuste de cantidad en caso de no obtener el mensaje de confirmación y en
caso de que el mensaje ya fue procesado en SAP no se debe contabilizar nuevamente y se debe retornar el número
de documento SAP.

El Estatus de los mensajes es “CONFIRMADO” y “ENVIADO”. El estatus cambia a CONFIRMADO cuando se recibe el mensaje de
confirmación desde SAP y debe ser eliminado de la tabla de control de estatus. Para el caso de ENVIADO debe programarse un
job que reenvíe los mensajes que no tienen confirmación. La cantidad debe ser de 5 reintentos con un intervalo de 30 minutos
entre cada intento. Si por algún motivo este patrón no logra la confirmación en el 5to intento se debe enviar una alerta por
parte de PMM que no fue posible realizar el ajuste y se debe revisar los datos con los cuales fue solicitado.

11. Casos de Prueba

Caso Descripción Resultados esperados

1 Ajuste de cantidad para F2 con factura Debe viajar el ajuste de cantidad a SAP, debe ser partícipe al
asociada momento de verificar factura (Factura-Recepción-Ajuste
Cantidad) validar procesamiento de GUIID según reglas de
validación.
 Diseño - Integración

2 Ajuste de cantidad por totalidad de la Debe viajar a SAP y marcar la recepción con un estado distinto para
recepción identificar que se encuentra con ajuste en su totalidad.

3 Ajuste de cantidad a factura cuadrada Enviar mensaje de error a lista de distribución definida

4 Ajuste de cantidad en valor positivo Debe viajar a SAP y notificar esta acción a los usuarios definidos en
la lista de distribución indicando el motivo.
5 Enviar ajuste de cantidad duplicado No debe permitirse el registro en SAP, debe enviar mensaje de error
de esta acción a los usuarios definidos en la lista de distribución
indicando el motivo para su revisión.
6 Enviar ajuste de cantidad con referencia a Debe arrojar mensaje de error estándar de BAPI al no encontrar el
una recepción no existente en SAP documento de entrada en SAP

7 Ajuste de cantidad en dólares Debe viajar el ajuste de cantidad a SAP, debe ser partícipe al
momento de verificar factura (Factura-Recepción-Ajuste Cantidad)
validar procesamiento de GUIID según reglas de validación
8 Ajuste de cantidad a proveedor Debe viajar el ajuste de cantidad a SAP, debe ser
(fuera de la zona de selva) en partícipe al momento de verificar factura (Factura-
Tottus Oriente afecto a IGV Recepción-Ajuste Cantidad) validar procesamiento
de GUIID según reglas de validación
9 Ajuste de cantidad a proveedor (de Debe viajar el ajuste de cantidad a SAP, debe ser
la zona de selva) en Tottus Oriente partícipe al momento de verificar factura (Factura-
inafecto a IGV Recepción-Ajuste Cantidad) validar procesamiento
de GUIID según reglas de validación
10 Legado debe Reenviar a SAP Ajustes SAP PO debe enviar la misma respuesta de la creación
enviados anteriormente de los Ajustes originales
11 Enviar Ajustes desde Legado hacia El resultado esperado es la ejecución de reintentos por
SAP con error de comunicación en parte de Legado
PO

Descripción Peru 06/02/2020

En concordancia a la EFD PTP-M-211 desarrollada para la entrada de mercancías del pedido de
compra en SAP desde el legado PMM (F1), esta integración toma todos y cada uno de los
aspectos relevantes de dicha EFD para llevar acabo la Devolución en SAP, si bien el legado es la
fuente de Datos, la devolución de mercancía se realiza con referencia al pedido de compra y
Entrada de Mercancías previamente creado en SAP.
 Diseño - Integración

Se requiere crear la integración de entrada a S4 HANA teniendo como fuente de información el

sistema PMM, de tal manera que se realice la devolución de mercancías al proveedor logrando
rebajar la cantidad de material recibida en la recepción de mercancías. (Procesos F2Q desde PMM
y Tx: MIGO_GR en SAP)

Con la Operación estándar de SAP se sustenta las necesidades del negocio como se describe líneas abajo:

Necesidad 1: Si el ajuste de cantidad aplica a una factura Cuadrada (Sin diferencia o diferencia dentro del
rango de tolerancia) el ajuste debe pasar a SAP y enviar una notificación a los usuarios definidos en la lista
de distribución para que revise dicha situación y proceda a reversar este ajuste.

Funcionalidad SAP: La acción de enviar a SAP un ajuste de cantidad sobre una entrada de mercancías recae
totalmente en el Legado y los errores que esto pueda causar; mas sin embargo SAP de manera estándar
controla y valida que si una posición ya cuadrada (entiéndase como igualdad en cantidades recibidas y
cantidades facturadas) no se pueda modificar. Retornando un error al legado a través de los canales
definidos en este documento.

Necesidad 2: Si el ajuste de cantidad cuadra la diferencia de la factura, debe actualizar la diferencia y

levantar automáticamente el bloqueo de pago por este motivo.
Soporte SAP: Una vez la posición este cuadrada, SAP de manera automática no levanta el indicador de
bloqueo de la Factura, para ello que se prevee crear un JOB de Fondo que ejecute la transacción MRBR:
Liberar facturas Bloqueadas, el cual se programa para que se ejecute una vez al día de tal manera que
levante el indicador de bloqueo. tomando los parámetros definidos a continuación.

Necesidad 3: Si el ajuste de cantidad no cuadra la diferencia de la factura, debe actualizar la diferencia para
posterior análisis, debe mantener el bloqueo de pago.
 Diseño - Integración

Funcionalidad SAP: Se mantendrá el bloqueo de pago.

Necesidad 4: Si la recepción de pedido no se encuentra asociada a una factura o no tiene factura, el ajuste
deberá viajar a SAP (devolución) y quedar a la espera de su verificación factura, debe formar parte de la
cuadratura cuando sea efectuada. (Factura – Recepción – Ajuste Cantidad).

Funcionalidad SAP: Mientras se cumplan los datos mínimos para el tratamiento de la devolución el sistema
realizara el ajuste, reflejando el movimiento en el historial de la posición.

Necesidad 5: En caso que el ajuste de cantidad sea por el valor total de la recepción (anular EM) el ajuste
deberá viajar a SAP y reversar la entrada inicial.

Funcionalidad SAP: Como tal se realiza un movimiento de devolución que como consecuencia genera una
reversa a la entrada inicial, en el historial de la posición se visualiza un movimiento Y7.

Tratamiento de Errores

Los mensajes de sistema propios de la creación de la Entrada de mercancía deben ser trasmitidos
al sistema de origen para su tratamiento.

Si existen errores en la ejecución del envío se identificará a través de la tx SLG1.

Jerarquía:

Objeto: Z + NEGOCIO + PAIS

SubObjeto: MOVIMIENTOMERCADERIA

Negocio = Se obtiene con la función de BRF+ ZSOCIEDADESPORNEGOCIO entrando con SOCIEDAD

Pais = Tabla T001 - LAND1
MOVIMIENTOMERCADERIA es un valor fijo.

En caso de que suceda un error en SAP PO, tanto para el mensaje de creación como su respuesta,
se tratará de reenviar de manera automática 3 veces cada 5 minutos y luego se deberá solicitar el
reproceso manual desde la herramienta Message Monitor.
Alertas En caso que al realizar la conversión y validación de datos se detecte algún
error, se cancela el proceso y no realiza la EM y mucho menos la
contabilización, se procede a reportada el error al usuario de la lista de
distribución de correos (tabla Z).

En caso de que suceda un error en SAP PO se enviará una alerta a la lista de

distribución Integraciones PO-DEV.
 Diseño - Integración

Requerimientos de Monitoreo
Descripción: Necesidad de la transacción de dejar logs de las tareas realizadas
Se usará el registro estándar en el log de aplicaciones.

En SAP PO se utilizará el monitor estándar para darle seguimiento a los escenarios tanto
satisfactorios como con error.
Otras Consideraciones
No aplica

Lógica de Procesamiento
Flujo del proceso

Antecedentes y supuestos:
 Diseño - Integración

Lógica de Procesamiento
Esta interfaz de entrada parte del supuesto que el pedido de compra en SAP ya está creado y el documento
enviado por el sistema legado, sistema de origen de la interfaz, trae los siguientes datos:

El mensaje XML tiene definidos los siguientes nodos y cardinalidad:

Nodo Padre Nodo Cardinalidad Comentario

(nodo raíz) <EM> 1..1 Documento raíz.
EM <Cabecera> 1..1 Datos de cabecera.
EM <Posición> 1..N Posiciones o Items.

Los elementos que conforman estos nodos son:

Importante: El contenido de todos los tags enviados debe respetar la longitud máxima, así como las
restricciones específicas de valores, todos los campos provenientes del legado para la creación del
documento en SAP son Obligatorios.

Log de aplicaciones:

Todos los mensajes de sistema (informativos, advertencia y error) deben ser registrados en el log de
aplicaciones estándar (transacción SLG1), con su consiguiente código numérico. En caso de que el mensaje
no sea estándar (Z), debe ser generado dentro de una clase de mensaje Z y con un código de error
independiente para cada mensaje. No se debe usar mensajes de sistema genéricos (mensaje 000).
 Diseño - Integración

Lógica de Procesamiento
Clave de Área Nº mensaje Texto mensaje
idioma funcional

ES M7 024 Se ha sobrepasado la cantidad & & del documento de referencia

ES M7 025 La posición se marcará con indicador de entrega final
ES M7 027 La cantidad se ha fijado automáticamente en unidad medida precio pedido
ES M7 031 El pedido & tiene el indicador de borrado &
ES M7 089 Fecha-doc/Fecha-cont se encuentran en diferentes ejercicios
ES M7 093 Selección campo p.cl.movimiento &/cuenta & p.& (&) divergente
ES M7 127 El material & & & está marcado para su borrado
ES M7 160 Cuenta de mayor & está marcada para borrar en la sociedad &
ES M7 163 La última fecha de entrega posible era el &
ES M7 430 El material & & & está marcado p.borrado

** tabla referencial los mensajes y textos pueden varias acorde el error reportado por la BAPI estándar de
SAP.
Todas entradas al log de aplicaciones de este desarrollo deben quedar registradas con la jerarquía definida
anteriormente.

La fecha de expiración de todas las entradas en log de aplicaciones debe corresponder a los lineamientos
del proyecto.

Lógica para el mapeo de campos de la interfaz propiamente dicha

En el mandante 120 está la grabación: SE37: BAPI_GOODSMVT_CREATE

Registro: Devolucion Proveedor PMM
 Diseño - Integración

Lógica de Procesamiento
Parametros BAPI

GOODSMVT_HEADER
PSTNG_DATE
DOC_DATE
REF_DOC_NO
BILL_OF_LADING
HEADER_TXT : “Devolución PMM”
GOODSMVT_ITEM
MOVE_TYPE : Y07
ENTRY_QNT
PO_NUMBER
PO_ITEM
ITEM_TEXT : “Devolución a Proveedores”
MVT_IND : “B”
MOVE_REAS : “0001”
REF_DOC_YR
REF_DOC
REF_DOC_IT

Constantes:
HEADER_TXT=“Devolución PMM”
ITEM_TEXT=“Devolución a Proveedores”
MVT_IND = “B”
MOVE_REAS=“0001”

Los Datos a extraer son:

Paso 1 : Se obtiene la posicion de la entrada de mercancias a partir de la relacion numero de la posicion de

la EM de PMM con respect a la posicion de la EM en SAP que esta consignada en el campo MATDOC-ABLAD.

Select MATDOC- EBELN, MATDOC- EBELP, MATDOC- LFBNR, MATDOC- LFBJA, MATDOC- LFPOS from MATDOC
where <Posicion>-<RCV_DTL_TECH_KEY> = MATDOC-ABLAD and
<Posicion>-<NUMERO_SAP > = MATDOC-LFBNR
If sy-subrc = 0 then
 Diseño - Integración

Lógica de Procesamiento
MATDOC- EBELN move to PO_NUMBER
MATDOC- EBELP move to PO_ITEM
MATDOC- LFBJA move to REF_DOC_YR
MATDOC- LFBNR move to REF_DOC
MATDOC- LFPOS move to REF_DOC_IT

*** Asignar el contenido de los campos obtenidos en el select a la estructura de la tabla para usar en la BAPI.
*** Tener presente que pueden ser varias posiciones las que se van a devolver por documento
*** Después de ejecutar la bapi el número de doc de material obtenido en el proceso se debe enviar como
respuesta a PMM.

Es importante RESALTAR que si al ejecutar el movimiento de material (hacer la devolución de material al

proveedor) la cantidad total recibida del material es 0 (cero) se debe bloquear la posición del pedido en
SAP, para tal efecto usar el código de programación consignado en la integración PTP- 370 “modificación
posición de pedido PMM”

Select EKET- EBELP from EKET where EKET- WEMNG=0 and EKET-EBELP= PO_ITEM
and EKET-EBELN= PO_NUMBER
IF SY-SUBRC = 0 THEN
***Bloquear la posición del pedido identificada en EKET-EBELP
ENDIF

Envío de mensajes de respuesta a PMM.

El objetivo de este mensaje de respuesta es comunicarle al sistema legado el resultado del intento de crear
la Devolución de Mercancía en SAP.

El mensaje de respuesta debe consistir en el envío de la tabla de respuesta que retorno SAP al ejecutar la
BAPI, tabla RETURN.

Si hubiese algún incidente en la comunicación con el legado, este debe ser registrado en el log de
aplicaciones.
 Diseño - Integración

Lógica de Procesamiento
Adicionalmente se debe registrar en el log de aplicaciones un mensaje de sistema informativa con el texto
“&1|Entrada de Mercancía de legado finalizando proceso.”, donde &1 corresponde al número de la Entrada
de mercancía dado por el sistema SAP.

2. Alcance Regional

En la actualidad este sistema legado PMM es usado Por las Sociedades :.

SOC FI RUT DESCRIPCION SAP PAIS

P009 20508565934 HIPERMERCADOS TOTTUS S.A. PE
P010 20393864886 HIPERMERCADOS TOTTUS ORIENTE S.A.C. PE

3. Creación de documento contable

Los documentos contables relativos a este proceso se registran de manera secuencial después de la EM,
es un proceso estándar; esto define que primero se realiza la entrada de mercancía y después la
contabilización del documento, más sin embargo es válido aclarar que no puede darse uno sin el otro.

Se requiere la creación de una lista de distribución de correos que sea actualizable en el futuro. Esta lista
de distribución debe ser utilizada por la integración para notificar a los usuarios responsables del proceso
por cada sociedad FI respecto del resultado de la integración. Así mismo se debe enviar correo a todas las
cuentas de correo que estén asignadas a la sociedad.

Este control debe ser supervisado por quien emita el ajuste en PMM, en este caso “Control de Inventarios”
con la finalidad de resguardar que todos estos ajustes hayan sido traspasados a SAP.

Usuario Mail
Hugo Cid hjcid@tottus.cl
Jorge Cifuentes jecifuentes@tottus.cl
Olga Carrasco ocarrasco@tottus.cl

**** esta opción se deja a criterio del grupo de PO, lo importante es notificar a las personas responsables
bien sea usando una lista de distribución o una tabla Z.

Tablas Z: Estructura tabla.

Id de Tabla ZMMT###
 Diseño - Integración

Lógica de Procesamiento
Denominación
NotificEMLegado
Estructura de la tabla

Key Nombre Campo Descripción Dominio Longitud

X BUKRS Sociedad BUKRS CHAR, 4

NAME_FIRST Nombre del destinatario correo BU_NAME CHAR, 40

SMTP_ADDR Correo Electrónico AD_SMTPADR CHAR, 241

La tabla requiere transacción para su mantenimiento.

LOG de Ejecución:

Dentro del proceso se debe tener un log de ejecución el cual registre todos los eventos, además de validar
que toda la información recibida del legado llego a SAP satisfactoriamente.

Notificación de ejecución

Al terminar el proceso en S4Hana se debe enviar un correo electrónico al usuario designado en la lista de
distribución de correos por sociedad, indicando el log del proceso, como se presenta a continuación:

Correo Modelo:
Proceso Exitoso
Para este caso no se requiere correo, solo se responderá a PMM el número del documento de material
que SAP asigna de manera automática y secuencial a cada una de las devoluciones realizadas a la entrada
de mercancía previamente realizada. (Definición dada por PO).

Proceso con ERROR

Asunto: EM PO Legado PMM sin Exito (dd.mm.aaaa)

Se han identificado los siguientes errores (ejemplos) durante la lectura y procesamiento de los datos enviados.

Numero Pedido Numero Pos PO Nº Texto mensaje

legado Pedido SAP SAP mensaje
 Diseño - Integración

Lógica de Procesamiento
10 024 Se ha sobrepasado la cantidad & & del documento
############ T######### de referencia
10 025 La posición se marcará con indicador de entrega
############ T######### final
10 027 La cantidad se ha fijado automáticamente en
############ T######### unidad medida precio pedido
############ T######### 30 031 El pedido & tiene el indicador de borrado &
30 089 Fecha-doc/Fecha-cont se encuentran en diferentes
############ T######### ejercicios
40 093 Selección campo p.cl.movimiento &/cuenta & p.&
############ T######### (&) divergente
40 123 Ud. carece de autorización de impresión para cl-
############ T######### mov &
############ T######### 50 127 El material & & & está marcado para su borrado
10 132 Para el pedido de cliente & & no es posible movim.
############ T######### de anulación
10 160 Cuenta de mayor & está marcada para borrar en la
############ T######### sociedad &
############ T######### 10 163 La última fecha de entrega posible era el &
20 389 De la cantidad solicitada para material & quedan &
############ T######### & pendientes
############ T######### 30 430 El material & & & está marcado p.borrado

Control de procesamiento:
El sistema S4Hana enviara un identificador único por cada documento a crear en SAP (Doc. Material) que debe ser de
tipo UUID largo de 32 caracteres. Con este dato el mensaje viajará al Legado con un UUID de mensaje que se utilizará
con propósitos de monitoreo y un UUID por cada documento que requiera generar para evitar duplicidad en la
creación de documentos
 Diseño - Integración

Lógica de Procesamiento
 Diseño - Integración

Responsable del Jesus Cordova Tipo Interfaz (X) Entrada ( ) Salida

sistema legado

( ) Síncrona (Ej.: Una consulta) Cantidad de 5000 Entradas Diarias

Espera Respuesta (X) Asíncrona Registros
(X) Con respuesta aproximados
( ) Sin respuesta
Modo de ( ) Batch (X) Online Reproceso de (X) Total ( ) Delta
Ejecución errores
Sistema ( ) File ( ) Anual ( ) Mensual
(X) JDBC (Respuesta) Frecuencia
( ) Semanal ( ) Diario
(X) SOAP (Request) (X) A Pedido
( ) Otros
( ) Otro (¿cuál?) Con una
hora de frecuencia.
Cantidad de Campos a (X) SI
Campos Homologar ( ) NO
(Cuenta Contable, CeCo,
BP)
Acción en SAP Tipo (X) Nueva
( ) NO
( ) A Convertir
(X) SI
Datos
Adicionales
N/A

Pruebas
Caso Descripción Resultados esperados
1 Ajuste de cantidad cuadra Debe contabilizar el documento de ajuste, actualizar
diferencia del documento. diferencia del documento, levantar bloqueo de pago,
validar procesamiento de GUID según reglas de
validación
2 Ajuste de cantidad no cuadra Debe contabilizar el documento de ajuste, actualizar
diferencia del documento. diferencia del documento, mantener el bloqueo de pago,
validar procesamiento de GUID según reglas de
validación
 Diseño - Integración

Caso Descripción Resultados esperados

3 Ajuste de cantidad a documento Debe viajar el ajuste de cantidad a SAP, debe ser partícipe
no contabilizado. al momento de verificar factura (Factura-Recepción-Ajuste
Cantidad) validar procesamiento de GUIID según reglas
de validación
4 Ajuste de cantidad por totalidad Debe viajar a SAP y marcar la recepción con un estado
de la recepción distinto para identificar que se encuentra con ajuste en su
totalidad. (no hay marcas en la recepción se visualiza en el
historial de la posicion)
5 Ajuste de cantidad a factura Debe contabilizar el ajuste y enviar mensaje de error de
cuadrada esta acción a los usuarios definidos en la lista de
distribución indicando el motivo para su revisión.
6 Ajuste de cantidad en valor Debe viajar a SAP y notificar esta acción a los usuarios
positivo definidos en la lista de distribución indicando el motivo.
7 Enviar ajuste de cantidad SAP envía número de documento SAP para ese GUID
duplicado procesado a PMM
8 Enviar ajuste de cantidad con Debe arrojar mensaje de error estándar de BAPI al no
referencia a una recepción no encontrar el documento de entrada en SAP
existente en SAP
 Diseño - Integración

Documentación Técnica – PO
Descripción de interfaz
COD NOMBRE

Tamaño Máximo de
Vertical: Tottus Sistema Origen Sistema Destino
Mensaje (KB)

Destino PMM 15800 registros por

S4H
mensaje

Descripción Desde PMM se envían las devoluciones de mercancía para que sean
registrados en SAP. Luego se envía una confirmación a PMM con el número
SAP generado para los casos de éxito. Para los casos de error se envía la
misma confirmación y adicionalmente se envía un correo a una lista de
distribución mencionando los errores detectados.

Modo Operación Asíncrono

Respuesta Si

Activación Grabar devolucion de mercaderia en PMM

Objeto de Negocio Devolucion Mercaderia

Tipo de Integración PROXY

con SAP

Dirección (con Entrante

respecto a SAP)

Nivel de Complejidad Media

Modo de ejecución Tiempo Real

Periodicidad de Por Demanda

ejecución

Persistencia 7 días

Módulos Impactados MM

Analista Técnico Roxanni Bandres

 Diseño - Integración

Características de la etapa de envío

Etapa de Envío: Grabar movimiento de mercaderia en PMM

Peak Estimado de 5 TPS

Nº Estimado de Mensajes/Día 50
Mensajes/Min 30 Min

Hora de Inicio (si procede) 8am Hora de Fin (si procede) 6pm

Formato Envío (XML, IDOC, Formato Recepción (XML,

XML XML
etc.) IDOC, etc.)

Nº Campos de Mapeo 15 Timeout (si procede) 10seg

Características de la etapa de respuesta (si procede)

Etapa de Respuesta: Al registrar el movimiento de mercaderia en SAP

Peak Estimado de 5 TPS

Nº Estimado de Mensajes/Día 50
Mensajes/Min 30 Min

Formato Envío (XML, IDOC, Formato Recepción (XML,

XML XML
etc.) IDOC, etc.)

Nº Campos de Mapeo 5 Timeout 10seg

Definición estructura SAP

Creación de Tipo Base IDOC (si la interfaz se define con IDOC)
Elemento
COD Segmento Tabla Campo Obl. Rep. Descripción
de datos

N/A

Tratamiento de errores de integración (reproceso técnico)

N/A
 Diseño - Integración

Asignación del módulo de funciones de entrada / salida al tipo mensaje

N/A

Acuerdos de interlocutor
N/A

Tratamiento de errores de IDOC

N/A

Definición PROXY
Estructura: ActualizarDevolucionMercaderiaRequest_Inb

Pack Pre
Service Interface SWCV Namespace
age fix
ActualizarDevolucionMercaderi F_I_S4H_LOGISTICAIN urn:Falabella.cl:S4H:LogisticaInventario:De
ZP
aRequest_Inb VENTARIO volucionMercaderia ZPTP
O

Estructura de Datos y Requerimiento de Transformación de Datos.

Numero de Flujo Sistemas Entrada, Salida y Mapeo

001 PMM S4H

Mapeo Proxy -
BAPI.xlsx

Requisitos Especiales.
N° Descripción.

N/A

Definición PROXY
Estructura: ActualizarDevolucionMercaderiaConfirmation_Out

Pack Pre
Service Interface SWCV Namespace
age fix
 Diseño - Integración

ActualizarDevolucionMercaderiaC F_I_S4H_LOGISTICAI urn:Falabella.cl:S4H:LogisticaInventario:D

ZP
onfirmation_Out NVENTARIO evolucionMercaderia ZPTP
O

Estructura de Datos y Requerimiento de Transformación de Datos.

Numero de Flujo Sistemas Entrada, Salida y Mapeo

001 S4H  PMM

PTP-M-239.xlsx

Requisitos Especiales.
N° Descripción.

N/A

Definición PROXY
Estructura: EnviarFalloDevolucionMercaderiaNotification_Out

Pack Pre
Service Interface SWCV Namespace
age fix
urn:Falabella.cl:S4H:LogisticaInventario:D
EnviarFalloDevolucionMercaderia F_I_S4H_LOGISTICAI ZP
evolucionMercaderia ZPTP
Notification_Out NVENTARIO O

Estructura de Datos y Requerimiento de Transformación de Datos.

Numero de Flujo Sistemas Entrada, Salida y Mapeo

001 S4H  EMAIL

PTP-M-239.xlsx

Requisitos Especiales.
N° Descripción.
 Diseño - Integración

N/A

DATOS PROPIOS DE LA INTEGRACION (sección dedicada a consultor PO)

System Landscape Directory.

Product Software Component Technical System Business System
F_PMM F_I_PMM_LOGISTICAINVENTARIO PMM_PE_D PMM_PE_D
F_S4H F_I_S4H_LOGISTICAINVENTARIO F4D S4H120_D
F_PI F_B_PI_LOGISTICAINVENTARIO N/A N/A
F_PI F_A_PI_LOGISTICAINVENTARIO N/A N/A
F_PI F_C_PI_COMMON N/A N/A
F_EMAIL F_I_EMAIL_LOGISTICAINVENTARIO EMAIL_D EMAIL_D

Request

Enterprise Service Repository.

Data Type
Nombre Header
 Diseño - Integración

Namespace urn:Falabella.cl:PI:Common
Software
Component F_C_PI_COMMON
Version
Tipo de
Campo Proxy Largo/Formato Cardinalidad Descripción
Dato
->Header 1..1
Id de mensaje para poder hacer
->->Id_Mensaje string 0..1
seguimiento

Estructura Fecha en que se genera el mensaje con

->->Fecha date yyyy-MM-dd 1..1
formato yyyy-mm-dd

->->Pais string 2 0..1 Valor ISO del País

->->Sociedad string 0..1
Legado que genera el mensaje, ejemplo:
->->Legado string 1..1
PMM

Data Type
Nombre DevolucionMercaderia
Namespace urn:Falabella.cl:PI:LogisticaInventario:DevolucionMercaderia
Software
Component F_B_PI_LOGISTICAINVENTARIO
Version

Estructura
PTP-M-239.xlsx

Message Type
Nombre ActualizarDevolucionMercaderiaRequest
Namespace urn:Falabella.cl:PI:LogisticaInventario:DevolucionMercaderia
Software
Component F_B_PI_LOGISTICAINVENTARIO
Version
Data Type
DevolucionMercaderia
Relacionado
Namespace
data type urn:Falabella.cl:PI:LogisticaInventario:DevolucionMercaderia
relacionado
Target
urn:Falabella.cl:PI:LogisticaInventario:DevolucionMercaderia
namespace
 Diseño - Integración

Service Interface
Nombre ActualizarDevolucionMercaderiaRequest_Out
Namespace urn:Falabella.cl:PMM:LogisticaInventario:DevolucionMercaderia
Software
Component F_I_PMM_LOGISTICAINVENTARIO
Version
Estructura
ActualizarDevolucionMercaderiaRequest
relacionada
Namespace
urn:Falabella.cl:PI:LogisticaInventario:DevolucionMercaderia
relacionado
Categoría Outbound
Modo Asincronico

Service Interface
Nombre ActualizarDevolucionMercaderiaRequest_Inb
Namespace urn:Falabella.cl:S4H:LogisticaInventario:DevolucionMercaderia
Software
Component F_I_S4H_LOGISTICAINVENTARIO
Version
Estructura
ActualizarDevolucionMercaderiaRequest
relacionada
Namespace
urn:Falabella.cl:PI:LogisticaInventario:DevolucionMercaderia
relacionado
Categoría Inbound
Modo Asincronico

Integration Builder

Configuration Scenario
Nombre ActualizarDevolucionMercaderia

Party
Nombre N/A

Business Component
 Diseño - Integración

Nombre N/A

Integrated Configuration
Communication Party
Communication
PMM_PE_D
Component
Interface ActualizarDevolucionMercaderiaRequest_Out
Interface Namespace urn:Falabella.cl:PMM:LogisticaInventario:DevolucionMercaderia
Communication Channel
Inbound Processing
SOAPSenderActualizarDevolucionMercaderia
Condition Communication Party Communication Component Receiver
Receiver
S4H120_D
Conditio Operation
Interface Namespace
n Mapping
Receiver Interfaces
ActualizarDevolucionMe urn:Falabella.cl:S4H:LogisticaInventari
rcaderiaRequest_Inb o:DevolucionMercaderia
Communication Channel
Outbound Processing
SOAPXIReceiverActualizarDevolucionMercaderia_PMM_PE

Communication Channel
Party
Communication
PMM_PE_D
Component
Nombre SOAPSenderActualizarDevolucionMercaderia
Adaptador SOAP
SOAP / Sender / Exactly once
Configuración HTTP Destination: S4DCLNT120
Timeout: XMBWS.Timeout 10000

Communication Channel
Party
Communication
S4H120_D
Component
Nombre SOAPXIReceiverActualizarDevolucionMercaderia_PMM_PE
Adaptador SOAPXI
SOAP / HTTP / XI
Configuración HTTP Security Level: HTTP
Timeout: XMBWS.Timeout 10000

Confirmation

Enterprise Service Repository.

 Diseño - Integración

Data Type
Nombre ResultadoTransaccion
Namespace urn:Falabella.cl:S4H:Common:Structures
Software
Componen F_C_S4H_COMMON
t Version

Estructura
PTP-M-239.xlsx

Data Type
Nombre ResultadoTransaccionSqlStmt
Namespace urn:Falabella.cl:PI:Common:Structures
Software
Componen F_C_PI_COMMON
t Version

Estructura
PTP-M-239.xlsx
 Diseño - Integración

Message Type
Nombre EnviarResultadoTransaccionConfirmation
Namespace urn:Falabella.cl:S4H:Common:Structures
Software Component
F_C_S4H_COMMON
Version
Data Type Relacionado ResultadoTransaccion
Namespace data type
urn:Falabella.cl:S4H:Common:Structures
relacionado
Target namespace urn:Falabella.cl:S4H:Common:Structures

Message Type
Nombre EnviarResultadoTransaccionConfirmationSqlStmt
Namespace urn:Falabella.cl:PI:Common:Structures
Software Component
F_C_PI_COMMON
Version
Data Type Relacionado ResultadoTransaccionSqlStmt
Namespace data type
urn:Falabella.cl:PI:Common:Structures
relacionado
Target namespace urn:Falabella.cl:PI:Common:Structures

Service Interface
Nombre ActualizarDevolucionMercaderiaConfirmation_Out
Namespace urn:Falabella.cl:S4H:LogisticaInventario:DevolucionMercaderia
Software
Componen F_I_S4H_LOGISTICAINVENTARIO
t Version
Estructura
EnviarResultadoTransaccionConfirmation
relacionada
Namespace
relacionad urn:Falabella.cl:S4H:Common:Structures
o
Categoría Outbound
Modo Asincronico

Service Interface
Nombre ActualizarDevolucionMercaderiaConfirmationSqlStmt_Inb
Namespace urn:Falabella.cl:PMM:LogisticaInventario:DevolucionMercaderia
 Diseño - Integración

Software
Componen F_I_PMM_LOGISTICAINVENTARIO
t Version
Estructura
EnviarResultadoTransaccionConfirmationSqlStmt
relacionada
Namespace
relacionad urn:Falabella.cl:PI:Common:Structures
o
Categoría Inbound
Modo Asincronico

Message Mapping
Nombre EnviarResultadoTransaccionConfirmation_to_EnvioRespuestaSqlStmt
Namespace urn:Falabella.cl:PI:Common:Mappings
Software
Componen F_A_PI_COMMON
t Version
Estructuras EnviarResultadoTransaccionConfirmation
Relacionad
urn:Falabella.cl:S4H:Common:Structures
as Origen
Estructuras EnvioRespuestaSqlStmt
Relacionad
as Destino urn:Falabella.cl:PI:Common:Structures

Definición
de Mapeo PTP-M-239.xlsx

Operation Mapping
ActualizarDevolucionMercaderiaConfirmation_Out_to_ActualizarDevolucionMercaderiaConfirmation
Nombre
SqlStmt_Inb
Namespace urn:Falabella.cl:PI:LogisticaInventario:DevolucionMercaderia
Software
Componen F_A_PI_LOGISTICAINVENTARIO
t Version
Mapeos
Relacionad EnviarResultadoTransaccionConfirmation_to_EnvioRespuestaSqlStmt
os
Operacione ActualizarDevolucionMercaderiaConfirmation_Out
s
Relacionad urn:Falabella.cl:S4H:LogisticaInventario:DevolucionMercaderia
os Origen
 Diseño - Integración

Operacione ActualizarDevolucionMercaderiaConfirmationSqlStmt_Inb
s
Relacionad urn:Falabella.cl:PMM:LogisticaInventario:DevolucionMercaderia
os Destino

Integration Builder

Configuration Scenario
Nombre ActualizarDevolucionMercaderia

Party
Nombre N/A

Business Component
Nombre N/A

Integrated Configuration
Communication Party
Communication
S4H120_D
Component
Interface ActualizarDevolucionMercaderiaConfirmation_Out
Interface Namespace urn:Falabella.cl:S4H:LogisticaInventario:DevolucionMercaderia
Communication Channel
Inbound Processing
SOAPXISenderActualizarDevolucionMercaderiaConfirmation
Communication Component
Condition Communication Party
Receiver
p1:EnviarResultadoTransaccionConfi
rmation/Respuestas/Header/Legado
Receiver
/Legados = PMM AND
PMM_PE_D
/p1:EnviarResultadoTransaccionConf
irmation/Respuestas/Header/Pais =
PE
Conditio
Operation Mapping Interface Namespace
n
ActualizarDevolucionMerc
Receiver Interfaces aderiaConfirmation_Out_ ActualizarDevolucionMerc urn:Falabella.cl:PMM:LogisticaI
to_ActualizarDevolucion aderiaConfirmationSqlStm nventario:DevolucionMercader
MercaderiaConfirmation t_Inb ia
SqlStmt_Inb
Communication Channel
Outbound Processing
JDBCReceiverActualizarDevolucionMercaderiaConfirmation
 Diseño - Integración

Communication Channel
Party
Communication
S4H120_D
Component
Nombre SOAPXISenderActualizarDevolucionMercaderiaConfirmation
Adaptador SOAPXI
SOAP / HTTP / XI
Configuración
TimeOut: XMBWS.Timeout 10000

Communication Channel
Party
Communication
PMM_PE_D
Component
Nombre JDBCReceiverActualizarDevolucionMercaderiaConfirmation
Adaptador JDBC
JDBC Driver: oracle.jdbc.OracleDriver
Connection: P/D
User Name: P/D
Configuración Password: P/D
TimeOut: XMBWS.Timeout 10000
Advanced Mode:
Additional parameters: disconnect from database after processing each message

Notificación por email

Enterprise Service Repository.

 Diseño - Integración

External Definition
Nombre Mail
Namespace urn:Falabella.cl:PI:Common:Mail
Software Component Version F_C_PI_COMMON

Archivo a importar

Service Interface
Nombre EnviarFalloDevolucionMercaderiaNotification_Out
Namespace urn:Falabella.cl:S4H:LogisticaInventario:DevolucionMercaderia
Software Component Version F_I_S4H_LOGISTICAINVENTARIO
Estructura relacionada Mail
Namespace relacionado urn:Falabella.cl:PI:Common:Mail
Categoría Outbound
Modo Asincronico

Service Interface
Nombre EnviarFalloDevolucionMercaderiaNotification_Inb
Namespace urn:Falabella.cl:Email:LogisticaInventario:DevolucionMercaderia
Software Component Version F_I_EMAIL_LOGISTICAINVENTARIO
Estructura relacionada Mail
Namespace relacionado urn:Falabella.cl:PI:Common:Mail
 Diseño - Integración

Categoría Inbound
Modo Asincronico

Integration Builder
Configuration Scenario
Nombre ActualizarDevolucionMercaderia

Integrated Configuration
Communication Party
Communication
S4H120_D
Component
Interface EnviarFalloDevolucionMercaderiaNotification_Out
Interface Namespace urn:Falabella.cl:S4H:LogisticaInventario:DevolucionMercaderia
Communication Channel
Inbound Processing
SOAPXISenderEnviarFalloDevolucionMercaderia
Condition Communication Party Communication Component Receiver
Receiver
EMAIL_D
Operati
Condit on
Interface Namespace
Receiver ion Mappin
Interfaces g
EnviarFalloDevolucionMercaderiaN urn:Falabella.cl:Email:LogisticaInventario:Dev
otification_Inb olucionMercaderia
Outbound Communication Channel
Processing MailReceiverEnviarFalloDevolucionMercaderia

Communication Channel
Party
Communic
ation
S4H120_D
Componen
t
Nombre SOAPXISenderEnviarFalloDevolucionMercaderia
Adaptador SOAPXI
SOAP / HTTP / XI
Configurac
TimeOut: XMBWS.Timeout 10000
ión

Communication Channel
 Diseño - Integración

Party
Communic
ation
EMAIL_D
Componen
t
Nombre MailReceiverEnviarFalloDevolucionMercaderia
Adaptador Mail
SMTP / XIPAYLOAD / Receiver
URL: smtp://correoseguro.falabella.cl:25
Configure User Authentication
Configurac Authentication Method: Plain
ión User: SAP-PO-PREPROD@falabella.cl
Use Mail Package
Content Encoding: base64
TimeOut: XMBWS.Timeout 10000

Documentación Técnica – ABAP

Fecha Actual Fecha Entrega
(dd/mm/aaaa) (dd/mm/aaaa)

Objetos (Solo en utilización de PROXY)

[Incluir en esta sección un inventario de los objetos que componen y serán utilizados en el
desarrollo, indicando tablas, programas, funciones, etc. Listar todos los objetos, ya sean nuevos
o existentes. En caso de requerir la creación de tablas, estructuras, elementos de datos o campos
específicos incluir un detalle de cada uno. Eliminar este comentario en la versión final del
documento.]
Short Description Program ID Object Type Object Name

Tiene relación con la llamada a programas y/o funciones necesarias para la ejecución del
proceso en SAP, ejemplo, monitoreo, clases de mensajes, funciones de formatos de campos.
 Diseño - Integración

Implementación
[Incluir en esta sección las consideraciones para implementar la solución en el entorno productivo,
incluyendo definiciones sobre órdenes de transporte y cualquier otro requerimiento para que su
correcta puesta en marcha. Eliminar este comentario en la versión final del documento.]
Orden Transporte Descripción Comentario
[ID] [Describir el título de la orden]