Como habilitar integração com a The Mart
A The Mart é a solução definitiva para empreender com sucesso na internet. Você pode maximizar suas vendas, seja com produtos físicos ou digitais, utilizando todas as soluções oferecidas. Pode aproveitar as ferramentas e recursos para impulsionar o desempenho do seu negócio, além de pode alcançar um público maior, otimizando suas estratégias de marketing e convertendo mais clientes.
Após logar em sua conta na Spedy, clique em Apps no menu lateral e, no card da The Mart, clique no botão Desabilitado ou no botão Mais Ações (três pontos) > + Nova Integração.
Na tela exibida, o botão Habilitar integração já estará ativado.
Em Qual modelo de nota fiscal? será definido o modelo de nota fiscal que será utilizado por padrão nas vendas. Se precisar, você poderá modificar o modelo de forma específica no cadastro do produto.
A opção Quando emitir a nota fiscal? definirá em que momento a nota fiscal será emitida para as vendas integradas:
Antes de habilitar a emissão automática é necessário emitir uma nota fiscal para validação. Por isso, ao habilitar a integração, por padrão, as vendas serão integradas com o modo de emissão Não emitir automaticamente. Posteriormente, após validar a emissão de nota, será possível habilitar a emissão automática.
Na geração da venda: A venda será integrada logo após geração na plataforma de vendas, mesmo sem a aprovação do pagamento e a nota fiscal será emitida automaticamente;
Emitir após o período de garantia: A nota será emitida automaticamente após o período de garantia da venda;
Emitir quando o pagamento for aprovado: A nota será emitida automaticamente após a aprovação do pagamento da venda;
Não emitir automaticamente: A nota deverá ser emitida manualmente na tela de vendas.
Homologada a emissão de nota fiscal, se for preciso importar vendas retroativas, selecione a opção Não emitir automaticamente, para evitar a emissão de nota fiscal em competência indevida. Após a integração das vendas retroativas, habilite novamente a emissão automática conforme preferência.
A opção Enviar nota fiscal via email para o cliente? define se, após autorização da nota, ela será ou não enviada via e-mail ao cliente.
Já a opção Cancelar nota fiscal quando houver um reembolso? define se a nota será ou não cancelada automaticamente quando houve aprovação de reembolso para a venda.
Agora, em sua conta na The Mart, acesse o menu Ferramentas > API e clique no botão Adicionar (+);
Na tela exibida, informe Spedy no campo Descrição e clique em Salvar.
Em seguida, copie o Token gerado e cole no respectivo campo na tela de Configurações do App da The Mart na Spedy.
Agora, precisaremos configurar o Webhook.
Acesse o menu Ferramentas > Webhooks e clique no botão Adicionar (+);
Na tela exibida, preencha os campos da seguinte forma:
Nome: Spedy;
Link de integração: Informe a Url exibida na tela de Configurações do app da The Mart na Spedy;
Produto: Selecione o produto desejado (pode ser selecionados todos produtos ou um produto específico);
Planos: Selecione o plano desejado ou marque a opção Selecionar todos os planos;
Eventos: Selecione os eventos Pedido realizado, Pedido pago e Pedido reembolsado.
Clique em Salvar para concluir a configuração do Webhook..
Para concluir a configuração na Spedy, iremos informar qual a data de início da integração e a quantidade de dias de garantia (caso se trabalhe com a emissão das notas Após o período de garantia).
No campo Data de início da integração, deve-se informar a data a partir da qual o sistema deverá importar as vendas. Este campo é utilizado quando existem vendas retroativas a serem integradas.
Por exemplo: a integração está sendo realizada no dia 15/04/2024. Contudo, existem vendas realizadas desde 01/04/2024. Logo, deverá ser informada a data 01/04/2024 para que as vendas retroativas sejam integradas.
Se for trabalhar com a emissão automática da nota fiscal Após o período de garantia, no campo Dias de garantia, deverá ser informada a quantidade de dias de garantia. Informando os dias de garantia, o campo Data de garantia será preenchido na venda e a nota fiscal será emitida automaticamente após o período da garantia.
Clique em Salvar para concluir a configuração da integração da Spedy com a The Mart.
A partir de agora, suas vendas na The Mart começarão a aparecer no painel de vendas da Spedy automaticamente.
Viu como é simples e fácil utilizar nossa plataforma? Cuidamos de suas notas fiscais para que você foque no crescimento do seu negócio.
Caso ainda tenha alguma dúvida, entre em contato conosco através de um de nossos canais de atendimento.
Até mais.
Habilitando integração
Após logar em sua conta na Spedy, clique em Apps no menu lateral e, no card da The Mart, clique no botão Desabilitado ou no botão Mais Ações (três pontos) > + Nova Integração.
Na tela exibida, o botão Habilitar integração já estará ativado.
Em Qual modelo de nota fiscal? será definido o modelo de nota fiscal que será utilizado por padrão nas vendas. Se precisar, você poderá modificar o modelo de forma específica no cadastro do produto.
A opção Quando emitir a nota fiscal? definirá em que momento a nota fiscal será emitida para as vendas integradas:
Antes de habilitar a emissão automática é necessário emitir uma nota fiscal para validação. Por isso, ao habilitar a integração, por padrão, as vendas serão integradas com o modo de emissão Não emitir automaticamente. Posteriormente, após validar a emissão de nota, será possível habilitar a emissão automática.
Na geração da venda: A venda será integrada logo após geração na plataforma de vendas, mesmo sem a aprovação do pagamento e a nota fiscal será emitida automaticamente;
Emitir após o período de garantia: A nota será emitida automaticamente após o período de garantia da venda;
Emitir quando o pagamento for aprovado: A nota será emitida automaticamente após a aprovação do pagamento da venda;
Não emitir automaticamente: A nota deverá ser emitida manualmente na tela de vendas.
Homologada a emissão de nota fiscal, se for preciso importar vendas retroativas, selecione a opção Não emitir automaticamente, para evitar a emissão de nota fiscal em competência indevida. Após a integração das vendas retroativas, habilite novamente a emissão automática conforme preferência.
A opção Enviar nota fiscal via email para o cliente? define se, após autorização da nota, ela será ou não enviada via e-mail ao cliente.
Já a opção Cancelar nota fiscal quando houver um reembolso? define se a nota será ou não cancelada automaticamente quando houve aprovação de reembolso para a venda.
Agora, em sua conta na The Mart, acesse o menu Ferramentas > API e clique no botão Adicionar (+);
Na tela exibida, informe Spedy no campo Descrição e clique em Salvar.
Em seguida, copie o Token gerado e cole no respectivo campo na tela de Configurações do App da The Mart na Spedy.
Agora, precisaremos configurar o Webhook.
Acesse o menu Ferramentas > Webhooks e clique no botão Adicionar (+);
Na tela exibida, preencha os campos da seguinte forma:
Nome: Spedy;
Link de integração: Informe a Url exibida na tela de Configurações do app da The Mart na Spedy;
Produto: Selecione o produto desejado (pode ser selecionados todos produtos ou um produto específico);
Planos: Selecione o plano desejado ou marque a opção Selecionar todos os planos;
Eventos: Selecione os eventos Pedido realizado, Pedido pago e Pedido reembolsado.
Clique em Salvar para concluir a configuração do Webhook..
Para concluir a configuração na Spedy, iremos informar qual a data de início da integração e a quantidade de dias de garantia (caso se trabalhe com a emissão das notas Após o período de garantia).
No campo Data de início da integração, deve-se informar a data a partir da qual o sistema deverá importar as vendas. Este campo é utilizado quando existem vendas retroativas a serem integradas.
Por exemplo: a integração está sendo realizada no dia 15/04/2024. Contudo, existem vendas realizadas desde 01/04/2024. Logo, deverá ser informada a data 01/04/2024 para que as vendas retroativas sejam integradas.
Se for trabalhar com a emissão automática da nota fiscal Após o período de garantia, no campo Dias de garantia, deverá ser informada a quantidade de dias de garantia. Informando os dias de garantia, o campo Data de garantia será preenchido na venda e a nota fiscal será emitida automaticamente após o período da garantia.
Clique em Salvar para concluir a configuração da integração da Spedy com a The Mart.
A partir de agora, suas vendas na The Mart começarão a aparecer no painel de vendas da Spedy automaticamente.
Viu como é simples e fácil utilizar nossa plataforma? Cuidamos de suas notas fiscais para que você foque no crescimento do seu negócio.
Caso ainda tenha alguma dúvida, entre em contato conosco através de um de nossos canais de atendimento.
Até mais.
Atualizado em: 18/04/2024
Obrigado!