gearEen INNO API instellen

1

Maak een nieuwe koppeling

Volg onderstaande stappen om een nieuwe INNO-koppeling te maken:

  • Begin door naar de API-pagina binnen je project te gaan en te klikken op de "+Add new API" knop. Deze actie brengt je naar de pagina met koppelingen van je bedrijf

  • Op de koppelingen-pagina selecteer je "+Add a new connection".

  • Zoek naar de 'INNO' koppeling door door de pagina's te klikken. Nadat je de 'INNO' koppeling gevonden hebt, geef je een label voor deze nieuwe koppeling.

  • Klik "Koppel met INNO". Je wordt doorgestuurd naar INNO voor de volgende stap. Zodra je bent doorgestuurd, log in met je INNO-gegevens.

Na een succesvolle login is de koppeling met INNO tot stand gebracht en klaar voor gebruik. Je wordt teruggebracht naar de API-setup.

2

Maak de API aan

Eenmaal terug, selecteer je je nieuwe koppeling met INNO en ga je verder met het instellen van je API.

  • Configureer API-instellingen:

    • Geef je API een naam

    • Kies het Unieke ID per item (aanbevolen: het id veld)

    • Selecteer de taal van je API

  • API aanmaken: Klik "Doorgaan" om de nieuwe INNO API te maken.

3

Maak je productvermeldingen aan

Volg onderstaande stappen om je API in te stellen. Elke stap behandelt een deel van de productconfiguratie.

1

Categorisatie

Om je productgegevens te kunnen aanmaken, moeten je producten een categorie hebben. Voeg categorieën toe aan je producten met de functie categorieën genereren, of maak nieuwe categorieën vanaf nul.

  • Slimme categorisering: Wijs automatisch categorieën toe aan je producten op basis van vooraf bepaalde criteria.

  • Handmatige categorisering: Ken categorieën handmatig toe met regels en filters.

  • Niet-gecategoriseerde items: Bekijk en categoriseer items die nog niet zijn gecategoriseerd.

Klik hier om meer te lezen over de categorisering in API's.

2

Regels

Maak regels om je productdata te optimaliseren en te transformeren (filteren, velden wijzigen of verbeteren).

Klik hier om meer te lezen over de regels in API's.

3

Bouw stap

De Build-stap laat je alle benodigde attributen voor je items configureren zodat ze voldoen aan de vereisten van de marketplace.

Je kunt het template invullen door op elk veld te klikken en te selecteren welke informatie je wilt verzenden. Nadat je het template hebt ingevuld, klik je Opslaan onderaan de pagina.

circle-info

Opmerking: de verplichte velden om te mappen in de Build-stap kunnen per marketplace verschillen.

Klik hier om meer te lezen over de Build-stap.

4

GPSR- en DSA-vereisten

De Europese Unie (EU) heeft nieuwe GPSR- en DSA-vereisten voor online platformen, inclusief marketplaces.

Voor je INNO API in Channable, zorg dat je het attributen in het categorie-specifieke Attributen per categorie tab in de Bouwen stap invult:

  • Productveiligheidsinfo: Er zijn twee velden voor de regio's 'BE_NL' en 'BE_FR'.

Aanvullende vereisten voor INNO

De volgende informatie is specifiek voor INNO en behandelt het item-tabblad en aanvullende vereisten.

Item-tabblad

  • Verzendklasse (logistieke klasse): Voer de logistieke klasse van je product in.

  • Levertijd om te verzenden: Geef de verzendtijd in dagen aan.

  • Eco-bijdragen: Als je in Frankrijk actief bent, voeg dan eco-bijdragen toe aan je aanbiedingen. Lijst van beschikbare EPR-categorieën.

Vereisten voor titel

  • Geen merknaam: Mag de merknaam niet bevatten (het merk wordt boven de naam weergegeven).

  • Vereiste taal: Verplicht in zowel Nederlands als Frans.

  • Maximale lengte: 56 tekens (inclusief spaties); aanbevolen limiet 28 tekens voor volledige zichtbaarheid.

  • Naamstructuur: marketingnaam (optioneel) + categorie + attribuut + artikelnummer (voor horloges).

Vereisten voor lange beschrijving

  • Geen externe links of reclame voor andere producten.

  • Vereiste taal: Nederlands en Frans.

  • Unieke inhoud: Vermijd duplicatie met je website.

  • Maximale lengte: 5.000 tekens.

  • Opsommingstekens: Mogen gebruikt worden; formatteer regels met <br/> aan het einde.

Vereisten voor korte beschrijving

  • Geen opsommingstekens (lopende tekst).

  • Vereiste taal: Nederlands en Frans.

  • Maximale lengte: 112 tekens.

Afbeeldingsvereisten

  • Tot 6 afbeeldingen per artikel (1 verplicht, tot 4 extra aanbevolen).

  • Minimale afmetingen: 1050x1200 pixels.

  • Aanbevolen: 1400x1600 pixels.

  • Maximum: 2625x3000 pixels.

  • Vereiste beeldverhouding: 7:8.

  • Ondersteunde formaten: gif, jp2, jpg, jpeg, png, tiff, tif.

  • Hoofdafbeelding: Vooraanzicht, volledig zichtbaar (gedragen door een mannequin bij kleding).

  • Sets: Lever een afbeelding die alle inbegrepen artikelen toont.

  • Geen watermerken, logo's of tekstcomponenten.

  • Achtergrond: Alleen wit, beige of lichtgrijs.

  • Geen kinder modellen voor ondergoed of strandkleding.

  • Opmerking: Er kan nog geen rich media-inhoud (video's) worden geüpload.

Door deze richtlijnen te volgen zorg je dat je INNO-vermeldingen voldoen aan de vereisten van INNO.

5

Beste praktijken

  • Meerdere attributenwaarden toevoegen: Wanneer je meerdere waarden toevoegt in een attribuutveld voor Mirakl Marketplaces, scheid je elke waarde met een pijp-teken "|" zodat ze correct worden gedetecteerd en verwerkt.

  • Product-ID van verkoper voor enkele/eenvoudige producten: Er zijn twee attributen met de naam SellerArticleId en SellerProductId. SellerProductId verwijst naar de Parent ID, terwijl SellerArticleId verwijst naar variant-items. Voor single producten moeten beide attributen met dezelfde waarde worden ingevuld.

Voor meer informatie over Mirakl-marktplaatsfouten, handleidingen en best practices, bekijk onze speciale handleiding.

6

Stap 4: Verstuur je productvermeldingen naar INNO

  • Als je je project nog niet hebt geactiveerd, ga naar je projectinstellingen aan de linkerkant en klik "Activeer project".

  • Ga naar het APIs-overzicht en open [Je INNO API] > Instellingen, activeer daarna de API door te klikken op "Activeer API".

  • Zodra de API is geactiveerd, ga je terug naar het API-overzicht en klik je op de blauwe "Uitvoeren" knop om je productvermeldingen naar INNO te verzenden.

7

Stap 5: Controleer je productvermeldingen op fouten

  • Ga naar [Resultaatpagina van de API] > Tabblad Fouten om te zien welke productvermeldingen fouten hebben.

  • Klik op een specifieke fout om meer informatie over de oorzaak te zien.

Voor meer informatie over wat de fouten betekenen, lees dit artikel.

Laatst bijgewerkt

Was dit nuttig?