Om te beginnen met het verkopen van je producten op Miravia, is het noodzakelijk om een Miravia verkopersaccount te hebben. Als je nog geen Miravia verkopersaccount hebt, raden wij je aan contact met Miravia op te nemen om deze te verkrijgen. Zodra je een Miravia verkopersaccount hebt ingesteld, kun je beginnen met de koppeling via Channable.
Inhoudsopgave
Stap 1: Een nieuwe koppeling aanmaken
Volg onderstaande stappen om een nieuwe Miravia koppeling aan te maken:
- Navigeer eerst naar de API-pagina binnen je project en klik op de knop “+ API koppeling toevoegen”. Deze actie leidt je door naar de pagina met alle koppelingen in je account.
- Klik op '+Koppeling toevoegen'. Selecteer in dit scherm de Miravia koppeling en geef een label op voor deze nieuwe koppeling.
- Klik op 'Koppel met Miravia' en je wordt doorgestuurd naar de Miravia omgeving. Eenmaal omgeleid, log je in met je Miravia gegevens.
- Na succesvol inloggen is de koppeling met Miravia tot stand gebracht en beschikbaar voor gebruik! Je wordt teruggebracht naar de API setup.
Stap 2: Opzetten van de Miravia API
Eenmaal terug, moet je de nieuwe Miravia koppeling selecteren en verder gaan met het instellen van je API.
-
Configureer de API-instellingen
- Geef je API een naam
- Kies de taal van je API
- Kies het unieke ID per item (wij raden het 'id' veld aan)
-
Maak de API aan: Klik op 'Volgende' om de nieuwe Miravia API aan te maken.
Stap 3: Het aanmaken van productvermeldingen in Channable
Volg de onderstaande stappen om je API in te stellen. Klik op elke stap om deze uit te klappen en de gedetailleerde instructies te bekijken, die je door het hele proces zullen leiden.
1. Categorieën
Om je productgegevens aan te maken, hebben je producten een categorie nodig. Voeg categorieën aan je producten toe met de functie 'categorieën genereren' of maak nieuwe categorieën aan.
- Smart categorization: Deze functie wijst automatisch categorieën aan je producten toe op basis van vooraf gedefinieerde criteria, wat het categorisatie proces vereenvoudigt.
- Handmatige categorieën: Wijs handmatig categorieën toe aan je producten door specifieke regels in te stellen. Je kunt gedetailleerde filters maken om elk product aan de juiste categorie toe te wijzen.
- Niet-gecategoriseerde items: Controleer en categoriseer alle items die nog niet gecategoriseerd zijn om ervoor te zorgen dat alle producten goed gecategoriseerd zijn.
2. Regels
Maak verschillende regels om je productgegevens te optimaliseren. Raadpleeg voor voorbeelden ons helpcenter artikel voor algemene regels.
- Regels setup: Stel verschillende regels in om je productgegevens te verfijnen. Dit kan het filteren, wijzigen of verbeteren van datavelden omvatten om te voldoen aan de vereisten van de marketplace.
3. Opbouw stap
Met de Opbouw stap in Channable kun je alle benodigde attributen voor je items configureren, zodat je productgegevens overeenkomen met de vereisten van de marketplace. Deze stap is cruciaal voor succesvolle product listings en het vermijden van fouten.
3.1 Overzicht
- Ga naar de Opbouw stap: Begin met het openen van de gecentraliseerde interface van de Opbouw stap. Hier kun je alle productattributen beheren en in kaart brengen.
- Identificeer verplichte en optionele velden: Verplichte velden zijn roze gemarkeerd om aan te geven dat ze essentieel zijn. Optionele velden zijn oranje gemarkeerd en kunnen worden ingevuld op basis van specifieke behoeften.
3.2 Gedeelde attributen vullen
-
Gedeelde attributen vullen: Voer algemene gegevens in die van toepassing zijn op alle producten, zoals EAN, prijzen en titels. Deze stap zorgt voor uniformiteit in de basisproductinformatie voor al je listings.
-
Gebruik statische of dynamische waarden:
- Statische waarden: Direct waarden invoeren die constant blijven, zoals merknaam of fabrikant.
- Dynamische waarden: Gebruik velden die automatisch worden bijgewerkt op basis van gekoppelde gegevens, ideaal voor variabelen zoals voorraadniveaus of prijzen.
-
Gebruik statische of dynamische waarden:
Nadat je de gewenste waarden voor de gedeelde attributen hebt ingevuld, ga je verder met de categoriespecifieke attributen hieronder.
3.3 Categoriespecifieke attributen opgeven
- Selecteer een productcategorie: Kies de relevante categorie voor je product, zoals kleding of meubels.
- Invullen van categoriespecifieke attributen: Vul de attributen in die specifiek zijn voor de geselecteerde categorie, zoals maten voor kleding of afmetingen voor meubels. Deze stap helpt bij het afstemmen van je listings op de categorie vereisten. Ook hier kun je statische of dynamische waarden gebruiken.
4. Kwaliteitsstap
De kwaliteitsstap geeft direct feedback over de kwaliteit van de instellingen en markeert verplichte en optionele fouten om ervoor te zorgen dat je productgegevens voldoen aan de standaarden van de marketplaces.
Acties
- Bekijk items: Bekijk producten met specifieke problemen.
- Bekijk in de opbouw stap: Leidt je door naar de opbouw stap om ontbrekende informatie in kaart te brengen.
- Categorieën instellen: Hiermee ga je naar de Categorieën stap om items te categoriseren.
- Toon Bron: Beschikbaar voor ID-velden, hiermee ga je direct naar de instellen stap.
Klik hier om meer te lezen over de kwaliteitsstap in de API.
5. Bekijk stap
De Bekijk stap toont in kaart gebrachte attributen voor meerdere items en markeert fouten voordat er naar de marketplace wordt geëxporteerd.
Features
- Zoek & filter: Zoek specifieke producten of filter op foutmelding/categorie.
- Item overzicht: Toont alle items die geëxporteerd moeten worden; het kan filteren om alleen items met fouten te tonen.
- Gedetailleerd productoverzicht: Toont ontbrekende informatie en dynamische acties om fouten te corrigeren.
Checklist voor het afronden van attributen
- Gedeelde kenmerken bekijken: Zorg ervoor dat alle verplichte gedeelde attributen zijn ingevuld.
- Categoriespecifieke kenmerken bekijken: Zorg ervoor dat alle verplichte categoriespecifieke attributen zijn ingevuld.
- Contoleer op fouten: Corrigeer rood gemarkeerde velden.
6. Resultaat stap
Het tabblad Resultaat geeft een overzicht van de resultaten van je API-instelling, inclusief succesvolle uploads, fouten en een voorbeeld van de producten die worden weergegeven. Dit tabblad zorgt ervoor dat je productgegevens correct worden verwerkt en identificeert eventuele problemen die moeten worden opgelost.
- Overzicht: Het resultaat tabblad toont de status van je productvermeldingen en markeert fouten en problemen voor een gedetailleerd inzicht.
- Preview van producten: Toont een overzicht van producten die naar de marketplace moeten worden verstuurd, zodat kan worden gecontroleerd of attributen correct zijn ingevuld.
- Succesvol: Toont producten die met succes zijn verwerkt en klaar zijn om gelist te worden, en bevestigt dat ze voldoen aan de vereisten van de marketplace.
- Fouten: Identificeert fouten tijdens de verwerking en geeft gedetailleerde informatie om problemen op te lossen.
Optionele tabbladen zoals Repricer fouten, Repricer event geschiedenis, Voorraadupdates en Leveringstype updates verschijnen alleen als ze relevant zijn voor de API die je gebruikt. Klik hier om meer te lezen over de Resultaat stap.
Aanvullende vereisten voor Miravia
De volgende informatie is specifiek voor Miravia, we bespreken per tab waar je op moet letten.
Item tab
- Item group ID: Dit veld wordt gebruikt om meerdere variant items in een enkele listing te groeperen. Als er niet meerdere varianten zijn, selecteer dan het unieke ID van het item voor het item_group_id.
Verzenden tab
- Verplichte velden: Zorg ervoor dat alle velden met verzendgegevens, zoals gewicht, lengte, breedte en hoogte, worden ingevuld met waarden groter dan 0 en met niet meer dan 2 decimalen. Als dit niet bekend is, stel deze waarden dan in op 1, bijvoorbeeld met behulp van een regel.
- Levering door verkoper: Stel deze optie in op “Yes” alleen met voorafgaande toestemming van Miravia; stel deze anders in op “No” om fouten te voorkomen. Raadpleeg dit artikel over het gebruik van “Levering door Miravia” in Channable voor gedetailleerde informatie.
- Standaardwaarden: Als deze waarden onbekend zijn, stel ze dan allemaal in op 1 met behulp van een regel.
Afbeeldingen tab
- Afbeeldingen koppelen: Koppel de velden met je afbeeldingen in het tabblad Afbeeldingen.
- Vereisten voor afbeeldingen: Hou je aan de strenge afbeeldingseisen van Miravia voor zowel de URL als de afbeelding zelf. Niet-naleving zal resulteren in een "Could not upload image due to: .. E302: "Description of error" error in de resultaat stap van de API
Als je deze richtlijnen volgt, weet je zeker dat je Miravia listings correct zijn ingesteld en voldoen aan hun vereisten.
GPSR- en DSA-vereisten
Hoe kan ik DSA-informatie in Channable toevoegen
De Europese Unie (EU) heeft nieuwe GPSR- en DSA-vereisten voor online platforms ingevoerd, inclusief marketplaces.
Stap 1: Registreer Gegevens van de Fabrikant en Verantwoordelijke Persoon
Maak profielen aan in Seller Central en navigeer naar de pagina voor het beheren van fabrikant informatie. Je vindt daar twee tabbladen:
- Manufacturer information
- EU Responsible Person Information
In het tabblad Manufacturer information voeg je de gegevens van de fabrikant toe. In het tabblad EU Responsible Person Information voeg je de gegevens toe van de verantwoordelijke persoon binnen de EU. Hieronder zie je screenshots van het proces.
Zodra dit is afgerond, ontvang je een Manufacturer-ID en een EU Responsible Person-ID. Deze ID's zijn essentieel voor de volgende stap. Als iets onduidelijk is, kun je contact met Miravia opnemen voor meer informatie.
Stap 2: Vul de Fabrikant- en Verantwoordelijke Persoon attributen in met de verkregen ID's
Met de vereiste ID's uit Stap 1 kun je beginnen met het invullen van de attributen in Channable. Gebruik de volgende attributen in Channable:
- Manufacturer info: De geregistreerde ID van de fabrikant.
- EU Responsible: De geregistreerde ID van de verantwoordelijke persoon die aan het product is gekoppeld.
Om deze attributen in te vullen, ga je naar [Je Miravia API] > Opbouw > Attributen per categorie. Klik op een categorie en zoek naar de genoemde attributen. Vul de ID's uit Seller Central in bij de attributen en klik op Opslaan.
Algemene Productveiligheidsvoorschriften (GPSR)
Naast DSA-compliance heeft Miravia velden toegevoegd die betrekking hebben op productveiligheid.
Veiligheidswaarschuwingen
Verkopers moeten aangeven of het product veiligheidswaarschuwingen bevat. Als dit het geval is, moeten de volgende attributen worden ingevuld:
- Does This Product Have A Safety Warning: Voeg "Yes/No" toe. Als "Yes", zorg er dan voor dat je de benodigde veiligheidsinformatie toevoegt aan het attribuut Safety Warning Content.
- Safety Warning Content: Vul hier de tekst van de veiligheidswaarschuwing in.
Verpakkingsetiket
Je moet een productetiket met de noodzakelijke details aanleveren. Elk item moet ook een gelabelde afbeelding bevatten. Het fysieke verpakkingsetiket moet bevatten:
- Informatie over de fabrikant (en de EU-verantwoordelijke persoon, als de fabrikant buiten de EU is gevestigd).
- Productidentificatie-informatie.
- Eventuele markeringen of veiligheidswaarschuwingen.
In Channable vind je dit attribuut in de sectie Attributen per categorie onder Package/Label Photo(Eu).
Productcompliance-certificeringen
Miravia heeft aanvullende Attributen per categorie geïntroduceerd die alleen verschijnen in Channable als je producten in bepaalde categorieën vallen. Met deze attributen kan je relevante certificeringen indienen, zoals CE-certificaten en testrapporten. Beschikbare attributen variëren per productcategorie.
- Ce Certificate/ Declaration Of Conformity (Doc)
- ECE certificate
- CPNP certificate
- RoHS Testing Report: Controleert of elektronische producten voldoen aan regelgeving inzake schadelijke stoffen.
- REACH Report: Bevestigt dat chemicaliën in producten voldoen aan EU-regels binnen de hele toeleveringsketen.
- BPR Registration Certificate: Toont goedkeuring voor het gebruik van antibacteriële producten volgens EU-wetgeving.
- EU Food Contact Materials Test Report (FCM): Bevestigt dat materialen veilig zijn voor contact met levensmiddelen in de EU.
Voor bepaalde categorieën zijn ook specifieke testrapporten vereist, zoals:
- PIF document: Compleet dossier met informatie die nodig is voor de verkoop van cosmetica in de EU.
- EMC/LVD test report: Valideert naleving van regels voor elektromagnetische veiligheid.
- EMC test report: Controleert of een product geen elektromagnetische interferentie veroorzaakt.
- EN71 test report: Bewijst dat speelgoed veilig is volgens EU-normen.
- R44 test report: Certificeert dat autostoeltjes voor kinderen voldoen aan VN-veiligheidsregels.
- Building product test report: Bevestigt dat bouwmaterialen voldoen aan EU-normen.
- MDR test report: Toont aan dat medische apparaten voldoen aan EU-voorschriften.
- Soother test report (EN1400:2013): Verifieert dat fopspenen veilig zijn in de EU.
- PPE test report: Zorgt ervoor dat persoonlijke beschermingsmiddelen voldoen aan EU-normen.
- EN62115: Controleert of elektrisch speelgoed veilig is.
- RED test report: Bevestigt dat draadloze apparaten voldoen aan de Radio Equipment Directive.
Voor meer details over de EU-regelgeving en compliance kun je dit artikel raadplegen of contact met Miravia opnemen voor ondersteuning.
Stap 4: Stuur je advertenties naar Miravia
Zorg ervoor dat je je project hebt geactiveerd in Channable door in de tool naar Configuratie > Projectconfiguratie te gaan en daarna op "Activeer project" te klikken.
Ga daarna naar APIs > "Je Miravia API Naam" > Instellen en klik daarna op "Activeer API".
Nadat je deze stap hebt voltooid, ga je terug naar het APIs-overzicht en klik je op de blauwe knop "Uitvoeren" om de productvermeldingen naar Miravia te sturen.
Stap 5: Controleer je productvermeldingen op fouten
Wanneer de advertenties naar Miravia zijn verstuurd, kun je in de Resultaat stap de voorvertoning van je productvermeldingen zien. Klik op de tab 'Fouten'. Hier zie je welke advertenties fouten bevatten en niet op Miravia geplaatst zullen worden. Klik op een specifieke fout om meer informatie te zien over de oorzaak van de fout.
In dit helpcenter artikel vind je een overzicht van de meest voorkomende fouten in de Miravia API en hoe je deze kunt oplossen.