Programa Lidera

ESPECIFICACIÓN FUNCIONAL

ACTUALIZACIÓN DE % PROTEÍNA PARA

ASIGNACIÓN DE LOTES PARA LA VENTA.
ID- PP015D

PROGRAMA LIDERA
En cumplimiento al Contrato de Prestación de Servicios de Asesoría, se hace entrega del siguiente
documento:

Fase: CONSTRUCCIÓN

Entregable: ESPECIFICACIÓN FUNCIONAL

Componente: Especificación funcional por desarrollo - Interface

2
 Versión 1.0

Control de Documento
Información del Entregable
ACTUALIZACIÓN DE % PROTEÍNA PARA ASIGNACIÓN DE LOTES PARA LA VENTA.
Nombre del Entregable

Autor Roberto Castilllo Castañeda

Propietario NIRSA
Estatus En Construcción
Fecha de entrega: 11/07/2022

Historia de Revisión

Versión No. y Estatus Autor

Versión 1.0 En Construcción Roberto Castillo Castañeda

Aprobación

Rol Nombre Firma

Fecha:
Fecha:
Fecha:

Control documental

Descripción de la versión Estatus Responsable

Elaboración del documento Final Roberto Castillo Castañeda

Aprobación definitiva del documento Final

3
Contenido
1. Justificación............................................................................................................................................... 5
2. Especificación funcional............................................................................................................................. 5
2.1. Definiciones, acrónimos y abreviaciones.................................................................................................. 5
2.2. Supuestos.............................................................................................................................................. 5
2.3. Propósito............................................................................................................................................... 6
2.4. Descripción detallada del proceso............................................................................................................ 6
2.5. Caso de negocio – excepciones.............................................................................................................. 16
2.6. Enlistar los flujos del proceso referentes al desarrollo...............................................................................17
2.7. Requerimientos generales de procesamiento............................................................................................ 17
2.8. Dependencias / Prerrequisitos................................................................................................................ 17
2.9. Requerimientos de campos Legacy / SAP............................................................................................... 17
2.10. Campos adicionales para el formato [Nombre del formato].......................................................................17

4
1. Justificación
Área (Módulo SAP Modulo SAP
Versión SAP: 1 Fecha: 14/06/2022
ECC): PP
Nombre del RICEFW PP015D – Actualización de %Proteína para la asignación de lotes para la venta

Fase: Realización
Solicitado por: Ph/E-mail
Analista funcional: Roberto Castillo Castañeda Ph/E-mail racastillo@gmail.com
Analista Técnico: Ph/E-mail

Tipo de ( X) Reporte ( ) Interfaz ( ) Conversión ( ) Mejora ( ) Formato ( ) Workflow

programa: (X) Nuevo desarrollo en S/4 Hana ( ) Legacy
( ) Mandatorio (Requerido por ley)
( X) Esencial ( Crítico del negocio – caso de negocio válido)
Prioridad:
( ) Importante
( ) Recomendable tenerlo
Complejidad: ( ) Baja (X ) Mediana ( ) Alta
Frecuencia de
( ) Trimestralmente ( ) Mensualmente () Semanalmente (X ) Otro: Diario
uso:
Impacto a
funcionalidad ( ) Bajo ( X) Medio ( ) Alto
estándar:
Volumen de
información a
procesar:

Enlistar los sistemas legacy

existentes involucrados en el
esfuerzo de este desarrollo

2. Especificación funcional

5
1.1. Definiciones, acrónimos y abreviaciones
Cualquier término asociado con esta especificación que puede no ser usado comúnmente

2.1. Supuestos
Enlistar los supuestos que serán utilizados en este documento

1.2. Propósito 2.2.

Como solución de mejora del proceso de asignación de lotes de harina para la venta, en la sociedad de NIRSA, se
requiere la construcción de un desarrollo con dos opciones las cuales van a permitir gestionar las consultas de D
stock de lotes con sus respectivas características de calidad y por otro lado el registro de asignación de lotes para
la venta.
Estas dos opciones deben tener objetos de autorización para gestionar las asignaciones de los perfiles por usuario.

escripción detallada del proceso

Pantalla Inicial:

El desarrollo contempla los siguientes pasos:

1. Control de stock de lotes y características de inspección.

6
 2. Asignación de lotes para la venta.

Pantalla del programa:

Ambas vistas deben tener objetos de autorización para ser utilizadas en los roles y perfiles que se le asignen
a los usuarios.

Imagen referencial.

Control de stock de lotes (Stock de lotes de harina)

Para realizar la búsqueda de stock de lotes, se debe ingresar como parámetro de selección el centro 1080 y Almacén
0803.

Para realizar la búsqueda de los lotes se realiza la siguiente secuencia:

Tabla de stock de lotes MCHB

Solo considerar aquellos lotes que tienen stock en libre utilización y con el centro de distribución 1080 y almacén
0803.

7
Campos a obtener de esta tabla:

MATNR – Material
WERKS – Centro
LGORT - Almacén
CHARG - Lote
CLABS - Libre utilización

Tabla MCH1 donde se obtendrá los siguientes campos

MATNR – Material
CHARG – Lote
ERSDA – Fecha de creación
HSDAT – Fecha de fabricación

Lote de Inspección considerar los lotes con clase de inspección 04 y Z04CC.

Tabla QALS

WERK = 1050 ----Centro

ART = Z04CC ----- Clase de inspección
SELMATNR = 1195 Material
CHARG = LOTE130722 --- Lote
MATNR = 1195 --- Material
BWART = 101 ---- Clase de movimiento
AUFNR = Numero de Orden de proceso

Para obtener la columna Tipo de Lote para el ALV se debe buscar la orden de donde se produjo y verificar si
corresponde a una OP de atún o Pelágico, de acuerdo a esta información se desagrega el stock, se debe realizar la
siguiente secuencia de búsqueda:

Con el numero de la orden el cual se obtiene del campo AUFNR de la tabla QALS, con este dato se busca en la tabla
AFPO mediante el campo AUFNR y se obtiene el campo VERID del 1er registro y con esto se define el tipo de
lote:

VH01 – PRODUCCION PESCA PELAGICA

VH02 – PRODUCCION SUB ATUN

Para la búsqueda de los resultados de Inspección por característica se procede a realizar la ejecución de la siguiente
BAPI:

BAPI_INSPOPER_GETDETAIL

Y tomar las características de la tabla CHAR_REQUIREMENTS

8
Solo para las características:

Humedad Harina PT - H-ACHUM

Grasa Harina PT - H-GRASA
Ceniza Harina PT - H-CNZ
Histamina Harina PT - H-HSPLPT
FFA (Acidez Harina PT) - H-PUACI
TVN (Nitrógeno Harina PT) - H-TPELPT
Proteína Harina PT - H_PROTEI

Por cada característica se debe tomar los valores de la siguiente tabla CHAR_RESULTS

La relación entre las 2 tablas es mediante el campo INSPCHAR con esta relación se obtiene los valores de la
columna MEAN_VALUE.

ALV con el stock y características de calidad, si la cantidad en el lote esta con la unidad de KG utilizar una función
para que nos devuelva la cantidad en sacos (BTO).
CALL FUNCTION 'MD_CONVERT_MATERIAL_UNIT'
EXPORTING

9
i_matnr = " Número de Material
i_in_me = " Unidad de Medida Origen
i_out_me = " Unidad de Medida Salida
i_menge = " Cantidad en medida Origen
IMPORTING
e_menge = " Cantidad en medida Salida
EXCEPTIONS
error_in_application = 1
error = 2
OTHERS = 3.

El ALV debe tener todas las funcionalidades para su gestión (teclas de función, botones iconos).
Estructura del reporte ALV que se debe mostrar en el reporte de stock de lotes y sus características.

Estos campos representan las columnas del reporte el cual va a contener el detalle de los materiales, lotes,
stock y características con sus valores.
CAMPO Elemento de dato / TIPO DE DATO Valor
Tipo CHAR40 VH01 - PRODUCCION PESCA PELAGICA / VH02 - PRODUCCION S
Material MATNR MCHB-MATNR
Lote CHARG MCHB-CHARG
fecha de
CHAR
producción MCH1-HSDAT
Humedad CHAR50 CHAR_RESULTS-MEAN_VALUE
Grasa CHAR50 CHAR_RESULTS-MEAN_VALUE
Ceniza CHAR50 CHAR_RESULTS-MEAN_VALUE
Proteína CHAR50 CHAR_RESULTS-MEAN_VALUE
Histamina CHAR50 CHAR_RESULTS-MEAN_VALUE
FFA CHAR50 CHAR_RESULTS-MEAN_VALUE
TVN CHAR50 CHAR_RESULTS-MEAN_VALUE
SACOS MENGE_D Calculo

Consideraciones para este escenario:

1. Crear objeto de autorización, el cual será asignado a los usuarios que deseen realizar consultas de
stock de lotes de harina para la venta.
2. El proceso de selección de lotes se realiza con las características de inspección de calidad (04-
Z04CC).
3. Los parámetros de selección para generar la búsqueda de lotes son el centro y almacén (1080-
0801).
4. Los stocks de lotes estarán por grupos de acuerdo al proceso que le corresponde (proceso de harina
con pesca pelágica y sub producto de sardina- proceso de harina con sub producto de atún).
5. Este es un reporte de consulta con un formato ALV con (Pestaña de control de stock de lotes) toda
la estructura de funcionalidad estándar que trae esta herramienta (iconos).
6. Los campos y estructura de reporte se encuentran en el formato Excel adjunto en la parte inferior

10
 del documento.
7. Para el stock, se debe verificar que los lotes que cuenten con stock en LU y se encuentren en la
tabla de asignaciones se debe realizar la resta y actualizar en el alv como parte del stock disponible.

Asignación de lotes para la venta (Asignación de lotes):

2da Pestaña del Reporte

El usuario debe ingresar el número de contrato y las características a evaluar solicitadas por el cliente:

Parámetros de Inicio:

Nro. de Contrato (tipo de dato definido en la estructura de la tabla ZTQM_ASIG_CONTRATO-contrato)

Nro. de Código SCI (tipo de dato definido en la estructura de la tabla ZTQM_ASIG_CONTRATO-codigosci)
Cliente (KNA1-KUNNR) es l input , despues de seleccionar el código de cliente se debe visualizar en una etiqueta el
nombre del cliente KNA1-NAME1. utilizar match code estandar para la búsqueda en el campo.
Fecha (Fecha del Sistema)- Proponer la fecha del día, el usuario puede cambiar la fecha con la fecha real del
contrato la cual será ingresada
Cantidad (Tipo de dato es QUANT con 3 decimales)

11
Cantidad TM
El programa de mostrar un ALV de acuerdo a la siguiente imagen

El ALV tiene que ser dinámico de acuerdo a las características que se obtengan de la tabla constante TVARVC.

Características
 Proteína
 Humedad
 Grasa
 Ceniza
 TVN
 Histamina
 FFA
 Sal

El ALV debe permitir el ingreso de cantidades, las columnas en blanco deben ser editables y se completa los valores
por cada característica.

Estos datos deben estar almacenados en una tabla Z y hacer referencia al contrato con el cual se creó, tabla
ZTQM_ASIG_CARACT (definición de estructura en la parte inferior del documento) .

Campos del ALV.

Características
Valor
Valor

Después de ingresar los valores, se procede a realizar la búsqueda de lotes que cumplan con las condiciones del
cliente mediante el botón BUSQUEDA.

Obtener los lotes con disponibilidad de stock mediante la tabla de stock de lotes MCHB, solo considerar aquellos
lotes que tienen stock en libre utilización, con el centro 1080 y almacén 0803.

Campos a obtener de esta tabla:

MATNR – Material
WERKS – Centro
LGORT - Almacén
CHARG - Lote
CLABS - Libre utilización

Obteniendo los lotes con stock se procede a realizar la búsqueda del lote de inspección que le corresponde a cada lote

12
logístico.

El proceso debe seleccionar aquellos lotes con stock que cumplan con las características solicitadas en el contrato.

Proceso de selección de características de inspección por lote logístico:

Tabla QALS
CAMPOS VALOR
WERK 1050
ART 04
SELMATNR 1053
CHARG 0000000281
MATNR 1053
BWART 101
AUFNR 1000025

Con estos datos obtenemos el número de lote de inspección en el campo QALS- PRUEFLOS.
Con estos datos se procede a realizar la búsqueda de los resultados de inspección utilizando la siguiente BAPI:

BAPI_INSPOPER_GETDETAIL

Dir. Datos Test

13
Se seleccionará los valores de la tabla interna CHAR_REQUIREMENTS en el cual se encuentran las características,
los campos están seleccionados en el recuadro rojo.

Los valores de las características que se encuentran en la tabla CHAR_RESULTS en el campo MEAN_VALUE y el
código de la característica esta en el campo INSPCHAR

La relación entre ambas tablas se realiza mediante el campo INSPCHAR.

Solo considerar las características:

 Proteína
 Humedad
 Grasa
 Ceniza
 Histamina
 FFA (Acidez Harina PT)
 TVN (Nitrógeno Harina PT)

Después de obtener todos los resultados de las características por cada lote logístico y almacenados en una tabla
interna con los campos indicados anteriormente, se debe realizar la siguiente secuencia para los filtros:

A. Seleccionar solo aquellos lotes que cumplan con la condición de %proteína solicitada en el contrato.

14
 B. Lotes que cumplan las condiciones de los valores ingresados en el contrato para las demás características.
C. Aplicar la formula en el Excel para calcular el promedio.

D. La fecha de producción del lote es la fecha de contabilización del ingreso de material con clase de
movimiento 101 el cual se toma del lote de inspección tabla QALS-ERSTELDAT.
E. Para calcular el total de la columna sacos, se toma el total de sacos se convierte a TM y debe validar que
no sobre pase las TM solicitadas por el cliente, adicionalmente debe validar que la cantidad que se ingresa
como sacos por cada lote no sobre pase del stock disponible.
F. El nombre del cliente se obtiene del contrato tabla KNA1-NAME1 mediante el parámetro de ingreso KNA1-
KUNNR.

Campos para el ALV el cual debe tener todos sus iconos estándar.
CAMPOS VALOR
Contrato Parámetro de Ingreso
Fecha del contrato Parámetro de Ingreso
Lote MCHB-charg
Fecha de producción
del lote QALS-ERSTELDAT
Proteína CHAR_RESULTS-MEAN_VALUE
Humedad CHAR_RESULTS-MEAN_VALUE
Grasa CHAR_RESULTS-MEAN_VALUE
Ceniza CHAR_RESULTS-MEAN_VALUE
Histamina CHAR_RESULTS-MEAN_VALUE
FFA CHAR_RESULTS-MEAN_VALUE
TVN CHAR_RESULTS-MEAN_VALUE
Sacos Input
Parciales Input
Observación Input

Los lotes seleccionados para la asignación se almacenarán en una tabla ZTQM_ASIG_CONTRATO (definición de

15
estructura en la parte inferior del documento) donde se controla el stock asignado a los contratos.

Consideraciones para este escenario:

1. Al ingresar el número de contrato el cual se define su estructura de la tabla (campo obligatorio ) el

sistema debe verificar lo siguiente:
a. Si existe un contrato y esté liberado debe mostrar todo el resultado bloqueado.
b. En el caso no exista el contrato el sistema debe preguntar si desea crearlo.
c. En el caso exista y no esté liberado el sistema debe permitir la edición del contrato de asignación.
2. Crear objeto de autorización, el cual será otorgado a los usuarios que deseen registrar asignación de
lotes de harina para la venta.
3. El control de contratos debe almacenarse en una tabla Z y se utilice para consultas posteriores de
las asignaciones realizadas.
4. El proceso de selección de lotes se realiza con las características de inspección de calidad (04-
Z04CC)
5. La asignación de contrato debe permitir adjuntar archivos tales como informe de certificadora,
archivo interno, entre otros. A su vez estos serán consultados posteriormente visualizándose en el
formato de origen del archivo.
6. Debe tener un control de liberación donde no se permita modificar posteriormente (cuando el
contrato se ha atendido completamente) el Flag de liberado se encuentra la tabla de cabecera de los
contratos tabla ZTQM_ASIG_CARACT campo Liberado.
7. Solo se pueden eliminar contratos mediante código de autorización (Crear objeto de autorización
ELICON) si tiene acceso a este objeto el usuario SAP puede realizar la acción (El sistema
preguntara si desea eliminar el contrato – SI – NO). Debe existir un botón para ejecutar esta acción.
El proceso de eliminar el contrato consiste en dar delete a al contrato ingresado, el cual debe
borrarse de las 3 tablas con referencia al número de contrato claro está.
8. El primer filtro se realizará de acuerdo al porcentaje de proteína solicitado por el cliente en el
contrato. Seleccionar solo aquellos lotes que tengan los % de proteínas de la tabla interna como
resultado de la búsqueda da las BAPI.
9. El siguiente filtro se realizará de acuerdo a los valores de las demás características indicadas por el
cliente en el contrato. Para realizar este proceso se utiliza el uso de la tabla interna como resultado
de la búsqueda da las BAPI. Se debe
10. El siguiente filtro solo tomara los lotes que cumplan con las TM solicitadas por el cliente en el
contrato.
11. Todos los contratos deben tener referencia de los archivos anexados y debe permitir visualizarlos.
12. Se debe promediar los resultados de las características de acuerdo al archivo Excel adjunto en la
parte inferior del documento.
13. Los ALV que permiten edición de registro deben tener toda la funcionalidad estándar que
proporciona el sistema (iconos de función).
14. En el caso que el sistema no encuentre lotes que cumplan con él % Proteína se realizara un
promedio de aquellos lotes que cumplan con él % proteína solicitada (es decir se tomara un grupo
de lotes con el % mas cercano al solicitado y se promediara para alcanzar el % de proteína
solicitado por el cliente) y se retornara al punto 9 y continuar con los siguientes filtros.
15. Deben ingresarse las características en la tabla constante TVARVC Transacción STVARV
Características
 Proteína
 Humedad
 Grasa
 Ceniza
 TVN
 Histamina
 FFA
 Sal

16
Tablas para almacenar los datos del contrato:

TABLA ZTQM_ASIG_CONTRATO (Asignación de lotes para contrato - Posiciones)

CAMPO CLAVE TIPO DE DATO LONGITUD DECIMALES DESCRIPCION
MANDT X CLNT 3 mandante
CENTRO X CHAR 4 CENTRO
CONTRATO X CHAR 20 Numero de contrato
CODIGOSCI CHAR 15 Código SCI
CLIENTE CHAR 40 CLIENTE
CANTIDAD QUAN 13 3 TM
Fecha de entrega de
FECHA DE ENTREGA DATS 8 contrato - despacho
LOTE CHAR 10 Lote de harina
FECHA DATS 8 FECHA DE PRODUCCION
HUMEDAD CHAR 50 CARACTERISTICAS
GRASAS CHAR 50 CARACTERISTICAS
CENIZAS CHAR 50 CARACTERISTICAS
PROTEINA CHAR 50 CARACTERISTICAS
HISTAMINA CHAR 50 CARACTERISTICAS
FFA CHAR 50 CARACTERISTICAS
TVN CHAR 50 CARACTERISTICAS
CARAC_08 CHAR 50 CARACTERISTICAS
CARAC_09 CHAR 50 CARACTERISTICAS
CARAC_10 CHAR 50 CARACTERISTICAS
CARAC_11 CHAR 50 CARACTERISTICAS
CARAC_12 CHAR 50 CARACTERISTICAS
CARAC_13 CHAR 50 CARACTERISTICAS
CARAC_14 CHAR 50 CARACTERISTICAS
CARAC_15 CHAR 50 CARACTERISTICAS
SACOS QUAN 13 3 SACOS ASIGNADOS
PARCIALES QUAN 13 3 CNT PARCIALES
OBSERVACION CHAR 60

17
TABLA ZTQM_ASIG_CARACT (Tabla Cabecera de Asignación)
CAMPO CLAVE TIPO DE DATO LONGITUD DECIMALES DESCRIPCION
MANDT X CLNT 3 MANDANTE
CENTRO X CHAR 4 CENTRO
CONTRATO X CHAR 20 NUMERO DE CONTRATO
CORRELATIVO X NUMC 4 POSICION
CARAC_01 CHAR 50
CARAC_VALOR_01 CHAR 50
CARAC_02 CHAR 50
CARAC_VALOR_02 CHAR 50
CARAC_03 CHAR 50
CARAC_VALOR_03 CHAR 50
CARAC_04 CHAR 50
CARAC_VALOR_04 CHAR 50
CARAC_05 CHAR 50
CARAC_VALOR_05 CHAR 50
CARAC_06 CHAR 50
CARAC_VALOR_06 CHAR 50
CARAC_07 CHAR 50
CARAC_VALOR_07 CHAR 50
CARAC_08 CHAR 50
CARAC_VALOR_08 CHAR 50
CARAC_09 CHAR 50
CARAC_VALOR_09 CHAR 50
CARAC_10 CHAR 50
CARAC_VALOR_10 CHAR 50
CARAC_11 CHAR 50
CARAC_VALOR_11 CHAR 50
CARAC_12 CHAR 50
CARAC_VALOR_12 CHAR 50
CARAC_13 CHAR 50
CARAC_VALOR_13 CHAR 50
CARAC_14 CHAR 50
CARAC_VALOR_14 CHAR 50
CARAC_15 CHAR 50
CARAC_VALOR_15 CHAR 50
Liberado CHAR 1

TABLA ZTQM_ASIG_FILE (Tabla que almacena los archivos por cada contrato)
CAMPO CLAVE TIPO DE DATO LONGITUD DECIMALES DESCRIPCION
MANDT X CLNT 3 MANDANTE

18
CENTRO X CHAR 4 CENTRO
CONTRATO X CHAR 20 NUMERO DE CONTRATO
CORRELATIVO X NUMC 4 POSICION
FILE FILE ALMACENADO

Objetos de Autorización:

ZQM_ASIG - Objeto de autorización Monitor de contratos

Clase de Objeto de autorización

ZQM - Clase de objeto de autorización QM

Nombre de Campo

1.- ACTVT – Actividad

Valores

01 – Crear
02 – Modificar
03- Visualizar

El usuario puede tener la acción dependiendo de los campos que se le asigne.

2.- BOTON_DU
Crear un elemento de datos para utilizar con este campo:
ZE_QM_BOTON_DU con un tipo CHAR 10 , el dominio debe tener el nombre de ZD_QM_BOTON_DU con sus
valores fijos

AUTORIZAR - Solicitud de autorización

BLOQUEO - Bloquear
DESBLOQUEO - Desbloquear
ELICON – Eliminar contrato
VISUALIZAR - Visualizar reporte
CONFIRM - Confirmar
UPLOAD - Carga en masa
SAVE - Guardar observaciones

El usuario puede eliminar contratos solo si se le asigna el campo BOTON_DU con el valor de ELICON.

Datos de Pruebas:
Lotes de inspección con sus características y la BAPI_INSPOPER_GETDETAIL

19
20
 2.3. Caso de negocio – excepciones
No aplica

1.3. Enlistar los flujos del proceso referentes al desarrollo Técnico

2.4. Requerimientos generales de procesamiento

Modo de procesamiento: ( ) Lote (X) En línea
Frecuencia: ( ) Anualmente ( ) Trimestralmente ( ) Mensualmente ( ) Semanalmente
( ) Diariamente ( X ) Otro (especificar)

Volumen esperado de datos Total de registros:

21
2.5. Dependencias / Prerrequisitos
Descripción Documentos relacionados
No aplica No aplica

2.6. Requerimientos de campos Legacy / SAP

Campos en el sistema legacy Campos en SAP Reglas de conversión
No aplica No aplica No aplica

2.7. Campos adicionales para el formato [Nombre del formato]

Nombre del campo Tabla SAP/Nombre del campo Global o específico de cierto país
No aplica No aplica No aplica

22