Gerador de pagamentos

Propósito e intenção do utilizador: a ferramenta gera instruções de pagamento estruturadas e referências de pagamento para apoiar fluxos de faturação. Utilizadores primários: contabilistas, equipas financeiras, freelancers e pequenas empresas que emitem faturas e necessitam de dados de pagamento consistentes e auditos. Utiliza-se quando pagamentos são preparados ou quando detalhes do pagador-beneficiário são partilhados com clientes, fornecedores ou sistemas de folha de pagamento. Lógica central e características: normaliza entradas, valida formatos IBAN/BBAN e códigos de moeda, aplica regras por país e constrói um bloco canónico de instruções de pagamento. Funcionalidades obrigatórias: normalização de entradas, validação IBAN e geração determinística de referência com base em invoice_id, due_date e montante. Funcionalidades opcionais/avançadas: presets multi-moeda, saída JSON pronta para API e formatos de exportação compatíveis com ERP. Entradas/saídas: entradas incluem payer_name, payer_iban, payer_country, beneficiary_name, beneficiary_iban, amount, currency, due_date, invoice_id e referência opcional. Saídas incluem bloco de pagamento legível e payload JSON/CSV legível por máquina ou registo completo de transferência. Validação cobre presença de campos obrigatórios, formatos corretos e moedas suportadas. Algoritmos: geração de referência usa hash determinístico de invoice_id, due_date, amount e IBANs envolvidos; os primeiros 12 caracteres alfanuméricos formam a referência de pagamento. Validação IBAN usa o algoritmo de checksum padrão; saídas seguem normas ISO. Erros e casos extremos: entradas ausentes ou IBAN inválidos geram erros de domínio; moedas ou códigos de país não suportados geram avisos de validação; falha de dados externos aciona fallback seguro. Indústria/Região e Localização: alinhado com IBAN e ISO 4217, considerações SWIFT/BIC e formatos regionais de data/moeda; suporta localização de formatação de moeda. Suposições e Exclusões: Assume entradas fornecidas pelo utilizador ou fontes de confiança; não efetua pagamentos, verifica permissões bancárias nem fornece componentes de UI; excluir estilos de UI e comportamento de front-end.