Ligue o Fatture in Cloud ao Mokapen para manter alinhadas empresas, produtos, serviços, orçamentos e encomendas (com as respetivas linhas) entre contabilidade e gestão comercial. Não é uma integração de «rubrica» como o MailChimp: aqui importam os dados fiscais obrigatórios, o mapeamento de taxas de IVA e a ordem correta das operações (primeiro fichas e catálogo, depois documentos).
Visão geral: Integrações.
Se não aceitar, nenhuma empresa Fatture in Cloud poderá ser ligada e a sincronização permanece desativada.
Após o login defina o sentido de sincronização (ver abaixo), depois ligue uma ou mais empresas Fatture in Cloud: cada sociedade tem as suas próprias definições e filtros. Se tinha ligado a integração antes da introdução dos orçamentos, aparece um banner para atualizar as permissões: clique e repita a autorização no Fatture in Cloud; caso contrário, o botão «Sincronizar orçamentos» não funcionará.
Acesso à sua conta para ler e escrever clientes, fornecedores, produtos, serviços, orçamentos e encomendas da empresa Fatture in Cloud selecionada, segundo o sentido de sincronização que definir. O Mokapen não substitui o painel Fatture in Cloud para faturação eletrónica ou obrigações fiscais: serve para alinhar fichas e documentos comerciais entre os dois sistemas.
Se revogar o Mokapen no painel Fatture in Cloud ou a sessão expirar, desligue e volte a ligar a partir do Mokapen.
Três modos, válidos para todas as empresas Fatture in Cloud ligadas sob a mesma conta:
Alterar o sentido após uma sincronização já efetuada não apaga os dados existentes, mas convém relançar as sincronizações para recuperar o que ficou pendente.
Visível apenas para quem ligou a conta. Pode permitir que outros membros usem o mesmo login Fatture in Cloud (organização inteira ou utilizadores selecionados). Não é necessário repetir o acesso para cada colega, mas cada utilizador deve configurar ou iniciar as sincronizações nas empresas FC que lhe competem, segundo as permissões Mokapen.
Com um único login Fatture in Cloud pode gerir várias sociedades. No Mokapen cada empresa ligada tem um bloco de definições separado (como as audiências do MailChimp, mas com entidades fiscais e comerciais).
Sob cada empresa ligada encontra cartões distintos para taxas, empresas, produtos, serviços, orçamentos e encomendas. Cada cartão tem o seu interruptor, filtros, pré-visualização e botão de sincronização.
Primeiro cartão do bloco empresa. Obrigatório se quiser orçamentos, encomendas ou linhas com IVA correto.
O que faz — associa cada taxa de IVA Mokapen (coluna esquerda) à taxa correspondente Fatture in Cloud (menu à direita). Os menus carregam as taxas da empresa FC escolhida.
Porque importa — produtos, serviços, orçamentos e encomendas usam este mapa para calcular o IVA nas linhas. Se omitir ou errar uma correspondência, totais e linhas de documento podem sair errados ou a sincronização falha. Verifique que percentagens e naturezas coincidem (22 %, 10 %, isento, etc.).
Âmbito — cada empresa Fatture in Cloud ligada tem o seu próprio mapa de taxas; não é partilhado entre sociedades diferentes.
Cartão dedicado com interruptor Sincronizar empresas. Alinha as fichas de empresa Mokapen com clientes, fornecedores ou sujeitos cliente+fornecedor no Fatture in Cloud.
Cliente — as empresas Mokapen que passam os filtros tornam-se clientes no Fatture in Cloud (exportação) ou os clientes FC entram no Mokapen (importação). Se não definir filtros neste separador, as empresas Mokapen serão tratadas como clientes FC (mensagem na página): útil para levar todo o CRM para contabilidade, arriscado se nas fichas mistura clientes e fornecedores.
Fornecedor — mesma lógica para os fornecedores FC. Use tipo, tipo 2 e etiquetas para limitar quem entra ou sai (p. ex. apenas tipo «Fornecedor»).
Cliente / Fornecedor — sujeitos com duplo papel no Fatture in Cloud (o mesmo nome é cliente e fornecedor). Configure filtros separados para intercompany ou parceiros que compram e vendem.
Na página aparece o aviso azul sobre NIF/IVA e código fiscal: para o envio para o Fatture in Cloud a empresa Mokapen deve ter pelo menos um dos dois preenchido (vat ou vat_private). Sem NIF/IVA nem código fiscal a ficha não é exportada.
Na pré-visualização e na importação a partir do Fatture in Cloud o Mokapen usa critérios mais amplos: uma empresa pode aparecer ou ser emparelhada mesmo que tenha email legal, email (email1) ou telefone (phone1) — além de NIF/IVA e código fiscal. Na importação, se um cliente FC tem NIF/IVA, código fiscal, email ou telefone, o Mokapen procura nas fichas um registo com o mesmo valor num desses campos para fundir em vez de duplicar.
Na prática: na pré-visualização verá mais fichas do que as que sairão para o FC se faltar NIF/IVA ou código fiscal; para a exportação certifique-se de que os clientes a enviar têm pelo menos o NIF/IVA ou o código fiscal preenchidos.
Cada separador tem filtros próprios: os clientes FC não herdam os filtros dos fornecedores. Configure separadamente se no Mokapen usa o mesmo nome em papéis diferentes.
Os filtros definem quais empresas Mokapen podem entrar ou sair para esse papel no Fatture in Cloud — não apenas no primeiro «Sincronizar empresas», mas também cada vez que cria ou modifica uma empresa no CRM (se a sincronização automática estiver ativa e o sentido de sincronização o permitir).
Na prática: grava uma empresa no Mokapen → o Mokapen verifica se cumpre o tipo, tipo 2 e as etiquetas definidos nesse separador (Cliente, Fornecedor ou Cliente/Fornecedor) → só se passar todos os filtros cria ou atualiza no Fatture in Cloud no papel correspondente. Uma empresa fora da regra permanece no Mokapen mas não é enviada (e pode não aparecer na pré-visualização de exportação desse separador). Com sentido para o Mokapen ou nos dois sentidos, os mesmos filtros limitam também quais clientes/fornecedores FC entram no CRM para esse papel.
Sem filtros definidos — no separador Cliente, se deixar vazios tipo, tipo 2 e etiquetas, o Mokapen trata as empresas elegíveis como clientes FC (mensagem na página). Nos separadores Fornecedor e Cliente/Fornecedor, sem filtros não há esse valor predefinido automático: convém restringir sempre (p. ex. tipo «Fornecedor») para não exportar/importar toda a ficha mestre por erro.
Tipo — restringe a uma categoria de ficha Mokapen (p. ex. apenas «Cliente B2B» ou «Parceiro comercial»). Se o definir, a empresa deve ter esse valor no campo Tipo para ser sincronizada nesse separador. Deixe vazio se não precisar desse filtro.
Tipo 2 — segundo nível de classificação (p. ex. «Itália», «Estrangeiro», «Setor serviços»). Combina-se com Tipo e Etiqueta: todos os critérios que preencher devem ser satisfeitos (lógica AND). Exemplo: Tipo «Cliente» + Tipo 2 «Itália» → apenas clientes italianos.
Etiqueta — uma ou mais etiquetas de empresa: sincroniza apenas as fichas que as têm todas, em combinação com tipo e tipo 2. Exemplo: etiqueta «Faturação eletrónica» no separador Cliente → apenas essas empresas acabam como clientes FC. Útil para segmentar a exportação para contabilidade sem enviar prospectos ou fornecedores misturados.
Ao modificar os filtros aparece um aviso na página: após a alteração convém relançar Sincronizar empresas nessa empresa FC. As fichas já alinhadas que deixem de corresponder podem deixar de ser atualizadas até realinhar ou alargar os filtros.
O contador e a ligação de pré-visualização no bloco mostram quantas empresas correspondem aos filtros agora (com os critérios de pré-visualização: NIF/IVA, código fiscal, email ou telefone). Verifique que não vai sincronizar milhares de fichas por erro ou que os filtros não são demasiado restritos (zero na pré-visualização).
Razão social, morada, email, telefone, NIF/IVA, código fiscal, código destinatário, dados bancários e de pagamento, tipo legal, taxa predefinida (se mapeada), desconto predefinido — segundo sentido de sincronização e regra de conflito. As etiquetas configuradas nos filtros podem ser adicionadas à ficha na importação.
O quadro cinzento mostra quantas empresas correspondem aos filtros agora (com os critérios de pré-visualização acima). A ligação abre a lista com ID, nome, tipo. Com a integração ativa, Sincronizar empresas lança apenas esta entidade para essa empresa FC.
Cartão dedicado com interruptor Sincronizar produtos. Alinha o catálogo de produtos Mokapen com os produtos Fatture in Cloud (artigos materiais).
Cada produto deve ter o código de produto (product_code) preenchido: é a chave de correspondência entre os dois sistemas. Sem código o produto não aparece na pré-visualização nem é sincronizado.
Visíveis com o interruptor de produtos ativo. Definem quais produtos Mokapen podem entrar ou sair para o catálogo Fatture in Cloud dessa empresa — não apenas no primeiro «Sincronizar produtos», mas também cada vez que cria ou modifica um produto (com sincronização automática e sentido que o permitam).
Na prática: grava um produto com código preenchido → o Mokapen verifica o tipo, tipo 2 e as etiquetas definidos neste cartão → só se passar todos os filtros cria ou atualiza no Fatture in Cloud. Um produto fora da regra permanece no Mokapen mas não é enviado. Com importação a partir do FC, os mesmos filtros restringem quais artigos FC entram no catálogo Mokapen.
Tipo — restringe a uma categoria de produto Mokapen (p. ex. apenas «Material» ou «Peça de reposição»). Se o definir, o produto deve ter esse valor no campo Tipo para ser sincronizado com o Fatture in Cloud. Deixe vazio se não quiser filtrar por categoria — útil se quiser enviar para contabilidade todo o catálogo codificado.
Tipo 2 — segundo nível de classificação (p. ex. «Vendável», «Amostra», «Obsoleto»). Combina-se com Tipo e Etiqueta: todos os critérios que preencher devem ser satisfeitos (lógica AND). Exemplo: Tipo «Material» + Tipo 2 «Vendável» → apenas materiais vendáveis, não amostras ou artigos internos.
Etiqueta — uma ou mais etiquetas de produto: sincroniza apenas as fichas que as têm todas, em combinação com tipo e tipo 2. Exemplo: etiqueta «Catálogo FC 2026» → apenas esses SKU acabam em contabilidade, útil para um go-live gradual do catálogo sem enviar tudo de uma vez.
Sem filtros definidos (tipo, tipo 2 e etiquetas vazios), passam todos os produtos que têm o código de produto obrigatório preenchido.
Ao modificar os filtros aparece um aviso na página: após a alteração convém relançar Sincronizar produtos. Os produtos já alinhados que deixem de corresponder podem deixar de ser atualizados no Fatture in Cloud.
O contador e a ligação de pré-visualização no bloco (coluna código, nome, tipo) mostram quantos produtos correspondem aos filtros agora. Verifique que não vai sincronizar milhares de artigos por erro ou que os filtros não são demasiado restritos (zero na pré-visualização).
Código, título, descrições, categoria, unidade de medida, preço, custo, quantidade/stock, taxa de IVA (via mapa de taxas), tipo e etiquetas. Na importação a partir do FC o Mokapen cria ou atualiza a ficha de produto; na exportação envia código, nome, preço líquido e taxa para o catálogo FC.
Pré-visualização com coluna Código, nome, tipo. Sincronizar produtos executa apenas esta entidade. Convém fazê-lo antes da sincronização de encomendas (as linhas de encomenda referenciam produtos ou serviços).
Cartão dedicado com interruptor Sincronizar serviços. Mesma lógica dos produtos mas para serviços (prestações, consultoria, subscrições, etc.).
Código de serviço (service_code) obrigatório — mesmo papel que o código de produto.
Visíveis com o interruptor de serviços ativo. Definem quais serviços Mokapen podem entrar ou sair para o Fatture in Cloud dessa empresa — não apenas no primeiro «Sincronizar serviços», mas também cada vez que cria ou modifica um serviço (com sincronização automática e sentido que o permitam).
Na prática: grava um serviço com código preenchido → o Mokapen verifica o tipo, tipo 2 e as etiquetas definidos neste cartão → só se passar todos os filtros cria ou atualiza no Fatture in Cloud. Um serviço fora da regra permanece no Mokapen mas não é enviado. Com importação a partir do FC, os mesmos filtros restringem quais prestações FC entram no catálogo Mokapen.
Tipo — restringe a uma categoria de serviço Mokapen (p. ex. apenas «Consultoria» ou «Quota SaaS»). Se o definir, o serviço deve ter esse valor no campo Tipo para ser sincronizado com o Fatture in Cloud. Deixe vazio se não quiser filtrar por categoria — assim passam todos os serviços com código obrigatório (salvo outros filtros).
Tipo 2 — segundo nível de classificação (p. ex. «Recorrente», «Por projeto», «Pontual»). Combina-se com Tipo e Etiqueta: todos os critérios que preencher devem ser satisfeitos (lógica AND). Exemplo: Tipo «Consultoria» + Tipo 2 «Por projeto» → apenas consultoria por projeto, não subscrições recorrentes.
Etiqueta — uma ou mais etiquetas de serviço: sincroniza apenas as fichas que as têm todas, em combinação com tipo e tipo 2. Exemplo: etiqueta «Faturável» → envia para contabilidade apenas as rubricas que emite de facto, excluindo serviços internos ou ainda não faturáveis com etiquetas diferentes.
Sem filtros definidos (tipo, tipo 2 e etiquetas vazios), passam todos os serviços que têm o código de serviço obrigatório preenchido.
Ao modificar os filtros aparece um aviso na página: após a alteração convém relançar Sincronizar serviços. Os serviços já alinhados que deixem de corresponder podem deixar de ser atualizados no Fatture in Cloud.
O contador e a ligação de pré-visualização no bloco (coluna código, nome, tipo) mostram quantos serviços correspondem aos filtros agora. Verifique antes de uma sincronização massiva do catálogo de prestações.
Código, título, descrições, preços, taxa de IVA, tipo e etiquetas. No Fatture in Cloud acabam como artigos de tipo serviço.
Pré-visualização com código de serviço e filtros aplicados. Sincronizar serviços para lançar apenas os serviços. As encomendas também podem usar linhas de serviço: ative produtos e/ou serviços antes das encomendas.
Cartão dedicado com interruptor Sincronizar orçamentos. Requer permissões atualizadas no Fatture in Cloud se a integração foi ligada antes da introdução dos orçamentos (banner «Atualize as suas permissões»).
Cada software numera os orçamentos à sua maneira. O número de orçamento Mokapen é guardado nas notas do orçamento correspondente no Fatture in Cloud, e vice-versa na importação. Antes da primeira sincronização verifique que não há duplicados ou números já usados no outro sistema (aviso azul na página).
Define a partir de que data os orçamentos são elegíveis (máximo cerca de 6 meses para trás em relação a hoje). Documentos mais antigos ficam de fora mesmo que passem os filtros.
Além da data de início (acima), tipo, tipo 2 e etiquetas restringem quais orçamentos o Mokapen sincroniza com o Fatture in Cloud para essa empresa FC — não todo o módulo de orçamentos, apenas os documentos que passam os critérios.
Na prática: um orçamento deve estar dentro da janela de datas e cumprir os filtros → caso contrário não sai (exportação) ou não entra (importação). Com sincronização automática, um orçamento novo é avaliado ao guardar; fora de filtro permanece no Mokapen sem cópia no FC.
Tipo — restringe a uma categoria de orçamento Mokapen (p. ex. apenas «Comercial» ou «Exportação»). Se o definir, o orçamento deve ter esse valor no campo Tipo para ser sincronizado com o Fatture in Cloud. Deixe vazio se não quiser filtrar por categoria — lembre-se de que a data de início continua ativa.
Tipo 2 — segundo nível de classificação (p. ex. «Aprovado», «Enviado ao cliente», «Em negociação»). Combina-se com Tipo, Etiqueta e data de início: todos os critérios que preencher devem ser satisfeitos (lógica AND). Exemplo: Tipo «Comercial» + Tipo 2 «Aprovado» → apenas orçamentos comerciais já aprovados.
Etiqueta — uma ou mais etiquetas de orçamento: sincroniza apenas os documentos que as têm todas, em combinação com tipo, tipo 2 e data. Exemplo: etiqueta «FC» ou «A faturar» → apenas os orçamentos marcados para contabilidade; simulações ou rascunhos internos ficam de fora mesmo com data recente.
Sem filtros tipo/etiqueta (apenas data de início definida), passam todos os orçamentos na janela de datas que respeitam também cliente e linhas já alinhados noutros sítios.
Ao modificar filtros ou data aparece um aviso na página: após a alteração convém relançar Sincronizar orçamentos. Os documentos já alinhados que deixem de corresponder podem deixar de ser atualizados no Fatture in Cloud.
O contador e a ligação de pré-visualização no bloco (número, título, tipo) mostram quantos orçamentos correspondem aos filtros agora. Exemplo combinado: data de início 1 de janeiro + Tipo «Venda» + etiqueta «A faturar» → na pré-visualização vê exatamente o subconjunto que irá para o FC.
Cabeçalho do documento (cliente ligado, datas, totais), linhas com produtos/serviços sincronizados, taxas e montantes. O cliente do orçamento deve existir já entre as empresas alinhadas; as linhas devem referenciar códigos de produto/serviço presentes em ambos os sistemas.
Contador e lista com número, título, tipo. Sincronizar orçamentos lança apenas os orçamentos dessa empresa FC.
Cartão dedicado com interruptor Sincronizar encomendas.
Para ativar as encomendas deve ter ativos no mesmo bloco de empresa: Sincronizar empresas e Sincronizar produtos e/ou Sincronizar serviços. Uma encomenda sem cliente e sem linhas de artigo no Fatture in Cloud não pode ser enviada. Se o interruptor de encomendas estiver desativado, passe o rato sobre o tooltip: lembra a dependência.
Mesma lógica dos orçamentos: o número de encomenda Mokapen acaba nas notas da encomenda FC e vice-versa. Verifique duplicados antes da primeira sincronização.
Como nos orçamentos: máximo cerca de 6 meses para trás.
Além da data de início (acima), tipo, tipo 2 e etiquetas restringem quais encomendas Mokapen sincronizam com o Fatture in Cloud para essa empresa — não todo o módulo de encomendas, apenas os documentos que passam os critérios. Requerem empresas e produtos/serviços já ativos no mesmo bloco.
Na prática: grava uma encomenda no Mokapen → deve cumprir data de início, tipo, tipo 2 e etiquetas definidos neste cartão → só se passar todos os filtros o Mokapen propaga para o Fatture in Cloud (exportação) ou importa (para o Mokapen / nos dois sentidos). Uma encomenda fora da regra permanece no Mokapen mesmo que cliente e linhas de artigo já existam.
Tipo — restringe a uma categoria de encomenda Mokapen (p. ex. apenas «Cliente final» ou «B2B»). Se o definir, a encomenda deve ter esse valor no campo Tipo para ser sincronizada com o Fatture in Cloud. Deixe vazio se não quiser filtrar por categoria — a data de início e os outros filtros eventualmente definidos continuam ativos.
Tipo 2 — segundo nível de classificação (p. ex. «Enviado», «Em processamento», «Confirmado»). Combina-se com Tipo, Etiqueta e data de início: todos os critérios que preencher devem ser satisfeitos (lógica AND). Exemplo: Tipo «B2B» + Tipo 2 «Confirmado» → apenas encomendas B2B já confirmadas, não rascunhos ou testes.
Etiqueta — uma ou mais etiquetas de encomenda: sincroniza apenas os documentos que as têm todas, em combinação com tipo, tipo 2 e data. Exemplo: etiqueta «Encomenda FC» → envia para contabilidade apenas as encomendas marcadas para o FC; encomendas internas ou de retificação sem essa etiqueta permanecem apenas no Mokapen.
Sem filtros tipo/etiqueta (apenas data de início), passam todas as encomendas na janela de datas que têm cliente e linhas já alinhados.
Ao modificar filtros ou data aparece um aviso na página: após a alteração convém relançar Sincronizar encomendas. As encomendas já alinhadas que deixem de corresponder podem deixar de ser atualizadas no Fatture in Cloud.
O contador e a ligação de pré-visualização no bloco (número de encomenda, título, tipo) mostram quantas encomendas correspondem aos filtros agora. Verifique antes de uma sincronização massiva.
Cabeçalho (cliente, datas, totais) e linhas de encomenda com produtos/serviços já sincronizados, preços e IVA. Planeie: primeiro empresas + catálogo, depois encomendas.
Contador, lista e Sincronizar encomendas dedicado.
No final do bloco de cada empresa ligada está Remover: interrompe a sincronização apenas para essa sociedade, sem desligar toda a conta nem as outras empresas. Os registos já importados ou exportados permanecem salvo limpeza manual ou desligação com caixas «Conservar» desmarcadas.
O bloco Opções (gerais) aparece quando a integração está ativa. Aplica-se a toda a ligação Fatture in Cloud, não a uma única empresa.
Opção sempre ativa (não desativável): o Mokapen compara empresas com o mesmo NIF/IVA ou código fiscal entre Mokapen e Fatture in Cloud para não criar duplicados. NIF/IVA escrito de forma inconsistente (espaços, prefixo IT) faz falhar o emparelhamento — normalize os campos antes de sincronizar.
Quando o mesmo sujeito existe em ambos os sistemas mas morada, razão social ou outros campos não coincidem, escolha quem prevalece:
Se o FC é o master fiscal convém muitas vezes Fatture in Cloud nas fichas; se o CRM é o master comercial, Mokapen. Teste numa amostra antes da sincronização automática.
Escolha única a nível de conta (não por empresa FC individual):
Sincronização automática — o Mokapen propaga criações e alterações em segundo plano (gravação de empresa, produto, encomenda…) quando passam filtros e sentido configurado. Não precisa de premir cada vez «Sincronizar …».
Sincronização manual — sem propagação automática: alinha apenas com Guardar ou os botões «Sincronizar empresas / produtos / serviços / orçamentos / encomendas». Recomendada na configuração inicial, mapeamento de taxas e teste de filtros.
Com sentido para o Mokapen ou bidirecional: quem na organização pode ver as fichas criadas ou atualizadas pela importação (empresas, produtos, documentos ligados).
Todos os membros — quem tem permissão no módulo vê os registos importados.
Apenas membros selecionados — limita o acesso a utilizadores ou equipas escolhidos. Se a organização impõe regras de privacidade globais (Team Master), algumas opções podem vir predefinidas.
Marque «Autorizo o Mokapen a criar uma cópia…» antes de Guardar e das sincronizações. Sem a caixa a gravação não inicia.
O botão Desligar no final da página (não «Remover» no bloco individual) fecha a ligação completa para a organização. Janela com secção Conservar (caixas ativas por predefinição):
Com todas as caixas marcadas, desligar apenas interrompe a ligação: os dados permanecem no Mokapen mas deixam de ser atualizados. Não apaga nada automaticamente no Fatture in Cloud — revogue o Mokapen também no painel FC se não voltar a usar a integração.
Para desvincular apenas uma sociedade use Remover no bloco dessa empresa, sem desligar toda a conta.
Escreva a palavra de confirmação e confirme Desligar. Operações com muitos registos podem demorar minutos.
Saiba mais: Orçamentos, Encomendas.
Preciso de ajuda?