Een eBay API opzetten – Help Center - Channable

Dit is een helpcenter artikel van Channable, de tool voor product feedmanagement en marketplaces integraties. Als je nog geen account hebt, meld je dan gratis aan of ontdek hoe je jouw webshop kan integreren met eBay.

Wil je interactief alle basisprincipes leren met betrekking tot het maken van een API export, of wil je leren hoe je een geavanceerde API setup maakt in Channable? Leer via dit Helpcenterartikel hoe je een Channacademy-account aanmaakt in de Channable app en start met de Basic APIs of Expert APIs course.

Voordat je begint, lees dit eerst!

eBay berekent kosten voor elke keer dat een advertentie (of listing, zoals eBay ze noemt) wordt aangemaakt. We plaatsen advertenties als 'Good Till Cancelled'-listings. Meer informatie hierover, kun je hier vinden.
Je eBay koppeling kan verlopen nadat je deze een bepaalde tijd hebt gebruikt. Dit zal leiden tot een foutmelding in de API en de API zal 'mislukt' aangeven. Om de koppeling te verversen, volg je de stappen in dit artikel.
Zorg ervoor dat je niet bent ingelogd op je eBay-account.

Stap 1 - Maak een nieuwe eBay koppeling in Channable aan

Ga naar het project waar je in werkt en navigeer naar het API tabblad. Klik op '+ API koppeling toevoegen' en dan op 'Koppeling toevoegen'.

Selecteer eBay, geef je nieuwe API een naam en klik op 'Koppel met eBay'. Je wordt nu doorgestuurd naar je eBay omgeving. Meld je aan met het e-mailadres of gebruikersnaam en wachtwoord. Zorg ervoor dat je niet al in een ander eBay account bent ingelogd. Vervolgens moet je Channable toegang verlenen, waarna je terug naar Channable wordt gestuurd.

Je kunt in Channable het maken van de koppeling afronden door op 'Koppeling toevoegen' te klikken.

Stap 2 - Een nieuwe eBay API instellen

Nadat je de nieuwe eBay API hebt aangemaakt kun je de API een naam geven, het land kiezen en het unieke ID per item selecteren (we raden hier het ID aan). Het land wordt gebruikt om het verkopersbeleid (bv. het verzendprofiel) vanuit je eBay account op te halen voor dat specifieke land. Zie stap 3.3 van dit artikel voor meer informatie over het instellen van je verkopersbeleid.

In de instellingen van je eBay API moet je ook de 'Status' selecteren. Hier zijn twee opties voor:

'Verify-only': De status staat standaard op 'Verify-only'. Met de 'Verify-only' status kun je de API activeren om te testen of er foutmeldingen zijn zonder dat je daadwerkelijk iets op eBay publiceert.
'Publish': Als je zeker weet dat je jouw advertenties op eBay wilt publiceren kun je de status veranderen naar 'Publish'.

Tot slot kun je een master regel groep gebruiken (optioneel). Klik op 'Volgende' als je klaar bent met de instellingen.

Let op I: Als je de 'Verify-only' optie selecteert en de API activeert, zie je alleen het aantal fouten in de 'Bekijk' stap. Je zult geen aantal succesvolle producten zien omdat je nog niets publiceert.

Let op II: Wanneer je de Status in de API instellingen van 'Verify-only' naar 'Publish' verandert kun je dit niet weer terugzetten naar de 'Verify-only' modus!

Stap 3 - Bouw je productadvertenties

Volg de vier stappen hieronder om je productadvertenties voor eBay te configureren.

1. Categorieën

Voeg eBay categorieën toe aan je producten. Dit kan met behulp van de functie Categorieën genereren, of door handmatig de categorieën in te vullen.

2. Regels

Maak verschillende regels aan om je productdata te optimaliseren. Voor voorbeelden kun je naar ons helpcenter artikel gaan voor veel voorkomende regels.

3. Opbouw

Hier vind je onze vooraf ingestelde template voor productvermeldingen. Je hoeft het alleen maar in te vullen door op elk veld te klikken en de juiste waarde te kiezen (dynamische of statische waarde). Bijvoorbeeld voor 'Price' kies je de prijs van je product uit een dynamisch veld 'Price'. Volg een soortgelijk proces voor andere velden.

We zullen een paar velden toelichten die mogelijk extra details nodig hebben:

Conditie

Afhankelijk van de categorie waarin je producten vallen, heeft eBay verschillende condities voor deze categorieën. In Channable heb je de mogelijkheid om uit een lijst van statische waarden te kiezen door op het veld Conditie > Vaste waarden te klikken. Hier vind je een lijst met mogelijke opties.

Als je een groot aantal producten in verschillende categorieën hebt, moet je de juiste conditie voor die specifieke categorie gebruiken. Als je conditieveld volgens eBay niet de juiste waarde bevat, kun je een regel creëren waarbij je een dynamisch veld met de juiste waarde vult.

Weet je niet zeker wat de juiste conditie waarde voor een categorie is? Raadpleeg het helpcenter van eBay voor advies.

Verzend-, betalings- en retourbeleid

Je moet profielen voor je Verzend-, Betaal- en Retourbeleid opgeven. Zie deze link voor meer informatie over deze profielen.

In Channable kun je de eBay profielen selecteren die je in eBay hebt ingesteld om voor je eBay API in Channable te gebruiken. Gebruik de profielnamen zoals die op eBay te zien zijn of kopieer de de ID's uit de browser-URL wanneer je op één van de 3 profielen klikt. Volg deze handleiding voor dynamische profielconfiguratie (dat wil zeggen verschillende profielen voor verschillende producten).

Item group ID

Het veld "Item group ID" wordt gebruikt om meerdere items in één listing te combineren. Selecteer hier het veld dat de Group- of Parent ID van je producten bevat. Later, in de "Attributen" stap, kun je velden selecteren om de varianten van gegroepeerde producten te configureren. Als al je producten varianten zijn, gebruik je gewoon het product-ID (ID).

Categorie ID winkel & Categorie naam winkel

Als je eigenaar van een eBay winkel bent, moet je ook de velden 'Categorie ID winkel' en 'Categorie naam winkel' invullen. Zo niet, dan kun je deze velden leeg laten.

Tip! Als je met je muis over de vraagtekens achter de velden gaat, krijg je een beschrijving van het veld te zien en suggesties voor de inhoud.

Let op I: Voorheen was het verplicht om EAN/GTIN codes te hebben voor eBay, maar inmiddels niet meer. Voor eBay EU: Als je geen EAN/GTIN codes hebt en wel op eBay wil adverteren, selecteer dan 'EAN' als ID type en zorg ervoor dat het veld dat je gebruikt de waarde 'Does not apply' heeft. Voor eBay US: Als je geen UPC/GTIN codes hebt en wel op eBay wil adverteren, selecteer dan 'UPC' als ID type en zorg ervoor dat het veld dat je gebruikt de waarde 'Does not apply' heeft.

Let op II: Hoewel het niet direct zichtbaar is in de tool, ondersteunt Channable wel het K-type kenmerk voor de auto-categorie in de opbouw-stap. Als je gebruik wilt maken van dit kenmerk, kun je contact met onze technische support afdeling opnemen en dan zullen zij deze functie voor jouw eBay API inschakelen.

4. Attributen

Vervolgens moet je in de Attributen stap per categorie de attributen instellen. Zie de afbeelding hieronder voor een voorbeeld hoe de attributen eruit zien. Een meer gedetailleerde uitleg wat je in de Attributen stap in kan stellen kun je hier vinden.

Let op: als je varianten van producten hebt, kun je deze ook in de Attributen stap instellen. Als je een veld als waarde voor een attribuut selecteert, kun je bij sommige attributen ook de 'Gebruik als variant attribuut' optie aanvinken. Als je varianten hebt, moet je dit voor minimaal 1 attribuut per categorie doen waar je varianten onder vallen. Anders zullen je producten niet als varianten op eBay verschijnen. Let ook op dat niet alle categorieën de varianten structuur accepteren, alleen de categorieën die op deze pagina staan.

Een-eBay-API-opzetten-–-Channable.png

Stap 4 - Stuur je advertenties naar eBay

Belangrijk: Channable maakt nieuwe productvermeldingen aan in je eBay-account, het maakt GEEN verbinding met de producten die je al in je eBay-account hebt staan, dus vergeet niet om alle producten uit je eBay-account te halen, door deze te verwijderen voordat je ze via Channable verstuurt.

Als je klaar bent met je productadvertenties bouwen kun je jouw advertenties naar eBay gaan sturen. Als je het project nog niet hebt geactiveerd, navigeer dan eerst naar 'Setup > Projectconfiguratie' en activeer het project. Ga daarna terug naar het API-overzicht en ga naar Instellen van de eBay API om ook de API te activeren. Als je vervolgens op 'Uitvoeren' klikt worden je producten naar eBay gestuurd!

Als je nog steeds 'Verify-only' als status hebt ingesteld komen je producten niet direct op eBay te staan. In plaats daarvan zie je alleen de foutmeldingen in de Bekijk stap in Channable. Als je klaar bent om je advertenties op eBay te publiceren, selecteer dan 'Publish' als status en klik opnieuw op 'Uitvoeren'.

Let op: Wanneer je de Status in de API instellingen van 'Verify-only' naar 'Publish' verandert kun je dit niet weer terugzetten naar de 'Verify-only' modus!

Stap 5 - Controleer je productvermeldingen op fouten

Ga naar de Bekijk stap nadat je jouw advertenties naar eBay hebt gestuurd. Als je op 'Fouten' klikt, zie je een overzicht van het aantal foutmeldingen. Deze producten zullen niet op eBay worden geplaatst. Klik op een foutmelding om te zien om wat voor fout het gaat en welke producten de foutmelding hebben. Als je jouw advertenties met de status 'Publish' stuurt, zul je ook het aantal succesvolle producten in de Bekijk stap te zien krijgen.

Let op I: Als je een foutmelding op 1 variant van een gegroepeerde advertentie krijgt, is de foutmelding te zien voor alle producten in deze gegroepeerde advertentie.

Let op II: Advertenties worden niet automatisch gestopt als de voorraad 0 is. Als je een advertentie wil stoppen moet je deze dus uitsluiten in Channable.