API partenaires Ematea

POST/dossiers.php droit dossiers

Crée un brouillon pour le cabinet de la clé. La paire clé API + external_reference rend l’opération idempotente : une nouvelle tentative retourne le même dossier.

POST https://ematea.fr/extranet/api/v1/dossiers.php
Authorization: Bearer emt_live_votre_cle
Content-Type: application/json

{
  "external_reference": "courtigo-quote-4182",
  "formData": {
    "projectType": "residence_principale", "loanType": "change", "bankId": "credit-agricole", "date_effet": "2026-10-01",
    "borrowers": [{
      "id": 1, "gender": "F", "firstName": "Jeanne", "lastName": "Martin", "birthDate": "1985-05-10", "postCode": "75001", "job": 1,
      "email": "jeanne.martin@example.fr", "phone": "0600000000", "smoker": false, "travelKm": "lt15", "heights": false, "manual": false, "sport": false, "riskyJob": false, "isPPE": false,
      "guarantees": [{"loan_id":1,"quotite":100,"type":"dc_ptia_itt_ipt","ipp":true,"mno":true,"franchise":90}]
    }],
    "loans": [{"id":1,"type":"amortissable","amount":250000,"duration":240,"rate":3.45,"deferred":0}]
  }
}

Réponse 201 (ou 200 si la référence existe déjà) :

{
  "ok": true,
  "data": {"dossier_id": 123, "created": true, "external_reference": "courtigo-quote-4182"}
}

GET/dossiers.php?id=123 droit dossiers

Lit uniquement un dossier du cabinet de la clé.

{
  "ok": true,
  "data": {
    "id": 123, "status": "simulation", "montant_total": "250000.00",
    "banque_nom": "credit-agricole", "nb_assures": 1, "date_effet": "2026-10-01",
    "nom_produit_final": null, "last_step": 1,
    "created_at": "2026-09-23 10:15:00", "updated_at": "2026-09-23 10:15:00"
  }
}

Contrat formData complet

Pour une tarification partenaire, le profil est volontairement strict : Ematea refuse les valeurs par défaut silencieuses. Envoyez le même payload que le comparateur.

travelKm vaut lt15, 15_20, 20_25 ou gt25. Chaque fournisseur applique ensuite son propre seuil de déclaration.

PATCH/dossiers.php droit dossiers

Deux actions complètent le parcours sans modifier le profil :

{
  "action": "select_offer",
  "dossier_id": 123,
  "selected_offer": {"source_api":"simulassur","nom_produit":"Generali 7305","porteur_risque":"Generali","mensualite":32.4,"cout_total":7776}
}

{
  "action": "attach_documents",
  "dossier_id": 123,
  "batch_token": "jeton_retourne_par_l_ocr"
}

La première enregistre l’offre retenue. La seconde rattache les documents OCR du lot au dossier et au premier assuré.

POST/tarification.php droit tarifs

Le body est le formData des dossiers, directement ou enveloppé dans {"formData": {...}}. Ajoutez dossier_id pour rattacher et sauvegarder les offres. Les alias durationMonths et deferredMonths sont pris en charge.

{
  "dossier_id": 123,
  "projectType": "residence_principale",
  "loanType": "change",
  "bankId": "credit-agricole",
  "date_effet": "2026-10-01",
  "borrowers": [{"gender":"F","firstName":"Jeanne","lastName":"Martin","birthDate":"1985-05-10","postCode":"75001","job":1,"email":"jeanne.martin@example.fr","smoker":false,"travelKm":"lt15","heights":false,"manual":false,"sport":false,"riskyJob":false,"isPPE":false,"guarantees":[{"loan_id":1,"quotite":100,"type":"dc_ptia_itt_ipt","ipp":true,"mno":true,"franchise":90}]}],
  "loans": [{"id":1,"amount":250000,"duration":240,"type":"amortissable","rate":3.45,"deferred":0}]
}

La réponse est un flux Content-Type: text/event-stream. Chaque message utilise ce format :

event: tarif
data: {"type":"tarif","data":{...}}

POST/ocr.php droit ocr

Envoyez un multipart/form-data, pas du JSON. Taille maximale : 12 Mo. Formats : PDF, JPG, PNG.

curl -X POST "https://ematea.fr/extranet/api/v1/ocr.php" \
  -H "Authorization: Bearer emt_live_votre_cle" \
  -F "document=@offre.pdf" \
  -F "type_document=offre_pret"

Réponse :

{
  "status": "success", "document_id": 456,
  "upload_token": "token_de_lot", "batch_token": "token_de_lot",
  "data": {"...": "donnees extraites"},
  "completeness": {"...": "champs presents"},
  "quality": {"...": "indicateurs de qualite"},
  "_debug": {"...": "informations techniques optionnelles"}
}

data varie selon le document. Traitez les valeurs comme des propositions OCR à confirmer avant tarification.

POST/sso.php droit sso

Crée une URL à usage unique qui connecte le compte courtier choisi et ouvre le dossier. Le compte doit appartenir au même cabinet et être actif. courtier_user_id est facultatif seulement si un compte de reprise par défaut est configuré sur la clé.

{"dossier_id":123,"courtier_user_id":45}

{
  "ok": true,
  "data": {"dossier_id": 123, "expires_in": 300, "launch_url": "https://.../extranet/sso.php?token=..."}
}

Les erreurs JSON suivent ce format :

{"ok":false,"error":{"code":"invalid_request","message":"..."}}

Conservez l’en-tête X-Request-Id retourné sur les endpoints JSON et communiquez-le au support Ematea. N’envoyez jamais de clé API ni de document dans un ticket.