← Voltar aos projetos

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.

Minha contribuiçãoDesenvolvimento da API e processamento dos dados
TecnologiasPython · pandas · NumPy
Fluxo ilustrativoDa planilha ao resultado por ação
  1. Planilha

    Operações em inglês ou ucraniano.

  2. Organização

    Compras e vendas agrupadas por ação.

  3. Cálculo

    Pareamento pelas compras mais antigas.

  4. 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

← Voltar aos projetos

PROJETOS E OPORTUNIDADES

Vamos conversar?

Estou disponível para projetos freelance e para integrar uma equipe de desenvolvimento.

Entre em contato