Saltar para o conteúdo

Erro

FX-SCH-A-000417: O código do tipo de documento tem de ser aceite pelo perfil

Em resumo

Erro: falha nas verificações selecionadas.

FX-SCH-A-000417 significa que o código do tipo de documento (BT-3) de um ficheiro Basic WL tem um valor não vazio que não consta da lista permitida pelo perfil. Corrija ram:TypeCode dentro de rsm:ExchangedDocument com um código permitido que corresponda ao tipo real do documento. Exporte e volte a verificar o ficheiro.

Nesta página

O que significa

Nos perfis Basic WL do Factur-X e do ZUGFeRD, esta regra verifica ram:TypeCode diretamente dentro de rsm:ExchangedDocument. Um valor não vazio tem de pertencer à lista de tipos de documento do perfil. Exemplos são 380 para uma fatura e 381 para uma nota de crédito. Um valor vazio passa esta verificação específica, mas isso não significa que o tipo de documento possa ser omitido.

Porque é importante

O código identifica o tipo de documento emitido e deve preservar esse significado.

Como corrigir

Verifique o tipo real do documento (BT-3) e use o código correspondente da lista Basic WL. Use 380 para uma fatura ou 381 para uma nota de crédito apenas quando esse for o tipo correto. Não substitua outro tipo permitido apenas por ser menos comum. No XML, corrija ram:TypeCode dentro de rsm:ExchangedDocument, não ram:ExchangedDocument. Exporte e volte a verificar o ficheiro.

Depois de corrigir o ficheiro, volte a verificá-lo gratuitamente: Verificar uma fatura eletrónica

Ou corrija a fatura num formulário e transfira o ficheiro corrigido, por 1 crédito: Corrigir uma fatura eletrónica rejeitada Beta

A regra tal como foi publicada

Value of 'ram:TypeCode' is not allowed.

Onde esta regra se aplica

Conjunto de regras Versão
Factur-X 1.09 BASIC WL 1.0.9-2
ZUGFeRD 2.5 BASIC WL 2.5.2
Texto da regra retirado de phive-rules 4.6.4.

Verifique o seu ficheiro

Arraste para aqui a sua fatura eletrónica para ver se a regra FX-SCH-A-000417 ainda falha e que outras regras falham.

Atualizado em 7 de novembro de 2026