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 Revenue Share. 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. |
Este exemplo sample-component é destinado a Solução Aplicativo. Como os requisitos de desenvolvimento podem variar, oferecemos apoio para ajustar os critérios às necessidades específicas da sua solução. |
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:
Este exemplo sample-component é destinado a Solução Aplicativo. Como os requisitos de desenvolvimento podem variar, oferecemos apoio para ajustar os critérios às necessidades específicas da sua solução. |
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 da 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 da solução 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.
| Item | Descrição | Detalhes/Exemplos | Link de apoio |
|---|---|---|---|
1. Imagens e informações da Store incompletas | Falta de banners, thumbnails ou descrição adequada da solução. | - | |
2. Documentação insuficiente ou desatualizada | Falta de documentação dentro da solução. | Não detalha instalação, parametrização, regras de negócio ou integrações. | |
3. Não informar o que a solução altera no TOTVS Fluig | Não detalhar na documentação o que a solução altera no TOTVS Fluig. | Registro de formulários, processos, papéis, grupos e demais mudanças. | Alterações no Fluig: como detalhá-las na documentação técnica? |
4. Ausência de canal de suporte e SLA | Documentação sem informações de atendimento ao cliente. | - | Por que é necessário incluir na documentação o canal de suporte e o tempo de SLA? |
5. Erros de grafia da marca e conceitos do TOTVS Fluig | Uso incorreto da marca e conceitos. | “GED" no lugar de “ECM”, uso incorreto de “TOTVS Fluig Plataforma”, etc. | Como usar corretamente conceitos, recursos, marcas ou submarcas do Fluig? |
6. Termos de Uso e Política de Privacidade ausentes | Documentos não disponíveis dentro da solução. | - | |
7. Uso de console.log e debugs em produção | Uso de comandos de debug em código de produção. | - | |
8. Arquivos não minificados (JS/CSS) | Impacta performance e não segue padrão oficial. | - | |
9. Logs sem identificação da solução | Falta de prefixo específico para rastreabilidade. | Exemplo: log.info(“@<Nome da solução + Parceiro>” + message); | |
10. Arquivos obrigatórios mal preenchidos | Preenchimento incorreto de arquivos essenciais. | application.info, component.xml, page.xml, versionamento incorreto. | |
11. Uso de APIs internas | Utilização de APIs que não são públicas. | - | |
12. Código com recursos desnecessários ou prejudiciais | Código com elementos que não agregam valor ou são prejudiciais. | Código comentado excessivo, valores fixos. | |
13. Arquivos não utilizados no pacote | Inclusão de arquivos que não são necessários no pacote de distribuição. | - | |
14. Uso de fonts/links externos sem necessidade | Dependência desnecessária de recursos externos. | - | Passo a Passo: Adicionar Recursos Externos ao Widget (JS/CSS) |
15. Falta de i18n (internacionalização) | A solução não suporta diferentes idiomas. | - | Passo a Passo: Configuração de Internacionalização (i18n) em Widgets |
16. Sobrescrever CSS interno do TOTVS Fluig | Modificação de estilos padrões do TOTVS Fluig. | Gera conflitos visuais e funcionais. | |
17. Processos sem imagem do diagrama | Fluxos de processo sem a imagem representativa do diagrama. | ||
18. Importação incorreta de JS/CSS | Referência feita no .ftl ao invés de usar o application.info. | - | Passo a Passo: Adicionar Recursos Externos ao Widget (JS/CSS) |
19. Não utilizar o Fluig Style Guide | Desrespeito ao guia de estilo visual do TOTVS Fluig. | - | |
20. Acesso direto ao Banco de Dados | É proibido usar JDBC direto ou consultas SQL hardcoded. | Use sempre Datasets e Serviços. | Proibição de Acesso Direto ao Banco de Dados (DB) e Otimização de Consultas |
21. Bibliotecas Obsoletas | Uso de versões antigas ou bibliotecas com vulnerabilidades conhecidas (CVEs). | - | |
22. Variáveis Fixas | Dados sensíveis ou de configuração fixos no código. | IPs, senhas, e-mails ou caminhos de servidor fixos. Tudo deve ser parametrizável. | Não Utilizar Recursos Técnicos com Valores Fixos (Acesso Dinâmico) |
É 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 conforme a necessidade. |
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 da Solução:
Ao enviar um e-mail, sempre coloque no assunto o nome da sua empresa e o motivo (ex: "Dúvida Técnica - [Nome da sua Empresa] - [Nome da sua Solução]" ou "Solicitação de Acesso - [Nome da sua Empresa]") para agilizar o atendimento. |
O Fórum de dúvidas tem um espaço para Parceiros TOTVS especializados no Fluig! Lá o parceiro pode tirar dúvidas técnicas, compartilhar soluções criativas e discutir as melhores práticas para implementação, integração e suporte da plataforma.
Para solicitar acesso, envie um e-mail para: Apoio Parceiros TOTVS Fluig: [email protected]
Ao enviar um e-mail, sempre coloque no assunto o nome da sua empresa e o motivo (ex: "Acesso Fórum de dúvidas - [Nome da Empresa]" ou "Solicitação de Acesso Fórum de dúvidas - [Nome da Empresa]") para agilizar o atendimento. Encontre o que precisa usando as etiquetas: para iniciantes, acesse guia-básico; para conteúdos intermediários, vá para guia-intermediário; para tópicos avançados, explore guia-avançado; e para requisitos, confira requisitos-review-solucao . |