1. Accueil
  2. Docs
  3. Documentation Amzpecty
  4. Spécifications de l'API Amzpecty
  5. API d'estimation des bénéfices

API d'estimation des bénéfices

AJOUTER ASIN/ISBN POUR ESTIMATION DE LA QUEUE DE REQUÊTE DE PROFITE

La demande d'ajout d'un ASIN/ISBN à la file d'attente de requêtes Estimate Profit.

DÉDUCTION DE CRÉDIT

1 (un) crédit déduction après récupération réussie des données MFN et FBA.

Déduction supplémentaire de 1 (un) crédit pour chacun des paramètres facultatifs suivants.

  • includefbalight – (booléen facultatif) – si vrai, inclura FBA Small et Light
  • includeefn – si vrai, inclura le réseau européen de distribution (EFN)
  • includepaneu – si vrai, inclura PAN – Expédié par Amazon européen
  • includepaneulight – si vrai, inclura PAN – European FBA Small and Light
DEMANDE
URI /api/query/estprofit/{ASIN/ISBN}?writingprice={sellprice}&myfbacost={myfbacost}&mymfncost={mymfncost}&domain={domain}&secretKey={secretKey}&serviceaddons=inventoryplacement,opaquebagging,tape,label,bagging, papier bulle&peakstorage=true {ASIN/ISBN} – obligatoire – l'ASIN ou l'ISBN à ajouter à la file d'attente des requêtes d'estimation des bénéfices
{prix de vente} – numérique | requis – Le prix de vente cible de l’ASIN
{monfbacost} – numérique | facultatif – Le coût total d'exécution Expédié par Amazon du vendeur, hors frais Amazon. La valeur par défaut est 0.00 si non spécifié.
{moncoûtmfn} – numérique | facultatif – Le coût total d'exécution MFN, y compris les frais d'expédition, la main-d'œuvre, les matériaux d'emballage, l'expédition au client, le service client, les frais de stockage et les autres coûts du vendeur, à l'exclusion des frais Amazon. La valeur par défaut est 0.00 si non spécifié.
{serviceaddons} –facultatif – Modules complémentaires du service de coût d’exécution. Valeurs valides séparées par des virgules [stockplacement,opaquebagging,tape,label,bagging,bubblewrap]. Les modules complémentaires de service sont désactivés par défaut, sauf indication contraire sur la valeur de ce paramètre.
{stockage de pointe} – booléen | facultatif – Indicateur indiquant l’utilisation du coût de stockage de pointe. La valeur par défaut est false si non spécifié.
{includefbalight} – booléen | facultatif – si vrai, cela inclura Expédié par Amazon Small et Light
{Inclureefn} – booléen | facultatif – si vrai, cela inclura le réseau européen de distribution (EFN)
{Inclure le panneau} – booléen | facultatif – si vrai, inclura PAN – Expédié par Amazon européen
{Inclurepaneulight} – booléen | facultatif – si vrai, inclura PAN – European FBA Small and Light
(paramètres facultatifs)
{efnmarketplace} = (chaîne) – valeurs valides (DE, FR, IT, ES, UK) <-- (par défaut, basé sur le domaine)
{efninventoryplace} = (chaîne) – valeurs valides (DE, FR, IT, ES, UK) <-- (par défaut, basé sur le domaine)
{efncee} = (booléen) – indicateur pour activer le programme Utiliser l’Europe centrale <-- (vrai par défaut)
REMARQUE : EFN, PAN-EU et PAN-EU Light ne seront inclus que si le domaine est DE, FR, IT, ES, UK.
{domaine} – facultatif – par défaut www.amazon.com si non spécifié. Voir Domaines Amazon pris en charge pour la liste.
En-tête HTTP (facultatif) AMZPECTY_CALLBACK_URL={Votre URL de rappel}
Exemple /api/query/estprofit/B089B74PC4?sellingprice=15.00&secretKey=XXXXXXXXXX&myfbacost=4.99&mymfncost=3.99
RÉPONSE
En-têtes
Type de support application / json
Données JSON
JSON
{
    "status": "OK",
    "responsefor": "estprofit",
    "allowed": 4992,
    "dailyAllowed": 4992,
    "messageId": null,
    "message": null,
    "data": null,
    "rid": "60f126e20cf24280ed03be54",
    "dateProcessed": null,
    "domain": null
}

Notes: Lors du rappel, le rid peut être utilisé pour lier les données de rappel à l'appel de la demande d'origine.

RAPPEL DE REQUÊTE D'ESTIMATION DU PROFIT

DEMANDE DE RAPPEL D'ESTIMATION DU PROFIT
En-têtes Exemple : https://your.server.com/amzpecty_result {Veuillez fournir l'URL dans la page Préférences} L'URL doit être activée pour SSL. AMZPECTY-API-SECRET-KEY (nom de l'en-tête) – l'en-tête de clé secrète sera inclus pour que le serveur de rappel valide l'origine de la demande
Type de support application / json
ESTIMATION DU PROFIT REQUÊTE RAPPEL DONNÉES JSON EXEMPLE
En-têtes
Type de support application / json
Données JSON
JSON
{
  "status": "OK",
  "responsefor": "estprofit",
  "allowed": 4978,
  "dailyAllowed": null,
  "messageId": null,
  "message": null,
  "data": {
    "asin": "B00WV6B7SA",
    "sellingPrice": 21.9,
    "myFBACost": 0,
    "myMFNCost": 0,
    "fba": {
      "estimatedNetProfit": 8.66,
      "estimatedNetMargin": 39.54,
      "referralRate": 15,
      "referralFee": 3.38,
      "fixedClosingFee": 0.99,
      "variableClosingFee": 0,
      "fulfillmentFee": 5.18,
      "estimatedVATRate": 20,
      "estimatedVATAmount": 3.65,
      "storageFee": 0.04,
      "peakSeasonStorage": false,
      "orderHandlingFee": 0,
      "pickAndPackFee": 0,
      "weightHandlingFee": 0
    },
    "fbaStatus": "Completed",
    "mfn": {
      "estimatedNetProfit": 13.88,
      "estimatedNetMargin": 63.38,
      "referralRate": 15,
      "referralFee": 3.38,
      "fixedClosingFee": 0.99,
      "variableClosingFee": 0,
      "estimatedVATRate": 20,
      "estimatedVATAmount": 3.65
    },
    "mfnStatus": "Completed",
    "fbaLight": {
      "estimatedNetProfit": 8.66,
      "estimatedNetMargin": 39.54,
      "referralRate": 15,
      "referralFee": 3.38,
      "fixedClosingFee": 0.99,
      "variableClosingFee": 0,
      "fulfillmentFee": 5.18,
      "estimatedVATRate": 20,
      "estimatedVATAmount": 3.65,
      "storageFee": 0.04,
      "peakSeasonStorage": false,
      "orderHandlingFee": 0,
      "pickAndPackFee": 0,
      "weightHandlingFee": 0
    },
    "fbaLightStatus": "Completed",
    "efn": {
      "inventoryPlaceIn": "FR",
      "marketplace": "FR",
      "ceeEnabled": true,
      "estimatedNetProfit": 6.58,
      "estimatedNetMargin": 30.05,
      "referralRate": 15,
      "referralFee": 3.38,
      "fixedClosingFee": 0.99,
      "variableClosingFee": 0,
      "fulfillmentFee": 7.26,
      "estimatedVATRate": 20,
      "estimatedVATAmount": 3.65,
      "storageFee": 0.04,
      "peakSeasonStorage": false,
      "orderHandlingFee": 0,
      "pickAndPackFee": 0,
      "weightHandlingFee": 0
    },
    "efnStatus": "Completed",
    "panEU": {
      "inventoryPlaceIn": "FR",
      "marketplace": "FR",
      "ceeEnabled": true,
      "estimatedNetProfit": 8.66,
      "estimatedNetMargin": 39.54,
      "referralRate": 15,
      "referralFee": 3.38,
      "fixedClosingFee": 0.99,
      "variableClosingFee": 0,
      "fulfillmentFee": 5.18,
      "estimatedVATRate": 20,
      "estimatedVATAmount": 3.65,
      "storageFee": 0.04,
      "peakSeasonStorage": false,
      "orderHandlingFee": 0,
      "pickAndPackFee": 0,
      "weightHandlingFee": 0
    },
    "panEUStatus": "Completed",
    "panEULight": {
      "inventoryPlaceIn": "FR",
      "marketplace": "FR",
      "ceeEnabled": true,
      "estimatedNetProfit": 8.66,
      "estimatedNetMargin": 39.54,
      "referralRate": 15,
      "referralFee": 3.38,
      "fixedClosingFee": 0.99,
      "variableClosingFee": 0,
      "fulfillmentFee": 5.18,
      "estimatedVATRate": 20,
      "estimatedVATAmount": 3.65,
      "storageFee": 0.04,
      "peakSeasonStorage": false,
      "orderHandlingFee": 0,
      "pickAndPackFee": 0,
      "weightHandlingFee": 0
    },
    "panEULightStatus": "Completed"
  },
  "rid": "6437751e0cf210053fa49cc1",
  "dateProcessed": 1681356063853,
  "domain": "www.amazon.fr",
  "totalCreditsDeducted": 1
}
ESTIMATION DU PROFIT REQUÊTE RÉPONSE DE RAPPEL ATTRIBUTS JSON
Nom d'attributDétails
statutsLe statut de la demande.
réponsepourValeur « sellerinfo » pour le résultat de la requête Informations sur le vendeur.
permisLe nombre de demandes actuellement autorisées. Se réinitialise mensuellement.
quotidiennementAutoriséNombre de demandes quotidiennes actuellement autorisées. Se réinitialise quotidiennement.
ID du messageL'identifiant du message (le cas échéant).
messageLe message réel (le cas échéant). Veuillez vous référer aux messages d'erreur.
débarrasserL’identifiant de la demande. Cela peut être utilisé dans la requête Get comme clé.
domaineLe domaine Amazon correspondant pour le vendeur.
totalCréditsDéduitCe champ indique combien de crédits API Amzpecty ont été utilisés pour répondre à cette demande.
dateTraitéDate à laquelle la demande a été traitée au format horaire Unix.
données.asinL'ASIN du produit.
data.sellPrixLe prix de vente du vendeur.
data.myFBACoûtLe vendeur a spécifié le coût total de traitement Expédié par Amazon. (À l'exclusion des frais Amazon)
data.myMFNCostLe vendeur a spécifié le coût total d'exécution du traitement NPF. (À l'exclusion des frais Amazon)
data.fbaStatutStatut de recherche de données sur les frais Expédié par Amazon. « Terminé » ou « Impossible d'obtenir les données ».
data.fba.estimatedNetProfitLe montant estimé du bénéfice net Expédié par Amazon.
data.fba.estimatedNetMarginLe pourcentage de bénéfice net estimé de Expédié par Amazon.
data.fba.referralFeeLe montant des frais de parrainage Amazon FBA.
data.fba.referralRateLe pourcentage des frais de parrainage Amazon FBA.
data.fba.variableClosingFeeLes frais de clôture variables Amazon FBA.
data.fba.fulfillmentFeeLes frais de traitement Amazon FBA.
data.fba.estimatedVATRateLe rat de cuve Expédié par Amazon estimé
data.fba.estimatedVATAmountLe montant estimé de la TVA Expédié par Amazon
data.fba.serviceAddons. Frais d'ensachageLes frais d’emballage du module complémentaire Amazon FBA Service.
data.fba.serviceAddons. inventairePlacementFraisLes frais de placement d'inventaire du module complémentaire du service Amazon FBA.
data.fba.serviceAddons. bubbleWrapFraisLes frais d'emballage à bulles du module complémentaire du service Amazon FBA.
data.fba.serviceAddons. frais d'étiquetageLes frais d'étiquetage du service Amazon FBA.
data.fba.serviceAddons. frais d'enregistrementLes frais d’enregistrement du module complémentaire du service Amazon FBA.
data.fba.serviceAddons. opaqueBaggingFeeLes frais d'emballage opaque du module complémentaire de service Amazon FBA.
data.fba.orderHandlingFeeDÉCONSEILLÉ depuis septembre 2022. Les frais de traitement des commandes Amazon FBA.
data.fba.peakSeasonStorageL’indicateur des frais de stockage Amazon FBA Peak Season.
data.fba.storageFeeLes frais de stockage Amazon FBA.
data.fba.pickAndPackFeeDÉCONSEILLÉ depuis septembre 2022. Les frais de sélection et d’emballage Amazon FBA.
data.fba.fixedClosingFeeLes frais de clôture fixes d'Amazon FBA.
data.fba.weightHandlingFeeDÉCONSEILLÉ depuis septembre 2022. Les frais de gestion du poids Amazon FBA.
data.mfnStatusStatut de recherche de données sur les frais MFN. « Terminé » ou « Impossible d'obtenir les données ».
data.mfn.estimatedNetProfitLe montant estimé du bénéfice net NPF.
data.mfn.estimatedNetMarginLe pourcentage de bénéfice net NPF estimé.
data.mfn.referralFeeLe montant des frais de parrainage Amazon MFN.
data.mfn.referralRateLe pourcentage des frais de parrainage Amazon MFN.
data.mfn.variableClosingFeeLes frais de clôture variables Amazon MFN.
data.mfn.fixedClosingFeeLes frais de clôture fixes d'Amazon MFN.
data.mfn.estimatedVATRateLe taux de TVA NPF estimé
data.mfn.estimatedVATAmounLe montant estimé de la TVA Expédié par Amazon
data.fbaLightStatusStatut de recherche de données sur les frais FBA Light. « Terminé » ou « Impossible d'obtenir les données ».
data.fbaLight.estimatedNetProfitLe montant estimé du bénéfice net Expédié par Amazon Light.
data.fbalight.estimatedNetMarginPourcentage de marge nette FBA Light estimé.
data.fbalight.referralRateLe pourcentage des frais de parrainage Amazon FBA Light.
data.fbalight.referralFeeLe montant des frais de parrainage Amazon FBA Light.
data.fbalight.fixedClosingFeeLes frais de clôture fixes Amazon FBA Light.
data.fbalight.variableClosingFeeLes frais de clôture variables Amazon FBA Light.
data.fbalight.fulfillmentFeeLes frais de traitement Amazon FBA Light.
data.fbalight.storageFeeLes frais de stockage Amazon FBA Light.
data.fbalight.peakSeasonStorageLe drapeau des frais de stockage Amazon FBA Light Peak Season.
data.fbalight.orderHandlingFeeLes frais de traitement des commandes Amazon FBA Light.
data.fbalight.pickAndPackFeeLes frais de sélection et d'emballage Amazon FBA Light.
data.fbalight.weightHandlingFeeLes frais de traitement légers Amazon FBA.
data.fbalight.estimatedVATRateLe taux de TVA léger Expédié par Amazon estimé
data.fbalight.estimatedVATAmountLe montant estimé de la TVA légère Expédié par Amazon
data.efnStatusStatut de recherche de données sur les frais EFN. « Terminé » ou « Impossible d'obtenir les données ».
data.efn.inventoryPlaceInL'emplacement de l'inventaire dans EFN
data.efn.marketplaceLe marché sur lequel la commande a été passée. Valeurs valides (DE, FR, IT, ES, UK)
data.efn.ceeEnabledLe drapeau lorsque le programme Europe centrale est activé.
data.efn.estimatedNetProfitLe montant estimé du bénéfice net de l’EFN.
data.efn.estimatedNetMarginLe pourcentage de marge nette EFN estimé.
data.efn.referralRateLe pourcentage des frais de parrainage Amazon EFN.
data.efn.referralFeeLe montant des frais de parrainage Amazon EFN.
data.efn.fixedClosingFeeLes frais de clôture fixes d'Amazon EFN.
data.efn.variableClosingFeeLes frais de clôture variables Amazon EFN.
data.efn.fulfillmentFeeLes frais de traitement Amazon EFN.
data.efn.storageFeeLes frais de stockage Amazon EFN.
data.efn.peakSeasonStorageL'indicateur des frais de stockage en haute saison d'Amazon EFN.
data.efn.orderHandlingFeeLes frais de traitement des commandes Amazon EFN.
data.efn.pickAndPackFeeLes frais de sélection et d'emballage Amazon EFN.
data.efn.weightHandlingFeeLes frais de gestion du poids Amazon EFN.
data.panEUStatusStatut de recherche de données sur les frais paneuropéens. « Terminé » ou « Impossible d'obtenir les données ».
data.panEU.inventoryPlaceInL'emplacement de l'inventaire dans Pan EU.
données. panEU.marketplaceLe marché sur lequel la commande a été passée. Valeurs valides (DE, FR, IT, ES, UK.
données. panEU.ceeEnabledLe drapeau lorsque le programme Europe centrale est activé.
données. panEU.estimatedNetProfitLe montant estimé du bénéfice net paneuropéen.
données. panEU.estimatedNetMarginLe pourcentage de marge nette paneuropéenne estimé.
données. panEU.referralRateLe pourcentage des frais de parrainage Amazon Pan EU.
données. panEU.referralFeeLe montant des frais de parrainage Amazon Pan EU.
données. panEU.fixedClosingFeeLes frais de clôture fixes d'Amazon Pan EU.
données. panEU.variableClosingFeeLes frais de clôture variables Amazon Pan EU.
données. panEU.fulfillmentFeeLes frais de traitement Amazon Pan EU.
données. panEU.storageFeeLes frais de stockage Amazon Pan EU.
données. panEU.peakSeasonStorageLe drapeau des frais de stockage en haute saison d'Amazon Pan EU.
données. panEU.orderHandlingFeeLes frais de traitement des commandes Amazon Pan EU.
données. panEU.pickAndPackFeeLes frais de sélection et d'emballage d'Amazon Pan EU.
données. panEU.weightHandlingFeeLes frais de manutention du poids Amazon Pan EU.
data.panEULightStatusStatut de recherche de données sur les tarifs d'éclairage paneuropéens. « Terminé » ou « Impossible d'obtenir
Données."
data.panEULight.inventoryPlaceInL'emplacement de l'inventaire dans Pan EU Light.
données. panEULight.marketplaceLe marché sur lequel la commande a été passée. Valeurs valides (DE, FR, IT, ES, UK)
données. panEULight.ceeEnabledLe drapeau lorsque le programme Europe centrale est activé.
données. panEULight.estimatedNetProfitLe montant estimé du bénéfice net de Pan EU Light.
données. panEULight.estimatedNetMarginLe pourcentage de marge nette estimé de Pan EU Light.
données. panEULight.referralRateLe pourcentage des frais de référence Amazon Pan EU Light.
données. panEULight.referralFeeLe montant des frais de parrainage Amazon Pan EU Light.
données. panEULight.fixedClosingFeeFrais de clôture fixes Amazon Pan EU Light.
données. panEULight.variableClosingFeeLes frais de clôture variables Amazon Pan EU Light.
données. panEULight.fulfillmentFeeLes frais de traitement des produits légers Amazon Pan EU.
données. panEULight.storageFeeLes frais de stockage de lumière Amazon Pan EU.
données. panEULight.peakSeasonStorageLe drapeau des frais de stockage Amazon Pan EU Light Peak Season.
données. panEULight.orderHandlingFeeLes frais de traitement des commandes Amazon Pan EU Light.
données. panEULight.pickAndPackFeeLes frais de sélection et d'emballage Amazon Pan EU Light.
données. panEULight.weightHandlingFeeLes frais de traitement légers d’Amazon Pan EU.

Notes: Certains champs ont peut-être été consolidés ou supprimés dans la dernière version d'Amazon Revenue Calculator, mais ils existent pour des raisons de compatibilité du programme et peuvent être supprimés dans la future version de l'API.

OBTENIR LE RÉSULTAT DE PROFIT ESTIMÉ PAR ID DE DEMANDE

La demande pour obtenir le dernier résultat du bénéfice estimé par ID de demande (rid).

DÉDUCTION DE CRÉDIT

0 (zéro) déduction de crédit pour l’appel Get.

DEMANDE
URI /api/query/getestprofit/rid/{rid}?secretKey={secretKey} {rid} – demande d'identifiant à partir de la réponse /api/query/estprofit/
Exemple /api/query/getestprofit/rid/60f12c1a0cf24280ed03be5e?secretKey=XXXXXXXXXX/json
RÉPONSE

See Estimation des bénéfices de la requête de rappel, exemples de données JSON

Cet article vous a-t-il été utile ? Oui Non
Comment pouvons-nous vous aider ?