1. INÍCIO
  2. Docs
  3. Documentação Amzpecty
  4. Especificações da API Amzpecty
  5. API de estimativa de lucro

API de estimativa de lucro

ADICIONAR ASIN/ISBN À FILA DE CONSULTA DE ESTIMATIVA DE LUCROE

A solicitação para adicionar um ASIN/ISBN à fila de consultas Estimate Profit.

DEDUÇÃO DE CRÉDITO

1 (uma) dedução de crédito após recuperação bem-sucedida dos dados MFN e FBA.

Dedução adicional de 1 (um) crédito para cada um dos seguintes parâmetros opcionais.

  • includefbalight – (opcional booleano) – se verdadeiro incluirá FBA Small e Light
  • includeefn – se verdadeiro, incluirá a European Fulfillment Network (EFN)
  • includepaneu – se verdadeiro incluirá PAN – European FBA
  • includepaneulight – se verdadeiro incluirá PAN – European FBA Small and Light
PEDIDO
URI /api/query/estprofit/{ASIN/ISBN}?sellingprice={sellingprice}&myfbacost={myfbacost}&mymfncost={mymfncost}&domain={domain}&secretKey={secretKey}&serviceaddons=inventoryplacement,opaquebagging,tape,label,bagging, bubblewrap&peakstorage=true {ASIN/ISBN} – obrigatório – o ASIN ou ISBN a ser adicionado à fila de consulta de estimativa de lucro
{preço de venda} – numérico | obrigatório – O preço alvo de venda do ASIN
{meufbacost} – numérico | opcional – O custo total de cumprimento do FBA do vendedor, excluindo taxas da Amazon. O padrão é 0.00 se não for especificado.
{meucusto} – numérico | opcional – O custo total de cumprimento do MFN, incluindo despesas de envio, mão de obra, materiais de embalagem, envio ao cliente, atendimento ao cliente, custo de armazenamento e outros custos do vendedor, excluindo taxas da Amazon. O padrão é 0.00 se não for especificado.
{serviçoaddons} –opcional – Complementos do Serviço de Custo de Cumprimento. Valores válidos separados por vírgula [inventoryplacement,opaquebagging,tape,label,bagging,bubblewrap]. Os complementos de serviço ficam desativados por padrão, a menos que especificado neste valor de parâmetro.
{pico de armazenamento} – booleano | opcional – Sinalizador para indicar o uso do custo máximo de armazenamento. O padrão é falso se não for especificado.
{includefbalight} – booleano | opcional – se verdadeiro incluirá FBA Small e Light
{Includeefn} – booleano | opcional – se verdadeiro, incluirá a European Fulfillment Network (EFN)
{Incluir painel} – booleano | opcional – se verdadeiro incluirá PAN – European FBA
{Incluir luz do painel} – booleano | opcional – se verdadeiro incluirá PAN – European FBA Small and Light
(parâmetros opcionais)
{efnmarketplace} = (string) – valores válidos (DE, FR, IT, ES, UK) <-- (por padrão será baseado no domínio)
{efninventoryplace} = (string) – valores válidos (DE, FR, IT, ES, UK) <-- (por padrão será baseado no domínio)
{efncee} = (booleano) – sinalizador para ativar Usar programa da Europa Central <- (padrão verdadeiro)
NOTA: EFN, PAN-EU e PAN-EU Light só serão incluídos se o domínio for DE, FR, IT, ES, UK.
{domínio} – opcional – o padrão é www.amazon.com se não for especificado. Ver Domínios Amazon suportados para lista.
Cabeçalho HTTP (opcional) AMZPECTY_CALLBACK_URL={Seu URL de retorno}
Exemplo /api/query/estprofit/B089B74PC4?sellingprice=15.00&secretKey=XXXXXXXXXX&myfbacost=4.99&mymfncost=3.99
RESPOSTA
Cabeçalhos
Tipo de mídia aplicação / json
Dados JSON
JSON
{
    "status": "OK",
    "responsefor": "estprofit",
    "allowed": 4992,
    "dailyAllowed": 4992,
    "messageId": null,
    "message": null,
    "data": null,
    "rid": "60f126e20cf24280ed03be54",
    "dateProcessed": null,
    "domain": null
}

Note: Durante o retorno de chamada, o rid pode ser usado para vincular os dados de retorno de chamada à chamada de solicitação original.

CHAMADA DE CONSULTA DE ESTIMATIVA DE LUCRO

PEDIDO DE RETORNO DE CONSULTA DE ESTIMATIVA DE LUCRO
Cabeçalhos Exemplo: https://your.server.com/amzpecty_result {Forneça o URL na página de preferências} O URL deve estar habilitado para SSL. AMZPECTY-API-SECRET-KEY (nome do cabeçalho) – o cabeçalho da chave secreta será incluído para o servidor de retorno de chamada validar a origem da solicitação
Tipo de mídia aplicação / json
ESTIMATIVA DE CONSULTA DE LUCRO CALLBACK JSON DE AMOSTRA DE DADOS
Cabeçalhos
Tipo de mídia aplicação / json
Dados 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
}
ESTIMATIVA DE CONSULTA DE LUCRO RESPOSTA DE CHAMADA ATRIBUTOS JSON
Nome do AtributoAdicionar ao carrinho
estadoO status da solicitação.
resposta paraValor “sellerinfo” para o resultado da consulta de informações do vendedor.
permitidasA contagem atual de solicitações permitidas. Reinicia mensalmente.
diariamentePermitidoA contagem de solicitações diárias permitidas atualmente. Reinicia diariamente.
mensagemIdO ID da mensagem (se houver).
mensagemA mensagem real (se houver). Consulte Mensagens de erro.
livrarO ID da solicitação. Isso pode ser usado na consulta Get como uma chave.
domínioO domínio Amazon correspondente para o Vendedor.
totalCréditosDeduzidosEste campo indica quantos créditos da API Amzpecty foram usados ​​para atender esta solicitação.
dataProcessadoA data em que a solicitação foi processada no formato de hora unix.
dados.asinO ASIN do produto.
data.sellingPriceO preço de venda do vendedor.
dados.myFBACostO vendedor especificou o custo total de cumprimento do FBA. (Excluindo taxas da Amazon)
dados.myMFNCostO vendedor especificou o custo total de cumprimento do MFN. (Excluindo taxas da Amazon)
dados.fbaStatusStatus de pesquisa de dados de taxas FBA. “Concluído” ou “Não foi possível obter dados”.
dados.fba.estimatedNetProfitO valor estimado do lucro líquido da FBA.
data.fba.estimatedNetMarginA porcentagem estimada de lucro líquido da FBA.
data.fba.referralFeeO valor da taxa de indicação do Amazon FBA.
data.fba.referralRateA porcentagem da taxa de indicação do Amazon FBA.
data.fba.variableClosingFeeA taxa variável de fechamento da Amazon FBA.
data.fba.fulfillmentFeeA taxa de cumprimento do Amazon FBA.
data.fba.estimatedVATRateO FBA Vat Rat estimado
data.fba.estimatedVATAmountO valor estimado do IVA FBA
data.fba.serviceAddons. taxa de ensacamentoA taxa de bagagem adicional do serviço Amazon FBA.
data.fba.serviceAddons. inventárioPlacementFeeA taxa de colocação de inventário de complementos do serviço Amazon FBA.
data.fba.serviceAddons. bolhaWrapFeeA taxa de bolha do complemento do serviço Amazon FBA.
data.fba.serviceAddons. taxa de rotulagemA taxa de rotulagem de serviço Amazon FBA.
data.fba.serviceAddons. taxa de gravaçãoA taxa de gravação de complemento do serviço Amazon FBA.
data.fba.serviceAddons. opacoBaggingFeeTaxa de ensacamento opaco do complemento do serviço Amazon FBA.
data.fba.orderHandlingFeeDEPRECADO desde setembro de 2022. Taxa de processamento de pedidos da Amazon FBA.
data.fba.peakSeasonStorageO sinalizador Amazon FBA Peak Season Storage Fee.
data.fba.storageFeeA taxa de armazenamento Amazon FBA.
data.fba.pickAndPackFeeDEPRECADO desde setembro de 2022. Taxa de seleção e embalagem da Amazon FBA.
data.fba.fixedClosingFeeA taxa fixa de fechamento da Amazon FBA.
data.fba.weightHandlingFeeDEPRECADO desde setembro de 2022. Taxa de manuseio de peso da Amazon FBA.
dados.mfnStatusStatus de pesquisa de dados de taxas MFN. “Concluído” ou “Não foi possível obter dados”.
dados.mfn.estimatedNetProfitO valor estimado do lucro líquido MFN.
dados.mfn.estimatedNetMarginA percentagem estimada de lucro líquido MFN.
data.mfn.referralFeeO valor da taxa de indicação do Amazon MFN.
data.mfn.referralRateA porcentagem da taxa de indicação do Amazon MFN.
data.mfn.variableClosingFeeA taxa variável de fechamento da Amazon MFN.
data.mfn.fixedClosingFeeA taxa fixa de fechamento da Amazon MFN.
data.mfn.estimatedVATRateA taxa de IVA MFN estimada
dados.mfn.estimadoVATAmounO FBA Vat Amoun estimado
data.fbaLightStatusStatus de pesquisa de dados de taxas FBA Light. “Concluído” ou “Não foi possível obter dados”.
dados.fbaLight.estimatedNetProfitO valor estimado do lucro líquido da FBA Light.
dados.fbalight.estimatedNetMarginO percentual estimado de margem líquida do FBA Light.
data.fbalight.referralRateA porcentagem da taxa de referência do Amazon FBA Light.
data.fbalight.referralFeeO valor da taxa de indicação do Amazon FBA Light.
data.fbalight.fixedClosingFeeA taxa fixa de fechamento do Amazon FBA Light.
data.fbalight.variableClosingFeeA taxa de fechamento variável Amazon FBA Light.
data.fbalight.fulfillmentFeeA taxa de atendimento leve da Amazon FBA.
data.fbalight.storageFeeA taxa de armazenamento leve da Amazon FBA.
data.fbalight.peakSeasonStorageA bandeira Amazon FBA Light Peak Season Taxa de armazenamento.
data.fbalight.orderHandlingFeeA taxa de entrega de pedidos leves da Amazon FBA.
data.fbalight.pickAndPackFeeA taxa de seleção e embalagem leve da Amazon FBA.
data.fbalight.weightHandlingFeeA taxa de manuseio leve da Amazon FBA.
data.fbalight.estimatedVATRateA taxa estimada de IVA leve da FBA
data.fbalight.estimatedVATAmountO valor estimado do FBA Light VAT
dados.efnStatusStatus de pesquisa de dados de taxas EFN. “Concluído” ou “Não foi possível obter dados”.
dados.efn.inventoryPlaceInA localização do inventário na EFN
dados.efn.marketplaceO mercado em que o pedido foi feito. Valores válidos (DE, FR, IT, ES, UK)
data.efn.ceeEnabledA bandeira quando o Programa da Europa Central está ativado.
dados.efn.estimatedNetProfitO valor estimado do lucro líquido da EFN.
dados.efn.estimatedNetMarginA percentagem estimada da margem líquida EFN.
data.efn.referralRateA porcentagem da taxa de indicação do Amazon EFN.
data.efn.referralFeeO valor da taxa de indicação do Amazon EFN.
data.efn.fixedClosingFeeA taxa fixa de fechamento da Amazon EFN.
data.efn.variableClosingFeeA taxa variável de fechamento da Amazon EFN.
data.efn.fulfillmentFeeA taxa de cumprimento da Amazon EFN.
data.efn.storageFeeA taxa de armazenamento da Amazon EFN.
data.efn.peakSeasonStorageO sinalizador Amazon EFN Peak Season Storage Fee.
data.efn.orderHandlingFeeA taxa de entrega de pedidos da Amazon EFN.
data.efn.pickAndPackFeeA taxa de seleção e embalagem da Amazon EFN.
data.efn.weightHandlingFeeA taxa de manuseio de peso da Amazon EFN.
data.panEUStatusStatus de pesquisa de dados de taxas pan-europeias. “Concluído” ou “Não foi possível obter dados”.
data.panEU.inventoryPlaceInA localização do inventário na Pan EU.
dados. panEU.marketplaceO mercado em que o pedido foi feito. Valores válidos (DE, FR, IT, ES, UK.
dados. panEU.ceeEnabledA bandeira quando o Programa da Europa Central está ativado.
dados. panEU.estimatedNetProfitO valor estimado do lucro líquido pan-UE.
dados. panEU.estimatedNetMarginA percentagem estimada da margem líquida Pan-UE.
dados. panEU.referralRateA porcentagem da taxa de indicação da Amazon Pan EU.
dados. panEU.referralFeeO valor da taxa de indicação da Amazon Pan EU.
dados. panEU.fixedClosingFeeA taxa fixa de fechamento da Amazon Pan EU.
dados. panEU.variableClosingFeeA taxa variável de fechamento da Amazon Pan EU.
dados. panEU.fulfillmentFeeA taxa de cumprimento da Amazon Pan EU.
dados. panEU.storageFeeA taxa de armazenamento da Amazon Pan EU.
dados. panEU.peakSeasonStorageA bandeira da taxa de armazenamento na alta temporada da Amazon Pan EU.
dados. panEU.orderHandlingFeeA taxa de entrega de pedidos da Amazon Pan EU.
dados. panEU.pickAndPackFeeA taxa de seleção e embalagem da Amazon Pan EU.
dados. panEU.weightHandlingFeeA taxa de manuseio de peso da Amazon Pan EU.
data.panEULightStatusStatus de pesquisa de dados de taxas Pan-Europeias Light. “Concluído” ou “Não foi possível obter
Dados."
dados.panEULight.inventoryPlaceInA localização do inventário no Pan EU Light.
dados. panEULight.marketplaceO mercado em que o pedido foi feito. Valores válidos (DE, FR, IT, ES, UK)
dados. panEULight.ceeEnabledA bandeira quando o Programa da Europa Central está ativado.
dados. panEULight.estimatedNetProfitO valor estimado do lucro líquido da Pan EU Light.
dados. panEULight.estimatedNetMarginA percentagem estimada da margem líquida Pan EU Light.
dados. panEULight.referralRateA porcentagem da taxa de referência Amazon Pan EU Light.
dados. panEULight.referralFeeO valor da taxa de referência Amazon Pan EU Light.
dados. panEULight.fixedClosingFeeA taxa fixa de fechamento da Amazon Pan EU Light.
dados. panEULight.variableClosingFeeA taxa variável de fechamento Amazon Pan EU Light.
dados. panEULight.fulfillmentFeeA taxa de atendimento leve da Amazon Pan EU.
dados. panEULight.storageFeeA taxa de armazenamento leve da Amazon Pan EU.
dados. panEULight.peakSeasonStorageA bandeira Amazon Pan EU Light Peak Season Taxa de armazenamento.
dados. panEULight.orderHandlingFeeA taxa de entrega de pedidos leves da Amazon Pan EU.
dados. panEULight.pickAndPackFeeA taxa de seleção e embalagem leve do Amazon Pan EU.
dados. panEULight.weightHandlingFeeA taxa de manuseio de peso leve da Amazon Pan EU.

Note: alguns campos podem ter sido consolidados ou removidos na versão mais recente do Amazon Revenue Calculator, mas existem para compatibilidade do programa e podem ser removidos na versão futura da API.

OBTER RESULTADO DE LUCRO ESTIMADO POR ID DE PEDIDO

A solicitação para obter o resultado mais recente do lucro estimado por ID da solicitação (livre).

DEDUÇÃO DE CRÉDITO

0 (zero) dedução de crédito para a chamada Get.

PEDIDO
URI /api/query/getestprofit/rid/{rid}?secretKey={secretKey} {rid} – ID da solicitação da resposta /api/query/estprofit/
Exemplo /api/query/getestprofit/rid/60f12c1a0cf24280ed03be5e?secretKey=XXXXXXXXXX/json
RESPOSTA

See Estimativa de dados de amostra JSON de retorno de chamada de consulta de lucro

Este artigo foi útil para você? Sim Não
Como podemos ajudar?