Chargement...
Integre Verisav en sus sistemas y automatice sus procesos de gestión del servicio postventa
La API Verisav le permite integrar todas las funcionalidades de la plataforma en sus sistemas existentes. Ya sea que desee automatizar la gestión de garantías, sincronizar datos de productos o crear flujos de trabajo personalizados, nuestra API REST proporciona todas las herramientas necesarias.
Nuestra API sigue los estándares de la industria con una arquitectura RESTful, respuestas JSON y autenticación segura. Está diseñada para ser simple de usar, bien documentada y de alto rendimiento.
Automatice sus procesos, sincronice sus datos en tiempo real y cree experiencias personalizadas para sus clientes. La API Verisav se integra perfectamente con sus sistemas existentes.
Todas las solicitudes a la API Verisav requieren autenticación mediante un token API. Puede obtener sus credenciales desde su panel de control Verisav.
Inicie sesión en el espacio profesional, luego vaya a Configuración > Claves API para generar o regenerar su token. El token permanece válido hasta su revocación manual.
Authorization: Bearer YOUR_API_TOKENNunca comparta sus tokens API públicamente. Manténgalos seguros y regenérelos regularmente. Los tokens deben transmitirse en el encabezado Authorization de cada solicitud.
Siga estos sencillos pasos para comenzar a usar la API Verisav:
Inicie sesión en su panel de control Verisav y genere sus claves API desde la sección Configuración.
Agregue su token API en el encabezado Authorization de sus solicitudes HTTP: Authorization: Bearer YOUR_API_TOKEN
Pruebe su configuración recuperando el DPP de un producto. Reemplace ABC123 por un shortId real:
Ejemplo:
curl -X GET "https://www.verisav.fr/api/v1/dpp/ABC123" \
-H "Authorization: Bearer YOUR_API_TOKEN"Descubra todos los endpoints disponibles para integrar Verisav en sus sistemas. Cada endpoint está documentado con ejemplos de solicitudes y respuestas.
Las tarjetas siguientes muestran las familias de API: vocabularios RDF (DPP, RMA, WTY), GraphQL y REST. La sección Referencia API v1 detalla la API REST v1 completa con las rutas exactas.
Gestión del Pasaporte Digital del Producto (DPP)
/api/dppGestión de devoluciones e intercambios (RMA)
/api/rmaGestión de garantías (WTY)
/api/wtyAcceso a vocabularios y taxonomías
/api/v1/vocabularyAPI GraphQL para consultas flexibles
/api/graphqlDocumentación completa de cada endpoint de la API Verisav v1. URL base: https://www.verisav.fr. Cada API está documentada con su ruta, método, descripción y parámetros. Todas las solicitudes requieren el encabezado Authorization: Bearer YOUR_API_TOKEN.
Encabezados requeridos: Authorization: Bearer {token}, Content-Type: application/json para POST/PATCH.
/api/v1/dpp/{shortId}Recupera el DPP por identificador corto (shortId).
Parámetros: shortId — Identificador corto del producto
/api/v1/dpp?gtin=&serial=Recupera el DPP por GTIN + número de serie.
Parámetros: gtin, serial — GTIN y número de serie
/api/v1/products/{id}/warrantyInformación de garantía del producto.
Parámetros: id — UUID del producto
/api/v1/products/{id}/activateActiva el producto (registro de compra).
Parámetros: id — UUID del producto
/api/v1/products/{id}/usageRecupera los datos de uso del producto.
Parámetros: id — UUID del producto
/api/v1/products/{id}/usageRegistra o actualiza los datos de uso.
Parámetros: id — UUID del producto
/api/v1/products/{id}/supply-chainCadena de suministro y trazabilidad.
Parámetros: id — UUID del producto
/api/v1/products/bulkConsultas masivas para varios productos.
Parámetros: id — UUID del producto
/api/v1/products/{id}/douaneActualización de información aduanera (UN-CPC, TARIC, etc.).
Parámetros: Body: product_category_code, product_category_scheme (UN-CPC, TARIC)
/api/v1/products/{id}/materialsRecupera la composición de materiales del producto.
Parámetros: id — UUID del producto
/api/v1/products/{id}/materialsRegistra o actualiza la composición de materiales.
Parámetros: id — UUID del producto
/api/v1/products/{id}/conformityRecupera las declaraciones de conformidad.
Parámetros: id — UUID del producto
/api/v1/products/{id}/conformityRegistra o actualiza las declaraciones de conformidad.
Parámetros: id — UUID del producto
/api/v1/products/{id}/traceabilityRecupera los datos de trazabilidad.
Parámetros: id — UUID del producto
/api/v1/products/{id}/traceabilityRegistra o actualiza los datos de trazabilidad.
Parámetros: id — UUID del producto
/api/v1/products/{id}/verifiable-credentialsDevuelve las Verifiable Credentials (JSON-LD) del producto.
Parámetros: id — UUID del producto
/api/v1/products/{id}/verifiable-credentials?format=jwtDevuelve las Verifiable Credentials firmadas en formato JWT.
Parámetros: id — UUID del producto
/api/v1/products/{id}/transfer-ownershipTransfiere la propiedad del producto a otro actor.
Parámetros: id — UUID del producto
/api/v1/products/{id}/auraExportación en formato Aura Consortium.
Parámetros: id — UUID del producto
/api/v1/claimsCrea una nueva reclamación de servicio postventa.
/api/v1/claims/{id}/statusEstado de una reclamación por identificador.
Parámetros: id — UUID de la reclamación
/api/v1/claims/bulkConsultas masivas para varias reclamaciones.
/api/v1/repairers/nearby?lat=&lng=&radius=&limit=Lista de reparadores cercanos (lat, lng, radius, limit).
Parámetros: lat, lng — Coordenadas; radius — Radio (km); limit — Número máximo
/api/v1/repairers/{id}/availabilityDisponibilidad de un reparador.
Parámetros: id — UUID del reparador
/api/v1/suppliers/dataEnvío de datos de proveedor a Verisav.
/api/v1/webhooksRegistrar un webhook para recibir eventos.
Parámetros: url — URL de callback; events — Lista de eventos
Códigos de respuesta: 200 OK, 400 Bad Request, 401 Unauthorized, 404 Not Found, 429 Too Many Requests, 500 Server Error
DPP — Ejemplo de solicitud
curl -X GET "https://www.verisav.fr/api/v1/dpp/ABC123" \
-H "Authorization: Bearer YOUR_API_TOKEN"Produits — Activer
curl -X POST "https://www.verisav.fr/api/v1/products/{id}/activate" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'Réparateurs — À proximité
curl -X GET "https://www.verisav.fr/api/v1/repairers/nearby?lat=44.84&lng=-0.58&radius=50&limit=10" \
-H "Authorization: Bearer YOUR_API_TOKEN"Registre un webhook vía POST /api/v1/webhooks para recibir notificaciones en tiempo real (creación de reclamación, transferencia de propiedad, etc.). Perfecto para sincronizar sus sistemas y automatizar sus flujos de trabajo.
Eventos soportados: claim.created, ownership.transferred, product.activated, etc.
Ejemplo de registro:
curl -X POST "https://www.verisav.fr/api/v1/webhooks" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-domain.com/webhook",
"events": ["claim.created", "ownership.transferred", "product.activated"]
}'Los errores se devuelven en JSON: {"error": "mensaje", "code": "ERROR_CODE"}. El cuerpo de la solicitud se analiza para proporcionar detalles sobre los campos inválidos.
La API aplica límites de tasa por token. Si se supera, se devuelve una respuesta 429 Too Many Requests con el encabezado Retry-After. Contáctenos para necesidades de alto volumen.
Nuestro equipo está aquí para ayudarle a integrar la API Verisav en sus sistemas. Consulte nuestra documentación completa o contacte con nuestro soporte.