# IberLibro koppelen aan RUIT

Tutorial om IberLibro te koppelen: kopieer je gebruikers-ID, maak de API-sleutel aan bij AbeBooks en plak ze in RUIT, samen met het adres van je boekhandel.

_Updated: 2026-09-29 · Source: https://ruit.es/nl/docs/iberlibro-koppelen/_

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](https://ruit.es/nl/docs/je-telefoon-verifieren/), want zonder die
verificatie gaat het venster om een account te koppelen niet open.

> **Opmerking:** IberLibro is **in bèta** in RUIT: het venster om te koppelen meldt dat en de kaart van het account
> heeft het label **Bèta**. De koppeling kan mislukken of zich onverwacht gedragen; zie je iets
> vreemds, schrijf ons dan.

## 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.

_Schermafbeelding: Het veld Su ID de usuario in het account van een verkoper bij IberLibro, met de toelichting dat dit de ID is die nodig is voor de toegang via FTP en voor de API_

Het veld zoals het Spaanse helpcentrum van IberLibro het toont. Het kader wijst `Su ID de usuario`
(je gebruikers-ID) aan.

## 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](https://www.soporte.iberlibro.com/buying/s/article/find-my-API-key?language=es),
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.

> **Waarschuwing:** Vink je maar één dienst aan, dan werkt de sleutel niet voor de andere. En heb je al een ander
> programma aan IberLibro gekoppeld, dan **verbreekt een nieuwe sleutel de koppeling van dat
> programma**: je moet het dan de nieuwe sleutel geven.

> **Opmerking:** De sleutel haal je op `abebooks.com`, ook al moet het adres van je boekhandel dat van
> `iberlibro.com` zijn. Het is hetzelfde account onder twee namen.

## 3. Kopieer het adres van je boekhandel

Open [IberLibro](https://www.iberlibro.com/), 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).

> **Waarschuwing:** Het moet een adres van `iberlibro.com` zijn. Een adres van `abebooks.com` of `zvab.com` werkt niet,
> ook al is het dezelfde boekhandel, en RUIT weigert het bij het koppelen.

## 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**.

_Schermafbeelding: Het venster om IberLibro te koppelen in RUIT: de melding dat IberLibro in bèta is, de link naar deze handleiding, de velden voor de gebruikers-ID, de API-sleutel en de link naar de winkel, en de knoppen om te annuleren en te koppelen_

Het IberLibro-venster. De nummers wijzen **Gebruikers-ID (client PIN)**, **API-sleutel** en
**Link naar je winkel** aan.

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](https://ruit.es/nl/docs/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.

- [Verkopen op IberLibro met RUIT](https://ruit.es/nl/docs/marketplaces/)
- [Hoe het koppelen van een account werkt](https://ruit.es/nl/docs/hoe-het-koppelen-van-een-account-werkt/)