Codes d'erreur

Référence des codes HTTP et codes d'erreur métier retournés par l'API Aprovall.

Codes HTTP

L'API utilise les codes HTTP standards pour indiquer le succès ou l'échec d'une requête.

Code	Statut	Description
`200`	OK	Requête réussie
`400`	Bad Request	Paramètre manquant ou invalide (détail dans la réponse)
`401`	Unauthorized	Token d'authentification invalide ou expiré
`403`	Forbidden	Accès interdit à cette ressource
`404`	Not Found	Ressource introuvable
`500`	Server Error	Erreur serveur, réessayez ultérieurement

En cas d'erreur 400 ou 500, la réponse contient un code d'erreur métier précisant la cause.

Code	Description
`E001`	Paramètre manquant
`E002`	Paramètre inconnu
`E003`	Paramètre vide
`E010`	Format incorrect
`E011`	Taille maximale dépassée
`E021`	Date d'expiration dans le passé
`E022`	Date dans le futur
`E030`	Domaine email invalide

Code	Description
`E100`	Aucune entreprise correspondant à la recherche
`E101`	Erreur lors de la qualification de l'entreprise
`E102`	L'entreprise n'existe pas
`E103`	L'entreprise est fermée
`E104`	Trop d'entreprises pour ces critères
`E105`	L'identifiant de l'entreprise a changé
`E111`	Le code tiers (supplierCode) diffère de l'existant
`E112`	Le code tiers est déjà utilisé par un autre tiers
`E113`	Compte du tiers désactivé
`E122`	Import international impossible (option non activée)

Code	Description
`E200`	Aucun dossier correspondant à la recherche
`E201`	Dossier désactivé
`E202`	Cette référence existe déjà pour ce tiers
`E203`	Aucun dossier avec cette référence
`E204`	Dossier déjà actif
`E205`	Réactivation avec une date passée (modifier la date)
`E206`	Type de dossier introuvable
`E207`	Modification des documents interdite sur un dossier typé

Code	Description
`E301`	Document requis désactivé
`E302`	Document requis non autorisé
`E303`	Document désactivé depuis le type de dossier
`E304`	Document non autorisé depuis le type de dossier

Code	Description
`E401`	Non autorisé à interroger votre compte D&B
`E402`	Limite de requêtes D&B atteinte

Code	Description
`E1000`	Erreur lors du chiffrement de l'identifiant
`E1001`	Erreur lors du déchiffrement de l'identifiant
`E1002`	SIREN/SIRET requiert countryCode = FR
`E1005`	Valeur invalide
`E1006`	Service temporairement indisponible

En cas d'erreur, l'API retourne un objet JSON avec le code et le message :

{
  "error": {
    "code": "E201",
    "message": "Dossier disabled"
  }
}