Integração FKSmart × Tiny ERP
Este manual orienta o processo de ativação e parametrização da integração entre o Tiny ERP e a FKSmart, permitindo o envio automático de pedidos, notas fiscais e etiquetas de transporte para o WMS.
1. Pré-requisitos
· Ter acesso ao painel do Tiny ERP com perfil de administrador.
· Extensão "Token API" instalada na conta Tiny.
· Expedições concluídas no Tiny (necessário apenas para clientes que utilizam marketplaces integrados ao Tiny e precisam de etiquetas via expedição).
2. Obter o Token de Integração (API Key)
· Acesse o painel do Tiny ERP. · Vá até Menu → Início → Extensões da Olist.
· Na seção Vendas, localize e instale a extensão Token API.
· Após a instalação, acesse Menu → Configurações → Aba E-commerce → Token API.
· Copie o token exibido no campo Token.
· Envie o token, junto com o CNPJ e razão social, para suporte@fksmart.com.br.
3. Definir a Situação de Integração de Pedidos
· Acesse Menu → Configurações → Aba Vendas → Pedidos de Venda.
· Selecione a situação que será usada como gatilho para a integração com a FKSmart.
· As situações disponíveis no Tiny são: Em aberto, Aprovado, Preparando envio, Faturado (atendido), Pronto para envio, Enviado, Entregue, Não Entregue e Cancelado. · Recomendamos utilizar "Aprovado" ou "Preparando envio", conforme o fluxo operacional da sua empresa.
· Informe a situação escolhida para a equipe FKSmart durante a configuração da integração.
4. Definir o Depósito Padrão para Integração
· Acesse Menu → Início → Extensões da Olist e, na seção Suprimentos, instale a extensão Depósitos de estoque (caso ainda não esteja instalada).
· Acesse Menu → Configurações → Aba Suprimentos → Depósitos de estoque.
· Localize o depósito que será utilizado na integração ou clique em Incluir depósito para criar um novo.
· No menu de contexto ao lado do depósito, selecione a opção para defini-lo como depósito padrão.
· Certifique-se de que os produtos estão vinculados a este depósito para evitar erros de estoque.
5. Configurar o Módulo de Expedição (somente para integração de etiquetas via Tiny)
Esta configuração é necessária apenas para clientes que utilizam marketplaces integrados ao Tiny e precisam que as etiquetas de envio sejam geradas e consultadas via expedição do Tiny ERP.
· Acesse Menu → Configurações → Aba Vendas → Expedição e Logística → Configurações da Expedição.
· No campo de envio automático, selecione a opção "Automático ao autorizar a nota fiscal".
· Configure as formas de envio por transportadora conforme necessário.
· Após a expedição ser criada e concluída, a FKSmart consultará as etiquetas disponíveis via API.
Caso não utilize este fluxo, consulte a seção 6 abaixo.
6. Etiquetas de Envio
A FKSmart suporta duas origens para obtenção das etiquetas de envio:
Via Tiny ERP (expedição): Quando o módulo de expedição está ativo e a expedição está concluída, a FKSmart consulta e obtém a etiqueta diretamente pelo Tiny. · Se o Tiny fornecer a etiqueta em PDF, a FKSmart converte automaticamente para ZPL.
Via plataformas integradas (sem dependência do módulo de expedição): A FKSmart obtém a etiqueta diretamente na plataforma de origem, utilizando o ID do marketplace e o número do pedido. As plataformas suportadas são: · Loggi – fornece etiquetas em PDF (convertidas para ZPL). · Mercado Livre, Shopee e Melhor Envio – fornecem etiquetas nativas em ZPL.
Ambas as formas podem ser utilizadas de acordo com a operação do cliente.
7. Fluxo Resumido da Integração
· Pedido criado no Tiny e alterado para a situação definida como gatilho de integração.
· Nota fiscal autorizada e expedição gerada automaticamente (quando aplicável).
· FKSmart consulta o Tiny, integra o pedido ao WMS e obtém a etiqueta ZPL (via Tiny ou diretamente na plataforma de origem).
· O status do pedido é atualizado e o processo de expedição é concluído.