Sobre este projeto
it-programming / web-development
Aberto
Contexto Geral do Projeto
Desenvolvimento de Plataforma de Dropshipping Inteligente Multicanal (Shopee, Mercado Livre, TikTok Shop, Kwai Shop, Amazon, Magalu) com Carteira Digital, Gestão Fiscal, Separação e Embalagem, Multi-Fornecedores, e Whitelabel 🎯 Sobre o Projeto Buscamos um(a) desenvolvedor(a) experiente — ou uma pequena equipe — para desenvolver uma plataforma de dropshipping SaaS profissional e escalável, com automação total do ciclo de pedidos, integração completa com marketplaces, carteira digital interna, gestão fiscal automatizada, controle de estoque e logística, e estrutura whitelabel para multiplicar a solução para outros fornecedores. O objetivo é criar um sistema centralizado que: receba pedidos automaticamente dos marketplaces dos clientes, emita notas fiscais e envie para o marketplace e para o comprador, faça o controle de estoque próprio e de fornecedores secundários, realize a separação, embalagem e despacho inteligente, processe pagamentos e assinaturas de planos, e permita o uso da plataforma em modo whitelabel para outros fornecedores terem seu próprio sistema personalizado. 🧩 Escopo Funcional (MVP + V1) 1️⃣ Acesso, Multi-Tenant e Perfis Login seguro (e-mail/senha e 2FA opcional). Perfis com permissões (Admin, Operador, Fornecedor, Seller). Multi-tenant: cada fornecedor ou subplataforma opera de forma totalmente isolada, com suas próprias lojas, usuários e integrações. Admin principal (eu) pode atuar também como fornecedor dropshipping e incluir outros fornecedores secundários em minha conta, cujos estoques se somam aos meus. 2️⃣ Área de Separação e Embalagem Módulo interno para controle operacional de pedidos: Status: “A Separar”, “Em Separação”, “Embalado”, “Despachado”. Impressão de etiquetas, DANFE, packing list e comprovantes. Alocação de operador de separação (usuário interno). Registro de tempo de separação, produtos faltantes, fotos de conferência. Geração automática de QR Code de conferência antes do envio. Integração com coletores de código de barras, leitores móveis e impressoras térmicas. 3️⃣ Integrações com Marketplaces (Shopee, Mercado Livre, TikTok Shop, Kwai Shop, Amazon sp-api, magalu) oauth/api keys individuais por seller. Sincronização total: Produtos, estoque e preço em tempo real. Publicação e edição em massa (título, descrição, imagens, variações, ncm, ean, marca, categoria). Atualização de status do pedido, tracking e nota fiscal. Importação automática de pedidos (com webhook e polling redundante). Validação e normalização de dados (preço mínimo, markup, títulos, SEO, atributos obrigatórios). 4️⃣ Catálogo, Estoque e Multi-Fornecedores Catálogo centralizado com SKU master e variações. Estoque unificado: soma de estoques próprios + fornecedores secundários conectados. Prioridade configurável (estoque próprio → fornecedor A → fornecedor B). Controle de ruptura, bloqueio de SKUs e substituições automáticas. Cadastro de novos fornecedores com painel próprio e permissões limitadas. Cada fornecedor pode ter seu painel whitelabel com logo, domínio e cores personalizadas. Logs de movimentação de estoque e rastreabilidade por lote. 5️⃣ Automação de Pedidos Consolidação de todos os pedidos recebidos de marketplaces. Atualização automática de status conforme integração fiscal e logística. Timeline do pedido (criado → pago → separado → embalado → enviado → entregue → devolvido). Roteamento inteligente: identifica o fornecedor mais próximo ou com menor custo de frete. Impressão em massa de etiquetas, romaneios e comprovantes de coleta. 6️⃣ Fiscal / NF-e Integração com provedores como TecnoSpeed, NFe.io, PlugNotas, ou outro. Emissão automática de NF-e (modelo 55) com envio para marketplace e cliente. Cadastro fiscal completo por fornecedor (cnpj, ie, regime, cfop, ncm, cest). Cancelamento, carta de correção e contingência automática. Armazenamento de xml e danfe com histórico por pedido. 7️⃣ Logística e Rastreamento Integração com gateways (Melhor Envio, Frenet, Intelipost, transportadoras diretas). Geração de etiquetas e rastreio automático. Múltiplos centros de distribuição por fornecedor. Controle de SLA e alerta de atraso. Atualização de status e comprovante de entrega automático. 8️⃣ Carteira Digital / Wallet Cada fornecedor e seller possui uma conta virtual dentro da plataforma. Entradas: repasses de vendas, créditos, bônus, devoluções. Saídas: taxas, mensalidades, saques. Lançamentos automáticos por pedido, plano, taxa de marketplace e custo de envio. Saque manual com aprovação e KYC básico. Relatórios de extrato, DRE e comissão consolidada. 9️⃣ Planos e Assinaturas (Dropshipping / SaaS) Planos configuráveis (Free, Basic, Pro, Enterprise). Cada plano define: Limite de SKUs ativos. Quantidade de pedidos/mês. Número de marketplaces conectados. Recursos premium (API, relatórios avançados, suporte prioritário). Cobrança automática via Mercado Pago, Asaas ou outro gateway. Geração de PIX, boleto e cartão. Retentativas automáticas, cancelamento por inadimplência e upgrade automático. Integração com webhooks para conciliação. 🔟 Modo Whitelabel Completo Permite revender o sistema como plataforma própria: Personalização de domínio, logo, cores e e-mail. Painel exclusivo com subdomínio (ex: meusistema.com.br). Controle de usuários, fornecedores e planos. Gestão independente de billing, carteira e marketplace. Licenciamento modular (cada whitelabel é um tenant isolado, com base de dados e credenciais próprias). O Admin principal (eu) poderá criar novas instâncias whitelabel e gerenciar faturamento e hospedagem de cada uma. ⚙️ Requisitos Técnicos Arquitetura: API-First, modular, multi-tenant e escalável. Stack sugerida: Back-end: Node.js (NestJS) ou Python (FastAPI) ou PHP (Laravel). Banco: PostgreSQL + Redis (cache/filas). Front-end: React/Next.js ou Vue/Nuxt (UI moderna e responsiva). Infraestrutura: Docker, ci/cd, logs centralizados, health check e observabilidade. Segurança: lgpd, criptografia aes/ssl, tokens rotativos, rate limiting, trilha de auditoria. Testes: unitários, integração e E2E. Documentação: Swagger/OpenAPI + collection Postman. 📦 Entregáveis (MVP) Painel completo de login e multi-tenant. Integrações funcionais (Shopee + Mercado Livre no MVP). Catálogo com estoque unificado (multi-fornecedor). Módulo de pedidos com área de separação e embalagem. Emissão automática de NF-e e envio ao marketplace. Painel de planos e cobrança integrada (Mercado Pago/Asaas). Carteira digital e relatórios financeiros básicos. Função de whitelabel funcional com subdomínio e personalização visual. Documentação técnica e manual do usuário. ✅ Critérios de Aceite Pedidos processados em até 60 segundos após criados no marketplace. Estoque sincronizado em menos de 3 minutos entre canais. Emissão de NF-e automática e anexa ao pedido em até 90 segundos. Separação e embalagem com rastreabilidade e QR Code funcional. Painel whitelabel gerando nova instância funcional em menos de 5 minutos. 👤 Perfil Ideal Experiência comprovada com APIs de marketplaces (Shopee, ML, Amazon, Magalu, etc.). Domínio em automação de pedidos, webhooks, NF-e e carteiras digitais. Conhecimento em estrutura multi-tenant, whitelabel e billing SaaS. Capacidade de documentar e estruturar código limpo e modular. Experiência prévia com dropshipping, fulfillment, ou hubs de integração. 📄 O que enviar na Proposta Portfólio ou GitHub com projetos similares. Descrição técnica da arquitetura proposta. Cronograma com entregáveis (MVP e V1). Estimativa de horas/custo por etapa. Abordagem para whitelabel e multi-fornecedor. Estratégia de segurança, auditoria e escalabilidade. 🕐 Informações Adicionais Contratação PJ via Workana. Fuso: America/São_Paulo. Comunicação via chat diário (pt-br). Entregas em ambiente Docker e Git controlado. Código e direitos autorais pertencem integralmente ao contratante. Sobre o Projeto Buscamos um(a) desenvolvedor(a) sênior (ou pequena squad) para construir uma plataforma proprietária de dropshipping multiloja e multicanal. O sistema deve integrar marketplaces (Shopee, Mercado Livre, TikTok Shop, Kwai Shop, Amazon, Magalu) para cadastro inteligente de produtos, sincronização de estoque/preço, recebimento e roteamento de pedidos, emissão e envio de NF-e, logística, cobranças de planos e taxas, e carteira digital interna para conciliação e repasses. Objetivo Permitir que nossos clientes (sellers) conectem suas lojas nos marketplaces e operem em modelo de dropshipping, enquanto a nossa plataforma: publica/atualiza produtos nos canais, recebe pedidos em tempo real, emite NF-e e notifica o marketplace/cliente, orquestra expedição, controla estoque e preços, cobra planos/assinaturas e taxas, liquida valores via carteira digital e integrações de pagamento. Escopo Funcional (MVP → V1) 1) Autenticação, Acesso e Multi-Tenant Login com e-mail/senha e 2FA (TOTP). Perfis e RBAC (admin da plataforma, operador interno, seller, financeiro). Multi-tenant real: cada seller possui seus conectores, catálogos, regras fiscais, estoques, pedidos e relatórios isolados. 2) Integrações com Marketplaces (conectores) Shopee, Mercado Livre, TikTok Shop, Kwai Shop, Amazon (sp-api), magalu. Fluxos: OAuth/API keys por seller. Publicação/edição em massa de produtos (título, descrição, imagens, variações, atributos, categorias, gtin/ean, ncm, marca, dimensões, sla). Sincronização de estoque e preço (bidirecional, com prioridade de origem configurável). Pedidos em tempo real via webhooks/polling com deduplicação e reprocessamento. Atualização de status (pago, separado, enviado, entregue, devolvido). Upload de nota fiscal/manifestação, tracking e comprovantes (quando suportado pelo canal). Camada de mapeamento inteligente: Categorias e atributos por canal (templates e presets). Regras de título/SEO, variação e imagens por canal. Regras de precificação (markups, arredondamento, mínimo de margem, promoções). Anti-duplicidade de anúncios por sku/gtin/canais. 3) Catálogo e Estoque SKU Master com variações; kit e bundle. Regras de estoque: mínimo de segurança, reservas por pedido, bloqueio de ruptura, backorder opcional. Importação e edição em massa (csv/xlsx) e via api. Logs de alterações (auditoria completa). 4) Pedidos e Orquestração Consolidação de pedidos de todos os canais em uma única fila. Regras de roteamento: prioridade de armazém, estoque disponível, SLA de canal, custo de frete. Timeline do pedido (eventos: criado, pago, separado, NF-e, coleta, enviado, entregue, devolvido). Impressão de documentos: etiquetas, packing list, romaneio. Devoluções/Trocas: abertura, aprovação com regras, etiquetas de retorno, crédito na carteira. 5) Fiscal/NF-e Emissão de NF-e (Modelo 55; NFC-e 65 se necessário): integração via provedor fiscal (ex.: TecnoSpeed/NFe.io/Outro de sua preferência). Cadastro fiscal por seller: cnpj/ie/csosn/ncm/cest/cfop, regras por uf. Envio automático do XML/Chave de acesso ao marketplace e ao comprador (quando aplicável). Manifestação, cancelamento e carta de correção. Armazenamento de xml e danfe (download). 6) Logística e Rastreamento (opcional no MVP, desejável) Cálculo de frete via gateways (ex.: Melhor Envio/Frenet/Intelipost/Transportadoras diretas) — plugável. Geração de etiquetas e rastreio unificado multi-transportadora. SLA e promessas de entrega por canal. Eventos de rastreamento integrados na timeline do pedido. 7) Carteira Digital (Wallet) e Financeiro Saldo por seller: créditos de vendas líquidas, débitos de taxas, mensalidades, estornos. Subcontas/contas virtuais por seller. Lancamentos contábeis: recebíveis, comissões, taxas por pedido/canal, mensalidades/planos. Saques/withdraw com fluxo de aprovação (KYC básico). Conciliação: pedidos → NF-e → repasses → baixas. Relatórios: DRE simplificada, extrato, comissão por canal, aging de recebíveis. 8) Planos de Assinatura (Drop) e Cobranças Planos (Free/Basic/Pro/Enterprise) com limites por: número de SKUs ativos, pedidos/mês, canais conectados, features premium (ex.: Regras de preço avançadas, API, relatórios). Cobrança recorrente via Mercado Pago, Asaas (e gateway “outro” plugável). Emissão de boletos/PIX/Cartão, webhooks de pagamento, retentativas, suspensão automática por inadimplência. Cupom/Promo codes, teste grátis, upgrade/downgrade pró-rata. 9) Automação “Inteligente” de Publicação Regra-motor para decidir onde e como publicar o produto: Score por canal (fit de categoria, margem, taxa do canal, histórico de conversão). Ajuste de preço por marketplace (taxas, comissões, frete incluso/fora). Saneamento de dados (título, imagens mínimas, variações, atributos obrigatórios). Simulação antes de publicar (pré-validação) e relatório de erros por canal. 10) Painéis & UX Dashboard geral (KPIs: pedidos, faturamento, margem estimada, ruptura, devoluções, SLA). Dashboard do seller (por canal, produto, campanha). Filtros avançados, exportações csv/xlsx, busca por sku/gtin/pedido/cliente. Notificações (e-mail, WhatsApp via provedor, web push) por evento crítico. Requisitos Não Funcionais Arquitetura: API-first, microserviços ou modular monolito bem organizado. Filas (RabbitMQ/Kafka/SQS) para webhooks e jobs assíncronos. Stack sugerida (flexível): Back-end: Node.js (NestJS) ou Python (FastAPI) ou PHP (Laravel). Banco: PostgreSQL (primário) + Redis (cache/filas). Front-end: React/Next.js (ou Vue/Nuxt) com ui limpa e responsiva (desktop/tv). Infra: Docker, ci/cd, ambientes (dev/stage/prod), logs centralizados, métricas e alertas. Segurança: lgpd, criptografia em repouso/trânsito, rotação de tokens, rate limiting, ip allowlist para webhooks, auditoria completa (quem fez o quê, quando). Qualidade: testes unitários/integração/E2E, documentação (OpenAPI/Swagger), collection Postman, versionamento semântico. Escalabilidade: horizontalização dos workers, idempotência e garantia de entrega de eventos. Entregáveis (MVP de referência) Arquitetura documentada (diagrama + decisões). Conectores: pelo menos 2 marketplaces totalmente funcionais no MVP (ex.: Shopee + Mercado Livre) + camadas prontas para plugar os demais. Catálogo/Estoque com importação, edição e sync básico. Pedidos com ingestão em tempo real, timeline e mudança de status. Fiscal: emissão de NF-e com envio ao pedido/cliente. Planos & Cobrança: cadastro de planos, assinatura, cobrança via Mercado Pago ou Asaas. Carteira Digital: extrato, lançamentos, saldo e saque manual. Painéis: dashboard mínimo + listagens (produtos, pedidos, faturas, sellers). Logs & Auditoria + Observabilidade (health, métricas). Manual do Usuário (admin e seller) + Guia técnico (deploy, .env, jobs, webhooks). Após o MVP, avançaremos para V1 com os demais canais, logística completa, pricing avançado, antifraude, simulação de margem, roteirização por múltiplos CDs, etc. Critérios de Aceite (exemplos) Webhooks de pedido idempotentes (sem duplicidade). >99% de pedidos do período importados em até 60s após criação no canal (em ambiente de teste). NF-e emitida e anexada/visible no pedido em até 90s após confirmação de pagamento. Divergência de estoque < 1 unidade por SKU entre plataforma e marketplace após 5 minutos de alteração. Plano “Free” bloqueia recursos premium e impõe limites conforme configuração. Cobrança recorrente: criação/retentativa/cancelamento funcionam e espelham status no cadastro do seller. Carteira: somatório de lançamentos = saldo; extrato reconcilia com pedidos e taxas. Perfil Desejado Experiência comprovada em APIs de marketplaces (pelo menos duas entre Shopee/ML/Amazon/Magalu/TikTok/Kwai). Domínio de webhooks, filas, idempotência, rate limiting. Vivência com fiscal brasileira (NF-e) e provedores terceiros. Sólidos fundamentos em segurança, LGPD, multi-tenant e auditoria. Capacidade de documentar e entregar com testes. Diferenciais Já ter construído B2B2C / hub de integração / OMS. Experiência com sp-api (amazon), mercado pago e asaas. Conhecimentos de logística (transportadoras, gateways de frete). Infra como código (Terraform), Kubernetes. O que fornecer na proposta Portfólio/GitHub com projetos similares (links obrigatórios). Breve descrição da arquitetura que pretende usar e por quê. Cronograma por marcos (MVP → V1) com entregáveis claros. Estimativa de horas/custos por entregável (não precisa prazo fechado, mas granular). Lista dos riscos previstos (limites de APIs, fiscal, logística) e como mitigará. Necessidades de terceiros (provedor fiscal, gateways de pagamento, mensageria, storage). Perguntas de Triagem (responda ao candidatar-se) Quais marketplaces você já integrou (links de repositório ou prints do painel)? Mostre um endpoint seu com idempotência (ex.: Retry de webhook) e explique a estratégia. Como você faria o mapeamento de categorias/atributos por canal e a validação pré-publicação? Qual sua abordagem para NF-e (emissão, contingência, cancelamento e armazenamento dos XMLs)? Descreva sua estratégia de sincronização de estoque e preço para evitar corrida de concorrência. Como você implementaria a carteira digital (modelo de lançamentos, reconciliação e saque)? Que métricas/alertas monitoraria em produção e como trataria falhas intermitentes de APIs? Observações Contratação via Workana (PJ). Comunicação diária (pt-br), fuso america/sao_paulo. Entregas versionadas, ci/cd, homologação contínua. Código será nosso (cessão de direitos/uso), com documentação completa. Preferência por quem possa começar pelo MVP e evoluir para V1/V2.
Categoria TI e Programação
Subcategoria Programação
Isso é um projeto ou uma posição de trabalho? Um projeto
Tenho, atualmente Eu tenho uma ideia geral
Disponibilidade requerida Período integral
Integrações de API Mídias sociais (Facebook, Twitter, etc), Payment Processor (Paypal, Stripe, etc), Cloud Storage (Dropbox, Google Drive, etc), Outros (Outras APIs)
Funções necessárias Desenvolvedor, Designer
Duração do projeto De 1 a 3 meses
Habilidades necessárias