Partenaires techniques du Pass Culture : documentation sur l'API "stocks"

Ceci décrit l'API à implémenter par les partenaires techniques de Pass Culture qui souhaitent fournir des stocks.

Pass Culture s'identifie auprès des partenaires techniques via un certificat client SSL. La clé publique est publiée sur le site Pass Culture, et les partenaires sont prévenus à l'avance en cas de changement de clé via notre liste de diffusion email "partenaires techniques".

Statut actuel : protype, pour implémentations pilotes

Les Stocks [/stocks/{siret}]

Cette API est apellée immédiatement lorsqu'un offreur culturel vous choisit comme fournisseur dans le portail, puis une fois par nuit et par offreur vous ayant choisi par la suite.

Règles de mise à jour des données dans Pass Culture:

Lister les stocks disponible pour un établissement [GET /stocks/12345678901234?after=1978212345681&limit=2]

Les références renvoyées sont les EAN13 du code barre du produit.

L'ordre est au choix du fournisseur mais ne doit pas varier entre deux requetes.

"total" représente le nombre total d'entrées (nombre de références donc, ou presque, cf. le sujet du prix ci-dessous) disponibles. "limit" indique le nombre d'entrées maximum retournées pour une requete. Il est inférieur ou égal au paramètre limit envoyé dans la requete (inférieur si le serveur souhaite limiter, égal sinon) "offset" représente le nombre d'entrées précedent celles qui sont présentées

Dans une entrée,


































Les spécifications de cette API sont désormais disponibles  à cette adresse : https://github.com/betagouv/pass-culture-doc/blob/master/src/22_fournisseur.apib.md