Le projet Skool est présentement en développement. Il consiste à mettre sur pied différents types de formations spécialisées en affaires électroniques pour favoriser le développement et l'adoption des TIC dans vos organisations.
Osmose Interactif inc. /

Partenariats

Suivez-nous sur les médias sociaux

Twitter Facebook YouTube

Notre API permet aux fournisseurs de restaurants de synchroniser automatiquement leur liste de produits et de prix avec la base de données du logiciel Presto, permettant ainsi aux restaurateurs de disposer constamment de leur coût de revient à jour.

Ce document vous expliquera comment vous y intégrer.

Confidentialité des informations transmises

Osmose Intéractif souhaite développer des relations mutuellement avantageuses avec les distributeurs. Nous nous engageons donc envers vous à ne pas utiliser vos informations ni créer des fonctionnalités ayant pour effet de permettre de comparer vos prix avec ceux de vos fournisseurs. De plus, seuls vos clients qui disposent de codes d'accès valides (voir plus bas) auront accès à vos données.

Version de l'API

Cette documentation s'applique à la version 1.1 de l'API, mise à jour le 22 avril 2011. En cas de changement, le contact technique du fournisseur sera averti.

1. Synchronisation de la liste de produits

Hebdomadairement, Presto enverra une requête à une URL que vous aurez spécifié dans le panneau de contrôle.

Diagrame 1

Pagination des résultats

Afin de réduire le temps d'exécution des scripts, deux paramètres seront fournis pour paginer les résultats, soit offset et rows. rows indique à partir de quel produit commencer tandis que rows indique le nombre de résultats à retourner. Il s'agit de l'équivalent SQL de LIMIT offset, rows.

Authentification

Afin d'authentifier Presto, une clé d'API auto-générée (md5 32 caractères) vous sera indiquée. Cette clé d'API sera disponible dans votre panneau API lorsque vous vous serez inscrit comme fournisseur.

Si cette clé n'est pas valide, votre serveur doit retourner une entête HTTP/1.0 403 Forbidden pour indiquer que la clé n'est pas valide.

Retourner la liste des produits

Cette URL devra répondre avec une liste de produits dans un tableau associatif au format JSON suivant le standard suivant :

Format du fichier JSON des produits

Le détail des champs est indiqué en italique

[
{
"id":"Votre ID produit unique",
"available":"true ou false, selon la disponibilité du produit",
"name":"Le nom du produit, encodé UTF-8",
"category":"Nom catégorie, encodé UTF-8",
"format_qty":"La quantité contenue dans une caisse",
"format_units":"Le format d'une unité",
"format_unit_type":"Le type d'unité 1",
"replacement_id":"ID du produit de remplacement, optionnel",
"description":"Description du produit, optionnel"
"image_url":"URL de l'image, optionnel"
}

{ainsi de suite pour chaque produit}
Exemple de produit :

{
"id":"340406",
"available":"true",
"name":"Chardonnay Fleur du Cap Western cape",
"category":"Afrique du Sud",
"format_qty":"12",
"format_units":"750.00",
"format_unit_type":"ml",
"replacement_id":"12345",
"description":"Neque porro quisquam est qui dolorem ipsum quia dolor sit amet",
"image_url":"http://www.saq.com/wcsstore/saqcom/images_produits/00340406_g.jpg"
}

]

1 : types d'unités possibles pour le champ format_unit_type :

Voici des liens vers plus d'informations à propos de JSON selon votre langage de programmation :

2. Synchronisation de la liste de prix d'un client

Lorsque les clients / utilisateurs de Presto vous ajouteront comme fournisseur, ils pourront spécifier leur nom d'utilisateur et mot de passe pour votre site de commande. Ces codes d'accès seront utilisés pour récupérer la liste de prix sur votre serveur.

Quotidiennement, Presto enverra une requête pour chaque client à une URL que vous aurez spécifié dans le panneau de contrôle.

Diagrame 1

Pagination des résultats

Afin de réduire le temps d'exécution des scripts, deux paramètres seront fournis pour paginer les résultats, soit offset et rows. rows indique à partir de quel produit commencer tandis que rows indique le nombre de résultats à retourner. Il s'agit de l'équivalent SQL de LIMIT offset, rows.

Authentification

Cette url vous fournira le nom d'utilisateur et le mot de passe que le client utilise pour se connecter à votre site web de commande, vous permettant ainsi de l'authentifier.

Si les codes d'accès ne sont pas pas valides, votre serveur doit retourner une entête HTTP/1.0 403 Forbidden pour indiquer que les codes ne sont pas valides.

Retourner la liste des produits

Cette URL devra répondre avec une liste de prix dans un tableau associatif au format JSON suivant le standard suivant :

Format du fichier JSON des prix

Le détail des champs est indiqué en italique

[
{
"id":"Votre ID produit unique, doit correspondre avec la liste de produits",
"price":"Le prix à l'achat 1",
"price_unit":"l'unité de mesure du prix 2"
}

{ainsi de suite pour chaque produit}
Exemple de produit :

{
"id":"340406",
"price":"3765",
"price_unit":"units"
}

]

1 : le prix doit être spécifié en entier numérique. Par exemple, un produit dont le prix serait de 23.45 deviendra 2345.

2 : unités possibles pour le champ price_unit :

Voici des liens vers plus d'informations à propos de JSON selon votre langage de programmation :

En cas de questions

Si vous avez des questions, n'hésitez pas à communiquer avec notre équipe technique au api@osmoseinteractif.com.

Programme de partenariat