Als je gebruik maakt van de Skwirrel import dan lezen wij je produtgegevens regelmatig in. Soms komt het voor dat je gegevens mist in het StoreLinkr portaal of op je website. Gebruik dit artikel om te controleren wat er mis kan gaan.

Ik mis een of meerdere bijlage(n)

Voer onderstaande stappen uit om het probleem op te lossen:

• Open het StoreLinkr portaal
• Ga naar Catalogus -> Producten
• Klik op Nu synchroniseren

Controleer of je nu wel de bijlage ziet bij het product. Is deze er nog steeds niet? Controleer dan in Skwirrel of het bestand niet is gemarkeerd voor intern gebruik. Wij lezen alleen bestanden in die publiekelijk zichtbaar mogen zijn.

Gegevens komen niet overeen

Wij maken gebruik van een standaard velden indeling voor al onze klanten. Ben je benieuwd welke velden we gebruiken? Lees daar meer over in het artikel over de mapping van Skwirrel.

Mis je nog gegevens?

Heb je bovenstaande stappen gevolgd en mis je nog gegevens? Neem dan contact met onze helpdesk op om je verder te helpen.

Als je gebruik maakt van de StoreLinkr retouren oplossing, krijg je een eigen gratis subdomein. Echter is dit domein niet volledig je eigen huisstijl, waardoor het minder betrouwbaar lijkt.

Daarom bieden wij een gratis optie, namelijk dat je een eigen (sub)domein kunt koppelen aan je retouren portaal.

DNS instellingen voor eigen domein

Om gebruik te maken van een whitelabel retouren portaal, moet je een DNS record toevoegen op het domein van je webwinkel. Maak bijvoorbeeld een subdomein aan:

retouren.mijnwebwinkel.nl

En koppel deze doormiddel van een CNAME type aan:

returns.storelinkr.com

Eigen portaal URL kenbaar maken

Vergeet niet om in het StoreLinkr portaal onder Retouren -> Instellingen -> Portaal URL aan te passen:

Ons systeem zal binnen enkele uren de DNS aanpassing ook detecteren en een SSL certificaat aanmaken. Als het certificaat verloopt en de DNS nog geldig is, vernieuwen wij het certificaat kosteloos.

Als je al één of meerdere koppelingen hebt gemaakt in StoreLinkr, wil je soms een specifieke instelling wijzigen. Je kunt voor veel integraties al specifieke instellingen aanpassen.

Waar kan je dit doen?

Ga naar het dashboard in StoreLinkr. Onderin zie je alle actieve taken die we voor je verwerken. Klik op de taak waarvan je de instellingen wilt aanpassen:

In dit voorbeeld hebben we op de Skwirrel import geklikt. Nu zie je alle gegevens van deze integratie en zie je onderaan de pagina ook de instellingen. Pas hier de instelling aan die je wilt wijzigen. Na het wijzigen is deze direct opgeslagen.

Als we in StoreLinkr de juiste productcondities hebben, sturen we deze ook door naar WooCommerce via de StoreLinkr plugin. Wij moeten dan wel de conditie ook inlezen van je databron, bijvoorbeeld een kassapakket.

Voorbeeld code

Gebruik onderstaande snippet om op een productpagina van WooCommerce de gebruikt status weer te geven. Deze code kan je ook gebruiken als basis om je webshop verder op te bouwen:

add_action('woocommerce_single_product_summary', function() {
    global $product;

    if (!$product instanceof WC_Product) {
        return;
    }

    $used = $product->get_meta('used');

    if ($used !== '' && $used !== null) {
        // 0 = new
        // 1 = used
        echo '<p><strong>Used:</strong> ' . esc_html($used) . '</p>';
    } else {
        echo '<p><strong>Used-veld not found.</strong></p>';
    }
});

De code kijkt naar het meta_veld "used" van het product object. Hierin wordt één van de volgende values opgeslagen:

• 0 = nieuw
• 1 = gebruikt

Om te voorkomen dat we externe website's overbelasten door onze aanvraag, gaan we slim om met de synchronisaties naar je website toe.

In het goedkoopste pakket van de eCommerce oplossing bieden we een garantie voor minimaal 4 synchronisaties per dag. Het betekent echter niet dat we daadwerkelijk 4x een aanvraag naar je website doen, dit doen we de aan de hand van een algoritme.

Wijzigingen in productinformatie

Als er een wijziging is geweest in je productinformatie, dan wordt het product sowieso meegenomen in de synchronisatie ronde. Dat betekent als je gebruik maakt van het Basic pakket met 4 synchronisaties per dag, we de wijzigingen binnen 6 uur hebben doorgezet naar je website.

We detecteren ook wijzigingen in voorraadinformatie, teksten, categorie indeling en alle logische informatie die bij een product hoort. Als daar iets wijzigt, gaat hij sowieso mee in de update.

Waarom deze keuze?

Wij hebben gekozen voor deze oplossing omdat het geen zin heeft om je hele catalogus meerdere keren per dag bij te werken als er geen wijzigingen zijn. Dit levert extra vertraging op in je website, omdat wij eerst een hoop extra aanvragen maakten naar je site.

Minder dataverkeer

Door slim om te gaan met deze data, kunnen we efficiënter werken en houden we het platform en jouw website snel voor iedereen. Ook scheelt het enorm veel dataverkeer naar je website toe omdat we simpelweg minder aanvragen doen. De kwaliteit van de data blijft uiteraard gewaardborgd.

Handmatig synchroniseren

Ondanks deze manier van werken is het nog wel steeds mogelijk om een enkel product te synchroniseren vanuit ons portal. Hiermee forceer je een export naar je website toe en deze export zal dan ook altijd worden uitgevoerd. Ook als er geen wijzigingen gedetecteerd zijn.

In de StoreLinkr plugin zijn inmiddels diverse punten ingebouwd waarop je als developer kunt inhaken. Wij maken gebruik van de hooks & filters die standaard in WordPress core zijn ingebouwd.

Frontend HTML en CSS

Om enkele elementen in de basis mooi te krijgen voor al onze klanten, maken we gebruik van zeer beperkte opmaak in de productdetails pagina.

Momenteel zijn deze filters beschikbaar binnen de plugin:

• storelinkr_stock_css – CSS code voor de opmaak van de voorraadlocaties tabel. Wordt gebruikt in storelinkr.php.
• storelinkr_stock_html – HTML opbouw als je 2 of meer voorraadlocaties hebt. Dit filter toont de HTML in een table met de onderliggende voorraadlocaties. Wordt gebruikt in storelinkr.php.
• storelinkr_variant_css – CSS code om de variant dropdown op te maken. Wordt gebruikt in storelinkr.php.
• storelinkr_variant_html – HTML opbouw om een variant dropdown weer te geven op de productdetails pagina. Wordt gebruikt in storelinkr.php
• storelinkr_variant_dropdown_label – Het label dat gebruikt wordt boven de dropdown op een productdetails pagina. Standaard is het "Selecteer variant".
• storelinkr_attachment_label – Als je bijlagen hebt voegen we een tabblad toe op de productdetailspagina. Met dit filter kan je het label overschrijven. Standaard is dit "Bijlagen".

API en configuratie

Er is momenteel ook een filter toegevoegd in de backend van onze code.

• storelinkr_single_visibility – Stel de zichtbaarheid in van onderliggende artikelen als je gebruik maakt van gegroepeerde producten voor varianten.

Bekijk onze code

Twijfel je over de implementatie van de filters? Kijk dan gerust op onze GitHub repository waarin we deze WordPress plugin blijven ontwikkelen.

In onze WooCommerce koppeling bieden we de mogelijkheid om varianten aan te maken als gegroepeerd product. Dit betekent dat alle onderliggende Single products niet meer worden weergegeven in de catalogus.

Wijzig de zichtbaarheid van single products

Wij passen in onze koppeling een zogenaamd WordPress filter toe, waarmee ontwikkelaars het standaardgedrag kunnen aanpassen. In dit geval is het mogelijk om automatisch de zichtbaarheid te wijzigen.

Gebruik dit stukje voorbeeld code om de zichtbaarheid te wijzigen van onderliggende single products:

add_filter('storelinkr_single_visibility', 'custom_storelinkr_visibility', 10, 2);

/**
 * Pas de productzichtbaarheid aan op basis van voorwaarden.
 *
 * @param string $visibility De huidige zichtbaarheid (bijvoorbeeld 'visible', 'catalog', 'search', of 'hidden').
 * @param int $product_id Het product ID.
 * @return string De gewijzigde zichtbaarheid ('hidden' in dit geval).
 */
function custom_storelinkr_visibility($visibility, $product_id) {
    // Voorbeeldvoorwaarde: verander de zichtbaarheid naar 'hidden' als het product een specifiek ID heeft
    if ($product_id == 123) {
        return 'hidden';
    }
    
    return $visibility;
}

De geldige waarden zijn:

• search (standaard, alleen zichtbaar in zoekresultaten)
• hidden (verborgen)
• catalog
• visible

Dit zijn de standaard WooCommerce zichtbaarheid statussen.

Code niet direct te testen

Alle onderliggende producten worden niet direct bijgewerkt als je deze code hebt toegevoegd in je WordPress omgeving. Wacht hiervoor minimaal 1 synchronisatie af.

Het is ook mogelijk om de variant vanuit het StoreLinkr portaal handmatig te synchroniseren. Dan is de productvariant met de onderliggende producten direct bijgewerkt.

Onze koppeling maakt de producteigenschappen aan doormiddel van metafields. Deze metafields worden standaard niet weergegeven in je webshop, maar dit kan je wel instellen.

Ga hiervoor naar Settings (linksonder) en klik op Custom data:

Klik vervolgens op de "Products definitions" om die te bewerken.

Link StoreLinkr definities aan je eigenschappen

Om de aangemakte metafields te gebruiken in je Shopify winkel, moet je eerst toevoegen als definitie. Klik hiervoor op de knop "View unstructured metafields":

Nu wordt er een lijst getoond met de niet gekoppelde metafields. Bekijk welke velden je wilt gebruiken in je webwinkel en klik achter de definitie op "Add definition":

Maak vervolgens de definitie aan door een naam en omschrijving in te vullen. Selecteer het type single line text (of een andere die overeenkom met je wensen):

Controleer de opties onderaan de pagina en activeer wat er nodig is in je webwinkel:

Sla de definitie op en het producteigenschap wordt nu ook bij de producten in de Shopify admin getoond.

Als je gebruik maakt van onze eCommerce oplossing, dan is het handig om onze IP adressen altijd toegang te geven tot je server(s). Op deze manier worden we niet geblokkeerd.

Het kan soms gebeuren dat we automatisch geblokkeerd worden doordat we veel, maar gedoseerde aanvragen doen.

IP adressen toegang geven

Wij gebruiken de volgende IP adressen om aanvragen te doen naar je hosting omgeving. Voeg deze adressen toe op je firewall:

87.251.32.32/29
87.251.41.34/29 
213.136.4.32/29

User agent herkennen

Als onze aanvragen worden met dezelfde user agent uitgevoerd. Deze mag je ook (als het kan) toevoegen op de toegestane user agents:

StoreLinkr data crawler (https://storelinkr.com)

Ratelimiting

Als onze diensten gebruiken rate limiting en proberen alle aanvragen zo goed mogelijk te verdelen.

Op dit moment is er geen StoreLinkr app te vinden in de Shopify app store. Het is gelukkig wel mogelijk om een gratis koppeling te maken met het StoreLinkr platform. In dit artikel leggen we je uit hoe je deze kunt opzetten.

Mocht het niet lukken om deze stappen te doorlopen, dan helpen we je uiteraard graag. Neem dan even contact met ons op en we staan voor je klaar.

App maken in Shopify

Om te starten met de StoreLinkr koppeling, moet je een app aanmaken in je Shopify webwinkel. Login op Shopify en klik linksonder op "Settings".

Klik vervolgens in het menu op "Apps and sales channels":

Klik daarna op "Develop apps":

En vervolgens op "Create an app":

Vul vervolgens de app naam in, bijvoorbeeld StoreLinkr en selecteer de gebruiker die de app gaat beheren. Druk daarna op de Create app knop:

Het is als het goed is nu gelukt om de app aan te maken! Nu is het tijd om de API Scopes goed in te gaan stellen. Klik daarom op Configure Admin API Scopes.

Activeer de volgende scopes om de koppeling zo goed mogelijk te laten werken:

• write_customers
• read_customers
• write_orders
• read_orders
• write_publications
• read_publications
• write_order_edits
• read_order_edits
• write_draft_orders
• read_draft_orders
• write_assigned_fulfillment_orders
• read_assigned_fulfillment_orders
• write_fulfillments
• read_fulfillments
• write_inventory
• read_inventory
• write_locations
• read_locations
• write_product_listings
• read_product_listings
• write_products
• read_products
• write_returns
• read_returns

Na het activeren van bovenstaande scopes, druk op de zwarte Save knop om de instellingen op te slaan:

Belangrijk: selecteer en noteer welke API versie je applicatie gebruikt. Deze moet exact overeenkomen met de instelling in StoreLinkr. De API versie zie je onderaan deze pagina staan onder het kopje Webhook subscriptions:

Zorg dat hier altijd de (latest) versie geselecteerd is.

Shopify app installeren & activeren

Als bovenstaande stappen zijn afgerond, is het tijd om de app te activeren. Klik eerst op de API Credentials tab en daarna op de knop Install app:

Bevestig daarna de installatie door nogmaals op Install te klikken.

Tokens overnemen

Na het activeren kan je op de tab API credentials het token eenmalig inzien. Klik daarvoor op de link "Reveal token once" en kopieer dit token naar een kladblok of e-mail. Let op: dit token is écht maar één keer in te zien!

Scroll nu naar beneden totdat je de API key and API secret key ziet staan. Kopieer deze gegevens ook naar je kladblok zodat we ze daarna kunnen instellen in StoreLinkr. Dat ziet er zo uit:

Shop naam

Als laatste stap hebben we nog de shop naam nodig om de verbinding te kunnen maken. Als je in Shopify ingelogd bent, kan je deze uit de adresbalk bovenin je browser halen. In dit voorbeeld is het dus "mijn-winkel":

https://admin.shopify.com/store/mijn-winkel/settings/apps/development

Kopieer de shopnaam en voeg deze toe in de StoreLinkr configuratie.