Escopo
Resolução feita em 17/12/25
O sistema, denominado Automação de Geração de Links de Pagamento, tem como propósito otimizar o processo de criação de cobranças, substituindo a geração manual individual por um processamento em lote automatizado via script Python.
Dentre os principais objetivos de negócio destacam-se a redução drástica de erros operacionais (como digitação incorreta de valores ou dados de clientes) e o ganho de eficiência operacional na emissão de cobranças em grande escala.
O software permitirá ao usuário:
- Carregar arquivos de dados (planilhas formato .csv) contendo as informações dos clientes e valores.
- Processar essas informações integrando-se automaticamente ao Gateway de Pagamento Pagar (via API V5).
- Gerar e extrair os links de pagamento correspondentes para um arquivo de saída consolidado.
Escopo Negativo: É fundamental estabelecer que este sistema não realizará o envio das cobranças aos clientes finais (via e-mail, SMS ou WhatsApp) e não manterá registro ou controle de quem realizou ou não o pagamento (status da transação/baixa bancária). A responsabilidade do software encerra-se na geração e disponibilização do link de pagamento válido.
Requisitos
Prioridade
Requisitos Funcionais
- RF01: Gerar um script que aplique regras em dados oriundos de planilhas e consuma uma API da aplicação Pagar
- Luis Henrique
- RF02: Gravar na planilha o link de pagamento gerado pela API
- Luis Henrique
- RF03:
- RF04:
Leitura de Arquivo de Entrada: O script deve ler um arquivo .csv contendo colunas obrigatórias: Nome do Cliente, Valor (R$), Descrição do Item, Quantidade.
- RF05:Aplicação de Regras e Validação: O sistema deve validar os dados da planilha antes do envio (ex: converter valor decimal para centavos inteiros, verificar caracteres inválidos).
- RF06:Integração com Pagar.me V5: O script deve consumir a API do Pagar.me (Endpoint: POST /payment_links) autenticando-se via Basic Auth com a Secret Key.
- RF07:Geração de Payload JSON: O sistema deve montar o JSON de requisição contendo os objetos "payment_settings" e "cart_settings" conforme documentação da V5.
- RF08:Gravação do Link: O sistema deve capturar a URL do link retornada pela API e gravá-la em uma nova coluna na planilha ("Link de Pagamento").
- RF09:Tratamento de Erros de API: O sistema deve capturar erros HTTP (400, 401, 429) e registrar o motivo da falha na planilha de saída (ex: "Erro: Valor inválido"), sem interromper o processamento dos demais itens.
- RF10:Exportação de Resultado: Ao final, gerar um arquivo "resultado_[data].csv" contendo os dados originais acrescidos do Link Gerado ou Mensagem de Erro.
Requisitos Não-Funcionais
- RNF01:
Cronograma
| RF | Descrição | Início | Tempo em dias | Data Real entrega | Maker | % |
|---|---|---|---|---|---|---|
| 01 | Criar script a partir de uma planilha | 22/12/2025 | 3 | Luis Henrique | 30% | |
| 02 | Gerar interface para seleção da planilha | 4 | Luis Henrique | 0% | ||
| 03 | Gravar link de pagamento na planilha | 3 | Luis Henrique | 0% |
Diagramas
Projeto
Plano de Testes
Ambiente
Histórico
- 19/12/2025:
- Leonardo deve entregar os RFs
- Ambiente sendo montando entre Time e Sophia
- Luis montou link estático. Ainda não está rodando em cima das tabelas.
Equipe
- João Gabriel Santos Rodrigues
- Luis Henrique Bonini Santiago
- Euller Moreira de Santana
- Laryssa Eugênia de Oliveira