Browse all articles

Billbee koppelen

Last updated

Koppel Billbee aan ChannelDock

Billbee is een multichannel orderbeheerplatform dat veel wordt gebruikt door verkopers in Duitsland, Oostenrijk en Zwitserland. Met de ChannelDock-integratie (momenteel in Beta) stuurt u orders van ChannelDock naar Billbee voor fulfillment, kunt u optioneel voorraad en producten uit Billbee importeren, en ontvangt u tracking terug in ChannelDock.

Deze integratie vindt u onder Connections → Other — niet onder Sales channels.

Hoe deze koppeling werkt

  • Orders met status order of backorder in ChannelDock worden gesynchroniseerd naar Billbee.
  • ChannelDock maakt orders aan in Billbee met uw ChannelDock-bestelnummer als externe referentie.
  • Wanneer een order in Billbee wordt verzonden, wordt tracking teruggesynchroniseerd naar ChannelDock en wordt de order afgerond in het oorspronkelijke verkoopkanaal.
  • Wanneer een order in Billbee wordt geannuleerd, wordt deze ook geannuleerd in ChannelDock.
  • Voorraadniveaus kunnen optioneel van Billbee naar ChannelDock worden gesynchroniseerd (standaard uitgeschakeld).
  • Nieuwe producten kunnen op basis van EAN van Billbee naar ChannelDock worden geïmporteerd.

Voordat u koppelt

U heeft het volgende nodig in Billbee en ChannelDock:

In Billbee

  1. Log in op Billbee.
  2. Ga naar Instellingen → Billbee API (of Instellingen → Systeem → Billbee API).
  3. Schakel API-toegang in op het tabblad Algemene instellingen.
  4. Stel een API-wachtwoord in. Billbee vereist een sterk wachtwoord:
    • Minimaal 12 tekens
    • Minimaal één hoofdletter, één kleine letter, één cijfer en één speciaal teken (!@$%^&*+#)
    • Gebruik geen dubbele punt (:) in het wachtwoord — dit veroorzaakt authenticatiefouten
  5. Sla uw instellingen op.

U heeft ook een Billbee API-sleutel nodig voor de applicatie. Deze wordt verzonden als HTTP-header X-Billbee-Api-Key. Vraag er een aan bij Billbee als u die nog niet heeft — zie de Billbee API-documentatie.

Gebruikersnaam voor de koppeling

  • Voor het hoofdaccount gebruikt u het e-mailadres waarmee uw Billbee-account is geregistreerd.
  • Voor een medewerkersaccount gebruikt u de Billbee-gebruikersnaam van die medewerker.

In ChannelDock

  • Koppel eerst uw verkoopkanalen (Shopify, bol.com, Amazon, enz.) zodat orders in ChannelDock kunnen binnenkomen voordat ze naar Billbee worden doorgestuurd.

Billbee koppelen aan ChannelDock

  1. Log in op uw ChannelDock-account.

  2. Ga naar Connections → Other.

    Other integrations-pagina

  3. Klik op het Billbee-logo (gemarkeerd als Beta).

    Billbee-integratie tegel

  4. Vul het koppelformulier in:

    • Billbee API Key — uw applicatie-API-sleutel (verzonden als X-Billbee-Api-Key).
    • Billbee username/email — uw Billbee-login e-mail of medewerkersgebruikersnaam.
    • Billbee API password — het API-wachtwoord dat u in Billbee heeft ingesteld (niet uw gewone loginwachtwoord).

    Billbee-koppelvenster

  5. Klik op Connect Billbee.

ChannelDock valideert uw gegevens via de Billbee API. Als de koppeling slaagt, verschijnt Billbee in uw lijst met Other integrations.

Billbee gekoppeld onder Other integrations

API-instellingen configureren

Klik na het koppelen op het instellingen-icoon in de Billbee-rij om Edit API settings te openen:

Billbee API-instellingen

Controleer en configureer:

Instelling Beschrijving
Billbee stock sync Uit (standaard), EAN of SKU. Indien ingeschakeld worden voorraadniveaus uit Billbee gelezen en bijgewerkt in ChannelDock voor overeenkomende producten.
Stock ID (optional) Indien ingevuld leest ChannelDock voorraad uit deze specifieke Billbee-voorraadlocatie in plaats van de standaard.
Send orders from these sales channels Selecteer van welke gekoppelde verkoopkanalen orders naar Billbee moeten worden doorgestuurd. Laat leeg om geen orders te versturen.

Sla uw instellingen op na wijzigingen.

Orderflow

De typische workflow ziet er als volgt uit:

  1. Een klant plaatst een order op een gekoppeld verkoopkanaal (bijvoorbeeld Shopify of bol.com).
  2. De order wordt geïmporteerd in ChannelDock met status order.
  3. Als het verkoopkanaal van de order is geselecteerd onder Send orders from these sales channels, stuurt ChannelDock de order door naar Billbee.
  4. ChannelDock gebruikt uw ChannelDock-bestelnummer als orderreferentie in Billbee.
  5. U verwerkt de order in Billbee (pick, pack, ship).
  6. Wanneer de order in Billbee wordt verzonden, ontvangt ChannelDock het trackingnummer en rondt de order af in het oorspronkelijke verkoopkanaal.
  7. Als de order in Billbee wordt geannuleerd, wordt deze ook geannuleerd in ChannelDock.

Alleen orders met status order of backorder worden naar Billbee doorgestuurd. Orders die al zijn gesynchroniseerd worden niet opnieuw verzonden.

Voorraadsynchronisatie (optioneel)

Voorraadsynchronisatie is standaard uitgeschakeld. Om deze in te schakelen:

  1. Open de Billbee-integratie-instellingen in ChannelDock.
  2. Stel Billbee stock sync in op EAN of SKU.
  3. Stel optioneel een Stock ID in als u meerdere voorraadlocaties in Billbee gebruikt.
  4. Sla uw instellingen op.

ChannelDock koppelt producten tussen Billbee en ChannelDock via het geselecteerde veld (EAN of SKU). Alleen producten met een overeenkomende identifier in beide systemen worden bijgewerkt.

Voorraadwijzigingen verschijnen in het voorraadlogboek van ChannelDock als Billbee stock update-gebeurtenissen.

Productimport

ChannelDock kan nieuwe producten uit Billbee importeren die nog niet in ChannelDock bestaan. Producten worden gematcht en aangemaakt op basis van EAN. Bestaande producten met dezelfde EAN worden overgeslagen.

Geïmporteerde producten bevatten titel, SKU, EAN, voorraad, prijs, afbeelding-URL en afmetingen waar beschikbaar in Billbee.

Probleemoplossing

Koppeling mislukt of gegevens worden geweigerd

  • Controleer of API-toegang is ingeschakeld in Billbee onder Instellingen → Billbee API.
  • Vul alle drie de velden in: API Key, username/email en API password.
  • Gebruik uw API-wachtwoord, niet uw gewone Billbee-loginwachtwoord.
  • Controleer of uw API-wachtwoord voldoet aan de Billbee-eisen en geen dubbele punt (:) bevat.
  • Controleer of uw Billbee API-sleutel geldig en actief is.

Orders worden niet naar Billbee verstuurd

  • Open de Billbee-integratie-instellingen en controleer Send orders from these sales channels. U moet minimaal één verkoopkanaal selecteren — als de lijst leeg is, worden geen orders doorgestuurd.
  • Controleer of de orderstatus in ChannelDock order of backorder is.
  • Controleer of de order niet al naar Billbee is gesynchroniseerd (zoek naar Billbee-gerelateerde vermeldingen in het orderlogboek).

Voorraad synchroniseert niet vanuit Billbee

  • Zorg dat Billbee stock sync is ingesteld op EAN of SKU — standaard staat dit uit.
  • Controleer of overeenkomende EAN’s of SKU’s op producten in zowel Billbee als ChannelDock staan.
  • Als u meerdere voorraadlocaties in Billbee gebruikt, probeer dan de juiste Stock ID in te stellen.

Tracking synchroniseert niet terug naar ChannelDock

  • Controleer of de order in Billbee is verzonden en een trackingnummer of tracking-URL heeft.
  • Controleer het orderlogboek in ChannelDock op Billbee-verzendgebeurtenissen.
  • Geef de synchronisatiejob tijd om te draaien — statusupdates worden periodiek opgehaald uit Billbee.

Hulp nodig?

Als u problemen ondervindt met de Billbee-integratie, neem contact op met ons supportteam via de supportpagina in uw ChannelDock-account. Voeg de naam van uw Billbee-koppeling, een beschrijving van het probleem en eventuele foutmeldingen toe.

Was this helpful?

Related articles