---
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-06-19T19:59:51.42746+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 (50 a 200 USD al mes), 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. Para pyme argentina con más de 500 pagos al mes, el sistema propio amortiza en menos de 18 meses.

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 manejás 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 | 50 a 200 USD | 50 a 150 USD pass through |
| 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 distribuidora multi país con 100 franquicias necesitaba write back desde su sistema Catalizadora hacia un ERP central. Catalizadora implementó:

- Outbox queue en Postgres con idempotency_key UUID por transacción
- Trigger en app.leads on INSERT BOOKED genera fila en outbox.cierres_venta
- 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 de 30 minutos, 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 por 15,000 USD. Código a tu nombre.
- Para pymes muy pequeñas que solo necesitan ecommerce, CRM y cobros listos, [MAGIA Solo](https://catalizadora.ai/magia/solo) cubre desde 4,500 USD en 15 días.
## 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 Tango o Bejerman: 50 a 200 USD al mes. Desarrollo a medida: 4,000 a 10,000 USD una sola vez con propiedad total. Operación cloud 50 a 150 USD al 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í el sistema propio amortiza en menos de 18 meses.


---

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