Saltar para o conteúdo
Tejobit
Logótipo Holded

Faturação

Integração Holded

Faturas, contactos e pagamentos criados no Holded a partir das vendas que a empresa faz em Espanha, sem passar dados à mão.

Pedir esta integração Ver todas as integrações

Visão geral

Holded

O Holded é um software de gestão espanhol que junta faturação, contabilidade, inventário e CRM. É uma escolha comum para empresas portuguesas com sucursal ou atividade em Espanha, que precisam de faturar segundo as regras espanholas mas vendem através de plataformas que não falam com o Holded.

A Tejobit liga essas plataformas à API do Holded. Quando entra uma reserva, uma encomenda ou um pagamento, a ligação procura o contacto pelo NIF espanhol (NIF ou CIF) ou pelo email, cria-o se não existir e emite o documento certo: fatura, recibo de venda ou orçamento, com a numeração e os impostos configurados na conta.

O Holded continua a ser o sistema que emite e guarda os documentos. As obrigações fiscais espanholas, como o registo VeriFactu que Hacienda adiou para 2027, ficam do lado do Holded e da configuração da conta; a integração limita-se a alimentar o software com dados corretos.

Casos de uso

Para que serve

  • Operador de passeios em Madrid ou Sevilha que vende pelo FareHarbor e quer cada reserva paga transformada em fatura no Holded.
  • Loja Shopify portuguesa com sociedade espanhola, onde as encomendas com morada em Espanha são faturadas no Holded e as restantes noutro software.
  • Pagamentos Stripe registados como cobrança no documento correspondente, para a tesouraria do Holded bater certo com o banco.
  • Clientes B2B criados no CRM ou num formulário que passam a contacto no Holded com morada fiscal e CIF.
  • Catálogo de produtos ou serviços mantido num só sítio e espelhado no Holded para evitar códigos duplicados.
IN

O que a ligação escuta

  • Reserva confirmada ou encomenda paga na plataforma de vendas (webhook da origem).
  • Pagamento concluído no Stripe, PayPal ou outro gateway.
  • Consulta periódica ao Holded para saber que documentos foram pagos ou alterados, porque a API ainda não oferece webhooks próprios.
  • Reembolso ou cancelamento na origem, que pede a respetiva retificação.
OUT

O que a ligação faz

  • Cria ou atualiza o contacto no Holded com nome fiscal, CIF/NIF, morada e email.
  • Emite a fatura ou o recibo de venda com linhas, taxa de IVA espanhol e série definidas.
  • Regista o pagamento no documento e associa-o à conta de tesouraria escolhida.
  • Envia o PDF ao cliente pelo próprio Holded, se a conta estiver configurada para isso.
  • Guarda a referência cruzada entre a venda de origem e o documento, para não faturar duas vezes.

Como funciona

Do pedido à ligação em funcionamento

  1. 01

    Pedido

    O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.

  2. 02

    Análise e proposta

    A Tejobit confirma o que a API permite e envia uma proposta com o fluxo, o preço e o prazo.

  3. 03

    Configuração e testes

    A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.

  4. 04

    Manutenção e monitorização

    A Tejobit aloja a ligação, acompanha os erros e adapta-a quando a API muda.

A ligação corre na infraestrutura da Tejobit. A mensalidade cobre o alojamento, a monitorização e as alterações da API.

O que é preciso preparar

  • Uma chave de API criada em Holded, em Configuração, Desenvolvedores, com as permissões necessárias.
  • Séries de numeração e impostos já configurados para a atividade em Espanha.
  • Regras de negócio decididas: que vendas vão para o Holded, que tipo de documento e que conta de pagamento.
  • Acesso de administrador à plataforma de origem para registar os webhooks.

Por segurança, não envie passwords, chaves API ou tokens pelo formulário. As credenciais são pedidas por um canal seguro quando a configuração começa.

Limites

  • O Holded não envia webhooks oficiais neste momento, por isso alguns estados são obtidos por consulta periódica e não ao segundo.
  • A API está a migrar da v1 para a v2; a ligação é ajustada quando o Holded desativar endpoints antigos.
  • Retificações e devoluções complexas podem precisar de validação manual antes de serem emitidas.

Perguntas frequentes

Antes de começar

A integração emite faturas válidas para Hacienda?

Quem emite é o Holded, com a configuração fiscal da conta. A integração preenche os dados e pede a emissão, mas não substitui o software nem o aconselhamento do gestor espanhol.

Posso usar o Holded só para as vendas em Espanha e outro software para Portugal?

Sim. A ligação decide o destino pela morada, pelo país do cliente ou pelo produto, e envia para o Holded apenas o que pertence à entidade espanhola.

E se o cliente já existir no Holded com outro email?

A procura é feita primeiro pelo CIF ou NIF e só depois pelo email, para não criar contactos duplicados.

O que acontece quando a venda é reembolsada?

A ligação regista o reembolso e, consoante as regras acordadas, cria o documento retificativo ou deixa um alerta para a equipa tratar.

Integrações relacionadas

Ver todas as integrações

Ativar a integração Holded?

Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.

Fale sobre o projeto geral@tejobit.com