Auftragsmetadaten

Überblick

Order Invoicer fügt Ihren Aufträgen automatisch Metadaten hinzu, um die Nachverfolgbarkeit zwischen Ihrer E-Commerce-Plattform und Ihrer Rechnungssoftware zu gewährleisten. Diese Metadaten erleichtern es, Aufträge mit den generierten Dokumenten (Rechnungen, Angeboten, Bestellungen usw.) zu verknüpfen.

Arten von Metadaten

Metadaten zur Nachverfolgbarkeit

Die folgenden Metadaten werden jedem verarbeiteten Auftrag automatisch hinzugefügt:

Unterstützte Plattformen

Shopify

In Shopify werden Metadaten als Metafields auf Aufträgen gespeichert.

Metafield-Struktur

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

Shopify-Metadaten-Schlüssel

Zugriff auf Metadaten in Shopify

Über die GraphQL-API:

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

Über die Shopify-Oberfläche:

1. Gehen Sie zu Orders > All orders
2. Klicken Sie auf einen Auftrag
3. Im Abschnitt Metafields sehen Sie die URLs der generierten Dokumente

Download-Schaltfläche für Ihre Kunden

Order Invoicer stellt einen App-Block bereit, den Sie zu Ihrem Shopify-Theme hinzufügen können, damit Ihre Kunden ihre Rechnungen direkt aus ihrem Kundenkonto herunterladen können.

Mehr erfahren: Sehen Sie sich unseren Installationsleitfaden für die Download-Schaltfläche für die vollständige Einrichtung an.

WooCommerce

In WooCommerce werden Metadaten als meta_data auf Aufträgen gespeichert.

meta_data-Struktur

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

WooCommerce-Metadaten-Schlüssel

Zugriff auf Metadaten in WooCommerce

Über die REST-API:

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

Über die WordPress-Oberfläche:

1. Gehen Sie zu WooCommerce > Orders
2. Klicken Sie auf einen Auftrag
3. Im Tab Custom data sehen Sie die Order-Invoicer-Metadaten

Praktische Nutzung

Auftragsnachverfolgbarkeit

Mit den Metadaten können Sie:

• Schnell das zu einem Auftrag gehörende Sellsy-Dokument finden
• Den Verarbeitungsstatus eines Auftrags überprüfen
• Direkt von Ihrer E-Commerce-Plattform aus auf Dokumente zugreifen
• Beide Systeme konsistent halten

Integration mit Drittanbieter-Tools

Sie können diese Metadaten verwenden, um:

• Workflows zu automatisieren, die auf den Dokument-URLs basieren
• Verknüpfte Berichte zwischen E-Commerce und Rechnungsstellung zu erstellen
• Individuelle Integrationen zu erstellen
• Status zwischen Plattformen zu synchronisieren

Anwendungsbeispiele

Shopify-Prüfskript

// 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);
  }
}

WooCommerce-Prüfskript

// 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;
    }
}

Fehlerbehandlung

Fehlerbehebung