Documentation à l’adresse des développeurs pour l’utilisation de l’API de pilotage des données et des traitements pour le Fonds Réparations EEE.

Version =

État

colour	Green
title	1.0

Sommaire

minLevel	1
maxLevel	3

Historique des versions

État
colour Green
title version 1.0
version initiale 1 mars 2023

Objectifs

Cette API permet l’intégration des étapes de traitements et l'échange des données entre les applications métiers de réparateur et le système d’information gérant les données de soutien pour le Fond Réparations EEE.
Basée sur les standards JSON Rest, elle s’adresse aux intégrateurs et développeurs.

Diagramme de séquence

Drawio

mVer	2
zoom	1
simple	0
inComment	0
pageId	3629121571
custContentId	3629121595
lbox	1
diagramDisplayName	diag_sequence_api_ecl.drawio
contentVer	4
revision	4
baseUrl	https://ecologic-france.atlassian.net/wiki
diagramName	diag_sequence_api_ecl.drawio
pCenter	0
width	695.9999999999999
links
tbstyle
height	1281

le diagramme ci-contre, est une proposition de scénario de séquence des appels vers les méthodes de l’API.

La phase initiale consiste à récupérer les informations de référence devant être utilisée par l’application cliente.
Il est recommandé de consolider les référentiels au moins 1 fois par jour.

Si possible évitez de faire appel au référentiel avant chaque appel d’une méthode pour les Resquest ou Claim.

Une fois les informations sur le produit et l’estimation / devis pour la panne réalisée, la première étape est de s’assurer que la réparation va bien être prise en charge par Ecologic avec “CalculateEcoSupport”

Si la réponse est positive vous avez le montant du soutien allouable à l’acte de réparation

L'étape suivante consiste à créer la demande de soutien en fournissant les informations sur le produit, le devis et le consommateur avec “CreateSupportRequest”

Une fois la demande créée vous pouvez la mettre à jour (avec “UpdateSupportRequest”) ou dès que la confirmation consommateur est actée la convertir vers une demande de remboursement. Utilisez la métode “GetSupportRequestStatus” pour vérifier son statut.

La demande de remboursement se créé avec “CreateClaim” et la réponse vous indique s’il vous manque des informations pour pouvoir la soumettre à la vérification (et si tout est OK, au paiement)

Généralement, il manque initialement les documents de type, facture, plaque de numéro de série…
Ces documents peuvent être intégrés à la demande de remboursement avec “AttachFile”.
Il est aussi possible de compléter la demande avec “UpdateClaim”

Si la vérification est OK avec “GetClaimStatus”, vous pouvez faire un dernier “UpdateClaim” en demandant la soumission.

Le dossier de remboursement passe ensuite dans les étapes de contrôle chez Ecologic.

Environnement de développement (Pre Production)

Lexique

Request = demande de soutien
Claim =demande de remboursement

Accéder à l’environnement de développement

Pré requis

Le développement n’a de sens que s’il s’adresse à un réparateur qui dispose d’un compte sur le service e-reparateur.eco (https://www.e-reparateur.eco )

Le développeur doit contacter le support afin de se faire identifier = support@e-reparateur.eco

Procédure

contacter le support support@e-reparateur.eco en demandant à avoir accès à un environnement de production
si votre demande est acceptée vous recevrez par email en réponse
1. une clé API de PreProduction pour réaliser votre développement
2. un compte d’accès au service web e-reparateur de Pre-Production sur lequel vous pourrez gérer, vérifier, mettre à jour les différents objets du service
vous pouvez contacter le support par email sur support@e-reparateur.eco

Outils de tests

une fois que vous avez vos accès vous pouvez tester les premiers éléments (notamment votre clé API) avec les outils suivants

SwaggerUI

URL du site SwaggerUI = https://preprod-apiecologic.e-reparateur.eco/apidoc/ui/index#/

une fois votre clé entrée vous pourrez tester les méthodes de l’API

PostMan

Postman est un outil standard dans le développement et la validation des API Rest.
Nous vous mettons à disposition une collection préparée pour pouvoir tester toutes les méthodes, mais il est recommandé de bien lire les informations fournies pour chacune d’entre elles.

Pour utiliser la collection disponible ci-contre il vous juste réaliser l’importation du fichier json depuis l’interface de Postman

Ensuite il vous reste à définir votre clé API de Pre Production pour réaliser les appels avec le niveau d’autorisation du site associé
Pour cela ouvrez l’arborescence de la collection et sélectionnez “Pre Prod” et l’onglet “Authorization” pour y intégrer votre clé API

Info
surtout pensez à sauvegarder à chaque fois l’onglet, sinon l’information ne sera pas utilisable dans les autres onglets que vous allez ouvrir

Pour utiliser une méthode sélectionnez là dans l’arborescence et adaptez les valeurs pour les paramètres et le contenu pour le body selon votre contexte

View file

name	20230301 Ecologic API GestCo Doc.postman_collection.json

Collection PostMan à importer

version du 1 mars 2023

La collection regroupe les méthodes dans des dossiers permettant de plus facilement identifier un ordre type d’usage de celles-ci.
Ce n’est qu’un exemple, il vous est possible d’organiser les appels aux méthodes différemment et de n’utiliser que celles que vous identifiez utiles

Spécifications de l’API

Authentification

Appeler l’API depuis une service nécessite de disposer d’une clé d’authentification à passer dans l'entête HTTP de chacune des requêtes.

Nom de la clé d’entête = api_key

Valeur de la clé = <votre_clé_api> (GUID ex : C8E88146-AF8D-4E95-9B76-8C8FFF5A2C9B)

Info

<votre_clé_api> existe

soit en version de PreProduction à utiliser lors des développements et des tests
soit en version de Production et les appels à l’API déclencheront des actions concrètes et réelles auprès du Fond Réparation EEE.

Cette clé est unique pour chaque compte e-reparateur.eco.
Attention à ne pas la divulguer. Si jamais vous aviez un doute n’hésitez pas à prévenir le support = support@e-reparateur.eco

Vérification des sites

récupération des informations du site associé à la clé API - /GetRepairSitesByATS
État
colour Green
title GET

URL Preprod = https://preprod-apiecologic.agorapluse-reparateur.comeco/api/v3/ecosupport/getrepairsitesbyats

Fonctions

permet de récupérer les ID des sites associés à la clé API utilisée.
Ce sera l’information qu’il faudra ensuite utiliser dans certaines méthodes dans le paramètre “RepairSiteId”

Ex réponse

Bloc de code

language	json

{
    "ResponseData": [
        {
            "SiteId": "02c867c0-0000-0000-000-3cf8de2dc1c8",
            "Name": "Test Reparateur",
            "CommercialName": "ECO REPARE",
            "Zip": "78280",
            "City": "GUYANCOURT"
        }
    ],
    "ResponseStatus": "S",
    "IsValid": true,
    "ResponseMessage": "",
    "ResponseErrorMessage": ""
}

Réponse avec plusieurs sites

Bloc de code

language	json

{
    "ResponseData": [
        {
            "SiteId": "9cc23555-0000-0000-0000-3279c2f57261",
            "Name": "Test Reparateur 1",
            "CommercialName": "ECO REPARE",
            "Zip": "12100",
            "City": "MILLAU"
        },
        {
            "SiteId": "0590e586-0000-0000-0000-f94f4e1cb199",
            "Name": "Test Reparateur 1",
            "CommercialName": "ECO REPARE",
            "Zip": "12850",
            "City": "ONET-LE-CHATEAU"
        },
        {
            "SiteId": "b14ca037-0000-0000-0000-54a3391ee624",
            "Name": "Test Reparateur 1",
            "CommercialName": "ECO REPARE",
            "Zip": "12200",
            "City": "VILLEFRANCHE-DE-ROUERGUE"
        }
    ],
    "ResponseStatus": "S",
    "IsValid": true,
    "ResponseMessage": "",
    "ResponseErrorMessage": ""
}

Référentiels des données

Les créations de dossier de demande de soutien et de remboursement nécessitent de s’appuyer sur des données de références utilisées par l’API.
Celle-ci permet par contre de récupérer ces référentiels mis à jour régulièrement (au moins 1 fois toutes les 24h)

Récupération de la liste des marques - /PrintBrandList
État
colour Green
title GET

URL Preprod = https://preprod-apiecologic.e-reparateur.eco/api/v3/ecosupport/printbrandlist

URL Prod = https://apiecologic.e-reparateur.eco/api/v3/ecosupport/printbrandlist

Fonctions

permet de récupérer la liste des marques supportées par Ecologic.
Appeler cette API vous permettra de disposer d'un code marque unique et de l'associer à votre référentiel.

Usage

entrée = pas de paramètre spécifique

Exemple de réponse

Bloc de code

language	json

{
    "ResponseData": [
        {
            "BrandName": "Acer",
            "BrandId": "1689"
        },
        {
            "BrandName": "ADVANCE",
            "BrandId": "1922"
        },
        {
            "BrandName": "AEG",
            "BrandId": "1690"
        },
        ...
  ],
    "ResponseStatus": "S",
    "IsValid": true,
    "ResponseMessage": "",
    "ResponseErrorMessage": ""
}

Récupérer la liste des types de produit - /PrintProductTypeList
État
colour Green
title GET

URL Preprod = https://preprod-apiecologic.e-reparateur.eco/api/v3/ecosupport/printproducttypelist

URL Prod = https://apiecologic.e-reparateur.eco/api/v3/ecosupport/printproducttypelist

Fonctions

permet de récupérer la liste des types de produits supportés par Ecologic.

Appeler cette API vous permettra de disposer d'un code unique pour chaque type de produit afin de l'associer à votre référentiel. Cette API restitue également pour chaque type de produit les symptômes et les codes réparation éligibles au soutien.

Exemple usage

entrée = pas de paramètre spécifique

sortie =

ProductId = Identifiant produit

ProductName =Désignation du type de produit (ex: Four (hors micro-ondes et mini-four))

EligibilityStartDate = Date de début d'éligibilité

EligibilityEndDate = Date de fin d'éligibilité

RepairCodes = Tableau des codes pannes IRIS pouvant être utilisés dans la demande de remboursement (Claim)

IRISSymptoms[] = Liste des codes symptôme IRIS éligibles pour le type de produits et pour Ecologic à utiliser dans la demande de soutien (Request)

Info
vérifiez la date d'éligibilité afin de vous assurer de ne pas soumettre un dossier avec ce produit avant que celle-ci ne soit valide.

Exemple de réponse

Bloc de code

language	json

{
    "ResponseData": [
        {
            "ProductId": "EEE.M1.010",
            "ProductName": "Cave à vin",
            "EligibilityStartDate": "2022-01-01T00:00:00",
            "EligibilityEndDate": "9999-12-31T00:00:00",
            "RepairCodes": [
                "XXX",
                "PSP",
                "G12",
                "G13",
                "C05",
                "C01",
                "C10",
                "SFT"
            ],
            "IRISSymtoms": [
                "004",
                "006",
                "012",
                "013",
                "001",
                "023"
            ]
        },
        ...
  ],
    "ResponseStatus": "S",
    "IsValid": true,
    "ResponseMessage": "",
    "ResponseErrorMessage": ""
}

Demandes de soutien

Plusieurs méthodes sont disponibles pour gérer la construction et la soumission d’une demande de soutien, tout en s’assurant que les équipements concernés y seront éligibles.

Calculer le montant du soutien - /CalculateEcoSupport
État
colour Green
title GET

URL Preprod = https://preprod-apiecologic.e-reparateur.eco/api/v3/ecosupport/calculateccosupport

URL Prod = https://apiecologic.e-reparateur.eco/api/v3/ecosupport/calculateccosupport

Fonctions

permet de connaître l'éligibilité, l'éco-organisme et le montant du soutien pour un type de produit donné, en fonction du symptôme ou du code section fourni. Cette API n'a pour seul but que de simuler la demande de soutien.

Elle n'effectue aucune demande réelle auprès d'Ecologic.

Données à transmettre

exemple

Bloc de code

language	json

{
    "TotalAmountExclVAT": 120.00,
    "TotalAmountExclVAT_Currency": "EUR",
    "BrandId": 8055,
    "ProductId": 3032,
    "IRISSymtom": "001" 
 }

Données en entrée

TotalAmountExclVAT : Montant total HT de la réparation
TotalAmountExclVAT_Currency : Devise
BrandId: Code de la marque (retourné préalablement par l'API /PrintBrandList)
ProductId : Code du type de produit (retourné préalablement par l'API /PrintProductTypeList)
IRISSymptom : Liste des codes symptôme IRIS éligibles pour le type de produits et pour Ecologic

Données en sortie

EcoOrganizationId: Identifiant e-Reparateur de l'éco-organisme (44=Ecologic, 45=Ecosystem)
SupportAmount: Montant TTC du soutien

Exemple de paramètre en entrée

Exemple de réponse

Bloc de code

language	json

{
    "ResponseData": [
        {
            "EcoOrganizationId": 44,
            "SupportAmount": 10.00
        }
    ],
    "ResponseStatus": "S",
    "IsValid": true,
    "ResponseMessage": "",
    "ResponseErrorMessage": ""
}

Gestion des erreurs

si le produit ou la marque n’est pas connu vous aurez une réponse similaire à

Bloc de code

language	json

{
    "ResponseData": null,
    "ResponseStatus": "W",
    "IsValid": false,
    "ResponseMessage": "Produit pas valide",
    "ResponseErrorMessage": null
}

Si le symptôme ne correspond pas au code IRIS du produit l’erreur sera

Bloc de code

language	json

{
    "ResponseData": null,
    "ResponseStatus": "W",
    "IsValid": false,
    "ResponseMessage": "Symptôme pas valide",
    "ResponseErrorMessage": null
}

Si la fiche de compétence (ou fiche métier) associée au produit soumis, issue de la labélisation, n’est pas associée au site faisant la demande un refus sera retourné

Bloc de code

  {
    "ResponseData": null,
    "ResponseStatus": "W",
    "IsValid": false,
    "ResponseMessage": "Votre compte n'est pas autorisé à effectuer une demande de soutien pour ce type de produit.",
    "ResponseErrorMessage": null
}

Effectuer la demande de soutien - /CreateSupportRequest
État
colour Yellow
title POST

URL Preprod = https://preprod-apiecologic.e-reparateur.eco/api/v3/ecosupport/createsupportrequest

URL Prod = https://apiecologic.e-reparateur.eco/api/v3/ecosupport/createsupportrequest

Fonctions

Permet de soumettre la demande de soutien en vue d'obtenir la vérification du consommateur.

Remarque
Cette étape est obligatoire, car l'Id de la demande sera demandé lors de la création de la demande de remboursement.

Données à transmettre

exemple

Bloc de code

language	json

{
  "Consumer": {
    "Title": 1,
    "LastName": "Test Nom",
    "FirstName": "Test prénom",
    "StreetNumber": "15",
    "Address1": "Avenue du Centre",
    "Address2": "",
    "Address3": "",
    "Zip": "78280",
    "City": "GUYANCOURT",
    "Country": "250",
    "Phone": "0600000000",
    "Email": "test@egmail.com",
    "AutoValidation": true
},
  "Product": {
    "ProductId": "EEE.M5.024",
    "BrandId": "2194",
    "CommercialRef": "Repasse Plus",
    "SerialNumber": "ABCDE",
    "PurchaseDate": "2020-10-06",
    "IRISCondition": "",
    "IRISConditionEX": "",
    "IRISSymptom": "013",
    "IRISSection": "",
    "IRISDefault": "",
    "IRISRepair": "",
    "FailureDescription": "Symptome code IRIS 013",
    "DefectCode": ""  
},
  "Quote": {
    "LaborCost": {
      "Amount": 20.00,
      "Currency": "EUR"
    },
    "SparePartsCost": {
      "Amount": 10.00,
      "Currency": "EUR"
    },
    "TravelCost": {
      "Amount": 0.00,
      "Currency": "EUR"
    },
    "TotalAmountExclVAT": {
      "Amount": 100.00,
      "Currency": "EUR"
    },
    "TotalAmountInclVAT": {
      "Amount": 106.00,
      "Currency": "EUR"
    },
    "SupportAmount": {
      "Amount": 10.00,
      "Currency": "EUR"
    }
  },
  "SpareParts": [
    {
      "Partref": "",
      "Quantity": 0,
      "Status": ""
    }
  ]
}

Données en entrée

Dans les paramètres

CallDate= date de référence de l’appel à l’API
RepairSiteId= ID de votre compte e-reparateur.eco
QuoteNumber= numéro du devis

Dans le body

il y a 3 sections importantes

Consumer : fourni
- identité
  - Title -> 1 : Mrs. ; 2 : Ms. ; 3 : Mr. ; 4 : Société
- adresse
  - Country: 250 pour la France (List of ISO 3166 country codes - Wikipedia )
- téléphone = très important en cas de mode de vérification par SMS
- email
Product : défini tous les paramètres du produit en réparation
- ProductID = code du produit du référentiel
- BrandID = code de la marque
- SerialNumber = numéro de série
- IRISSymptom = code IRIS de symptôme retenu associé au produit (doit correspondre à une entrée du référentiel retourné par PrintProductTypeList
- FailureDescription = description des symptômes de la panne (ou de la panne)
Quote : défini les montants du devis associé à la demande

Données en sortie

RequestId: Identifiant de la demande de soutien
Cet ID unique sera à fournir pour toute référence à la demande de soutien qui vient d'être créée.

Exemple de réponse

Bloc de code

language	json

{
    "ResponseData": {
        "EcoOrganizationId": 44,
        "RequestId": 5310857,
        "IsValid": true
    },
    "ResponseStatus": "S",
    "IsValid": true,
    "ResponseMessage": "",
    "ResponseErrorMessage": ""
}

Gestion des modes SMS ou Offline

il est possible de déclencher une demande de soutien en utilisant 2 modes différents

mode SMS = le consommateur se verra envoyé un SMS avec un lien vers une page web lui permettant de valider la demande créée par le réparateur afin de s’assurer de la légitimité de la procédure en cours
mode Offline = le consommateur n’est pas sollicité par SMS. Cela permet de traiter les cas où ce dernier n’est pas en situation de traiter un SMS (téléphone en panne, manque de pratique…)
Le consommateur doit alors signer un document qui devra être transmis avec la demande de remboursement.

Info
si le mode Offline est utilisé, toute demande de remboursement à laquelle ne sera pas joint le document signé par le consommateur ne sera pas validable pour être traitée par Ecologic.

le mode Offline est déclenché en ajoutant le paramètre "AutoValidation": true dans la structure des informations pour "Consumer"

Bloc de code

{
  "Consumer": {
    "Title": 1,
    "LastName": "Test Nom",
    "FirstName": "Test prénom",
    "StreetNumber": "15",
    "Address1": "Avenue du Centre",
    "Address2": "",
    "Address3": "",
    "Zip": "78280",
    "City": "GUYANCOURT",
    "Country": "250",
    "Phone": "0600000000",
    "Email": "test@egmail.com",
    "AutoValidation": true
},

💡 Ne rien mettre ou mettre "AutoValidation": false sont équivalents

Suivre le statut de la demande de soutien - /GetSupportRequestStatus
État
colour Green
title GET

URL Preprod = https://preprod-apiecologic.e-reparateur.eco/api/v3/ecosupport/getsupportrequestStatus

URL Prod = https://apiecologic.e-reparateur.eco/api/v3/ecosupport/getsupportrequestStatus

Fonctions

permet de savoir si le consommateur a donné sa validation pour une demande de soutien donnée.

Données en entrée

Dans les paramètres

RequestId = Id de votre dossier issu de la réponse à CreateSupportRequest
Ex : /GetSupportRequestStatus?RequestId=1564

Données en sortie

LastStatus: Dernier statut de la demande de soutien
- mode SMS non validé par le consommateur = "En attente de validation consommateur"
- mode SMS validé par le consommateur ou mode offline : "Validé par le consommateur"
- refusé

Exemple de réponse

Bloc de code

language	json

{
    "ResponseData": [
        {
            "RequestId": 5310857,
            "LastStatus": "Validé par le consommateur",
            "Comment": "Symptome code IRIS 013",
            "CreateDate": "2023-03-01T15:49:50.4"
        }
    ],
    "ResponseStatus": "S",
    "IsValid": true,
    "ResponseMessage": "",
    "ResponseErrorMessage": ""
}

Effectuer la demande de soutien - /UpdateSupportRequest
État
colour Yellow
title POST

URL Preprod = https://preprod-apiecologic.e-reparateur.eco/api/v3/ecosupport/updatesupportrequest

URL Prod = https://apiecologic.e-reparateur.eco/api/v3/ecosupport/updatesupportrequest

Fonctions

permet de mettre à jour, compléter une demande de soutien (Request) avec un jeu de données

Remarque

Une demande de soutien (Request) validée par le consommateur ne peut plus être modifiée

Donc si en mode SMS le consommateur a validé ou si le processus est en mode Offline, la demande de modification retournera une erreur

Données en entrée

Dans les paramètres

RequestId = Id de votre dossier issu de la réponse à CreateSupportRequest
Ex : /GetSupportRequestStatus?RequestId=1564

Données en sortie

RequestId : numéro du dossier de soutien (request)
IsValid : true si le dossier est prêt à être soumis

Exemple de réponse

Bloc de code

language	json

{
    "ResponseData": {
        "EcoOrganizationId": 44,
        "RequestId": 5310864,
        "IsValid": true
    },
    "ResponseStatus": "S",
    "IsValid": true,
    "ResponseMessage": "",
    "ResponseErrorMessage": ""
}

Gestion des demandes de remboursement

Une fois le dossier de soutien accepté et validé par le consommateur, la demande de remboursement peut être créée et gérée.

Créer une demande de remboursement - /CreateClaim
État
colour Yellow
title POST

URL Preprod = https://preprod-apiecologic.e-reparateur.eco/api/v3/ecosupport/createclaim

URL Prod = https://apiecologic.e-reparateur.eco/api/v3/ecosupport/createclaim

Fonctions

permet d'effectuer la demande de remboursement (Claim) en convertissant une demande de soutien (Request)

En retour de cet appel, vous obtiendrez l'ID de votre demande de remboursement (ClaimId), qu'il vous faudra utiliser pour corriger les erreurs de validation, pour ajouter les pièces jointes requises et finalement soumettre votre demande.

Données à transmettre

exemple

Bloc de code

language	json

{
  "Consumer": {
    "Title": 1,
    "LastName": "Test Nom",
    "FirstName": "Test prénom",
    "StreetNumber": "15",
    "Address1": "Avenue du Centre",
    "Address2": "",
    "Address3": "",
    "Zip": "78280",
    "City": "GUYANCOURT",
    "Country": "250",
    "Phone": "0600000000",
    "Email": "test@egmail.com",
    "AutoValidation": false  
},
  "Product": {
    "ProductId": "EEE.M5.024",
    "BrandId": "2194",
    "CommercialRef": "Repasse Plus",
    "SerialNumber": "ABCDE",
    "PurchaseDate": "2020-10-06",
    "IRISCondition": "",
    "IRISConditionEX": "",
    "IRISSymptom": "",
    "IRISSection": "G18",
    "IRISDefault": "",
    "IRISRepair": "",
    "FailureDescription": "Code IRIS Symptome 013",
    "DefectCode": ""  
},
  "Quote": {
    "LaborCost": {
      "Amount": 20.00,
      "Currency": "EUR"
    },
    "SparePartsCost": {
      "Amount": 10.00,
      "Currency": "EUR"
    },
    "TravelCost": {
      "Amount": 0.00,
      "Currency": "EUR"
    },
    "TotalAmountExclVAT": {
      "Amount": 100.00,
      "Currency": "EUR"
    },
    "TotalAmountInclVAT": {
      "Amount": 106.00,
      "Currency": "EUR"
    },
    "SupportAmount": {
      "Amount": 10.00,
      "Currency": "EUR"
    }
  },
  "SpareParts": [
    {
      "Partref": "",
      "Quantity": 0,
      "Status": ""
    }
  ]
}

Données en entrée

Dans les paramètres
ex : /CreateClaim?RequestId=1564&RepairEndDate=2022-06-27T11:50:37.913Z&RepairSiteId=54654&ConsumerInvoiceNumber=132564

RequestId = date de référence du dossier de demande de soutien, issue de la réponse à CreateSupportRequest
RepairEndDate = Date de référence de la fin de réparation (ISO8601)
RepairSiteId = ID de votre compte e-reparateur.eco
ConsumerInvoiceNumber = numéro de référence de votre facture cliente
quoteNumber
État
colour Blue
title optionnel
= numéro de référence interne chez le réparateur

Dans le body

Remarque
Vérifiez bien la liste des champs obligatoires dans le Swagger et dans le fichier YAML ou JSON de l’API

IRISSection = il faut intégrer le code panne IRIS parmi celles associées au produit dans le référentiel

Données en sortie

ClaimId : Identifiant du dossier de remboursement
IsValid : indique si le dossier de remboursement est valide (true ou false)
ValidationErrors : tableau des erreurs détectées si IsValid = false

Exemple de réponse

Bloc de code

language	json

{
    "ResponseData": {
        "ClaimId": 5310865,
        "IsValid": false,
        "ValidationErrors": [
            {
                "Field": "Plaque signalétique",
                "ErrorMessage": "Des pièces jointes sont requises : Plaque signalétique",
                "MessageType": "E"
            },
            {
                "Field": "Facture",
                "ErrorMessage": "Des pièces jointes sont requises : Facture",
                "MessageType": "E"
            }
        ],
        "ErrorMessage": "Validation Errors"
    },
    "ResponseStatus": "S",
    "IsValid": true,
    "ResponseMessage": "",
    "ResponseErrorMessage": ""
}

Ajouter une pièce jointe à la demande de remboursement - /AttachFile
État
colour Yellow
title POST

URL Preprod = https://preprod-apiecologic.e-reparateur.eco/api/v3/ecosupport/AttachFile

URL Prod = https://apiecologic.e-reparateur.eco/api/v3/ecosupport/AttachFile

Fonctions

permet d'ajouter un document à une demande de remboursement.

Info

Formats supportés en entrée

jpg
jpeg
png
pdf

Un dossier de remboursement peut contenir plusieurs types de fichiers

les types de fichiers qui peuvent être joints à une demande :

Info
facture = INVOICE plaque signalétique = NAMEPLATE photo de l’appareil = PRODUCTPICTURE validation consommateur signée = CONSUMERVALIDATION

Info

Les pièces jointes obligatoires sont :

la facture,
~~1 photo minimum du produit,~~
la photo de la plaque signalétique.

Toute demande de remboursement qui ne disposerait pas de ces documents sera "non valide" et ne pourra être soumise.

Éventuellement le bordereau de validation du conso peut-être exigé dans certains cas de figure.

Données à transmettre

exemple

Bloc de code

language	json

{
  "FileContent": "KJQFKJSQKJDKJQSJDKLFDSGDGDG5F4D65HG46G4D5FSG456FD4G4SG64FSDG5FD5G46DS5G456FD4G56FDSG654FDS56G4F6DG54FDS6G5FD6SG45FS4D6G4F56D4SG654S6G4F5D4G6S45FD4G45SFD4G65FD4SG65DF46S4"
 }

Données en entrée

Dans les paramètres
ex : /AttachFile?ClaimId=16466&FileName=Facture797&FileExtension=pdf&DocumentType=Invoice

ClaimId = date de référence du dossier de demande de remboursement, issu de la réponse à CreateClaim
FileName = nom du fichier transmis (sans l’extension)
FileExtension = extension du fichier (voir ci contre)
- permet de définir le type
- extension sans le point “.”
DocumentType = type de document transmis à intégrer dans la demande (voir les codes identifiants ci contre)

Dans le body

FileContent = contenu du fichier en Base64

Astuce

pour test exemple d’encodeur Base64 en ligne

https://base64.guru/converter/encode/file

Données en sortie

"Code 200 -> OK"

Le statut de sortie est géré par le statut de la réponse HTTP

Code 200 -> OK
Code 400 -> Bad request
Code 500 -> Internal Error

Mettre à jour, corriger et soumettre la demande de remboursement - /UpdateClaim
État
colour Yellow
title POST

URL Preprod = https://preprod-apiecologic.e-reparateur.eco/api/v3/ecosupport/updateclaim

URL Prod = https://apiecologic.e-reparateur.eco/api/v3/ecosupport/updateclaim

Fonctions

permet de mettre à jour, de corriger et de soumettre la demande de remboursement. La mise à jour n'est plus possible après la soumission de la demande.

Données à transmettre

Exemple (les données ci-dessous de l’exemple sont à mettre à jour; en effet des champs sont obsolètes)

Bloc de code

language	json

{
  "Consumer": {
    "Title": 1,
    "LastName": "Test Nom",
    "FirstName": "Test prénom",
    "StreetNumber": "15",
    "Address1": "Avenue du Centre",
    "Address2": "",
    "Address3": "",
    "Zip": "78280",
    "City": "GUYANCOURT",
    "Country": "250",
    "Phone": "0600000000",
    "Email": "test@egmail.com",
    "AutoValidation": false  
},
  "Product": {
    "ProductId": "EEE.M5.024",
    "BrandId": "2194",
    "CommercialRef": "Repasse Plus",
    "SerialNumber": "ABCDE",
    "PurchaseDate": "2020-10-06",
    "IRISCondition": "",
    "IRISConditionEX": "",
    "IRISSymptom": "",
    "IRISSection": "G18",
    "IRISDefault": "",
    "IRISRepair": "",
    "FailureDescription": "Code IRIS Symptome 013",
    "DefectCode": ""  
},
  "Quote": {
    "LaborCost": {
      "Amount": 20.00,
      "Currency": "EUR"
    },
    "SparePartsCost": {
      "Amount": 10.00,
      "Currency": "EUR"
    },
    "TravelCost": {
      "Amount": 0.00,
      "Currency": "EUR"
    },
    "TotalAmountExclVAT": {
      "Amount": 100.00,
      "Currency": "EUR"
    },
    "TotalAmountInclVAT": {
      "Amount": 106.00,
      "Currency": "EUR"
    },
    "SupportAmount": {
      "Amount": 10.00,
      "Currency": "EUR"
    }
  },
  "SpareParts": [
    {
      "Partref": "",
      "Quantity": 0,
      "Status": ""
    }
  ]
}

Données en entrée

Dans les paramètres
ex : /UpdateClaim?ClaimId=5310865&repairEndDate=2023-02-24T11:00:00Z&RepairSiteId=02c867c0-3cef-454d-9a04-3cf8de2dc1c8&consumerInvoiceNumber=FACT_20230301-1&quoteNumber=REF_INT_20230301-1&Submit=false

ClaimId = date de référence du dossier de demande de soutien, issu de la réponse à CreateSupportRequest
RepairEndDate = Date de référence de la fin de réparation (ISO8601)
RepairSiteId = ID de votre compte e-reparateur.eco
ConsumerInvoiceNumber = numéro de référence de votre facture cliente
quoteNumber
État
colour Blue
title optionnel
= numéro de référence interne chez le réparateur
Submit = 💡 indique si la mise à jour déclenche ou non la soumission
- false = la mise à jour n’est pas suivi d’une tentative de soumission
- true = la mise à jour entraine une tentative de soumission

Dans le body

Remarque
Vérifiez bien la liste des champs obligatoires dans le Swagger et dans le fichier YAML ou JSON de l’API

Données en sortie

ClaimId : Identifiant du dossier de remboursement en cours
IsValid : indique si le dossier de remboursement est valide (true ou false)
ValidationErrors : tableau des erreurs détectées si IsValid = false

Exemple de réponse

Bloc de code

language	json

{
    "ResponseData": {
        "ClaimId": 5275562,
        "IsValid": false,
        "ValidationErrors": [
            {
                "Field": "Plaque signalétique",
                "ErrorMessage": "Des pièces jointes sont requises : Plaque signalétique",
                "MessageType": "E"
            },
            {
                "Field": "Facture",
                "ErrorMessage": "Des pièces jointes sont requises : Facture",
                "MessageType": "E"
            },
            {
                "Field": "Panne ou code IRIS",
                "ErrorMessage": "Cette valeur est obligatoire",
                "MessageType": "E"
            }
        ],
        "ErrorMessage": "Validation Errors"
    },
    "ResponseStatus": "S",
    "IsValid": true,
    "ResponseMessage": "",
    "ResponseErrorMessage": ""
}

Si la soumission est OK

Bloc de code
{ "ResponseData": { "ClaimId": 5310865, "IsValid": true }, "ResponseStatus": "S", "IsValid": true, "ResponseMessage": "", "ResponseErrorMessage": "" }

Facture non conforme à la soumission

exemple de facture non liée à l’utilisateur

Bloc de code

{
    "ResponseData": {
        "ClaimId": 5310865,
        "IsValid": false,
        "ValidationErrors": [
            {
                "Field": "OCR facture",
                "ErrorMessage": "La facture n'est pas conforme (Nom du consommateur)",
                "MessageType": "E"
            }
        ],
        "ErrorMessage": "Validation Errors"
    },
    "ResponseStatus": "S",
    "IsValid": true,
    "ResponseMessage": "",
    "ResponseErrorMessage": ""
}

Sou

Suivre le statut de la demande de remboursement - /GetClaimStatus
État
colour Green
title GET

URL Preprod = https://preprod-apiecologic.e-reparateur.eco/api/v3/ecosupport/getclaimstatus

URL Prod = https://apiecologic.e-reparateur.eco/api/v3/ecosupport/getclaimstatus

Fonctions

permet de connaitre le statut d'une demande de remboursement qui a été soumise.

Données à transmettre

Exemple

/GetClaimStatus?ClaimId=16466

Données en entrée

Dans les paramètres
ex : /GetClaimStatus?ClaimId=16466

ClaimId = date de référence du dossier de demande de soutien, issu de la réponse à CreateSupportRequest

Données en sortie

LastStatus : Dernier statut de la demande de soutien
- “Dossier incomplet” : des pièces ou des informations doivent être ajoutées au dossier de demande de remboursement (Claim) avant de tenter de le soumettre

Info
Le statut "NotConform" indique qu'une action de correction est requise par Ecologic. Ce statut permet de visualiser la demande dans le champ "Comment" et de mettre à jour la demande de remboursement puis finalement de la soumettre à nouveau.

Exemple de réponse

Bloc de code

language	json

{
    "ClaimId": null,
    "ResponseData": {
        "ClaimId": 5310865,
        "LastStatus": "Dossier incomplet",
        "Comment": "Code IRIS Symptome 013",
        "CreateDate": "2023-03-01T16:41:06.857"
    },
    "ResponseStatus": "S",
    "IsValid": true,
    "ResponseMessage": "",
    "ResponseErrorMessage": ""
}

SwaggerUI (en rédaction)

Remarque
Les éléments présentés ci-dessous ne sont pas fonctionnels et en cours de déploiement.

Swagger open api macro

swagger: '2.0'
info:
  description: Ecologic e-reparateur API Portal
  version: 2.0.0
  title: Ecologic e-reparateur API Portal
  contact:
    email: support@e-reparateur.eco
host: preprod-apiecologic.e-reparateur.eco
basePath: /v2
tags:
  - name: Ecologic e-reparateur  Web APIs
    description: Ecologic e-reparateur Web APIs
    externalDocs:
      description: Find out more
      url: http://support.e-reparateur.eco
schemes:
  - https
  - http
paths:
  /api/v2/EcoSupport/CreateSupportRequest:
    post:
      tags:
        - EcoSupport
      summary: Request for an ECO Support
      description: ''
      operationId: CreateSupportRequest
      produces:
        - application/json
        - text/json
        - application/xml
        - text/xml
      parameters:
        - name: CallDate
          in: query
          description: Date the consumer contact the repair center took in charge the appliance
          required: true
          type: string
          format: date-time
        - name: RepairSiteId
          in: query
          description: Site ID of the repair
          required: true
          type: string
        - name: QuoteNumber
          in: query
          description: Number of the quote
          required: true
          type: string
        - in: body
          name: RepairDetails
          description: Details needed for the Eco support
          required: true
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.EcoSupport.RepairDetails'
      responses:
        '200':
          description: successful operation
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.Response.CreateSupportRequestResponse'
        '400':
          description: Bad request
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.Response.ErrorResponse'
        '500':
          description: InternalServerError
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.Response.ErrorResponse'
  /api/v2/EcoSupport/GetSupportRequestStatus:
    get:
      tags:
        - EcoSupport
      summary: Get support request status
      operationId: GetSupportRequestStatus
      consumes: []
      produces:
        - application/json
        - text/json
        - application/xml
        - text/xml
      parameters:
        - name: RequestId
          in: query
          description: Identifier of the request in Agora
          required: false
          type: integer
          format: int32
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.Response.RequestStatusResponse'
        '500':
          description: InternalServerError
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.Response.ErrorResponse'
  /api/v2/EcoSupport/CreateClaim:
    post:
      tags:
        - EcoSupport
      summary: Claim for reimbursment
      description: ''
      operationId: CreateClaim
      produces:
        - application/json
        - text/json
        - application/xml
        - text/xml
      parameters:
        - name: RequestId
          in: query
          description: Support request identifier, returned by e-reparateur (CreateSupportRequest)
          required: true
          type: integer
          format: int32
        - name: RepairEndDate
          in: query
          description: Date of the end of the repair
          required: true
          type: string
          format: date-time
        - name: RepairSiteId
          in: query
          description: Qualirepar ID of the repair site
          required: true
          type: string
        - name: ConsumerInvoiceNumber
          in: query
          description: Invoice number
          required: true
          type: string
        - in: body
          name: RepairDetails
          description: Details needed for the Eco support
          required: true
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.EcoSupport.RepairDetails'
      responses:
        '200':
          description: successful operation
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.Response.ClaimResponse'
        '400':
          description: Bad request
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.Response.ErrorResponse'
        '500':
          description: InternalServerError
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.Response.ErrorResponse'
  /api/v2/EcoSupport/UpdateClaim:
    post:
      tags:
        - EcoSupport
      summary: Update the claim to fix issue raised by e-reparateur 
      description: ''
      operationId: UpdateClaim
      produces:
        - application/json
        - text/json
        - application/xml
        - text/xml
      parameters:
        - name: ClaimId
          in: query
          description: Identifier of the claim provided by e-reparateur after the creation
          required: true
          type: integer
          format: int32
        - name: RepairEndDate
          in: query
          description: Date of the end of the repair
          required: true
          type: string
          format: date-time
        - name: RepairSiteId
          in: query
          description: Site ID of the repair
          required: true
          type: string
        - name: ConsumerInvoiceNumber
          in: query
          description: Invoice number
          required: true
          type: string
        - name: Submit
          in: query
          description: Submit claim if valid
          required: false
          type: boolean
        - in: body
          name: Body
          description: Repair details
          required: true
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.EcoSupport.RepairDetails'
      responses:
        '200':
          description: successful operation
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.Response.ClaimResponse'
        '400':
          description: Bad request
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.Response.ErrorResponse'
        '500':
          description: InternalServerError
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.Response.ErrorResponse'
  /api/v2/EcoSupport/AttachFile:
    post:
      tags:
        - EcoSupport
      summary: Attach a file to the claim
      description: ''
      operationId: AttachedFile
      produces:
        - application/json
        - text/json
        - application/xml
        - text/xml
      parameters:
        - name: ClaimId
          in: query
          description: Identifier of the claim provided by e-reparateur after the creation
          required: true
          type: integer
          format: int32
        - name: FileName
          in: query
          description: Date of the end of the repair
          required: true
          type: string
        - name: FileExtension
          in: query
          description: File extension
          required: true
          type: string
        - name: DocumentType
          in: query
          description: Document type. Possible values (Invoice, Nameplate)
          required: true
          type: string
        - name: FileContent
          in: body
          description: Document content in base 64.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
        '400':
          description: Bad request
        '500':
          description: InternalServerError
  /api/v2/EcoSupport/GetClaimStatus:
    get:
      tags:
        - EcoSupport
      summary: Get claim status
      operationId: GetClaimStatus
      consumes: []
      produces:
        - application/json
        - text/json
        - application/xml
        - text/xml
      parameters:
        - name: Claimid
          in: query
          description: Identifier of the request in Agora
          required: false
          type: integer
          format: int32
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.Response.ClaimStatusResponse'
        '500':
          description: InternalServerError
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.Response.ErrorResponse'
  /api/v2/EcoSupport/CalculateEcoSupport:
    get:
      tags:
        - EcoSupport
      summary: Check the eligibility and Calculate the suppport
      operationId: CalculateEcoSupport
      consumes: []
      produces:
        - application/json
        - text/json
        - application/xml
        - text/xml
      parameters:
        - name: TotalAmountExclVAT
          in: query
          description: Identifier of the request in Agora
          type: number
          format: float
        - name: TotalAmountExclVAT_Currency
          in: query
          description: Identifier of the request in Agora
          type: string
        - name: BrandId
          in: query
          description: Identifier of the request in Agora
          required: false
          type: integer
          format: int32
        - name: ProductId
          in: query
          description: Identifier of the request in Agora
          required: false
          type: integer
          format: int32
        - name: IRISSymptom
          in: query
          description: Identifier of the request in Agora
          required: false
          type: string
        - name: RepairCode
          in: query
          description: Repair code or Iris Repair code
          required: false
          type: string
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.Response.CalculateSupportResponse'
        '500':
          description: InternalServerError
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.Response.ErrorResponse'
  /api/v2/EcoSupport/PrintBrandList:
    get:
      tags:
        - EcoSupport
      summary: Print the list of brands
      operationId: PrintBrandList
      consumes: []
      produces:
        - application/json
        - text/json
        - application/xml
        - text/xml
      parameters: []
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.Response.PrintBrandListResponse'
        '500':
          description: InternalServerError
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.Response.ErrorResponse'
  /api/v2/EcoSupport/PrintProductTypeList:
    get:
      tags:
        - EcoSupport
      summary: Print the list of product type with for each its related repair codes and symptom codes
      operationId: PrintProductTypeList
      consumes: []
      produces:
        - application/json
        - text/json
        - application/xml
        - text/xml
      parameters: []
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.Response.PrintProductTypeListResponse'
        '500':
          description: InternalServerError
          schema:
            $ref: '#/definitions/AgoraWebServices.Models.Response.ErrorResponse'
securityDefinitions:
  api_key:
    type: apiKey
    description: API Key Authentication
    name: api_key
    in: header
definitions:
  AgoraWebServices.Models.EcoSupport.RepairDetails:
    type: object
    required:
      - Consumer
      - Product
      - Quote
    properties:
      Consumer:
        type: object
        $ref: '#/definitions/AgoraWebServices.Models.EcoSupport.Consumer'
      Product:
        type: object
        $ref: '#/definitions/AgoraWebServices.Models.EcoSupport.Product'
      Quote:
        type: object
        $ref: '#/definitions/AgoraWebServices.Models.EcoSupport.CostDetails'
      SpareParts:
        type: array
        items:
          $ref: '#/definitions/AgoraWebServices.Models.EcoSupport.Sparepart'
    xml:
      name: Request
  AgoraWebServices.Models.EcoSupport.Consumer:
    type: object
    required:
      - LastName
      - Address1
      - Zip
      - City
      - Country
      - Email
    properties:
      Title:
        type: integer
        format: int32
      LastName:
        type: string
      FirstName:
        type: string
      StreetNumber:
        type: string
      Address1:
        type: string
      Address2:
        type: string
      Address3:
        type: string
      Zip:
        type: string
      City:
        type: string
      Country:
        type: string
      Phone:
        type: string
      Email:
        type: string
    xml:
      name: Consumer
  AgoraWebServices.Models.EcoSupport.Product:
    type: object
    required:
      - ProductId
      - BrandId
      - SerialNumber
      - PurchaseDate
      - IRISSymptom
    properties:
      ProductId:
        type: string
      BrandId:
        type: string
      CommercialRef:
        type: string
      SerialNumber:
        type: string
      PurchaseDate:
        type: string
        format: date
      IRISCondition:
        type: string
      IRISConditionEX:
        type: string
      IRISSymptom:
        type: string
      IRISSection:
        type: string
      IRISDefault:
        type: string
      IRISRepair:
        type: string
      FailureDescription:
        type: string
      DefectCode:
        type: string
    xml:
      name: Product
  AgoraWebServices.Models.EcoSupport.CostDetails:
    type: object
    required:
      - LaborCost
      - SparePartsCost
      - TravelCost
      - TotalAmountExclVAT
      - TotalAmountInclVAT
      - SupportAmount
    properties:
      LaborCost:
        type: object
        properties:
          Amount:
            type: number
            format: float
          Currency:
            type: string
      SparePartsCost:
        type: object
        properties:
          Amount:
            type: number
            format: float
          Currency:
            type: string
      TravelCost:
        type: object
        properties:
          Amount:
            type: number
            format: float
          Currency:
            type: string
      TotalAmountExclVAT:
        type: object
        properties:
          Amount:
            type: number
            format: float
          Currency:
            type: string
      TotalAmountInclVAT:
        type: object
        properties:
          Amount:
            type: number
            format: float
          Currency:
            type: string
      SupportAmount:
        type: object
        properties:
          Amount:
            type: number
            format: float
          Currency:
            type: string
    xml:
      name: Quote
  AgoraWebServices.Models.EcoSupport.Sparepart:
    type: object
    required:
      - Partref
      - Quantity
      - Status
    properties:
      Partref:
        type: string
      Quantity:
        type: integer
        format: int64
      Status:
        type: string
    xml:
      name: Sparepart
  Tag:
    type: object
    properties:
      id:
        type: integer
        format: int64
      name:
        type: string
    xml:
      name: Tag
  AgoraWebServices.Models.Response.CreateSupportRequestResponse:
    description: Create complete repair method response values
    type: object
    properties:
      ResponseData:
        $ref: '#/definitions/AgoraWebServices.Models.Response.SupportRequestResponseData'
        description: Response data
      ResponseStatus:
        description: 'Response status ("S" : Sucess, "E": Error, "W":Warning)'
        type: string
      IsValid:
        description: Response validity
        type: boolean
      ResponseMessage:
        description: Response message
        type: string
      ResponseErrorMessage:
        description: Response Error Message
        type: string
  AgoraWebServices.Models.Response.SupportRequestResponseData:
    description: Response data from create complete repair method
    type: object
    properties:
      EcoOrganizationId:
        format: int32
        description: Identifier of the Eco organization who will provide the suppot
        type: integer
      RequestId:
        format: int32
        description: e-reparateur internal identifier of the request
        type: integer
      IsValid:
        description: Validity
        type: boolean
      ErrorMessage:
        description: Error message
        type: string
  AgoraWebServices.Models.Response.ClaimResponse:
    description: Create complete repair method response values
    type: object
    properties:
      ResponseData:
        $ref: '#/definitions/AgoraWebServices.Models.Response.ClaimResponseData'
        description: Response data
      ResponseStatus:
        description: 'Response status ("S" : Sucess, "E": Error, "W":Warning)'
        type: string
      IsValid:
        description: Response validity
        type: boolean
      ResponseMessage:
        description: Response message
        type: string
      ResponseErrorMessage:
        description: Response Error Message
        type: string
  AgoraWebServices.Models.Response.ClaimResponseData:
    description: Response data from create complete repair method
    type: object
    properties:
      ClaimId:
        format: int32
        description: e-reparateur internal identifier of the request
        type: integer
      IsValid:
        description: Validity
        type: boolean
      ValidationErrors:
        description: Validation errors
        type: array
        items:
          $ref: '#/definitions/AgoraWebServices.Models.Return.ValidationResult'
      ErrorMessage:
        description: Error message
        type: string
  AgoraWebServices.Models.Return.ValidationResult:
    description: Validation error result values
    type: object
    properties:
      Field:
        description: Field assotiated to the error
        type: string
      ErrorMessage:
        description: Error message
        type: string
      MessageType:
        description: "Type of the error message : \r\n - E : Error\r\n - W : Warning"
        type: string
  AgoraWebServices.Models.Response.ErrorResponse:
    description: Error response object
    type: object
    properties:
      ResponseData:
        description: Response data
        type: object
      ResponseStatus:
        description: 'Response status ("S" : Sucess, "E": Error, "W":Warning)'
        type: string
      IsValid:
        description: Response validity
        type: boolean
      ResponseMessage:
        description: Response message
        type: string
      ResponseErrorMessage:
        description: Response Error Message
        type: string
  AgoraWebServices.Models.Response.RequestStatusResponse:
    description: Get request method response values
    type: object
    properties:
      ResponseData:
        description: Response data
        type: array
        items:
          $ref: '#/definitions/AgoraWebServices.Models.EcoSupport.RequestStatusResponseData'
      ResponseStatus:
        description: 'Response status ("S" : Sucess, "E": Error, "W":Warning)'
        type: string
      IsValid:
        description: Response validity
        type: boolean
      ResponseMessage:
        description: Response message
        type: string
      ResponseErrorMessage:
        description: Response Error Message
        type: string
  AgoraWebServices.Models.EcoSupport.RequestStatusResponseData:
    description: Warranty claim informations
    type: object
    properties:
      RequestId:
        format: int32
        description: Identifier in Agora
        type: integer
      LastStatus:
        description: Last status
        type: string
      Comment:
        description: Comment
        type: string
      CreateDate:
        format: date-time
        description: Creation date
        type: string
  AgoraWebServices.Models.Response.ClaimStatusResponse:
    description: Get request method response values
    type: object
    properties:
      ResponseData:
        description: Response data
        type: array
        items:
          $ref: '#/definitions/AgoraWebServices.Models.EcoSupport.ClaimStatusResponseData'
      ResponseStatus:
        description: 'Response status ("S" : Sucess, "E": Error, "W":Warning)'
        type: string
      IsValid:
        description: Response validity
        type: boolean
      ResponseMessage:
        description: Response message
        type: string
      ResponseErrorMessage:
        description: Response Error Message
        type: string
  AgoraWebServices.Models.EcoSupport.ClaimStatusResponseData:
    description: Warranty claim informations
    type: object
    properties:
      ClaimId:
        format: int32
        description: Identifier in Agora
        type: integer
      LastStatus:
        description: Last status
        type: string
      Comment:
        description: Comment
        type: string
      CreateDate:
        format: date-time
        description: Creation date
        type: string
  AgoraWebServices.Models.Response.CalculateSupportResponse:
    description: Get request method response values
    type: object
    properties:
      ResponseData:
        description: Response data
        type: array
        items:
          $ref: '#/definitions/AgoraWebServices.Models.EcoSupport.CalculateSupportResponseData'
      ResponseStatus:
        description: 'Response status ("S" : Sucess, "E": Error, "W":Warning)'
        type: string
      IsValid:
        description: Response validity
        type: boolean
      ResponseMessage:
        description: Response message
        type: string
      ResponseErrorMessage:
        description: Response Error Message
        type: string
  AgoraWebServices.Models.EcoSupport.CalculateSupportResponseData:
    description: Warranty claim informations
    type: object
    properties:
      EcoOrganizationId:
        format: int32
        description: Identifier of the Eco organization who will provide the suppot
        type: integer
      SupportAmount:
        type: object
        properties:
          Amount:
            type: number
            format: float
          Currency:
            type: string
  AgoraWebServices.Models.Response.PrintBrandListResponse:
    description: Get request method response values
    type: object
    properties:
      ResponseData:
        description: Response data
        type: array
        items:
          $ref: '#/definitions/AgoraWebServices.Models.EcoSupport.PrintBrandListResponseData'
      ResponseStatus:
        description: 'Response status ("S" : Sucess, "E": Error, "W":Warning)'
        type: string
      IsValid:
        description: Response validity
        type: boolean
      ResponseMessage:
        description: Response message
        type: string
      ResponseErrorMessage:
        description: Response Error Message
        type: string
  AgoraWebServices.Models.EcoSupport.PrintBrandListResponseData:
    description: List of brands
    type: object
    properties:
      BrandName:
        description: Brand name
        type: string
      BrandId:
        description: Brand code
        type: string
  AgoraWebServices.Models.Response.PrintProductTypeListResponse:
    description: Get request method response values
    type: object
    properties:
      ResponseData:
        description: Response data
        type: array
        items:
          $ref: '#/definitions/AgoraWebServices.Models.EcoSupport.PrintProductTypeListResponseData'
      ResponseStatus:
        description: 'Response status ("S" : Sucess, "E": Error, "W":Warning)'
        type: string
      IsValid:
        description: Response validity
        type: boolean
      ResponseMessage:
        description: Response message
        type: string
      ResponseErrorMessage:
        description: Response Error Message
        type: string
  AgoraWebServices.Models.EcoSupport.PrintProductTypeListResponseData:
    description: List of brands
    type: object
    properties:
      ProductId:
        description: Identifier of the product
        type: string
      ProductName:
        description: Name of the product type
        type: string
      EligibilityStartDate:
        description: Name of the product type
        type: string
        format: date
      EligibilityEndDate:
        description: Name of the product type
        type: string
        format: date
      RepairCodes:
        type: array
        items:
          type: object
          properties:
            RepairCode:
              description: Repair Code
              type: string
      IRISSymtoms:
        type: array
        items:
          type: object
          properties:
            IRISSymtom:
              description: IRIS code of the symptom
              type: string
externalDocs:
  description: Find out more about Swagger
  url: http://swagger.io

Version	Ancienne version 25	Nouvelle version 26
Modifications effectuées par	Sylvain Roberdeau	Sylvain Roberdeau
Sauvegardée le	mars 01, 2023	mars 01, 2023

Content Comparison

Comparaison des versions

Légende

Historique des versions

Objectifs

Diagramme de séquence

Environnement de développement (Pre Production)

Lexique

Accéder à l’environnement de développement

Pré requis

Procédure

Outils de tests

SwaggerUI

PostMan

Spécifications de l’API

Authentification

Vérification des sites

récupération des informations du site associé à la clé API - /GetRepairSitesByATS ÉtatcolourGreentitleGET

Fonctions

Référentiels des données

Récupération de la liste des marques - /PrintBrandList ÉtatcolourGreentitleGET

Fonctions

Usage

Exemple de réponse

Récupérer la liste des types de produit - /PrintProductTypeList ÉtatcolourGreentitleGET

Fonctions

Exemple usage

Exemple de réponse

Demandes de soutien

Calculer le montant du soutien - /CalculateEcoSupport ÉtatcolourGreentitleGET

Fonctions

Données à transmettre

Données en entrée

Données en sortie

Exemple de réponse

Gestion des erreurs

Effectuer la demande de soutien - /CreateSupportRequest ÉtatcolourYellowtitlePOST

Fonctions

Données à transmettre

Données en entrée

Données en sortie

Exemple de réponse

Gestion des modes SMS ou Offline

Suivre le statut de la demande de soutien - /GetSupportRequestStatus ÉtatcolourGreentitleGET

Fonctions

Données en entrée

Données en sortie

Exemple de réponse

Effectuer la demande de soutien - /UpdateSupportRequest ÉtatcolourYellowtitlePOST

Fonctions

Données en entrée

Données en sortie

Exemple de réponse

Gestion des demandes de remboursement

Créer une demande de remboursement - /CreateClaim ÉtatcolourYellowtitlePOST

Fonctions

Données à transmettre

Données en entrée

Données en sortie

Exemple de réponse

Ajouter une pièce jointe à la demande de remboursement - /AttachFile ÉtatcolourYellowtitlePOST

Fonctions

Données à transmettre

Données en entrée

Données en sortie

Mettre à jour, corriger et soumettre la demande de remboursement - /UpdateClaim ÉtatcolourYellowtitlePOST

Fonctions

Données à transmettre

Données en entrée

Données en sortie

Données en sortie

Exemple de réponse

Facture non conforme à la soumission

Suivre le statut de la demande de remboursement - /GetClaimStatus ÉtatcolourGreentitleGET

Fonctions

Données à transmettre

Données en entrée

Données en sortie

Exemple de réponse

SwaggerUI (en rédaction)

récupération des informations du site associé à la clé API - /GetRepairSitesByATS
État
colour Green
title GET

Récupération de la liste des marques - /PrintBrandList
État
colour Green
title GET

Récupérer la liste des types de produit - /PrintProductTypeList
État
colour Green
title GET

Calculer le montant du soutien - /CalculateEcoSupport
État
colour Green
title GET

Effectuer la demande de soutien - /CreateSupportRequest
État
colour Yellow
title POST

Suivre le statut de la demande de soutien - /GetSupportRequestStatus
État
colour Green
title GET

Effectuer la demande de soutien - /UpdateSupportRequest
État
colour Yellow
title POST

Créer une demande de remboursement - /CreateClaim
État
colour Yellow
title POST

Ajouter une pièce jointe à la demande de remboursement - /AttachFile
État
colour Yellow
title POST

Mettre à jour, corriger et soumettre la demande de remboursement - /UpdateClaim
État
colour Yellow
title POST

Suivre le statut de la demande de remboursement - /GetClaimStatus
État
colour Green
title GET