Contact Connexion Oxiva

API Oxiva CRM

API Oxiva : connectez votre CRM à tout votre écosystème applicatif

Oxiva dispose de sa propre API REST (JSON), documentée et en évolution continue, pour connecter votre CRM à vos outils de facturation, votre site web, votre ERP tiers, votre BI ou toute application métier.

Cette page s’adresse aux intégrateurs, éditeurs partenaires et directions techniques qui évaluent la capacité d’Oxiva à s’interfacer avec un système d’information existant.

Une API REST pensée pour vos intégrations

L’API Oxiva permet à une application tierce d’accéder aux données de votre dossier Oxiva : sociétés, adresses, contacts, opportunités, contrats et tickets. Elle repose sur les standards REST et le format d’échange JSON, ce qui la rend compatible avec la quasi-totalité des outils métier, ERP, sites web et plateformes de facturation du marché.

Elle est documentée dans un dossier technique dédié (endpoints, paramètres, exemples de requêtes et de réponses, codes d’erreur), mis à jour au fil des versions du produit, et accessible depuis la console d’administration de votre dossier.

Demander de l’info Demander une démo

Pourquoi connecter votre CRM à une API

Beaucoup d’entreprises qui recherchent un CRM ont déjà un système d’information en place : un site e-commerce, un outil de facturation, une plateforme métier spécifique, un ERP, un outil de Business Intelligence, parfois un objet connecté ou une application développée en interne. La question n’est alors plus seulement « ce CRM couvre-t-il mes besoins ? » mais « ce CRM peut-il dialoguer avec le reste de mon système d’information ? ».

L’API Oxiva répond directement à cette question : elle expose les données du dossier (sociétés, contacts, adresses, opportunités, contrats, tickets) et permet à une application tierce de les lire, de les créer ou de les mettre à jour, sans ressaisie manuelle et sans export/import de fichiers.

  • Intégrateurs et éditeurs de logiciels qui souhaitent connecter leur solution à Oxiva pour un client commun.
  • Directions techniques et DSI qui évaluent la capacité d’un CRM à s’interfacer avec un ERP, un outil de facturation ou un entrepôt de données existant.
  • Équipes internes qui veulent automatiser une synchronisation entre Oxiva et un site web, un outil marketing ou une application métier maison.

Activation et authentification

L’API est un module activable depuis l’administration d’Oxiva (onglet Modules), au même titre que le module Marketing ou le module Base de connaissance. Son activation nécessite les droits d’administration du dossier et constitue une option payante : le tarif dépend de votre contrat et se confirme auprès de votre distributeur. (Source : documentation technique Oxiva – API v3.0, juin 2026)

Une fois le module activé, un token (clé d’accès) est généré pour le dossier. Ce token doit être transmis à chaque appel de l’API et peut être régénéré à tout moment depuis la console d’administration ; pensez alors à le mettre à jour dans votre application tierce. Il est également possible de suspendre l’utilisation de l’API à tout instant : les appels retournent alors une erreur 405 - API suspendue.

Pour utiliser l’API Oxiva, votre équipe technique doit maîtriser les concepts d’API REST et le format de données JSON. La racine d’adresse à utiliser pour les appels (propre à chaque dossier) est indiquée directement dans la console d’administration du module.

Les endpoints disponibles (API v3.0)

Chaque réponse est renvoyée au format JSON avec un code de statut explicite (succès ou erreur détaillée). Le détail des paramètres, des exemples de requêtes cURL et des codes d’erreur figure dans le dossier technique remis à chaque dossier client.

Version — GET

Renvoie la version courante de l’API (version) et sa sous-version (sversion). Utile pour vérifier la compatibilité de votre intégration avant chaque mise à jour.

Statut — GET

Vérifie la validité du dossier et du token transmis. Renvoie un statut 200 si l’authentification est correcte, ou une erreur explicite (token invalide, dossier introuvable) dans le cas contraire.

Société — GET / POST

L’endpoint le plus complet : lecture d’une société identifiée par son identifiant, son numéro de compte, son nom abrégé ou son nom complet, avec en option ses adresses, contacts, activités, opportunités, contrats et tickets. En écriture (POST), il permet de créer une société avec son adresse et son contact principal (add_soc), de la mettre à jour (update_soc), et de gérer ses adresses (add_adr, update_adr) et ses contacts (add_cont, update_cont).

Nouveau — GET

Renvoie la liste des sociétés, adresses et contacts créés depuis une date/heure donnée. Conçu pour les synchronisations incrémentales : votre application interroge régulièrement cet endpoint pour ne récupérer que ce qui est réellement nouveau.

Modification — GET

Même logique que l’endpoint Nouveau, appliquée aux éléments modifiés depuis une date/heure donnée. Permet de maintenir un système tiers à jour sans devoir relire l’intégralité du dossier à chaque synchronisation.

Webhooks

En complément des appels sortants, la console du module API permet de déclarer une adresse de webhook pour les événements de création et une adresse pour les événements de modification. Oxiva notifie alors automatiquement votre application, avec la table et l’identifiant concernés.

Un exemple d’appel

Récupérer une société avec ses adresses et ses contacts, en une seule requête :

curl -X GET "https://[votre-dossier].oxiva.cloud/api/oxiva/v3.0/societe/?dossier=[dossier]&token=[votreToken]&id=123&adr=Y&cont=Y"

Réponse :

{
  "statut": 200,
  "societe": { "csoc_id": "123", "csoc_nom": "Nom de la société", "csoc_uid": "UID123" },
  "adr": [ { "cadr_id": "456", "cadr_rue": "1 Rue de l'Exemple" } ],
  "cont": [ { "ccont_id": "789", "ccont_nom": "Dupont" } ]
}

(Source : documentation technique Oxiva – API v3.0, juin 2026, exemple simplifié.)

Une API en constante évolution

La version documentée sur cette page est l’API Oxiva v3.0 (dossier technique de juin 2026). Elle s’inscrit dans une dynamique plus large : chaque nouvelle version d’Oxiva CRM fait évoluer les capacités d’intégration du produit, pas seulement l’API en tant que telle.

La version 7.2 d’Oxiva CRM a par exemple renforcé la réception des emails par webhooks dans l’intégration Microsoft 365 / Oximail, et fiabilisé la synchronisation du connecteur Sage 100 (rapprochement automatique des sociétés par SIRET, exclusion des sociétés en sommeil). Ce sont des évolutions distinctes de l’endpoint API documenté ici, mais elles illustrent la même logique : Oxiva investit en continu dans ses capacités de connexion avec le reste de votre système d’information. (Voir le détail sur la page des nouveautés Oxiva CRM)

Avant toute intégration en production, vérifiez la version en cours via l’endpoint Version et consultez le dossier technique remis avec votre dossier : c’est la référence à jour, plus fiable qu’une capture figée dans un support marketing.

Exemples d’usages possibles API Oxiva

Facturation et gestion commerciale

Faire remonter automatiquement les sociétés et contacts créés dans Oxiva vers votre outil de facturation ou votre ERP, ou inversement, sans ressaisie.

Site web et formulaires

Créer automatiquement une fiche société et son contact dans Oxiva dès la soumission d’un formulaire sur votre site, via l’action add_soc.

Business Intelligence

Interroger régulièrement les endpoints Nouveau et Modification pour alimenter un entrepôt de données ou un tableau de bord externe, sans recharger l’intégralité du dossier à chaque fois.

Applications métier internes

Connecter une application développée en interne (terrain, atelier, supervision) aux données clients et contrats déjà présentes dans Oxiva.

Notifications en temps réel

Déclencher une action dans un outil tiers dès qu’une société est créée ou modifiée dans Oxiva, grâce aux webhooks, sans avoir à interroger l’API en continu.

Développements sur mesure

Pour un besoin non couvert par les endpoints standards, votre intégrateur ou notre équipe technique peut étudier une évolution : la documentation évolue avec chaque version majeure.

Sur des sujets proches

Connecteur Sage 100

L’intégration native et bidirectionnelle entre Oxiva et Sage 100 Gestion commerciale, développée par le même éditeur que le CRM.

Découvrir le connecteur Sage 100 →

CRM souverain

Hébergement, droit applicable et politique de sécurité : les éléments à connaître avant de connecter un CRM à votre système d’information.

Voir la page CRM souverain →

CRM multi-bases Sage 100

Comment Oxiva consolide les données de plusieurs dossiers Sage 100 dans un seul CRM, un cas d’usage fréquent chez les groupes multi-sites.

En savoir plus →

Service client Oxiva

Tickets, contrats, SLA et parc installé : le module dont les données sont également accessibles via les endpoints Société de l’API.

Découvrir le module Service Client →

Nouveautés Oxiva CRM

Le détail des évolutions produit, version après version, y compris les évolutions d’intégration (Microsoft 365, connecteur Sage 100).

Voir les nouveautés →

Formations Oxiva CRM

Accompagner vos équipes techniques et fonctionnelles dans la prise en main d’Oxiva, y compris ses briques d’intégration.

Voir les formations →

Questions fréquentes API Oxiva

Qu’est-ce que l’API Oxiva ?

C’est une API REST au format JSON qui permet à une application tierce d’accéder aux données de votre dossier Oxiva (sociétés, adresses, contacts, opportunités, contrats, tickets), en lecture et en écriture. Elle est documentée dans un dossier technique dédié (version 3.0, juin 2026).

L’API Oxiva est-elle payante ?

Oui. C’est un module activable depuis l’administration du dossier, au même titre que les autres modules Oxiva (Marketing, Base de connaissance, etc.). Son activation modifie le montant de l’abonnement ; le tarif exact se confirme auprès de votre distributeur.

Comment s’authentifie-t-on auprès de l’API ?

Chaque dossier dispose d’un token (clé d’accès) généré depuis la console d’administration, à transmettre à chaque appel avec l’identifiant du dossier. Le token peut être régénéré à tout moment, et l’utilisation de l’API peut être suspendue temporairement si besoin.

Quelles données sont accessibles via l’API ?

Les endpoints documentés couvrent les sociétés, leurs adresses, leurs contacts, leurs activités, leurs opportunités, leurs contrats et leurs tickets, en lecture comme en création/mise à jour pour les sociétés, adresses et contacts.

L’API permet-elle de créer et modifier des données, ou seulement de les lire ?

Les deux. L’endpoint Société accepte les méthodes GET (lecture) et POST (création via add_soc, mise à jour via update_soc, et les actions équivalentes pour les adresses et les contacts).

Comment synchroniser Oxiva avec un système tiers sans tout relire à chaque fois ?

Les endpoints Nouveau et Modification sont conçus pour cela : ils renvoient uniquement les éléments créés ou modifiés depuis une date/heure donnée, ce qui évite de recharger l’intégralité du dossier à chaque synchronisation.

Qu’apportent les webhooks par rapport aux endpoints Nouveau et Modification ?

Les webhooks évitent d’interroger l’API à intervalles réguliers : Oxiva notifie directement votre application dès qu’une création ou une modification a lieu, avec la table et l’identifiant concernés. Les deux mécanismes peuvent être combinés selon vos besoins.

L’API évolue-t-elle avec les nouvelles versions d’Oxiva ?

Oui. La documentation technique est mise à jour au fil des versions du produit. Nous recommandons de vérifier la version en cours via l’endpoint Version avant toute mise à jour d’une intégration en production, et de consulter le dossier technique remis avec votre dossier pour le détail le plus à jour.

Qui peut m’aider à développer une intégration avec l’API Oxiva ?

Notre réseau de partenaires intégrateurs et notre équipe technique peuvent accompagner un projet d’intégration, du cadrage initial au développement. Trouver un partenaire Oxiva ou contactez-nous directement.

Sources et mentions API Oxiva

Cette page API Oxiva a été rédigée le 8 septembre 2026. Les éléments techniques (endpoints, paramètres, formats de requête et de réponse, codes d’erreur, modalités d’activation et d’authentification) sont tirés du dossier interne « Oxiva – API v3.0 – Documentation », daté de juin 2026, remis par Viktory Software aux dossiers clients disposant du module API.

Les exemples de requêtes et de réponses présentés sur cette page sont simplifiés à des fins pédagogiques. Pour une intégration en production, référez-vous au dossier technique complet remis avec votre dossier, qui détaille l’ensemble des champs, des paramètres et des codes d’erreur.

Prêt à connecter Oxiva à votre système d’information ?

Que vous soyez intégrateur, éditeur partenaire ou direction technique, nous pouvons vous transmettre le dossier technique complet de l’API Oxiva et échanger sur votre projet d’intégration.

Demander de l’info Demander une démo Trouver un partenaire