Artikeldata voor food en FMCG

Eén artikel.
Eén waarheid.
Elk kanaal.

Skuery verzamelt artikeldata uit leveranciersfeeds, GDSN en publieke bronnen, valideert elk veld tegen uw eigen regels, en levert één gecontroleerd record aan al uw systemen.

Naar het portaal Hoe het werkt
leverancier.csv BRUISWATER CITROEN 1L · 1L · Fonteyn
GDSN-XML Bruiswater citroen · 1,0 L · FONTEYN NV
Open Food Facts bruiswater, citroen · 1000 ml · Fonteyn
Canoniek artikel Gepubliceerd
gtin
5401234567890
brand_name
Fonteyn
functional_name
Bruiswater citroen
net_content
1000 ml
revisie
4

Werkwijze

Niets komt ongezien in de catalogus

Elke wijziging doorloopt dezelfde vier stappen. Een artikel bestaat pas als iemand het heeft goedgekeurd.

  1. 01

    Voorstel

    Een client POST't data naar /v1/proposals, of u importeert een CSV- of GDSN-XML-bestand. De catalogus blijft ongemoeid.

  2. 02

    Validatie

    Elk veld gaat door uw validatieregels. Het voorstel krijgt een score, met fouten en waarschuwingen per veld.

  3. 03

    Review

    Een datasteward ziet de voorgestelde waarde naast de huidige en keurt alles goed, een selectie van velden, of niets.

  4. 04

    Canoniek artikel

    Na goedkeuring is het artikel beschikbaar via de API. Elke wijziging is een revisie, en elke revisie is terug te draaien.

Integratie

Eén geversioneerde API voor lezen en schrijven

Authenticatie met een API-key per client, rechten per endpoint en limieten per uur, dag en maand. Een voorstel indienen ziet er zo uit:

Verzoek application/json 
POST /api/v1/proposals
X-API-Key: sk_live_7f3c…
Content-Type: application/json

{
  "gtin": "5401234567890",
  "brand_name": "Fonteyn",
  "functional_name": "Bruiswater citroen",
  "net_content": "1000 ml",
  "target_market": "belgium"
}
Antwoord 202 Accepted 
{
  "message": "Proposal received and queued
             for later review.",
  "data": {
    "id": "a1df0713-b68c-421c-af8b…",
    "gtin": "5401234567890",
    "article_id": null,
    "status": "pending_review",
    "validation_score": 95.0,
    "is_new_article": true
  }
}
Authenticatie
API-key per client, met rechten articles.read en articles.write.
Limieten
Per uur, dag en maand instelbaar, met strengere limieten voor publiceren en exporteren.
Sandbox
Een sandboxclient wordt volledig gevalideerd, maar bereikt de catalogus nooit.
Import en export
CSV en GDSN-XML importeren, met een dry run. GDSN-export loopt als asynchrone job.

Datamodel

Wat Skuery per artikel bijhoudt

Een intern model dat is afgestemd op GDSN-begrippen, zodat een veld dezelfde betekenis houdt in elk kanaal.

Identificatie

Barcodes, interne artikelnummers en classificatie.

gtin · internal_sku · gpc_code

Omschrijving en merk

Functionele naam, handelsomschrijving en merknaam.

brand_name · functional_name

Ingrediënten en allergenen

Ingrediëntendeclaratie plus allergenen als aparte, gestructureerde records.

ingredients_statement · allergens

Nutritionele waarden

Voedingswaarden per grondslag, apart opgeslagen in plaats van als vrije tekst.

nutrition_facts

Verpakking en maten

Verpakkingsniveaus met hoeveelheden, zodat een omdoos numeriek klopt.

package_levels

Documenten en beeld

Technische fiches en productfoto's, met een interne kopie op private opslag.

documents · images

Herkomst en bewaring

Land van oorsprong, doelmarkt en bewaarcondities.

country_of_origin · target_market

Publicatie en revisies

Publicatiestatus per artikel en een volledige revisiehistoriek.

publication_status · revisions

Controle

Regels die u zelf instelt

De validatie is configuratie, geen code. U past regels aan zonder een release af te wachten.

Stand van zaken

Wat er werkt, en wat nog komt

In gebruik
  • Voorstellen, validatie, scoring en review in het portaal
  • API v1 voor artikelen, voorstellen, revisies en rollback
  • API-keys met rechten, limieten en sandboxmodus
  • Import van CSV en GDSN-XML, met dry run
  • GTIN-verrijking via Open Food Facts
In ontwikkeling
  • De volledige GDSN-mappinglaag voor import en export
  • Bredere publicatiekanalen naast de API

Skuery is een intern platform. Toegang loopt via een API-client die uw datasteward aanmaakt — er is geen publieke registratie.