1. Accueil
  2. SaaS
  3. API

Notre API de financement en temps réel

L'API Novalend vous permet d'intégrer une brique de financement dans votre site ou logiciel.

Notre API REST vous permet d'automatiser le financement de biens matériels ou immatériels. Bénéficiez de son intégration facile et rapide et créez un projet qui réponde à vos problématiques, attentes & objectifs.

Confiez-nous vos idées !

Notre équipe technique peut également développer, pour vous, votre projet sur mesure. N'hésitez pas à nous contacter pour en discuter avec nous.

Demander un accès à l'API



Généralités :

Nous mettons à votre disposition gratuitement un espace de test sécurisé (sandbox) en parallèle de l’environnement de production. Cet espace vous permettra de tester vos prototypes et tout autre exemple d’intégration.

L'API REST utilise les en-têtes HTTP pour l'autorisation.

  • Authorization: Basic votre_token
  • Sandbox API URL : https://test.novalend.com/api/
  • Live API URL : https://www.novalend.com/api/

Request Format

Les demandes doivent être effectuées en JSON. L'en-tête Content-type doit être défini en conséquence sur Content-type: application/json

Format de réponse

Les réponses sont formatées en JSON.

Code de retour standard de l'API

Code Description
200 OK
400 Eligibilities : Cette valeur n'est pas un code SIREN valide.
Quotation : Bad request, dans la réponse vous trouverez une mention du champ causant cette erreur.


API Eligibilities :


Description Permet de tester l’éligibilité d'un client via son numéro SIREN.
URL https://test.novalend.com/api/eligibilities
Méthode POST
Paramètres
  1. siren siren du client. (Integer)
Retour Un objet JSON qui contient les informations ou erreurs associés

Exemple de réponse JSON 

{
  "criterias": {
     "public": {
          "label": "La société est public",
          "code": "public",
          "value": "542051180",
          "result": false
      } ,
      "tradingfollow": {
          "label": "La société dispose de 2 liasses fiscales consécutives",
          "code": "tradingfollow",
          "value": "2017 - 2016",
          "result": true
      },
      "turnover": {
          "eval": "$value >= 400000",
          "label": "La société a un chiffre d'affaire supérieur ou égal à 400.000 Euros",
          "message": "La société a un chiffre d'affaire inférieur à 400 000 Euros",
          "code": "turnover",
          "value": "7085000000",
          "result": true
      } ,
      "financial": {
          "eval": "$value > 0",
          "label": "La société possède des données financières",
          "code": "financial",
          "value": 5,
          "result": true
      }
   },
  "name": "TOTAL SA",
  "isEligible": true
}

API Quotation :


Description Permet d'obtenir les loyers d'un produit donné.
URL https://test.novalend.com/api/quotation
Méthode POST
Paramètres
  1. sirenClient siren du client (Integer)
  2. sirenSupplier siren du fournisseur (Integer)
  3. equipmentType voir tableau ci-dessous (Integer)
  4. duration 12|18|24|30|36|42|48|54|60 mois, dépendant de equipmentType.(Integer)
  5. period valeur entre 1 et 4 pour mensuelle, trimestrielle, semestrielle, annuelle. (Interger)
  6. amount valeur en euros, entre 500 et 50000 (Float)
  7. condition Neuf | Occasion (String)
  8. intangible montant intangible (Float)
  9. rebillable Montant à refacturer au fournisseur (Float)

correspondances pour equipmentType

IDNameDurée minimumDurée maximum
1Manutention et levage2472
2Matériel de BTP2460
3Nettoyage et gestion déchets2460
4Matériel médical2460
5Bureautique, informatique2460
6Autres équipements et outillages2472
7Logiciels1236
8Environnement de travail1248
9Véhicules2472
Retour Un objet JSON qui contient les informations ou erreurs associés

Exemple de réponse JSON 

{
    "created_at": "2018-09-05T15:24:48+0200",
    "siren_client": "542051180",
    "siren_supplier": "824608475",
    "equipment_type": {
        "name": "Manutention et levage"
    },
    "condition": "Neuf",
    "duration": 36,
    "amount": 935.5,
    "intangible": 0,
    "rebillable": 200,
    "score": 5.5,
    "period": {
        "id": 1,
        "name": "Mensuelle"
    },
    "quantity": 1,
    "rent": 39,
    "rents": [
        {
            "duration": 24,
            "rent": 52,
            "url": "https://test.novalend.com/quotation/createQuotation/5295?duration=24"
        },
        {
            "duration": 30,
            "rent": 44,
            "url": "https://test.novalend.com/quotation/createQuotation/5295?duration=30"
        },
        {
            "duration": 36,
            "rent": 39,
            "url": "https://test.novalend.com/quotation/createQuotation/5295?duration=36"
        },
        {
            "duration": 42,
            "rent": 35,
            "url": "https://test.novalend.com/quotation/createQuotation/5295?duration=42"
        },
        {
            "duration": 48,
            "rent": 33,
            "url": "https://test.novalend.com/quotation/createQuotation/5295?duration=48"
        }
    ],
    "application_fee": 50,
    "messages": ""
}

1. Code PHP pour tester l'égibilité d'une société via son SIREN

  $token="votre_token_ici";
  $sirenDeVotreClient="824236988"; // code SIREN de Novalend pour l'exemple

  $json='{"sirenClient":"'.$sirenDeVotreClient.'"}';

  $crl = curl_init("https://test.novalend.com/api/eligibilities");
  $headr = array();
  $headr[] = 'Accept: application/json';
  $headr[] = 'Content-type: application/json';
  $headr[] = 'Authorization: Basic '.$token;
  curl_setopt($crl, CURLOPT_HTTPHEADER,$headr);
  curl_setopt($crl, CURLOPT_POST,true);
  curl_setopt($crl, CURLOPT_RETURNTRANSFER,true);
  curl_setopt($crl, CURLOPT_POSTFIELDS, $json);
  $curl_response = curl_exec($crl);
  curl_close($crl);
  $response=json_decode($curl_response,true);

  if ($response["code"]==400)
  {
    echo "Cette valeur n'est pas un code SIREN valide.";
    exit();
  }

  if ($response["isEligible"])
    echo "La société ".$response["name"]." est éligible au leasing.";
  else
    echo "Le résultat de l'analyse financière de la société ".$response["name"]." ne nous permet pas de formuler une offre en ligne.";

2. Code PHP pour obtenir une quotation pour le leasing d'un produit

  $token="votre_token_ici";
  $sirenDeVotreClient="542051180";  // Code SIREN de TOTAL SA pour l'exemple
  $sirenSupplier="824236988" // Mettre votre SIREN. Ici code SIREN de Novalend pour l'exemple

  $json='{
    "sirenClient":"'.$sirenDeVotreClient.'",
    "sirenSupplier":"'.$sirenSupplier.'",
    "equipmentType":1,
    "duration":48,
    "period":1,
    "amount":15000,
    "condition":"Neuf",
    "intangible":0,
    "rebillable":200
  }';

  $crl = curl_init("https://test.novalend.com/api/quotations");
  $headr = array();
  $headr[] = 'Accept: application/json';
  $headr[] = 'Content-type: application/json';
  $headr[] = 'Authorization: Basic '.$token;
  curl_setopt($crl, CURLOPT_HTTPHEADER,$headr);
  curl_setopt($crl, CURLOPT_POST,true);
  curl_setopt($crl, CURLOPT_RETURNTRANSFER,true);
  curl_setopt($crl, CURLOPT_POSTFIELDS, $json);
  $curl_response = curl_exec($crl);
  curl_close($crl);
  $response=json_decode($curl_response,true);

  if ($response["code"]==400)
  {
    echo "Bad request, in the response, you will see which field is missing or invalid.";
    exit();
  }
  if ($response["rent"])
    echo "Le loyer est de  ".$response["rent"]."€";

Détails de la tarification

L'utilisation de l'API est gratuite* les 3 premiers mois suivants votre inscription, puis est facturée 5 euros HT par requête.

* dans la limite de 200 requêtes sur la période.


Assistance et contrat SLA

Nous offrons un support technique pour la mise en place de l'API.

Contrat SLA : nous garantissons le fait que les instances du service Gestion des API exécutées au niveau standard répondront aux demandes d’opérations au moins 99,9 % du temps.