Skip to content

Latest commit

 

History

History
97 lines (77 loc) · 6.38 KB

README.md

File metadata and controls

97 lines (77 loc) · 6.38 KB
Raw

Preprocesador de reportes de conciliación de Mercado Pago

Este proyecto transforma el reporte de liquidaciones de Mercado Pago a uno más similar a los extractos bancarios tradicionales, con el propósito de permitir la importación en programas de conciliación no diseñados específicamente para MP (como, por ejemplo, Odoo).

Actualmente está optimizado para el caso de uso de empresas que reciben y envían transferencias. Puede no tener toda la funcionalidad necesaria para empresas que venden por Mercado Libre.

Específicamente, hace lo siguiente:

  • Elimina las filas de saldo inicial, total de movimientos, reserve for payout (y cualquier otra sin EXTERNAL_REFERENCE)
  • Cambia el formato de la columna DATE para eliminar el huso horario y las fracciones de segundo
  • Traduce algunos términos de la columna DESCRIPTION,
  • Toma las columnas TAXES_DISAGGREGATED y MP_FEE_AMOUNT y las coloca en filas nuevas.

Por ejemplo, transforma:

DATE SOURCE_ID EXTERNAL_REFERENCE RECORD_TYPE DESCRIPTION GROSS_AMOUNT MP_FEE_AMOUNT TAXES_DISAGGREGATED BALANCE
2024-10-01T00:00:00.000-03:00 initial_available_balance 0
2024-10-01T00:00:00.000-03:00 95932048395 3670377883134 release payment 100000 -1000 [{financial_entity":"debitos_creditos", "amount": "-3000", "detail": "tax_withholding_collector"}]" 96000
2024-10-01T13:00:00.000-03:00 89344433513 release reserve_for_payout -96000 [] 0
2024-10-01T13:00:01.000-03:00 89344433513 release reserve_for_payout 96000 [] 96000
2024-10-01T13:00:01.000-03:00 89344433513 LEORZG90K0R84X0P9EGJ46 release payout -96000 [] 0
total 4000 -1000 0

En:

DATE SOURCE_ID EXTERNAL_REFERENCE RECORD_TYPE DESCRIPTION GROSS_AMOUNT BALANCE
2024-10-01 00:00:00 95932048395 3670377883134 release Transferencia recibida 100000 100000
2024-10-01 00:00:00 95932048395_tax0 3670377883134 release Impuesto debitos creditos (tax withholding collector) -3000 97000
2024-10-01 00:00:00 95932048395_fee 3670377883134 release Comisión + IVA -1000 96000
2024-10-01 13:00:01 89344433513 LEORZG90K0R84X0P9EGJ46 release Transferencia enviada -96000 0

Para evitar problemas, se recomienda generar el reporte con todas las columnas y en inglés.

Desarrollo y extensión

Cualquier extensión a este proyecto debe hacerse en un fork. No se aceptan PRs o Issues.

Recomendamos hacer deploy a GitHub Pages con la acción incluida (en .github/workflows) y apuntar un dominio o subdominio a la misma. Si no se desea hacer esto último (es decir, se prefiere acceder desde usuario.github.io/repo/preprocesador_mp), hay que modificar vite.config.js siguiendo esta documentacion.

Para agregar funcionalidad, se recomienda agregar funciones que modifiquen elementos de una fila a la lista updateRules y funciones que transformen columnas en nuevas filas al diccionario transposeRules. Ambos están definidos en PreprocessorWorker.js.

Por ejemplo, para consolidar las columnas DESCRIPTION, PAYER_NAME, PAYER_ID_TYPE y PAYER_ID_NUMBER, se debería agregar el siguiente elemento a updateRules:

// Reglas que modifican filas.
const updateRules = [
    [...],
    consolidateColumns
]

function consolidateColumns(row) {
    row['DESCRIPTION'] = `${row['DESCRIPTION']} ${row['PAYER_NAME']} ${row['PAYER_ID_TYPE']} ${row['PAYER_ID_NUMBER']}`
    delete row['PAYER_NAME']
    delete row['PAYER_ID_TYPE']
    delete row['PAYER_ID_NUMBER']
}

Y para agregar una regla que transforme la columna FINANCING_FEE_AMOUNT en filas, habría que agregar el siguiente elemento a transposeRules:

// Reglas que transforman columnas en filas. El key es el nombre de la columna a transponer.
// originalRow: Fila antes de aplicarle updateRules
// updatedRow: Fila después de aplicarle updateRules
// Ambas son necesarias porque updateRules puede eliminar columnas necesarias para las nuevas filas.
const transposeRules = {
    [...],

    FINANCING_FEE_AMOUNT: (originalRow, updatedRow) => {
        let rows = []
        const fee = parseFloat(originalRow['FINANCING_FEE_AMOUNT'])

        if (fee !== 0) {
            let newRow = structuredClone(updatedRow)
            newRow['SOURCE_ID'] += "_financing_fee"
            newRow['GROSS_AMOUNT'] = fee
            newRow['DESCRIPTION'] = "Comisión por ofrecer cuotas sin interés"

            rows.push(newRow)
        }

        return rows
    },
}