Empezando
¿Dónde empezar? ¡Léeme primero!
Antes de comenzar a trabajar en esta API, necesitas leer las siguientes secciones si aún no las has revisado:
Los Tipos de Transacción
Hay tres tipos de transacciones realizadas por un concesionario:
- Partes: Ventas de Partes, Accesorios y Ropa (PA&A) a un cliente.
- Trabajos: Órdenes de reparación para la reparación y mantenimiento de vehículos.
- Unidades: Ventas de un vehículo a un cliente.
Los tres tipos de transacciones se envían en el Transacciones recurso y muchas transacciones pueden enviarse en la misma llamada.
El concesionario debe consentir el intercambio de datos antes de que envíes la transacción del concesionario a BRP.
Consulta la Compartición de Datos sección para más información sobre el intercambio de datos.
La carga útil de la API de Transacciones Minoristas contiene mucha información. A veces, su DMS puede no ser capaz de proporcionar la información solicitada.
Está bien, y cada caso se discutirá durante las actividades de certificación. Si su DMS tiene limitaciones técnicas que impiden enviar cierta información, las excepciones serán documentadas y acordadas.
Los Escenarios
Cuando un cliente entra a un concesionario, son posibles muchos escenarios. Aquí hay algunos ejemplos:
- El cliente compra un nuevo casco Ski-Doo (Piezas).
- El cliente trae su ATV para mantenimiento (Piezas y Trabajos).
- El cliente trae su viejo See-Doo a cambio de comprar uno nuevo (Unidades).
- El cliente trae su Side-by-side para reparación y para agregar un cabrestante (Piezas y Trabajos).
- El cliente entra para comprar un nuevo Ricker con accesorios y un casco (Piezas, Unidades y Trabajos).
Estos escenarios crean diferentes transacciones, proporcionando información valiosa sobre el comportamiento del cliente, las tendencias del mercado, la eficiencia de las promociones y la fidelidad a la marca.
La información es útil para BRP en la comprensión del mercado y en la adaptación de las promociones, programas y estrategias para ayudar a los concesionarios a mejorar su negocio.
Por eso, la API de Transacciones Minoristas es muy importante para los grupos de negocio de BRP.
La estructura de la carga útil de la API de Transacciones Minoristas permite enviar muchas transacciones del cliente, y cada transacción del cliente puede utilizar uno, dos o tres tipos.
Usando los escenarios anteriores, su DMS enviará las siguientes cargas útiles:
El cliente compra un nuevo casco Ski-Doo.
- La carga contiene una Partes transacción.
El cliente trae su ATV para mantenimiento.
- La carga contiene un Trabajos para las reparaciones y uno OTC para las piezas.
El cliente trae su viejo See-Doo a cambio de comprar uno nuevo.
- La carga contiene una Unidades transacción.
El cliente trae su Side-by-side para reparación y para agregar un cabrestante.
- La carga contiene un Trabajos para las reparaciones y uno Partes para las piezas.
El cliente entra para comprar un nuevo Ryker con accesorios y un casco, la carga contiene.
- Uno Trabajos para la instalación de los accesorios
- Uno Partes para el casco y los accesorios.
- Uno Unidades para la venta de la unidad.
Un Cargamento para Enviarlos a Todos
Todas estas transacciones podrían enviarse en una carga útil ya que la API recibe un array de transacciones, y cada transacción tiene los tres tipos.
Hay un objeto de encabezado global para cada transacción, y los objetos de Partes, Unidades y Reparaciones se llenan según sea necesario.
En el contexto de la API de Transacciones Minoristas, una transacción en la carga útil generalmente corresponde a una factura en su DMS.
Cuando vea "transacción" en la documentación restante, puede pensar en una "factura".
La imagen de abajo muestra una carga para las 5 transacciones (o facturas) descritas en los escenarios.
La transacción de abajo es un ejemplo del escenario 5, en el cual el cliente compra un nuevo Ski-Doo Summit con un portaequipajes y un nuevo traje y hace que el concesionario instale el portaequipajes.
Una carga puede contener muchas transacciones ¡si todas son para el mismo concesionario!
En la carga, los diferentes tipos de transacciones están mapeados de la siguiente manera:
- Piezas: transactions.parts
- Trabajos: transactions.jobs
- Unidades: transactions.units