Alles over Shopify

Shopify: Verkooporders naar Shopify sturen

Stuur bestellingen uit je ERP of ander verkoopkanaal naar Shopify, als bestelling of als conceptbestelling. APIcenter maakt of zoekt ook de klant.

Bijgewerkt op 9 november 2026

Deze flow stuurt verkooporders uit een andere applicatie, zoals een ERP of marktplaats, naar Shopify. APIcenter maakt de order aan in Shopify, als bestelling of als conceptbestelling.

Zo wordt een order verwerkt

  1. Elke order heeft een referentie nodig. Zonder referentie mislukt de order.
  2. APIcenter controleert de instelling Send Order as. Je kunt Order (standaard) of Draft Order kiezen. Bij een andere waarde mislukt de order.
  3. Bij Order maakt APIcenter een bestelling aan met de referentie als bronreferentie (sourceIdentifier).
  4. Bij Draft Order maakt APIcenter een conceptbestelling aan. Met Make from a a draft order a finalized order rondt APIcenter de conceptbestelling direct af, zodat er een bestelling van wordt gemaakt. Dat gebeurt met betaling in afwachting, tenzij de gegevens iets anders zeggen. Staat de instelling uit, dan blijft het een conceptbestelling en meldt het flowresultaat dat afronden is overgeslagen.
  5. Na het aanmaken haalt APIcenter de orderregels op en geeft die door in het resultaat.

De klant

  • Heeft de order een klant-ID in Shopify, dan gebruikt APIcenter die klant.
  • Heeft de order geen klant-ID, dan heeft de klant een e-mailadres nodig. APIcenter zoekt de klant dan op e-mailadres en maakt de klant aan als die niet bestaat. Bestaat de klant al, dan werkt APIcenter de klant alleen bij als de instellingen voor bijwerken aanstaan. Zie Klanten naar Shopify sturen.
  • Met Create customers as guests maakt APIcenter geen klant aan en koppelt APIcenter de order niet aan een klant.

Bestaande orders bijwerken

  • Staat Update order aan, dan zoekt APIcenter eerst een bestelling in Shopify waarvan de naam of de bronreferentie gelijk is aan de referentie. Is die er, dan werkt APIcenter alleen de eigen velden bij: aangepaste attributen, e-mailadres, lokale velden, notitie, PO-nummer, verzendadres, tags en metafields. Orderregels en bedragen worden niet bijgewerkt.
  • Staat de instelling uit, of is er geen bestelling met die referentie, dan maakt APIcenter een nieuwe bestelling aan. Bij Draft Order zoekt APIcenter geen bestaande order.
  • Standaard staat Update order uit.

Orderregels en prijzen

  • Elke orderregel heeft een aantal nodig.
  • Heeft een orderregel een kortingsbedrag, dan stuurt APIcenter dat als vast bedrag mee.
  • Je kunt kosten als aparte orderregel toevoegen, bijvoorbeeld Require order line for shipping costs. Vul dan ook de code van die regel in, anders mislukt de flow.
  • Negatieve bedragen zet APIcenter standaard om naar positieve bedragen. Met Skip negativity flip process slaat APIcenter die omzetting over.

Wat je eerst nodig hebt

  • Shopify is gekoppeld. Zie Shopify koppelen aan APIcenter.
  • De andere applicatie van de integratie kan verkooporders versturen, met een referentie, orderregels met aantallen en bij voorkeur de klant met een e-mailadres.
  • De app in Shopify heeft toegang tot bestellingen, conceptbestellingen en klanten (read_orders, write_orders, read_draft_orders, write_draft_orders, read_customers en write_customers).

Tips

  • Mislukt een order met een melding over de bestelling? Kijk in de activiteit: de fouten van Shopify staan bij userErrors.
  • Wil je extra velden op de bestelling, zoals notities of metafields? Voeg ze toe onder Data mapping. Zie Data mapping.

Je vindt alle instellingen van deze flow hieronder, elk met een eigen uitleg.

Instellingen

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

Create customers as guests

Customer Settings

Met deze instelling behandelt APIcenter de klant als gast in plaats van als vaste klant. Er wordt dan geen klantaccount aangemaakt of opgezocht in de doelapplicatie. Zet dit aan als bestellingen van gasten moeten worden verwerkt. Standaard staat deze instelling uit.

Zet dit aan om een standaard betalingstermijn te gebruiken. Vul daarna de waarde in bij default payment terms id. Zonder deze instelling gebruikt APIcenter geen standaardwaarde. Standaard staat dit uit.

Gebruikt een mappingtabel om het betalingstermijn-id om te zetten tussen het bronsysteem en het doelsysteem. Zet dit aan als de betalingstermijnen in beide systemen een andere waarde hebben. Vul daarna de mappingtabel in. 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 deze instelling uit.

Vul hier de waarde in van de klantgroep, zoals het doelsysteem die herkent (meestal het id). APIcenter gebruikt deze waarde alleen als Enable use of a default customer group aan staat. Heeft de klantgroep in de gegevens al een waarde, dan blijft die staan, tenzij Force the usage of the default customer group aan staat. Er is geen standaardwaarde.

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 Use default payment terms id mapping table aan staat. De standaardkeuze is Standaardwaarde gebruiken.

default payment terms id

Customer Settings

Vul hier de waarde in van de betalingstermijn, zoals het doelsysteem die herkent (meestal het id). APIcenter gebruikt deze waarde alleen als Make use of a default payment terms id aan staat. Heeft de betalingstermijn in de gegevens al een waarde, dan blijft die staan, tenzij Force the usage of the default payment terms aan staat. Er is geen standaardwaarde.

Hiermee codeer je de waarden in het adres (de URL) van de doelapplicatie, dus bij flows die gegevens versturen. 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 de waarde in die APIcenter standaard gebruikt voor de btw-code voor verkoop van de klant, zoals die in de applicatie bestaat. De waarde wordt alleen gebruikt als Enable the use of a default customer sales vat code id aan staat. Staat die instelling aan en is hier niets ingevuld, dan geeft APIcenter hiervan een melding.

Zet dit aan om een standaardwaarde te gebruiken voor de btw-code voor verkoop van de klant. APIcenter vult dan de waarde uit Default customer sales vat code id in wanneer de gegevens zelf geen waarde bevatten. Wil je de standaardwaarde ook gebruiken als er wel een waarde is, gebruik dan Force the usage of the customer sales vat code id. Standaard staat deze instelling uit.

Zet dit aan om altijd de standaardwaarde uit Default customer sales vat code id te gebruiken voor de btw-code voor verkoop van de klant, ook als de gegevens zelf al een waarde bevatten. Staat dit uit, dan is de standaardwaarde alleen een terugval voor als er geen waarde in de gegevens staat. Deze instelling werkt samen met Enable the use of a default customer sales vat code id. Standaard staat deze instelling uit.

Zet dit aan om de waarde voor de btw-code voor verkoop van de klant in de gegevens om te zetten met een mappingtabel. Je vult de mappingtabel zelf in. 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 deze instelling uit.

Hier kies je wat er gebeurt met een waarde die niet in de koppeltabel van Use default customer sales vat code id mapping table staat. Bij Waarde gebruiken blijft de oorspronkelijke waarde staan en bij Waarde negeren wordt de waarde weggelaten. Bij Standaardwaarde gebruiken wordt de standaardwaarde gebruikt die je hebt ingesteld. De standaardwaarde is Standaardwaarde gebruiken.

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.

Vul hier de Slack-webhook van je Slack-werkruimte in om meldingen over mislukte activiteiten ook in Slack te ontvangen. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan stuurt APIcenter geen Slack-melding. 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.

Zet dit aan om de factuurkosten van de order als aparte orderregel toe te voegen. APIcenter doet dit alleen als de order een bedrag aan factuurkosten heeft. Vul daarna Default item code for billing costs in, anders mislukt de flow. Standaard staat dit uit.

Zet dit aan om de commissie van de order als aparte orderregel toe te voegen. APIcenter doet dit alleen als de order een commissiebedrag heeft. Vul daarna Default item code for commission in, anders mislukt de flow. Standaard staat dit uit.

Zet dit aan om de betaalkosten van de order als aparte orderregel toe te voegen. APIcenter doet dit alleen als de order een bedrag aan betaalkosten heeft. Vul daarna Default item code for Payment Costs in, anders mislukt de flow. Standaard staat dit uit.

Vul hier de artikelcode in die APIcenter gebruikt voor de orderregel met betaalkosten. De code moet bestaan in de applicatie waarnaar je verstuurt. Dit is nodig als Add order line for payment costs aan staat. Er is geen standaardwaarde.

Vul hier de artikelcode in die APIcenter gebruikt voor de orderregel met factuurkosten. De code moet bestaan in de applicatie waarnaar je verstuurt. Dit is nodig als Add order line for billing costs aan staat. Er is geen standaardwaarde.

Vul hier de artikelcode in die APIcenter gebruikt voor de orderregel met commissie. De code moet bestaan in de applicatie waarnaar je verstuurt. Dit is nodig als Add order line for commission aan staat. Er is geen standaardwaarde.

Vul hier de artikelcode in die APIcenter gebruikt voor de orderregel met verzendkosten. De code moet bestaan in de applicatie waarnaar je verstuurt. Dit is nodig als Require order line for shipping costs aan staat. Er is geen standaardwaarde.

Default order prefix

Order Settings

Vul hier een tekst in die APIcenter vooraan zet bij de ordernummer- of orderreferentie. Laat je het veld leeg, dan blijft de waarde ongewijzigd. Dit werkt als de mapping van de orderreferentie de functie voor het voorvoegsel gebruikt. Er is geen standaardwaarde.

Default order suffix

Order Settings

Vul hier een tekst in die APIcenter achteraan zet bij de waarde die je in de mapping aan de orderreferentie koppelt. Laat je het veld leeg, dan blijft de waarde ongewijzigd. Dit werkt als de mapping van de orderreferentie de functie voor het achtervoegsel gebruikt. Er is geen standaardwaarde.

Vul hier de belastingklasse in voor de orderregel met factuurkosten. Laat je het veld leeg, dan gebruikt APIcenter de waarde van Value for the default tax id (exclude '%'). In beide gevallen past APIcenter de regels voor de standaard belastingklasse toe, inclusief de mappingtabel. Dit werkt alleen als Add order line for billing costs aan staat.

Vul hier de belastingklasse in voor de orderregel met commissie. Laat je het veld leeg, dan gebruikt APIcenter de waarde van Value for the default tax id (exclude '%'). In beide gevallen past APIcenter de regels voor de standaard belastingklasse toe, inclusief de mappingtabel. Dit werkt alleen als Add order line for commission aan staat.

Vul hier de belastingklasse in voor de orderregel met betaalkosten. Laat je het veld leeg, dan gebruikt APIcenter de waarde van Value for the default tax id (exclude '%'). In beide gevallen past APIcenter de regels voor de standaard belastingklasse toe, inclusief de mappingtabel. Dit werkt alleen als Add order line for payment costs aan staat.

Vul hier de belastingklasse in voor de orderregel met verzendkosten. Laat je het veld leeg, dan gebruikt APIcenter de waarde van Value for the default tax id (exclude '%'). In beide gevallen past APIcenter de regels voor de standaard belastingklasse toe, inclusief de mappingtabel. Dit werkt alleen als Require order line for shipping costs aan staat.

Vul hier de omschrijving in voor de orderregel met factuurkosten. Laat je het veld leeg, dan zet APIcenter geen eigen omschrijving op de regel. Dit werkt alleen als Add order line for billing costs aan staat. Er is geen standaardwaarde.

Vul hier de omschrijving in voor de orderregel met commissie. Laat je het veld leeg, dan zet APIcenter geen eigen omschrijving op de regel. Dit werkt alleen als Add order line for commission aan staat. Er is geen standaardwaarde.

Vul hier de omschrijving in voor de orderregel met betaalkosten. Laat je het veld leeg, dan zet APIcenter geen eigen omschrijving op de regel. Dit werkt alleen als Add order line for payment costs aan staat. Er is geen standaardwaarde.

Vul hier de omschrijving in voor de orderregel met verzendkosten. Laat je het veld leeg, dan zet APIcenter geen eigen omschrijving op de regel. Dit werkt alleen als Require order line for shipping costs aan staat. Er is geen standaardwaarde.

Deze instelling werkt alleen als je bij Send Order as de keuze Draft Order hebt gemaakt. APIcenter rondt de conceptbestelling dan direct af en maakt er een bestelling van, met betaling in afwachting tenzij de gegevens iets anders zeggen. Staat de instelling uit, dan blijft het een conceptbestelling en meldt het flowresultaat dat afronden is overgeslagen. Bij Order heeft de instelling geen effect. Standaard staat de instelling uit.

Zet dit aan om de verzendkosten van de order als aparte orderregel toe te voegen. APIcenter doet dit alleen als de order een bedrag aan verzendkosten heeft. Vul daarna Default item code to use for shipping cost order line in, anders mislukt de flow. Standaard staat dit uit.

Send Order as

Order Settings

Bepaalt hoe APIcenter de order in Shopify aanmaakt: als Order, een gewone bestelling, of als Draft Order, een conceptbestelling. Kies Draft Order als de bestelling in Shopify nog gecontroleerd of afgerond moet worden, bijvoorbeeld met Make from a a draft order a finalized order. Een andere waarde geeft een foutmelding. De standaardkeuze is Order.

Update order

Order Settings

Zet dit aan om bestaande bestellingen in Shopify bij te werken. APIcenter zoekt een bestelling waarvan de naam of de bronreferentie gelijk is aan de orderreferentie. Daarbij werkt APIcenter alleen deze velden bij: aangepaste attributen, e-mailadres, lokale velden, notitie, PO-nummer, verzendadres, tags en metafields. Orderregels en bedragen worden niet bijgewerkt. Staat dit uit, of vindt APIcenter geen bestelling, dan maakt APIcenter een nieuwe bestelling aan. Dit werkt niet bij Draft Order. Bij Shopify staat deze instelling standaard uit.

Skip negativity flip process

Product Settings

Standaard zet APIcenter negatieve bedragen bij prijzen, kortingen en belasting om naar positieve bedragen. Bedragen inclusief en exclusief belasting worden dan ook omgewisseld als de belasting negatief is. Zet je deze instelling aan, dan slaat APIcenter deze omzetting over en blijven negatieve waarden negatief. De standaardwaarde is uit.

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.

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.

Zet deze instelling aan om een standaard verzendmethode te gebruiken. De waarde vul je in bij Value to use as the default shipping method id. Met Force the use of the default shipping method bepaal je of deze altijd wordt gebruikt of alleen als de bron geen verzendmethode meegeeft. De standaardwaarde is uit.

Hiermee bepaal je wanneer de standaard verzendmethode wordt gebruikt. Staat de instelling aan, dan wordt altijd de standaard verzendmethode gebruikt. Staat de instelling uit, dan wordt alleen de standaard gebruikt als de gegevens uit de bronapplicatie geen verzendmethode bevatten. Dit werkt alleen als Enable the use of a default shipping method aan staat. De standaardwaarde is uit.

Zet deze instelling aan om verzendmethoden uit de bronapplicatie via een toewijzingstabel om te zetten naar verzendmethoden van de doelapplicatie. Je vult de toewijzingstabel zelf in. 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. Er is geen standaardwaarde.

Hier vul je de waarde in die als standaard verzendmethode wordt gebruikt. Dit is het id van de verzendmethode in de doelapplicatie. De waarde wordt gebruikt als Enable the use of a default shipping method aan staat. Staat die aan en is hier niets ingevuld, dan geeft APIcenter een melding. Er is geen standaardwaarde.

Hiermee bepaal je wat er gebeurt met een verzendmethode die niet in de toewijzingstabel staat. Bij Waarde gebruiken wordt de oorspronkelijke waarde gebruikt. Bij Waarde negeren wordt de waarde weggelaten. Bij Standaardwaarde gebruiken wordt de standaardwaarde gebruikt. De standaardwaarde van deze instelling is Standaardwaarde gebruiken.

Enable the use of a default warehouse

Stock & Warehouse Settings

Bij Shopify is een magazijn een locatie. Zet dit aan om een standaardlocatie te gebruiken voor voorraad die geen locatie heeft. Vul de locatie in bij Set the default location for your stock. Standaard staat dit uit.

Force the usage of the default warehouse

Stock & Warehouse Settings

Bij Shopify is een magazijn een locatie. Zet dit aan om altijd de locatie van Set the default location for your stock te gebruiken, ook als de gegevens een andere locatie bevatten. Dit werkt alleen als Make use of a default Location for your stock aan staat. Standaard staat dit uit.

Use warehouse mapping table

Stock & Warehouse Settings

Bij Shopify is een magazijn een locatie. Zet aan om de locatie uit de gegevens met een mappingtabel om te zetten naar een locatie in Shopify. Wat er gebeurt met een waarde die niet in de tabel staat, bepaal je met When the location is not mappable or doesnt exist what do you want to do with the data. Standaard staat dit uit.

Value for the default warehouse id

Stock & Warehouse Settings

Bij Shopify is een magazijn een locatie. Vul hier het ID van de locatie in Shopify in. APIcenter gebruikt deze waarde als Make use of a default Location for your stock aan staat en de gegevens geen locatie hebben. Met Force to use the default Location gebruikt APIcenter deze locatie ook als er wel een locatie in de gegevens staat. APIcenter kan de locaties van je Shopify-winkel ophalen.

Hiermee bepaal je wat er gebeurt met een magazijn die niet in de mappingtabel staat. Bij Waarde negeren wordt de waarde weggelaten. Bij Waarde gebruiken blijft de oorspronkelijke waarde staan. Bij Standaardwaarde gebruiken gebruikt APIcenter de standaardwaarde uit Set the default location for your stock, als Make use of a default Location for your stock aan staat; anders blijft de waarde leeg. Standaard is dit Standaardwaarde gebruiken.

Zet aan om een standaard btw-code te gebruiken. APIcenter vult die dan in als de gegevens geen btw-code hebben. De waarde stel je in bij Value for the default tax id (exclude '%'). Standaard staat de instelling uit.

Zet aan om altijd de standaard btw-code te gebruiken, ook als de gegevens al een waarde hebben. Staat de instelling uit, dan gebruikt APIcenter de standaardwaarde alleen als de gegevens geen waarde hebben. Deze instelling hoort bij Enable the use of a default tax id. Standaard staat hij uit.

Zet aan om de btw-code uit de gegevens om te zetten met een mappingtabel. APIcenter zoekt de waarde op in de tabel. Wat er gebeurt als een btw-code niet in de tabel staat, bepaal je met What to do with a value that cannot be mapped using the mapping table. Standaard staat de instelling uit.

Hier vul je de standaard btw-code in, zonder het %-teken. APIcenter zet deze waarde in het btw-codeveld, als Enable the use of a default tax id aan staat en de gegevens geen btw-code hebben. Met Force the use of the default tax id gebruikt APIcenter deze waarde ook als er wel een btw-code is.

Hiermee bepaal je wat er gebeurt met een btw-code die niet in de mappingtabel staat. Bij Waarde negeren wordt de waarde weggelaten. Bij Waarde gebruiken blijft de oorspronkelijke waarde staan. Bij Standaardwaarde gebruiken gebruikt APIcenter de standaardwaarde uit Value for the default tax id (exclude '%'), als Enable the use of a default tax id aan staat; anders blijft de waarde leeg. Standaard is dit Standaardwaarde gebruiken.

Nog vragen?

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

Naar support