Hankinnan optimointi varaosaluettelon hakudatasta
Lähetätte luettelonne hakutapahtumat, varastosaldot ja myynnin. Me ratkaisemme jokaisen VIN-numeron ajoneuvokohtaisesti, vertaamme auton todellista tarvetta siihen mitä luettelonne näytti ja palautamme ostojärjestelmäänne syötettävät valikoimasuositukset, kattavuusaukot ja KType-varianttikartan — toimipisteittäin.
Procurement365 is DropGear's procurement-optimisation API for parts distributors: send catalogue search events, stock and sales; receive KType-bound range recommendations, coverage gaps weighted by the Finnish vehicle parc, and a variant map — per branch.
Valikoimasuositukset
KEEP / DEEPEN / REDUCE / DROP nimikkeittäin, perusteluineen ja luottamustasoineen; sopivuusaste ja sisarvariantit.
Kattavuusaukot
OE-numerot, joita autokantanne tarvitsee mutta luettelonne ei näyttänyt — painotettuna alueen ajoneuvokannalla (Traficom).
KType-varianttikartta
Mitkä variantit hakupopulaationne tarvitsee ja millä osuuksilla, ja mitkä omat nimikkeenne kattavat ne.
Tunnistautuminen
Jokainen kutsu kantaa otsikon X-API-Key. Avaimen saatte DropGearilta sopimuksen yhteydessä; se näytetään vain kerran.
Lähetys (push)
| Kutsu | Sisältö |
|---|---|
POST /api/procurement/events | Hakutapahtumat: VIN/rekkari, KType, osaryhmä, kaikki näytetyt artikkelit, valinta/tilaus, toimipiste |
POST /api/procurement/articles | Nimikkeet ja saldot varastoittain |
POST /api/procurement/sales | Myynti kuukausittain (12 kk), valinnaisesti toimipisteittäin |
POST /api/procurement/supplier_range | Täydennystoimittajan valikoima |
JSON-taulukko, enintään 5 000 riviä per kutsu. Vastaus 202 ja erän tulos (rows_ok, errors, unmapped_groups, unmapped_branches).
curl -X POST https://procurement365.dropgear.fi/api/procurement/events -H "X-API-Key: dgpk-…" -H "Content-Type: application/json" --data @events.json
Nouto (pull)
| Kutsu | Palauttaa |
|---|---|
GET /api/procurement/runs[?branch=OULU] | Ajot uusin ensin (ketju ja toimipisteet) |
GET /api/procurement/runs/{id} | Ajon tiedot ja taulut |
GET /api/procurement/runs/{id}/reco_sku?format=csv | Tiedosto — myös reco_sku_ktype, reco_gap, reco_ktype, summary; format=csv|json |
Statuskoodit
| Koodi | Merkitys |
|---|---|
| 202 / 200 | Erä vastaanotettu / tulos |
| 401 · 403 | Avain puuttuu tai väärä · avaimella ei ole Procurement365-asiakkuutta |
| 404 · 409 | Tuntematon ajo tai taulu · ajo ei ole vielä valmis |
| 413 · 429 | Yli 5 000 riviä · päiväkiintiö täynnä (Retry-After) |
| 503 | Palvelu tilapäisesti pois käytöstä |