bernetshop para TYPO3

Nem toda loja TYPO3 precisa de um framework de e-commerce completo

Aimeos é o padrão para e-commerce no TYPO3. Mas Aimeos também é complexo: camada de abstração de banco de dados própria, sistema de templates próprio, mais de 30 tabelas de configuração. Para uma associação que vende 8 artigos de merchandising ou uma empresa de médio porte com 50 peças de reposição, é exagero. bernetshop oferece uma alternativa leve: lista de produtos, carrinho, pagamento, pronto. Sem gestão de estoque, sem multi-loja, mas também sem meses de configuração.

A extensão é destinada a organizações que querem vender poucos produtos pelo seu site TYPO3 existente, sem operar um sistema de loja separado. O uso típico: 10 a 200 produtos, variantes simples (tamanho, cor), pagamento por boleto, PayPal ou Stripe.

Cenários típicos de uso

Associações e organizações sem fins lucrativos. Clubes esportivos vendem camisetas e ingressos, instituições culturais oferecem assinaturas anuais e publicações. A loja precisa ser fácil de manter, pois voluntários a gerenciam. bernetshop pode ser configurado via elementos de conteúdo padrão do TYPO3: um produto é um registro com imagem, preço, descrição e variantes. Sem necessidade de treinamento além da edição normal do TYPO3.

Venda de peças de reposição e acessórios. Fabricantes de máquinas e equipamentos vendem peças de desgaste, acessórios e materiais de consumo pelo site corporativo. Os dados do produto já existem no TYPO3 (páginas de produto, fichas técnicas), bernetshop complementa com carrinho e função de pagamento. A manutenção do produto permanece onde os dados técnicos já estão: no CMS.

Portais de pedidos internos. Empresas maiores utilizam sistemas simples de pedidos para material de escritório, material promocional ou acessórios de TI. bernetshop com TYPO3 Frontend-Login resulta em um portal de pedidos protegido por senha sem software externo. Os pedidos são encaminhados por e-mail ao departamento responsável, uma conexão ERP não é prevista e nesse contexto não é necessária.

Arquitetura técnica

bernetshop é baseado em Extbase/Fluid, o framework padrão para extensões TYPO3. Os dados de produto são armazenados em uma tabela própria tx_bernetshop_domain_model_product. Variantes (tamanhos, cores) são modeladas como relações inline. O carrinho é mantido na sessão PHP e opcionalmente persistido no banco de dados para usuários registrados.

A lógica da loja é clara: há controllers para lista de produtos, detalhe de produto, carrinho e checkout. Os templates são Fluid padrão e podem ser personalizados como qualquer outro template TYPO3. O processamento de pagamento ocorre via um adaptador de provedor de pagamento: PayPal, Stripe e boleto são implementados por padrão. Provedores adicionais podem ser acrescentados via interface PHP.

Os pedidos são armazenados em uma tabela do banco de dados e disparam um e-mail de confirmação para cliente e operador da loja. Um módulo de backend mostra todos os pedidos com status (aberto, pago, enviado). Exportação como CSV está integrada, uma interface ERP direta não.

A extensão utiliza o cache padrão do TYPO3 para listas de produtos. O carrinho e a área de checkout são uncacheable (USER_INT). Isso significa: páginas de lista de produtos se beneficiam do cache TYPO3, o checkout roda sem cache, o que é relevante sob alta carga.

Problemas frequentes e soluções

Limites de escalabilidade a partir de 200 produtos. A lista de produtos fica lenta com número crescente de produtos quando nenhuma paginação está configurada. bernetshop inclui uma paginação simples, mas sem busca facetada ou filtro por categoria. Solução: a partir de 200 produtos, criar páginas de categoria e limitar a lista de produtos por categoria. A partir de 500 produtos, considerar seriamente Aimeos ou uma loja externa.

Integração de pagamento desatualizada. Os adaptadores de pagamento incluídos usam parcialmente versões mais antigas das APIs dos provedores. A API clássica do PayPal foi descontinuada, Stripe atualizou sua API várias vezes. Solução: verificar os adaptadores de pagamento e atualizar para versões de API atuais. O esforço por adaptador é de 1 a 2 dias de desenvolvimento.

Requisitos legais não completamente cobertos. Direito de arrependimento, indicação de preço base, regulamento de embalagem e as obrigações de informação no e-commerce exigem adaptações que bernetshop não entrega out-of-the-box. No Brasil, a LGPD (PT: RGPD) e o Código de Defesa do Consumidor impõem requisitos específicos para lojas online. Solução: complementar os templates de checkout com as informações legalmente necessárias. Isso é trabalho de template, não desenvolvimento de extensão.

Migração e compatibilidade de versões

bernetshop é uma extensão de nicho com manutenção limitada. A última versão estável suporta TYPO3 v10 e v11. Para TYPO3 v12 não existe atualização oficial, o esforço de portabilidade é gerenciável (alterações de API Extbase, ajustes TCA), mas deve ser feito manualmente. Para TYPO3 v13 não há planejamento.

Empresas que migram para TYPO3 v12 ou v13 enfrentam uma decisão: portar bernetshop ou mudar para uma alternativa. As opções são Aimeos (framework de e-commerce completo, esforço significativamente maior), cart (loja baseada em Extbase com manutenção ativa e compatibilidade v12) ou uma loja externa (Shopify, WooCommerce) com integração TYPO3 via API.

A migração dos dados de produto é sempre simples: a tabela tem uma estrutura clara que pode ser transferida para qualquer sistema de destino via script SQL. Em um cliente com 85 produtos, a migração completa de bernetshop para EXT:cart incluindo adaptação de templates levou 4 dias de trabalho. A Gosign orienta sobre a opção mais econômica e assume a portabilidade ou migração conforme necessidade.