WooCommerce

Förutsättningar för att ansluta WooCommerce till Kroconnect.

  • WordPress version 5.0 eller högre.
  • WooCommerce version 7.0 eller högre.
  • Https aktiverat på webbplatsen.
  • Ladda ner och installera pluginet Kroconnect WooCommerce Connector.

Connection

För att ansluta en WooCommerce-butik behöver den läggas upp som en Connection i Kroconnect. Här i artikeln förklarar vi hur du går tillväga.

Hämta info från WooCommerce

Följande information behövs för att ansluta WooCommerce som en ny connection i Kroconnect:

  1. API Key & API Secret
    Skapa en API-nyckel och hemlighet i din WooCommerce-butik. Dessa behöver ha rättigheter att både läsa och skriva samt vara knutna till en användare som inte raderas i WordPress.
    Navigera till WooCommerce → Inställningar → Avancerat → REST API och klicka på Lägg till nyckel.

    Läs mer om hur du skapar API-nycklar i WooCommerce här: https://woocommerce.com/document/woocommerce-rest-api/
  2. Butikens momsinställningar
    Kontrollera om WooCommerce-butiken är inställd på att priser anges inklusive eller exklusive moms. Det här behövs i samband med att priser synkas till/från andra system eftersom WooCommerce API anger priser utan information om de är angivna med eller utan moms. Läs mer om moms i WooCommerce här: https://woocommerce.com/document/setting-up-taxes-in-woocommerce/

Skapa en Connection i Kroconnect

  1. Logga in i ditt konto på app.kroconnect.com.
  2. Navigera till Connections och klicka på knappen Lägg till ny connection.
  3. Välj WooCommerce.
  4. Endpoint
    Det här är URL’en till din webbutik. För att vara exakt så är det URL’en till platsen där din WordPress-installation finns. Vanligtvis anger man alltså den som https://dindoman.se. Om din WordPress-installation ligger i mappen wordpress så blir endpointen https://dindoman.se/wordpress.
  5. API Key & API Secret
    Ange API-nycklarna du tidigare skapat i WooCommerce.
  6. Custom order statuses
    Kan lämnas tom.
  7. Create missing products
    Används om du har aktiverat workflowen att synka produkter från Specter till WooCommerce. Om checkboxen är ikryssad kommer nya artiklar att skapas i WooCommerce (med status Utkast) om en produkt med det specifika artikelnumret inte existerar sedan tidigare i WooCommerce.

När uppgifterna är ifyllda klickar man på Save och därefter är en ny Connection skapad.

Möjligheten att själv skapa en Connection är inte lanserad till alla kunder ännu. Om du inte ser det i ditt konto kan du skicka in uppgifterna till din kontaktperson på Kroconnect (support@kroconnect.com). Använd gärna en tjänst som QuickForget för att skicka känslig data. Därefter lägger vi in det åt dig.

Vi jobbar på en admin-portal där man som kund ska kunna lägga in den här typen av uppgifter själv. En ny version av app.kroconnect.com släpps under hösten 2024.

Workflows

Följande workflows finns tillgängliga för WooCommerce.

Order

När en ny order (som räknas som betald) skapas i WooCommerce kan den skickas vidare till ett annat system. För närvarande kan ordern skickas till Specter, Fortnox, Visma.net samt Slack.

Vilken orderdata som skickas från WooCommerce till det externa systemet kan konfigureras via mappningsfunktionen som finns i Kroconnect.

Product

När en produkt skapas eller ändras i WooCommerce kan den skickas vidare till ett annat system. För närvarande kan produktdata skickas till WooCommerce och Specter.

Stock

När en produkt skapas eller ändras i WooCommerce kan lagersaldo skickas vidare till ett annat system.

Synkning

WooCommerce kan synkas med flera integrationer. Här under har vi samlat dokumentationen för alla de olika kopplingarna.

Från WooCommerce

Till WooCommerce

Egen / anpassad data i WooCommerce REST API

Eftersom metadata returneras i WooCommerce REST API, både för order och produkt, klarar man sig vanligtvis med denna data. I vissa fall finns det dock behov av mer anpassad data som ska skickas vidare till andra system. Det kan röra sig om data som behöver behandlas/beräknas före det skickas vidare eller data från andra tabeller/posttyper än just order eller produkt.

För att skicka med anpassad data kan man använda sig av olika filter som finns tillgängliga i pluginet Kroconnect WooCommerce Connector.

Order

Genom filtret kroconnect_wc_rest_order_data kan man skicka med specifik information på objektet för order. Denna data hamnar då under sektionen kroconnect på order-objektet. Här är ett exempel för att skicka med data från användaren som gjort köpet.

/**
 * Order object data.
 *
 * Add user data to the Kroconnect order data in the REST API.
 * @param array    $data Kroconnect data object added in the order API request.
 * @param WC_Order $order Order object.
 * @return array   The kroconnect object.
 */
add_filter( 'kroconnect_wc_rest_order_data', 'krk_kroconnect_wc_rest_order_data', 10, 2 );

function krk_kroconnect_wc_rest_order_data( $data, $order ) {

	$user = $order->get_user();

	if( $user ) {
		$data['user'] = array(
			'id' => $user->ID,
			'username' => $user->user_login,
			'email' => $user->user_email,
			'kundnummer' => get_user_meta($user->ID, 'kundnummer', true),
		);
	}

	return $data;
}

Genom filtret kroconnect_wc_rest_order_item_product_data kan man skicka med specifik information på objektet för orderrader. Denna data hamnar då under sektionen kroconnect på varje enskild orderrad i orderobjektet. Här är ett exempel för att skicka med metadata från från produkten på varje enskild orderrad.

/**
 * Order line product data.
 *
 * @param array $data The data added in the order API request.
 * @param object WC_Order_Item_Product.
 * @return array The kroconnect object.
 */
add_filter('kroconnect_wc_rest_order_item_product_data', 'custom_kroconnect_wc_rest_order_item_product_data', 10, 2 );

function custom_kroconnect_wc_rest_order_item_product_data( $data, $order_item_product ) {
	$product_id = ! empty( $order_item_product['variation_id'] ) ? $order_item_product['variation_id'] : $order_item_product['product_id'];
	$product = wc_get_product($product_id);
	
	if( is_object($product)) {
		$data['pcs_article_id'] = $product->get_meta('pcs_article_id');
	}
	
	return $data;
}
Rulla till toppen