Soms kan het voorkomen dat een bepaald product niet online verschijnt in je webshop. Dit kan verschillende oorzaken hebben. In dit artikel bespreken we enkele mogelijke oplossingen om ervoor te zorgen dat jouw producten zichtbaar worden voor klanten.

Mogelijke oorzaken en oplossingen

1. Unieke EAN-code

• Controleer of het product een unieke EAN-code heeft. Bij ons moet elk product uniek zijn.

2. Exportfilters

• Controleer of er actieve exportfilters zijn die het product tegenhouden.

3. Toegestaan product

• Zorg ervoor dat het product is gemarkeerd als “Toegestaan” in je systeem.

4. Variantsynchronisatie

• Bekijk of het product onderdeel uitmaakt van een variant. Indien ja, synchroniseer de variant handmatig.

5. Geldige categorie-indeling

• Controleer of het product is toegewezen aan een geldige categorie binnen de webshop.

6. Juiste prijs

• Bevestig dat het product een correcte prijs heeft ingesteld.

Debuggen van het probleem

1. Ga naar het Storelinkr portal en zoek jouw specifieke product op.
2. Klik rechtsboven op “nu synchroniseren” en selecteer “export”.
3. Wacht tot de logs onderin zijn bijgewerkt. In de tussentijd kun je deze vernieuwen.

Neem contact op met de helpdesk

Het kan frustrerend zijn als een product niet zichtbaar is in je webshop, maar met de juiste stappen en controles kun je het probleem vaak snel oplossen. Volg de hierboven genoemde stappen om het proces te controleren.

Als bovenstaande stappen niet helpen, neem dan contact op met onze helpdesk. Laat ons weten welke specifieke EAN-code niet op je webshop verschijnt, zodat we samen naar een oplossing kunnen zoeken.

Zodra je de API sleutel van CycleSoftware hebt ingevoerd in onze software, is het belangrijk om ook te zorgen dat je een goed aanbod activeert. Dit aanbod activeren kan op verschillende manieren.

Tweewielers activeren via extern aanbod

Ga in CycleSoftware naar Tweewielers -> Voorraad (zoeken). Zoek daar de tweewielers op die je wilt activeren naar de webshop koppeling.

Klik vervolgens op het loepje achter de tweewieler om alle details in te zien.

Hier staat een tabblad E-Commerce, klik daarop. Activeer vervolgens de button “Extern aanbod” om de tweewieler toe te voegen aan de webshop koppeling.

Artikelen activeren

Ga in CycleSoftware naar Artikelen -> Artikelen Catalogus. Zoek daar de juiste artikelen die je wilt activeren in je webshop:

Klik vervolgens op de blauwe i om details in te zien van het artikel. Druk vervolgens op het tabblad E-Commerce en activeer daar het E-Commerce vinkje. Je kan hier ook direct de verkoopprijs en actieprijs instellen voor dit artikel.

Tweewielers en artikelen worden ingelezen

Nadat je de tweewielers en artikelen hebt geactiveerd, kan het nog enkele uren duren voordat ze zichtbaar zijn in de datakoppeling. Wij halen deze gegevens meerdere keren per dag op uit CycleSoftware. Daarna worden ze verwerkt en doorgezet naar je webwinkel.

Wanneer je via onze WordPress plugin een groot variabel product aanmaakt in WooCommerce, kan het gebeuren dat niet alle variaties aankomen. Een product met honderden variaties betekent vaak een JSON-bestand van enkele megabytes. Op een lokale omgeving werkt dit meestal vlekkeloos, maar op een live server blijkt de REST API soms maar een deel van de data te verwerken. Dat kan ertoe leiden dat bijvoorbeeld maar zeven variaties zichtbaar zijn terwijl er honderden zijn verzonden.

Waarom dit probleem ontstaat

De oorzaak ligt meestal niet in je code, maar in de manier waarop de webserver en PHP met grote verzoeken omgaan.
Wanneer een REST-aanvraag te veel data bevat, kan de server de JSON gedeeltelijk afkappen of weigeren te verwerken. WordPress ontvangt dan slechts een deel van de informatie en decodeert die alsof het complete data zijn. Daardoor lijkt alles correct te werken, maar ontbreken er variaties.

Dit is een vorm van inputbeperking. Zowel PHP als de webserver hebben limieten die bepalen hoeveel data per aanvraag mag worden verwerkt. Deze zijn bedoeld om de server te beschermen, maar kunnen bij grote WooCommerce producten te krap zijn.

Controleer de limieten van de server

Om te begrijpen of de limieten te laag staan, kun je in je omgeving nagaan welke waarden momenteel gelden. Typische instellingen vind je in het php.ini-bestand of via de WordPress systeeminformatiepagina.
Let vooral op waarden zoals:

• post_max_size – bepaalt hoeveel data via een POST-aanvraag mag worden verstuurd
• upload_max_filesize – beïnvloedt de maximale bestandsgrootte van uploads
• memory_limit – regelt hoeveel geheugen PHP mag gebruiken
• max_input_vars en max_input_nesting_level – beïnvloeden hoeveel en hoe diep geneste variabelen kunnen worden verwerkt

Wanneer deze limieten te laag staan, kan je JSON maar deels worden ingelezen. Bij een grote variant heb je meestal al snel een request size van <5 MB.

Timeout verhogen

Op veel hostingomgevingen is er een standaard timeout van 30 seconden. Wij hanteren aan onze kant een maximale request tijd van 120 seconden per oproep. Probeer de timeout en/of max request time te verhogen naar 120 seconden (2 minuten).

Let op: dit artikel is bedoelt voor (thema) developers die meewerken aan een WordPress site.

In onze StoreLinkr plugin maken we gebruik van diverse metafields om alle informatie omtrent producten beschikbaar te maken in de WooCommerce shop.

Productvarianten – Variabel product

Binnen een variabel product zijn er opties. Iedere optie is een eigen product, ook binnen StoreLinkr. Op variant optie niveau kan je de volgende metafields ophalen:

Single products

Er zijn ook losse producten, die worden door ons als Single product aangemaakt. Op productniveau kan je de volgende metafields ophalen:

Voorbeeld code om een metafield te gebruiken

Als je als ontwikkelaar een metafield wilt gebruiken, kan je onderstaande snippet in je code gebruiken:

<?php

$product = wc_get_product(3); // het id
$stock_locations = $product->get_meta('stock_locations');

// Toon een lijst van voorraadlocaties voor dit product
var_dump($stock_locations);

StoreLinkr kan producten importeren uit Skwirrel PIM systeem. In de tabel hieronder hebben we beschreven we welke velden gebruiken om de catalogus te vullen in de Shopify catalogus.

Let op: Wil je gebruik maken van meerdere talen in je webshop? Lees dan ook het artikel over de meertaligheid met StoreLinkr.

Velden in Skwirrel bij de productgegevens:

Het is helaas niet mogelijk om deze mapping aan te passen. Mocht je onverhoopt toch een veld missen, neem dan contact op met een van onze product experts.

Eigen CDN url gebruiken voor bijlagen

Bijlagen worden op het StoreLinkr CDN opgeslagen. Op de product pagina op de webshop wordt alleen een link getoond naar het betreffende bestand en de bestanden worden niet binnen Shopify aangemaakt.

Standaard krijg je bij ons een CDN url die er als volgt uit ziet:

https://files.storelinkr.com/directory/filename.pdf

Whitelabel CDN Add-on

Wij bieden een add-on om de CDN url whitelabel aan te bieden op de publieke Shopify pagina. Dit is een betaalde add-on die je kunt activeren in het StoreLinkr portal. Wij kunnen samen met de klant de URL configureren. Ook zorgen wij ervoor dat er een geldig SSL certificaat actief is.

Een voorbeeld van een whitelabel CDN url:

https://bestanden.uwbedrijf.com/directory/filename.pdf

Zodra je vanuit StoreLinkr werkt met meerdere voorraadlocaties, bijvoorbeeld een winkel en een warehouse, maken we deze beide aan in de Shopify integratie.
We maken de voorraadlocaties alleen aan als alle adresgegevens bekend zijn in het StoreLinkr portaal. Controleer dit eerst in Catalogus -> Voorraadlocaties. Zorg dat alle gegevens zijn ingevuld.

Om zeker te zijn dat de locaties bekend zijn in Shopify, mag je deze nog synchroniseren. Doe dit vanuit StoreLinkr, klik vanuit het Voorraadlocaties scherm rechtsboven op “Nu synchroniseren -> Export”.

Locatie instellingen controleren

Ga vervolgens naar je Shopify beheeromgeving. Klik dan linksonder op het tandwiel met Instellingen. Er opent een popup.
Klik vervolgens op Locaties (of Locations in het engels), als het goed is zie je je vooraad locaties die ook bekend zijn in StoreLinkr:

Controleer de nieuwe voorraad locaties door ze beide aan te klikken. Je moet namelijk de zichtbaarheid activeren van deze locaties in je webwinkel. Ze kunnen dan gebruikt worden voor de inventory en tijdens de checkout.

Als voorbeeld hebben we voor deze locatie beide mogelijkheden (verzenden en ophalen) geactiveerd:

Sla de instellingen bovenaan de pagina op om verder te gaan.

Voorraadlocaties weergeven op de productpagina

Het is standaard niet mogelijk om de nieuwe locaties direct te tonen op je winkelpagina. Hiervoor kan je een Liquid maken (technisch), of een Shopify developer vragen om dit te doen. Een goede Shopify agence kan je hierbij uiteraard ook verder helpen.

Het is met onze plugin mogelijk om dubbele attributen te verwijderen. Daarnaast kan je ook in een losse actie de niet gekoppelde attribuut waarden verwijderen.

Onze integratie probeert zo schoon mogelijk te werken, echter lukt dat niet altijd. Dit kan diverse oorzaken hebben. Wij hebben speciaal hiervoor een “Danger zone / Gevarenzone” ingebouwd:

Dubbele attributen verwijderen

Om dubbele attribuut namen samen te voegen en te verwijderen kan je de eerste actie gebruiken in de StoreLinkr WordPress plugin. Deze methode bekijkt alle attributen in WooCommerce en voegt de waardes samen tot één attribuut.

Als je deze methode gebruikt, kan het zijn dat je productfilters opnieuw moet koppelen. Controleer dit altijd na het gebruik van deze opschoonfunctie.

Ongebruikte attribuut waardes verwijderen

Als er veel attribuut waardes zijn, dan wordt het soms tijd om dit op te schonen. Deze functie verwijderd alle attribuut waardes die niet meer gekoppeld zijn aan 1 of meer producten in je webshop.

Ga voorzichtig te werk

Bovenstaande acties zijn niet terug te draaien. Er is geen “undo” functie. Als je twijfelt of je deze functies kunt gebruiken, maak dan eerst een database backup van je website.

Als je voor- en nadelen hebt ingesteld in StoreLinkr, dan maken we deze ook voor je aan op de WooCommerce omgeving. Dit worden ook wel plus- en minpunten genoemd.

Plus- en minpunten beschikbaar als metafield

Wij voegen deze gegevens toe als 2 metafields op het product. Je ontwikkelaar kan hierbij helpen om deze weer te geven op je website.

Om de pluspunten op te halen, kan je de volgende code gebruiken:

$product->get_meta('_positive_points');

En om de minpunten van een product op te halen gebruik je deze code:

$product->get_meta('_negative_points');

Standaard heeft WooCommerce ondersteuning voor 2 type prijzen. Namelijk:

• Reguliere prijs (de standaard verkoopprijs)
• Actieprijs

In StoreLinkr ondersteunen we echter 3 soorten prijzen, namelijk:

• Verkoopprijs
• Adviesprijs
• Promotieprijs

Indeling van StoreLinkr naar WordPress prijzen

In onderstaande tabel zie je hoe wij onze prijzenstructuur aan die van WooCommerce hebben gekoppeld:

Adviesprijs weergeven

Gebruik onderstaande code snippet om de adviesprijs weer te geven in je frontend. Als je hier niet uitkomt, kan je agency je ondersteunen met dit stukje code:

add_action( 'woocommerce_single_product_summary', 'show_advised_price', 25 );

function show_advised_price() {
    global $product;

    $advised_price = get_post_meta( $product->get_id(), 'advised_price', true );

    if ( ! empty( $advised_price ) ) {
        echo '<p class="advised-price">Advised Price: ' . wc_price( $advised_price ) . '</p>';
    }
}

Als je catalogus bij ons wordt gevuld door bijvoorbeeld een PIM systeem, hebben we niet altijd voorraadinformatie over je artikelen. Het is erg nuttig om StoreLinkr toegang te geven tot je live voorraad, aangezien we dit dan ook kunnen bijwerken in alle export koppelingen.

Voorraadlocaties importeren

Om de warehouses van Picqer te importeren gaan we in StoreLinkr naar Catalogus -> Voorradlocaties. Klik bovenin op de knop “Importeer voorraadinformatie”:

Klik vervolgens op de Picqer integratie. Vul daarna je Picqer domein in en geef een unieke API sleutel op die je kunt aanmaken in Picqer.

Test vervolgens de verbinding en maak de koppeling definitief. Vanaf nu zullen we de voorraadinformatie ook inlezen voor je producten in de catalogus.

Product voorraadinformatie vanuit Picqer

Doordat de koppeling nu is gelegd met je WMS platform, kunnen we live meekijken hoeveel voorraad er nog is van een artikel binnen je webwinkel. Je kunt dit controleren door naar een productpagina te navigeren vanuit je catalogus en het blokje “Vooraad” te controleren. Als de voorraad uit Picqer komt, zie je dat duidelijk vermeld staan: