Requisitos de DSP

4 min

Requisitos Funcionales

ID	Tipo	Requisito
1	Obligatorio	El access_token debe ser actualizado automáticamente cada 90 minutos
2	Obligatorio	El API de Autenticación de Concesionarios access_token y refresh_token deben ser guardados y utilizados por todos los usuarios que tengan permiso para gestionar pedidos de piezas.
3	Obligatorio	El API de Autenticación de Concesionarios token_de_acceso debe ser renovado cada 2 horas usando el token_de_refresco.
4	Obligatorio	El concesionario debe validar (Validar servicio) antes de enviar (Crear servicio) el pedido de piezas.
5	Obligatorio	Los mensajes de advertencia y error devueltos por el servicio de Validar y Crear deben ser mostrados al concesionario.
6	Obligatorio	Un pedido de piezas creado debe ser actualizado llamando al servicio Get para recuperar la información más reciente hasta que el pedido sea enviado. El servicio Get puede ser llamado cuando el concesionario muestra el pedido de piezas o periódicamente en segundo plano.
7	Obligatorio	El código de estado 504 de tiempo de espera de puerta de enlace debe ser gestionado llamando al servicio de Verificación hasta que se cree el pedido de piezas tanto para los servicios de Crear como de Validar.
8	Obligatorio	Los métodos de envío disponibles para el distribuidor deben obtenerse de la API de distribuidores. El método de envío predeterminado debe ser el primero devuelto por el API de distribuidores.
9	Obligatorio	El concesionario debe poder cancelar uno o varios artículos en un pedido de piezas si el pedido no está completado o enviado.
10	Obligatorio	El DMS debe utilizar el servicio Get para realizar una carga inicial, recuperar todos los pedidos de piezas de los últimos 90 días y guardarlos en la base de datos del DMS. Si se ha creado un pedido de piezas en su DMS, el pedido de piezas debe actualizarse con la nueva información recibida a través de la API de Pedido de Piezas. Si el pedido de piezas no existe, debe ser creado en su DMS.
11	Obligatorio	El servicio Get debe ser utilizado diariamente para recuperar el pedido de piezas de los últimos 30 días y guardarlos en la base de datos DMS. Si se ha creado un pedido de piezas en su DMS, el pedido de piezas debe actualizarse con la nueva información recibida a través de la API de Pedido de Piezas. Si el pedido de piezas no existe, debe ser creado en su DMS.
12	Obligatorio	El concesionario debe poder encontrar un pedido de piezas utilizando un número de entrega.
13	Obligatorio	El concesionario debe poder encontrar un pedido de piezas utilizando un número de factura.
14	Opcional	El concesionario puede encontrar un pedido utilizando el número de seguimiento del transportista.
15	Opcional	El concesionario puede cargar manualmente los pedidos de piezas proporcionando un rango de fechas.
16	Obligatorio	Para cada pedido de pieza, la siguiente información específica de BRP debe estar disponible para el concesionario: El número de orden de venta sales_order_no El estado del pedido encabezado_estados Para cada elemento: El estado de entrega deliveries.status_code El número del artículo de entrega deliveries.item_no El número de entrega deliveries.no
17	Obligatorio	Cuando se muestra un pedido de piezas, el shipping_lines campo debe ser mostrado al usuario. El ordered_lines campo también puede ser mostrado, pero el DMS debe mostrar claramente que el concesionario recibirá las piezas listadas en el shipping_lines campo.
18	Opcional	El concesionario debería poder recuperar un solo pedido de piezas utilizando el número de pedido de ventas. Su DMS debería estar llamando al Obtener Pedido endpoint.
19	Opcional	El concesionario debería poder recuperar resúmenes de pedidos de piezas. En este caso, su DMS debería estar llamando al Obtener Pedidos punto final utilizando el resumen parámetro.

Actividades de Certificación

Esta sección presenta todas las actividades de certificación y validaciones que deben completarse para certificar la API.

Aseguramiento de la Calidad

Las pruebas enumeradas en la tabla a continuación deben completarse con éxito en el entorno de prueba antes de que puedas comenzar la fase piloto del distribuidor.

👉 Para ejecutar las pruebas, necesitas credenciales de distribuidor de BOSSWeb en el entorno de prueba. Si no las tienes, abre un ticket en el Jira de DCP.

ID	Prueba	Resultado Esperado
1	Verifique los métodos de envío disponibles para el concesionario en el DMS.	Los métodos de envío deben ser los mismos que el devuelto por el API de distribuidores y el predeterminado debe ser el primero devuelto en la respuesta.
2	Valide un pedido de piezas con 20 piezas válidas y muestre los mensajes de advertencia y error.	El pedido de piezas es válido, sin mensajes de advertencia o error.
3	Valide un pedido de piezas con una pieza descontinuada (1301200012). Muestra los mensajes de advertencia y error.	El pedido de piezas es inválido y se muestra el mensaje de error.
4	Validar un pedido de piezas con 45 líneas de artículos. Llama al servicio de verificación hasta que el pedido esté validado.	El pedido de piezas es válido, sin mensajes de advertencia o error.
5	Valide y cree un pedido de piezas con 20 piezas válidas y muestre los mensajes de advertencia y error.	El pedido de piezas ha sido creado y mostrado.
6	Obtenga el pedido de piezas creado y muestre el resultado.	El pedido de piezas se muestra.
7	Crea un pedido de piezas con 45 piezas válidas. Llama al servicio de verificación hasta que se cree el pedido.	El pedido de piezas ha sido creado y mostrado.
8	Llama al servicio Obtener Pedidos para recuperar los pedidos de piezas creados en los últimos 7 días.	Los pedidos de piezas han sido cargados en su DMS. El equipo de DCP compara los pedidos de piezas con los que se encuentran en BOSSWeb.
9	Llama al servicio Obtener Pedidos para recuperar los pedidos de piezas en progreso.	Los pedidos de piezas han sido cargados en su DMS.
10	Cree un pedido de piezas con 1 línea de artículo. Tan pronto como se cree el pedido, cancele el artículo.	El artículo y el pedido están cancelados.
11	Valide y cree un pedido de piezas con las siguientes piezas: Un kit (505074936) Una parte sustituida (20104)	El pedido es válido y se creó con mensajes de advertencia.
12	Valide un pedido de piezas con una pieza en una línea de productos no soportada por el concesionario.	Se muestra el mensaje de error.
13	El servicio Get se llama diariamente para recuperar los pedidos de piezas	Los pedidos de piezas de los últimos 30 días están cargados en la base de datos
14	Llama a Obtener Pedido para obtener un pedido específico utilizando el número de pedido de venta. (Opcional)	El pedido de piezas está cargado en su DMS.
15	Llama al servicio Obtener Pedidos para recuperar los resúmenes de los pedidos de piezas creados en los últimos 7 días. (Opcional)	Los pedidos de piezas están cargados en su DMS.

Piloto de Concesionario

La tabla a continuación describe los parámetros y validaciones del piloto del concesionario.

Parámetro	Valor
Medio ambiente	Producción
Número de distribuidores	1 a 3
Duración	1 a 3 semanas
Validación 1	Verifique que los pedidos de piezas con más de 25 líneas de artículos sean creados.
Validación 2	Verifique que los pedidos de piezas creados se actualicen para mostrar la información de entrega.
Validación 3	Envías un informe cada semana mostrando los pedidos de piezas creados para cada distribuidor en el piloto. El informe debe mostrar el pac_order_id y el sales_order_id.
Validar 4	Realiza una demostración en vivo de la función de pedido de piezas en tu DMS en uno de los concesionarios en el piloto.
Validación 5	Verifique que los pedidos de piezas de los últimos 90 días estén cargados.
Validación 6	Verifique que los pedidos de piezas de los últimos 30 días se actualicen diariamente.