Confirmer l’envoi des commandes (importitemshippingstatus)

  • 1. Utilisation

    Ce webservice permet:

    • d’envoyer le numéro de tracking sur plusieurs articles,
    • d’informer le client l’envoi des commandes pour tous les modes d’expédition (y compris le mode Normal),
    • d’ajouter un tag <shipped>1</shipped> dans les webservices GetCurrentSales, GetItemsInfos et GetBillingInformation.
    • et d’activer la compensation accélérée (à condition que le compte vendeur est éligible).

     

    L’appel de ce webservice déclenche un message dans l’interface du client et lui envoi un mail avec le lien du colis. Le mail ne contiendra pas de lien de suivi si l’envoi s’effectue en mode Normal.

     

    Ce webservice est accessible aux marchands professionnels.

  • 2. Url

    https://ws.fr.shopping.rakuten.com/sales_ws?action=importitemshippingstatus&login=xxxxxx&pwd=xxxxxx&version=xxxx-xx-xx

     

    IMPORTANT : Il faut transmettre le fichier d’import de stock en POST / multiPart.
    (Par exemple, en simulant l’envoi d’un formulaire HTML en POST, ou en utilisant des fonctions java, PHP, Curl … d’upload en MultiPart de fichiers)

  • 3. Paramètres

    Nom Description Obligatoire
    action importitemshippingstatus Oui
    login login du vendeur Oui
    pwd Vous avez besoin de votre Token. Plus d’informations ICI. Et vous trouverez votre Token ICI. Oui
    version Version du webservice
    Cliquer ici pour voir le dernier numéro de version    		 Oui
    file Le fichier en tant que tel
    Cliquer ici pour voir la structure du fichier    		 Oui

  • 4. XSD

    https://www.fr.shopping.rakuten.com/res/schema/importitemshippingstatus/importitemshippingstatus.2016-05-09.xsd

  • 5. Exemple de fichier à envoyer

    Ouvirir

  • 6. Liste des transporteurs disponibles et consignes

    Consignes concernant le Transporteur (balise “transporter”)

    Il s’agit d’indiquer le nom du transporteur. Vous devez impérativement utiliser les même textes listés dans le tableau ci-dessous.

    En revanche, pour les modes “Normal” et “Retrait chez le vendeur”, vous devez laisser la balise “transporter” vide.

    Consignes concernant le Numéro de suivi (balise “trackingnumber”)

    Indiquez dans cette balise la valeur correspondante au numéro de suivi de votre transporteur.

    Pour les modes “Normal” et envois en mode prépayés “So Colissimo”, “Chronopost”, “Mondial Relay prépayé”, “Click and Collect” et “Retrait chez le vendeur”, vous devez renseigner la valeur “1”, “oui” ou “yes”.

    Consignes concernant l’URL (balise “trackingurl”)

    Il s’agit de transmettre l’URL pour permettre à l’acheteur de suivre l’acheminement de son colis. Cette donnée est obligatoire uniquement pour les transporteurs Autre. Pour les autres transporteurs, Rakuten France utilisera une adresse de tracking pré-remplie valable uniquement pour tout envoi depuis la France. Pour tout envoi depuis un autre pays, il est conseillé d’utiliser le transporteur “Autre”.

     

    Transporteur trackingnumber obligatoire trackingurl obligatoire Express
    Colis Prive x
    SFC Service x
    So Colissimo x
    Colissimo x
    Bluecare x
    Continental x
    Geodis x
    China Post x
    WeDo Logistics x
    4PX x
    Autre x x
    DPD x x
    Mondial Relay x
    Mondial Relay prépayé
    Chronopost x x
    TNT x x
    UPS x x
    Fedex x x
    Tatex x x
    GLS x x
    GLS-ITALY x
    DHL x x
    France Express x x
    Kiala x
    Cubyn x
    DPD Germany x
    DPD UK x
    B2C Europe x
    TrackYourParcel x
    Yun Express x
    China EMS x
    Swiss Post x
    Courrier Suivi x
    Exapaq x
    PostNL International x
    Royal Mail x
    CNE Express x
    S.F. Express x
    Singapore Post x
    Hong Kong Post x
    Bpost x

    6. Possible errors

    Type Code Message Detail
    Sender ParameterError Problem with parameters The parameter ‘login’ is mandatory
    Sender ParameterError Problem with parameters The parameter ‘pwd’ is mandatory
    Sender ParameterError Problem with parameters The parameter ‘version’ is mandatory
    Sender ParameterError Problem with parameters The version XXX is not supported
    Sender InvalidUserConnection Unknown user or password. Incorrect login or password
    Sender ParameterError Problem with parameters Article xxxx : numéro incorrect
    Sender ParameterError Problem with parameters Article xxxx : a déjà été expédié
    Sender ParameterError Problem with parameters Article xxxx : statut incorrect. L’enregistrement de votre numéro de suivi n’est possible que si le statut de votre article est “confirmé”.
    Sender ParameterError Problem with parameters Le fichier XML importé n’a pas le formatage attendu (respectez la structure du fichier modèle)
    Sender ParameterError Problem with parameters Le fichier soumis ne doit pas être vide

  • 7. Données en retour

    Valeur Description
    request Votre requête
    response La réponse
    lastversion Dernière version disponible du webservice
    status Status de votre requete

  • 8. Exemples de sortie

    En cas de succès

    Ouvirir

    En cas d’échec

    Ouvirir

Privacy Preference Center

Privacy Preferences