Metadati dell'ordine

Panoramica

Order Invoicer aggiunge automaticamente metadati ai suoi ordini per mantenere la tracciabilità tra la sua piattaforma e-commerce e il suo software di fatturazione. Questi metadati permettono di collegare facilmente gli ordini ai documenti generati (fatture, preventivi, ordini d'acquisto, ecc.).

Tipi di metadati

Metadati di tracciabilità

I seguenti metadati vengono aggiunti automaticamente a ciascun ordine elaborato:

Piattaforme supportate

Shopify

In Shopify, i metadati vengono memorizzati come metafields sugli ordini.

Struttura del metafield

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

Chiavi dei metadati Shopify

Accedere ai metadati in Shopify

Tramite l'API GraphQL:

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

Tramite l'interfaccia Shopify:

1. Vada su Orders > All orders
2. Faccia clic su un ordine
3. Nella sezione Metafields vedrà gli URL dei documenti generati

Pulsante di download per i suoi clienti

Order Invoicer fornisce un app block che può aggiungere al suo tema Shopify per consentire ai suoi clienti di scaricare le loro fatture direttamente dal proprio account cliente.

Per saperne di più: consulti la nostra guida all'installazione del pulsante di download per la configurazione completa.

WooCommerce

In WooCommerce, i metadati vengono memorizzati come meta_data sugli ordini.

Struttura di meta_data

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

Chiavi dei metadati WooCommerce

Accedere ai metadati in WooCommerce

Tramite l'API REST:

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

Tramite l'interfaccia WordPress:

1. Vada su WooCommerce > Orders
2. Faccia clic su un ordine
3. Nella scheda Custom data vedrà i metadati di Order Invoicer

Utilizzo pratico

Tracciabilità degli ordini

I metadati le permettono di:

• Trovare rapidamente il documento Sellsy corrispondente a un ordine
• Verificare lo stato di elaborazione di un ordine
• Accedere direttamente ai documenti dalla sua piattaforma e-commerce
• Mantenere coerenti entrambi i sistemi

Integrazione con strumenti di terze parti

Può utilizzare questi metadati per:

• Automatizzare flussi di lavoro basati sugli URL dei documenti
• Creare report incrociati tra e-commerce e fatturazione
• Realizzare integrazioni personalizzate
• Sincronizzare gli stati tra le piattaforme

Esempi di utilizzo

Script di verifica Shopify

// Check whether an order has been processed
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 di verifica WooCommerce

// Check whether an order has been processed
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;
    }
}

Gestione degli errori

Risoluzione dei problemi