← Documentacao / Guias
Motor de IVA da UE
Determinação do local de prestação, declarações OSS/IOSS, isenção para PME e limites para vendas à distância.
Tratamento de IVA transfronteiriço para vendas na UE/EEE: determinação do local de prestação (place-of-supply), autoliquidação (reverse charge), tratamento do fornecedor presumido (deemed-supplier) em plataformas (marketplace), referência de taxas por país e declarações OSS/IOSS. Tudo o que se segue funciona com base na API (API-first); os âmbitos (scopes) são apresentados por ponto de extremidade (endpoint).
Referência de taxas
POST /v1/reference/eu-vat-rates/list (reference:read) - taxas de IVA estatutárias para todos os 27 Estados-Membros da UE, filtráveis por countryCode e date. As janelas de validade das taxas são monitorizadas desde 2024-01-01 (EE 24 % a partir de 2025-07, RO 21 %/11 % a partir de 2025-08, SK 23 %/19 % a partir de 2025-01, FI 13,5 % e LT 12 % a partir de 2026-01, CZ 12 % a partir de 2024-01).
Fonte: base de dados "Taxes in Europe" da Comissão Europeia (TEDB, https://ec.europa.eu/taxation_customs/tedb/), obtida em 2026-07-16; alterações lituanas para 2026 confirmadas junto da VMI (https://www.vmi.lt/evmi/pvm-tarifai), alteração finlandesa para 2026 junto de vero.fi. Âmbito: apenas taxas do território continental/geral - as variantes regionais (Jungholz na Áustria, ilhas gregas, Açores/Madeira, territórios ultramarinos franceses e Córsega) não estão modeladas.
POST /v1/reference/vat-classifiers/list devolve agora um countryCode por classificador (os códigos i.SAF PVM* existentes correspondem a LT); POST /v1/reference/vat-classifiers/upsert (reference:write) carrega conjuntos de classificadores para países adicionais, constituindo o caminho de dados para futuros pacotes de países.
Determinação do tratamento
POST /v1/reference/vat/resolve (reference:read) responde à questão "que IVA devo cobrar?" para uma transação. Entrada: partnerId ou customerCountryCode (+ anulação opcional customerIsBusiness - inferida do número de IVA do parceiro, caso contrário), supplyType (goods | services | digital), date e sinalizadores de situação: belowDistanceSalesThreshold, facilitatedByMarketplace (vende através de uma plataforma de fornecedor presumido), actingAsMarketplace (é a própria plataforma), sellerEstablishedInEu, importedConsignmentValueEur.
Dados de entrada para as regras adicionadas pela Diretiva (UE) 2025/516 do Conselho (IVA na Era Digital):
serviceKind(short_term_accommodation|passenger_road_transport) comserviceCountryCode, o país onde se situa o alojamento ou onde o transporte tem lugar. Ambos requeremsupplyType: "services".underlyingSupplierGaveVatNumbereunderlyingSupplierChargesVat: se o anfitrião ou o motorista forneceu à plataforma um número de IVA do país de fornecimento e declarou que cobra o IVA. Apenas a combinação de ambos evita que a plataforma seja considerada o fornecedor presumido (art. 28a, n.º 1).goodsKind(installed|energy_network) para bens instalados ou montados junto do cliente (art. 36) e para gás, eletricidade, aquecimento ou arrefecimento através de uma rede (arts. 38 e 39).goodsLocationCountryCode, o país onde os bens se encontram no momento da venda ou onde o respetivo transporte se inicia, quando este não coincide com o país da empresa.
Saída: scheme, vatCountryCode, reverseCharge, deemedSupplier, zeroRated, o menu de taxas do país de destino, a base legal (artigo da Diretiva 2006/112/CE) e notas de aconselhamento (por exemplo, um lembrete de que a isenção do art. 138 requer um número de IVA do cliente válido no VIES).
Regras implementadas:
| Situação | Resultado |
|---|---|
| Fornecimento no mesmo país | domestic, taxas nacionais |
| Bens B2B intracomunitários | intra_eu_b2b - fornecimento isento ao abrigo do art. 138, autoliquidação pelo cliente |
| Serviços B2B intracomunitários | reverse_charge - arts. 44 e 196 |
| Bens/serviços digitais B2C intracomunitários acima de 10 000 € | oss_union - taxas de destino, arts. 33, alínea a), e 58 |
Bens/serviços digitais B2C intracomunitários abaixo de 10 000 € (belowDistanceSalesThreshold) |
domestic na origem, art. 59c |
| Serviços gerais B2C intracomunitários | domestic, art. 45 |
| Bens para fora da UE | export - isenção ao abrigo do art. 146, n.º 1 |
| Serviços/digitais para fora da UE | out_of_scope (arts. 44 e 59) |
Venda através de marketplace com fornecedor presumido (facilitatedByMarketplace) |
marketplace_deemed - fornecimento isento ao abrigo do art. 136a para a plataforma |
| Remessa importada ≤ 150 € B2C | ioss - IVA de destino na venda, arts. 369l a 369x; fornecedor presumido quando actingAsMarketplace (art. 14a, n.º 1) |
| Pequena empresa isenta (a empresa não é sujeito passivo de IVA), fornecimento interno | sme_exempt - sem IVA, art. 284, n.º 1 |
| Pequena empresa isenta, B2C transfronteiriço na UE, possui um número EX transfronteiriço | sme_exempt - art. 284, n.º 2; válido enquanto estiver abaixo do limite de destino e do volume de negócios de 100 000 € na União |
| Pequena empresa isenta, B2C transfronteiriço na UE, sem número EX | mantém o regime oss_union/origem com uma nota de que um número EX transfronteiriço tornaria a operação isenta |
Plataforma (actingAsMarketplace) que facilite alojamento até 30 noites ou transporte rodoviário de passageiros, a partir de 1 de julho de 2028 |
deemedSupplier: true, tributado onde se situa o imóvel ou onde o transporte ocorre (arts. 28a, 47 e 48): domestic, oss_union para um consumidor noutro país (art. 369b, alínea c)) ou reverse_charge para uma empresa |
Anfitrião ou motorista que venda através dessa plataforma (facilitatedByMarketplace), a partir de 1 de julho de 2028 |
marketplace_deemed - fornecimento isento para a plataforma, art. 136b |
| Qualquer uma das duas situações anteriores antes de 1 de julho de 2028, ou quando o anfitrião ou motorista forneceu o seu número de IVA e cobra o IVA | local de prestação nos termos dos arts. 47 ou 48, sem fornecedor presumido |
| Bens detidos noutro Estado-Membro vendidos a um consumidor nesse Estado, a partir de 1 de julho de 2028 | oss_union, art. 369b, alínea e); antes disso, domestic nesse país com nota para efetuar registo local |
| A mesma operação para uma empresa nesse Estado | reverse_charge, art. 194 |
| Bens expedidos de outro Estado-Membro | oss_union para um consumidor (art. 33, alínea a)) ou intra_eu_b2b para uma empresa, com nota de que o fornecimento pertence ao registo de IVA desse país |
| Bens instalados para um consumidor noutro Estado-Membro | oss_union a partir de 1 de julho de 2028 (arts. 36 e 369b, alínea d)), antes disso domestic nesse país |
| Gás, eletricidade, aquecimento ou arrefecimento para um consumidor noutro Estado-Membro | oss_union a partir de 1 de janeiro de 2027 (arts. 39 e 369aa, depois 369b, alínea d)); reverse_charge para uma empresa (art. 195) |
O limite de 10 000 € (art. 59c) pode ser transmitido explicitamente como belowDistanceSalesThreshold; quando omitido, o motor calcula-o automaticamente a partir dos dados do razão (ledger) (consulte o ponto de extremidade de limites abaixo) e anota a determinação com os totais acumulados.
Isenção para PME (Diretiva 2020/285, a partir de 2025). Quando a empresa não está registada para efeitos de IVA, o resolvedor trata-a como uma pequena empresa que utiliza a isenção: as operações internas são resolvidas como sme_exempt (sem IVA) e as operações B2C transfronteiriças na UE também são resolvidas como sme_exempt se a empresa possuir um número EX transfronteiriço (smeExemptionNumber no perfil da empresa); caso contrário, mantém o tratamento OSS/origem normal com uma nota a sugerir o regime transfronteiriço. A elegibilidade (permanecer abaixo do limite de destino e do teto de volume de negócios de 100 000 € a nível da União) é da responsabilidade do declarante; o resolvedor assinala-o nas notas. Defina o número EX através de account/companies/update (smeExemptionNumber).
Faturas
Os pontos de extremidade sales/invoices/create|update aceitam vatScheme (um dos regimes acima), vatCountryCode (o Estado-Membro de consumo; obrigatório e validado como UE para oss_union/ioss) e deemedSupplier. As encomendas de comércio eletrónico aceitam shipToCountryCode e marketplace; orders/fulfill determina o tratamento a partir do país de entrega (ship-to) de forma automática e preenche a fatura em rascunho (assume bens e ultrapassagem do limite de vendas à distância - ajuste o rascunho antes de emitir, se aplicável).
Campo de regime de IVA na página de nova fatura
O campo "Regime de IVA" na página de nova fatura disponibiliza as opções abaixo. A percentagem de IVA inserida em cada linha é a que a fatura cobra. A seleção de uma opção marcada com "sem IVA" define todas as linhas como 0 % (e reverter repõe a taxa predefinida). O PDF imprime a menção legalmente exigida para o regime escolhido. A opção "Automático" chama o resolvedor acima ao guardar, utilizando o país e o número de IVA do parceiro, juntamente com o "Tipo de fornecimento" selecionado (bens, serviços ou serviços digitais); se o parceiro não tiver país nem número de IVA, o salvamento falha com uma mensagem e terá de selecionar um regime manualmente.
| Opção no formulário | Regime | Utilizar quando | IVA na fatura |
|---|---|---|---|
| Automático (a partir do parceiro e tipo de fornecimento) | determinado ao guardar | Pretende que o regime seja determinado a partir do parceiro e do tipo de fornecimento | Definido pelo regime determinado; as linhas ficam a zero para regimes sem IVA |
| Doméstico | domestic |
O comprador está no seu próprio país | Taxas do seu país |
| Bens B2B intracomunitários (0%, art. 138) | intra_eu_b2b |
Bens expedidos para uma empresa registada para efeitos de IVA noutro país da UE; o número de IVA do comprador deve ser válido no VIES | Sem IVA; o PDF indica a isenção do art. 138 |
| Serviços B2B intracomunitários (autoliquidação) | reverse_charge |
Serviços prestados a uma empresa registada para efeitos de IVA noutro país da UE | Sem IVA; o PDF imprime "Autoliquidação" (art. 196) |
| OSS da União (consumidores da UE, IVA de destino) | oss_union |
Bens ou serviços digitais a consumidores noutro país da UE acima do limite de 10 000 € a nível da UE; requer o país de consumo | Taxa do país de consumo, inserida em cada linha; declarada na declaração trimestral OSS |
| IOSS (importações até 150 €) | ioss |
Bens importados de fora da UE para um consumidor da UE, remessa ≤ 150 €; requer o país de consumo | Taxa do país de consumo, inserida em cada linha; declarada na declaração mensal IOSS |
| Marketplace (fornecedor presumido) | marketplace_deemed |
Vende através de uma plataforma que atua como fornecedor presumido | Sem IVA no seu fornecimento à plataforma (art. 136a) |
| Exportação (isento) | export |
Bens expedidos para fora da UE | Sem IVA; o PDF indica a isenção do art. 146 |
| Fora do âmbito (serviços fora da UE) | out_of_scope |
Serviços prestados a um cliente fora da UE | Sem IVA; o PDF indica que a operação está fora do âmbito do IVA da UE (arts. 44 e 59) |
| Isenção PME (não sujeito passivo de IVA) | sme_exempt |
A sua empresa não é sujeito passivo de IVA e utiliza a isenção para pequenas empresas | Sem IVA; o PDF indica a isenção do art. 284 |
As duas opções de B2B intracomunitário diferem apenas no objeto do fornecimento. Os bens enquadram-se na isenção do art. 138: o comprador declara uma aquisição intracomunitária. Os serviços enquadram-se na autoliquidação dos arts. 44 e 196: o comprador autoliquida o IVA. Ambas geram uma fatura sem IVA, mas a menção impressa no PDF e o campo correspondente na declaração do comprador são diferentes, pelo que a escolha é determinante.
Declarações OSS / IOSS
POST /v1/declarations/eu/oss/compute (declarations:read) { year, quarter } - declaração trimestral do regime da União nos termos do Anexo III do Regulamento de Execução (UE) 2020/194 da Comissão: linhas por Estado-Membro de consumo × tipo de taxa (STANDARD/REDUCED) × taxa com montante tributável e IVA, notas de crédito compensadas, acrescidas dos totais. Apenas são incluídos os documentos emitidos com vatScheme: "oss_union". Os avisos assinalam taxas não estatutárias para o destino e período, linhas isentas ignoradas, documentos sem vatCountryCode e operações tributadas no Estado-Membro de identificação.
POST /v1/declarations/eu/ioss/compute { year, month } - o mesmo formato, em base mensal, para vatScheme: "ioss" (remessas importadas ≤ 150 €.
Ambas as respostas incluem uma matriz corrections (além de correctionsTotal): uma nota de crédito emitida no período atual, mas associada (através de creditedInvoiceId) a uma fatura original de um período OSS/IOSS anterior, é retirada das linhas do período e reportada como uma correção de período anterior (país, ano original, trimestre original (OSS) ou mês original (IOSS), e o delta de IVA negativo), conforme exigido pelo Anexo III do Regulamento 2020/194. As notas de crédito sem creditedInvoiceId são integradas no período atual e assinaladas com um aviso para que possam ser associadas; correções com mais de três anos são sinalizadas (art. 61 do Regulamento 282/2011).
Disponível para qualquer empresa estabelecida na UE (não restrito à Lituânia).
Declaração de transferências de bens próprios
POST /v1/declarations/eu/own-goods-transfers/compute (declarations:read) { year, month } - declaração mensal do regime especial aplicável às transferências de bens próprios (Diretiva 2006/112/CE, arts. 369xa a 369xk, a partir de 1 de julho de 2028), apresentada no Estado-Membro onde a empresa está estabelecida até ao final do mês seguinte (dueDate). As linhas apresentam, por Estado-Membro de destino e por Estado-Membro de expedição dos bens, o valor das transferências ao custo (art. 76) em euros, convertido à taxa de câmbio do último dia do mês (art. 369xh). Uma transferência corresponde a uma transferência de stock (POST /v1/inventory/stock/transfer) entre armazéns situados em dois Estados-Membros diferentes; defina o país do armazém com countryCode em /v1/inventory/warehouses/create ou /v1/inventory/warehouses/update (um armazém sem esta indicação assume o país da empresa).
Relato digital da UE
POST /v1/declarations/eu/digital-reporting/list (declarations:read) { fromDate, toDate } lista todas as transações que o art. 262 da Diretiva 2006/112/CE exige que sejam reportadas individualmente a partir de 1 de julho de 2030, em todos os 27 Estados-Membros:
- faturas de venda e notas de crédito emitidas com o
vatSchemeintra_eu_b2b(art. 262, n.º 1, alínea a)) oureverse_charge(art. 262, n.º 1, alínea c)), exigíveis no momento da emissão da fatura; - faturas de compra registadas emitidas por um fornecedor noutro Estado-Membro cujas linhas tenham o IVA autoliquidado pela empresa (art. 262, n.º 1, alínea b) para bens, alínea d) para serviços), exigíveis 5 dias após a receção da fatura.
Cada transação contém os dados exigidos pelo art. 264: data e número da fatura, números de IVA do fornecedor e do cliente, linhas, montante tributável, referência da isenção, número da fatura corrigida no caso de nota de crédito (art. 226, n.º 16), contas bancárias do fornecedor (art. 226, n.º 17), taxa e montante de IVA para aquisições, Estado-Membro de reporte (o que emitiu o número de IVA utilizado, art. 262, n.º 2), prazo limite e missing a identificar qualquer elemento de dados em falta no registo. Os Estados-Membros devem aceitar os dados sob a forma de fatura eletrónica EN 16931 (art. 263, n.º 3); POST /v1/sales/invoices/peppol-xml gera esse ficheiro para cada fornecimento. A mensagem comum da UE prevista no art. 263, n.º 4, e os canais nacionais de transmissão de dados ainda não foram publicados, pelo que a Nordlet não efetua o envio.
Limite de vendas à distância
POST /v1/declarations/eu/distance-sales-threshold/get (declarations:read) { date? } - monitoriza o limite de 10 000 € na União previsto no art. 59c a partir dos dados do razão: totais do ano civil atual e anterior relativos a vendas à distância B2C transfronteiriças (faturas ao abrigo do regime OSS e faturas a consumidores transfronteiriças sem regime), indicando se a empresa se mantém abaixo do limite e a margem restante. Os documentos em moedas diferentes de EUR são somados pelo valor do documento, acompanhados de um aviso. O resolvedor de IVA consulta este ponto de extremidade automaticamente quando belowDistanceSalesThreshold não é fornecido.
Limites da isenção para PME
POST /v1/declarations/eu/sme-thresholds/list devolve oslimites de isenção de IVA internos por Estado-Membro ao abrigo da Diretiva (UE) 2020/285 (incluindo o limite nacional de 85 000 € e o limite de volume de negócios na União de 100 000 €). Os valores são obtidos a partir das páginas do portal de PME da Comissão; caso uma página nacional remeta para a TEDB sem indicar um valor explícito, o resultado apresentado é null em vez de uma estimativa. Algunslimites estão definidos em moeda nacional (DKK/HUF/RON) e determinados países publicam limites setoriais (por exemplo, Irlanda: serviços 42 500 €, bens 85 000 €).
POST /v1/declarations/eu/sme-threshold/get { date? } reporta a posição de uma empresa não sujeita a IVA face ao limite do seu próprio país: volume de negócios do ano civil atual acrescido do ano anterior (precedingTurnover), status (below / approaching a 80% / exceeded, ou not_applicable para um sujeito passivo registado, unknown quando o limite não consta do registo ou a moeda difere), margem restante e avisos. São incluídos avisos de quarentena: a ultrapassagem do limite determina a indisponibilidade da isenção para o resto do ano civil atual e para o ano civil seguinte, sendo emitido um aviso a uma empresa que se encontre abaixo do limite este ano mas o tenha ultrapassado no ano passado de que a isenção só poderá ser retomada no ano posterior (ambos os anos devem permanecer abaixo - mecânica do art. 284, n.º 2; o ponto de extremidade de volume de negócios na União inclui o mesmo aviso para o limite de 100 000 €). Para os países com um gatilho intracomunitário nacional - os 14 000 € da Lituânia para serviços prestados a outros Estados-Membros e bens/serviços adquiridos a estes -, a resposta inclui uma discriminação intraEu (aquisições a fornecedores da UE + serviços sujeitos a autoliquidação prestados) com o respetivo estado e aviso.
Regime de PME transfronteiriço: volume de negócios na União e declaração trimestral
POST /v1/declarations/eu/union-turnover/get { date? } monitoriza o teto de 100 000 € de "volume de negócios na União" para o regime de PME transfronteiriço (art. 284, n.º 2) com base nos dados do razão - o valor total dos fornecimentos efetuados no interior da UE (excluindo exportações e operações fora do âmbito) no ano civil atual e anterior -, devolvendo os totais de ambos os anos, o status, a margem e os avisos (not_applicable para um sujeito passivo de IVA).
POST /v1/declarations/eu/sme-cross-border-report/compute { year, quarter } gera a declaração trimestral que uma PME abrangida pelo regime deve apresentar ao seu Estado-Membro de origem (art. 284b): o valor total dos fornecimentos efetuados em cada Estado-Membro nesse trimestre, uma linha por país (sendo o Estado-Membro de fornecimento o país de consumo da fatura, caso contrário o país do parceiro e, na falta de ambos, o país de origem), acrescido do total. Os fornecimentos extra-UE são excluídos.
Pacotes de declarações de IVA nacionais
POST /v1/declarations/eu/vat-return/packs/list enumera os pacotes de países disponíveis; POST /v1/declarations/eu/vat-return/compute { countryCode, year, month, months? } encaminha o pedido para o pacote registado para esse país e devolve a declaração sob a forma de campos numerados ({ code, label, amount }), juntamente com avisos, notas e a fonte oficial (source). Requer que a empresa esteja registada nesse país (caso contrário, devolve 422). Lituânia (FR0600) é disponibilizada como o primeiro pacote, integrando o gerador FR0600 existente; serão adicionados novos países sob a forma de adaptadores baseados exclusivamente em dados logo que o seu layout oficial de formulário seja validado.
O relatório POST /v1/reports/oss anterior mantém-se disponível como uma vista de analítica heurística (baseada no país do parceiro, sem exigir um regime específico); os pontos de extremidade de declaração constituem a via adequada para efeitos fiscais. Ambos derivam o país de origem a partir da empresa em vez de assumirem a Lituânia.