---
title: "Integrar Mercado Pago con ERP argentino paso a paso 2026"
description: "Guía paso a paso 2026 para integrar Mercado Pago con tu ERP en Argentina: webhooks, conciliación bancaria, AFIP y desarrollo a medida con outbox."
slug: "integrar-mercadopago-con-erp-argentino-paso-a-paso"
url: "https://catalizadora.ai/blog/integrar-mercadopago-con-erp-argentino-paso-a-paso"
cluster: "datos-sistemas/integrar-mercadopago-erp"
author: "Pablo Estrada"
published_at: "2026-05-11T12:00:00+00:00"
updated_at: "2026-11-21T02:58:45.264011+00:00"
read_minutes: "5"
lang: "es"
---
# Integrar Mercado Pago con ERP argentino paso a paso 2026

> Guía paso a paso 2026 para integrar Mercado Pago con tu ERP en Argentina: webhooks, conciliación bancaria, AFIP y desarrollo a medida con outbox.

Integrar Mercado Pago con un ERP argentino en 2026 se hace por tres vías: middleware tipo Zapier o Make (20 a 60 USD al mes), conector partner para Tango Gestión, Bejerman, Holistor o Calipso, o desarrollo a medida con webhook handling, conciliación bancaria, timbrado AFIP nativo y outbox pattern para idempotency. El patrón correcto es: webhook de Mercado Pago llega a queue persistente, worker procesa con idempotency_key, registra movimiento en el ERP, timbra factura electrónica AFIP y guarda audit log append only.

Si eres COO, CFO o jefe de sistemas de pyme argentina con Mercado Pago como pasarela principal y necesitas que tu ERP refleje cada pago sin doble digitación, esta guía te lleva paso a paso.

## Paso 1: Configurar webhooks en Mercado Pago

Mercado Pago expone API REST en api.mercadopago.com y webhooks bajo el nombre Notificaciones IPN o Webhooks. En tu Dashboard de Mercado Pago vas a Tu negocio luego Configuración luego Notificaciones, y registras tu URL pública.

Eventos clave para integrar con ERP:

- payment.created cuando se crea un pago nuevo
- payment.updated cuando cambia estado (approved, rejected, refunded, charged_back)
- merchant_order.updated para órdenes con múltiples pagos
- plan.updated y subscription.updated si manejas suscripciones

URL típica: https://tu-api.com/webhooks/mercadopago. Mercado Pago manda POST con JSON `{"id": "123456", "topic": "payment"}`. Tu API debe responder 200 OK en menos de 22 segundos o Mercado Pago reintenta.

## Paso 2: Implementar handler idempotente

El handler correcto sigue el patrón outbox:

1. Validar firma del webhook con tu access_token
2. Llamar a la API de Mercado Pago para traer el detalle del pago (GET /v1/payments con el id)
3. Insertar en tabla outbox.payments con idempotency_key = payment.id
4. Responder 200 OK al webhook
5. Worker asincrónico procesa outbox, registra en ERP, timbra AFIP

Sin idempotency, Mercado Pago puede mandar el mismo webhook 2 a 3 veces y tu ERP termina con pagos duplicados.

## Paso 3: Registrar movimiento en el ERP argentino

Cada ERP argentino tiene su API:

| ERP | API | Endpoint típico |
|---|---|---|
| Tango Gestión | Servicio web SOAP local | localhost:8080/tango |
| Bejerman | REST API limitada | api.bejerman.com.ar |
| Holistor | REST API | api.holistor.com |
| Calipso | REST API moderno | api.calipso.com |
| Odoo Argentina | XML-RPC o REST | tu-odoo.com/web/api |

Tu worker llama al endpoint correspondiente con el payload del movimiento (cuenta contable, importe, fecha, referencia Mercado Pago). El ERP responde con ID del movimiento. Guardas ese ID en tu base intermedia para conciliación posterior.

## Paso 4: Timbrar AFIP con WSFEv1

Cuando el pago es de un cliente final, necesitas factura electrónica AFIP. El worker:

1. Obtiene Token Authorization (TA) vigente desde WSAA
2. Arma comprobante WSFEv1 con datos del receptor y del pago
3. Llama a FECAESolicitar
4. AFIP devuelve CAE
5. Guarda CAE en tu base junto al ID Mercado Pago y al ID ERP

Si AFIP cae (es frecuente fin de mes), reintenta exponencial cada 15 minutos hasta que responda. El cliente final recibe recibo provisorio en checkout y factura AFIP por email cuando AFIP responda.

## Paso 5: Conciliar pagos con tu cuenta bancaria

Mercado Pago liquida a tu CBU en T+10 o T+14 según tu cuenta (estándar o Money). La conciliación correcta:

1. Pull diario de la API Mercado Pago de liquidaciones (GET /v1/account/settlements)
2. Cruzar contra extracto bancario (CBU vía Open Banking o archivo manual)
3. Confirmar que cada lote Mercado Pago coincide con depósito bancario
4. Si hay desfase, alertar al equipo financiero
5. Registrar liquidación en cuenta contable de Mercado Pago

Sin este paso, tu balance ERP muestra pagos pero tu banco no, y el contador pasa días al mes cuadrando.

## Tabla comparativa rápida

| Criterio | Zapier | Conector partner | A medida |
|---|---|---|---|
| Costo mensual | 20 a 60 USD | Según el proveedor | Según el proyecto |
| Idempotency | Limitada | Vía proveedor | Total (UUID propio) |
| Timbrado AFIP | Paso extra | Incluido normalmente | Incluido |
| Conciliación bancaria | No | Parcial | Total |
| Multi canal | No | Limitado | Total |
| Dueño del código | Zapier | Proveedor | Tú, 100 por ciento |

## El caso real: outbox pattern con write back

Una red de franquicias necesitaba write back desde su sistema hacia un ERP central. Catalizadora implementó:

- Outbox queue en Postgres con idempotency_key UUID por transacción
- Un trigger que, al quedar agendada una venta, genera una fila en la cola de salida
- Worker Python con retry exponencial (1s, 2s, 4s) llama a la API del ERP
- Audit log append only registra cada intento, éxito o fallo
- CDC (Change Data Capture) vía replicación lógica para histórico

Resultado: cero pérdida de transacciones, idempotency garantizada, reintentos automáticos sin intervención humana. Exactamente el patrón que necesita una integración Mercado Pago a ERP argentino seria.

## Lo que NO debes hacer

Tres errores típicos:

1. Procesar el webhook sincrónico dentro del handler: si tu ERP tarda, Mercado Pago da timeout y reintenta, duplicando pagos
2. Sin idempotency_key: te duplica entre 2 y 5 por ciento de pagos al mes
3. Saltarte conciliación bancaria: tu ERP miente sobre cuánto dinero realmente entró a tu cuenta

## Próximos pasos

Si recién arrancas tu integración Mercado Pago a ERP en Argentina, un Zap o conector partner cubre los primeros meses. Cuando ya cruzas 500 pagos al mes o necesitas multi canal con AFIP automático, vale la pena construir el flujo propio.

Catalizadora arma el diagnóstico en una llamada sin pitch deck, conversación real sobre tu operación.

- [MAGIA Core](https://catalizadora.ai/magia/core) construye sistemas a medida con Mercado Pago, AFIP, ERP y conciliación bancaria en 12 semanas, con el precio en su página. El código, los datos y el dominio quedan a tu nombre.
- Si vendes productos y quieres tu tienda completa, en tu dominio y dentro de WhatsApp, con un vendedor que atiende y cobra solo, el camino es [MAGIA Commerce](https://catalizadora.ai/magia/commerce).
## Preguntas frecuentes

### ¿Mercado Pago tiene integración nativa con Tango Gestión o Bejerman?

No directamente. Mercado Pago expone API REST y webhooks. Tango Gestión, Bejerman, Holistor o Calipso reciben pagos vía middleware (Zapier, conector partner) o vía desarrollo a medida que escucha webhooks de Mercado Pago y registra movimientos en el ERP.

### ¿Cómo conciliar Mercado Pago con AFIP automático?

Webhook Mercado Pago (payment.created, payment.updated) dispara llamada al webservice WSFEv1 de AFIP para timbrar factura electrónica. CAE devuelto se guarda en el ERP junto al ID de Mercado Pago. Sin este flujo, tu contador concilia manual cada mes.

### ¿Cuánto cuesta integrar Mercado Pago con un ERP argentino?

Vía Zapier o Make: 20 a 60 USD al mes. Conector partner para Tango o Bejerman: según el proveedor. Desarrollo a medida: según el alcance, con el código a tu nombre, más la operación en la nube cada mes.

### ¿Qué pasa con reversos y contracargos?

Mercado Pago dispara webhook payment.updated cuando hay refund o chargeback. Una integración seria registra movimiento contable inverso en el ERP, timbra nota de crédito AFIP y notifica al equipo. Si lo haces a mano, tu balance se desfasa cada semana.

### ¿Cuándo migrar de middleware a desarrollo a medida?

Cuando superas 500 pagos al mes con Mercado Pago, tienes múltiples canales (ecommerce más físico más bot WhatsApp), o tu contador pasa más de 8 horas al mes reconciliando. Ahí conviene pasar a desarrollo a medida.


---

Source: https://catalizadora.ai/blog/integrar-mercadopago-con-erp-argentino-paso-a-paso
Author: Pablo Estrada — AI Catalysts, LLC (catalizadora.ai)
