Preparamos este guia de perguntas e respostas para resolver de forma rápida e clara as principais dúvidas sobre como funciona a nossa Store no TOTVS Fluig.
É uma grande vitrine onde os clientes TOTVS Fluig podem navegar, descobrir novas soluções, instalar e atualizar, com poucos cliques soluções prontas que complementam e potencializam o uso da plataforma em seu negócio.
Acesse para mais detalhes: Plataforma | Store |
A Store no TOTVS Fluig é um acelerador de negócios para você parceiro de Soluções. As principais vantagens são:
Central do Desenvolvedor: Documentação oficial e guias técnicos (Central de ajuda).
APIs & SDKs: Recursos robustos para integrar suas soluções profundamente à plataforma (https://api.fluig.com/).
Guia de Estilos (Style Guide): Padrões visuais para garantir que sua interface seja bonita e consistente com o TOTVS Fluig (https://style.fluig.com/).
TOTVS Fluig Academy: Portal de e-learning para capacitação contínua do parceiro (https://academy.fluig.com/).
Fórum TOTVS: Uma comunidade ativa para tirar dúvidas e trocar experiências com outros desenvolvedores e profissionais de negócios (https://forum.totvs.io/).
Webinars Técnicos: Sessões exclusivas para se manter atualizado sobre as novidades da plataforma (https://developers.totvs.com/).
A publicação e venda de soluções são exclusivas para Parceiros de Soluções.
Você precisa do "kit básico" do parceiro desenvolvedor:
Não existe um custo fixo de publicação para o parceiro de Soluções. Nós trabalhamos no modelo de Revenue Share (compartilhamento de receita).
Funciona no modelo ganha-ganha. Quando uma solução sua é vendida, o valor é dividido:
Uma porcentagem do valor da venda vai para você, o desenvolvedor.
Outra porcentagem fica com o TOTVS Fluig para cobrir custos da plataforma, vitrine e transações financeiras.
As porcentagens exatas estão definidas no seu contrato de parceria ou aditivo específico da Store no TOTVS Fluig. Consulte esse documento para ver os valores vigentes. |
A plataforma é muito flexível. Você pode criar e vender diversos tipos de soluções:
| Categoria da Solução | Descrição | Observações |
|---|---|---|
| Solução Aplicativo | Aplicações robustas que rodam dentro do TOTVS Fluig, utilizando recursos nativos da plataforma (widgets, datasets, processos, layouts, formulários, APIs etc.). São instaladas no ambiente do cliente TOTVS Fluig. |
|
| Solução Flows | Soluções compostas por processos e formulários prontos, focadas em implantação rápida. Não são aplicativos completos, mas processos prontos para serem instalados e usados com configurações mínimas. |
|
| Solução Runner | É uma solução aplicativo, porém entregue em uma arquitetura SaaS hospedada na nuvem, comercializada como serviço. O cliente não precisa ter um ambiente TOTVS Fluig, pois o aplicativo utiliza o TOTVS Fluig apenas como motor (engine) nos bastidores. |
|
Preparamos este guia de perguntas e respostas para resolver de forma rápida e clara as principais dúvidas sobre como funciona o desenvolvimento de soluções e a publicação na Store no TOTVS Fluig.
O processo segue este fluxo:
Para desenvolvedores interessados em distribuir soluções para o TOTVS Fluig foi disponibilizado um exemplo (sample-component) completo no repositório Git Fluig utilizando a estrutura necessária para estes projetos.
Leia o arquivo README para conhecer os detalhes da estrutura do projeto de um componente da Store. |
Além disso, abaixo também estão listadas as principais referências para o desenvolvimento dos componentes da plataforma que compõe um produto distribuído pela Store.
|
|
Não deixe de participar dos encontros do TOTVS Developers: https://developers.totvs.com/ |
Já sabe o que vai criar e conhece a plataforma? Siga os passos:
Após o ciclo de desenvolvimento, testes internos e feedback de beta testers, é hora de lançar!
O parceiro deve enviar uma solicitação seguindo os passos Solicitação de ativação/desativação de acesso ao Portal do parceiro TOTVS Fluig
É dever do parceiro solicitar imediatamente a desativação do acesso desse usuário. O processo é o mesmo da ativação. Manter a lista de usuários atualizada é crucial para a segurança das informações da sua empresa dentro do Portal de parceiros.
O parceiro deve enviar uma solicitação seguindo os passos Solicitação de ativação/desativação de acesso ao Portal do parceiro TOTVS Fluig.
Nós queremos que a Store seja um ambiente seguro e confiável para os clientes. Por isso, todas as soluções (novas ou atualizações) passam por um rigoroso Review de Solução: o guia rápido para o parceiro de soluções antes de serem publicadas.
Sua solução deve evoluir para corrigir bugs e acompanhar a plataforma TOTVS Fluig.
Envio ao Review da Solução: Todas as atualizações (correções ou novos recursos) devem ser submetidas ao processo de Review da Solução. É vetada a distribuição direta para clientes.
Versionamento Semântico: Recomendamos seguir o modelo 2.0.0 (MAJOR.MINOR.PATCH).
MAJOR: Mudanças incompatíveis na API.
MINOR: Novas funcionalidades compatíveis.
PATCH: Correções de falhas compatíveis.
Release Notes: Toda atualização da solução deve vir acompanhada de notas de lançamento detalhando o que mudou.
Os requisitos do Review da Solução são divididos em categorias para cobrir todos os aspectos da sua solução. O processo verifica desde a experiência do usuário até a segurança.
A tabela a seguir apresenta um resumo dos requisitos por categoria.
Para consultar a descrição completa de cada requisito, clique aqui. |
| Categoria | O que o Review da Solução avalia |
| Documentação de uso | Garante que a documentação (recursos, regras, instalação, pré-requisitos, etc.) seja completa, acessível e atualizada para o usuário final e administrador. |
| Desenvolvimento | Verifica se o código segue as boas práticas do TOTVS Fluig e evita variações técnicas, consultas diretas ao banco, bibliotecas desatualizadas, códigos duplicados e configurações fixas. |
| Segurança | Assegura que a solução não exponha vulnerabilidades e que as informações sejam protegidas. Exige o uso de conexões seguras (SSL/TLS) em serviços externos. |
| Distribuição | Confirma se a solução segue as diretrizes para ser empacotado e publicado. |
| Privacidade | Garante que a solução tenha Termos de uso e Política de privacidade adequados à legislação, com transparência sobre a coleta e tratamento de dados. |
| Técnico | Garante que o parceiro envie o código-fonte completo e o artefato compilado devidamente. |
| Instalação | Verifica se a instalação é isenta de erros. O instalador deve executar todos os procedimentos (deploy, criação de registros, etc.) e validar permissões/pré-requisitos automaticamente. |
| Onboarding | Assegura que a solução proporcione um Onboarding rápido e simples, sem exigir configurações manuais ou processos adicionais após a instalação. |
| Uso | Garante que a solução funcione sem travamentos ou erros, oferecendo boa usabilidade, interface responsiva, mensagens claras e conteúdo sem erros gramaticais. |
| Processos | Garante que a solução Flows esteja configurado corretamente, sem inconsistências. |
| Configuração | Garante que a solução permita ao administrador controlar o acesso e a disponibilidade do app no ambiente. |
| QA | Garante que o parceiro forneça uma licença válida para testes, caso a solução possua licenciamento adicional, para validação completa. |
O Review da Solução foca na qualidade técnica, arquitetura, segurança e aderência aos padrões do TOTVS Fluig.
A solução é reprovada principalmente quando viola os padrões de arquitetura e segurança do TOTVS Fluig, apresenta baixa performance ou código sujo, e falha na documentação.
A tabela a seguir apresenta um resumo das principais razões para a reprovação no Review da Solução.
| Principais motivos | Descrição do erro |
|---|---|
| Imagens e informações da Store incompletas | Falta de banners, thumbnails ou descrição adequada da solução. |
| Documentação insuficiente ou desatualizada | Falta de documentação dentro da solução. |
| Não informar o que o app altera no TOTVS Fluig | Não detalhar na documentação o que a solução altera no TOTVS Fluig como: registro de formulários, processos, papéis, grupos e demais mudanças. |
| Ausência de canal de suporte e SLA | Documentação sem informações de atendimento ao cliente. |
| Erros de grafia da marca e conceitos do TOTVS Fluig | “GED" no lugar de “ECM”, uso incorreto de “TOTVS Fluig Plataforma”, etc. |
| Termos de Uso e Política de Privacidade ausentes | Documentos não disponíveis dentro da solução. |
| Uso de console.log e debugs em produção | - |
| Arquivos não minificados (JS/CSS) | Impacta performance e não segue padrão oficial. |
| Logs sem identificação da solução | Falta de prefixo específico para rastreabilidade. log.info (“@<Nome do App + Parceiro>” + message); |
| Arquivos obrigatórios mal preenchidos | application.info, component.xml, page.xml, versionamento incorreto. |
Uso de APIs internas | - |
Código com recursos desnecessários ou prejudiciais | Código comentado excessivo, valores fixos. |
Arquivos não utilizados no pacote | - |
Uso de fonts/links externos sem necessidade | - |
Falta de i18n (internacionalização) | - |
Sobrescrever CSS interno do TOTVS Fluig | Gera conflitos visuais e funcionais. |
Processos sem imagem do diagrama | - |
Importação incorreta de JS/CSS | Referência feita no .ftl ao invés de usar o application.info. |
Não utilizar o Fluig Style Guide | - |
Acesso direto ao Banco de Dados | É proibido usar JDBC direto ou consultas SQL hardcoded. Use sempre Datasets e Serviços. |
Bibliotecas Obsoletas | Uso de versões antigas ou bibliotecas com vulnerabilidades conhecidas (CVEs). |
Variáveis Fixas | IPs, senhas, e-mails ou caminhos de servidor fixos no código. Tudo deve ser parametrizável. |
É um programa que permite aos parceiros acesso às novas versões do TOTVS Fluig (fase Release Candidate) antes do lançamento oficial para o mercado (General Availability - GA).
Para garantir a compatibilidade. Você deve validar sua solução no novo ambiente para assegurar que, quando seu cliente atualizar o TOTVS Fluig, sua solução continue funcionando perfeitamente.
Os pacotes estão disponíveis para download no Portal do parceiro, fique atento às notícias para saber os passos exatos para realizar o download. Sempre acompanhe o Release Notes para saber o que há de novo.
Acesso Antecipado: O parceiro receberá acesso antecipado para testar a nova release e garantir que sua solução continua compatível antes do lançamento oficial da plataforma.
O TOTVS Fluig disponibiliza atualização de Acesso Antecipado de correção semanalmente. |
O parceiro desenvolvedor, é o responsável pelo suporte da sua solução.
O TOTVS Fluig garante que a Store funcione. No entanto, o suporte sobre o uso, configuração ou correção de bugs específicos da sua solução deve ser fornecido pela sua equipe. Por isso, é fundamental manter seus contatos de suporte sempre atualizados na descrição da solução na Store no TOTVS Fluig.
Toda correção aplicada a soluções publicadas exige um novo ciclo de submissão e revisão para que a versão atualizada seja disponibilizada na Store. |
Sim. A solução deve ser construída de forma que o administrador do ambiente TOTVS Fluig no cliente possa controlar o acesso, ativar ou desativar a solução, conforme necessário.
Para questões específicas sobre o desenvolvimento, validação técnica ou feedback sobre o processo de Review de Solução:
A comunicação geralmente ocorre através da própria ferramenta de submissão no Portal do parceiro ou pelo e-mail: Apoio Parceiros TOTVS Fluig: [email protected]
Ao enviar um e-mail, sempre coloque no assunto o nome da sua empresa e o motivo (ex: "Dúvida Técnica - [Nome da Empresa]" ou "Solicitação de Acesso - [Nome da Empresa]") para agilizar o atendimento. |