Histórico da Página
| Índice |
|---|
Dúvidas frequentes
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.
O que é exatamente a 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.
| Informações | ||
|---|---|---|
| ||
Acesse para mais detalhes: Plataforma | Store |
Por que devo investir tempo desenvolvendo soluções para a Store no TOTVS Fluig?
A Store no TOTVS Fluig é um acelerador de negócios para você parceiro de Soluções. As principais vantagens são:
- Junte-se aos maiores: O TOTVS Fluig faz parte do ecossistema TOTVS, líder absoluta no mercado brasileiro
- Exposição e divulgação
- Acesso a novos clientes: O TOTVS Fluig é uma plataforma que possui milhares de clientes, milhões de usuários, além de diversos canais e desenvolvedores especializados na plataforma.
- Acesso a tecnologia de ponta: O TOTVS Fluig fornece toda uma gama de recursos que facilitam o desenvolvimento de soluções e integrações com a plataforma:
- Recursos de Desenvolvimento:
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/).
- Conhecimento e Comunidade:
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/).
- Recursos de Desenvolvimento:
Quem pode vender soluções na Store no TOTVS Fluig?
A publicação e venda de soluções são exclusivas para Parceiros de Soluções.
O que o parceiro precisa ter antes de começar a desenvolver para a Store no TOTVS Fluig?
Você precisa do "kit básico" do parceiro desenvolvedor:
- Contrato de parceria: Estar ativo e regularizado com a TOTVS.
- Ambiente próprio: Ter um ambiente TOTVS Fluig de desenvolvimento para criar e testar seus códigos.
- Conhecimento técnico: Dominar as ferramentas de desenvolvimento da plataforma (consulte sempre o TDN – nossa documentação técnica oficial).
- Acesso ao Portal do parceiros: É a ferramenta por onde você enviará sua solução para nossa análise.
Quanto custa para publicar um aplicativo na Store no TOTVS Fluig?
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).
Como funciona esse "Revenue Share"?
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.
| Informações | ||
|---|---|---|
| ||
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. |
Que tipos de "coisas" eu posso vender na Store no TOTVS Fluig?
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. |
|
Desenvolvimento e Publicação
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.
Qual é o passo a passo para publicar minha primeira solução?
O processo segue este fluxo:
- Ideia e regras: Defina o que vai criar e consulte a Central de Ajuda para conhecer os requisitos técnicas e de segurança.
- Desenvolvimento e testes: Crie a solução no seu ambiente e teste exaustivamente.
- Envio para homologação: Submeta o pacote da solução através do Portal do parceiro
- Análise Review da Solução: Nossa equipe técnica revisará seu código (segurança, performance, etc.). Se necessário, pediremos ajustes.
- Aprovação e publicação: Após aprovado, você configura as informações comerciais (descrição de marketing, imagens, etc) e sua solução entra no ar para os clientes.
Onde encontro a documentação técnica e recursos para aprender a desenvolver para o TOTVS Fluig?
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.
| Informações |
|---|
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.
| Deck of Cards | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||
|
| Painel | ||
|---|---|---|
| ||
|
| Dica |
|---|
Não deixe de participar dos encontros do TOTVS Developers: https://developers.totvs.com/ |
Qual o passo a passo prático para desenvolver minha solução?
Já sabe o que vai criar e conhece a plataforma? Siga os passos:
- Instale o TOTVS Fluig: Baixe o instalador no Portal do Cliente ou solicite via Apoio Parceiros TOTVS Fluig se ainda não tiver acesso.
- Comece a criar: Utilize o exemplo (sample-component)como modelo para garantir a estrutura correta.
- Gere o pacote e instale: Após codificar, gere o arquivo do componente (EAR) e faça o deploy no seu ambiente TOTVS Fluig seguindo a documentação da Central de componentes
- Teste e evolua: Teste exaustivamente sua solução até que ela esteja madura.
Minha solução está pronta. Como faço para submetê-la na Store no TOTVS Fluig?
Após o ciclo de desenvolvimento, testes internos e feedback de beta testers, é hora de lançar!
- Empacote: Garanta que o código-fonte e dependências estejam em um arquivo .ear, na estrutura correta (você pode exportar diretamente pelo Fluig Studio).
- Capriche na documentação e marketing: A vitrine é fundamental. Prepare um texto vendedor, screenshots de alta qualidade, vídeos de demonstração e uma documentação de uso clara e completa. Clientes pesquisam antes de comprar; valorize seu produto!
- Envie: Acesse e envie através do Portal do parceiro o pacote da sua solução para nossa análise.
Como cadastro um novo desenvolvedor no Portal do parceiro?
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
Um desenvolvedor saiu da equipe. O que devo fazer?
É 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.
Como funciona o processo de Review da Solução da Store?
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.
- O que analisamos: Instalação, qualidade do código, comportamento no ambiente, segurança, boas práticas e documentação.
- Objetivo: Garantir o perfeito funcionamento para o cliente e apoiar você com as melhores práticas de desenvolvimento.
Como devo gerenciar as atualizações e versões da minha solução?
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.
Existe um checklist do que é obrigatório para cada tipo de solução?
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.
| Informações | ||
|---|---|---|
| ||
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 que NÃO entra no escopo do Review da Solução?
O Review da Solução foca na qualidade técnica, arquitetura, segurança e aderência aos padrões do TOTVS Fluig.
- Não analisamos: Regras de negócio específicas do nicho do cliente, estratégias de precificação ou customizações que fujam ao escopo da solução ofertada. Seguimos os passos do Review de Solução: o guia rápido para o parceiro de soluções.
Quais são as principais razões de reprovação da solução?
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. |
O que é a release antecipada parceiros TOTVS Fluig
É 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).
| Informações | ||
|---|---|---|
| ||
Por que devo testar solução na release antecipada?
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.
Onde faço o download da release antecipada
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.
Informações O TOTVS Fluig disponibiliza atualização de Acesso Antecipado de correção semanalmente.
Se um cliente comprar minha solução e tiver dúvidas ou encontrar um erro, quem dá suporte?
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.
| Informações | ||
|---|---|---|
| ||
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. |
O cliente tem autonomia sobre a solução?
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.
Contatos para dúvidas técnicas e Review da Solução
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]
- Deve-se utilizar também o grupo de chat criado pela TOTVS para o parceiro.
| Dica |
|---|
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. |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas