Een eBay API opzetten – 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

In de Opbouw stap vind je ons standaard template voor de productadvertenties. Het enige wat je hoeft te doen is de velden aanklikken en de benodigde informatie invullen. Het veld 'Title' moet bijvoorbeeld overeenkomen met de titel van je producten.

Het 'Item group ID' veld wordt gebruikt om meerdere items te combineren in 1 advertentie. Selecteer hier het veld dat het groeps- of parent-ID van je producten bevat. Later in de Attributen stap kun je velden selecteren om de varianten van gegroepeerde producten in te stellen.

Als je een eBay winkeleigenaar (eBay Store Owner) bent, moet je ook de 'Categorie ID winkel' en 'Categorie naam winkel' velden invullen. Als je dit niet bent 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.