Ligações de faturação

Ligue o fornecedor que emite as suas faturas e configure-o.

Antes de começar

• Onde: Definições → Integrações → Integrações de plataforma (https://platform.vivin.app/settings/integrations).
• Plano: todas as contas podem ligar um fornecedor. A faturação começa quando liga um; não há um interruptor separado.
• Permissões: Account Settings → Module, Account Settings → Integrations e Utilities → Edit Connections. Configurar na Faturação VIVIN precisa também de Account Settings → Invoicing & Payments. O Super administrador e o Administrador têm todas por defeito.

Adicione e remova ligações como descrito em Integrações. Depois defina os códigos de imposto em Faturação.

Que fornecedores podem funcionar em conjunto

Fornecedor	Funciona com outros?	Mais do que um?
Invoice Express, Hostkit, Sage 50c	Não. Enquanto um estiver ligado, não pode adicionar outro.	Não
Faturação VIVIN, NetSuite, A-Cube (faturação eletrónica italiana)	Sim, entre si.	Sim

Com a Faturação VIVIN, o NetSuite e o A-Cube:

• A primeira ligação é a geral (catch-all). Não tem filtros e emite tudo.
• Cada uma que acrescentar depois dela é uma ligação filtrada. Escolha pelo menos um de Tipos de pagamento ou Proprietários: os encargos que correspondem passam por ela, e todos os outros recorrem à ligação geral. Com ambos definidos, um encargo tem de corresponder a ambos.
• Enquanto existir uma ligação filtrada, a ligação geral mostra um distintivo Fallback e não pode ser removida.
• Um cartão filtrado resume o seu filtro, por exemplo "Tipos: …" e "Proprietários: …". Evite que os filtros se sobreponham: quando duas correspondem ao mesmo encargo, ganha a que filtra por tipo e proprietário em simultâneo. Se forem igualmente específicas, a fatura não é emitida.

Faturação VIVIN

Emite faturas, proformas e notas de crédito dentro da VIVIN, sem conta externa. Depois de a adicionar, clique em Configurar no seu cartão ("Numeração de faturas, impostos e modelos Word").

Secção	Campos
Ligação VIVIN	Que ligação edita. Só aparece com mais do que uma.
Dados do emitente	Nome da empresa, NIF, Morada, Cidade, Código postal, País, IBAN
Numeração de documentos	Série de faturas, Série de proformas, Série de notas de crédito, Formato do número, Número inicial, Reiniciar a numeração todos os anos
Taxas de imposto	Nome do imposto e Taxa (%) para cada taxa; Adicionar taxa
Modelos Word	Um .docx para cada um de Fatura de inquilino, Proforma de inquilino e Nota de crédito de inquilino

• Os dados do emitente, a numeração e os modelos definem-se por ligação; as taxas de imposto aplicam-se a toda a conta. Os dados do emitente ficam gravados em cada documento no momento em que é emitido.
• O Formato do número aceita {series}, {year} e {number}: {series}.{year}/{number} dá F.2026/453. O Número inicial continua uma sequência de outro sistema.
• Com os Relatórios de proprietário ativados, tem também a Série de honorários e os modelos Honorários de proprietário e Liquidação de proprietário.
• As linhas da fatura encontram a taxa pelo nome, por isso o Nome do imposto tem de corresponder ao que escolhe em Códigos de imposto.
• Cada linha de modelo tem Carregar, Pré-visualizar, Exportar e Eliminar modelo. Pré-visualizar preenche um documento de inquilino com duas linhas de exemplo (renda e utilidades, com uma só taxa de IVA) para poder confirmar como se imprime a linha repetida; o modelo Honorários de proprietário pré-visualiza uma linha de honorários. Ver variáveis disponíveis lista os tokens: {IssuerName} imprime o nome da empresa, {DocumentNumber} o número. Ponha {#Items} no início de uma linha de tabela e {/Items} no fim para a repetir por cada linha da fatura. Os tokens desconhecidos ficam em branco.

Hostkit

Cada anúncio usa a chave de API da sua própria propriedade no Hostkit, por isso a ligação não pede nenhuma chave.

1. Adicione o Hostkit. A caixa de diálogo tem uma ligação para o guia do Hostkit sobre como criar chaves (no Hostkit, Propriedades → chave API).
2. No cartão do Hostkit, clique em Chaves por anúncio.
3. Em Chaves API Hostkit por anúncio, pesquise por anúncio ou propriedade, cole a chave em Nova chave e clique em Guardar nessa linha. Chave guardada mostra "Configurada (···1234)" ou Não definido.
4. Em Faturação, defina a Série de faturas Hostkit.

Um anúncio cuja chave está Não definido não pode ser faturado através do Hostkit.

NetSuite

1. Adicione o NetSuite com o ID da conta, o ID de cliente OAuth, o ID do certificado e a Chave privada (PEM). Os quatro são obrigatórios.
2. No cartão (distintivo Ativo), clique em Configurar.
3. Preencha os Valores por omissão da fatura e o Mapa de tipos de identificação SII, e clique em Guardar configuração.
4. Em Mapeamentos de classe de propriedade, escolha uma propriedade em Selecionar propriedade, introduza o seu Código de classe e clique em Adicionar. Cada linha guarda-se por si.

Secção	Campos
Valores por omissão da fatura	Código da subsidiária, Código da conta do razão, Código de condições, Moeda (ID interno), Código da localização base, ID do método de pagamento por omissão, Conta bancária (onde se registam os recebimentos)
Mapa de tipos de identificação SII	Uma linha por tipo de identificação de cliente e o respetivo código SII do NetSuite (Adicionar mapeamento)
Mapeamentos de classe de propriedade	Um código de classe do NetSuite por propriedade

• Quando a VIVIN consegue ler os valores do NetSuite, os valores por omissão são listas pendentes ("A carregar do NetSuite…" enquanto carregam). Caso contrário, escreva cada código exatamente como no NetSuite.
• Os valores por omissão da fatura e o mapa SII são por ligação. Os mapeamentos de classe de propriedade são partilhados por todas as ligações NetSuite.

A-Cube (faturação eletrónica italiana)

1. Adicione o A-Cube (faturação eletrónica italiana) com o seu Email de acesso ao A-Cube, a Palavra-passe do A-Cube e o Ambiente: Sandbox (testes) ou Produção.
2. No cartão, clique em Definições de faturação italiana e preencha as secções abaixo.
3. Clique em Guardar. A janela fecha quando o A-Cube aceita a configuração; volte a abri-la para verificar que mostra Pronta a emitir.

Secção	Campos
Empresa emitente	Nome da empresa, Partita IVA, Codice Fiscale (se diferente), morada, número de porta, CAP, cidade, província, Regime fiscal
Numeração	Nome da sequência e Formato do número (%s = número, %Y = ano)
Destinatários	Exigir Codice Fiscale italiano nas faturas a inquilinos
Modelo da cópia de cortesia	Um .docx para Fatura (TD01) e Nota de crédito (TD04)

• A empresa emitente é impressa em todas as faturas como vendedor.
• A VIVIN só cria a sequência no A-Cube se ela ainda não existir; uma sequência existente mantém o seu contador.
• Com o interruptor do Codice Fiscale ativado, uma fatura a um inquilino é recusada até o inquilino ter um Codice Fiscale italiano. As empresas e as notas de crédito não são afetadas.
• A cópia de cortesia é o que o inquilino recebe. Sem modelo, é enviado o layout padrão do A-Cube.
• Uma ligação A-Cube emite para uma empresa italiana. Para várias empresas, adicione uma ligação para cada uma e use os filtros de Proprietários.

O que acontece quando guarda

• Um fornecedor ligado emite a partir do documento seguinte. Os documentos já emitidos não mudam.
• Os novos dados do emitente, a numeração e os modelos aplicam-se aos documentos emitidos depois.

Resolução de problemas

• "Selecione pelo menos um tipo de pagamento ou um proprietário para esta ligação filtrada.": uma segunda ligação da Faturação VIVIN, do NetSuite ou do A-Cube precisa de um filtro.
• "O ID da conta, o ID de cliente, o ID do certificado e a chave privada são todos obrigatórios para o NetSuite.": preencha os quatro.
• O A-Cube mostra "Definições guardadas, mas o A-Cube recusou a numeração ou os webhooks.": as suas definições ficam guardadas e a janela mostra a resposta do A-Cube. Corrija a numeração e guarde outra vez.
• A ligação geral não pode ser removida: remova primeiro as ligações filtradas.

Dicas

• Para passar do Invoice Express ou do Hostkit para outro fornecedor, remova primeiro a ligação antiga, depois adicione a nova e escolha de novo cada IVA.
• Mantenha fora dos modelos Word os logótipos e as assinaturas que não quer em todos os documentos. A VIVIN avisa-o quando um modelo carregado contém imagens.

Relacionado

• Integrações
• Faturação: códigos de imposto, observações e série do Hostkit
• Finanças: emitir faturas
• Proprietários
• Como funcionam as integrações