SkyHub API
SkyHub PortalApi Explorer
  • Sobre a API SkyHub
  • Comunicados
    • Comunicados 2025
      • Criação e atualização de produtos e variações no Marketplace
      • Atualizações dos pedidos no Marketplace
      • Etiquetas Americanas Entrega
    • Comunicados 2024
      • Novo canal de atendimento
      • Remoção do array "categories" na busca de produtos
      • Novos campos no JSON de Pedidos
    • Comunicados 2023
      • Personalização de Preço Por Marca
      • Obrigatoriedade de body em métodos POST/PUT/PATCH
    • Comunicados 2022
      • Inativação do endpoint /categories
      • MultiCD: Substituição do store_status pelo statuses
      • Bloqueio de requisições com x-account inválido - Prazo não definido
      • Mudança na atualização da chave da nota fiscal
    • Comunicados 2021
      • Código de homologação da Anatel
      • Atributo Garantia
      • Envio de Imagens para o Mktp B2W
      • Mudança response HTTP /delivery
      • Mudança Faturamento Pedidos B2W Entrega Direct
      • Limite de Categorias na SkyHub
      • Limite de Imagens na SkyHub
      • Mudança response HTTP /invoice e /shipments
      • Mudança Infraestrutura SkyHub
      • Protocolo HTTP/HTTPS
      • Consumo de Pedidos | Preço
      • X-Accountmanager-Key
    • Comunicados 2020
      • Requisição Duplicada
      • Requisição Contas Inativas
      • Entrega Agendada by Direct
      • Headers para Requisições
      • Consumo de Pedidos
      • Atributo Data Faturamento
      • Atributo Data Enviado
  • Guias API SkyHub
    • Autenticação e formato dos dados
    • Códigos de retorno (HTTP status)
    • Limite de requisições
    • Melhores práticas
  • Recursos
    • Produtos
    • Rehub
    • Pedidos
    • Erros
    • Etiquetas
    • Fulfillment
    • Multi Origem
    • Perguntas e Respostas
    • SAC
    • Credenciamento
  • Processo de Homologação
    • Perfil para Homologação
    • Pré-Requisitos
    • Validações
      • Produtos
      • Conexão via API (Rehub)
      • Pedidos
      • Etiqueta (PLP)
    • Melhores Práticas
      • Produtos
      • Pedidos
      • Etiqueta PLP
  • Perguntas Frequentes
  • Produtos
    • > Integração Produto
    • Categorização
      • Consultar lista de Categorias
      • Consultar atributos por categoria
    • Consultar Marcas
    • Criação de Produto
      • Produto Simples
      • Produto Variável
    • Atualização de Produto
      • Produto Simples
      • Produto Variável
    • Consulta de Produto
      • Produto Simples e Variável
      • Variação de Produto
    • Exclusão de Produto
      • Produto Simples e Variável
      • Variação de Produto
    • Outros Recursos de Produtos
      • Filtros de Consultas
      • Endpoint Atributos
      • Consulta URL
        • URL Variações
  • Rehub
    • > Integração Rehub
    • Rehub - Ações de Produto
    • Resultado das Ações de Produto
  • Pedidos
    • > Integração Pedido
    • Criação e Aprovação de Pedido Teste
    • Atualização de Pedidos
    • Faturamento Pedido - Americanas Entrega Direct
    • Consumo de Pedidos - Queues
    • Notificação de Pedidos
    • Consulta de Pedidos
  • Erros
    • Consulta de Erros de Sincronização e Produção
  • Etiquetas Americanas Entrega
    • > Integração Etiqueta
    • Etiqueta de Frete - Direct
      • Padrão da Etiqueta Direct
      • Direct - Processos via API
      • Etiqueta Clique e Retire - Direct
    • Etiqueta de Frete - Correios
      • Padrão da Etiqueta Correios
      • Correios - Processos via API
      • Etiqueta Clique e Retire - Correios
  • Frete
    • > Integração Frete
    • Como Homologar
    • Melhores Práticas
  • Fulfillment
    • > Integração Fulfillment
    • Consulta de Estoque
    • Identificando Pedido
    • Faturamento
    • Consulta de Notas
    • Faturador
      • Regra Fiscal
      • Regras Tributárias
      • Relacionamento entre Produto e Regra
        • Produto Simples
        • Produto Variável
  • Multi Origem
    • > Integração Multi Origem
    • Solicitar Credenciais
    • Criar e Consultar CD
    • Criação e Atualização de Estoque
    • Pedido Multi Origem
    • Etiqueta Multi Origem
  • Perguntas e Respostas Americanas
    • > Integração Q&A
    • Perguntas e Respostas (Q&A)
  • SAC
    • > Integração SAC
    • Listar SAC
    • Chats
    • Consulta de Itens
    • Instâncias geradas de SAC
    • Actions
    • Refunds
Powered by GitBook
On this page
  1. Comunicados
  2. Comunicados 2023

Personalização de Preço Por Marca

Comunicado encaminhado pelo marketplace sobre alteração no envio de preço por marca

PreviousComunicados 2023NextObrigatoriedade de body em métodos POST/PUT/PATCH

Last updated 1 year ago

No dia 09/03/2023 o envio de preço para as marcas Americanas, Shoptime e Submarino foi unificado.

Visando uma melhor experiência para o seller e simplificação de sua operação, os preços serão unificados, isto é, cada produto terá um preço único para venda nos sites que constituem o marketplace Americanas (sendo eles Americanas, Shoptime e Submarino).

O que muda?

Anteriormente, além dos campos padronizados para envio de preço (price e promotional_price), era possível criar através da plataforma/ERP e encaminhar para a API atributos para a distinção de preço por marca. Assim, após o mapeamento de tais atributos no front da API, as marcas que constituem o marketplace Americanas (Americanas, Shoptime e Submarino) recebiam valores distintos para a venda de um mesmo produto.

Esta ação impactava diretamente na atualização de preços, uma vez que após definidos os valores por marca, a cada atualização, fazia-se necessário que o seller alterasse individualmente os atributos criados em sua plataforma/ERP com a finalidade de distinção de preço por site do marketplace.

O que não muda?

Para o serviço Americanas Empresas não haverá alteração, ou seja, através da plataforma/ERP ainda será possível criar atributos responsáveis pela inclusão de preços distintos que serão refletidos para vendas para clientes CNPJ.

A solicitação do serviço Americanas Empresas é realizada exclusivamente pelo próprio seller através do portal parceiro, porém abaixo temos uma breve orientação quanto a inclusão do preço personalizado para tal serviço.

Uma vez que a loja deseja atuar com vendas para CNPJ's (serviço Americanas Empresas) é possível incluir na estrutura do produto atributos que irão conter preços a serem utilizados para este serviço.

Como se tratam de atributos comuns a serem enviados via API, não há uma padronização para a key a ser utilizada, porém a mesma deve ser de fácil compreensão.

No exemplo a seguir temos a criação de um produto contendo os atributos price_empresas e promo_price_empresas dentro do array specifications e estes receberão os preços a serem considerados pelo serviço Americanas Empresas:

Para consultar todos os detalhes sobre a criação de um produto via API, acesse a página desta documentação.

curl --location 'https://api.skyhub.com.br/products' \
--header 'X-User-Email: email_de_usuario' \
--header 'X-Api-Key: token_de_integracao de sua conta SkyHub' \
--header 'X-accountmanager-key: token_account único de cada Plataforma/ERP' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "product": { 
        "sku": "2023001",
        "name": "Camiseta Branca Tam. Único",
        "description": "[A descrição deve trazer detalhes do produto, com a finalidade de atrair o consumidor final] Camiseta regata feminina, disponível na cor branca e tamanho único.",
        "status": "enabled", 
        "qty": 1,
        "price": 39.90,
        "promotional_price": 35.90,
        "cost": 19.89,
        "weight": 0.1,
        "height": 25,
        "width": 1,
        "length": 30,
        "brand": "SkyHub",
        "ean": "1234567890123", 
        "nbm": "11223344",
        "categories": [],
        "images": [
            "https://images-americanas.b2w.io/produtos/2638788562/imagens/regata-basic-feminina-canelada-branca/2638788562_1_xlarge.jpg"
        ],
        "specifications": [
            { 
                "key": "Tamanho",
                "value": "Único"
            },
            { 
                "key": "Crossdocking",
                "value": "3"
            },
            { 
                "key": "price_empresas",
                "value": "29.90"
            },
            { 
                "key": "promo_price_empresas",
                "value": "25.90"
            }
        ]
    }
}'

Após a criação do produto contendo os atributos de preço que deverão ser utilizados pelo serviço Americanas Empresas (price_empresas e promo_price_empresas) é necessário realizar o mapeamento destes campos para que o marketplace possa refleti-los corretamente.

O mapeamento é realizado diretamente no front da API através do menu Plataformas > Atributos [B2W] > Mapear:

Ao visualizar na página de mapeamento os campos destinados aos preços que serão enviados para o serviço Americanas Empresas, basta selecionar os atributos criados através da plataforma/ERP:

Criação de Produto
Normalmente ao final da página de mapeamento de campos para o marketplace vemos os campos "B2w Empresas Preço De" e "B2w Empresas Preço Por", utilizados para a definição dos atributos que deverão ser considerados para a precificação de itens para o serviço Americanas Empresas