Alles over Shopware 6.4 and above
Shopware: Prijslijsten naar Shopware sturen
Stuur prijzen en staffelprijzen per klantgroep naar Shopware. APIcenter maakt ontbrekende klantgroepen en prijsregels aan.
Bijgewerkt op 9 november 2026
Deze flow zet prijzen in Shopware per klantgroep, met staffelprijzen per aantal. Gebruik deze flow als een ander systeem de prijslijsten beheert.
Zo werkt het
- Voor elke prijsregel moet de klantgroep, de valuta, de bruto prijs en de netto prijs gevuld zijn. Daarnaast moet de flow het productnummer van het product of van de variant krijgen. Is een variantnummer aanwezig, dan gebruikt APIcenter dat. Anders gebruikt het het productnummer van het product.
- Bestaat het product niet in Shopware, dan geeft de flow een fout. De flow maakt geen producten aan.
- APIcenter zoekt de klantgroepen op naam in Shopware en maakt klantgroepen aan die ontbreken.
- Voor elke klantgroep gebruikt APIcenter een prijsregel (rule) in Shopware met de naam
APIcenter-price-list-gevolgd door het ID van de klantgroep. Bestaat die regel niet, dan maakt APIcenter hem aan met de voorwaarde dat de klant in die klantgroep zit. - APIcenter verwijdert eerst de bestaande prijzen van het product die bij deze regels horen. Daarna schrijft het de prijzen uit de gegevens. Prijzen die je zelf in Shopware bij andere regels hebt gezet, blijven staan.
- De valuta zoekt APIcenter op ISO-code in Shopware. Bestaat de valuta niet, dan geeft de flow een fout.
- Het aantal waarvan een staffelprijs geldt (
quantityStart) is minimaal 1. Ontbreekt het, dan gebruikt APIcenter het veldquantity, en anders 1. Het einde van de staffel (quantityEnd) wordt alleen gebruikt als het gelijk is aan of hoger is dan het begin. Anders heeft de staffel geen einde. - De bruto en netto prijs worden in Shopware gekoppeld opgeslagen.
Wat je eerst nodig hebt
- Shopware is gekoppeld. Zie Shopware koppelen aan APIcenter.
- De producten bestaan in Shopware. Maak ze eerst aan met de flow Producten naar Shopware sturen.
Tips
- Krijgt een klantgroep de prijs niet? Controleer of de naam van de klantgroep in de gegevens exact gelijk is aan de naam in Shopware. APIcenter zoekt op naam.
- Zie voor fouten bij het versturen van prijzen Shopware: veelvoorkomende fouten.
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.
Default price list group
Customer SettingsVul hier de waarde in van de prijslijstgroep, zoals het doelsysteem die herkent (meestal het id). APIcenter gebruikt deze waarde alleen als Enable use of a default customer price list group aan staat. Heeft de prijslijstgroep in de gegevens al een waarde, dan blijft die staan, tenzij Force the usage of the default price list group aan staat. Er is geen standaardwaarde.
Enable use of a default customer group
Customer SettingsZet dit aan om een standaard klantgroep te gebruiken. Vul daarna de waarde in bij Value to use as default customer group. Zonder deze instelling gebruikt APIcenter geen standaardwaarde. Standaard staat dit uit.
Enable use of a default customer price list group
Customer SettingsZet dit aan om een standaard prijslijstgroep te gebruiken. Vul daarna de waarde in bij Default price list group. Zonder deze instelling gebruikt APIcenter geen standaardwaarde. Standaard staat dit uit.
Field name holding customer group
Customer SettingsNaam van het veld waarin de klantgroep staat. Vul hier de veldnaam in zoals die in de applicatie heet. Standaard is het veld leeg.
Force the usage of the default customer group
Customer SettingsMet deze instelling bepaal je of de standaardwaarde de klantgroep in de gegevens vervangt. Staat dit aan, dan gebruikt APIcenter altijd de waarde uit Value to use as default customer group. Staat dit uit, dan wordt die waarde alleen gebruikt als de gegevens zelf geen klantgroep bevatten. Dit werkt alleen als Enable use of a default customer group aan staat. Standaard staat dit uit.
Force the usage of the default price list group
Customer SettingsMet deze instelling bepaal je of de standaardwaarde de prijslijstgroep in de gegevens vervangt. Staat dit aan, dan gebruikt APIcenter altijd de waarde uit Default price list group. Staat dit uit, dan wordt die waarde alleen gebruikt als de gegevens zelf geen prijslijstgroep bevatten. Dit werkt alleen als Enable use of a default customer price list group aan staat. Standaard staat dit uit.
Use customer group mapping table
Customer SettingsBepaalt of een koppeltabel wordt gebruikt om de klantgroep om te zetten. Zonder koppeltabel wordt de waarde uit de klantgegevens doorgegeven en gebruikt als id van de klantgroep. Standaard staat de instelling uit. Vul de koppeltabel in als je deze instelling aanzet.
Use default price list group mapping table
Customer SettingsGebruikt een mappingtabel om de prijslijstgroep om te zetten tussen het bronsysteem en het doelsysteem. Zet dit aan als de prijslijstgroepen 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.
Value to use as default customer group
Customer SettingsVul hier de naam in van de klantgroep in Shopware die APIcenter gebruikt bij het aanmaken van bestellingen. APIcenter zoekt de klantgroep op naam, dus de naam moet exact gelijk zijn aan de naam in Shopware. De instelling is verplicht. Vindt APIcenter de klantgroep niet, dan mislukt de flow met de melding dat de klantgroep niet is gevonden. De standaardwaarde is Standard customer group.
What to do with a value that cannot be mapped using the mapping table
Customer SettingsBepaalt 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 price list group mapping table aan staat. De standaardkeuze is Standaardwaarde gebruiken.
Enable URL Encoding of data in the endpoints of the source application
General flow settingHiermee 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.
Enable URL Encoding of data in the endpoints of the target application
General flow settingHiermee 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.
Enable URL encoding of data in endpoints
General flow settingZet 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 settingZet 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.
What to do with a value that cannot be mapped using the mapping table
General flow settingHier 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.
Notifications Email address
NotificationsVul 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 Slack webhook
NotificationsVul 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
NotificationsKies 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
NotificationsZet 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.
Skip negativity flip process
Product SettingsStandaard 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.
Maximum number of pages to retrieve
Run behaviourDit 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 behaviourDit 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.
Enable the use of quantity discount rules
Wholesale SettingsZet aan om ook de staffelkortingsregels (kortingen op basis van aantal) te verwerken. Staat de instelling uit, dan verwerkt APIcenter alleen de groothandelsprijs van de rol. Standaard staat de instelling aan.