Saltar para o conteúdo
Logótipo Számlázz.hu

Faturação

Integração Számlázz.hu

Faturas e recibos criados no Számlázz.hu através do Számla Agent, para empresas com atividade na Hungria.

Visão geral

Számlázz.hu

O Számlázz.hu é o programa de faturação online mais conhecido na Hungria. Na Hungria todas as faturas emitidas por sujeitos passivos são comunicadas em tempo real ao sistema Online Számla da autoridade tributária, o NAV, e o Számlázz.hu faz essa comunicação quando a conta tem o utilizador técnico do NAV configurado.

A integração usa o Számla Agent, a interface do Számlázz.hu que recebe pedidos XML e responde com o número da fatura ou com a descrição do erro. A autenticação é feita com uma chave Számla Agent criada pelo titular ou administrador da conta, que só serve para a API e não dá acesso ao site.

A Tejobit liga a esta interface as plataformas onde a venda acontece, para que a fatura húngara, com o PDF e o envio por email ao cliente, saia sem que alguém em Lisboa tenha de entrar numa conta em húngaro.

Casos de uso

Para que serve

  • Operador de cruzeiros no Danúbio ou de visitas em Budapeste que vende no FareHarbor e precisa de fatura húngara por reserva.
  • Loja WooCommerce com stock na Hungria cujas encomendas locais são faturadas no Számlázz.hu.
  • Pagamentos Stripe de clientes húngaros convertidos em fatura com a menção de pagamento já feito.
  • Recibos eletrónicos (e-nyugta) para vendas a particulares, quando a atividade o permite.
  • Cópia dos PDF emitidos para o arquivo da empresa em Portugal.
IN

O que a ligação escuta

  • Reserva paga ou encomenda concluída na plataforma de origem.
  • Pagamento confirmado no Stripe.
  • Reembolso que pede fatura de anulação (sztornó).
  • Execução agendada para confirmar faturas emitidas e erros pendentes.
OUT

O que a ligação faz

  • Envia ao Számla Agent o XML da fatura com comprador, linhas, taxa de IVA (ÁFA) e forma de pagamento.
  • Marca a fatura como paga quando o pagamento já foi recebido.
  • Pede a fatura de anulação em caso de reembolso total.
  • Guarda o número da fatura e o PDF devolvidos.
  • Faz o Számlázz.hu enviar a fatura por email ao comprador, se configurado.

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

  • Chave Számla Agent criada pelo titular ou administrador da conta.
  • Utilizador técnico do NAV configurado no Számlázz.hu para a comunicação Online Számla.
  • Prefixo de numeração definido e não partilhado com outro sistema.
  • Correspondência entre produtos e taxas de ÁFA húngaras.

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 Számla Agent é uma interface XML orientada à emissão; não envia webhooks nem lista alterações feitas à mão.
  • Um erro de comunicação ao NAV é tratado no Számlázz.hu e pode obrigar a corrigir a fatura dentro da conta.
  • Partilhar o prefixo de faturas com outro programa pode causar problemas na comunicação ao NAV.

Perguntas frequentes

Antes de começar

A integração comunica as faturas ao NAV?

Não diretamente. O Számlázz.hu comunica ao NAV as faturas que emite, desde que o utilizador técnico esteja configurado. A ligação limita-se a pedir a emissão com dados corretos.

As faturas saem em húngaro?

O Számlázz.hu permite faturas bilingues, por exemplo húngaro e inglês. A língua é escolhida em cada pedido e pode depender do cliente.

Preciso de registo fiscal na Hungria?

Para faturar a partir de uma conta Számlázz.hu, sim, a empresa tem de estar registada na Hungria. O enquadramento deve ser confirmado com um contabilista local.

Ativar a integração Számlázz.hu?

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