Proceso de Certificación
¿Por qué la certificación?
Como se menciona en la ¿Por qué desarrollar APIs? sección, el objetivo principal de las APIs DCP es apoyar las operaciones comerciales y el crecimiento de los concesionarios de BRP.
En este contexto, es importante que la implementación de la API DCP siga la interfaz y los comportamientos definidos y que la integración en el DSP apoye los objetivos comerciales.
La validación se realiza a través de un proceso de certificación que valida cada integración de API.
Descripción general de la certificación
Las actividades de certificación se escalan de acuerdo con la complejidad y criticidad de la API DCP. Hay tres categorías de APIs DCP:
- Las API utilizadas por el DSP para recuperar datos, como el catálogo de piezas,
- Las API utilizadas por el DSP para enviar datos a BRP, por ejemplo, el inventario de piezas del concesionario.
- Las API se utilizan para transacciones, como ordenar piezas.
En cada categoría, la complejidad de la API DCP puede ser:
- Baja: pequeña cantidad de datos y llamadas a API simples, como la especificación de unidades.
- Media: Los datos son más críticos, o hay muchas llamadas diferentes, como el localizador de piezas.
- Alta: Los datos son más complejos/críticos, y/o hay muchas llamadas diferentes a la API, como los datos de transacciones minoristas.
Las actividades de certificación para cada API DCP se describen en detalle en el Catálogo de API sección.
Una vez que se completan todas las actividades de certificación, el último paso de certificación es la fase piloto del concesionario.
Fases de Certificación
Fase 1: Desarrollo
En esta fase, comienzas el desarrollo basado en la documentación de la API DCP proporcionada en este portal.
Después de leer la documentación de la API, se puede organizar una reunión de inicio si tienes preguntas.
Durante esta fase, puedes usar simulaciones para validar la integración base de la API DCP y, cuando estés más avanzado en la integración, usar el entorno de prueba para hacer llamadas a la API.
❗❗ Al comenzar a trabajar en una API DCP, necesitamos solicitar acceso creando un ticket de certificación, como se describe en la Actividades de Certificación con JIRA sección que se encuentra a continuación.
Fase 2: Aseguramiento de Calidad
Durante esta fase, se realizan actividades de prueba, verificación y validación para confirmar que la API DCP está correctamente integrada en el DSP. Los requisitos del DSP especificados para la API DCP también se han verificado para cumplir con los requisitos comerciales. Consulta la sección Catálogo de API para una introducción a los requisitos del DSP.
Se define un conjunto diferente de actividades de certificación para cada combinación de categoría de API y complejidad. Las actividades de certificación son:
- Una demostración de la función en el DSP.
- Validación de los datos recibidos por BRP.
- Casos de prueba formales.
A menos que se especifique lo contrario, estas actividades se realizan utilizando el entorno de prueba de la API DCP y el entorno de prueba del DSP.
Al realizar las pruebas, todas las funciones de la API y del DSP, incluidos los trabajos del DSP que llaman automáticamente a la API, deben estar disponibles y verificados.
Por ejemplo, el API de piezas debe ser llamado diariamente para recuperar los cambios en el catálogo de piezas. El trabajo que llama al API de piezas debe estar habilitado durante las pruebas de la fase 2.
Fase 3: Piloto de Concesionarios
Utilizando algunos concesionarios, la fase piloto de concesionarios valida la integración y la funcionalidad del DSP en el entorno de producción.
La fase piloto del concesionario tiene como objetivo confirmar que la integración de la API de DCP está funcionando como se esperaba en el entorno de producción real y con concesionarios que utilizan el DSP para sus operaciones normales.
Durante la fase piloto del concesionario, las principales actividades son demostrar la funcionalidad del DSP y validar los datos recibidos por BRP.
👉 La demostración se puede realizar enviando capturas de pantalla o archivos o haciendo una sesión en vivo para demostrar la funcionalidad de su DSP.
Las condiciones del piloto del concesionario varían según el alcance de la API de DCP, pero normalmente se lleva a cabo con 1 a 5 concesionarios durante 1 a 3 semanas.
Mientras se realiza la fase piloto del concesionario, todas las funciones de la API y del DSP, incluidos los trabajos del DSP que llaman automáticamente a la API, deben estar disponibles y verificados.
Por ejemplo, la API de Piezas debe ser llamada diariamente para recuperar los cambios en el catálogo de piezas. El trabajo que llama a la API de Piezas debe estar habilitado durante la fase piloto del concesionario.
Estado de Certificación de la API de DCP
El equipo de DCP rastrea el estado de certificación de cada API de DSP, que está disponible para los concesionarios a través del Centro de Conocimiento de BOSSWeb.
Un DSP no puede ofrecer una funcionalidad de API de DCP a los concesionarios hasta que se complete el proceso de certificación.
Actividades de Certificación con Jira
Para ayudar con la planificación y el seguimiento de las actividades de certificación, DCP ha implementado un sistema de tickets utilizando Jira.
Se le proporciona acceso al Jira de DCP cuando esté listo para comenzar el desarrollo de la primera API. Se organiza una reunión de inicio con su equipo de desarrollo para presentar el portal de documentación de DCP y el sistema de tickets de DSCP Jira.
👉 El Jira de DCP también se utiliza para hacer preguntas, solicitar soporte y agregar/quitar miembros del equipo. Consulte la sección Obteniendo Apoyo para más información.
Esta sección describe cómo utilizar los tickets de certificación para gestionar sus actividades de certificación.
❗❗ Es importante crear el ticket de Jira para una certificación de API solo cuando comiences a trabajar en la API ❗❗
En otras palabras, ¡no uses los tickets de Jira de DCP para crear un backlog!
Flujo de trabajo
El flujo de trabajo del ticket de certificación se presenta en la imagen a continuación.
Cuando estés listo para comenzar a trabajar en una API, ve al portal de Jira de DCP y abre un ticket para la API.
❗❗ Crea el ticket de Jira solo cuando comiences a trabajar en la API ❗❗
El equipo de DCP habilita tus credenciales en la API en el entorno de QA y cambia el estado del ticket a En Desarrollo.
Cuando estés listo para comenzar la fase de aseguramiento de calidad (pruebas), cambia el estado del ticket a En Pruebas. Si tienes evidencia de pruebas para proporcionar, como capturas de pantalla, adjunta los archivos al ticket.
Cuando el equipo de DCP valida los resultados de las pruebas, el estado del ticket se cambia a En Preparación de Piloto de Distribuidor. Durante esta fase, preparas el piloto de distribuidor con los distribuidores, y el equipo de DCP habilita tus credenciales en la API en el entorno de producción.
Cuando comienza el piloto de distribuidor, cambias el estado del ticket a En Piloto de Distribuidor. Si tienes evidencia de pruebas para proporcionar, como capturas de pantalla, adjunta los archivos al ticket.
Una vez que el equipo de DCP valida los resultados del piloto de distribuidor, cambian el estado del ticket a Certificado para indicar que la API está certificada.
👉 Cada vez que cambies el estado del ticket o ingreses un comentario, el equipo de DCP recibe una notificación.
También funciona al revés: cada vez que el equipo de DCP cambia el estado del ticket o ingresa un comentario, tu equipo recibe una notificación.
El Portal de Jira
Cómo Acceder
Una vez que hayas firmado el acuerdo DCP, un miembro del equipo DCP creará un grupo para tu empresa en Jira, y tú y los miembros de tu equipo recibirán una invitación por correo electrónico.
El correo electrónico contiene un enlace para registrarte en el sistema de tickets de Jira. Una vez que hagas clic en el enlace, serás llevado a la plataforma Jira para crear tu cuenta.
✏ 👉 No desactives la notificación por correo electrónico! Si lo haces, no recibirás notificaciones cuando el ticket sea actualizado.
Menú Principal
Cuando vayas al portal DCP Jira, la siguiente pantalla aparecerá una vez que inicies sesión.
❗❗ Antes de crear un ticket, verifica que estás en el portal DCP Jira ❗❗
Revisa la sección ¡Asegúrate de estar en el portal DCP! a continuación.
Haz clic en el menú de Integración API.
Integración API
Se muestra la página de Certificación y Soporte DCP.
- Selecciona A Integración API en la lista de Contáctanos sobre.
- Haz clic en Certificación de Integración API.
- Se muestra el formulario de ticket de Certificación de Integración API.
Formulario de Ticket de Certificación de Integración API
Se muestra un formulario donde debes ingresar los detalles de la solicitud.
Para ayudar a gestionar el ticket, el campo del encabezado debe verse así:
Certificación API - [nombre de tu organización] - [nombre de API]
Por ejemplo:
Certificación de API - MyDMS - Información de DSP
Luego selecciona la API en el ¿En qué API deseas certificarte? lista.
Finalmente, proporciona estimaciones aproximadas para las fechas de inicio y finalización para ayudarnos a rastrear tu cronograma de certificación y brindarte un mejor apoyo.
Haz clic en Enviar para enviar tu ticket.
Cómo Cambiar el Estado de un Ticket de Certificación
Como se mencionó en la Flujo de Trabajo sección, debes cambiar el estado de un ticket de certificación en 2 pasos del flujo de trabajo:
- Cuando estés listo para comenzar la fase de aseguramiento de calidad (prueba), cambia el estado del ticket a En Prueba. Si tienes evidencia de prueba para proporcionar, como capturas de pantalla, adjunta los archivos al ticket.
- Cuando comience el piloto del distribuidor, cambia el estado del ticket a En Piloto del Distribuidor. Si tienes evidencia de prueba para proporcionar, como capturas de pantalla, adjunta los archivos al ticket.
Para cambiar el estado del ticket, ábrelo y mira en el lado derecho del formulario, resaltado en verde en la imagen a continuación.
En este ejemplo, haz clic en el Mover a Dealer Pilot, y se abrirá una ventana. Puedes ingresar un comentario y hacer clic en Mover a Dealer Pilot.
El equipo de DCP recibe una notificación del cambio de estado.
¡Asegúrate de estar en el portal de DCP!
El DCP Jira está utilizando Jira Service Management (JSM).
🛑 ¡Tienes acceso a todos los proyectos de JSM en BRP!
Así que, antes de crear un ticket, asegúrate de estar en el portal de Certificación y Soporte de DCP.
Cuando estés en el portal de DCP Jira, haz clic en el Centro de Ayuda enlace en la esquina superior izquierda. Serás enviado a la página principal de BRP JSM, donde ¡puedes ver todos los portales!
¡Se ignorará si creas un ticket en un portal que no sea el
portal de Certificación y Soporte de DCP!Si estás en la Help Center página principal, la forma más segura de encontrar el DCP Certification and Support portal es usar el campo de búsqueda y buscar DCP.
Se muestra una lista de recursos de ayuda.
Puedes abrir uno de los formularios de DCP desde el resultado de búsqueda o ir al DCP Certification and Support portal.
Hoja de Ruta de Desarrollo
A menos que tú y DCP hayan acordado una hoja de ruta diferente, las API deben desarrollarse y certificarse en el orden presentado a continuación.
DMS
Prioridad | Nombre de la API |
|---|---|
1 | |
2 | |
3 | |
4 | |
5 | |
6 | |
7 | |
8 | |
9 | |
10 | |
11 | |
12 | |
13 | |
14 | |
15 | |
16 | |
17 |
CRM
Prioridad | Nombre de la API |
|---|---|
1 | |
2 | |
3 | API de Promociones (opcional) |
4 | API de Unidades (opcional) |
5 | API de piezas (opcional) |