Swagger
Endpoints
|
Méthode 468_01a55e-e2> |
Chemin 468_bacadb-31> |
Description 468_4acfae-49> |
|
POST 468_729364-03> |
/login 468_26a4d2-e1> |
Récupère le token d’authentification 468_661730-0a> |
|
GET 468_ced584-a5> |
/catalogs 468_a3eb7d-19> |
Liste des catalogues fabricants/fournisseurs 468_1ecdef-46> |
|
GET 468_a21cd5-4b> |
/product_families 468_0cfeba-1c> |
Liste des familles de produits 468_150333-15> |
|
GET 468_8d0614-4b> |
/products 468_fc1332-5f> |
Liste des articles (pagination, filtrage par famille) 468_24a3d6-40> |
|
GET 468_c0d37e-8d> |
/product_infos 468_d88462-d5> |
Met à jour le prix d’achat fournisseur 468_005969-36> |
|
GET 468_520c1e-cd> |
/suppliers 468_0801b8-e4> |
Récupérer la liste des fournisseurs |
|
GET 468_b89919-0f> |
/agencies 468_87329d-32> |
Récupérer la liste des agences |
|
GET 468_1141bd-17> |
/cart 468_8fdda7-bb> |
Intègre des articles dans devis/commandes 468_e0b3b8-71> |
|
GET 468_806c20-9b> |
/quotation_price 468_c22f19-9e> |
Récupérer le prix de chiffrage 468_c4ede5-c1> |
|
GET 468_c11ebd-68> |
/orders 468_fc886b-e0> |
Liste des commandes validées 468_f7459f-e6> |
|
GET 468_06de7a-72> |
/order 468_f87eab-f0> |
Détail d’une commande validée 468_cb77cd-b3> |
|
POST 468_45ef95-aa> |
/order 468_e879e1-e6> |
Création d’une commande 468_8e17bb-7f> |
|
PUT 468_08edc6-e4> |
/order 468_a9f657-ee> |
Modification d’une commande 468_908f1e-4d> |
Exemples par API
Cette API permet de récupérer le token, requis pour l’utilisation de toutes les autres API.
Paramètres d’entrée :
- login
- mot de passe
Retour :
- token
Le token est valable pendant 2 heures.
curl -X POST https://fronttest.tarifeo.net/API/login -H "Content-Type: application/json" -d '{"username": "user", "password": "pass"}'
fetch('https://fronttest.tarifeo.net/API/login', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ username: 'user', password: 'pass' }) })
import requests
requests.post('https://fronttest.tarifeo.net/API/login', json={'username': 'user', 'password': 'pass'})
Réponse JSON
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6..."
"dateTimeExpiration": "2025-08-20T13:25:47.2783
}
Liste des catalogues fabricants/fournisseurs
Cette API permet de récupérer la liste des catalogues des fabricants/fournisseurs disponibles dans Tarifeo, ainsi que leurs dates d’application.
L’ID Tarif Tarifeo du catalogue est requis pour utiliser d’autres API.
Elle permet également de comparer les dates de mise à jour avec celles des catalogues déjà extraits, afin de proposer une mise à jour si nécessaire.
Paramètre d’entrée :
- token
Retour :
- ID
- Trigramme Tarifeo
- Nom du fabricant
- Date de mise à jour publique
- Date de prochaine mise à jour (si disponible)
- Date de traitement du tarif par Tarifeo
curl -X GET https://fronttest.tarifeo.net/API/catalogs -H "Authorization: YOUR_TOKEN_HERE"
fetch('https://fronttest.tarifeo.net/API/catalogs', { headers: { 'Authorization': 'YOUR_TOKEN_HERE' } })
import requests
requests.get('https://fronttest.tarifeo.net/API/catalogs', headers={'Authorization': 'YOUR_TOKEN_HERE'})
Réponse JSON
{
"@context": "/contexts/Catalog",
"@id": "/catalogs",
"@type": "hydra:Collection",
"hydra:totalItems": 651,
"hydra:member": [
{
"@id": "/catalogs/3FF",
"@type": "Catalog",
"name": "3F FILIPPI",
"codeCtm": "3FF",
"productNumber": 2927,
"nextApplicationDate": "",
"type": "public",
"applicationDate": "20230701",
"diffusionDate": ""
},
{
"@id": "/catalogs/3ME",
"@type": "Catalog",
"name": "3M ELECTRIQUES",
"codeCtm": "3ME",
"productNumber": 1088,
"nextApplicationDate": "",
"type": "public",
"applicationDate": "20250401",
"diffusionDate": ""
},
...
]
}
Liste des familles de produits
Cette API permet de récupérer les codes des familles de produits, afin de classer les articles dans votre logiciel de gestion (ERP).
Elle permet également de filtrer les données pour intégrer seulement certaines familles de produits.
Paramètres d’entrée :
- token
- Trigramme
Retour :
- Code famille de produit
- Libellé famille de produit
curl -X GET https://fronttest.tarifeo.net/APIFRONT/product_families?codeCtm=XXX -H 'Authorization': 'YOUR_TOKEN_HERE'
fetch('https://fronttest.tarifeo.net/APIFRONT/product_families?codeCtm=XXX', { headers: { 'Authorization': 'YOUR_TOKEN_HERE' } })
import requests
requests.get('https://fronttest.tarifeo.net/API/product_families?codeCtm=XXX', headers={ 'Authorization': 'YOUR_TOKEN_HERE' })
Réponse JSON
{
"productFamilies": [
{
"code": "1J1",
"label": "CONDUITS BRANCHEMENTS"
},
{
"code": "1H1",
"label": "ACCESSOIRES CONDUITS"
},
...
]
}
Liste des articles (pagination, filtrage par famille)
Cette API permet de récupérer la liste des articles avec leurs données générales.
Paramètres d’entrée :
- token
- Trigramme
- Page (mettre 1 pour la première interrogation)
- Familles produits
Retour (par pages de 500 articles) :
- Numéro de page / Nombre total de pages
- Code article (max. 40 caractères, généralement ≤15)
- Désignation courte
- Désignation longue
- Prix unitaire (5 décimales)
- Prix de chiffrage (aujourd’hui retourne le prix public)
- Unité
- Unité de prix
- Code famille produit
- Code EAN
- Taxe DEEE (2 décimales)
curl -X GET "https://front.tarifeo.net/API/products?catalog.codeCtm=XXX&pageNumber=1" -H 'Authorization': 'YOUR_TOKEN_HERE'
fetch('https://fronttest.tarifeo.net/API/products?catalog.codeCtm=XXX&pageNumber=1', { headers: { 'Authorization': 'YOUR_TOKEN_HERE' } })
import requests
requests.get('https://fronttest.tarifeo.net/API/products?catalog.codeCtm=XXX&pageNumber=1', headers={'Authorization': 'YOUR_TOKEN_HERE' })
Réponse JSON
{
"@context": "/contexts/Product",
"@id": "/products",
"@type": "hydra:Collection",
"hydra:totalItems": 17700,
"hydra:member": [
{
"@id": "",
"@type": "Product",
"optimaPrimaryKey": "",
"label": "Conduit Isolant, Cintrable, Transversalement élastique, Annelé ICTA 3522 Rai'Gliss Ø40mm noir à bandes grises livré avec manchon IP68 IK10 (IP30 avec manchon) - préconisé Enedis, répond à la NF C 14-100, conforme à la norme EN 61386-22",
"shortLabel": "Conduit cintrable ICTA 3522 Rai'Gliss Ø40mm - noir à bandes grises",
"europeanArticleNumberCode": "3414971487154",
"manufacturerReference": "00040",
"supplierReference": "",
"coefficient": 1,
"family": {
"@id": "/families/1J1",
"@type": "Family",
"id": "1J1",
"label": "",
"idBo": ""
},
"prices": [
{
"@id": "",
"@type": "Price",
"id": "",
"value": 7.662,
"notCommunicated": false,
"label": "Prix Unitaire",
"unit": "u"
}
]
},
...
]
}
Cette API permet de mettre à jour les prix d’achat des produits récupérés via Tarifeo. Elle est à intégrer dans les devis ou autres documents selon vos besoins.
Paramètres d’entrée :
- token
- Nom dossier Tarifeo
- Trigramme
- Code article
- SIRET agence
- Derog_affaire (optionnel)
Si le code de dérogation est erroné, l’API retourne 0.
Retour :
- Désignation longue
- Désignation courte
- Prix public
- Code famille de produits
- Désignation famille de produits
- Prix d’achat fournisseur
- Coefficient de remise fournisseur
- Commentaire sur le prix d’achat (max. 100 caractères)
- Code douane
- Multiple de commande fournisseur
- Date de début du contrat cadre
- Date de fin du contrat cadre
curl -X GET "https://fronttest.tarifeo.net/API/product_infos?codeCtm=XXX&manufacturerReference=XXXXXX&supplierRegistrationNumber=XXXXXXXXXXXXXX&folderName=NomduFolder&exceptionCode=derogation1A" -H 'Authorization': 'YOUR_TOKEN_HERE'
fetch('https://fronttest.tarifeo.net/API/product_infos?codeCtm=XXX&manufacturerReference=XXXXXX&supplierRegistrationNumber=XXXXXXXXXXXXXX&folderName=NomduFolder&exceptionCode=derogation1A', { headers: { 'Authorization': 'YOUR_TOKEN_HERE' } })
import requests
requests.get('https://fronttest.tarifeo.net/API/product_infos?codeCtm=XXX&manufacturerReference=XXXXXX&supplierRegistrationNumber=XXXXXXXXXXXXXX&folderName=NomduFolder&exceptionCode=derogation1A', headers={'Authorization': 'YOUR_TOKEN_HERE' })
Réponse JSON
{
"@context": "/contexts/ProductInfo",
"@id": "/product_infos",
"@type": "hydra:Collection",
"hydra:totalItems": 1,
"hydra:member": [
{
"@id": "/product/infos",
"@type": "ProductInfo",
"optimaPrimaryKey": "",
"catalog": {
"@id": "/internal/catalogs/XXX",
"@type": "Catalog",
"id": 42,
"name": "NomduFabricant",
"codeCtm": "XXX"
},
"label": "BAES d'évacuation saillie à LEDs 45 lumens 1 heure IP43 IK07 SATI Connecté avec fonctionnalité Visibilité Augmenté et balisage lumineux d'évacuation pour ERP et ERT - visualisation de l'état sur l'application Legrand ERPconnecté",
"shortLabel": "BAES d'évacuation saillie à LEDs 45lm 1h plastique IP43 IK07 SATI Connecté",
"europeanArticleNumberCode": "3414971404793",
"manufacturerReference": "062525",
"supplierReference": "",
"prices": [
{
"@id": "",
"@type": "Price",
"id": "",
"value": 155.3,
"notCommunicated": false,
"label": "Prix Unitaire",
"unit": "u"
}
],
"attributes": [
{
"@type": "Attribute",
"@id": "",
"value": "9405612090",
"label": "Code douanier"
}
],
"family": {
"@id": "/families/207",
"@type": "Family",
"id": "207",
"label": "BAES ECO 1 20/80",
"idBo": ""
},
"coefficient": "",
"type": "public",
"quotationPrice": 155.3,
"companyFamily": null
}
],
"hydra:view": {
"@id": "/product/infos?codeCtm=XXX&manufacturerReference=XXXXXX",
"@type": "hydra:PartialCollectionView"
}
}
Cette API permet de récupérer la liste des fournisseurs qui permettront initialiser l’ERP.
Paramètres d’entrée :
- token
Tarifeo retourne la liste des fournisseurs
Retour : la collection des fournisseurs, voir si pagination
- SIRET
- Raison sociale
curl -X GET https://fronttest.tarifeo.net/API/suppliers -H "Authorization: Bearer <token>"
fetch('https://fronttest.tarifeo.net/API/suppliers', { headers: { 'Authorization': 'YOUR_TOKEN_HERE' } })
import requests
requests.get('https://fronttest.tarifeo.net/API/suppliers', headers={'Authorization': 'YOUR_TOKEN_HERE'})
Réponse JSON
{
"@context": "/contexts/Supplier",
"@id": "/suppliers",
"@type": "hydra:Collection",
"hydra:totalItems": 63,
"hydra:member": [
{
"@id": "/suppliers/0",
"@type": "Supplier",
"code": "2ED",
"socialReason": "2ED",
"registrationNumber": "512913518",
"fullRegistrationNumber": "51291351800027"
},
{
"@id": "/suppliers/0",
"@type": "Supplier",
"code": "3CCLIM",
"socialReason": "3C CLIM",
"registrationNumber": "421677089",
"fullRegistrationNumber": "42167708900219"
},
...
]
}
Cette API permet de récupérer la liste des agences qui permettront initialiser l’ERP.
- Token
- SIRET ou SIREN fournisseur
Tarifeo retourne la liste des agences
Retour : la collection des agences
- SIRET
- Ville
- Raison sociale
- Agence
- Adresse
- Code postal
curl -X GET https://fronttest.tarifeo.net/API/agencies?supplier.fullRegistrationNumber=xxxxxxxxx -H "Authorization: Bearer <token>"
fetch('https://fronttest.tarifeo.net/API/agencies?supplier.fullRegistrationNumber=xxxxxxxxx', { headers: { 'Authorization': 'YOUR_TOKEN_HERE' } })
import requests
requests.get('https://fronttest.tarifeo.net/API/agencies?supplier.fullRegistrationNumber=xxxxxxxxx', headers={'Authorization': 'YOUR_TOKEN_HERE'})
Réponse JSON
{
"@context": "/contexts/Agency",
"@id": "/agencies",
"@type": "hydra:Collection",
"hydra:totalItems": 672,
"hydra:member": [
{
"@id": "/agencies/3591",
"@type": "Agency",
"id": 3591,
"denomination": "MANPOWER - BOURG EN BRESSE",
"socialReason": "MANPOWER FRANCE",
"registrationNumber": "42995529713787",
"address": {
"@type": "Address",
"@id": "",
"address": "293 AVENUE DES GRANGES BARDES",
"zipcode": "01000",
"city": "BOURG-EN-BRESSE",
"latitude": 46.220441,
"longitude": 5.247577
}
},
{
"@id": "/agencies/3592",
"@type": "Agency",
"id": 3592,
"denomination": "MANPOWER - BOURG EN BRESSE BTP",
"socialReason": "MANPOWER FRANCE",
"registrationNumber": "42995529713803",
"address": {
"@type": "Address",
"@id": "",
"address": "293 AVENUE DES GRANGES BARDES",
"zipcode": "01000",
"city": "BOURG-EN-BRESSE",
"latitude": 46.220441,
"longitude": 5.247577
}
},
...
]
}
Cette API permet d’intégrer des listes d’articles dans les devis, ouvrages.
Paramètres d’entrée :
- token
- dossier
Retour :
- Trigramme
- Trigramme fabricant
- Code article
- Désignation longue
- Prix de chiffrage (pour l’instant retourne le prix public)
- Prix unitaire public (numérique, 5 décimales)
- Unité (ex. : ML, UN)
- Code famille produit (jusqu’à 5 niveaux, séparés par |)
- Quantité d’articles
- Date et heure de la mise à jour du panier
curl -X GET https://fronttest.tarifeo.net/API/cart?foldername=NomDuFolder -H "Authorization: Bearer <token>"
fetch('https://fronttest.tarifeo.net/API/cart?foldername=NomDuFolder', { headers: { 'Authorization': 'YOUR_TOKEN_HERE' } })
import requests
requests.get('https://fronttest.tarifeo.net/API/cart?foldername=NomDuFolder', headers={'Authorization': 'YOUR_TOKEN_HERE'})
Réponse JSON
{
"@context": "/context/Cart",
"@id": "",
"@type": "Cart",
"total": 0,
"currency": "EUR",
"LastUpdate": "2025-09-24T16:47:28.659",
"hydra:member": [
{
"codeCtm": 42,
"productCode": "062525",
"label": "BAES d’évacuation saillie à LEDS 45 lumens 1 heure IP43 IK07 SATI Connecté avec fonctionnalité Visibilité Augmenté et balisage lumineux d’évacuation, visualisation de l’état sur l’application Legrand ERPconnecté",
"unitPrice": 155.3,
"quotationPrice": 155.3,
"unit": "UN",
"productFamilyCode": "207",
"supplier": {
"code": "",
"price": "0"
},
"quantity": 1
}
]
}
Cette API permet de récupérer le prix de chiffrage. Elle est à intégrer dans les devis/ouvrages. Jusqu’à 100 références.
Paramètres d’entrée :
- token
- Nom dossier Tarifeo
- Nombre de références
Collection de :
- Trigramme
- Code article
Retour :
- Collection des prix de chiffrage
curl -X GET https://fronttest.tarifeo.net/API/quotation_price?foldername=NomDuFolder&totalItems=2&codeCtm[1]=XXX&manufacturerReference[1]=XXXXXX&codeCtm[2]=YYY&manufacturerReference[2]=YYYYYY -H "Authorization: Bearer <token>"
fetch('https://fronttest.tarifeo.net/API/quotation_price?foldername=NomDuFolder&totalItems=2&codeCtm[1]=XXX&manufacturerReference[1]=XXXXXX&codeCtm[2]=YYY&manufacturerReference[2]=YYYYYY', { headers: { 'Authorization': 'YOUR_TOKEN_HERE' } })
import requests
requests.get('https://fronttest.tarifeo.net/API/quotation_price?foldername=NomDuFolder&totalItems=2&codeCtm[1]=XXX&manufacturerReference[1]=XXXXXX&codeCtm[2]=YYY&manufacturerReference[2]=YYYYYY', headers={'Authorization': 'YOUR_TOKEN_HERE'})
Réponse JSON
{
"@context": "/contexts/QuotationPrice",
"@id": "/quotationprice",
"@type": "hydra:Collection",
"hydra:totalItems": 2,
"hydra:member": [
{
"@id": "",
"@type": "QuotationPrice",
"codeCtm": "YYY",
"manufacturerReference": "EMN001",
"quotationPrice": 92.58
},
{
"@id": "",
"@type": "QuotationPrice",
"codeCtm": "XXX",
"manufacturerReference": "062525",
"quotationPrice": 155.3
}
]
}
Liste des commandes validées
Cette API permet de récupérer la liste des commandes crées dans Tarifeo pour une agence.
Paramètres d’entrée :
- token
- Nom dossier
- SIRET
- Date de début (format AAAAMMJJ)
- Date de fin
Retour :
- Date de commande
- Numéro de commande
- Statut
- Total
curl -X GET https://fronttest.tarifeo.net/API/orders -H "Authorization: Bearer <token>"
fetch('https://fronttest.tarifeo.net/API/orders', { headers: { 'Authorization': 'YOUR_TOKEN_HERE' } })
import requests
requests.get('https://fronttest.tarifeo.net/API/orders', headers={'Authorization': 'YOUR_TOKEN_HERE'})
Réponse JSON
[
()
]
Détail d’une commande validée
Cette API permet de récupérer les détails d’une commande crée sur Tarifeo.
Paramètres d’entrée :
- token
- Dossier
- Numéro de commande
Retour :
- Numéro unique de la commande
- Numéro de commande fournisseur si existe
- Type de commande (220, 230 ou 231)
- Date de commande
- Devise utilisée
Informations sur le demandeur :
- Nom de la société-acheteuse
- SIRET de la société-acheteuse
- Adresse de la société-acheteuse
Contact du demandeur :
- Prénom NOM du créateur de la commande
- Mail du créateur de la commande
Informations sur le fournisseur
- Nom de l’agence fournisseur
- Siret de l’agence fournisseur
- Adresse complète de l’agence
- Prénom NOM du contact fournisseur
- Adresse mail du contact fournisseur
Lignes de commandes :
- Line ID
- Désignation du produit
- Code article du produit
- Quantité commandée
- Unité
- Prix Bet
- Taux de TVA de la ligne.
- Montant total HT de la ligne
Totaux de commande :
- Total HT (déjà existant)
- TVA Totale
- Total TTC
Informations logistiques / Livraison :
- Adresse de livraison
- Date de livraison souhaité
- Conditions de livraison
Informations de paiement :
- Mode de paiement (Virement / prélèvement)
- Conditions de paiement (A réception de facture / 30 jours fin de mois / 45 jours fin de mois)
- IBAN / BIC : coordonnées bancaires du vendeur.
curl -X GET https://fronttest.tarifeo.net/API/order?folderName=xxx&orderNumber=1 -H "Authorization: <token>"
fetch('https://fronttest.tarifeo.net/API/order?folderName=xxx&orderNumber=1', { headers: { 'Authorization': 'YOUR_TOKEN_HERE' } })
import requests
requests.get('https://fronttest.tarifeo.net/API/order?folderName=xxx&orderNumber=1', headers={'Authorization': 'YOUR_TOKEN_HERE'})
Cette API permet de créer une commande depuis l’ERP.
Paramètres d’entrée :
- token
- Dossier
- Numéro de commande dans l’ERP
- Type de commande (220, 230 ou 231)
- Date de commande
- Devise utilisée
Informations sur le demandeur :
- Nom de la société-acheteuse
- SIRET de la société-acheteuse
- Adresse de la société-acheteuse
Contact du demandeur :
- Prénom NOM du créateur de la commande
- Mail du créateur de la commande
Informations sur le fournisseur
- Nom de l’agence fournisseur
- Siret de l’agence fournisseur
- Adresse complète de l’agence
- Prénom NOM du contact fournisseur
- Adresse mail du contact fournisseur
Lignes de commandes :
- Line ID
- Désignation du produit
- Code article du produit
- Quantité commandée
- Unité
- Prix Bet
- Taux de TVA de la ligne.
- Montant total HT de la ligne
Totaux de commande :
- Total HT (déjà existant)
- TVA Totale
- Total TTC
Informations logistiques / Livraison :
- Adresse de livraison
- Date de livraison souhaité
- Conditions de livraison
Informations de paiement :
- Mode de paiement (Virement / prélèvement)
- Conditions de paiement (A réception de facture / 30 jours fin de mois / 45 jours fin de mois)
- IBAN / BIC : coordonnées bancaires du vendeur.
Retour :
- Statut commande (precommande, transmise aux fournisseurs, reçue par le fournisseur, validée)
curl -X GET https://fronttest.tarifeo.net/API/order -H "Authorization: Bearer <token>"
curl -X POST https://fronttest.tarifeo.net/API/order -H "Content-Type: application/json" -d '{"username": "user", "password": "pass"}'
import requests
requests.get('https://fronttest.tarifeo.net/API/order', headers={'Authorization': 'YOUR_TOKEN_HERE'})
Cette API permet de modifier une commande existante depuis l’ERP
Paramètres d’entrée :
- token
- Dossier
- Numéro de commande dans l’ERP
- Type de commande (220, 230 ou 231)
- Date de commande
- Devise utilisée
Informations sur le demandeur :
- Nom de la société-acheteuse
- SIRET de la société-acheteuse
- Adresse de la société-acheteuse
Contact du demandeur :
- Prénom NOM du créateur de la commande
- Mail du créateur de la commande
Informations sur le fournisseur
- Nom de l’agence fournisseur
- Siret de l’agence fournisseur
- Adresse complète de l’agence
- Prénom NOM du contact fournisseur
- Adresse mail du contact fournisseur
Lignes de commandes :
- Line ID
- Désignation du produit
- Code article du produit
- Quantité commandée
- Unité
- Prix Bet
- Taux de TVA de la ligne.
- Montant total HT de la ligne
Totaux de commande :
- Total HT (déjà existant)
- TVA Totale
- Total TTC
Informations logistiques / Livraison :
- Adresse de livraison
- Date de livraison souhaité
- Conditions de livraison
Informations de paiement :
- Mode de paiement (Virement / prélèvement)
- Conditions de paiement (A réception de facture / 30 jours fin de mois / 45 jours fin de mois)
- IBAN / BIC : coordonnées bancaires du vendeur.
Retour :
Statut commande (precommande, transmise aux fournisseurs, reçue par le fournisseur, validée