Récupérer le détail d’une opération financière (getcompensationdetails)

  • 1. Utilisation

    Ce webservice permet de récupérer le détail d’une opération financière donnée via son numéro de compensation.

    Dans le cas d’une opération de type « salestransfer » vous retrouverez la liste des articles qui vous ont été payés ainsi que d’autres données de type comptable (abonnement mensuel, ventes annulées, remboursement des frais de port, etc…).
    Ce webservice ne récupère que les éléments de facturations relatifs aux articles vendus. Il ne retourne pas les gestes ou pénalités commerciales.
    Ce webservice est accessible uniquement aux marchands professionnels.

  • 2. Url

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

  • 3. Paramètres

    Nom Description Obligatoire
    action getcompensationdetails 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
    compensationid Numéro de compensation récupéré via le WS getoperations Oui

     

  • 4. XSD

    http://www.fr.shopping.rakuten.com/res/schema/getcompensationdetails/getcompensationdetails.2011-03-29.xsd

  • 5. Erreurs possible

    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 parameter compensationid 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 The compensationid doesn’t exist.

  • 6. Données en retour

    Valeur Description
    sellerid Identifiant Rakuten France du compte vendeur
    lastversion Dernière version disponible du webservice
    compensationdetails  
    compensationid Numéro de la compensation
    compensationdate Date à laquelle la compensation a été créée
    invoicenumber Numéro de facture associée à cette compensation
    itempayment Balise désignant le paiement d’un article dans la compensation
    purchasedate Date de la commande associée à cet article
    purchaseid Numéro de la commande
    purchasebuyerlogin Pseudonyme de l’acheteur
    item  
    itemid Numéro de l’article concerné
    sku SKU de l’article
    headline Titre de l’article
    category Catégorie de l’article
    itemstatus Status de l’article
    Valeur possible :

    • CLOSED
    • ACCEPTED
    • CANCELLED
    • CLAIM
    itemsaleprice Prix de vente de l’article
    shippingsaleprice Montant des frais de port payé par l’acheteur
    itemcommissionvatrate Taux de TVA de la commission sur le montant article
    itemcommissionexcltax Montant HT de la commission sur le montant article
    itemcommissionvat Montant de la TVA de la commission sur le montant article
    shippingcommissionvatrate Taux de TVA de la commission sur les frais de port acheteur
    shippingcommissionexcltax Montant HT de la commission sur les frais de port acheteur
    shippingcommissionvat Montant de la TVA de la commission sur les frais de port acheteur
    paymentamount Montant total payé au vendeur
    cancelleditempayment Balise désignant l’annulation d’un article dans la compensation
    totalcancellationamount Montant total débité au vendeur
    itemadjustmentpayment Balise désignant un ajustement de la part de Rakuten France dans la compensation (remboursement frais de port au vendeur, etc…)
    itemadjustmentvatrate Taux de TVA sur les ajustements : sera toujours égal à zéro
    itemadjustmentamount Montant de l’ajustement payé par Rakuten France
    licensefee Balise désignant un abonnement marchand
    licensefeeid Numéro de l’abonnement marchand
    licensefeeperiod Période de l’abonnement marchand
    licensefeevatrate Taux de TVA appliqué sur le montant de l’abonnement
    licensefeeamountexcltax Montant HT de l’abonnement
    licensefeeamountvat Montant de la TVA sur l’abonnement
    licensefeeamountincltax Montant total prélevé par Rakuten France
    licensefeeasset Balise désignant un avoir sur un abonnement marchand
    licensefeeid Numéro de l’abonnement marchand concerné par l’avoir
    licensefeeperiod Période de l’abonnement marchand concerné par l’avoir
    licensefeeassetvatrate Taux de TVA appliqué sur le montant de l’avoir
    licensefeeassetamountexcltax Montant HT de l’avoir
    licensefeeassetamountvat Montant de la TVA sur l’avoir
    licensefeeassetamountincltax Montant total remboursé par Rakuten France

  • 7. Exemple de sortie 

    <getcompensationdetailsresult xsi:schemaLocation="http://www.fr.shopping.rakuten.com/res/schema/getcompensationdetails http://www.fr.shopping.rakuten.com/res/schema/getcompensationdetails/getcompensationdetails.2011-03-29.xsd" xmlns="http://www.fr.shopping.rakuten.com/res/schema/getcompensationdetails" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<request>
<user>TDMNEUF</user>
<compensationid>550000</compensationid>
<version>2011-03-29</version>
</request>
<response>
<sellerid>1089000</sellerid>
<lastversion>2011-03-29</lastversion>
<compensationdetails>
<compensationid>550000</compensationid>
<compensationdate>01/11/2003-09:00</compensationdate>
<invoicenumber>122000</invoicenumber>
// Cas d'un article payé normalement
<itempayment>
<purchasedate>23/10/2003-22:11</purchasedate>
<purchaseid>3307000</purchaseid>
<purchasebuyerlogin>aouragan1</purchasebuyerlogin>
<item>
<itemid>5273000</itemid>
<sku><![CDATA[3505373118965]]></sku>
<headline><![CDATA[Cheval Encyclopédie]]></headline>
<category><![CDATA[Logiciel PC]]></category>
<itemstatus>ACCEPTED</itemstatus>
<itemsaleprice>
<amount>14.15</amount>
<currency>EUR</currency>
</itemsaleprice>
<shippingsaleprice>
<amount>5.31</amount>
<currency>EUR</currency>
</shippingsaleprice>
<itemcommissionvatrate>19.6</itemcommissionvatrate>
<itemcommissionexcltax>
<amount>1.19</amount>
<currency>EUR</currency>
</itemcommissionexcltax>
<itemcommissionvat>
<amount>0.23</amount>
<currency>EUR</currency>
</itemcommissionvat>
<shippingcommissionvatrate>19.6</shippingcommissionvatrate>
<shippingcommissionexcltax>
<amount>0.59</amount>
<currency>EUR</currency>
</shippingcommissionexcltax>
<shippingcommissionvat>
<amount>0.11</amount>
<currency>EUR</currency>
</shippingcommissionvat>
<paymentamount>
<amount>17.34</amount>
<currency>EUR</currency>
</paymentamount>
</item>
</itempayment>
// Cas d'un article annulé
<cancelleditempayment>
<purchasedate>13/09/2009-19:39</purchasedate>
<purchaseid>75412000</purchaseid>
<purchasebuyerlogin>shaka01</purchasebuyerlogin>
<item>
<itemid>114343000</itemid>
<sku><![CDATA[AR79156]]></sku>
<headline><![CDATA[Cooler Master CoolViva G1 - Refroidisseur de carte vidéo avec dissipateurs thermiques pour mémoire - aluminium]]></headline>
<category><![CDATA[Accessoire]]></category>
<itemstatus>CANCELLED</itemstatus>
<itemsaleprice>
<amount>11.76</amount>
<currency>EUR</currency>
</itemsaleprice>
<shippingsaleprice>
<amount>6.4</amount>
<currency>EUR</currency>
</shippingsaleprice>
<itemcommissionvatrate>19.6</itemcommissionvatrate>
<itemcommissionexcltax>
<amount>1.04</amount>
<currency>EUR</currency>
</itemcommissionexcltax>
<itemcommissionvat>
<amount>0.0</amount>
<currency>EUR</currency>
</itemcommissionvat>
<shippingcommissionvatrate>19.6</shippingcommissionvatrate>
<shippingcommissionexcltax>
<amount>0.75</amount>
<currency>EUR</currency>
</shippingcommissionexcltax>
<shippingcommissionvat>
<amount>0.0</amount>
<currency>EUR</currency>
</shippingcommissionvat>
<totalcancellationamount>
<amount>16.37</amount>
<currency>EUR</currency>
</totalcancellationamount>
</item>
</cancelleditempayment>
// Cas d'un item adjustment
<itemadjustmentpayment>
<purchasedate>31/03/2010-19:20</purchasedate>
<purchaseid>84660000</purchaseid>
<purchasebuyerlogin>ziamobile</purchasebuyerlogin>
<item>
<itemid>131742000</itemid>
<sku><![CDATA[RO10009230]]></sku>
<headline><![CDATA[Lancement une Raquette Explosive Dans La Tranchée Ennemie.]]></headline>
<category><![CDATA[Revue]]></category>
<itemstatus>CANCELLED</itemstatus>
<itemadjustmentvatrate>0</itemadjustmentvatrate>
<itemadjustmentamount>
<amount>3.3</amount>
<currency>EUR</currency>
</itemadjustmentamount>
</item>
</itemadjustmentpayment>
// Cas d'un abonnement marchand
<licensefee>
<licensefeeid>031000</licensefeeid>
<licensefeeperiod>07/2010</licensefeeperiod>
<licensefeevatrate>19.6</licensefeevatrate>
<licensefeeamountexcltax>
<amount>19.99</amount>
<currency>EUR</currency>
</licensefeeamountexcltax>
<licensefeeamountvat>
<amount>3.92</amount>
<currency>EUR</currency>
</licensefeeamountvat>
<licensefeeamountincltax>
<amount>23.91</amount>
<currency>EUR</currency>
</licensefeeamountincltax>
</licensefee>
// Cas d'un abonnement marchand remboursé (partiellement ou non)au vendeur
<licensefeeasset>
<licensefeeid>100000</licensefeeid>
<licensefeeperiod>06/2010</licensefeeperiod>
<licensefeeassetvatrate>19.6</licensefeeassetvatrate>
<licensefeeassetamountexcltax>
<amount>19.99</amount>
<currency>EUR</currency>
</licensefeeassetamountexcltax>
<licensefeeassetamountvat>
<amount>3.92</amount>
<currency>EUR</currency>
</licensefeeassetamountvat>
<licensefeeassetamountincltax>
<amount>23.91</amount>
<currency>EUR</currency>
</licensefeeassetamountincltax>
</licensefeeasset>
</compensationdetails>
</response>
</getcompensationdetailsresult>

Privacy Preference Center

Privacy Preferences