Swagger

Endpoints

Méthode

Chemin

Description

POST

/login

Récupère le token d’authentification

GET

/catalogs

Liste des catalogues fabricants/fournisseurs

GET

/product_families

Liste des familles de produits

GET

/products

Liste des articles (pagination, filtrage par famille)

GET

/product_infos

Met à jour le prix d’achat fournisseur

GET

/suppliers

Récupérer la liste des fournisseurs
qui permettront initialiser l’ERP

GET

/agencies

Récupérer la liste des agences
qui permettront initialiser l’ERP.

GET

/cart

Intègre des articles dans devis/commandes

GET

/quotation_price

Récupérer le prix de chiffrage

GET

/orders

Liste des commandes validées

GET

/order

Détail d’une commande validée

POST

/order  

Création d’une commande

PUT

/order

Modification d’une commande

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

Retour en haut