Métadonnées des commandes

Vue d'ensemble

Order Invoicer ajoute automatiquement des métadonnées à vos commandes pour maintenir la traçabilité entre votre plateforme e-commerce et votre logiciel de facturation. Ces métadonnées permettent de lier facilement les commandes aux documents générés (factures, devis, bons de commande, etc.).

Types de métadonnées

Métadonnées de traçabilité

Les métadonnées suivantes sont ajoutées automatiquement à chaque commande traitée :

Plateformes supportées

Shopify

Dans Shopify, les métadonnées sont stockées sous forme de metafields sur les commandes.

Structure des metafields

{
  "ownerId": "gid://shopify/Order/123456789",
  "key": "invoice_url",
  "value": "https://app.sellsy.com/invoice/12345",
  "type": "url"
}

Clés de métadonnées Shopify

Accès aux métadonnées dans Shopify

Via l'API GraphQL :

query getOrderMetafields($id: ID!) {
  order(id: $id) {
    metafields(first: 10) {
      edges {
        node {
          key
          value
          type
        }
      }
    }
  }
}

Via l'interface Shopify :

1. Allez dans Commandes > Toutes les commandes
2. Cliquez sur une commande
3. Dans la section Métadonnées, vous verrez les URLs des documents Sellsy

WooCommerce

Dans WooCommerce, les métadonnées sont stockées sous forme de meta_data sur les commandes.

Structure des meta_data

{
  "meta_data": [
    {
      "key": "orderinvoicer.invoice_url",
      "value": "https://app.sellsy.com/invoice/12345"
    }
  ]
}

Clés de métadonnées WooCommerce

Accès aux métadonnées dans WooCommerce

Via l'API REST :

GET /wp-json/wc/v3/orders/{id}

Via l'interface WordPress :

1. Allez dans WooCommerce > Commandes
2. Cliquez sur une commande
3. Dans l'onglet Données personnalisées, vous verrez les métadonnées Order Invoicer

Utilisation pratique

Traçabilité des commandes

Les métadonnées permettent de :

• Retrouver rapidement le document Sellsy correspondant à une commande
• Vérifier le statut de traitement d'une commande
• Accéder directement aux documents depuis votre plateforme e-commerce
• Maintenir la cohérence entre les deux systèmes

Intégration avec des outils tiers

Vous pouvez utiliser ces métadonnées pour :

• Automatiser des workflows basés sur les URLs des documents
• Créer des rapports croisés entre e-commerce et facturation
• Développer des intégrations personnalisées
• Synchroniser des statuts entre les plateformes

Exemples d'utilisation

Script de vérification Shopify

// Vérifier si une commande a été traitée
async function checkOrderProcessed(orderId) {
  const order = await shopify.order.get(orderId);
  const metafields = order.metafields;
  
  const invoiceUrl = metafields.find(m => m.key === 'invoice_url');
  if (invoiceUrl) {
    console.log('Commande traitée - Facture:', invoiceUrl.value);
  }
}

Script de vérification WooCommerce

// Vérifier si une commande a été traitée
function check_order_processed($order_id) {
    $order = wc_get_order($order_id);
    $invoice_url = $order->get_meta('orderinvoicer.invoice_url');
    
    if ($invoice_url) {
        echo 'Commande traitée - Facture: ' . $invoice_url;
    }
}

Gestion des erreurs

Dépannage