Uw assortiment, prijzen en voorraad

Lever uw eigen productgegevens aan vanuit uw software.

Uw goedgekeurde aansluiting

Deze route is voor geverifieerde leveranciers met een toegewezen leveranciersreferentie en feedcode. Producthandel stemt het bestandstype, de velden en de werkwijze met u af. De feed moet als webhook_push zijn goedgekeurd in de actieve of schaduwconfiguratie.

U ontvangt een geheim voor deze feed via een beveiligd kanaal. Dit is een HMAC-sleutel, niet de Bearer-sleutel voor inkopen. Bewaar het geheim alleen in uw beveiligde serveromgeving. Uw toegang geldt uitsluitend voor uw eigen leverancier, feed, imports en verwerkingsopdrachten.

Elke aanvraag ondertekenen

Ook GET-aanvragen vereisen deze drie headers:

X-Bridge-Webhook-Timestamp: de timestamp van uw aanvraag.
Idempotency-Key: de bewaarde sleutel voor deze bedoelde opdracht.
X-Bridge-Webhook-Signature: sha256=<hexadecimale HMAC-SHA256>.

Onderteken onderstaande UTF-8-tekst met uw feedgeheim. Gebruik een regeleinde tussen de velden, zonder extra regeleinde aan het einde.

METHOD
exact_path
timestamp
Idempotency-Key
sha256(raw_body).hexdigest()

Methode, pad, headers en ongewijzigde body moeten exact overeenkomen met wat u verstuurt. GET en de processing/routing-POSTs hebben geen body of querystring; gebruik daarvoor de SHA256 van lege bytes. De actuele referentie vermeldt de geldigheid van timestamps en de invoergrenzen.

Van aanlevering naar verwerkingsstatus

Het basispad is /supplier/v1/feeds/{supplier_reference}/{feed_key}. Gebruik de toegewezen waarden, niet de naam van uw bedrijf.

Lees GET op het basispad voor uw feedbeschrijving en gegevensvereisten.
Verstuur POST /captures onder dit basispad met de exacte CSV-, JSON- of XML-bronbytes en de bijbehorende goedgekeurde Content-Type. Bewaar de oorspronkelijke idempotency key. De ontvangst plant verwerking in; het artikel is daarmee nog niet gepubliceerd.
Lees GET /imports/{import_id} met de teruggegeven importreferentie.
Indien nodig plant POST /imports/{import_id}/processing de verwerking in. Controleer eerst de bestaande status: ontvangst plant verwerking al automatisch in.
POST /imports/{import_id}/routing plant verwerking volgens het afgesproken publicatiebeleid. Dit forceert geen publicatie en overschrijft geen goedgekeurde productcorrecties.
Volg de teruggegeven opdracht via GET /work/{work_id} binnen hetzelfde basispad.

Wat bevestigt de ontvangst?

De 202-reactie bevat import_id, sha256, idempotent_replay en een verwerkingsopdracht of processing: null. Dubbele bronbytes worden bewaard zonder nieuwe importeffecten; er hoeft dan geen nieuwe opdracht te zijn. Volg de bestaande importstatus. Dezelfde sleutel en body herstellen dezelfde aanlevering; dezelfde sleutel met een gewijzigde body geeft een conflict.

Volledig bestand of alleen wijzigingen?

Uw goedgekeurde feed bepaalt de betekenis. Een ontbrekend artikel in een delta is geen verwijdering. Alleen afgesproken formaten en velden worden verwerkt. Ontbrekende beelden, onvolledige gegevens of tegenstrijdig bronbewijs kunnen om beoordeling vragen.

Na een onderbreking

Bewaar de exacte bronbytes, oorspronkelijke opdracht, idempotency key en ontvangen referenties. Lees na een time-out eerst de import- of opdrachtstatus als u de referentie hebt. Ontbreekt die? Herstel dezelfde aanlevering met dezelfde body en oorspronkelijke sleutel volgens het contract; maak niet zomaar een nieuwe opdracht. Onderteken een later verzoek opnieuw met een geldige timestamp.

Wat valt buiten deze route?

Deze koppeling verwerkt bronfeeds en toont hun status. Leveranciersorders, verzendberichten, accountbeheer en abonnementen vallen er niet onder. Een geslaagde import vervangt geen beoordeling van productgegevens of publicatierechten.

Het contract voor uw feed

/public/v1/openapi/supplier-publishing.json

Bekijk de volledige referentie voor de actuele aanvraagmodellen en herstelregels. Een zichtbaar schema activeert geen niet-goedgekeurde feed.

Gebaseerd op het vastgelegde Bridge-contract. Controleer bij integratie altijd de actuele referentie en toegangsvoorwaarden.