Nafha — Dropshipping parfums Maroc

Connectez votre propre site de vente à Nafha : les commandes passées chez vous arrivent automatiquement dans votre onglet « Nouvelle », sans rien saisir à la main. Cette page est à transmettre à la personne qui développe votre site.

Authentification

Deux en-têtes HTTP obligatoires sur chaque requête, GET comme POST :

En-tête	Valeur	Rôle
apikey	<voir exemples ci-dessous>	Autorise l'accès à la passerelle
Authorization	Bearer <clé_vendeur>	Identifie le vendeur et son tarif

Pour les requêtes POST, ajouter aussi : Content-Type: application/json

⚠️ Régénérer la clé invalide instantanément l'ancienne, sans avertissement. Une erreur 401 soudaine signale probablement une clé régénérée entre-temps.

Lire le catalogue (GET)

« parfums[].id » est l'identifiant à utiliser pour commander ; « disponible:false » doit être masqué côté site. « tarif » est le prix par unité propre à ce vendeur — c'est toujours celui-là qui est facturé, jamais un prix saisi côté site.

Créer une commande (POST)

Gardez « id » (pas seulement « reference ») : c'est la clé à fournir à l'endpoint de suivi ci-dessous. « reference » n'est qu'un affichage court (ex. pour l'écran du livreur), pas une clé fiable sur la durée.

Suivre une commande (GET)

Le téléphone du client final est exigé en plus de l'id — pas seulement l'id seul — parce que cette page est faite pour être affichée directement à votre client (une page « suivre ma commande »), et qu'un id qui circule (SMS, historique du navigateur…) ne doit pas suffire à n'importe qui pour consulter le statut. Réponse 404 générique et identique si l'id est inconnu, si le téléphone ne correspond pas, ou si la commande appartient à un autre vendeur — jamais d'indice sur laquelle de ces raisons s'applique. « cathedis_refus_motif » n'est renseigné que si Cathedis a refusé l'envoi.

Suivre une commande par votre référence (GET)

Pour un usage back-end à back-end (votre système interroge le statut d'une commande par la référence que vous lui avez donnée vous-même via « note » à la création) : la clé API suffit, pas besoin du téléphone client. Réponse 404 si cette note est introuvable pour votre compte.

Erreurs

Code	Cause	Action
400	Corps de requête invalide (champ manquant ou mal formé)	Corriger le corps de la requête et réessayer
401	Clé manquante, fausse, ou régénérée depuis	Vérifier l'en-tête Authorization ; si besoin, régénérer et mettre à jour votre site
404	Commande introuvable (id inconnu, téléphone qui ne correspond pas, ou commande d'un autre vendeur)	Vérifier l'id et le téléphone transmis ; cette réponse ne précise jamais laquelle des deux informations est en cause
405	Méthode HTTP invalide	Vérifier GET (catalogue) / POST (commande)
422	Requête bien formée, mais règle métier refusée (ville invalide, solde négatif, plafond de commandes atteint, minimum de pièces non atteint…)	Lire le message renvoyé, corriger côté site, réessayer
429	Trop de requêtes pour cette clé	Espacer les appels, notamment la lecture régulière du catalogue

400 = la requête elle-même est mal formée ; 422 = la requête est valide mais une règle métier la refuse.

Sécurité et bonnes pratiques

Idéalement, appeler l'API depuis le back-end de votre site, pas depuis le JavaScript du navigateur — sinon la clé est visible dans le code source.
CORS ouvert, aucune configuration nécessaire côté site vendeur.
Limite de fréquence par clé API : espacez vos appels, en particulier la lecture régulière du catalogue.
Ne partagez jamais votre clé publiquement ; en cas de doute, régénérez-la immédiatement depuis cette page.
Testez GET et POST (avec le minimum de pièces indiqué dans l'exemple) avant de brancher le vrai tunnel de commande.

Aujourd'hui

Commandes reçues

Unités à préparer

Encaissé (livré)

Taux de retour

0 %

Commandes

Vendeurs

Classement du mois

Demandes d'échantillons

Demandes de code d'accès

Catalogue

Intégration 33ML (stock)

Colle l'export SKU → nom fourni par 33ML (un par ligne, ex. « 03-EDP;1 Million »). Les correspondances proposées restent à vérifier et valider une par une avant d'être utilisées — jamais automatique.

Tarifs et règles

Prix d'achat vendeur — à partir de X unités

Prix de vente conseillé — à partir de X unités

Message de l'usine — affiché en haut de l'espace vendeur

Pénalité par colis retourné (DH)

Commandes max — vendeur neuf

Après 1^re livraison

Livraison offerte à tous les clients, quelle que soit la quantité ou la ville : les réglages ci-dessous ne comptent plus dans ce qui est facturé au client, ils restent juste affichés ici.

Frais de livraison (DH)

Offerte à partir de — pièces

Sous ce seuil, la livraison est payée par

Kit échantillons — flacons

Prix du kit (DH)

Kit offert à partir de — commandes livrées, 0 = jamais offert

Quantités visibles par les vendeurs

Cadeau du meilleur vendeur du mois

Le challenge s'ouvre à un total mensuel de — pièces livrées

Présentoir offert à partir de — en pièces

Tarif famille (DH la pièce)

Tarif équipe (DH la pièce)

Dès combien de pièces une commande passe au tarif famille

Minimum par commande — en pièces

Votre idée du jour

Le présentoir offert

Mon profil

Mes commandes

Où vous êtes payé

Connecter mon site

Vos échantillons

Comment ça marche

Nouvelle commande

Client final

Kit d'échantillons

Où vous livrer

Authentification

Lire le catalogue (GET)

Créer une commande (POST)

Suivre une commande (GET)

Suivre une commande par votre référence (GET)

Erreurs

Sécurité et bonnes pratiques

Aujourd'hui

Vue plateforme

Commandes

Vendeurs

Classement du mois

Demandes d'échantillons

Demandes de code d'accès

Catalogue

Parfums retirés

Intégration 33ML (stock)

Tarifs et règles

Vendez nos parfums sans acheter de stock

Mot de passe oublié

Votre idée du jour

Le présentoir offert

Mon profil

Mes commandes

Où vous êtes payé

Connecter mon site

Vos échantillons

Comment ça marche

Nouvelle commande

Client final

Kit d'échantillons

Où vous livrer

Authentification

Lire le catalogue (GET)

Créer une commande (POST)

Suivre une commande (GET)

Suivre une commande par votre référence (GET)

Erreurs

Sécurité et bonnes pratiques

Aujourd'hui

Vue plateforme

Commandes

Vendeurs

Classement du mois

Demandes d'échantillons

Demandes de code d'accès

Catalogue

Parfums retirés

Intégration 33ML (stock)

Tarifs et règles