A Skafe Cosméticos é uma marca brasileira de cuidados capilares com várias linhas de produtos, entre elas Keraform, Keramax e Natutrat. Construí e mantenho a plataforma Shopify da marca, que reúne o site institucional, o catálogo de produtos e a loja online em skafe.com.br. Também construí a infraestrutura de comércio por trás da loja: as integrações entre Shopify, Bling ERP e transportadoras.
Visão geral e contexto de negócio
Uma marca como essa precisa fazer três coisas no mesmo site: apresentar a empresa, documentar uma linha grande de produtos e vender online. O negócio também depende de sistemas fora da Shopify. O Bling ERP cuida de notas fiscais e estoque, e as transportadoras cuidam da entrega. O objetivo era uma loja que funcione bem para o cliente e mantenha esses sistemas alinhados sem redigitação manual.
Papel: Desenvolvedor Full-Stack e Engenheiro de E-commerce.
Minhas responsabilidades
- Customizar e manter a loja Shopify com Liquid e JavaScript.
- Projetar a arquitetura de integração entre Shopify, Bling ERP e transportadoras.
- Construir e operar as integrações em Cloudflare Workers, D1 e Queues.
- Automatizar estoque, notas fiscais, etiquetas de envio e rastreio de pedidos.
- Melhorar o design responsivo, a descoberta de produtos e a experiência de compra.
Desenvolvimento da loja
A loja é um tema Shopify customizado, escrito em Liquid e JavaScript e pensado para funcionar bem em qualquer dispositivo. Um único tema atende as páginas institucionais, o catálogo e a loja.
Catálogo e loja
Nem todo produto da Skafe é vendido online, então a loja separa duas coisas:
- Catálogo. Uma referência institucional da linha de produtos, onde o visitante consulta informações, composição, modo de uso e detalhes técnicos. Toda entrada do catálogo oferece "Ver informações".
- Loja online. O subconjunto de produtos que podem ser comprados. Essas entradas aparecem como "Disponível na loja" e trazem a ação "Comprar na loja".
Produtos que não são vendidos online continuam documentados e fáceis de encontrar, sem mostrar um caminho de compra que não leva a lugar nenhum.
Arquitetura de backend e integrações
A Shopify não conversa sozinha com o Bling nem com as transportadoras, então coloquei uma camada de integração entre eles na Cloudflare:
- Workers executam a lógica de integração entre Shopify, Bling ERP e transportadoras (incluindo a Frenet) por meio de suas APIs REST.
- D1 armazena os dados da integração.
- Queues tiram o trabalho do caminho da requisição, para que as chamadas a APIs externas rodem de forma assíncrona.
Automação de e-commerce
A camada de integração automatiza quatro tarefas operacionais que, de outra forma, seriam feitas à mão entre os sistemas:
- Sincronização de estoque
- Processamento de notas fiscais
- Geração de etiquetas de envio
- Rastreio de pedidos
Os dados dos pedidos circulam entre Shopify, Bling ERP e transportadoras sem repasses manuais.
UX e otimização de conversão
Melhorei a loja com layouts responsivos, melhor descoberta de produtos e ajustes de UX voltados à conversão. A separação entre catálogo e loja descrita acima faz parte disso: o cliente pode explorar a linha completa e ver com clareza o que pode comprar. Não publico números de conversão deste projeto.
Desafios técnicos e soluções
Vários sistemas, cada um com seus dados. Shopify, Bling ERP e transportadoras guardam, cada um, uma parte da história de um pedido. Coloquei uma camada de integração entre eles nos Workers, para que cada sistema possa se concentrar no seu papel.
Chamadas externas lentas ou instáveis. APIs de ERP e de transportadoras não devem bloquear a loja nem umas às outras. As Queues mantêm esse trabalho assíncrono e fora do caminho da requisição.
Produtos informativos ao lado de produtos à venda. Um único site precisava documentar toda a linha e vender só uma parte dela. Separar o catálogo da loja online, com rótulos explícitos em cada entrada, deixa a diferença clara para o cliente.