REPUVE

Este conector consulta el Registro Público Vehicular (REPUVE) y te dice si un vehículo está registrado y con qué datos: marca, modelo, año, línea, VIN, placa, la institución que lo registró y la entidad que lo emplacó, entre otros. Puedes buscarlo por su número de serie (VIN), por su placa o por su NIC.

Para añadir este conector, ubícate en el nodo de tu workfloo en el que desees añadir tu llamada y haz clic. En la pantalla con los conectores disponibles, ve a Nubarium y elige Consulta de vehículo en REPUVE. Haz clic en siguiente.

En tu lienzo aparecerá el nodo Nubarium - Consulta de vehículo en REPUVE. También se agregará un formulario con el campo VIN - número de serie. Además, verás una ventana donde podrás configurar el conector.

Datos solicitados para la consulta

El vehículo se puede buscar por cualquiera de estos tres datos:

Campo	Formato	¿Viene en el formulario?
VIN - número de serie	17 caracteres alfanuméricos	Sí, se agrega al crear el conector
Placa	De 5 a 10 caracteres alfanuméricos, admite guiones	No, lo agregas tú
NIC - número de identificación REPUVE	De 6 a 12 caracteres alfanuméricos	No, lo agregas tú

Al crear el conector, el formulario sólo recibe el campo VIN - número de serie. Si prefieres buscar por placa o por NIC, agrega el campo que necesites desde el propio formulario:

Abre el nodo de formulario de tu workfloo.
Al final del panel, haz clic en Agregar campos.
Busca Placa o NIC y haz clic en el campo para añadirlo.
Guarda tu workfloo.

🚧
Deja en el formulario un solo criterio de búsqueda:
Es obligatorio que llegue al menos uno de los tres datos: si el paso se ejecuta con todos vacíos, el conector termina por la salida de error. Y como REPUVE busca por un único criterio, deja en el formulario sólo el campo con el que vas a buscar y elimina los demás.

Configuración del conector

En la pestaña general te solicitará:

Credenciales - haz clic en credenciales y en crear nuevo. Verás una nueva ventana en la que se te pedirá el Usuario y la Contraseña de Nubarium, así como el nombre que le darás a tus credenciales vault en kiban. Haz clic en guardar.
Incluir constancia en PDF: actívalo si además de los datos quieres recibir la constancia del vehículo en PDF. Por default viene desactivado.

📘
Importante:
Estas credenciales debes obtenerlas de tu cuenta con Nubarium. Son las mismas que usan el resto de los conectores de Nubarium, así que si ya las guardaste para otro paso puedes reutilizarlas aquí.

En la pestaña avanzado, se te mostrará un modal que te permite reintentar tu consulta hasta cinco veces, en caso de que así lo desees. También puedes seleccionar la opción no reintentar

👍
Nota:
La configuración de reintentos permite ejecutar nuevamente consultas si el servicio no está disponible sin reiniciar el flujo.

Salida de error

Junto al icono de tu conector se muestra una rama de error.

Una vez agregado el conector, tienes las siguientes posibilidades:

Cuando termine la ejecución de tu conector, terminar el flujo de tu workfloo.
Seguir con el flujo en la rama inferior (la rama de ejecución exitosa).
Definir un flujo alternativo si ocurrió un error en tu conector (salida de error).

Si haces clic en el signo + rojo se te ofrecen dos opciones: elegir un nuevo paso o uno existente, es decir, añadir un nuevo conector, o bien, hacer un enlace a alguno que ya se encuentre dentro de tu workfloo.

Si decides no determinar algún camino para seguir con el flujo, éste se terminará en cuanto se presente el error.

Si, por algún motivo, decides borrar el conector en el que determinaste una salida de error, se te muestra un modal de confirmación en el que se te advierte que todos los nodos relacionados con dicho conector en la rama de salida también serán eliminados. Si estás de acuerdo con ello, haz clic en guardar.

Guarda tu workfloo.

Ejecución

Al ejecutar tu workfloo, en el paso de Nubarium - Consulta de vehículo en REPUVE se captura el dato de búsqueda en el formulario y la consulta se realiza de forma automática, sin intervención de tu cliente.

Un vehículo que no está registrado en REPUVE no es un error: la consulta se realizó, el flujo continúa por la rama de ejecución exitosa y el resultado te lo dice en la respuesta. Esa consulta se contabiliza igual que una en la que sí se encontró el vehículo.

Respuesta

Una vez que ejecutas tu workfloo, en el resumen de la ejecución, dentro de la pestaña Respuesta, podrás observar los siguientes datos:

Resumen

Dato	Descripción
Estatus	Estatus con el que respondió el proveedor
Código de mensaje	Resultado de la consulta: `0` vehículo registrado, `1` vehículo no registrado
Mensaje	Descripción del resultado
Código de validación	Código con el que REPUVE identifica la validación realizada
ID REPUVE	Identificador del vehículo en REPUVE. Sólo cuando el vehículo está registrado

🚧
Evalúa el código de mensaje, no el estatus:
Cuando el vehículo no está en REPUVE, el proveedor responde con el estatus en ERROR y ese valor se te entrega tal cual, aunque la consulta haya sido exitosa. Si construyes tu árbol de decisión sobre el campo Estatus vas a tratar como falla lo que en realidad es un "vehículo no registrado". La condición correcta es sobre Código de mensaje: 0 es registrado y 1 es no registrado.

Vehículo

Sólo llega cuando el vehículo está registrado (código de mensaje 0).

Dato	Descripción
Placa	Placa del vehículo
VIN	Número de identificación vehicular
Clase	Clase de vehículo
Marca	Marca
Modelo	Modelo
Año modelo	Año del modelo
Tipo	Tipo de vehículo
Línea	Línea
Complemento	Complemento de la descripción del vehículo
Número de puertas	Cantidad de puertas
País de origen	País de origen
Cilindrada	Cilindrada del motor
Número de cilindros	Cantidad de cilindros
Número de ejes	Cantidad de ejes
Planta de ensamble	Planta en la que se ensambló
Señas particulares	Señas particulares registradas
ID de importación	Identificador de importación
NRPV	Número de registro público vehicular
ID de institución	Identificador de la institución que registró el vehículo
Institución que registró	Nombre de la institución que lo registró
Fecha de registro	Fecha en que se registró en REPUVE
Hora de registro	Hora del registro
ID de entidad	Identificador de la entidad que emplacó
Entidad que emplacó	Entidad federativa que emplacó el vehículo
Fecha de expedición	Fecha de expedición de la placa
Fecha de actualización	Última actualización del registro
Tipo de movimiento	Identificador del movimiento registrado
Movimiento	Descripción del movimiento registrado

Errores frecuentes

Estos casos terminan por la salida de error del nodo:

Situación	Qué significa
Datos de consulta inválidos	El VIN, la placa o el NIC no tienen la forma que espera REPUVE. Revisa el dato capturado
Credenciales inválidas	El usuario o la contraseña no corresponden a tu cuenta de Nubarium
Servicio no disponible temporalmente	REPUVE no está respondiendo. Es el caso que cubren los reintentos
Error de datos	El proveedor no pudo resolver la consulta