Documentazione
Hub per sviluppatoriStato dell'APISupporto
Inizia a digitare per cercare...

Guida ai casi d'uso di Commissioni prodotti v0

Come utilizzare API per le tariffe dei prodotti.

Versione API: v0

Cos'è API per le tariffe dei prodotti??

L'API Product Fees recupera le commissioni dei prodotti per più prodotti. Puoi usare il getMyFeesEstimates operazione per ottenere stime delle commissioni di prodotto per un elenco di prodotti e mercati e quindi fissare i prezzi in base a tali stime. Devi specificare i tuoi prodotti tramite ASIN o SKU (non UPC, ISBN o altri identificatori).

È necessario includere un identificatore originale in ogni richiesta di commissione del prodotto. Questo identificatore è incluso nella stima delle commissioni in modo da poter correlare una stima delle commissioni con una richiesta originale.

❗

Importante

Le commissioni stimate restituite da questa API non sono garantite. Le commissioni effettive possono variare.

Prerequisiti

Per completare correttamente questo tutorial, devi disporre di quanto segue:

  • Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
  • Il ruolo Prezzi e Offerte di prodotti assegnato al tuo profilo sviluppatore.
  • Il ruolo Prezzi e Offerte di prodotti selezionato nella pagina di registrazione dell'app per la tua candidatura.

Tutorial 1: Ottieni stime dei costi del prodotto per uno SKU specifico

Questo tutorial mostra come recuperare le tariffe dei prodotti per uno SKU.

Chiama getMyFeesEstimateForSKU per recuperare le stime delle commissioni per un articolo

Puoi chiamare l'operazione getMyFeesEstimateForSKU per un articolo per conto di un partner di vendita prima che quest'ultimo stabilisca il prezzo dell'articolo. Quest'operazione accetta un ASIN come parametro di percorso.

Parametri del percorso

Nome Descrizione Schema
SellerSKU Utilizzato per identificare un articolo in un determinato marketplace. SellerSKU è qualificato dal SellerId del venditore, che è incluso in ogni operazione inviata. Tipo: stringa

Parametri del corpo

Nome Descrizione Schema
body Lo schema del corpo della richiesta per l'operazione getMyFeesEstimateForSKU. Tipo: GetMyFeesEstimateRequest

Esempio di richiesta:

POST https://sellingpartnerapi-na.amazon.com/products/fees/v0/listings/UmaS1/feesEstimate
{
  "FeesEstimateRequest": {
    "MarketplaceId": "ATVPDKIKX0DER",
    "IsAmazonFulfilled": false,
    "PriceToEstimateFees": {
      "ListingPrice": {
        "CurrencyCode": "USD",
        "Amount": 10
      },
      "Shipping": {
        "CurrencyCode": "USD",
        "Amount": 10
      },
      "Points": {
        "PointsNumber": 0,
        "PointsMonetaryValue": {
          "CurrencyCode": "USD",
          "Amount": 0
        }
      }
    },
    "Identifier": "UmaS1"
  }
}

Risposta

Una risposta con esito positivo include quanto segue:

{
  "FeesEstimateResult": {
    "Status": "Success",
    "FeesEstimateIdentifier": {
      "MarketplaceId": "ATVPDKIKX0DER",
      "IdType": "SellerSKU",
      "SellerId": "AXXXXXXXXXXXXX",
      "SellerInputIdentifier": "UmaS1",
      "IsAmazonFulfilled": false,
      "IdValue": "UmaS1",
      "PriceToEstimateFees": {
        "ListingPrice": {
          "CurrencyCode": "USD",
          "Amount": 10
        },
        "Shipping": {
          "CurrencyCode": "USD",
          "Amount": 10
        },
        "Points": {
          "PointsNumber": 0,
          "PointsMonetaryValue": {
            "CurrencyCode": "USD",
            "Amount": 0
          }
        }
      }
    },
    "FeesEstimate": {
      "TimeOfFeesEstimation": "Mon Oct 28 18:49:32 UTC 2019",
      "TotalFeesEstimate": {
        "CurrencyCode": "USD",
        "Amount": 3.0
      },
      "FeeDetailList": [
        {
          "FeeType": "PerItemFee",
          "FeeAmount": {
            "CurrencyCode": "USD",
            "Amount": 0.0
          },
          "FinalFee": {
            "CurrencyCode": "USD",
            "Amount": 0.0
          },
          "FeePromotion": {
            "CurrencyCode": "USD",
            "Amount": 0.0
          }
        }
      ]
    },
    "Error": {
      "Type": "",
      "Code": "",
      "Message": "",
      "Detail": []
    }
  }
}

Tutorial 2: Ottieni stime dei costi del prodotto per un ASIN specifico

Questo tutorial dimostra come recuperare le tariffe dei prodotti per un ASIN.

Chiama il getMyFeesEstimateForASIN operazione per recuperare le stime delle commissioni per un articolo

Puoi chiamare l'operazione getMyFeesEstimateForASIN per un articolo per conto di un partner di vendita prima che quest'ultimo stabilisca il prezzo dell'articolo. Quest'operazione accetta un ASIN come parametro di percorso.

Parametri del percorso

Nome Descrizione Schema
ASIN ASIN (Numero identificativo standard di Amazon) dell'articolo. Tipo: stringa

Parametri del corpo

Nome Descrizione Schema
body Lo schema del corpo della richiesta per l'operazione getMyFeesEstimateForASIN. Tipo: GetMyFeesEstimateRequest

Esempio di richiesta:

POST https://sellingpartnerapi-na.amazon.com/products/fees/v0/items/UmaS1/feesEstimate
{
  "FeesEstimateRequest": {
    "MarketplaceId": "ATVPDKIKX0DER",
    "IsAmazonFulfilled": false,
    "PriceToEstimateFees": {
      "ListingPrice": {
        "CurrencyCode": "USD",
        "Amount": 10
      },
      "Shipping": {
        "CurrencyCode": "USD",
        "Amount": 10
      },
      "Points": {
        "PointsNumber": 0,
        "PointsMonetaryValue": {
          "CurrencyCode": "USD",
          "Amount": 0
        }
      }
    },
    "Identifier": "UmaS1"
  }
}

Risposta

Una risposta con esito positivo include quanto segue:

{
  "FeesEstimateResult": {
    "Status": "Success",
    "FeesEstimateIdentifier": {
      "MarketplaceId": "ATVPDKIKX0DER",
      "IdType": "ASIN",
      "SellerId": "AXXXXXXXXXXXXX",
      "SellerInputIdentifier": "UmaS1",
      "IsAmazonFulfilled": false,
      "IdValue": "B00V5DG6IQ",
      "PriceToEstimateFees": {
        "ListingPrice": {
          "CurrencyCode": "USD",
          "Amount": 10
        },
        "Shipping": {
          "CurrencyCode": "USD",
          "Amount": 10
        },
        "Points": {
          "PointsNumber": 0,
          "PointsMonetaryValue": {
            "CurrencyCode": "USD",
            "Amount": 0
          }
        }
      }
    },
    "FeesEstimate": {
      "TimeOfFeesEstimation": "Mon Oct 28 18:49:32 UTC 2019",
      "TotalFeesEstimate": {
        "CurrencyCode": "USD",
        "Amount": 3
      },
      "FeeDetailList": [
        {
          "FeeType": "PerItemFee",
          "FeeAmount": {
            "CurrencyCode": "USD",
            "Amount": 0
          },
          "FinalFee": {
            "CurrencyCode": "USD",
            "Amount": 0
          },
          "FeePromotion": {
            "CurrencyCode": "USD",
            "Amount": 0
          }
        }
      ]
    },
    "Error": {
      "Type": "",
      "Code": "",
      "Message": "",
      "Detail": []
    }
  }
}

Tutorial 3: ottieni le tariffe dei prodotti per un gruppo di massimo 20 articoli

Questo tutorial mostra come recuperare le tariffe dei prodotti per gruppo di massimo 20 SKU o ASIN.

Fase 1 Crea una serie di FeesEstimateByIdRequest oggetti

L'operazione getMyFeesEstimates consente fino a 20 richieste di prodotto in un unico lotto. Per inviare 20 richieste in una chiamata API, è necessario creare un array con un massimo di 20 oggetti FeesEstimateByIdRequest.

Esempio di un array di oggetti FeesEstimateByIdRequest:

[
  {
    "FeesEstimateRequest": {
      "MarketplaceId": "ATVPDKIKX0DER",
      "IsAmazonFulfilled": false,
      "PriceToEstimateFees": {
        "ListingPrice": {
          "CurrencyCode": "USD",
          "Amount": 10
        },
        "Shipping": {
          "CurrencyCode": "USD",
          "Amount": 10
        },
        "Points": {
          "PointsNumber": 0,
          "PointsMonetaryValue": {
            "CurrencyCode": "USD",
            "Amount": 0
          }
        }
      },
      "Identifier": "UmaS1"
    },
    "IdType": "ASIN",
    "IdValue": "asin123"
  },
  {
    "FeesEstimateRequest": {
      "MarketplaceId": "A1AM78C64UM0Y8",
      "IsAmazonFulfilled": true,
      "PriceToEstimateFees": {
        "ListingPrice": {
          "CurrencyCode": "MXN",
          "Amount": 10
        },
        "Shipping": {
          "CurrencyCode": "MXN",
          "Amount": 10
        },
        "Points": {
          "PointsNumber": 0,
          "PointsMonetaryValue": {
            "CurrencyCode": "MXN",
            "Amount": 0
          }
        }
      },
      "Identifier": "UmaS2"
    },
    "IdType": "SellerSKU",
    "IdValue": "sku123"
  },
  ...
]

Passaggio 2. Chiama l'operazione getMyFeesEstimates

Chiama l'operazione getMyFeesEstimates, passando i seguenti parametri:

Parametri del corpo

Nome Descrizione Schema
FeesEstimateRequest Prodotto, marketplace e prezzo proposto utilizzati per richiedere le commissioni stimate. Tipo: FeesEstimateRequest

Esempio di richiesta

POST https://sellingpartnerapi-na.amazon.com/products/fees/v0/feesEstimate
[
  {
    "FeesEstimateRequest": {
      "MarketplaceId": "ATVPDKIKX0DER",
      "IsAmazonFulfilled": false,
      "PriceToEstimateFees": {
        "ListingPrice": {
          "CurrencyCode": "USD",
          "Amount": 10
        },
        "Shipping": {
          "CurrencyCode": "USD",
          "Amount": 10
        },
        "Points": {
          "PointsNumber": 0,
          "PointsMonetaryValue": {
            "CurrencyCode": "USD",
            "Amount": 0
          }
        }
      },
      "Identifier": "UmaS1"
    },
    "IdType": "ASIN",
    "IdValue": "asin123"
  },
  {
    "FeesEstimateRequest": {
      "MarketplaceId": "A1AM78C64UM0Y8",
      "IsAmazonFulfilled": true,
      "PriceToEstimateFees": {
        "ListingPrice": {
          "CurrencyCode": "MXN",
          "Amount": 10
        },
        "Shipping": {
          "CurrencyCode": "MXN",
          "Amount": 10
        },
        "Points": {
          "PointsNumber": 0,
          "PointsMonetaryValue": {
            "CurrencyCode": "MXN",
            "Amount": 0
          }
        }
      },
      "Identifier": "UmaS2"
    },
    "IdType": "SellerSKU",
    "IdValue": "sku123"
  }
]

Risposta

Una risposta con esito positivo include quanto segue:

Nome Descrizione Schema
GetMyFeesEstimatesResponse Tariffe stimate per un elenco di prodotti.

Tipo: array

 Tipo: GetMyFeesEstimatesResponse

Esempio di risposta:

{
  "Status": "Success",
  "FeesEstimateIdentifier": {
    "MarketplaceId": "ATVPDKIKX0DER",
    "IdType": "ASIN",
    "SellerId": "AXXXXXXXXXXXXX",
    "SellerInputIdentifier": "UmaS1",
    "IsAmazonFulfilled": false,
    "IdValue": "asin123",
    "PriceToEstimateFees": {
      "ListingPrice": {
        "CurrencyCode": "USD",
        "Amount": 10
      },
      "Shipping": {
        "CurrencyCode": "USD",
        "Amount": 10
      },
      "Points": {
        "PointsNumber": 0,
        "PointsMonetaryValue": {
          "CurrencyCode": "USD",
          "Amount": 0
        }
      }
    }
  },
  "FeesEstimate": {
    "TimeOfFeesEstimation": "Mon Oct 28 18:49:32 UTC 2019",
    "TotalFeesEstimate": {
      "CurrencyCode": "USD",
      "Amount": 3.0
    },
    "FeeDetailList": []
  },
  "Error": {
    "Type": "",
    "Code": "",
    "Message": "",
    "Detail": []
  }
},
{
  "Status": "Success",
  "FeesEstimateIdentifier": {
    "MarketplaceId": "A1AM78C64UM0Y8",
    "IdType": "SellerSKU",
    "SellerId": "AXXXXXXXXXXXXX",
    "SellerInputIdentifier": "UmaS2",
    "IsAmazonFulfilled": false,
    "IdValue": "sku123",
    "PriceToEstimateFees": {
      "ListingPrice": {
        "CurrencyCode": "MXN",
        "Amount": 10
      },
      "Shipping": {
        "CurrencyCode": "MXN",
        "Amount": 10
      },
      "Points": {
        "PointsNumber": 0,
        "PointsMonetaryValue": {
          "CurrencyCode": "MXN",
          "Amount": 0
        }
      }
    }
  },
  "FeesEstimate": {
    "TimeOfFeesEstimation": "Mon Oct 28 18:49:32 UTC 2019",
    "TotalFeesEstimate": {
      "CurrencyCode": "MXN",
      "Amount": 3.0
    },
    "FeeDetailList": []
  },
  "Error": {
    "Type": "",
    "Code": "",
    "Message": "",
    "Detail": []
  }
}

Updated 9 months ago

Questa pagina ti è stata utile?