API des bons de commande

🚀 Pourquoi utiliser l’API des bons de commande?

Les bons de commande sont des éléments essentiels de la gestion des stocks et de la logistique dans DataDocks. Ils représentent des ententes concernant la livraison de produits vers vos entrepôts (entrants) ou leur expédition depuis ces derniers (sortants). L’API des bons de commande vous permet de créer, suivre et gérer ces documents critiques de façon programmatique, en reliant directement vos systèmes de chaîne d'approvisionnement à vos opérations d’entrepôt.

Problèmes réels résolus par cette API

Rationalise le traitement des commandes : créez et mettez à jour automatiquement les bons de commande à partir de votre système ERP ou de gestion de commandes
Améliore la visibilité des stocks : suivez les arrivées et départs attendus avec des informations détaillées sur les produits
Simplifie la gestion des transporteurs : associez des transporteurs aux bons de commande pour faciliter la logistique
Optimise la planification : définissez les échéanciers attendus pour mieux gérer les ressources de l'entrepôt
Active l’analyse avancée : accédez à des données structurées sur les bons de commande pour les rapports et analyses

Démarrage rapide en 5 minutes

Prêt à créer votre premier bon de commande via l’API? Suivez ces étapes simples :

Obtenez votre jeton API auprès du support
Identifiez le sous-domaine de votre emplacement (exemple : votre-entrepot.datadocks.com)
Créez un bon de commande de base avec la commande suivante :

Voir l’exemple cURL

curl -X POST \
  https://your-warehouse.datadocks.com/api/v1/purchase_orders \
  -H 'Authorization: Token YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "purchase_order": {
      "po_number": "PO-2023-001",
      "carrier_name": "Express Logistics",
      "outbound": false,
      "expected_starts_at": "2023-06-01T08:00:00-04:00",
      "expected_ends_at": "2023-06-01T16:00:00-04:00",
      "purchase_order_items": [
        {
          "product_name": "Widgets",
          "unit_name": "Pallet",
          "quantity": 10,
          "weight": 500
        }
      ]
    }
  }'

C’est terminé ! Votre bon de commande est maintenant dans DataDocks. Vérifiez votre tableau de bord pour le voir.

Aperçu de l’architecture de l’API

┌─────────────────┐       ┌─────────────────┐       ┌─────────────────┐
│  Votre système  │──────▶│  API DataDocks  │──────▶│  Opérations     │
│ (ERP/OMS/TMS)   │◀──────┤   (REST/JSON)   │◀──────┤ Entrepôt (BC/PI)│
└─────────────────┘       └─────────────────┘       └─────────────────┘
                                    │  ▲
                                    │  │
                                    ▼  │
                             ┌─────────────────┐
                             │ Rendez-vous     │
                             │ et horaires     │
                             │                 │
                             └─────────────────┘

Authentification

Toutes les requêtes API doivent inclure votre jeton API dans l’en-tête Authorization :

Authorization: Token YOUR_API_TOKEN

Lister les bons de commande

Objectif

Récupérez une liste paginée de bons de commande avec possibilité de filtrage par numéro de BC. Utilisez ce point de terminaison pour synchroniser les bons de commande avec vos systèmes, vérifier le statut des livraisons attendues ou préparer des rapports sur l’activité de l’entrepôt.

Cas d’usage métier

Synchroniser les bons de commande avec votre ERP ou système de gestion des commandes
Générer des rapports sur les mouvements de stocks attendus
Surveiller les livraisons ou expéditions à venir
Suivre la performance des transporteurs à travers les bons de commande

Requête HTTP

GET https://[location_subdomain].datadocks.com/api/v1/purchase_orders

Paramètres de requête

Paramètre	Type	Obligatoire	Description	Exemple
`page`	Integer	Non	Numéro de page (pagination, valeur par défaut 1)	`page=2`
`po_number`	String	Non	Filtrer par numéro de BC exact (insensible à la case)	`po_number=A-1000`

Format de réponse

La réponse contient un tableau d’objets bons de commande, chacun avec les champs suivants :

Champ	Type	Description
`id`	Integer	Identifiant unique du bon de commande
`po_number`	String	Numéro du bon de commande
`name`	String	Nom généré automatiquement d'après les détails du BC
`carrier_name`	String	Nom du transporteur attribué au bon de commande
`location_name`	String	Nom de l'emplacement/entrepôt
`outbound`	Boolean	Indique si la commande est sortante (true) ou entrante (false)
`expected_starts_at`	String	Timestamp ISO8601 du début prévu
`expected_ends_at`	String	Timestamp ISO8601 de fin prévue
`custom_values`	Object	Paires clé-valeur de champs personnalisés
`purchase_order_items`	Array	Liste des articles associés à ce bon de commande

Chaque item dans purchase_order_items contient :

Champ	Type	Description
`id`	Integer	Identifiant unique de l’article
`customer_name`	String	Nom du client associé à l’article
`product_name`	String	Nom du produit
`unit_name`	String	Unité de mesure (ex. : « Palette », « Boîte »)
`quantity`	Number	Quantité du produit
`weight`	Number	Poids de l’article
`custom_values`	Object	Paires clé-valeur de champs personnalisés pour cet article

Exemples de code

cURL

Voir l’exemple cURL

# Liste de base
curl -H "Authorization: Token YOUR_API_TOKEN" \
     https://YOUR_LOCATION.datadocks.com/api/v1/purchase_orders

# Filtrer par numéro de BC
curl -H "Authorization: Token YOUR_API_TOKEN" \
     "https://YOUR_LOCATION.datadocks.com/api/v1/purchase_orders?po_number=A-1000"

JavaScript

Voir l’exemple JavaScript

// Utiliser fetch API avec filtre par numéro de BC
const getPurchaseOrders = async (poNumber) => {
  const params = new URLSearchParams();
  if (poNumber) params.append("po_number", poNumber);

  const response = await fetch(
    `https://YOUR_LOCATION.datadocks.com/api/v1/purchase_orders?${params.toString()}`,
    {
      method: "GET",
      headers: {
        Authorization: "Token YOUR_API_TOKEN",
        "Content-Type": "application/json",
      },
    }
  );

  if (!response.ok) {
    const errorData = await response.json();
    throw new Error(
      `Impossible d’obtenir la liste des bons de commande : ${JSON.stringify(errorData)}`
    );
  }

  return response.json();
};

Exemple de réponse

Voir un exemple de réponse

[
  {
    "id": 1,
    "po_number": "A-1000",
    "name": "A-1000-FastCo-Cereal",
    "carrier_name": "FastCo",
    "location_name": "Toronto",
    "outbound": false,
    "expected_starts_at": "2020-10-09T13:35:00-04:00",
    "expected_ends_at": "2020-10-15T13:35:00-04:00",
    "custom_values": {
      "expected_at": "2020-10-09",
      "travel_type": "Plane",
      "forklift_operator": "Joe"
    },
    "purchase_order_items": [
      {
        "id": 2,
        "customer_name": "FishCo",
        "product_name": "Trout",
        "unit_name": "Skid",
        "quantity": 16,
        "weight": 102,
        "custom_values": {}
      },
      {
        "id": 1,
        "customer_name": "FishCo",
        "product_name": "Cereal",
        "unit_name": "Skid",
        "quantity": 33,
        "weight": 581,
        "custom_values": {}
      }
    ]
  }
]

Récupérer un seul bon de commande

Objectif

Obtenez l’information détaillée d’un bon de commande précis par son ID. Utilisez ce point de terminaison lorsque vous avez besoin de toutes les données sur une commande, incluant les lignes d’articles et les champs personnalisés.

Cas d’usage métier

Afficher les détails d’un bon de commande dans votre application
Vérifier les détails avant traitement
Accéder à la liste complète des articles de la commande
Vérifier les valeurs de champs personnalisés à des fins d’intégration

Requête HTTP

GET https://[location_subdomain].datadocks.com/api/v1/purchase_orders/:id

Paramètres d’URL

Paramètre	Type	Obligatoire	Description
`id`	Integer	Oui	Identifiant unique du bon de commande

Réponse

Une requête réussie retourne une réponse 200 OK avec l’objet complet du bon de commande, au même format que pour la liste.

Exemples de code

cURL

Voir l’exemple cURL

curl -H "Authorization: Token YOUR_API_TOKEN" \
     https://YOUR_LOCATION.datadocks.com/api/v1/purchase_orders/1

JavaScript

Voir l’exemple JavaScript

const getPurchaseOrder = async (purchaseOrderId) => {
  try {
    const response = await fetch(
      `https://YOUR_LOCATION.datadocks.com/api/v1/purchase_orders/${purchaseOrderId}`,
      {
        method: "GET",
        headers: {
          Authorization: "Token YOUR_API_TOKEN",
          "Content-Type": "application/json",
        },
      }
    );

    if (!response.ok) {
      if (response.status === 404) {
        throw new Error(`Bon de commande #${purchaseOrderId} non trouvé`);
      }

      const errorData = await response.json();
      throw new Error(
        `Impossible de récupérer le bon de commande : ${JSON.stringify(errorData)}`
      );
    }

    return await response.json();
  } catch (error) {
    console.error("Erreur lors de la récupération du bon de commande :", error);
    throw error;
  }
};

Créer un bon de commande

Objectif

Créer un nouveau bon de commande dans DataDocks. Ce point de terminaison permet d’ajouter des bons de commande et leurs lignes d’articles de façon automatisée, intégrant ainsi votre système de gestion de commandes directement aux opérations de l’entrepôt.

Arbre de décision : Quand créer un BC via API

┌─────────────────┐
│ Ajouter un BC ? │
└────────┬────────┘
         │
         ▼
┌─────────────────────┐    Oui   ┌──────────────────┐
│ Intégration avec    │─────────▶│ Idéal via l’API !│
│ votre ERP/SGC ?     │         │                  │
└────────┬────────────┘         └──────────────────┘
         │ Non
         ▼
┌─────────────────────┐    Oui   ┌────────────────────┐
│ Plusieurs BC à créer│────────▶│ Utiliser l’import   │
│ d’un seul coup ?    │         │ en lot              │
└────────┬────────────┘         └─────────────────────┘
         │ Non
         ▼
┌─────────────────┐
│  Utiliser l’UI  │
│  web            │
└─────────────────┘

Cas d’usage métier

Intégration des systèmes : Créer directement des bons de commande via votre ERP ou gestion de commandes
Traitement automatisé des commandes : Transformer les commandes de vente en BCs de façon programmée
Intégration EDI : Convertir des documents EDI 850 en BCs DataDocks
Intégration fournisseurs : Permettre aux fournisseurs de soumettre leurs BC via vos systèmes

Requête HTTP

POST https://[location_subdomain].datadocks.com/api/v1/purchase_orders

Corps de la requête

Paramètre	Type	Oblig.	Description	Contraintes	Défaut	Exemple
`po_number`	String	Oui	Numéro du bon de commande	Doit être unique	Aucun	`"PO-2023-001"`
`carrier_name`	String	Non *	Nom du transporteur	Aucun	Aucun	`"Express Logistics"`
`carrier_number`	String	Non	Numéro d’entreprise du transporteur	Doit correspondre à un transporteur	Aucun	`"EXP-001"`
`location_name`	String	Non	Nom de l’emplacement	Doit correspondre à un entrepôt	Emplacement actif	`"Entrepôt Toronto"`
`outbound`	Boolean	Non	Indique si la commande est sortante	Aucun	`false`	`true`
`expected_starts_at`	String	Non	Timestamp ISO8601 du début prévu	Format ISO8601 valide	Aucun	`"2023-06-01T08:00:00-04:00"`
`expected_ends_at`	String	Non	Timestamp ISO8601 de fin prévue	Format ISO8601 valide	Aucun	`"2023-06-01T16:00:00-04:00"`
`alternate_reference_number`	String	Non	Numéro de référence secondaire	Aucun	Aucun	`"REF-123"`
`closed`	Boolean	Non	Statut fermé du BC	Aucun	`false`	`true`
`custom_values`	Object	Non *	Valeurs des champs personnalisés	Selon paramètres de l’emplacement	`{}`	`{"department": "Produce"}`
`purchase_order_items`	Array	Non	Lignes d’articles du BC	Au moins un recommandé	`[]`	Voir ci-dessous

Chaque article dans purchase_order_items peut inclure :

Paramètre	Type	Oblig.	Description	Contraintes	Exemple
`customer_name`	String	Non *	Nom du client	Aucun	`"Acme Corp"`
`customer_number`	String	Non *	Numéro d’entreprise du client	Doit correspondre à un client	`"ACME-001"`
`product_name`	String	Non *	Nom du produit	Aucun	`"Widgets"`
`unit_name`	String	Non *	Unité de mesure	Aucun	`"Pallet"`
`quantity`	Number	Non *	Quantité du produit	Doit être positive	`10`
`weight`	Number	Non *	Poids de l’article	Doit être positif	`500`
`custom_values`	Object	Non *	Champs personnalisés pour l’article	Selon paramètres de l’emplacement	`{"color": "Blue"}`

* Peut être obligatoire selon les préférences de l’emplacement

Réponse

Une création réussie retourne une réponse 200 OK avec l’objet BC complet, incluant l’id généré et autres valeurs système.

Exemples de code

cURL

Voir l’exemple cURL

curl -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -X POST \
     -d '{
       "purchase_order": {
         "po_number": "PO-2023-001",
         "carrier_name": "Express Logistics",
         "outbound": false,
         "expected_starts_at": "2023-06-01T08:00:00-04:00",
         "expected_ends_at": "2023-06-01T16:00:00-04:00",
         "custom_values": {
           "department": "Electronics",
           "priority": "High"
         },
         "purchase_order_items": [
           {
             "product_name": "Laptops",
             "unit_name": "Box",
             "quantity": 50,
             "weight": 250,
             "custom_values": {
               "model": "XPS 13"
             }
           },
           {
             "product_name": "Monitors",
             "unit_name": "Pallet",
             "quantity": 10,
             "weight": 500,
             "custom_values": {
               "size": "27-inch"
             }
           }
         ]
       }
     }' \
     https://YOUR_LOCATION.datadocks.com/api/v1/purchase_orders

JavaScript

Voir l’exemple JavaScript

const createPurchaseOrder = async (purchaseOrderData) => {
  try {
    const response = await fetch(
      `https://YOUR_LOCATION.datadocks.com/api/v1/purchase_orders`,
      {
        method: "POST",
        headers: {
          Authorization: "Token YOUR_API_TOKEN",
          "Content-Type": "application/json",
        },
        body: JSON.stringify({ purchase_order: purchaseOrderData }),
      }
    );

    if (!response.ok) {
      const errorData = await response.json();
      const errorMessages = Object.entries(errorData.errors || {})
        .map(([field, messages]) => `${field}: ${messages.join(", ")}`)
        .join("\n");

      throw new Error(`Échec de la création du bon de commande :\n${errorMessages}`);
    }

    return await response.json();
  } catch (error) {
    console.error("Erreur API :", error);
    throw error;
  }
};

Mettre à jour un bon de commande

Objectif

Mettre à jour les détails d’un bon de commande existant. Ce point d’API permet de modifier tous les aspects d’un BC, incluant ses articles, ses dates, le transporteur et les champs personnalisés.

Cas d’usage métier

Données à jour : ajuster les dates de livraison ou le transporteur en cas de changement
Modifier le contenu : ajouter/retirer/changer des articles selon le besoin
Changer le statut du BC : marquer un bon de commande comme terminé/fermé
Ajouter des informations de suivi : mettre à jour les champs personnalisés avec des informations complémentaires

Requête HTTP

PUT https://[location_subdomain].datadocks.com/api/v1/purchase_orders/:id

Paramètres d’URL

Paramètre	Type	Obligatoire	Description
`id`	Integer	Oui	Identifiant unique du bon de commande

Corps de la requête

Ce corps accepte les mêmes paramètres que la création. N’incluez que les champs à modifier.

Scénarios courants

Mise à jour des dates

{
  "purchase_order": {
    "expected_starts_at": "2023-06-05T08:00:00-04:00",
    "expected_ends_at": "2023-06-05T16:00:00-04:00"
  }
}

Changement de transporteur

{
  "purchase_order": {
    "carrier_name": "Fast Transit Inc",
    "carrier_number": "FTI-001"
  }
}

Fermeture d’un bon de commande

{
  "purchase_order": {
    "closed": true
  }
}

Mise à jour des articles

{
  "purchase_order": {
    "purchase_order_items": [
      {
        "id": 123,
        "quantity": 15
      },
      {
        "product_name": "New Product",
        "unit_name": "Box",
        "quantity": 5,
        "weight": 25
      }
    ]
  }
}

Exemples de code

cURL

Voir l’exemple cURL

curl -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -X PUT \
     -d '{
       "purchase_order": {
         "carrier_name": "Updated Logistics Co",
         "expected_starts_at": "2023-06-02T08:00:00-04:00",
         "custom_values": {
           "tracking_number": "TRK12345"
         }
       }
     }' \
     https://YOUR_LOCATION.datadocks.com/api/v1/purchase_orders/1

JavaScript

Voir l’exemple JavaScript

const updatePurchaseOrder = async (purchaseOrderId, updateData) => {
  try {
    const response = await fetch(
      `https://YOUR_LOCATION.datadocks.com/api/v1/purchase_orders/${purchaseOrderId}`,
      {
        method: "PUT",
        headers: {
          Authorization: "Token YOUR_API_TOKEN",
          "Content-Type": "application/json",
        },
        body: JSON.stringify({ purchase_order: updateData }),
      }
    );

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(
        `Échec de la mise à jour du bon de commande : ${JSON.stringify(errorData)}`
      );
    }

    return await response.json();
  } catch (error) {
    console.error("Erreur lors de la mise à jour du bon de commande :", error);
    throw error;
  }
};

Supprimer tous les articles du BC

Pour retirer toutes les lignes d’un bon de commande, ajoutez le paramètre clear_po_items avec la valeur true:

{
  "purchase_order": {
    "clear_po_items": "true",
    "purchase_order_items": [
      {
        "product_name": "New Product",
        "unit_name": "Box",
        "quantity": 10
      }
    ]
  }
}

Cela supprimera tous les articles existants et les remplacera par ceux fournis (le cas échéant).

Supprimer un bon de commande

Objectif

Supprimer un bon de commande du système. Ce point de terminaison permet d’éliminer des BC devenus inutiles.

Points importants

Avant de supprimer un BC, considérez ce qui suit :

Il ne doit pas être associé à des rendez-vous actifs
La suppression est définitive et irréversible
Il est souvent préférable de marquer le bon de commande comme "fermé" plutôt que de le supprimer

Cas d’usages métiers

Nettoyage de données de test : enlever les BC fictifs ou de test
Élimination des doublons : nettoyage lors des déduplications de données
Entretien du système : suppression des vieux enregistrements inutilisés

Requête HTTP

DELETE https://[location_subdomain].datadocks.com/api/v1/purchase_orders/:id

Paramètres d’URL

Paramètre	Type	Obligatoire	Description
`id`	Integer	Oui	Identifiant unique du bon de commande

Réponse

Une suppression réussie retourne 204 No Content, indiquant que la suppression a été effectuée avec succès.

Exemples de code

cURL

Voir l’exemple cURL

curl -H "Authorization: Token YOUR_API_TOKEN" \
     -X DELETE \
     https://YOUR_LOCATION.datadocks.com/api/v1/purchase_orders/1

JavaScript

Voir l’exemple JavaScript

const deletePurchaseOrder = async (purchaseOrderId) => {
  try {
    const response = await fetch(
      `https://YOUR_LOCATION.datadocks.com/api/v1/purchase_orders/${purchaseOrderId}`,
      {
        method: "DELETE",
        headers: {
          Authorization: "Token YOUR_API_TOKEN",
        },
      }
    );

    if (!response.ok) {
      if (response.status === 404) {
        throw new Error(`Bon de commande #${purchaseOrderId} non trouvé`);
      }

      const errorData = await response.json();
      throw new Error(
        `Échec de la suppression du bon de commande : ${JSON.stringify(errorData)}`
      );
    }

    return true; // Suppression réussie
  } catch (error) {
    console.error("Erreur lors de la suppression du bon de commande :", error);
    throw error;
  }
};

Résolution automatique des entités

Résolution du transporteur

Lors de la création ou la modification d’un bon de commande, vous pouvez fournir soit carrier_name, soit carrier_number (ou les deux) :

Si vous fournissez carrier_number, le système essayera de trouver un transporteur correspondant via son numéro d’entreprise
Si une correspondance est trouvée, le nom et l’ID du transporteur seront automatiquement associés au BC
Sinon, la valeur fournie sera utilisée comme carrier_name

Résolution du produit

Pour la création ou mise à jour d’articles du bon de commande :

Si le nom du produit correspond à un produit existant (insensible à la case), celui-ci sera utilisé
Sinon, l’article sera créé mais sera peut-être non lié à un produit enregistré
contactez le support si vous souhaitez créer un produit inexistant

Résolution de l’unité

Comme pour les produits :

Si le nom de l’unité correspond à une unité existante (insensible à la case), elle sera utilisée
Sinon, l’article n’aura pas d’association de type d’unité valide
contactez le support si l’unité n’existe pas encore

Bonnes pratiques

Gestion des données

Utilisez des numéros de BC uniques : assurez-vous que chaque BC a un identifiant unique
Fournissez les numéros d’entreprise des transporteurs : pour une association fiable avec un transporteur
Validez les données côté client : effectuez des validations de base avant l’envoi
Privilégiez le statut "fermé" : marquez les BCs comme fermés plutôt que de les supprimer
Gérez adéquatement les champs personnalisés : utilisez seulement ceux configurés pour votre emplacement

Optimisation de performance

Inclure toutes les données pertinentes : si possible, envoyez tous les détails en une seule requête API
Utiliser les opérations groupées : regroupez les modifications de BC liées ensemble
Soyez précis dans vos requêtes : utilisez les filtres disponibles pour limiter le volume de données transférées

Problèmes fréquents et dépannage

Unicité du numéro de BC : les numéros doivent être uniques par emplacement
Formatage des dates : toutes les dates doivent être au format ISO8601 (ex. : « 2023-06-01T08:00:00-04:00 »)
Association des transporteurs : vérifiez le numéro d’entreprise pour une association automatique correcte
Types des champs personnalisés : Les champs JSON demeurent en JSON, les autres sont convertis en chaînes
Suppression des articles : utilisez le paramètre clear_po_items pour effacer/redéfinir tous les articles

Gestion des erreurs

Code d’erreur	Description	Cause possible
400	Requête invalide	Valeurs ou format incorrects
404	Introuvable	ID du bon de commande inexistant
422	Entité non traitable	Validation échouée (ex : champ requis manquant)
401	Non autorisé	Jeton API invalide ou manquant
403	Interdit	Permissions insuffisantes

Exemple de réponse d’erreur

{
  "errors": {
    "po_number": ["ne peut pas être vide"],
    "purchase_order_items": ["doit contenir au moins un article"]
  }
}

Aide et support

Si vous rencontrez des problèmes qui ne sont pas couverts dans cette documentation :

Vérifiez la réponse d’erreur : la plupart des erreurs API incluent des indications précises sur la cause
Vérifiez les permissions : assurez-vous que votre jeton API a les autorisations nécessaires
Testez par étapes : décomposez les opérations complexes pour isoler la cause du problème

🚀 Pourquoi utiliser l’API des bons de commande?​

Problèmes réels résolus par cette API​

Démarrage rapide en 5 minutes​

Aperçu de l’architecture de l’API​

Authentification​

Lister les bons de commande​

Objectif​

Cas d’usage métier​

Requête HTTP​

Paramètres de requête​

Format de réponse​

Exemples de code​

cURL​

JavaScript​

Exemple de réponse​

Récupérer un seul bon de commande​

Objectif​

Cas d’usage métier​

Requête HTTP​

Paramètres d’URL​

Réponse​

Exemples de code​

cURL​

JavaScript​

Créer un bon de commande​

Objectif​

Arbre de décision : Quand créer un BC via API​

Cas d’usage métier​

Requête HTTP​

Corps de la requête​

Réponse​

Exemples de code​

cURL​

JavaScript​

Mettre à jour un bon de commande​

Objectif​

Cas d’usage métier​

Requête HTTP​

Paramètres d’URL​

Corps de la requête​

Scénarios courants​

Mise à jour des dates​

Changement de transporteur​

Fermeture d’un bon de commande​

Mise à jour des articles​

Exemples de code​

cURL​

JavaScript​

Supprimer tous les articles du BC​

Supprimer un bon de commande​

Objectif​

Points importants​

Cas d’usages métiers​

Requête HTTP​

Paramètres d’URL​

Réponse​

Exemples de code​

cURL​

JavaScript​

Résolution automatique des entités​

Résolution du transporteur​

Résolution du produit​

Résolution de l’unité​

Bonnes pratiques​

Gestion des données​

Optimisation de performance​

Problèmes fréquents et dépannage​

Gestion des erreurs​

Exemple de réponse d’erreur​

Aide et support​

🚀 Pourquoi utiliser l’API des bons de commande?

Problèmes réels résolus par cette API

Démarrage rapide en 5 minutes

Aperçu de l’architecture de l’API

Authentification

Lister les bons de commande

Objectif

Cas d’usage métier

Requête HTTP

Paramètres de requête

Format de réponse

Exemples de code

cURL

JavaScript

Exemple de réponse

Récupérer un seul bon de commande

Objectif

Cas d’usage métier

Requête HTTP

Paramètres d’URL

Réponse

Exemples de code

cURL

JavaScript

Créer un bon de commande

Objectif

Arbre de décision : Quand créer un BC via API

Cas d’usage métier

Requête HTTP

Corps de la requête

Réponse

Exemples de code

cURL

JavaScript

Mettre à jour un bon de commande

Objectif

Cas d’usage métier

Requête HTTP

Paramètres d’URL

Corps de la requête

Scénarios courants

Mise à jour des dates

Changement de transporteur

Fermeture d’un bon de commande

Mise à jour des articles

Exemples de code

cURL

JavaScript

Supprimer tous les articles du BC

Supprimer un bon de commande

Objectif

Points importants

Cas d’usages métiers

Requête HTTP

Paramètres d’URL

Réponse

Exemples de code

cURL

JavaScript

Résolution automatique des entités

Résolution du transporteur

Résolution du produit

Résolution de l’unité

Bonnes pratiques

Gestion des données

Optimisation de performance

Problèmes fréquents et dépannage

Gestion des erreurs

Exemple de réponse d’erreur

Aide et support