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, comprar instalar e instalaratualizar, 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 Parceriaparceria: Estar ativo e regularizado com a TOTVS.
- Ambiente Própriopróprio: Ter um ambiente TOTVS Fluig de desenvolvimento para criar e testar seus códigos.
- Conhecimento Técnicotécnico: Dominar as ferramentas de desenvolvimento da plataforma (consulte sempre o TDN – Central de Ajudanossa documentação técnica oficial).
- Acesso ao Portal de Parceirosdo parceiros: É a ferramenta o portal por onde você enviará sua Solução 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
...
o Revenue Share
...
?
...
Funciona no modelo ganha-ganha Revenue Share. Quando uma Solução solução sua é vendida, o valor é dividido:
...
| Informações | ||
|---|---|---|
| ||
As porcentagens exatas estão definidas no seu Contrato contrato de Parceria parceria ou aditivo específico da Store no TOTVS Fluig. Consulte esse documento para ver os valores vigentes. |
Que tipos de
...
soluções eu posso vender na Store no TOTVS Fluig?
...
A plataforma é muito flexível. Você pode criar e vender diversos tipos de artefatossoluçõ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 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.
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 leia as "Diretrizes de Homologação da Store no TOTVS Fluig na consulte a Central de Ajuda para entender as regras para conhecer os requisitos técnicas e de segurança.
- Desenvolvimento e testes: Crie a Solução solução no seu ambiente e teste exaustivamente.
- Envio para homologação: Submeta o pacote da Solução 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 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. |
| Aviso | ||
|---|---|---|
| ||
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.
| 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 Criarcriar: Utilize o exemplo (sample-component)como modelo para garantir a estrutura correta.
- Gere o Pacote pacote e Instaleinstale: 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 Evoluaevolua: Teste exaustivamente sua solução até que ela esteja madura.
| Aviso | ||
|---|---|---|
|
...
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. |
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 documentação e Marketingmarketing: 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 o Formulário: 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 liberação/revogação de acesso ao Portal Partner
Um desenvolvedor saiu da equipe. O que devo fazer?
...
É dever do parceiro solicitar imediatamente a revogaçã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 liberação/revogação de acesso ao Portal Partner.
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 da 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.
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 eview 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.
Release Candidates (RC): O Fluig tem atualizações (MINOR) a cada 2 ou 3 meses. Você receberá acesso antecipado (RC) para testar e garantir que seu app continua compatível antes do lançamento oficial da plataforma.
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çãosolução. O processo verifica desde a experiência do usuário até a segurança.
...
| 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 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 solução segue as diretrizes para ser empacotado e publicado. |
| Privacidade | Garante que a Solução 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 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 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 Flow solução Flows esteja configurado corretamente, sem inconsistências. |
| Configuração | Garante que a Solução solução permita ao administrador controlar o acesso e a disponibilidade do app da solução no ambiente. |
| QA | Garante que o parceiro forneça uma licença válida para testes, caso a Solução solução possua licenciamento adicional, para validação completa. |
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 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 da 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.
| 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) |
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 conforme a necessidade.
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 da Solução:
- Portal do Parceiro: A comunicação principal ocorre diretamente pelo Portal de parceiros a ferramenta de submissão.
- Chat Exclusivo: Utilize o grupo de chat criado pela TOTVS no Google Chat para interações rápidas.
- E-mail de Apoio: [email protected].
| 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 sua Empresa] - [Nome da sua Solução]" ou "Solicitação de Acesso - [Nome da sua Empresa]") para agilizar o atendimento. |
Como posso solicitar acesso à área de fórum do parceiro dentro do Fórum de dúvidas
...
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]
| Dica |
|---|
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 . |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas