Sepa-XMl
Sepa-XMl

Uma empresa pode ter os dados bancários dos seus clientes organizados, as autorizações de débito direto atualizadas e os montantes dos pagamentos acordados. Mas como é que transforma toda essa informação em instruções que um banco possa processar?

É aí que entra a mensagem «pain.008». Trata-se de uma mensagem XML utilizada para preparar as cobranças por débito direto SEPA. A sua estrutura organiza as informações sobre a empresa, os ordenantes, as autorizações e as transações num formato normalizado.

Compreender como esta informação está organizada facilita a deteção de erros, a verificação de detalhes e evita ter de refazer o trabalho. Neste guia, vamos analisar os principais elementos do pain.008 através de um exemplo simples, sem que sejam necessários conhecimentos avançados de programação.

O que é um ficheiro pain.008?

O «pain.008» é uma mensagem ISO 20022 utilizada para iniciar cobranças por débito direto. O seu nome técnico é «Iniciação de Débito Direto do Cliente» e o seu objetivo é enviar instruções de cobrança do credor ao prestador de serviços de pagamento.

No contexto do Débito Direto SEPA, o ficheiro permite agrupar vários débitos numa estrutura XML, de acordo com as orientações técnicas do Conselho Europeu de Pagamentos (EPC).

Imagine uma empresa que precisa de cobrar pagamentos mensais a 50 clientes. Em vez de preparar cada instrução separadamente, pode organizar as transações num único ficheiro, desde que os dados e os requisitos de envio estejam corretos.

Um ficheiro pain.008, portanto, não constitui prova de que uma transferência tenha sido concluída. Contém instruções que ainda têm de ser recebidas e processadas pela instituição financeira.

Como está estruturado um ficheiro XML pain.008?

Um ficheiro XML utiliza elementos identificados por etiquetas para organizar a informação. No pain.008, estas etiquetas seguem uma hierarquia definida, permitindo que os sistemas reconheçam cada dado e a sua finalidade.

A estrutura tem três secções principais: Cabeçalho do Grupo, Informações de Pagamento e Informações sobre Transações de Débito Direto.

Cabeçalho do grupo: Identificação do ficheiro

O cabeçalho do grupo (GrpHdr) contém informações gerais sobre a mensagem, tais como o seu identificador, data de criação, número de transações e totais de controlo.

Estes detalhes ajudam a identificar o ficheiro e a verificar o seu conteúdo. Por exemplo, se o número de transações declarado não corresponder ao conteúdo real, a mensagem poderá conter inconsistências.

Informações de pagamento: Detalhes da cobrança

A secção «Informações de pagamento» (PmtInf) organiza as informações partilhadas por um conjunto de transações.

É aqui que encontrará os dados relativos ao credor, ao tipo de pagamento, ao sistema utilizado e à data de cobrança solicitada.

Um ficheiro pode conter várias secções deste tipo, dependendo da forma como as instruções estão organizadas e das regras técnicas aplicáveis.

Informações sobre transações de débito direto: Detalhes de cada transação

Nas secções de pagamento, o elemento «Informações sobre transações de débito direto» (DrctDbtTxInf) identifica cada cobrança.

Inclui detalhes como o montante, o identificador da transação, as informações do ordenante e as referências da autorização.

Esta estrutura permite que um único ficheiro contenha várias instruções, mantendo cada transação identificável individualmente.

Quais são os principais campos de um ficheiro pain.008?

Embora o XML contenha muitos elementos, alguns são particularmente importantes para compreender como as colecções são preparadas.

Campo XML Finalidade
MsgId Identifica a mensagem enviada
CreDtTm Regista a data e a hora de criação
NbOfTxs Especifica o número de transações
PmtInfId Identifica o grupo de instruções de pagamento
ReqdColltnDt Especifica a data de cobrança solicitada
EndToEndId Identifica de forma única uma transação
InstdAmt Especifica o montante a cobrar
MndtId Identifica a autorização de débito direto
DtOfSgntr Regista a data em que o mandato foi assinado

Estes campos não abrangem todos os requisitos de uma mensagem pain.008. A mensagem deve também incluir dados bancários, a identificação das partes envolvidas e outros elementos exigidos pelas regras aplicáveis.

A versão da norma e os requisitos da instituição financeira determinam quais os dados que devem ser fornecidos e como devem ser organizados.

Exemplo prático: Como se lê um excerto de XML do pain.008?

Considere uma empresa fictícia que precisa de cobrar 150 € a um cliente que autorizou o débito direto. A transação tem o seu próprio identificador e está associada a uma autorização registada anteriormente.

Uma representação simplificada de parte da cobrança teria o seguinte aspeto:

<DrctDbtTxInf>

<PmtId>

<EndToEndId>INV-2026-001</EndToEndId>

</PmtId>

<InstdAmt Ccy=”EUR”>150,00</InstdAmt>

<DrctDbtTx>

<MndtRltdInf>

<MndtId>MANDATO-001</MndtId>

<DtOfSgntr>15 de outubro de 2026</DtOfSgntr>

</MndtRltdInf>

</DrctDbtTx>

</DrctDbtTxInf>

Este é um exemplo ilustrativo que utiliza dados fictícios. O excerto foi simplificado por uma questão de clareza e não constitui um ficheiro completo e validado, pronto para ser enviado a um banco.

Neste exemplo, o EndToEndId identifica a transação, enquanto o InstdAmt regista o montante de 150 €. O atributo Ccy indica a moeda utilizada.

MndtId é a referência do mandato e DtOfSgntr regista a data em que o mandato foi assinado.

Estes dados têm de corresponder aos registos da empresa. Por exemplo, se o identificador do mandato não corresponder a uma autorização existente, isso poderá causar problemas no processamento ou na apresentação de provas da cobrança.

De que forma é que estes detalhes se relacionam com a preparação do ficheiro?

Na prática, uma empresa precisa de recolher informações como o montante, o identificador da cobrança, os dados do cliente e a referência da autorização antes de gerar o ficheiro XML.

Uma ferramenta de geração de ficheiros organiza estes detalhes na estrutura técnica necessária, para que os utilizadores não tenham de escrever cada etiqueta manualmente.

O exemplo ilustra esta relação a nível conceptual. Não reproduz ecrãs nem campos específicos da interface do SEPA XML Generator.

Que erros podem levar à rejeição de um ficheiro XML?

Um ficheiro XML não está necessariamente pronto para ser processado apenas porque as suas etiquetas estão corretamente organizadas. A instituição financeira verifica também os requisitos técnicos e operacionais.

Entre os motivos que podem impedir a aceitação contam-se a falta de informações obrigatórias, versões de mensagens incompatíveis, montantes inconsistentes e dados bancários inválidos.

É igualmente importante distinguir entre duas situações: a rejeição do processo e a rejeição de uma coleção específica.

Um ficheiro pode apresentar um problema estrutural que impeça a sua aceitação. Noutros casos, a mensagem pode ser aceite, mas uma transação específica pode apresentar um problema, como dados bancários incorretos ou um problema com a autorização.

O resultado depende das regras do sistema SEPA e dos procedimentos da instituição financeira em causa.

Como se preparam e validam os ficheiros pain.008?

Uma preparação cuidadosa começa antes da geração do ficheiro XML. A empresa deve verificar as informações dos clientes, confirmar as autorizações e organizar os montantes e as datas de cobrança.

Em seguida, tem de utilizar uma estrutura compatível com a versão da mensagem aceite pelo seu banco.

A validação técnica permite identificar problemas de formatação e estrutura, mas não garante que todas as cobranças sejam aprovadas. Poderão ainda ser aplicadas verificações bancárias e operacionais adicionais.

O SEPA XML Generator disponibiliza ferramentas para a criação de ficheiros SEPA XML. Para ver como funciona a plataforma, consulte a Visita Guiada ao Produto.

Para obter requisitos técnicos mais detalhados, as principais referências são a documentação da norma ISO 20022 e as Orientações de Implementação do EPC.

Perguntas frequentes sobre a dor.008

Qual é a diferença entre o pain.008 e o pain.001?

O «pain.008» é utilizado para iniciar cobranças por débito direto, enquanto o «pain.001» é utilizado para instruções de transferência de crédito. Trata-se de mensagens diferentes, cada uma com a sua própria estrutura e finalidade.

Um ficheiro pain.008 pode conter várias coleções?

Sim. A estrutura permite que várias transações sejam organizadas num único ficheiro. O número aceitável e as condições de processamento dependem das regras técnicas e operacionais do banco.

Um ficheiro pain.008 válido garante que uma cobrança será processada?

Não. A validação estrutural não substitui as verificações efetuadas pelo banco. Uma cobrança pode ainda ser rejeitada ou devolvida devido a problemas com os dados, a autorização ou as condições da transação.

Prepare os seus ficheiros XML SEPA com maior confiança

Compreender a estrutura do ficheiro pain.008 facilita a organização das cobranças e a identificação de potenciais inconsistências antes de enviar um ficheiro ao banco.

O SEPA XML Generator permite-lhe preparar ficheiros XML sem ter de criar manualmente toda a estrutura técnica. Explore as funcionalidades disponíveis na Visita Guiada ao Produto e descubra como simplificar esta parte do seu fluxo de trabalho.

Cria hoje mesmo o teu primeiro ficheiro XML SEPA

Começa a experimentar o SEPA XML GENERATOR gratuitamente — sem qualquer compromisso. Cria ficheiros de débito direto ou de transferência bancária e envia-os diretamente para o teu banco online.