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.
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.
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
- 01
Pedido
O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.
- 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.
- 03
Configuração e testes
A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.
- 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.
Integrações relacionadas
Ver todas as integrações- Reservas
FareHarbor
Operadores de tours e atividades: cada reserva FareHarbor gera o documento certo no software de faturação, sem exportações manuais.
Desde 30 € /mês + IVA
Ver integração - Pagamentos
Stripe
Leva cada pagamento, subscrição e reembolso da Stripe para a faturação portuguesa, o CRM e o back-office, sem exportações.
Desde 5 € /mês + IVA
Ver integração - Comércio
WooCommerce
Liga a loja WooCommerce à faturação, aos pagamentos portugueses e às transportadoras, por webhooks e REST API.
Desde 5 € /mês + IVA
Ver integração
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.