Trabajando

Desenvolvimento de Middleware para Orquestração de Pagamentos com Split via Api Asaas

Publicado el 18 Diciembre, 2025 en Programación y Tecnología

Sobre este proyecto

Abierto

O projeto consiste no desenvolvimento de um sistema middleware simples, focado na orquestração de pagamentos com split utilizando a API do Asaas. O objetivo principal é otimizar o fluxo financeiro, evitando que o valor total das cobranças dos clientes transite pela conta da empresa, e permitindo que uma parte do pagamento seja direcionada diretamente para cuidadores/prestadores de serviço. Este split será configurado por valor fixo e suportará múltiplos cuidadores em uma única cobrança. É Importante ressaltar que este sistema não se destina a ser um ERP completo, um sistema financeiro abrangente ou a possuir um frontend complexo.

A fonte de dados para este middleware serão relatórios exportados em formato Excel, uma vez que o sistema atual não dispõe de uma API para integração direta.

Objetivos Principais:
- Criar e gerenciar subcontas/recebedores no Asaas, vinculando-os à conta mestre da empresa.
- Gerar cobranças (boleto, Pix, cartão de crédito) com funcionalidade de split automático.
- Suportar a inclusão de múltiplos recebedores em uma mesma cobrança.
- Operar exclusivamente com base em dados fornecidos por planilhas (CSV, Excel, Google Sheets).

Escopo Funcional (Obrigatório):
- Importação em massa de dados de cuidadores (que atuarão como recebedores).
- Funcionalidade de upload de planilhas (CSV/Excel/Sheets), onde cada linha representa um cuidador.
- Criação ou atualização de subcontas no Asaas via API, com o salvamento do 'walletId' retornado.
- Regras de processamento:
  - cpf/cnpj como chave única para identificação.
  - Idempotência para evitar duplicação de registros em execuções repetidas.
  - Processamento em lote (ex: 100 registros por vez) para otimização.
  - Registro detalhado de erros por linha para fácil auditoria.
- Campos esperados na planilha de cuidadores:
  - nome
  - cpf ou cnpj
  - email (pode ser catch-all)
  - telefone (pode repetir)
  - dados bancários: banco, agência, conta, tipo de conta
  - walletId (campo para armazenamento do retorno da API do Asaas)
  - status / erro (para feedback do processamento)

Não haverá necessidade de biometria ou qualquer ação manual por parte do cuidador neste processo.

Categoría Programación y Tecnología
Subcategoría Programación Web
¿Cuál es el alcance del proyecto? Cambio mediano

Plazo de Entrega: No definido

Habilidades necesarias

Otros proyectos publicados por M. R.