Release Notes & Roadmap

• Bugfix
  De controle natrium × 2,5 = zout gebruikt nu de juiste nutriënt voor zout

  Meer informatie

  Wat verandert er?

  De basisvalidatie vergeleek natrium met een verkeerde nutriënt in plaats van met zout (nutriënt-id 64). Daardoor kon een product met correcte natrium- en zoutwaarden onterecht worden afgekeurd, of werd een onjuiste verhouding niet opgemerkt.

  Wat moet je doen?

  Niets. Werd een product eerder afgekeurd op de natrium/zout-controle terwijl de waarden klopten, bied het dan opnieuw aan.

  Resultaat

  De controle natrium × 2,5 = zout (marge 10%) wordt nu op de juiste waarden uitgevoerd.

• Bugfix
  Een nutriëntwaarde van 0 wordt bij bereidingsstaat Product en Na bereiding niet langer afgekeurd

  Meer informatie

  Wat verandert er?

  De controle op verplichte nutriëntwaarden keurde ook een waarde van 0 af. 0 is een geldige waarde, bijvoorbeeld koolhydraten en eiwit bij 100% vet. Alleen negatieve waarden worden nu nog afgekeurd. Dit geldt ook voor de waarde per portie.

  Wat moet je doen?

  Niets. Producten die op deze controle werden afgekeurd vanwege een waarde van 0, kun je opnieuw aanbieden.

  Resultaat

  Producten met nutriëntwaarden van 0 worden zonder foutmelding opgeslagen.

• Bugfix
  De controle natrium × 2,5 = zout gebruikt nu de juiste nutriënt voor zout

  Meer informatie

  Wat verandert er?

  De basisvalidatie vergeleek natrium met een verkeerde nutriënt in plaats van met zout (nutriënt-id 64). Daardoor kon een product met correcte natrium- en zoutwaarden onterecht worden afgekeurd, of werd een onjuiste verhouding niet opgemerkt.

  Wat moet je doen?

  Niets. Werd een product eerder afgekeurd op de natrium/zout-controle terwijl de waarden klopten, bied het dan opnieuw aan.

  Resultaat

  De controle natrium × 2,5 = zout (marge 10%) wordt nu op de juiste waarden uitgevoerd.

• Bugfix
  Een nutriëntwaarde van 0 wordt bij bereidingsstaat Product en Na bereiding niet langer afgekeurd

  Meer informatie

  Wat verandert er?

  De controle op verplichte nutriëntwaarden keurde ook een waarde van 0 af. 0 is een geldige waarde, bijvoorbeeld koolhydraten en eiwit bij 100% vet. Alleen negatieve waarden worden nu nog afgekeurd. Dit geldt ook voor de waarde per portie.

  Wat moet je doen?

  Niets. Producten die op deze controle werden afgekeurd vanwege een waarde van 0, kun je opnieuw aanbieden.

  Resultaat

  Producten met nutriëntwaarden van 0 worden zonder foutmelding opgeslagen.

• Verbetering De eenheid (unitofmeasureid) is nu verplicht per nutriënt en moet passen bij de eenheidsgroep van die nutriënt (zie de masters Nutrients en UnitOfMeasures)
• Verbetering Een product kan alleen nog aan een productgroep zonder subgroepen gekoppeld worden
• Verbetering Eenheid nettogewicht en netto-inhoud worden nu gevalideerd op toegestane eenheden
• Verbetering Wettelijk verplichte allergenen mogen niet meer op 'niet gespecificeerd' staan (onderdeel van de basisvalidatie)
• Bugfix De GTIN-controlecijfervalidatie keurt geldige GTIN-8/12/13/14 codes niet langer af
• Verbetering Een aantal validaties uit PS Basis Plus valt nu onder de basisvalidatie: verpakkingsgewicht t.o.v. bruto-/nettogewicht, statiegeld op verpakking, verpakkingsafmetingen (groter dan 0 en ouder ≥ kind), contactset op de basiseenheid, aantal lagen en aantal per laag op de pallet, actieve GPC-code, kenmerk-/allergeenrestricties en de nutriëntcontroles (kcal/kJ, energieberekening, natrium/zout, waarde per portie, subtotalen koolhydraten en vet, verplichte nutriëntwaarde voor product en na bereiding)

De backend van de Webapi is volledig geoptimaliseerd. De JSON-structuur van het bestaande /productsheet/{id}-endpoint is hierdoor niet gewijzigd — bestaande integraties blijven gewoon werken.

• Nieuw Alle validatieregels uit de v6 zijn overgenomen in versie 7
• Verbetering Algehele prestatieverbetering — diverse databasequery's zijn geoptimaliseerd, waardoor endpoints merkbaar sneller reageren
• Bugfix Bij het ophalen van alle wijzigingen (GetAllUpdates) wordt een lastUpdatedAfter van meer dan 7 dagen terug op de eerste pagina nu correct afgewezen met een 400 Bad Request, in plaats van hier inconsistent mee om te gaan. Zorg dat uw lastUpdatedAfter niet ouder is dan 7 dagen wanneer u pagina 1 opvraagt
• Let op: veld op termijn vervallen Veld id in het JSON summary-overzicht is verouderd — gebruik voortaan psId (bevat dezelfde waarde). Het id-veld blijft nog beschikbaar maar zal op termijn verdwijnen. Bij XML-output is niets veranderd

• Nieuw Uitgebreide groothandel validatieregels — 17 nieuwe verplichte validaties voor leveranciersproducten: producerGLN, opslagstadia, ingrediënten, palletdata, namen, contact, belastingtarief, verpakkingsmaterialen, nutriënten, brutogewicht, nettogewicht, netinhoud, maatvoereenheid-consistentie, intrastatcode, GTIN-controlegetal en commerciële beschrijving
• Nieuw Zoeken op alternatieve GTINs — wanneer u zoekt op een GTIN die als alternatieve GTIN bij een product is geregistreerd, geeft de lookup de bijbehorende primaire (huidige) GTIN terug. Dit geeft aan dat de door u gebruikte GTIN verouderd of vervangen is; werk uw eigen systeem bij met de teruggegeven primaire GTIN en gebruik voortaan die GTIN bij verdere opzoekacties
• Nieuw Pallet-GTIN lookup — opzoeken via pallet-GTIN levert nu de bijbehorende basiseenheid op in plaats van een niet-gevonden resultaat

• Nieuw Uitgebreide verpakkingsmateriaal structuur — verpakkingsmaterialen bevatten nu PackagingMaterialType, PackagingElement en RecyclabilityLevel als gekoppelde masterdata. Aanvullende velden zoals IsRecyclable, PercentageRecycledMaterial, kleur, transparantie en stijfheid zijn toegevoegd voor GDSN-conform rapporteren
• Nieuw Hiërarchische verpakkingsmaterialen — een verpakkingsmateriaal kan nu een bovenliggend materiaal (ParentId) hebben, zodat samengestelde verpakkingsstructuren correct worden weergegeven
• Nieuw Kruisbesmetting bij allergenen — twee nieuwe masterdatatypes (CrossContaminationType en CrossContaminationDistribution) zijn toegevoegd aan allergenen, waarmee producenten de aard en spreiding van kruisbesmetting kunnen vastleggen conform EU-allergenenregelgeving
• Nieuw Allergeen eiwitgehalte — nieuwe velden AmountAllergenProteinGr, AmountAllergenProteinPpm, AllergenProteinWeight en AllergenProteinPercentage maken het mogelijk exacte eiwitdrempelwaarden per allergeen op te slaan
• Nieuw Product Carbon Footprint bij impactscore — de impactscore bevat nu een lijst van ProductCarbonFootprintInfo objecten voor gedetailleerde CO₂-voetafdruk rapportage per product
• Verbetering Uitgebreide impactscore metrics — extra indicatoren toegevoegd: biodiversiteitsimpact, blauw watergebruik, broeikasgas, arbeidsrisico, landgebruik, verwerkingsimpact, bodemgezondheid en dierenwelzijn. Tevens is een IsOutlier markering met uitleg en een DataQuality indicator beschikbaar
• Verbetering Nieuwe masterdata endpoints — PackagingMaterialType, PackagingElement, RecyclabilityLevel, CrossContaminationType en CrossContaminationDistribution zijn beschikbaar via de masterdata-endpoints
• Breaking Change Allergenen met "kan sporen bevatten" worden niet langer teruggegeven met levelOfContainment=3. Deze allergenen worden nu verstuurd met levelOfContainment=2 ("zonder") en de nieuwe velden CrossContaminationType en CrossContaminationDistribution geven aan of en in welke mate kruisbesmetting aanwezig is

• Nieuw Paginering bij lookup-resultaten — stuur PageNumber en PageSize (standaard 250, max 1000) mee in de request body; de respons bevat pageNumber, pageSize, totalPages en tellingen per categorie
• Nieuw Paginering bij assortimentslijst items — GET assortments/{id}/items accepteert pageNumber en pageSize als queryparameters; bij een verlopen cache (2 min) volgt een 410 Gone
• Nieuw Producten zoeken op handelseenheid (HE) — GTINs worden automatisch genormaliseerd naar 14 cijfers
• Nieuw Product verwijderen via de API — inclusief verwijderreden en synchronisatie-endpoint
• Nieuw Alternatieve GTINs bij logistiek product — alternativegtins-lijst beschikbaar in GET én opslaan via PUT
• Nieuw Push notificatie bij assortiment match — directe webhook (ProductUpdateNotification) zodra een product aan een assortimentslijst wordt gematcht
• Verbetering Lookup zoekt nu ook in niet basiseenheden en geeft basiseenheden die daar bij horen terug
• Verbetering Dubbele producten in lookup resultaten worden nu samengevoegd tot één resultaat per product
• Verbetering Consistente 400 Bad Request foutmeldingen bij ontbrekende verplichte velden
• Breaking Change Veld assortmentTypeId is verwijderd uit de API — assortimentslijsten kunnen nu onbeperkt worden aangemaakt zonder dit veld

• Nieuw Assortimentslijsten CRUD - Volledig beheer van assortimentslijsten via API
• Nieuw Webhooks voor push berichten - Ontvang real-time notificaties bij wijzigingen
• Nieuw Impactscore toegevoegd aan product endpoints
• Verbetering Uitbreiding rate limit voor enterprise klanten
• Verbetering Response tijd verbetering tot 40% sneller
• Verbetering Database optimalisaties voor betere schaalbaarheid
• Verbetering Nieuwe caching strategie geïmplementeerd
• Breaking Change Endpoint herbenoemingen - Zie documentatie voor migratie details

• Nieuw Volledige API versie 7 met verbeterde validatie en foutafhandeling
• Nieuw NuGet package voor .NET ontwikkelaars (compatibel met .NET 6.0 - 9.0)
• Nieuw PHP Composer package voor eenvoudige integratie
• Verbetering Uitgebreide Swagger documentatie met interactieve API explorer
• Verbetering Geoptimaliseerde response tijden voor productsheet endpoints