Release Notes & Roadmap

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