Especificación Funcional

Proyecto

INTEGRA

EF_Portal81_Embarques_Reporte de Folios de entrega

Versión: 1.0

Proyecto: Integra – Embarques - Reporte de Folios de entrega

ID Req: Portal81
Archivo: EF_Portal81_Embarques_Reporte de Folios de entrega

Autor: Eloisa Vázquez Rojas

Fecha: 02 de noviembre de 2020
Copyright: CYDSA
Compañía: CYDSA
Cliente: CYDSA
Equipo:

Estatus:
Prioridad: Obligatorio
1 Índice

ESPECIFICACIÓN FUNCIONAL 1

1 ÍNDICE 3

2 BITÁCORA DE MODIFICACIONES 4

3 INTRODUCCIÓN 5
3.1 CREADO POR: 5
3.2 CONTACTO TELEFÓNICO Y MAIL: 5
3.3 AUTORIZADO POR: 5
3.4 UNIDAD DE NEGOCIOS QUE SOLICITA: 5
3.5 PROCESO DE NEGOCIOS RELACIONADO: 5
3.6 NOMBRE DEL USUARIO FINAL: 5
3.7 FECHA DE AUTORIZACIÓN: 5

4 DEFINICIÓN GENERAL 6
4.1 DESCRIPCIÓN DEL REQUERIMIENTO: 6
4.2 TIPO DE DESARROLLO: 6
4.3 MÓDULO / SUBMÓDULO: 6
4.4 VERSIÓN DE SAP: 6
4.5 RAZÓN PARA DESARROLLAR: 6
4.6 BENEFICIOS ESPERADOS / AHORRO ESPERADO: 6
4.7 CONTROL DE ACCESO: 7
4.8 RELACIÓN ENTRE EL USUARIO Y LOS DIFERENTES INTERLOCUTORES COMERCIALES 8
4.9 COMENTARIOS: 9
4.10 ANTECEDENTES 10

5 REGLAS GENERALES DEL NEGOCIO 13

6 REQUERIMIENTOS FUNCIONALES Y NO FUNCIONALES 16

6.1 DESCRIPCIÓN GENERAL DE LA FUNCIONALIDAD SOLICITADA: 16
6.2 PARAMETRIZACIÓN PREVIA /INICIAL 32
6.3 PRECIOS Y TECNICAS DE CONDICIÓN 33
6.4 DIAGRAMA DE FLUJO 34
6.5 MENSAJES DE RETORNO A LA APP DE FIORI AL EMITIR UN REPORTE EN S4 HANA 34
6.6 TABLAS RELACIONADAS: 35
6.7 DISEÑO DE LA ANTALLA DE REPORTE FOLIOS DE ENTREGA 35
6.8 VOLUMEN DE DATOS: 36
6.9 TIPO DE PROCESAMIENTO: 36
6.10 FRECUENCIA DE EJECUCIÓN: 36
6.11 AUTORIZACIONES: 36
6.12 TIPO DE PROCESAMIENTO: 36
6.13 CONSIDERACIONES ESPECIALES: 36
6.14 PROCEDIMIENTOS DE CONTINGENCIA: 37
6.15 FIORI CUSTOM: 37
6.16 ID HISTORIA DE USUARIOS: 37
6.17 CRITERIOS DE TERMINADO: 37
6.18 CRITERIOS DE ACEPTACIÓN: 37
6.19 TIPO DE DISPOSITIVO: 37

7 ESPECIFICACIÓN FUNCIONAL 38

8 GLOSARIO DE CONCEPTOS 39
8.1 CONTROL DE CAMBIOS: 39
8.2 CORREO DE CONFIRMACIÓN DEL CAMBIO: 39
9 CASOS DE PRUEBA 40
2 B i t á c o r a d e M o d i fi c a c i o n e s

Versión ID Lotus Id Fecha Motivo Autor

Req.
1.0 eloisa.vazquez@negociando.com.mx 02/11/20 Embarques – Reporte Eloisa
Folios de entrega Vázquez
3 Introducción

3.1 CREADO POR:

Eloisa Vázquez

3.2 CONTACTO TELEFÓNICO Y MAIL:

Teléfono: (55) 5519352375 Email:
eloisa.vazquez@negociando.com.mx

3.3 AUTORIZADO POR:

----

3.4 UNIDAD DE NEGOCIOS QUE SOLICITA:

SISA – Sales del Istmo

3.5 PROCESO DE NEGOCIOS RELACIONADO:

Embarques – Reporte Folios de entrega

3.6 NOMBRE DEL USUARIO FINAL:

-----

3.7 FECHA DE AUTORIZACIÓN:

07 de septiembre de 2020
4 D e fi n i c i ó n G e n e r a l

4.1 DESCRIPCIÓN DEL REQUERIMIENTO:

El objetivo de este reporte es mostrar un listado de pedidos de venta o documentos de venta que
cuentan ya con una factura o que han sido procesados en facturación y que le han actualizado los datos que se
otorgan después de la entrega del material al cliente. Tales como fecha de entrega, folio, contra recibo, etc.

Estos documentos ya tuvieron una entrega previa por lo que ya fueron embarcados. Este reporte
permite conocer aquellas facturas que ya cuentan con los folios de entrega para tomar decisiones como
proceder al pago de comisiones.
De igual forma que las aplicaciones anteriores se deben tomar en cuenta el control de accesos solo
para Comisionistas. Estas apps Fiori permiten al usuario contar con un portal que les permita consultar la
información en línea sin necesidad de ingresar al ERP SAP GUI.

4.2 TIPO DE DESARROLLO:

Se realizará un servicio Odata nuevo que contenga básicamente algunos campos referentes de las tablas
principales VBRK (Factura: Datos de cabecera) y la VBRP (Factura: Datos de posición) haciendo una
unión a la tabla custom Z_COMISION (Tabla para poder conocer las facturas que han sido aprobadas por
comisión).
Se indica como realizar esta extracción de tablas, pero también si el ABAP ve conveniente puede usar BAPI
para leer la información de la factura: LB_BIL_INV_OUTP_READ_PRTDATA

4.3 MÓDULO / SUBMÓDULO:

SD (Sales & Distribution) / Facturación

4.4 VERSIÓN DE SAP:

SAP FIORI SAP S/4 HANA 1709 FSP2

4.5 RAZÓN PARA DESARROLLAR:

Contar con una aplicación Fiori que permita consultar un listado de las facturas que fueron
actualizadas con sus respectivos folios de entrega, donde este folio lo otorga el cliente cuando realiza la
recepción del material en su sistema. Justo el folio que nos indica que el material fue entregado físicamente al
cliente.

Los datos que alimentan en el pedido ya facturado son: fecha de entrega, folio y contra recibo, entre
otros. Adicional se deberá tomar en cuenta el importe de la comisión, así como el usuario que lo actualizó
con su respectivo estatus de la factura y de la comisión.

Por parte del proceso de implementación funcional de S4 Hana se realizará la creación de una tabla
Custom Z_COMISION la cual a pesar de no estar creada aún se tomará en cuenta para la creación de este
desarrollo que deberá unir dichas tablas para mostrar el reporte al usuario.
4.6 BENEFICIOS ESPERADOS / AHORRO
ESPERADO:
Consultar de forma eficaz los folios de entrega reportados en las facturas de un cierto periodo de tiempo que
permita al usuario exportar a Excel para toma de decisiones, así como el pago de comisiones.

4.7 CONTROL DE ACCESO:

Para los parámetros de control se deberá acceder a las tablas de control del usuario para identificar los valores
a los cuales tiene permiso
Usar el CDS creado para este fin, en el cual se puedan obtener los diferentes controles para el usuario y poder
limitar su acceso.
Relación de Tablas en el control de acceso

Procedimiento de extracción
1. Parámetros de Usuario. Con el usuario SCP que se recibe como parámetro de entrada accesar la tabla
ZPCSISA_USUARIO con la llave UNAME, obtener los datos relacionados al usuario

UNAME Nombre de usuario

TEXT Rol
KUNNR Número de cliente
BUKRS Sociedad
VKORG Organización de ventas
SPART Sector
USALIA
S Nombre alias p.usuario de Internet

2. Extraer el campo KUNNR

4.8 RELACIÓN ENTRE EL USUARIO Y LOS
DIFERENTES INTERLOCUTORES COMERCIALES
Relación entre el usuario comisionista y los diferentes interlocutores comerciales

A continuación, se describen los pasos a realizar y la relación que existe para extraer los datos
relacionadas a los comisionistas y los datos de los Interlocutores comerciales (Business Partner).

1) Usuario y Rol Comisionista

i. Crear un usuario para el comisionista (Basis)
ii. Crear un número de comisionista en el dato maestro de clientes (Consultor S4HANA
SD)
iii. Generar un rol para el usuario comisionista (Basis)
iv. Asociar el número de comisionista al rol comisionista (Basis)

2) Datos Destinatario
i. Crear los destinatarios de mercancías en el dato maestro de clientes, a cada destinatario
se le asignará el estado y la ciudad para su ubicación geográfica y el centro para indicar
de donde se surtirán sus pedidos (Consultor S4HANA)
ii. Asignar el número de comisionista a cada destinatario de mercancía en la pestaña de
Funciones de interlocutor en el dato maestro de clientes (Consultor S4HANA)

3) Datos Cliente
 i. Crear un número de cliente para cada socio comercial, en el dato maestro de clientes
(Consultor S4HANA)
ii. Asignar a cada cliente, los diferentes destinatarios de mercancía en la pestaña de
Funciones de Interlocutor en el dato maestro de clientes (Consultor S4HANA)

Consideraciones importantes para la extracción de los interlocutores comerciales (Business Partner):

- Un usuario comisionista solo podrá tener asignado un número de comisionista

- Un comisionista puede estar ligado a uno o más destinatarios de mercancía
- Un destinatario de mercancías solo puede estar asignado a un cliente.
- Un cliente puede tener uno o más destinatarios de mercancías
- Utilizar los objetos de autorización V_VBAK_VKO – área de ventas para filtrar los
interlocutores comerciales

Parámetros de Entrada para la extracción de los Interlocutores Comerciales

SEC CAMPO DESCRIPCIÓN

1 Número Comisionista Obtener el Número del comisionista del sol del
comisionista

Parámetros de Salida - Interlocutores comerciales

SEC CAMPO DESCRIPCIÓN
1 Comisionista Número del comisionista, dato parametrizado en el rol del
comisionista
14 Núm. Solicitante Número de cliente
A nivel tabla se obtiene de KNVP- KUNNR

En resumen, se deberá tomar el usuario del comisionista y de ahí unirse a la tabla KNVP y extraer el campo
KUNNR.

Revisar el CDS Control de accesos para obtener los solicitantes especificado en la EF 54 para los
comisionistas. Y el cds creado extraer los destinatarios en la EF 08 – Seguimiento de Pedidos.

Como ya existen los CDS creados para este fin, se pide usar CDS: ZPCV_Clientes, para la extracción de los
clientes correspondientes al comisionista y el CDS: ZPCV_DM para la extracción de los destinatarios o
consignatarios del comisionista.

4.9 COMENTARIOS:
No existe ninguna aplicación para clonar, en este caso se realizará un desarrollo nuevo o de cero que permita
justo consultar los datos de estas tablas de facturación y comisiones.
4.10 ANTECEDENTES
Se anexa la pantalla que maneja Cydsa actualmente en el ERP Progress para el reporte de Folios de entrega
correspondientes a Embarques:
Pulsar número de factura: Esta pantalla se desarrollará en la Épica 90 – Link Factura. Donde se podrá ligar a
esta app. o bien se puede mostrar el link de la transacción de la factura VF03.

Pulsar el importe de la comisión: El detalle de esta pantalla se encuentra en la Épica 109- Comisiones ->
Factura Su Almacén / Factura Otro Almacén. Por lo que al pulsar el importe de comisión deberá tener un
link a la aplicación de esta Épica solo lo referente al detalle de la comisión.
Pantalla propuesta con los ajustes requeridos para Cydsa:
5 Reglas Generales del Negocio

Regla del Negocio Campo Comentarios

Esta aplicación solo funcionará como Aplica No se podrá editar. Al tomar los clientes y solicitantes no se
consulta o de visualización de las tablas podrán editar manualmente. Solo seleccionar los clientes
de facturación. que tiene permitidos en combo box

Los pedidos deben facturase usando la No

clave de producto del cliente (UPC). aplica

Como tiene varios campos para poder Aplica

filtrar la información, se pide dejar el
icono de adaptar filtros a fin de que el
usuario pueda mostrar u ocultar campos
si fuera requerido.

Al igual que todas las aplicaciones del Aplica Al ingresar a la aplicación no mostrará registros de forma
portal esta quedará restringida por un inicial, hasta seleccionar algún filtro o si no deberán pulsar
CDS de control de accesos, que permita el botón “ir”
visualizar aquellas facturas que
correspondan al usuario comisionista
que ingresa a la aplicación.

Si la factura no contiene un folio de Aplica

entrega deberá imprimir SN lo cuál
indica que no contiene aún un folio.

Si el usuario pulsa el número de la Aplica

factura deberá ligarlos o enviarlos a la
pantalla del detalle de la misma.

Si el usuario pulsa el importe de la Aplica

comisión lo deberá unir a la pantalla de
detalle de la comisión. La cuál se
encuentra en otra épica 109 -
Comisiones -> Factura Su Almacén /
Factura Otro Almacén

Se deberán mostrar los clientes que Aplica

pertenecen al comisionista para ello se
detallará el control de accesos.

Se elimina la función de la vista del Aplica Se usará la función estándar de las apps Fiori para exportar
reporta de acuerdo con el nuevo sistema a Excel.
y manejo de exportación a Excel.

El consignatario equivale a lo que Aplica

significa el destinatario en el back end.

El filtro del estatus de la factura Aplica

corresponde a los que se usan en el
Back end de forma estándar. Sin
embargo, se deberá tener a unión con
Z_COMISION donde ahí tendrá otro
estatus como en pago; en Rep. de
comisión, etc.
El importe de la comisión se encuentra Aplica
ya calculado en la factura; donde de ahí
se deberá tomar el valor.

Cuando se confirme el folio de entrega Aplica

se va a colocar un anexo con la
evidencia en la entrega generada. La
cuál se dirige al GOS

La tabla Z_COMISION se creará Aplica

cuando se generé la factura en S4 Hana
y se va a ir alimentando cuando se
lleven a cabo los siguientes pasos como
cuando se llena la comisión.

El comisionista es un interlocutor en la Aplica

BP

En la Épica 26 - Confirmar Folios se Aplica

realizará el control y actualización de
los diferentes estatus de la factura en la
tabla Z_COMISION.

01 – Se generó la factura
02 – El comisionista registra
Información de la entrega como: fecha
de recibo, folio de recepción, fecha de
pago, etc. / o bien se rechazó la
comisión.
03 – Confirma la comisión.

El enlace del importe de la comisión se Aplica

deberá llamar o tener un link hacia la
Épica 109 la cuál tiene el detalle de
importe de la comisión. No se deberá
calcular solo tomar para mostrar en este
reporte.

En este reporte se verán reflejados tanto Aplica

las facturas como las notas de crédito
asociadas a dichas facturas, las cuáles
por Fiori se deberán marcar en un color
diferente. Rojo o verde y colocar justo
bajo la factura de referencia.

Cada nota de crédito tendrá su valor en Aplica

negativo y se colocará justo con la
factura mostrando así la disminución
del valor factura, así como el importe
de la comisión.
El motivo de rechazo tiene una pantalla Aplica
que fue especificada en la EF 26 –
Confirmar folios

Crear una tabla TVARVC indicando la Aplica Se pide al ABAP aplicar esta tablita TVARVC
clase de condición a usar para la
comisión. Por este momento sería
ZCO2

Crear una tabla TVARVC para colocar Aplica Ver sección: Factura con clases de documento.
las clases de documento de factura a
considerar, así como las notas de
crédito. Ambos documentos fiscales del
documento.

Se pide que las clases de factura sean Aplica Pantalla en Fiori

mostradas en un color normal, ej. Negro
o azul y que las notas de crédito se
muestren con importe negativo y en un
color diferente, puede ser verde o rojo.

Se pueden enviar en 2 o más tablas o
MF Ej. En una la información de las
facturas y en otra las devoluciones
respetando la naturaleza de los campos.
Los filtros quedarán del lado del
backend donde por cada filtro que se
realice en la pantalla de Fiori se deberá
ir al Back para tomar el dato.
Aplica No enviar string, respetar la naturaleza de los campos.
Aplica El módulo de funciones proporcionado para listar las
facturas deberá poder permitir los siguientes parámetros:
factura, cliente, etc que son los filtros que se señalan
adelante.
Los cuáles serán un tipo rango para cada parámetro, para
así no afectar la búsqueda en caso de no enviar filtros
6 Requerimientos Funcionales y No Funcionales

6.1 DESCRIPCIÓN GENERAL DE LA

FUNCIONALIDAD SOLICITADA:

Esta aplicación corresponde a un “Report List” el cual deberá permitir Exportar a Excel por parte del
usuario en caso requerido, por ello se pide que contenta los siguientes íconos:

Mostrará un listado de las tablas principales de la factura: VBRK (Factura: Datos de cabecera),
VBRP (Factura: Datos de posición) así como la tabla de Comisiones Z_COMISION

La misma deberá permitir crear vistas a gusto del usuario donde podrá mostrar u ocultar columnas en
caso requerido:

El proceso contiene las siguientes secciones a desarrollar:

I. Datos de selección. Sección con información y filtros que sirven de apoyo al usuario para acotar la
información de manera más precisa.

I. Datos de Detalle. Corresponde a la información de las facturas actualizadas con el folio de entrega,
así como sus importes de comisión. Esquema de precios.

II. Datos de Devoluciones. Corresponde a las notas de crédito por devoluciones correspondientes a cada
factura si es que existen creadas, caso contrario dejar en blanco.

I. Datos de selección

Para obtener la información de estas tablas se mostrarán hasta que pulsen el botón “Ir” en la pantalla de
Fiori, de entrada, se mostrará en blanco.
Campos (FILTROS) nuevos:
No. Descripción Tabla/Campo Característic Requerid No. Lógica ó Estructura Rol
a o Fuente (ODATA)
1 Nombre del Cliente BUT000- Múltiple Si Crear Nuevo Ej. Rol Comisionista
BU_SORT2 en Combo-box
Función de interlocutor caso de que sea Funciones de ZZ_Rep_Folios_Entrega
comercial = Cliente blancos tomar el selección en el
nombre del campo combo box
BUT000-
 NAME_ORG1

2 Tipo de comisión Z_COMISION- Múltiple SI Crear Nuevo Ej. Rol Comisionista

ZTIPO combo box
ZZ_Rep_Folios_Entrega
3 Capturados de: Fecha VBRP – ERDAT Range Date SI Crear Nuevo Ej. Rol Comisionista
captura inicio (Fecha de Selection
creación del ZZ_Rep_Folios_Entrega
registro)

4 Capturados de: Fecha VBRK-FKDAT Range Date SI Crear Nuevo Ej. Rol Comisionista
captura Fin (fecha factura) Selection
VBRP – ERDAT ZZ_Rep_Folios_Entrega
(Fecha de
creación del
registro)

5 Consignatario / LIKP – KUNNR Múltiple SI Crear Nuevo Ej. Rol Comisionista

Destinatario: Enviar los 2 combo box
campos, pero en ZZ_Rep_Folios_Entrega
este sería:
(BUT000-
BU_SORT2) en
caso de que sea
blancos tomar el
nombre del
campo BUT000-
NAME_ORG1

6 Estatus Comisión: Z_COMISION – Múltiple SI Crear Nuevo Ej. Rol Comisionista

ZCOMF y la combo box
denominación de ZZ_Rep_Folios_Entrega
ZAUTORCOMI
SION y el campo
custom
Denominación.
7 Factura VBRP – VBELN SI Crear Nuevo Ej. Rol Comisionista

ZZ_Rep_Folios_Entrega

En este caso de deberá colocar el ícono de “Adaptar filtros”:

Descripción de Lógica de los Campos:

1. Nombre del Cliente: Este campo filtro se comportará de la siguiente manera:

Utilizar los CDS creados para este fin:

 ZPCV_Clientes. - para la extracción de los clientes correspondientes al comisionista.

Se aplicará de la misma forma que esos CDS, donde se deberá tomar el l usuario SCP (SAP Cloud Portal).
Tendrán acceso a este aplicativo los usuarios a los que se les otorgue el acceso en Fiori.
Esto aplicará solo para el Rol de comisionistas.

De este CDS se obtendrá el campo KUNNR con lo cual se deberá usar para mostrar los registros de la tabla
VBRK (Factura: Datos de cabecera); se deberá como inicio tomar el campo de número del cliente:

VBRK- KUNAG (Solicitante)

Representa al cliente al que se le realizó el pedido de venta.

Con este dato se deberá ligar a la tabla:

Descripción TABLA-CAMPO OP. TABLA-CAMPO

Cliente / Interlocutor VBRK- KUNAG = BUT000-PARTNER
comercial
El campo para tomar en este filtro será: (BUT000- BU_SORT2) en caso de que sea blancos tomar el
nombre del campo BUT000-NAME_ORG1

2. El tipo de comisión será registrado en la tabla custom Z_COMISION:

Z_COMISION - ZTIPO

Con el número de la factura se deberá establecer la siguiente unión a las tablas de facturas: cabecero
y detalle (VBRK - Factura: Datos de cabecera y VBRP - Factura: Datos de posición) y
posteriormente a la tabla Z_COMISION:

Descripción TABLA-CAMPO OP. TABLA-CAMPO

Factura VBRK- VBELN = VBRP-VBELN
Factura VBRK-VBELN = Z_COMISION-VBELN
O bien Factura VBRP-VBELN = Z_COMISION-VBELN
Es una sugerencia realizar esta unión sin embargo se pide de forma técnica ver la mejor forma de
realizar de tomar de estas tablas el campo requerido de Z_COMISION.

3. Fecha de captura de la factura inicio:

VBRP – ERDAT
(Fecha de creación del registro)

4. Fecha de captura de la factura Fin:

VBRP – ERDAT
(Fecha de creación del registro)

5. Consignatario /Destinatario. Este campo de filtro se deberá obtener de forma automática del control
de accesos ZPCV_DM. - para la extracción de los destinatarios o consignatarios del comisionista.
Cuyo objetivo es poner el campo KUNNR que se obtiene de este cds y que permitirá filtrar con el
siguiente:
LIKP – KUNNR (BUT000- BU_SORT2) en
caso de que sea blancos tomar el
Enviar los 2 campos, pero en este sería: nombre del campo BUT000-
NAME_ORG1

6. Estatus de la factura.

Este campo se deberá tomar del campo:

Z_COMISION – ZCOMF y para extraer la descripción o denominación del campo se deberá ligar a
la tabla custom:

ZAUTORCOMISION

Este estatus puede ser:

- Sin folio,
 - entregado
- revisado,
- en rep de comisión,
7. Factura. El número que identifica de forma unívoca el documento de facturación (por ejemplo, la
factura). Este campo se puede tomar de:
- Z_COMISION – VBELN,
- O bien de la VBRK – VBELN
- O bien de la VBRP – VBELN
Lo que sea más fácil tomar.

II. Datos de Detalle

En el detalle se pueden tomar todos los campos de estas tablas una vez unidas, para que el usuario pueda
seleccionar los que requiere mostrar u ocultar en caso necesario:

Campos nuevos:
# Descripción Tabla/Camp Característica Req No. Lógica ó Estructura Fuente Rol
o ueri (ODATA)
do
1 # Sec Número Número consecutivo que se Si Crear Nuevo Ej. Rol
consecutivo deberá poner desde el Comisionista
en Fiori desarrollo en Fiori para ZZ_Rep_Folios_Entrega
enlistar o enumerar los
registros mostrados.
2 Factura VBRP – Número de la factura Si Crear Nuevo Ej. Rol
VBELN Comisionista
ZZ_Rep_Folios_Entrega
2ª Clase de VBRK - Es importante enviar este No Crear Nuevo Ej. Rol
documento FKART campo para así tener la clase Comisionista
de factura. ZZ_Rep_Folios_Entrega
3 Fecha Factura VBRK- Fecha en la que se facturó el Si Crear Nuevo Ej. Rol
FKDAT documento. Comisionista
ZZ_Rep_Folios_Entrega
4 Orden de VBRK - Número de documento de Si Crear Nuevo Ej. Rol
compra XBLNR referencia Comisionista
ZZ_Rep_Folios_Entrega
5 Número LIKP – Si Crear Nuevo Ej. Rol
Destinatario de Mercancías
destinatario KUNNR Comisionista
ZZ_Rep_Folios_Entrega
5ª Nombre Del (BUT000- Nombre del destinatario de Si Crear Nuevo Ej. Rol
destinatario BU_SORT2) mercancías Comisionista
en caso de ZZ_Rep_Folios_Entrega
que sea
blancos
tomar el
nombre del
campo
BUT000-
NAME_OR
G1
6 Fecha Captura VBRP - Fecha de creación del registro Si Crear Nuevo Ej. Rol
ERDAT Comisionista
ZZ_Rep_Folios_Entrega
7 Usuario VBRP- Usuario que añadió o registro Si Crear Nuevo Ej. Rol
ERNAM el documento Comisionista
ZZ_Rep_Folios_Entrega
8 Fecha Entrega Z_COMISIO Si Crear Nuevo Ej. Rol
Fecha real que se entrego el
N – ZFENT Comisionista
material al cliente
(Fecha de ZZ_Rep_Folios_Entrega
entrega)
 9 Folio Z_COMISIO SI Crear Nuevo Ej. Rol
Folio de recepción otorgado
N - ZFOLI Comisionista
por el cliente al recibir la
ZZ_Rep_Folios_Entrega
Orden de compra en su
sistema
10 Contra recibo Z_COMISIO SI Crear Nuevo Ej. Rol
Contra recibo o CYC
N - ZRELC Comisionista
ZZ_Rep_Folios_Entrega
11 Comisión PRCD_ELE SI Crear Nuevo Ej. Rol
(Valor o importe de la
MENTS – Comisionista
condición)
KWERT ZZ_Rep_Folios_Entrega
Importe de la comisión que se
tomará por un lado de la tabla
PRCD_ELEMENTS y por
otro deberá apuntar a la Épica
109

Lógica de los Campos correspondiente a las ventas:

Como parte de las ventas se deberán tomar en cuenta las siguientes clases de documento de venta:

ZB08 Factura Comisionistas

Para lo cuál se pide colocar de la tabla de control de accesos, de modo tal que dependiendo el rol del usuario
que ingrese a la aplicación deberá mostrar las facturas indicadas en esa tabla de control: ZPCSIS_FAC (Clase
de factura de acuerdo con el rol)

1. # Secuencia. Es un número consecutivo que se deberá colocar desde la app de Fiori que permita
ordenar y visualizar los registros requeridos. No es un campo como tal en la Odata.

2. Factura. El número que identifica de forma unívoca el documento de facturación (por ejemplo, la
factura). Este campo se debe tomar de:
VBRP – VBELN

Es importante mencionar que se debe crear una liga o unión entre las siguientes tablas que ya se
señaló arriba, pero a modo de resumen:

VBRK, VBRP y Z_COMISION

DESCRIPCIÓN TABL CAMPO E TABLA CAMPO

A Q

Número de documento de VENTA VBRK VBELN = VBRP VBELN

Número de documento de VENTA VBRP VBELN = Z_COMISIO VBELN

O bien VBRK VBELN = Z_COMISIO VBELN

Esta factura va a tener un link al detalle de la misma. Esto será en la Épica 90 - Link
“Factura” Esto puede ser como tal una factura o bien una nota de crédito.
 2ª.- Es importante señalar que por ahora estas son las clases de factura que se colocaron en el control de
accesos para saber que clases de documento usar:

Campo: VBRK - FKART

Clase de documento Denominación de la clase de doc

Factura

ZB08 Factura Comisionistas

3. Fecha Factura. Representa la fecha en la que se generó el documento de facturación:

VBRK-FKDAT

4. Orden de compra: Número de documento de referencia

VBRK – XBLNR

5. Número Destinatario y Nombre del destinatario. Enviar ambos campos en la Odata:

 LIKP – KUNNR (Destinatario de mercancías)

Con este dato unirse a la tabla BUT000 para extraer el nombre del destinatario:

Descripción TABLA-CAMPO OP. TABLA-CAMPO

Destinatario / Interlocutor LIKP – KUNNR = BUT000-PARTNER
comercial

El campo Nombre del Destinatario será: (BUT000- BU_SORT2) en caso de que sea blancos tomar
el nombre del campo BUT000-NAME_ORG1

Para obtener el campo LIKP-KUNNR (Destinatario de mercancías) se deberá ingresar a la tabla VBFA:
Unir la tabla VBRP con VBFA:
DESCRIPCIÓN TABL CAMPO EQ TABL CAMPO

A A

Número de documento de VENTA VBRP VBELN = VBFA VBELN

Posición de la factura VBRP POSNR = VBFA POSNN

Y obtener el registro:
Tomar el campo VBFA-VBELV (Documento comercial anterior) cuando (Cat.doc.comercial.anterior)
VBFA-VBTYP_V = J  entrega.
Y con este campo VBFA-VBELV ir a la tabla de entregas: LIKP:

DESCRIPCIÓ TABLA CAMPO EQ TABL CAMPO

N A

Doc. Comercial VBFA VBELV = LIKP VBELN

Ant / Entrega

Una vez hecho esto, tomar el campo LIKP = KUNNR (Destinatario Mercancías), que se menciona
arriba.
Nota. Cuando se trate de un sol. De devolución o nota de crédito, esto quiere decir cuando el importe
sea negativo entonces deberá pintarlo de verde y además poner DEVOLUCIÓN DEL PRODUCTO.

6. Fecha Captura. Puede ser la fecha de creación del registro:

VBRP - ERDAT

De cada posición mostrada en el reporte. Esto puede ser de una factura, pero por cada posición.

7. Usuario. Nombre del responsable que añadió el objeto:

VBRP-ERNAM

8. Fecha Entrega. Campo customizado que representa la fecha real en que se entrego el material al
cliente físicamente en sus instalaciones:

Z_COMISION – ZFENT (Fecha de entrega)

9. Folio. Folio de la recepción que se ingresa cuando el cliente recibe el material físicamente en sus
instalaciones y al recibir la Orden de compra en su sistema le otorga un folio, mismo que se llena en
este campo: En caso de estar vacío enviar “sn”

Z_COMISION - ZFOLI

10. Contra recibo. Campo para conocer la relación de cuentas por cobrar "contrarecibo" CYC. En caso
de estar vacío enviar “sn”

Z_COMISION - ZRELC

11. Comisión. Importe de la comisión el cuál al pulsar nos llevará a un link donde se detalla la comisión,
este se encuentra detallado en la Épica 109 Comisiones -> Factura Su Almacén / Factura Otro Almacén

En la tabla VBRK (Cab. Factura) se guarda un campo de relación de condiciones (KNUMV). Con
dicho campo nos vamos a la PRCD_ELEMENTS (Pricing Elements) y vemos todas las condiciones
encontradas. En este caso debemos tomar la correspondiente a la clase de condición ZCO2. Se puede
hacer una tabla TVARVC a fin de colocar ahí la clase de condición a usar para este reporte.
 Entonces usar tablas, del registro de factura a mostrar, tomar el campo VBRK-KNUMV y en la tabla
PRCD_ELEMENTS (Pricing Elements), ingresas PRCD_ELEMENTS -KNUMV = VBRK-
KNUMV. Se descarga la información y luego se filtras por el campo PRCD_ELEMENTS
-KSCHL = ZCO2 (Clase de condición para comisiones), ejemplo:

Y de ahí tomar el campo:

PRCD_ELEMENTS – KWERT (Valor o importe de la condición)

Esto es para tomar el importe, una vez con esto se deberá colocar el link para ingresar al detalle de
las comisiones, ver Épica 109.

III. Datos de Devoluciones

Por cada factura que corresponda se deberá validar la existencia de devoluciones o solicitudes de
devolución con su correspondiente nota de crédito fiscal o factura. Se pide por parte de Fiori, colocar
un color a todo el renglón de sobre color azul claro. Y abajo se indica que campos van de color rojo
las letras y cuales en verde. El dato de “part” que significa partida se quitará de esta pantalla al no
 tener utilidad o funcionalidad. Lo mismo con el campo “CAN” que significa “basado en Cantidad”.
Se pide colocar estos subtítulos por Fiori en la pantalla, Ajustar a fin de quedar linda para
entendimiento.

# Descripción Tabla/Camp Característica Req No. Lógica ó Estructura Fuente Rol

o ueri (ODATA)
do
a Factura VBFA- Documento relacionado SI Crear Nuevo Ej. Rol
VBELV Factura Comisionista
ZZ_Rep_Folios_Entrega
1 Solicitud de VBFA - Solicitud de devolución SI Crear Nuevo Ej. Rol
Devolución VBELN ligada a la factura. Pintar de Comisionista
color rojo ZZ_Rep_Folios_Entrega
1a Números de VBFA- Enviar por servicio Odata, SI Crear Nuevo Ej. Rol
posición o POSNN pero no imprimir en la Comisionista
partidas de la pantalla de Fiori o dejar como ZZ_Rep_Folios_Entrega
devolución una columna para mostrar u
ocultar.
2 Nota de VBFA – Número de la nota de crédito. Si Crear Nuevo Ej. Rol
Crédito Fiscal VBELN En Fiori pintar de color rojo. Comisionista
(Factura): ZZ_Rep_Folios_Entrega
3 Fecha VBRK- Fecha de la nota de crédito. Si Crear Nuevo Ej. Rol
Factura / NCR FKDAT Tomar la fecha del cabecero e Comisionista
imprimir tantas posiciones ZZ_Rep_Folios_Entrega
existan
4 Motivo de VBAK- Motivo de la devolución, la Si Crear Nuevo Ej. Rol
devolución AUGRU cuál se deberá configurar el Comisionista
+ siguiente concepto: ZZ_Rep_Folios_Entrega
TVAUT- “A26 – Devolución del
BEZEI producto” y en Fiori pintarlo
de verde.

5 Número de VBRP- Número del lote de cada SI Crear Nuevo Ej. Rol
Lote CHARG posición de la solicitud de Comisionista
nota de devolución. ZZ_Rep_Folios_Entrega
6 Cantidad VBAP- Se puede tomar de cualquiera SI Crear Nuevo Ej. Rol
ZMENG de estos campos, ya que Comisionista
VBRP- ambas son útiles para la ZZ_Rep_Folios_Entrega
FKIMG cantidad. Por cada posición
7 Unidad de VBAP- Unidad de medida de venta SI Crear Nuevo Ej. Rol
medida VRKME de cada posición Comisionista
VBRP- ZZ_Rep_Folios_Entrega
VRKME
8 Importe Nota VBRP- Como este importe refiere al SI Crear Nuevo Ej. Rol
de crédito NETWR + total por posición con Comisionista
PRCD_ELE impuestos, se pide sumar ZZ_Rep_Folios_Entrega
MENTS – dichos valores y colocar En
KBETR negativo

9 Importe de PRCD_ELE Valor o importe de la SI Crear Nuevo Ej. Rol

comisión MENTS – condición ZCO2 en negativo Comisionista
KWERT ZZ_Rep_Folios_Entrega

Lógica de los Campos de registros correspondientes a devoluciones:

Como parte de las ventas se deberán tomar en cuenta las siguientes clases de documento de devoluciones:

ZRS1 Sol Dev Comisionista

Para lo cual se pide colocar en una tabla TVARVC ejemplo: ZCLASE_DEVOLUCION y colocar estos
valores. De modo tal que si fuera necesario a futuro quitar o agregar alguna clase de documento lo permita
hacer sin modificar el programa. Evaluar si esto quedará también en el control de accesos, ya que ahí se
deberá indicar para el rol en este caso de comisionistas la clase de documento para devolución.
 Se deberá realizar además una validación para extraer el documento de devolución referenciado a la factura.
Con el objetivo de tomar la relación de dicha devolución con la factura y así imprimir justo debajo de cada
registro de factura a la cuál corresponda.

El 1er paso sería tomar las notas de devolución en este caso las indicadas en la tabla TVARVC, ej. ZRS1
(Devolución de Comisionistas) o bien los indicados en dicha tabla de la VBRK, con el objetivo de buscar
aquellos que contengan devoluciones.

Ya se había establecido la unión con esta tabla VBFA sin embargo se indica nuevamente:
Unir la tabla VBRK con VBFA:

DESCRIPCIÓN TABL CAMPO EQ TABL CAMPO

A A

Número de documento de VENTA VBRK VBELN = VBFA VBELN

Y obtener el registro de la factura, campo VBFA-VBELN:

Colocar el número de la factura en el campo VBFA-VBELV (Documento comercial anterior), cuando
(Cat.doc.comercial.anterior) VBFA-VBTYP_V = M  Factura y (Categoría de documento del documento
siguiente) VBFA - VBTYP_N = H  Devoluciones y VBFA – POSNV (Posición anterior de un documento
comercial) > cero.
a.- Factura – Documento relacionado.- Refiere al documento relacionado a la devolución a fin de tener la
unión de esta. Para ello de igual forma que lo ya mencionado se deberá tomar el campo: VBFA – VBELV
(Factura).

Cuando el campo VBFA-VBTYP_N (Categoría de documento del documento siguiente) = H ( Devoluciones) y

Cuando el campo VBFA-VBTYP_V (Categoría del documento comercial anterior) = M (Factura);
1. Solicitud de devolución y 1ª. Número de posición . Una vez con lo anterior, tomar los siguientes
campos:
Y esto tomar los campos VBFA- VBELN de cada posición, así como el VBFA- POSNN (Posición
subsiguiente de un documento comercial) los cuáles deberán ser considerados para enviarse por el servicio
Odata así como en mostrarse en Fiori dichas posiciones justamente ligadas a la factura, se mostraran debajo
de la misma, pintadas de color rojo. En la pantalla de Fiori original no se mostrará el campo de posición, pero
si se enviará para en dado caso mostrar u ocultar a elección del usuario.
Estos mismos campos se usarán para unirse a la tabla de VBAP (Pedidos: Datos de posición) y VBAK
(pedidos: Datos de cabecera)

DESCRIPCIÓ TABLA CAMPO EQ TABL CAMPO

N A

Doc. Comercial VBFA VBELV = VBAK VBELN

Ant

VBFA VBELV = VBAP VBELN

VBFA POSNN = VBAP POSNR

2. Nota de Crédito Fiscal (Factura): con los mismos datos anteriores que se usaron para extraer la solicitud
de devolución, pero ahora para unir con la tabla de VBRP (Factura: Datos posición) y VBRK
(Factura: Datos de cabecera), para así traer el campo de Nota de crédito fiscal o Factura:

Pasos:
a) 1ero con el valor VBFA- VBELN obtenida en el punto 2, que representa la solicitud de
devolución, ingresar nuevamente en la tabla VBFA:
Colocar el número de la solicitud en el campo VBFA-VBELV (Documento comercial
anterior), cuando (Cat.doc.comercial.anterior) y VBFA – POSNV (Posición anterior de un
 documento comercial), VBFA- VBTYP_N = O  Abono y (Categoría del documento
comercial anterior) VBFA - VBTYP_V = K  Solicitud de abono.
Tomar el campo: Documento comercial subsiguiente (VBFA – VBELN) y Posición subsiguiente de
un documento comercial (VBFA – POSNN) que representa la nota de crédito Fiscal. Además, te
tomarla para enviarla por el servicio Odata, y mostrar por Fiori en color rojo, nos servirá para unir
con la VBRP y así tomar los demás datos:

Se deberá tomar o repetir el valor tantas posiciones existan.

Estos mismos campos se usarán para unirse a la tabla de VBRP (Factura: Datos de posición):
DESCRIPCIÓ TABLA CAMPO EQ TABL CAMPO

N A

Doc. Comercial VBFA VBELN = VBRP VBELN

Ant

VBFA POSNN = VBAP POSNR

3. Fecha Factura / NCR. Tomar del cabecero de la factura:

VBRK-FKDAT

4. Motivo de devolución: Este motivo de coloca en la solicitud de devolución, y va por cabecero del
mismo, por lo que se pide imprimir o repetir tantas posiciones existan.

VBAK-AUGRU + TVAU – BEZEI

Unirse a la tabla de Motivos de Pedidos:

TABLA CAMPO EQ TABL CAMPO

DESCRIPCIÓ
A
N

Motivo o razón VBAK AUGRU = TVAU AUGRU

del pedido.

Tomar el campo de “Denominación” TVAU- BEZEI

Nota. El servicio Odata puede enviar por separado o bien si puede enviar concatenado AUGRU + BEZEI, en
caso de que no sea posible Fiori deberá concatenar y pintar de verde.

5. Número del lote. De la nota de crédito ya con las tablas unidas tomar el siguiente campo que se toma por
cada posición:

VBRP-CHARG

6. Cantidad. Como la solicitud de nota de crédito será procesado automáticamente hasta generar la factura,
la cantidad se puede tomar tanto de la solicitud del pedido como de la cantidad facturada:

VBAP- ZMENG
VBRP- FKIMG

7. Unidad de medida. De igual forma al campo anterior, si se toma el campo de una tabla u otra considerar
la Unidad de medida de una u otra tabla, por cada posición:

VBAP-VRKME
VBRP-VRKME

8. Importe de la nota de crédito Tomar el importe de la nota fiscal o nota de crédito, que refiere al importe
de cada posición + Impuestos:
 Importe Bruto de la Nota de crédito = (Valor neto de posición de factura en moneda de documento)
VBRP-NETWR + PRCD_ELEMENTS – KBETR (Importe o porcentaje de la condición)

Extraer el valor del impuesto:

PRCD_ELEMENTS (Pricing Elements) para respetar el que haya sido tomado en la Nota de
crédito como tal, en caso de no contener deberá dejar en blanco, y arrojar un error de falta de
impuesto, luego así tomar el campo:

PRCD_ELEMENTS – KBETR (Importe o porcentaje de la condición)

En la tabla VBRK (Cab. Factura) se guarda un campo de relación de condiciones (KNUMV). Con
dicho campo nos vamos a la PRCD_ELEMENTS (Pricing Elements) y vemos todas las condiciones
encontradas. En este caso debemos tomar la correspondiente a la clase de condición MWST. Se
puede hacer una tabla TVARVC a fin de colocar ahí la clase de condición a usar para este reporte.

Entonces usar tablas, del registro de la nota de crédito a mostrar, tomar el campo VBRK-KNUMV y
en la tabla PRCD_ELEMENTS (Pricing Elements), ingresas PRCD_ELEMENTS -KNUMV =
VBRK-KNUMV. Se descarga la información y luego se filtras por el campo PRCD_ELEMENTS
-KSCHL = MWST (Clase de condición para el IVA), ejemplo:
 Y de ahí tomar el campo:

PRCD_ELEMENTS – KBETR (Importe o porcentaje de la condición)

9. Importe de la comisión: Importe de la comisión el cuál al pulsar nos llevará a un link donde se detalla la
comisión, este se encuentra detallado en la Épica 109 Comisiones -> Factura Su Almacén / Factura Otro
Almacén

PRCD_ELEMENTS – KWERT

En la tabla VBRK (Cab. Factura) filtramos con el número de la nota de crédito obtenida anteriormente, se
guarda un campo de relación de condiciones (KNUMV). Con dicho campo nos vamos a la
PRCD_ELEMENTS (Pricing Elements) y vemos todas las condiciones encontradas. En este caso debemos
tomar la correspondiente a la clase de condición ZCO2. Se puede hacer una tabla TVARVC a fin de colocar
ahí la clase de condición a usar para este reporte.
 Entonces usar tablas, del registro de factura a mostrar, tomar el campo VBRK-KNUMV y en la tabla
PRCD_ELEMENTS (Pricing Elements), ingresas PRCD_ELEMENTS -KNUMV = VBRK-
KNUMV. Se descarga la información y luego se filtras por el campo PRCD_ELEMENTS
-KSCHL = ZCO2 (Clase de condición para comisiones), ejemplo:

Y de ahí tomar el campo:

PRCD_ELEMENTS – KWERT (Valor o importe de la condición)

Esto es para tomar el importe, una vez con esto se deberá colocar el link para ingresar al detalle de
las comisiones, ver Épica 109. Como este importe corresponde a la nota de crédito se encontrará en
la tabla con valor en negativo, se pide respetar el signo y colocar en pantalla y en el servicio Odata
con valor negativo.

6.2 PARAMETRIZACIÓN PREVIA /INICIAL

1. Parametrización de la Clase de condición. Es importante que durante la implementación se configure
las clases de condición en este caso referente a comisiones ZCO2 por estándar, incluyendo esquema de
precios, secuencias de acceso, etc.
2. Registrar las comisiones en ZCO2 en VK11 por carga masiva o manual.
3. Alta de clientes
4. Alta de materiales
5. Alta de clases de factura (configuración)

6.3 PRECIOS Y TECNICAS DE CONDICIÓN

6.4 DIAGRAMA DE FLUJO
El esquema de cálculo en el back end contiene todos los registros de condición para clientes individuales,
desde condiciones simples para puntos de venta individuales hasta condiciones complejas para empresas
multinacionales. El maestro de materiales incluye datos relevantes para la determinación de precio, por
ejemplo, las unidades de medida físicas (UM) y conversiones de UM. Durante la sincronización de los
datos de ruta desde el back end a los dispositivos móviles, solo se envían los datos de determinación de
precio relevantes para clientes en las rutas a los dispositivos móviles. El determinador de precios utiliza
clientes relevantes par ruta, material y registros de condición junto con datos de Customizing y
conversión para calcular los precios en los dispositivos móviles.

En este reporte se usará la clase de condición de precios ZCO2 para determinar el % de comisión que será
calculado en cada factura.

6.5 MENSAJES DE RETORNO A LA APP DE

FIORI AL EMITIR UN REPORTE EN S4 HANA

Es muy importante el poder enviar a la app en Fiori los mensajes de error que se hayan generado al
ejecutar un reporte. A continuación, algunos ejemplos de los errores, por los cuales no se pudo
concluir el reporte en S4/HANA y Fiori:
 - Como tal siendo un reporte donde solo visualización, no existen casi errores, sin embargo,
uno posible sería:

a. Cuando no se tienen los datos del comisionista si por alguna razón hay algún error que
no permita al CDS de control de accesos funcionar correctamente: “Faltan datos de
control de acceso”
b. Cuando no se tiene el importe del comisionista ya que no haya sido calculado
automáticamente en la factura: “ZCO2 inexistente falta comisión”
c. Cuando no existe el link para la comisión: “No existe datos de la comisión”
d. Cuando no exista el link para la factura: “no se puede ver el detalle de facturación”
e. Se debe considerar que cuando la nota de crédito que es un registro con importe
negativo deberá imprimirse junto con la factura relacionada. En caso de no encontrar la
relación por algún error, “Nota de crédito no referenciada”
f. Si por alguna razón no existiera la factura o la nota de crédito a mostrar en la tabla
Z_COMISION, deberá arrojar un error: “Documento inexistente en la tabla
Z_COMISION”
g. Cuando se coloquen datos no congruentes en algún campo del filtro, Cliente invalido,
“Ha indicado datos no válidos o inconsistentes en un campo como mínimo. Corrija
el error antes de continuar con la búsqueda”

Error en pantalla:

6.6 TABLAS RELACIONADAS:

Tablas Relacionadas:

Tabla Nombre Comentarios

PRCD_ELEMENT Pricing Elements
S
VBRK Factura: Datos de cabecera
BUT000 IC Datos generales I
VBRP Factura: Datos de posición
Z_COMISION Tabla custom comisiones
VBAK Pedidos: Datos de cabecero
VBAP Pedidos: Datos de posición
TVAU Motivos de pedido

6.7 DISEÑO DE LA ANTALLA DE REPORTE

FOLIOS DE ENTREGA
1. Diseño de la pantalla REPORTE DE FOLIOS DE ENTREGA:
6.8 VOLUMEN DE DATOS:
Alto – 100 o más veces diarias

6.9 TIPO DE PROCESAMIENTO:

Síncrono.

6.10 FRECUENCIA DE EJECUCIÓN:

Diaria – 100 o más veces diarias

6.11 AUTORIZACIONES:
N/A

6.12 TIPO DE PROCESAMIENTO:

N/A

6.13 CONSIDERACIONES ESPECIALES:

N/A
6.14 PROCEDIMIENTOS DE CONTINGENCIA:
N/A

6.15  FIORI CUSTOM:

Patrón de diseño:
List report
Master Detail
Diagram
Shopping cart
Otro Especifique:

6.16  ID HISTORIA DE USUARIOS:

81 – EMBARQUES - REPORTE DE FOLIOS DE ENTREGA

6.17  CRITERIOS DE TERMINADO:

6.18  CRITERIOS DE ACEPTACIÓN:

6.19  TIPO DE DISPOSITIVO:

Chico, Mediano y Grande (smartphone, Tablet, escritorio)
7 E s p e c i fi c a c i ó n F u n c i o n a l

Tipo de Desarrollo Componente Requerido

Crear una nueva aplicación

Sap Script / Report
8 Glosario de Conceptos

Para las nomenclaturas y el glosario SAP revise el siguiente documento anexo:

Glosario y
Nomeclaturas SAP.docx

8.1 CONTROL DE CAMBIOS:

N/A

8.2 CORREO DE CONFIRMACIÓN DEL CAMBIO:

N/A
9 Casos de Prueba

Los casos de Prueba se verán en un documento independiente y serán responsabilidad de los Producto
Owner.