IberLibro koppelen aan RUIT

In deze tutorial koppel je je boekhandel op IberLibro aan RUIT. IberLibro koppel je met drie gegevens uit je account als verkoper: je gebruikers-ID, een API-sleutel en het adres van je boekhandel. Je hoeft geen extensie te installeren en geen browser open te laten. Het duurt vijf minuten en je doet het maar één keer.

Je hebt nodig een goedgekeurd account als verkoper bij IberLibro, dat hetzelfde account is als bij AbeBooks, en een geverifieerde telefoon, want zonder die verificatie gaat het venster om een account te koppelen niet open.

1. Kopieer je gebruikers-ID

IberLibro is een Spaanse site en het menu staat in het Spaans, dus hier staan de opties zoals je ze op het scherm ziet, met hun betekenis erbij. Ga in het ledenmenu van IberLibro naar Mi información personal (mijn persoonlijke gegevens) en open Información de mi cuenta (gegevens van mijn account). Druk op Detalles de su librería (gegevens van je boekhandel): onderaan de pagina staat het veld ID de usuario (gebruikers-ID). Kopieer de ID: die staat altijd in hoofdletters en zonder spaties.

2. Maak je API-sleutel aan

De sleutel maak je aan in de tool voor API-sleutels van AbeBooks, waar je met hetzelfde account inlogt. De handleiding van IberLibro, in het Spaans, linkt naar die tool. Druk daar op Generate New Key en kies het type Classic (hashed key). Vink allebei de diensten aan, Inventory Update API en Order Update API, geef de sleutel het label Ruit - Third-Party Integrator en druk op Generate. Kopieer de sleutel meteen: hij wordt maar één keer getoond.

3. Kopieer het adres van je boekhandel

Open IberLibro, ga naar je boekhandel, blader door je boeken en kopieer wat er in de adresbalk van je browser staat. Het lijkt op https://www.iberlibro.com/buscar-libro/vi/12345678/, met het nummer van jouw boekhandel in plaats van dat nummer. Op welke pagina je staat of welke sortering je gekozen hebt, maakt niet uit. Het adres van je etalage, dat op /sf eindigt, is ook goed, net als dat van de link Buscar en los libros de esta librería (zoeken in de boeken van deze boekhandel).

4. Koppel het account in RUIT

Ga naar Instellingen → Accounts, druk op Account koppelen en kies IberLibro. Plak de ID bij Gebruikers-ID (client PIN), de sleutel bij API-sleutel en het adres bij Link naar je winkel, en druk op Koppelen.

RUIT test de gegevens meteen door IberLibro om je openstaande bestellingen te vragen, dus je weet direct of er iets verkeerd gekopieerd is.

Wat je hebt bereikt

Je boekhandel staat bij Gekoppelde accounts als IberLibro gevolgd door je gebruikers-ID, met het label Bèta. De gegevens verlopen niet, dus de kaart heeft niet de knop Opnieuw koppelen die Wallapop en Vinted wel hebben: de koppeling blijft bestaan tot je bij AbeBooks een nieuwe sleutel aanmaakt.

Volgende stap: je catalogus uploaden met de export van HomeBase, of je eerste advertentie.

Als iets niet klopt

• «Dat adres is je boekhandel op AbeBooks, niet op IberLibro». Je hebt het adres van abebooks.com geplakt. Open dezelfde boekhandel op iberlibro.com en plak dat adres.
• «We hebben de id van je boekhandel niet in dat adres gevonden». Het adres is niet dat van een boekhandel, maar bijvoorbeeld de startpagina van IberLibro of de pagina van een boek. Ga terug naar stap 3.
• «Verifiëren van de inloggegevens is mislukt. Controleer je API-sleutels en winkel-URL». IberLibro heeft de ID of de sleutel niet geaccepteerd. Controleer of de ID in hoofdletters en zonder spaties staat en of bij de sleutel allebei de diensten zijn aangevinkt. Twijfel je aan de sleutel, maak dan in stap 2 een nieuwe aan.
• Je had een ander programma aan IberLibro gekoppeld en dat werkt niet meer. Dat komt door de nieuwe sleutel uit stap 2: geef dat programma ook de sleutel die je net hebt aangemaakt.