API & intégrations

API et intégrations.

Explorez les connecteurs et les interfaces pour faire circuler vos données. Retrouvez les exemples et les repères nécessaires à votre intégration.

Sur cette page

Vos connexions.

Les connexions utiles à votre activité.

PrestaShop

E-commerce

Intégration native. Les données échangées, catalogue, commandes ou clients, sont convenues pendant le cadrage du projet.

Natif · selon le cadrage

WooCommerce

E-commerce

Intégration native. Les données échangées avec votre boutique WordPress sont convenues pendant le cadrage du projet.

Natif · selon le cadrage

Shopify

E-commerce

Reprise du catalogue à partir de l’export CSV des produits : simulation, import, redirections et annulation d’un clic. Aucune synchronisation n’est promise.

Import du catalogue

Stripe

Paiements

Paiements Stripe et prélèvements SEPA intégrés. Pour la boutique en ligne, le paiement par carte fonctionne aujourd’hui en mode test.

Paiements et SEPA

Google et Meta

Canaux de vente

Un flux pour Google Merchant Center et un catalogue pour Facebook et Instagram, à une adresse privée que vous collez dans ces services.

Flux produits

Mondial Relay

Livraison

Le client choisit son point relais par code postal au moment de commander. Les étiquettes d’expédition ne sont pas encore créées par Inklura.

Points relais

Plateformes agréées

Facture électronique

Vos factures en Factur-X, UBL ou CII, à télécharger puis déposer sur la plateforme agréée de votre choix. L’envoi automatique n’existe pas encore.

Export de fichiers

WordPress

CMS

Le plugin Company Manager relie votre site WordPress à Inklura : formulaires, devis et contacts.

Plugin officiel

Votre outil

Sur-mesure

ERP, comptabilité, logistique : l’API REST commerce donne accès aux produits, variantes, stocks, commandes et clients, avec des clés à permissions limitées.

API REST

Correspondance des champs

Pendant le cadrage, nous établissons la correspondance entre les champs de vos outils et le modèle Inklura, et le sens dans lequel circule chaque donnée.

  • emailcontact.email
  • skuproduit.reference
  • order.totalfacture.montant
  • statuscommande.statut

Webhooks

Les webhooks se déclarent depuis votre espace. Leur livraison vers votre serveur et le renvoi en cas d’échec sont à valider avec notre équipe avant d’en dépendre.

facture.payeecommande.creeepaiement.echouestock.basclient.creeabonnement.annule

Les exemples de code de cette page appellent l’API REST commerce. Aucun SDK officiel n’est publié : générez un client à partir du schéma OpenAPI.

Votre premier appel.

Du compte au premier appel, en quatre étapes.

01

Ouvrez votre espace

Dans Inklura, ouvrez Développeurs, puis Clés d’API.

02

Générez une clé

Choisissez ses permissions, par exemple products:read ou inventory:write.

03

Lisez le schéma

manage.inklura.fr/api/v1/commerce/openapi.json

04

Premier appel

Listez les produits de votre boutique en un appel.

Copier
const API = 'https://manage.inklura.fr/api/v1/commerce';

// Lister les produits de la boutique
const res = await fetch(API + '/products?limit=10', {
  headers: { Authorization: 'Bearer ' + process.env.INKLURA_API_KEY },
});

console.log(await res.json());
import os, requests

API = 'https://manage.inklura.fr/api/v1/commerce'
headers = {'Authorization': 'Bearer ' + os.environ['INKLURA_API_KEY']}

# Lire le stock
r = requests.get(API + '/inventory', headers=headers, params={'limit': 10})
print(r.json())
curl 'https://manage.inklura.fr/api/v1/commerce/products?limit=10' \
  -H "Authorization: Bearer $INKLURA_API_KEY"

Vos repères.

Les repères pour construire votre intégration.

API REST commerce

Produits, variantes, stocks, commandes et clients, documentés en OpenAPI 3.1 à l’adresse /api/v1/commerce/openapi.json.

Versionnement /v1Produits et variantesStocks et commandesClients

Authentification sécurisée

Des clés d’API limitées à ce que vous autorisez, par exemple la lecture des produits ou l’écriture du stock, révocables à tout moment.

Clés d’APIPermissions par usageRévocation immédiateHistorique des stocks

Clients typés

Générez un client typé dans votre langage à partir du schéma OpenAPI de l’API commerce.

TypeScriptPythonPHPAutres langages

Webhooks

Des événements sur les commandes et les stocks. Leur mise en service se valide avec notre équipe avant de vous y fier.

CommandesStocksÀ valider avec nous

Les interfaces.

Retrouvez les interfaces par métier.

Les domaines et chemins ci-dessous servent à cadrer votre projet. Le contrat technique, les droits d’accès et les interfaces disponibles sont à confirmer avec notre équipe. Demandez la documentation correspondant à votre intégration.

En pratique.

Les ressources pour passer à la pratique.

Documentation

Référence Swagger UI interactive : chaque endpoint, ses paramètres et ses réponses.

Ouvrir Swagger

Postman ou Insomnia

Importez le schéma OpenAPI de l’API commerce dans votre outil de test.

Voir le schéma

Clients typés

Générez un client typé pour votre langage à partir du schéma OpenAPI, avec le générateur de votre choix.

Voir le schéma

Parlons intégration.

Besoin d’aide pour votre intégration ?

Notre équipe technique vous accompagne, de la première clé d’API à la mise en production.