Vocabulaire RMA / Ticketing Verisav (RMA Vocabulary)

Name: Verisav RMA Vocabulary
Published: 2025-12-16
License: https://creativecommons.org/licenses/by/4.0/

Namespace: https://ns.verisav.fr/rma#
Version: 1.0.0
Dernière modification: 2025-12-16
Préfixe recommandé: rma:

Fichiers disponibles:

rma.ttl (Turtle/OWL) rma.jsonld (JSON-LD Context) Vocabulaire DPP (complémentaire)

📚 Exemples de données RMA:

Consultez nos exemples pratiques d'utilisation du vocabulaire :

Voir tous les exemples Documentation des exemples

Exemples disponibles :

Simple Return Refund - Retour avec remboursement
Ticket with Dispute - Ticket avec litige et résolution
Return with Shipping - Retour avec expédition et suivi
Service Ticket Complete - Ticket complet avec messages
Demo Complete Scenario - Exemple exhaustif

Description

Ce vocabulaire définit les classes et propriétés pour standardiser la gestion des Retours de Marchandise (RMA - Return Merchandise Authorization) et des tickets SAV entre consommateurs, distributeurs et réparateurs.

Il complète le vocabulaire DPP qui décrit l'état des produits, en couvrant les workflows dynamiques de communication et résolution de problèmes.

Classes Principales

rma:ReturnRequest

Une demande de retour d'un produit vers un distributeur ou fabricant.

Sous-classe de: schema:Action

Propriétés principales: returnRequestNumber, returnReason, returnRequestStatus

rma:Ticket

Un ticket SAV qui suit les interactions de service client et la résolution de problèmes.

Sous-classe de: schema:Thing

Propriétés principales: ticketNumber, ticketStatus, ticketPriority

rma:Dispute

Un litige ou réclamation concernant un produit (ex: arrivé cassé, non conforme, défectueux).

Sous-classe de: schema:Complaint

Propriétés principales: disputeType, disputeDescription

rma:Resolution

Une résolution proposée ou appliquée (remboursement, échange, avoir, réparation, remplacement).

Propriétés principales: resolutionType, resolutionAmount, resolutionStatus

rma:ShippingLabel

Une étiquette d'expédition pour retourner un produit, contenant les informations transporteur et suivi.

Sous-classe de: schema:DigitalDocument

Propriétés principales: labelUrl, carrierName, trackingNumber

rma:Message

Un message dans un fil de conversation de ticket entre client, distributeur ou réparateur.

Sous-classe de: schema:Message

Propriétés principales: messageText, messageDate, messageType

rma:Approval

Une approbation ou autorisation pour une demande de retour ou résolution.

Sous-classe de: schema:Action

Propriétés principales: approvalStatus, approvalDate, approvedBy

rma:Tracking

Informations de suivi pour un colis retourné, incluant les événements transporteur et statut.

Propriétés principales: trackingNumber, trackingStatus, trackingUrl

Propriétés Principales

Relations (Object Properties)

rma:hasReturnRequest - Lie un produit ou ticket à une demande de retour
rma:hasTicket - Lie un produit à un ticket SAV
rma:hasDispute - Lie une demande de retour à un litige
rma:hasResolution - Lie une demande de retour à une résolution
rma:hasShippingLabel - Lie une demande de retour à une étiquette d'expédition
rma:hasMessage - Lie un ticket à des messages
rma:concernsProduct - Lie une demande/ticket/litige au produit concerné
rma:resultsInWorkOrder - Lie une demande de retour à un ordre de travail (si réparation)
rma:requestedBy - Personne/organisation qui a créé la demande
rma:handledBy - Organisation qui traite la demande

Attributs (Data Properties)

rma:returnRequestNumber - Numéro RMA unique
rma:returnReason - Raison du retour
rma:returnRequestStatus - Statut de la demande
rma:ticketNumber - Numéro de ticket
rma:disputeType - Type de litige
rma:resolutionType - Type de résolution
rma:resolutionAmount - Montant (remboursement/avoir)
rma:trackingNumber - Numéro de suivi colis
... et bien d'autres

Exemple d'Utilisation

Exemple JSON-LD

{ "@context": "https://ns.verisav.fr/rma/rma.jsonld", "@type": "ReturnRequest", "returnRequestNumber": "RMA-2025-001234", "returnReason": "defective", "returnRequestDate": "2025-12-16T10:30:00Z", "returnRequestStatus": "approved", "concernsProduct": { "@type": "Product", "sku": "PROD-12345" }, "hasDispute": { "@type": "Dispute", "disputeType": "defective", "disputeDescription": "Le produit ne s'allume plus après 2 jours d'utilisation" }, "hasResolution": { "@type": "Resolution", "resolutionType": "refund", "resolutionAmount": 299.99, "resolutionCurrency": "EUR", "resolutionStatus": "approved" }, "hasShippingLabel": { "@type": "ShippingLabel", "labelUrl": "https://carrier.com/labels/RMA-2025-001234.pdf", "carrierName": "DHL", "trackingNumber": "1234567890" } }

Intégration avec DPP

Le vocabulaire RMA peut être utilisé conjointement avec le vocabulaire DPP :

{ "@context": [ "https://ns.verisav.fr/dpp/dpp.jsonld", "https://ns.verisav.fr/rma/rma.jsonld" ], "@type": "ProductPassport", "serialNumber": "SN-123456", "hasReturnRequest": { "@type": "ReturnRequest", "returnRequestNumber": "RMA-2025-001234" }, "hasWorkOrder": { "@type": "WorkOrder", "workOrderStatus": "en_cours" } }

Cas d'Usage

E-commerce → Réparateur: Un retailer Shopify envoie une demande de retour standardisée à un réparateur
Marketplace: Standardiser les retours pour tous les vendeurs d'une marketplace
Réseau de SAV: Communication standardisée entre retailers et réparateurs partenaires
Interopérabilité: Remplacer les formats propriétaires (Zendesk, Salesforce) par un standard ouvert

Enregistrement LOV

Ce vocabulaire est conçu pour être enregistré dans le Linked Open Vocabularies (LOV) registry pour une meilleure visibilité et réutilisabilité dans le Web sémantique.