Nordlet

← 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) com serviceCountryCode, o país onde se situa o alojamento ou onde o transporte tem lugar. Ambos requerem supplyType: "services".
  • underlyingSupplierGaveVatNumber e underlyingSupplierChargesVat: 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 vatScheme intra_eu_b2b (art. 262, n.º 1, alínea a)) ou reverse_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.