Importer les nouvelles commandes (getnewsales)

  • 1. Utilisation

    Ce Webservice permet de récupérer la liste des nouvelles ventes (ventes à confirmer).

    Il est accessible à la fois aux vendeurs particuliers et aux marchands pro.
    Cependant, les particuliers n’auront pas accès aux données relatives aux coordonnées de l’acheteur (pour cela ils devront tout d’abord confirmer la vente puis invoquer le WS getshippinginformation).

  • 2. Url

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

  • 3. Paramètres

    Nom Description Obligatoire
    action getnewsales 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 à utiliser
    Cliquer ici pour voir le dernier numéro de version    		 Oui

  • 4. XSD

    https://www.fr.shopping.rakuten.com/res/schema/getnewsales/getnewsales.2017-08-07.xsd

  • 5. Erreurs possibles

    Type Code Message Detail
    Sender Parameters Error Problem with parameters The parameter login is mandatory
    Sender Parameters Error Problem with parameters The parameter pwd is mandatory
    Sender Parameters Error Problem with parameters The parameter version is mandatory
    Sender InvalidUserRights Problem with user rights. The user nickname is not allowed to use web services.
    Sender InvalidUserConnection User is from another country. The user ‘XXX’ is not from this platform.
    Sender Incorrect status error Incorrect purchase status. Current status : xxx – Required status : REQUESTED

  • 6. Données en retour

    Here is a general overview of the available data. Refer to XSD for details.

    Value Description
    response
    lastversion Latest available version of WS (to be used as a priority)
    Format : AAAA-MM-JJ
    sellerid Rakuten France seller account user name
    sales
    sale
    purchaseid Rakuten France order username
    purchasedate Order date
    deliveryinformation
    shippingtype Shipping type
    Possible values:

    • Normal
    • Suivi
    • Recommandé
    • So Colissimo
    • Chronopost
    • Express
    • Point relais Mondial Relay
    • Retrait chez le vendeur
    • Retrait gratuit en magasin
    isfullrsl Indicates if all ordered products are shipped by the RSL Service
    Possible values:

    • Y
    • N
    pickupStoreId Only for “Retrait gratuit en magasin” shipping type
    purchasebuyerlogin Buyer login
    purchasebuyeremail Buyer email address

    Only supplied in the webservice GetCurrentSales

    collectionpointaddress Address of the collection point
    (For deliveries in collection point)
    civility Civility
    lastname Last name
    firstname First Name
    id Id of the collection point
    name Name of the collection point
    address Adress
    zipcode Zip code
    city City
    country Country
    contractlevel Level of service (only for Mondial Relay)
    deliveryaddress OR
    billingaddress    		 deliveryaddress OR
    billingaddress only when shipping modes are So Colissimo, Chronopost, points relais et Retrait chez le vendeur.
    civility Seller title

    Possible values FR :

    • M.
    • Mme
    • Mlle
    lastname Buyer’s last name
    firstname Buyer’s first name
    address1 Buyer’s address
    address2 Address supplement
    zipcode Zip code
    city City
    state State/ Region
    country Country
    Valeurs possibles :

    FR
    France métro.
    Andorre
    Belgique
    Luxembourg
    Suisse
    Guadeloupe
    Guyane
    Martinique
    La Réunion
    Allemagne
    Autriche
    Canada
    Danemark
    Espagne
    Etats-Unis
    Finlande
    Gibraltar
    Grèce
    Irlande
    Italie
    Liechtenstein
    Norvège
    Pays bas
    Portugal
    Royaume uni
    Suède
    Vatican
    countryalpha2 Alpha 2 country code

    Possible values : http://en.wikipedia.org/wiki/ISO_3166-1#SC
    phonenumber1 Buyer’s telephone number

    Only supplied to eligible sellers
    phonenumber2 Buyer’s telephone number

    Only supplied to eligible sellers
    items
    item
    sku Seller’s private reference
    advertid Rakuten France listing Id
    advertpricelisted
    amount Original selling price of the item (excluding negotiation, campaign, promotion)
    currency Currency
    itemid Rakuten France article reference
    headline Article title
    itemstatus Item status
    Possible values :

    • COMMITED
    • REQUESTED ou REMINDED
    • CANCELLED

    See status details

    ispreorder Indicates if the item is a pre-order
    Possible values :

    • Y
    • N
    isnego Indicate if the sale is a negotiation on behalf of the seller. It’s an option you activate in your account.
    Possible values:

    • Y
    • N
    negociationcomment Negotiation commentary (only if isnego is equal to Y) if it is provided by the buyer
    price
    amount Selling price
    currency Currency
    isrsl Indicates if the item is shipped by RSL (Y or N)
    isbn Article’s ISBN
    ean Article’s EAN
    paymentstatus Status of payment

    Possible values:

    • INCOMING
    sellerscore Buyer’s rating

    Possible values :

    • No current return value

  • 7. Output example

    Ouvrir

Privacy Preference Center

Privacy Preferences