Conectar HeruDoc con un ERP o TMS mediante API

Entra en Desarrolladores para consultar la versión estable de la API, la dirección base y el límite de peticiones.

Genera una clave distinta para cada ERP, TMS o integración y concede únicamente los permisos necesarios. Para gestionar documentos y accesos del conductor, elige Documentos y portal del conductor. Las claves existentes no reciben permisos nuevos automáticamente.

Copia el secreto completo cuando se muestre y guárdalo en el servidor como una variable segura. No lo incluyas en el navegador ni en el código de una aplicación pública.

Tu ERP o TMS puede preparar el portal al crear y publicar el HeRU o sobre un documento existente, y consultar, regenerar o revocar su enlace. La ficha se identifica por NIF o driverId; el correo solo es contacto. Se reutiliza la ficha o se crea con nombre y móvil español válido. También puede prepararse el acceso sin ficha, usando el conductor del servicio. No crea cuentas ni envía mensajes. Ver la guía técnica del portal por API.

Mientras la primera publicación está pendiente, el portal no devuelve una URL disponible. Una versión publicada disponible puede seguir accesible mientras se prepara una corrección. Consulta su estado tras el aviso de publicación existente o periódicamente. No necesita otra orden de activación ni nuevos tipos de webhook. Para reintentar, conserva requestId y cuerpo; una acción nueva lleva un identificador nuevo.

Añade una dirección HTTPS y selecciona los eventos que quieras recibir cuando un HeRU se publique, se corrija o cambie de estado.

Comprueba la firma del webhook y evita procesar dos veces la misma entrega. Implementa también el control de errores y los reintentos indicados en la documentación.

Los ejemplos de integración utilizan los campos mínimos. La API puede seleccionar la versión, revisión o fin de servicio actual; los controles explícitos siguen disponibles. No necesitas guardar toda la respuesta: revision, sourceRevision y eTag son metadatos para control avanzado. Conserva o consulta los identificadores que necesites gestionar y reutiliza el mismo requestId y cuerpo al reintentar. Publicar o descartar sin revisión actúa sobre los cambios actuales, aunque otra persona los haya modificado. En HeRU no necesitas generar schemaVersion ni draftServiceId al crear; usa changes.service para modificar el único servicio.

Utiliza los ejemplos, la referencia de autenticación y versiones, el contrato OpenAPI y la colección de Postman disponibles en la documentación.

Trabaja primero en un espacio controlado y utiliza siempre la versión documentada. Revisa las notas de la versión estable antes de actualizar tu integración.