Integrações do Primavera: conectores, API e fluxos com o resto da empresa

Quem procura um conector Primavera quase nunca quer o conector em si. Quer que a encomenda da loja chegue ao ERP sem ser digitada de novo, que o extrato do banco se concilie sozinho, que o painel de gestão leia os mesmos números que a contabilidade. Esta página explica como pensar a integração Primavera como um projeto com fluxos, responsáveis e testes, e não como uma lista de ligações a comprar.

Em Portugal, há uma restrição que pesa em todas as decisões: o que toca em faturação tem de respeitar o software certificado pela AT, o ATCUD, o código QR e o SAF-T (PT). Uma integração mal desenhada pode ser rápida no primeiro dia e um problema fiscal no primeiro fecho.

O que o editor diz sobre abertura e integração

O editor afirma que o ERP Evolution se integra facilmente com todos os sistemas e aplicações e que se adapta aos processos de negócio. Indica também que serviços cloud e aplicações de terceiros podem ser integrados no ERP em cloud.

É uma declaração de princípio, não um catálogo. Não diz que existe um conector pronto para a sua loja, para o seu banco ou para a sua ferramenta de BI. A pergunta útil é outra: para cada ligação de que precisa, existe um conector pronto, uma interface oficial para o construir ou apenas uma troca de ficheiros? Peça essa resposta por escrito ao integrador, ligação a ligação, para a versão que vai instalar. A escolha da edição influencia o que está disponível; veja versões e edições do Primavera.

Ferramentas já ligadas ao ecossistema Cegid

Alguns dos instrumentos mencionados pelo editor resolvem problemas de integração sem desenvolvimento:

• Office Extensions: dá acesso aos dados do ERP a partir do tabelador que a equipa já usa. Para o financeiro, é muitas vezes a integração mais rentável, porque evita exportar, limpar e voltar a importar.
• Cegid Docs: permite enviar documentos por email ou por importação, extrair dados através de código QR e tratar a informação recebida. Faz sentido onde entram muitas faturas de fornecedores.
• Cegid Fiscal Automation: associado ao ERP Evolution for Accountants, envia automaticamente as declarações dos clientes às entidades oficiais. Destina-se sobretudo a gabinetes de contabilidade, mas mostra o tipo de automação fiscal possível.

Antes de contar com qualquer destes módulos, confirme se estão incluídos na sua licença ou se são adicionais, e a que perfil de utilizador se destinam. Valores e condições estão em preços do Primavera.

Os tipos de integração que uma PME portuguesa costuma precisar

Nem todas as ligações têm o mesmo peso. O quadro seguinte ajuda a ordená-las por impacto e por risco. Não substitui a confirmação técnica do que existe para a sua versão.

E-commerce, lojas e marketplaces

É o fluxo onde mais se erra. Uma encomenda criada na loja tem de virar um documento no ERP com o cliente certo, o IVA certo e a morada de entrega certa. Decida desde o início:

1. Quem manda no stock. Se o ERP é a fonte, a loja só lê; se a loja também baixa stock, defina o que acontece em caso de falha.
2. Quem emite a fatura. O documento fiscal deve nascer no ERP, com ATCUD e código QR. Uma loja que gera a sua própria fatura cria uma segunda numeração a reconciliar.
3. O que acontece com devoluções e notas de crédito. É aqui que muitos conectores simples param.
4. Como se tratam os clientes sem NIF e os envios para fora do território nacional, incluindo as regiões autónomas.

O setor tem exigências próprias; veja ERP para comércio eletrónico.

Bancos e pagamentos

A integração bancária vale pelo tempo que poupa na conciliação. O ponto de partida é saber que formatos o seu banco disponibiliza para extratos e para ordens de pagamento, e se o ERP os importa sem tratamento. Depois, defina quem aprova pagamentos: uma ligação que envia ordens ao banco sem validação interna é um risco de controlo, não uma comodidade. A contabilidade e finanças do Primavera é o enquadramento natural para este fluxo.

Ferramentas de escritório e BI

Muitas empresas começam por ligar o ERP ao tabelador e ao painel de gestão. Duas regras evitam discussões em reunião. Primeiro, um indicador tem uma definição única (por exemplo, o que conta como venda do mês), escrita e partilhada. Segundo, os painéis leem do ERP ou de uma cópia controlada, nunca de ficheiros que cada pessoa edita.

EDI e troca de documentos

Na distribuição e na indústria, grandes clientes impõem o formato das encomendas e dos avisos de expedição. O trabalho está menos no ERP e mais no mapeamento: o que o parceiro envia, o que o Primavera espera e o que fazer quando uma linha falha a validação. Em ERP para distribuição e grossistas e em ERP para logística estes casos são frequentes.

API do Primavera: como a olhar sem ser técnico

Para um decisor, a API Primavera reduz-se a três perguntas, que devem constar do caderno de encargos:

• Que operações expõe? Ler artigos e saldos é diferente de criar documentos de venda.
• Está documentada e é suportada pelo editor? Uma interface oficial sobrevive melhor a atualizações do que um acesso direto às tabelas.
• Que limites tem? Volume de pedidos, autenticação, ambientes de teste.

Se a resposta a alguma destas perguntas for vaga, o orçamento da integração também o será. Não aceite uma proposta que diga apenas «integração com a loja» sem enumerar os fluxos, os sentidos e os casos de erro.

Quando a necessidade vai além do que a interface oferece, entra-se no desenvolvimento à medida, tratado em personalização do Primavera. O princípio é manter o núcleo do ERP intocado e colocar a lógica específica em camadas que sobrevivam às atualizações.

Como enquadrar um fluxo de integração

Cada ligação deve ter uma ficha de uma página antes de ser desenvolvida. Um modelo simples:

1. Objetivo de negócio: que tarefa manual desaparece e quem a fazia.
2. Dados e sentido: que campos circulam, de onde para onde, com que frequência.
3. Fonte de verdade: qual sistema prevalece em caso de conflito.
4. Documentos fiscais: onde nascem, como são numerados, como chegam ao SAF-T (PT).
5. Erros: o que acontece quando um registo falha, quem é avisado e como se repete.
6. Testes: casos normais, casos limite e regressão após atualização.
7. Responsável: quem corrige, quem valida, quem aprova mudanças.

Esta ficha faz parte do mesmo trabalho que o caderno de requisitos de um ERP e deve ser fechada antes da fase de configuração descrita em implementação do Primavera.

A regra do documento fiscal

Em Portugal, a regra mais segura é simples: o documento fiscal nasce no software de faturação certificado e a integração limita-se a transportar dados. Qualquer fluxo que reconstrua, renumere ou altere documentos fora do ERP deve ser revisto com o contabilista certificado. O enquadramento legal está em requisitos legais de um ERP e em software de faturação certificado.

Quem mantém a integração

É a pergunta que mais se esquece e a que mais custa depois. Uma integração não é um objeto que se entrega e se esquece: depende de dois ou três sistemas que evoluem sozinhos. A loja muda de versão, o banco altera um formato, o Primavera é atualizado.

Defina por escrito:

• Quem monitoriza os fluxos e como é alertado (uma fila de erros que ninguém lê é um fluxo parado).
• Quem corrige e em que prazo, no quadro do contrato de suporte e manutenção do Primavera.
• Quem decide a atualização do ERP e quem testa as integrações antes dela.
• Quem detém o código das extensões à medida e a documentação respetiva, para não depender de uma única pessoa.

Se o ERP está alojado fora das suas instalações, acrescente o impacto no desenho das ligações; veja Primavera em cloud e, em termos gerais, ERP em cloud ou local.

Erros frequentes em projetos de integração

• Começar pelas ligações mais vistosas em vez das que poupam mais tempo.
• Duplicar a emissão de faturas entre a loja e o ERP.
• Não prever o que acontece quando a ligação cai durante um fecho.
• Testar apenas com dados de exemplo limpos, sem clientes reais nem exceções.
• Confiar o conhecimento de uma integração a uma só pessoa.
• Ligar tudo antes de estabilizar os dados mestres (artigos, clientes, fornecedores).

Os dados mestres limpos são pré-requisito: se a migração trouxe duplicados, a integração só os replica mais depressa. Veja migração para o Primavera.

Como escolher quem faz a integração

A competência de integração varia muito de um parceiro para outro. Peça exemplos de fluxos semelhantes em empresas do seu setor (sem exigir nomes de clientes), a forma como testam e documentam, e o modelo de suporte posterior. Desconfie de quem promete integrar qualquer coisa sem perguntar pelos casos de erro. O guia como escolher um integrador de ERP e a página sobre escolher parceiro para o Primavera dão os critérios de seleção.

Se o seu projeto depende de ligações que o Primavera não cobre bem, compare também o que outros ERP oferecem em alternativas ao Primavera. A decisão deve assentar nos fluxos de que precisa, não na preferência por um editor.

Próximos passos

Antes de pedir propostas, reúna três coisas: a lista de sistemas que têm de falar com o ERP, o fluxo atual de cada um (mesmo que seja manual) e as regras fiscais que não podem ser quebradas. Com isto, os integradores respondem sobre o mesmo perímetro e as propostas tornam-se comparáveis. O processo de ligação do nosso serviço gratuito encaminha o seu pedido para um integrador adequado ao seu caso, sem compromisso.

Os nomes de software mencionados são marcas dos respetivos editores, citadas a título meramente informativo. Este site é independente e não é afiliado a nenhum editor.