mars 2017 Yield tarifaire indépendant

Présentation

Ce webservice a pour objectif de retourner suivant certains paramètres un tarif d’assurance.

Les paramètres pris en compte peuvent varier, dans l’exemple ci-dessous, le but est de faire varier le tarif d’assurance suivant :

  • un montant de séjour
  • une durée entre entre la date de réservation et le début de ce séjour

Les champs obligatoires seront donc :

  • identifiant : l’identifiant du vendeur (code client fourni par Gritchen Affinity)
  • mot_de_passe : le mot de passe d’accès au webservice pour le vendeur (code fourni par Gritchen)
  • montant_sejour : le montant du séjour (exemple : 1245.12)
  • debut_date : date de début de séjour (exemple : 2017-12-31)
  • produits : le code (ou les codes) produit d’assurance, (code fourni par Gritchen)

L’URL d’accès au webservice est : https://yield-gap.gritchen.fr/tarif , ce webservice est protégé par un utilisateur et un mot de passe spécifique au prestataire technique et les données échangées seront au format JSON.

Exemple de flux de requête :

{
 "montant_sejour":1000,
 "identifiant":"PN-XXXXX",
 "mot_de_passe":"ma clef api",
 "debut_date":"2017-03-10",
 "produits":"ANNULATION"
}

Cette requête va donc demander le tarif d’assurance pour le produit ANNULATION pour un début de séjour le 10 mars 2017 et un montant de 1000€.

Il sera retourné :

{
 "produits": {
    "ANNULATION": {
       "montant_assurance": 27.8
    }
 },
 "statut_libelle": "succes",
 "statut": 0
}

Soit : un montant d’assurance de 27.80€ pour le produit ANNULATION.

En cas de code produit non reconnu, la valeur retournée sera -1 au niveau du montant de l’assurance.

Le statut 0 indique que tout s’est bien déroulé, en code d’erreur, un autre code sera retourné.

Code de statut

  • 0 : succes
  • 1 : partenaire technique invalide, erreur de l’authentification htaccess
  • 2 : données json envoyées invalides ou manquantes
  • 3 : code vendeur introuvable ou invalide dans le flux json