Como integrar software de despesas com ERP TOTVS: guia prático

Por que a integração com TOTVS é prioritária para empresas brasileiras

O TOTVS domina mais de 50% do mercado de ERP para médias empresas no Brasil. Protheus é o produto mais usado em manufatura, distribuição, construção e serviços. TOTVS RM é forte em saúde e educação. Para qualquer plataforma de gestão de despesas que atenda empresas brasileiras, a integração com TOTVS é requisito, não diferencial.

Sem integração, o fluxo é manual: a equipe financeira exporta um relatório da plataforma de despesas e lança manualmente no TOTVS — duplicando o trabalho, criando risco de erro e atrasando o fechamento. Para entender o contexto completo, veja o guia sobre gestão de despesas e integração com ERP.

Modelos de integração disponíveis com TOTVS

1. API nativa — o modelo mais eficiente

O TOTVS Protheus e o RM disponibilizam APIs REST que permitem que sistemas externos leiam e escrevam dados diretamente. Uma plataforma de despesas com conector nativo para TOTVS usa essa API para enviar lançamentos aprovados automaticamente, sem exportação de arquivo.

Como funciona na prática: a despesa é aprovada na plataforma de gestão → os dados (valor, conta contábil, centro de custo, CNPJ do fornecedor, data) são enviados via API → o TOTVS registra o lançamento automaticamente.

2. Arquivo de importação — para customizações específicas

O TOTVS aceita importação de lançamentos via arquivos nos formatos TXT, CSV e XML com layouts específicos (SIGACON, CTBA). A plataforma de despesas gera o arquivo no formato correto e a equipe financeira importa no TOTVS periodicamente — diariamente ou semanalmente.

É um modelo mais trabalhoso que a API, mas funciona para ERPs com configurações muito customizadas onde a API nativa não consegue mapear todos os campos necessários.

3. TOTVS iPaaS — middleware da própria TOTVS

O TOTVS iPaaS é uma plataforma de integração da própria TOTVS que conecta sistemas externos ao Protheus via conectores configuráveis. Para empresas que já usam o iPaaS para outras integrações, é possível configurar a conexão com a plataforma de despesas através dele.

O que mapear antes de integrar

Passo a passo para integrar software de despesas com TOTVS

1. Levantar o plano de contas atual do TOTVS — exportar a lista de contas contábeis e centros de custo ativos
2. Mapear categorias de despesa × contas contábeis — definir qual conta do TOTVS corresponde a cada categoria da plataforma de despesas (alimentação, combustível, hospedagem, SaaS...)
3. Configurar a conexão — credenciais de API do TOTVS, ambiente (homologação primeiro, depois produção), empresa fiscal
4. Testar com lançamentos reais — processar 10 a 20 despesas reais e validar os lançamentos no TOTVS antes de ativar em escala
5. Ativar para todos os colaboradores — após validação, desligar o processo manual de exportação e relançamento
6. Monitorar logs de integração — acompanhar logs nas primeiras 2 semanas para identificar lançamentos rejeitados e ajustar mapeamentos

Principais erros na integração com TOTVS

• Testar direto em produção: lançamentos incorretos no TOTVS precisam de estorno manual — sempre testar em ambiente de homologação primeiro
• Plano de contas desatualizado: criar novas categorias de despesa na plataforma sem mapear a conta contábil correspondente gera lançamentos rejeitados
• Ignorar a hierarquia de filiais: empresas com múltiplos CNPJs precisam configurar cada empresa fiscal separadamente — um lançamento na empresa errada gera problema contábil
• Não configurar sincronização bidirecional: integração que só envia despesas para o TOTVS mas não importa plano de contas de volta fica desatualizada quando o TOTVS é alterado

Como a Payfy integra com TOTVS Protheus e RM

A Payfy tem integração nativa bidirecional com TOTVS Protheus e TOTVS RM — desenvolvida e mantida pela equipe da Payfy, sem necessidade de customização por parte do cliente. A configuração é feita pela equipe de implementação da Payfy em parceria com o time de TI da empresa.

• Importação automática do plano de contas: o Payfy importa plano de contas e centros de custo do TOTVS automaticamente — sem digitação manual
• Envio automático de lançamentos: despesas aprovadas são enviadas ao TOTVS via API em tempo real — sem exportação de arquivo
• Suporte a múltiplas empresas fiscais: matriz e filiais com CNPJs diferentes, cada uma com seu ambiente TOTVS
• Logs de integração: rastreabilidade completa de cada lançamento enviado — status, data, campos e erro em caso de rejeição

Para entender como funciona a integração de gestão de despesas com ERP de forma mais ampla, veja nosso guia. E para o contexto completo de gestão de despesas corporativas, veja nosso guia completo. Agende uma demonstração gratuita.