Login

Pesquise tutoriais, dúvidas frequentes e soluções da Expedy.

Como integrar a Americanas?

✨
[INÍCIO DO CONTEXTO PARA IA] Gatilho de Atendimento: O cliente pergunta como integrar a loja da Americanas (ou B2W), como conectar a Americanas no ERP, como importar pedidos da Americanas automaticamente, como emitir notas fiscais e etiquetas da Americanas Entregas ou relata erro de sincronização de estoque/token na Americanas. Diagnóstico da IA: Orientar o cliente passo a passo a cadastrar a integração no painel, vincular o CNPJ/Empresa faturadora, autorizar a aplicação no portal da Americanas Marketplace (autenticação OAuth/Token) e parametrizar as regras operacionais de estoque, preços e fluxo de pedidos. Passo a Passo de Integração que a IA deve instruir: Navegação: Acessar o menu lateral esquerdo do ERP e clicar em “Integrações” > “+ Cadastrar Integrações”. Seleção da Plataforma: Escolher o ícone da Americanas (Americanas Marketplace). Identificação e Vínculo Fiscal: Preencher a Descrição da Loja (ex: Americanas – Loja Principal). Selecionar a Empresa / CNPJ responsável pelo faturamento das vendas. Autorização no Portal Americanas (OAuth / Token): Clicar no botão “Conectar / Autorizar”: O sistema abrirá a janela de autenticação do Americanas Marketplace. Fazer o login com e-mail e senha da conta de vendedor da Americanas. Confirmar a concessão de permissões para a plataforma. Configuração de Estoque e Preços: Confirmar se o Token está como “Ativo” (verde). Selecionar o Depósito Padrão de estoque no ERP. Ativar a Sincronização de Estoque. (Opcional) Ajustar a tabela de preços ou Markup de acréscimo. Fluxo de Pedidos e Etiquetas: Definir o Fluxo de Pedidos (ex: Emitir Nota/Etiqueta para automação completa). Definir o tipo de etiqueta como “Marketplace” (Americanas Entregas). Regra de Ouro do SKU: Reforçar que o código SKU na Americanas deve ser RIGOROSAMENTE IGUAL ao SKU cadastrado no ERP. Pergunta de Fechamento: Finalizar perguntando: “Você conseguiu realizar o login no portal da Americanas e confirmar a autorização com sucesso?” [FIM DO CONTEXTO PARA IA]

👤 RESUMO DO TUTORIAL

Visão Geral: Este tutorial ensina o passo a passo para conectar a sua loja da Americanas (Americanas Marketplace) ao sistema Expedy. A integração automatiza a importação das vendas, agiliza a emissão das Notas Fiscais Eletrônicas (NF-e) e envia automaticamente os dados fiscais de volta para a plataforma para a liberação da etiqueta de envio.

Tempo estimado de leitura: 3 minutos.

Pré-requisitos: Possuir conta de vendedor ativa no portal Americanas Marketplace e permissão de acesso ao módulo de Integrações na Expedy.

📖 CONTEÚDO PRINCIPAL (O Tutorial Passo a Passo)

A integração entre a Americanas e a Expedy permite centralizar o faturamento e o envio de todas as suas vendas do marketplace, automatizando o envio dos dados fiscais para manter a reputação da sua loja alta.

A conexão é realizada através de uma chave de integração segura (Token de API). Siga o roteiro em três etapas abaixo para concluir a configuração:

Etapa 1: Obter a Chave de API no portal da Americanas

  • Acesse o portal administrativo do Americanas Marketplace.
  • No menu de navegação, acesse a seção de Configurações e clique em Integrações, APIs ou Acesso de Desenvolvedor.
  • Localize o campo correspondente à Integração API (Token de API).
  • Depois em Integração API, aqui você tem que abrir um chamado para solicitar o token de acesso a plataforma.

Etapa 2: Configurar a Americanas na Expedy

  • Acesse o seu painel do sistema Expedy.
  • No menu lateral esquerdo, clique na opção Integrações.
  • No canto superior direito, clique no botão + Adicionar Integração.
  • Procure e selecione o card da Americanas na lista de plataformas disponíveis.
  • Preencha os campos com os dados da sua loja:
  • Nome da Integração: Digite uma identificação de sua preferência (Ex: Americanas – Loja Oficial).
  • B2W Email: Email da conta da Americanas.
  • Token de API / Chave de Acesso: Cole o código copiado no portal da Americanas.
  • Clique no botão Cadastrar Integração.

Clique no logotipo da “Americanas“.

Com o token em mãos, basta inseri-lo nos campos correspondentes dentro da Expedy para concluir a integração.

Etapa 3: Configurar a nova integração

Pronto, concluímos a integração, para realizar as configurações necessárias veja neste post (Configuração da integração)

❓ Dúvidas Frequentes (FAQ do Artigo)

  • O sistema exibiu erro de “Autenticação Falhou” ao salvar na Expedy. O que fazer? Verifique se a chave de API inserida está correta e sem espaços adicionais. Caso o erro persista, gere uma nova chave dentro do portal da Americanas e atualize o cadastro na Expedy.
  • A Expedy envia os dados da Nota Fiscal de volta para a Americanas? Sim. Assim que a nota fiscal é autorizada na SEFAZ, a Expedy envia a chave de acesso, o número e a série da NF-e para a Americanas, permitindo que a etiqueta de transporte seja gerada no painel deles.
  • Tenho mais de um CNPJ vendendo na Americanas. Como integrar? Você deve criar uma integração separada na Expedy para cada conta do Americanas Marketplace, vinculando cada uma ao seu respetivo CNPJ cadastrado na Expedy.

Artigos relacionados