Entreprise Marketing - Italie

Le service Entreprise Marketing appartient à API Company et est conçu pour toutes les entreprises souhaitant accéder à des données certifiées et détaillées pour les activités de communication, d'analyse et de marketing.

Avec le seul numéro de TVA, le service Entreprise Marketing permet d'obtenir en quelques minutes plus de 300 informations enrichies sur les caractéristiques et les classifications de l'entreprise ainsi que sur les données de contact.

Il est possible d'obtenir des informations telles que :

L'endpoint de référence est https://company.openapi.com/IT-marketing/{vatCode_or_taxCode}

Le service Entreprise Marketing est actuellement disponible en mode synchrone et asynchrone.

En période de forte affluence, les sources de données officielles peuvent subir des ralentissements dans les temps de réponse, donc si ce n'est pas nécessaire, nous suggérons de mettre en œuvre la méthode POST. Cette méthode permet de définir une URL de rappel, éliminant ainsi la nécessité de vérifier l'état et permettant à notre système d'envoyer une notification proactivement dès que la demande est terminée.

EXEMPLE DE DEMANDE

POST/IT-marketing

Ceci est un exemple de demande où le paramètre numéro de TVA a été utilisé : 12485671007

https://company.openapi.com/IT-marketing/12485671007

Comme indiqué précédemment, en utilisant la méthode POST et donc le service asynchrone, il est également possible de définir un rappel via le payload :

{
  "callback": {
    "url": "https://your_domain.it/your_callback.php",
    "method": "JSON",
    "headers": {
      "session_id": "oiwejdf89453urf945jfg"
    }
  }

EXEMPLE DE RÉPONSE

POST/IT-marketing

La réponse inclura l'id de la demande et l'état

{
  "callback": {
  "data": {
    "state": "PENDING",
    "id": "66a8ed9b82cf2ae627012068"
  },
  "success": true,
  "message": "",
  "error": null
}

VÉRIFICATION DE L'ÉTAT DE LA DEMANDE

Il est possible de vérifier l'état de la demande à tout moment via l'endpoint /IT-check_id/{id}. En cas de définition du rappel, le système notifiera directement lorsque la réponse sera disponible.

EXEMPLE DE DEMANDE

GET /IT-check_id/{id}

https://company.openapi.com/IT-check_id/66a8ed9b82cf2ae627012068

EXEMPLE DE RÉPONSE

GET /IT-check_id/{id}

Dans le cas où l'état de la demande est terminé, c'est-à-dire en done, la réponse inclura toutes les données :

Ceci est un exemple de réponse pour le paramètre numéro de TVA : 12485671007

{
    "data": {
    "pec": "OPENAPI@LEGALMAIL.IT",
    "companyDetails": {
      "vatCode": "12485671007",
      "taxCode": "12485671007",
      "lastUpdateDate": "2023-03-08T11:25:08.0331456Z",
      "cciaa": "RM",
      "reaCode": "1378273",
      "companyName": "OPENAPI SPA",
      "officeType": {
        "code": "SSL",
        "description": "Siège administratif et siège social"
      },
      "openapiNumber": "IT93E20F0DS0001"
    },
    "companyStatus": {
      "activityStatus": {
        "code": "A",
        "description": "Activé"
      }
    },
    "address": {
      "streetName": "VIALE FILIPPO TOMMASO MARINETTI, 221",
      "zipCode": "00143",
      "city": "ROMA",
      "province": "RM",
      "country": "IT"
    },
    "classification": {
      "atecoPrimary": "7022",
      "atecoSecondary": "7022",
      "nace": "7022",
      "sic": "7022",
      "atecoDescription": "Conseil pour les affaires et la gestion",
      "naceDescription": "Conseil pour les affaires et la gestion",
      "sicDescription": "Conseil pour les affaires et la gestion"
    },
    "company": {
      "revenue": {
        "value": "1000000",
        "change": "0",
        "forecast": "0"
      },
      "employees": {
        "number": "50",
        "change": "0",
        "forecast": "0"
      },
      "capital": {
        "amount": "150000",
        "forecast": "0"
      }
    }
  },
  "success": true,
  "message": "Votre demande a été traitée avec succès",
  "error": null
}

En cas de non-acceptation de la demande ou de problème pendant le traitement, l'état sera en error et la réponse comprendra le code d'erreur et le message d'erreur :

{
  "data": {
    "state": "ERROR",
    "id": "66a8ed9b82cf2ae627012068"
  },
  "success": false,
  "message": "La demande n'a pas pu être traitée",
  "error": {
    "code": "01",
    "description": "Les données du client ne sont pas disponibles."
  }
}

Comme indiqué, le service Entreprise Marketing est également disponible en mode synchrone. L'endpoint à utiliser est /IT-marketing/{vatCode_or_taxCode}, mais dans ce cas, la méthode sera GET. La réponse sera généralement restituée en quelques secondes.

En période de fort trafic, les sources de données officielles peuvent connaître des ralentissements dans les temps de réponse. Pendant ces pics de charge ou périodes de maintenance, nous avons prévu un délai d'attente de 30 secondes pour les requêtes synchrones. Après ce délai, un identifiant unique est généré, permettant aux clients de demander des mises à jour sur l'état et d'obtenir la réponse lorsqu'elle sera disponible via l'endpoint dédié GET company.openapi.com/IT-check_id

Entreprise Marketing est utilisé par les entreprises souhaitant élargir leur portefeuille clients. Quelques exemples de types d'entreprises qui utilisent déjà le service marketing sont les Banques, Assurances, Télécoms, Voyages, IT, ONG, Immobilier.

Certaines données peuvent ne pas être disponibles pour toutes les entreprises.