Billomat WooCommerce Plugin – Manual

Alle Funktionen verständlich erklärt

Du kannst unser Billomat WooCommerce Plugin ganz individuell nach deinen Bedürfnissen konfigurieren, damit es optimal mit deinem Onlineshop zusammenarbeitet. Nutze dafür die Filter und installiere die Webhooks, die du benötigst.

Welche Filter gibt es?

  • Übergabe von WooCommerce-Kundendaten an die Billomat API

    woocommerce_billomat_customer_export_data
    Beschreibung: Wird bei der Übergabe von WooCommerce-Kundendaten an die Billomat API (Kunde) angewendet (Export).


    add_filter( 'woocommerce_billomat_customer_export_data', 'filter_function_name', 10, 2 );

    function filter_function_name( $data, $user_meta ) {
    // Process Billomat client data here
    return $data;
    }

  • Übergabe von Billomat-Kundendaten an WooCommerce

    woocommerce_billomat_customer_import_data
    Beschreibung: Wird bei der Übergabe von Billomat-Kundendaten an WooCommerce angewendet (Import).

    add_filter( 'woocommerce_billomat_customer_import_data', 'filter_function_name', 10, 2 );

    function filter_function_name( $user_meta, $api_data ) {
    // Process user meta here
    return $user_meta;
    }

  • Übergabe von WooCommerce-Produktdaten an die Billomat API

    woocommerce_billomat_invoice_data
    Beschreibung: Wird bei der Übergabe von WooCommerce-Bestelldaten an die Billomat API (Rechnung) angewendet (Export).

    add_filter( 'woocommerce_billomat_invoice_data', 'filter_function_name', 10, 2 );

    function filter_function_name( $data, $order ) {
    // Process Billomat invoice data here
    return $data;
    }

  • Übergabe von Billomat-Artikeldaten an WooCommerce

    woocommerce_billomat_product_import_data
    Beschreibung: Wird bei der Übergabe von Billomat-Artikeldaten an WooCommerce angewendet (Import).

    add_filter( 'woocommerce_billomat_product_import_data', 'filter_function_name', 10, 2 );

    function filter_function_name( $product_data, $api_data ) {
    // Process product data here
    return $product_data;
    }

  • Übergabe von WooCommerce-Bestelldaten an die Billomat API

    woocommerce_billomat_invoice_data
    Beschreibung:Wird bei der Übergabe von WooCommerce-Bestelldaten an die Billomat API (Rechnung) angewendet (Export).

    add_filter( 'woocommerce_billomat_invoice_data', 'filter_function_name', 10, 2 );

    function filter_function_name( $data, $order ) {
    // Process Billomat invoice data here
    return $data;
    }

  • Generierung der Kundenadresse für die Übergabe an die Billomat API

    woocommerce_billomat_invoice_address_data
    Beschreibung: Wird bei der Generierung der Kundenadresse einer Bestellung für die Übergabe an die Billomat API (Rechnung) angewendet (Export).

    add_filter( 'woocommerce_billomat_invoice_address_data', 'filter_function_name', 10, 2 );

    function filter_function_name( $address_data, $customer_id ) {
    // Process adress data here
    return $address_data;
    }

  • Generierung einer WooCommerce-Bestellposition für die Übergabe an die Billomat API

    woocommerce_billomat_invoice_item_data
    Beschreibung: Wird bei der Generierung einer WooCommerce-Bestellposition für die Übergabe an die Billomat API (Rechnungsposition) angewendet (Export).

    add_filter( 'woocommerce_billomat_invoice_item_data', 'filter_function_name', 10, 2 );

    function filter_function_name( $invoice_item_data, $order_item ) {
    // Process invoice item data here
    return $invoice_item_data;
    }

  • Hinzufügen einer WooCommerce Order Action für die Ausgabe eines Rechnungs-Buttons in der Bestellübersicht

    woocommerce_billomat_invoice_button_action
    Beschreibung: Wird beim Hinzufügen einer WooCommerce Order Action für die Ausgabe eines Rechnungs-Buttons in der Bestellübersicht angewendet.

    add_filter( 'woocommerce_billomat_invoice_button_action', 'filter_function_name', 10, 2 );

    function filter_function_name( $invoice_button_action ) {
    // Modify button action
    return $invoice_button_action;
    }

Welche Webhooks müssen installiert sein?

Für die beidseitige Synchronisation der Kunden- und Artikeldaten, sowie für die automatische Erstellungen von Rechnungen und Lieferscheinen über Billomat, verwendet das Plugin Webhooks. Diese Webhooks musst du in deinem Billomat Account zwingend einrichten.
Bitte beachte dabei, dass das mehrfache Versenden von Webhooks aufgrund von möglichen Zeitüberschreitungen bei Serveranfragen, nicht ausgeschlossen werden kann.

Logge dich dazu in deinen Billomat Account ein. Über das Menü >Einstellungen > Administration > Webhooks gelangst du zur Eingabemaske der Webhooks. Für die Einrichtung der Webhooks benötigst du den Secret Key. Diesen findest du in den Plugin Einstellung unter dem Reiter >Billomat. Kopiere dir den Secret Key.

Screenshot: Billomat Webhooks mit dem Secret Key verknüpfen.

Übersicht Webhooks

Nun kannst du die folgenden acht Webhooks in deinem Billomat Account einrichten:

Event: Customer / change bzw. Kunde / ändern URL: https://yourdomain.com/wp-admin/admin-post.php?action=wcb_update_customer&secret_key=YOUR_SECRET_KEY

Event: Customer / delete bzw. Kunde / löschen https://yourdomain.com/wp-admin/admin-post.php?action=wcb_delete_customer&secret_key=YOUR_SECRET_KEY

Event: Articles / change bzw. Artikel / ändern https://yourdomain.com/wp-admin/admin-post.php?action=wcb_update_product&secret_key=YOUR_SECRET_KEY

Event: Articles / delete bzw. Artikel / löschen URL: https://yourdomain.com/wp-admin/admin-post.php?action=wcb_delete_product&secret_key=YOUR_SECRET_KEY

Event: Delivery note / Change of status bzw. Lieferschein / Statusänderung URL: https://yourdomain.com/wp-admin/admin-post.php?action=wcb_add_delivery_note&secret_key=YOUR_SECRET_KEY

Event: Delivery note / delete bzw. Lieferschein / löschen URL: https://yourdomain.com/wp-admin/admin-post.php?action=wcb_delete_delivery_note&secret_key=YOUR_SECRET_KEY

Event: Invoice / Change of status bzw. Rechnung / Statusänderung URL: https://yourdomain.com/wp-admin/admin-post.php?action=wcb_change_invoice_status&secret_key=YOUR_SECRET_KEY

Event: Invoice / Delete bzw. Rechnung / löschen URL: https://yourdomain.com/wp-admin/admin-post.php?action=wcb_delete_invoice&secret_key=YOUR_SECRET_KEY

Screenshot: Webhooks Einrichtung am Beispiel eines Musteraccounts.