Una integración ERP funciona cuando propiedad e identificadores están claros. El transporte es secundario. Decida qué sistema crea listas, quién asigna clientes, si las actualizaciones sustituyen o modifican y cómo un error evita que un precio incorrecto llegue al checkout.
Interfaz según el patrón
| Interfaz | Uso adecuado | Característica |
|---|---|---|
| CSV Import/Export | Lotes programados, migración y revisión | Archivo legible con listas, productos, clientes y grupos |
| SOAP/REST | Actualizaciones por eventos y middleware | Operaciones individuales y masivas |
| GraphQL | Lecturas headless o de integración | Consultas filtradas de listas y relaciones |
El módulo GraphQL actual ofrece consultas, no mutaciones de listas. Para escribir desde otro sistema utilice CSV o SOAP/REST.
Identificadores estables
Utilice el SKU Magento para productos. Defina un nombre externo duradero o mapeo por lista. El correo del cliente y el nombre de grupo son cómodos en archivos, pero pueden cambiar. En instalaciones multisitio el ámbito debe ser explícito.
No cree silenciosamente otra lista por diferencias de espacios o mayúsculas. Decida si el ERP envía una ID inmutable, Magento guarda un mapeo o el nombre es la clave contractual.
Carga completa o incremental
La carga completa se reconcilia fácilmente porque entrega el estado deseado, pero puede ser costosa y retirar datos válidos si se aplica mal. El delta es menor, aunque exige reglas fiables para crear, modificar, borrar y reintentar.
Para un nuevo contrato suele ser más seguro crear otra lista fechada que editar la activa. Puede revisarse antes de su entrada en vigor.
Validar antes de activar
Compruebe identidad, sitio, periodo, SKU, cantidad, tipo de cálculo, valor, cliente o grupo y duplicados. Rechace fechas imposibles y relaciones desconocidas. El informe de fallos debe ser comprensible para operaciones.
Secuencia de despliegue
- Guardar o exportar el estado actual.
- Cargar una muestra en staging.
- Comparar precios esperados y calculados con clientes reales.
- Probar reintentos y una fila inválida.
- Cargar todo fuera del periodo de mayor actividad.
- Calentar caché y revisar tienda, carrito, checkout y pedidos.
- Conservar archivo o carga anterior para volver atrás.
Lecturas relacionadas
Última revisión: 9 de agosto de 2026.