Alles over Fruugo

Fruugo: Verkooporders ophalen uit Fruugo

Haal orders van Fruugo op, met verzendadres, orderregels en prijzen, en stuur ze door naar je webshop of ERP. Fruugo levert de orders via een webhook.

Bijgewerkt op 9 november 2026

Deze flow haalt orders van Fruugo op en geeft ze als verkooporders door aan een andere applicatie, bijvoorbeeld je webshop of ERP. Gebruik deze flow om Fruugo-orders in je eigen systeem te verwerken.

Zo werkt het

Fruugo levert orders met een webhook, niet direct op een verzoek. Dat werkt zo:

  • APIcenter vraagt bij Fruugo orders aan, vanaf de datum in Use last order date.
  • Fruugo antwoordt alleen dat het verzoek is aangenomen. In de activiteit zie je dan de waarschuwing "Request accepted, waiting for response...". Dat is geen fout.
  • Fruugo stuurt de orders daarna met de webhook naar APIcenter. De flow verwerkt per melding maximaal het aantal orders van Amount to process. De overige orders uit die melding verwerkt de flow niet.
  • APIcenter kan een order ook los bij Fruugo opvragen, op ordernummer. Het antwoord komt dan ook met de webhook.

De webhook aanmaken

Zonder webhook ontvangt APIcenter geen orders van Fruugo.

  1. Open je integratie en ga naar de flow Verkooporders ophalen.
  2. Open het tabblad Webhooks en klik op Genereren.
  3. Kopieer de Webhook-URL met de kopieerknop.
  4. Geef deze URL aan Fruugo. Bij het aansluiten op de API vraagt Fruugo om een webhook-URL. Die geef je aan je integration specialist bij Fruugo.

Fruugo heeft geen API om een webhook automatisch te registreren. APIcenter maakt de URL dus wel aan, maar registreert hem niet bij Fruugo. Je kunt de webhook van Fruugo ook niet opnieuw genereren. Zie Webhooks van een flow voor het tabblad.

Wat de data mapping omvat

Standaard geeft APIcenter door:

  • Het ordernummer van Fruugo als ID en het ordernummer van de klant als orderreferentie.
  • De status van de order en de besteldatum.
  • De valuta en de taal van de klant.
  • Het e-mailadres van de klant, uit het verzendadres.
  • Het verzendadres: voornaam, achternaam, straat, postcode, plaats, land en telefoonnummer.
  • Per orderregel: de SKU, de naam, het product-ID, het aantal, de stukprijs inclusief btw, het btw-percentage en de valuta.

Andere gegevens van Fruugo zijn beschikbaar onder Data mapping, zoals de verzendkosten, de verzendmethode, de verzendingen, het aantal geannuleerde, bevestigde, verzonden en geretourneerde items, de btw-gegevens van Fruugo en de prijzen exclusief btw. Zie Data mapping.

Wat je eerst nodig hebt

  • Fruugo is gekoppeld. Zie Fruugo koppelen aan APIcenter.
  • De andere applicatie van de integratie kan verkooporders ontvangen.
  • De webhook-URL van de flow is aan Fruugo doorgegeven.

Tips

Hieronder vind je alle instellingen van deze flow, elk met een eigen uitleg.

Instellingen

De instellingen die je in het dashboard ziet, met wat elke instelling doet.

Bepaalt wat er gebeurt als een veld bij het mappen van de gegevens niet kan worden omgezet. Staat de instelling aan, dan stopt de flow met een foutmelding. Staat de instelling uit, dan gaat de flow verder en wordt dat veld overgeslagen. Standaard staat deze instelling aan.

Bepaalt wat er gebeurt met een waarde die niet in de mappingtabel staat. Bij Waarde negeren wordt de waarde weggelaten, bij Waarde gebruiken wordt de oorspronkelijke waarde gebruikt en bij Standaardwaarde gebruiken wordt de ingestelde standaardwaarde gebruikt. De instelling werkt alleen als File Header Mapping aan staat. De standaardkeuze is Standaardwaarde gebruiken.

Zet dit aan om een bestelling die APIcenter al eerder heeft verwerkt opnieuw door te laten als de combinatie van order-, betaal- en fulfilmentstatus nog niet eerder is verwerkt. Staat dit uit, dan slaat APIcenter een bestelling die al is verwerkt altijd over. De statussen komen uit de velden die je in de mapping aan de status koppelt. Standaard staat dit uit.

Hiermee codeer je de waarden in het adres (de URL) van de bronapplicatie, dus bij flows die gegevens ophalen. Dit werkt alleen als Enable URL encoding of data in endpoints aanstaat. Standaard staat dit uit.

Zet dit aan als er speciale tekens in de data staan die in het adres (de URL) van een verzoek terechtkomen, zoals in een SKU of categorienaam. De waarden worden dan URL-gecodeerd, zodat het verzoek niet misgaat. Met Enable URL Encoding of data in the endpoints of the source application en Enable URL Encoding of data in the endpoints of the target application bepaal je voor welke kant dit geldt. Standaard staat dit uit.

Use administration mapping table

General flow setting

Zet dit aan om de administratie om te zetten met een koppeltabel tussen de twee applicaties. Wat er gebeurt met een waarde die niet in de tabel staat, bepaal je met What to do with a value that cannot be mapped using the mapping table. Standaard staat dit uit.

Hier kies je wat er gebeurt met een administratie die niet in de koppeltabel staat. Bij Waarde negeren wordt de waarde leeggelaten, bij Waarde gebruiken blijft de oorspronkelijke waarde staan en bij Standaardwaarde gebruiken wordt de standaardwaarde uit Default administration id gebruikt, als je die hebt ingeschakeld. Deze instelling werkt alleen als Use administration mapping table aanstaat. Standaard is Standaardwaarde gebruiken gekozen.

Vul hier het e-mailadres in waarnaar APIcenter meldingen stuurt over mislukte activiteiten van deze flow. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan gebruikt APIcenter bij Direct het e-mailadres van je account. Er is geen standaardwaarde.

Notifications frequency

Notifications

Kies hoe vaak APIcenter meldt dat activiteiten van deze flow zijn mislukt. Bij Direct volgt de melding zodra een activiteit mislukt. Bij Elke 30 minuten, Elk uur, Dagelijks en Wekelijks stuurt APIcenter een overzicht van de mislukte activiteiten die nog niet gemeld zijn. Dit werkt alleen als Receive Notifications aan staat. Standaard is dit Direct.

Receive Notifications

Notifications

Zet dit aan om een melding te krijgen als een activiteit van deze flow mislukt. Met Notifications frequency bepaal je hoe vaak je de melding krijgt, en met Notifications Email address en Notifications Slack webhook waar die naartoe gaat. Standaard staat dit uit.

Amount to process

Run behaviour

Dit is het maximale aantal orders dat de flow uit één melding van Fruugo verwerkt. Bevat een melding meer orders, dan verwerkt de flow de overige niet. De standaardwaarde is 10.

Last execution time

Run behaviour

Hier staat het moment waarop de flow voor het laatst is gestart. APIcenter vult dit zelf in na elke run en gebruikt het om te bepalen wanneer de flow weer mag draaien. Je hoeft dit normaal niet te wijzigen. De standaardwaarde is 1980-01-01T00:00:01: de flow heeft dan nog niet gedraaid.

Dit is het maximale aantal pagina's dat de flow in één run ophaalt. Het aantal items per pagina stel je in bij Use page size. De standaardwaarde is 20.

Offset

Run behaviour

Dit is het aantal items dat de flow overslaat bij het ophalen. APIcenter werkt de waarde zelf bij na een run: is het aantal opgehaalde items gelijk aan Amount to process, dan wordt de waarde met dat aantal verhoogd, anders wordt hij teruggezet. Wijzig dit alleen als je de flow opnieuw vanaf een bepaald punt wilt laten ophalen. De standaardwaarde is 0.

Run at specific times

Run behaviour

Hier kies je vaste tijden van de dag waarop de flow ook moet starten. Je kunt meerdere tijden kiezen, in stappen van 15 minuten. Er is geen standaardwaarde.

Use last order date

Run behaviour

Dit is de laatste besteldatum die APIcenter heeft gezien. De flow stuurt deze datum als begindatum mee als hij orders bij Fruugo aanvraagt. Fruugo levert de orders daarna met de webhook. APIcenter werkt de datum zelf bij na elke run. Zet je de datum terug, dan vraagt de flow orders vanaf die datum opnieuw aan.

Use page size

Run behaviour

Dit is het aantal items dat de flow per API-verzoek ophaalt. Samen met Maximum number of pages to retrieve bepaalt dit hoeveel items één run kan ophalen. De standaardwaarde is 50.

Nog vragen?

Stel je vraag aan de supportassistent in je dashboard of maak een supportticket aan.

Naar support