Caso de estudo
Prim.io – aplicação pública Shopify
A Prim.io é uma plataforma ERP búlgara desenvolvida e operada pela ANTIPODES OOD. Dá a retalhistas, grossistas e fabricantes um sistema único para inventário, armazenamento, preços, documentos de venda, logística e registos financeiros.
A Prim.io serve empresas que gerem stock real em vários armazéns e precisam que os seus dados operacionais - quantidades, preços, expedições e documentos - se mantenham corretos num único local de referência. À medida que um número crescente dos seus clientes começou a vender online, a Prim.io precisava que o seu ERP se ligasse nativamente a plataformas de eCommerce, a começar pelo Shopify.
O projeto
O desafio
Os comerciantes que geriam o negócio num ERP e a loja no Shopify mantinham dois sistemas desligados. As encomendas eram reintroduzidas à mão no ERP, os níveis de stock afastavam-se até a loja vender mais do que tinha, as alterações de preços tinham de ser aplicadas duas vezes e os dados de expedição viviam num terceiro sítio completamente à parte. Cada um destes passos era manual, lento e propenso a erros.
A Prim.io precisava de uma aplicação pública do Shopify que fizesse o ERP e a loja comportarem-se como um só sistema - suficientemente fiável para funcionar sem supervisão para muitos comerciantes ao mesmo tempo e suficientemente simples para o dono de uma loja a configurar sem um programador.
A solução
Encomendada pela Gloross e construída em colaboração com eles, a Prim.io ERP Integration é uma aplicação pública incorporada do Shopify que mantém a loja Shopify de um comerciante e a sua conta ERP Prim.io continuamente sincronizadas - nos dois sentidos.
A aplicação é totalmente self-service: um fluxo de onboarding guiado acompanha o comerciante na ligação do seu ERP, na escolha das predefinições operacionais e no mapeamento dos armazéns, listas de preços, métodos de pagamento e transportadoras entre os dois sistemas. A partir daí, tudo corre em segundo plano.
Principais capacidades
- Sincronização de encomendas em tempo real - uma encomenda do Shopify torna-se uma venda no ERP em segundos, com o cliente, os artigos, o tipo de pagamento e o método de entrega convertidos nos códigos ERP do próprio comerciante.
- Sincronização de inventário - os níveis de stock são atualizados a cada minuto, com envio instantâneo opcional a partir do ERP; vários armazéns do ERP são consolidados nas localizações Shopify corretas.
- Sincronização de preços e produtos - listas de preços, títulos, descrições, pesos, imagens e estado do produto passam do ERP para o Shopify, com controlo campo a campo sobre o que pertence ao ERP.
- Logística e transportadoras - os métodos de envio do Shopify são mapeados para os códigos de entrega do ERP, incluindo logística de terceiros e postos de recolha das transportadoras, para que a transportadora e o posto escolhido acompanhem a encomenda.
- Seguimento de expedições - quando é emitida uma guia de transporte no ERP, a aplicação cria o fulfillment no Shopify com o número de seguimento e o cliente é notificado automaticamente.
- Espaços de trabalho multiloja - os grupos de comerciantes podem ligar até dez lojas numa única organização.
- Visibilidade operacional completa - registos de atividade em linguagem simples, um painel de atividade de sincronização e payloads de pedidos inspecionáveis para um apoio rápido.
Destaques de engenharia
A fiabilidade era o requisito central: uma aplicação pública processa encomendas reais de outras empresas e uma encomenda perdida é uma venda perdida. Os eventos recebidos são escritos numa fila durável e processados com repetições automáticas e recuo exponencial, para que nada se perca durante uma falha de rede ou uma implementação. As operações sobre todo o catálogo usam a API de operações em massa do Shopify para movimentar milhares de produtos de forma eficiente, enquanto as sincronizações incrementais enviam apenas o que mudou de facto.
A aplicação autentica-se com session tokens do Shopify, guarda as credenciais no servidor, verifica cada webhook recebido e implementa os webhooks de privacidade obrigatórios do Shopify - incluindo a eliminação completa dos dados de uma loja na desinstalação. A faturação é tratada através do Shopify, com vários escalões de subscrição, e toda a interface está localizada em inglês, búlgaro e romeno.
Resultado
Os comerciantes da Prim.io podem agora vender no Shopify sem manter à mão um segundo sistema. As encomendas chegam automaticamente ao armazém, o stock mantém-se correto de ambos os lados e o seguimento da expedição chega ao cliente sem que ninguém copie um número entre dois ecrãs.
Tecnologias
.NET 8
C#
PostgreSQL
React
Node.js
Shopify GraphQL API
REST API
Webhooks
Nginx
Linux