Verificador de endereços ISO 20022
Verifique os endereços postais em um arquivo de pagamento pain.001, pacs.008 ou outro arquivo ISO 20022: veja quais estão estruturados, híbridos ou não estruturados e o que corrigir antes que os bancos os rejeitem.
Entrada
Saída
| Parte | Tipo | Endereço | Problemas |
|---|---|---|---|
| Nenhum endereço | |||
Leia-me
O que muda em novembro de 2026
Os bancos estão deixando de aceitar endereços postais totalmente não estruturados nas mensagens de pagamento ISO 20022. Os pagamentos internacionais do SWIFT (CBPR+) deixam de aceitá-los com a versão dos padrões de novembro de 2026, e os esquemas SEPA do Conselho Europeu de Pagamentos seguem o mesmo caminho em 22 de novembro de 2026. A partir de então, o endereço de cada pagador, beneficiário e banco em um pagamento precisa ser estruturado ou híbrido, e um pagamento com um endereço não estruturado pode ser rejeitado. Os arquivos que os softwares de contabilidade, folha de pagamento e ERP geram para o banco (transferências a crédito pain.001, débitos diretos pain.008) são afetados tanto quanto as mensagens que os bancos trocam entre si.
Três tipos de endereço
Um endereço estruturado coloca cada parte em um elemento próprio: rua (StrtNm), número do prédio (BldgNb), código postal (PstCd), cidade (TwnNm) e país (Ctry), sem linhas de endereço.
<PstlAdr>
<StrtNm>Market Street</StrtNm>
<BldgNb>12</BldgNb>
<PstCd>10115</PstCd>
<TwnNm>Berlin</TwnNm>
<Ctry>DE</Ctry>
</PstlAdr>Um endereço híbrido tem a cidade e o país em elementos próprios e o restante em no máximo duas linhas de endereço (AdrLine) de até 70 caracteres. As linhas não devem repetir a cidade nem o país.
<PstlAdr>
<TwnNm>Lisbon</TwnNm>
<Ctry>PT</Ctry>
<AdrLine>Rua das Flores 25, 2nd floor</AdrLine>
</PstlAdr>Um endereço não estruturado é escrito apenas em linhas de endereço, sem uma cidade separada. É esse o tipo que deixa de ser aceito.
<PstlAdr>
<Ctry>FR</Ctry>
<AdrLine>8 Rue du Vent</AdrLine>
<AdrLine>69002 Lyon</AdrLine>
</PstlAdr>Como verificar um arquivo
Cole o XML ou carregue o arquivo. O verificador encontra todos os endereços postais (PstlAdr) nele, seja qual for o tipo e a versão da mensagem: pain.001, pain.008, pacs.008, pacs.009, pacs.004, camt.053 e outros. Ele mostra:
- O nome da mensagem, obtido do namespace do arquivo, e quantos endereços de cada tipo o arquivo tem.
- Uma lista de verificação para o arquivo inteiro.
- Uma tabela com todos os endereços, com a parte a que cada um pertence (devedor, credor, credor final, um banco etc.), onde ele está no arquivo (número do pagamento e da transação), seus campos e seus problemas. Em um arquivo grande, marque "Somente endereços com problemas". Os botões abaixo da tabela permitem baixá-la como CSV ou JSON.
O que os problemas significam
- Endereço não estruturado: adicione a cidade (TwnNm) e o país (Ctry) como elementos próprios. As linhas de endereço podem permanecer, o que o torna um endereço híbrido, ou a rua, o número do prédio e o código postal também podem passar para elementos próprios.
- Cidade ausente ou país ausente: todo endereço estruturado ou híbrido precisa dos dois.
- Código de país desconhecido: o país é um código ISO 3166 de duas letras maiúsculas, como DE, FR ou PT.
- Linhas de endereço demais ou uma linha longa demais: um endereço híbrido aceita duas linhas de até 70 caracteres.
- Um campo longo demais: cada elemento tem um comprimento máximo nos esquemas ISO 20022, como 35 caracteres para a cidade e 16 para o código postal.
- Uma linha de endereço que repete a cidade ou o país é exibida como aviso: essas informações devem ficar apenas nos seus próprios elementos.
É bom saber
- O verificador analisa apenas os endereços. Ele não valida o arquivo inteiro com o esquema XML da mensagem, e seu banco pode ter regras próprias, então consulte também as diretrizes dele.
- Tudo acontece no seu navegador. O arquivo não é enviado para lugar nenhum, o que é importante porque os arquivos de pagamento contêm nomes e dados de contas.
Recursos
- Encontra todos os endereços postais em qualquer mensagem ISO 20022
- Distingue endereços estruturados, híbridos e não estruturados
- Verifica cidade, país, linhas de endereço, comprimento dos campos e códigos de país
- Mostra cada endereço com a parte correspondente e sua posição no arquivo
- Filtra os endereços com problemas e os exporta como CSV ou JSON