Pular para o conteúdo principal

Já é cliente eNotas? Acesse o material com as orientações sobre a Reforma Tributária e o Portal de Gestão NFS-e.

[Shopify] Como habilitar a integração na eNotas

Atualizado

Neste artigo, você aprenderá a criar um aplicativo personalizado na Shopify para integrar sua loja ao eNotas utilizando o novo modelo de autenticação OAuth. Esse processo garante mais segurança e estabilidade na comunicação entre as plataformas.

Pré-requisitos:

  • Ter acesso administrativo à loja Shopify.
  • Garantir que a loja esteja ativa.
  • Ter permissão para desenvolver aplicativos personalizados.

Na plataforma da Shopify:

  1. Acesse o painel administrativo da sua Shopify.
  2. No menu lateral esquerdo, clique em Configurações.
  3. Clique em Apps e depois em Desenvolver apps.
  4. Clique em Desenvolver Apps no Dev Dashboard.
  5. Caso seja solicitado, habilite o desenvolvimento de apps personalizados.
  6. Clique em Criar um app.
  7. Dê um nome ao aplicativo (ex.: eNotas Integração) e clique em Criar.

Para que o eNotas funcione corretamente, você deve configurar os escopos de acesso exatamente como listado abaixo:

  1. Na tela do app criado, localize a seção de Acesso - Escopos
  2. Copie e cole a lista de escopos abaixo, sem espaços extras no início ou no fim: read_customers,read_inventory,read_orders,read_products,read_resource_feedbacks,read_all_orders,write_orders
  3. Ao final da página clique em Lançar
  4. Retorne clicando no nome da aplicação criada e clique em Instalar app.
  5. Confirme a instalação na sua loja.

Agora, você precisará de três informações para inserir no painel do eNotas:

  1. ID do cliente e Chave secreta: No dashboard do app, em Configurações, copie essas duas chaves.
  2. Domínio da loja: Na tela inicial da sua loja vá em Configurações > Domínios e copie o domínio principal (ex.: 33a08v-eff.myshopify.com)

⚠️ IMPORTANTE! Ao inserir o domínio no eNotas, é obrigatório adicionar o protocolo https:// no início. Exemplo: https://33a08v-eff.myshopify.com

Habilitar a integração com a eNotas

  1. Com os dados em mãos, acesse o seu painel do eNotas.
  2. No menu, vá em Gerenciar.
  3. Clique na opção Apps.
  4. Localize a integração com a Shopify 2.0 e clique em Ativar.
  5. Insira o ID do cliente, a Chave secreta e o Domínio obtidos anteriormente.
  6. Clique em Confirmar.
❯ Por que devo informar o "Custo por item" nos meus produtos da Shopify?

Se você utiliza a Shopify integrada ao eNotas, o preenchimento do custo de cada item é fundamental para garantir que suas notas fiscais sejam emitidas com o valor correto de faturamento, especialmente se o seu modelo de negócio exige a tributação apenas sobre o lucro.


O que é o custo por item?

É o valor que o produto ou a variante custa para você (preço de custo).

  • Revenda: insira o preço pago ao fornecedor (excluindo impostos e frete).
  • Fabricação própria: insira o valor baseado em mão de obra e materiais.


⚠️ Importante: O preenchimento deste campo impacta diretamente o valor das notas emitidas. Se sua empresa precisa emitir notas apenas sobre o lucro real das vendas, este campo deve estar obrigatoriamente preenchido na Shopify.


Como o eNotas calcula o valor da nota?

  • Campo vazio: o eNotas utilizará o valor total do campo Preço como base para a nota fiscal.
  • Campo preenchido: o eNotas buscará o valor do campo Lucro (Preço - Custo) como base para a emissão.


Como cadastrar o custo de forma individual

  1. No painel da Shopify, acesse Produtos.
  2. Selecione o produto desejado.
  3. Na página do produto, localize a seção Preços e encontre o campo Custo por item.
  4. Insira o valor de custo. O sistema calculará o lucro automaticamente ao lado.
  5. Clique em Salvar.


Como cadastrar o custo em massa

  1. No menu lateral, clique em Produtos.
  2. Selecione os produtos que deseja editar através das caixas de seleção.
  3. Clique em Editar produtos (ou Edição em massa).
  4. Se a coluna Custo por item não estiver visível, clique em Colunas (ou Adicionar campos) e selecione Custo por item.
  5. Preencha os valores nas linhas correspondentes.
  6. Clique em Salvar.


Após esses passos, defina as configurações do fluxo de emissão das notas em sua conta. Sua integração está ativa e as vendas serão importadas automaticamente.

FAQ

❯ O menu "Desenvolver apps" não aparece na minha Shopify. O que fazer?

Isso geralmente acontece por dois motivos:

  1. Sua conta de usuário não possui permissões administrativas. Verifique com o dono da loja se você tem acesso total às configurações.
  2. O recurso de desenvolvimento de apps personalizados ainda não foi habilitado. Siga as instruções na tela da Shopify para ativar essa função.
❯ Onde encontro o ID do cliente e a Chave secreta após a instalação?

Essas informações ficam dentro do aplicativo que você criou. Acesse: Configurações > Apps e canais de vendas > Desenvolver apps, clique no app do eNotas e vá até a aba Configurações de API.

❯ Posso usar o domínio personalizado da minha loja (ex: www.minhaloja.com.br)?

Recomendamos utilizar o domínio padrão da Shopify (finalizado em .myshopify.com) para garantir a estabilidade da integração via API, sempre incluindo o https://

Ficou alguma dúvida? É só acionar o nosso time de suporte 😊.

Relativo a

Artigos relacionados