REPUVE

Consulta los datos de un vehículo en el Registro Público Vehicular a partir de su VIN, su placa o su NIC.

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 REPUVE y elige Consulta de vehículo en REPUVE. Haz clic en siguiente.

En tu lienzo aparecerá el nodo 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:

CampoFormato¿Viene en el formulario?
VIN - número de serie17 caracteres alfanuméricosSí, se agrega al crear el conector
PlacaDe 5 a 10 caracteres alfanuméricos, admite guionesNo, lo agregas tú
NIC - número de identificación REPUVEDe 6 a 12 caracteres alfanuméricosNo, 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:

  1. Abre el nodo de formulario de tu workfloo.
  2. Al final del panel, haz clic en Agregar campos.
  3. Busca Placa o NIC y haz clic en el campo para añadirlo.
  4. 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 este conector no te solicita credenciales: es un servicio que kiban mantiene, así que no necesitas contratar nada con un tercero. Lo único que puedes configurar es:

  • 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.

En la pestaña Reintentos, 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 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

DatoDescripción
EstatusEstatus con el que respondió la consulta
Código de mensajeResultado de la consulta: 0 vehículo registrado, 1 vehículo no registrado
MensajeDescripción del resultado
Código de validaciónCódigo con el que REPUVE identifica la validación realizada
ID REPUVEIdentificador 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, la respuesta trae el estatus en ERROR 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).

DatoDescripción
PlacaPlaca del vehículo
VINNúmero de identificación vehicular
ClaseClase de vehículo
MarcaMarca
ModeloModelo
Año modeloAño del modelo
TipoTipo de vehículo
LíneaLínea
ComplementoComplemento de la descripción del vehículo
Número de puertasCantidad de puertas
País de origenPaís de origen
CilindradaCilindrada del motor
Número de cilindrosCantidad de cilindros
Número de ejesCantidad de ejes
Planta de ensamblePlanta en la que se ensambló
Señas particularesSeñas particulares registradas
ID de importaciónIdentificador de importación
NRPVNúmero de registro público vehicular
ID de instituciónIdentificador de la institución que registró el vehículo
Institución que registróNombre de la institución que lo registró
Fecha de registroFecha en que se registró en REPUVE
Hora de registroHora del registro
ID de entidadIdentificador de la entidad que emplacó
Entidad que emplacóEntidad federativa que emplacó el vehículo
Fecha de expediciónFecha de expedición de la placa
Fecha de actualizaciónÚltima actualización del registro
Tipo de movimientoIdentificador del movimiento registrado
MovimientoDescripción del movimiento registrado

La constancia en PDF

Si activaste Incluir constancia en PDF, arriba del contenido de la pestaña Respuesta aparece el enlace Descargar pdf, con el formato y el peso del archivo —por ejemplo Descargar pdf (PDF · 184 KB)—. Haz clic para guardarlo en tu equipo. Dentro del JSON, la llave pdf sigue visible en el lugar donde se envía, pero con una etiqueta corta en vez del contenido del archivo.

📘

Si consumes la ejecución por API:

La descarga es una comodidad de la consola. En el JSON que entrega la API y en el payload del webhook, la constancia sigue viajando como texto en base64 dentro del campo pdf, así que ahí tendrás que decodificarla tú.

Errores frecuentes

Estos casos terminan por la salida de error del nodo:

SituaciónQué significa
Datos de consulta inválidosEl VIN, la placa o el NIC no tienen la forma que espera REPUVE. Revisa el dato capturado
Servicio no disponible temporalmenteREPUVE no está respondiendo. Es el caso que cubren los reintentos
Error de datosNo se pudo resolver la consulta

Did this page help you?