Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


Í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
titleInformaçõ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/)

  • Vitrine Global: Suas soluções ficam visíveis para toda a base de clientes TOTVS Fluig.

  • Nova Receita: É uma fonte de receita adicional (recorrente ou pontual) através da venda de propriedade intelectual.

  • Venda Rápida: O ciclo de venda é curto. O cliente vê a necessidade, compra e instala, sem a complexidade de grandes projetos de implantação
      • .


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 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 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
titleNota

...

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

...

soluções eu posso vender na

...

Store no TOTVS Fluig?

...

A plataforma é muito flexível. Você pode criar e vender diversos tipos de artefatos:

...

Widgets: Pequenos aplicativos funcionais para páginas.

...

Layouts: Estruturas visuais para portais e intranets.

...

Processos (BPM) e Formulários: Fluxos de trabalho prontos (ex: um processo de aprovação de viagens).

...

Datasets: Integrações de dados.

soluções:

Categoria da SoluçãoDescriçãoObservaçõ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.

  • Aplicativo que usa os componentes nativos do TOTVS Fluig.
  • Cliente precisa ter um ambiente TOTVS Fluig.
    • Ex.: Aplicativo de gestão com widget + processo + formulários + relatório.
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.
  • Cliente precisa ter TOTVS Fluig para instalar o Flows.
    • Ex.: Fluxo de aprovação de férias pronto, Processos para RH, Financeiro, TI etc.
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.

  • Um aplicativo construído com tecnologia TOTVS Fluig, mas oferecido como SaaS.
    • Ex.: Cliente acessa via web, sem instalar TOTVS Fluig.


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 Regrasregras: Defina o que vai criar e leia as "Diretrizes de Homologação da Store" no TDN para entender as regras consulte a Central de Ajuda  para conhecer os requisitos técnicas e de segurança.
  • Desenvolvimento e Testestestes: Crie a solução no seu ambiente e teste exaustivamente.
  • Envio para Homologaçãohomologação: Submeta o pacote da solução através da "Central de Componentes".do Portal do parceiro
  • Análise Review da SoluçãoAnálise Fluig: Nossa equipe técnica revisará seu código (segurança, performance, etc.). Se necessário, pediremos ajustes.
  • Aprovação e Publicaçãopublicação: Após aprovado, você configura as informações comerciais (preço, 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.

Aviso
titleAviso importante

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
iddesenvolvimento
Card

...

labelWidgets

Documentações

Vídeos

Guia de desenvolvimento de portais no TOTVS Fluig: aprenda a construir soluções integradas e robustas. Da edição de páginas à integração de sistemas, explore todo o potencial da plataforma.

Card
labelLayouts

Documentações

Vídeos

Guia de desenvolvimento de portais no TOTVS Fluig: aprenda a construir soluções integradas e robustas. Da edição de páginas à integração de sistemas, explore todo o potencial da plataforma.

Card
labelLicenças
  • obrigatório que seu componente verifique se o cliente possui uma licença válida para usá-lo.

    • Todo parceiro recebe um SlotID exclusivo para o componente criado.

    • Você deve usar o recurso "Slots" na API de Licenciamento para verificar a disponibilidade no License Server do cliente.

    • O endpoint para consulta é: [protocolo]://[host fluig]/license/api/v1/slots/{SlotID}.
Bloco de código
titleDica
Para ver os detalhes técnicos dessa API, acesse o Swagger no seu ambiente de desenvolvimento: [protocolo]://[host fluig]/license/swagger-ui/#/Slots
Painel
titlePrecisa de mais ajuda?
  • 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/).

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.
Aviso
titleAviso importante

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 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 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.
  • 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
titleNota:

Para consultar a descrição completa de cada requisito, clique aqui.

CategoriaO que o Review da Solução avalia
Documentação de usoGarante que a documentação (recursos, regras, instalação, pré-requisitos, etc.) seja completa, acessível e atualizada para o usuário final e administrador.
DesenvolvimentoVerifica 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çaAssegura 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çãoConfirma se a solução segue as diretrizes para ser empacotado e publicado.
PrivacidadeGarante 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écnicoGarante que o parceiro envie o código-fonte completo e o artefato compilado devidamente.
InstalaçãoVerifica 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.
OnboardingAssegura que a solução proporcione um Onboarding rápido e simples, sem exigir configurações manuais ou processos adicionais após a instalação.
UsoGarante que a solução funcione sem travamentos ou erros, oferecendo boa usabilidade, interface responsiva, mensagens claras e conteúdo sem erros gramaticais.
ProcessosGarante que a solução Flows esteja configurado corretamente, sem inconsistências.
ConfiguraçãoGarante que a solução permita ao administrador controlar o acesso e a disponibilidade da solução no ambiente.
QAGarante 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.


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.

ItemDescriçãoDetalhes/ExemplosLink de apoio

1. Imagens e informações da Store incompletas

Falta de banners, thumbnails ou descrição adequada da solução.

-

Como disponibilizar imagens da sua solução na Store? 

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.

Planejamento e Estrutura da Documentação

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.

-

Como criar e disponibilizar a Política de Privacidade? 

7. Uso de console.log e debugs em produção

Uso de comandos de debug em código de produção.

-

Como remover recursos desnecessários da sua solução?

8. Arquivos não minificados (JS/CSS)

Impacta performance e não segue padrão oficial.

-

Como remover recursos desnecessários da sua solução?

9. Logs sem identificação da solução

Falta de prefixo específico para rastreabilidade.

Exemplo: log.info(“@<Nome da solução + Parceiro>” + message);

Como implementar rastreabilidade de logs no Fluig? 

10. Arquivos obrigatórios mal preenchidos

Preenchimento incorreto de arquivos essenciais.

application.info, component.xml, page.xml, versionamento incorreto.

Como configurar os arquivos pages.xml e component.xml 

Passo a Passo: Configurando o application.info 

11. Uso de APIs internas

Utilização de APIs que não são públicas.

-

Aplicação correta de APIs na plataforma: como fazer?

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.

Como remover recursos desnecessários da sua solução?

13. Arquivos não utilizados no pacote

Inclusão de arquivos que não são necessários no pacote de distribuição.

-

Como remover recursos desnecessários da sua soluçã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.

Como utilizar o Fluig Style Guide de maneira adequada?

17. Processos sem imagem do diagrama

Fluxos de processo sem a imagem representativa do diagrama.


Como exportar processo e formulário via API?

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.

-

Como utilizar o Fluig Style Guide de maneira adequada?

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).

-

Gestão de Dependências e Conflitos

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
titleInformações

Acesse para mais detalhes: Liberação de release antecipada parceiros TOTVS Fluig.


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?

...

Você, o O parceiro desenvolvedor, é o responsável pelo suporte da sua solução.

A O TOTVS Fluig garante que a loja Store funcione. No entanto, o suporte sobre o uso, configuração ou correção de bugs do seu aplicativo específico 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 do produto na lojada solução na Store no TOTVS Fluig.

Informações
titleInformaçõ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 .