API e processamento de dados
API de apoio ao cálculo tributário
API em Python que recebia operações da bolsa americana em XLSX e retornava cálculos por ação e um total consolidado para um cliente ucraniano.
- Planilha
Operações em inglês ou ucraniano.
- Organização
Compras e vendas agrupadas por ação.
- Cálculo
Pareamento pelas compras mais antigas.
- Resposta
Valores por ação e total em JSON.
Esta página foi escrita a partir da minha experiência no projeto. Os materiais originais não estão mais disponíveis, e o diagrama é ilustrativo.
Reunir as operações de um período
Um cliente ucraniano operava na bolsa americana, principalmente com swing trade, e precisava calcular os valores relacionados aos impostos de suas operações. As informações chegavam em uma planilha XLSX, geralmente com os movimentos de um ano.
Desenvolvi toda a API em Python. Ela recebia o arquivo, organizava as operações e devolvia um JSON com os valores por ação e o total consolidado. Usei pandas e NumPy na leitura, no processamento e nos cálculos.
Compras e vendas da mesma ação
O principal desafio estava no histórico de cada ativo. Uma compra podia ser vendida em várias partes, e outras compras e vendas da mesma ação podiam acontecer ao longo do período.
Organizei o pareamento em uma fila: conforme as vendas eram processadas, elas consumiam as compras mais antigas disponíveis no arquivo. Esse critério, conhecido como FIFO, permitia acompanhar as quantidades associadas a cada operação.
Outro cuidado era a leitura das planilhas. O cliente precisava enviar documentos em inglês e em ucraniano, então o processamento reconhecia as informações nos dois formatos de idioma.
Entrega e alcance deste relato
O cliente utilizou a API e confirmou seu funcionamento. A entrega automatizou a leitura da planilha e a consolidação dos cálculos em uma resposta que podia ser consumida por outro sistema.
Minha estimativa é que a automação tenha poupado cerca de um mês de trabalho manual por ano. Esse valor é uma estimativa retrospectiva, sem medição de horas ou confirmação do cliente.
A validação que recebi foi o retorno do cliente após o uso. Este relato não inclui uma revisão tributária independente.
Tecnologias
Python · pandas · NumPy