Desarrollo WordPress personalizado en Madrid

Cómo conecto WordPress con un ERP o un CRM desde Madrid: rutas REST con permisos, webhooks firmados, cola de trabajos con reintentos y RGPD en el intercambio de datos.

Desarrollo WordPress personalizado

Mi lugar en la comunidad WordPress

  • Tengo cuenta en wordpress.org desde 2006.
  • He contribuido al núcleo de WordPress en las versiones 7.0 y 7.1.
  • Mantengo 30 plugins en wordpress.org.
  • Organizo WordCamps y hablo en ellos como ponente.
  • He asistido a todas las WordCamp Europe de 2017 a 2026.

Mi perfil en WordPress.org

Soy Mariusz Szatkowski, desarrollador WordPress desde 2006, y trabajo solo, en remoto y por escrito. Esta página trata de una sola cosa: conectar un WordPress de una empresa de Madrid con su ERP o su CRM mediante la API REST y webhooks, sin que un pedido, un contacto o una factura dependan de que alguien copie datos a mano.

#Antes de escribir código: qué dato viaja y quién manda

Una integración falla casi siempre por una decisión que nadie escribió. Antes de abrir el editor te pido una lista, en una hoja de cálculo o en un correo:

PreguntaPor qué importa
¿Qué dato viaja (cliente, pedido, stock, factura, oportunidad)?Cada dato tiene su ruta en la API del ERP o del CRM.
¿En qué sentido?WordPress al ERP, ERP a WordPress o los dos.
¿Quién gana si dos sistemas cambian el mismo campo?Sin una regla escrita, el último en escribir pisa al otro.
¿Qué datos personales incluye?Define qué sale de WordPress y qué se queda.
¿Qué pasa si el otro sistema no responde?Define la cola y los reintentos.

Cada ERP y cada CRM publica su propia documentación de API, y es lo primero que leo. Holded, por ejemplo, anuncia en su portal de desarrolladores una API REST con JSON, autenticación con Bearer, paginación por cursor y webhooks. Odoo 19 documenta una API externa JSON-2 con clave de API en una cabecera Bearer, y indica en la misma página que el acceso depende del plan contratado. Que tu ERP tenga API, y bajo qué condiciones, se comprueba antes de acordar el alcance.

#Rutas REST propias con permisos

WordPress incluye una API REST, y para un intercambio con un sistema externo suelo añadir una ruta propia en lugar de reutilizar las de contenido. El REST API Handbook pide tres cosas que respeto siempre:

  • Un espacio de nombres propio con versión, por ejemplo erp-sync/v1, para que dos plugins no choquen y para poder subir a v2 sin romper al cliente.
  • Validación y saneado de cada argumento al registrar la ruta, de modo que el callback reciba datos ya comprobados.
  • Un permission_callback. Desde WordPress 5.5, si falta, el núcleo avisa con un _doing_it_wrong, y una ruta pública debe declararlo con __return_true. Mis rutas de integración nunca son públicas.

El manual añade un matiz que se olvida: comprueba capacidades con current_user_can, no solo si hay sesión. Autenticar es saber quién eres y autorizar es saber qué puedes hacer.

Monumento a Alfonso XII junto al estanque del parque del Retiro, Madrid

Foto: Carlos Delgado, CC BY-SA 3.0, Wikimedia Commons.

#Autenticación: cuentas técnicas, no tu usuario

Para que el ERP llame a WordPress hay varias vías, y las comparo así:

MétodoCuándo lo usoCuidado
Contraseñas de aplicación (WordPress 5.6 en adelante)Un sistema que llama a rutas de WordPress con Basic AuthEl manual indica que funcionan sobre https y se generan por usuario. Creo un usuario técnico con el rol mínimo, nunca el de un administrador.
Claves de consumidor de WooCommerceLeer o escribir pedidos y productos por wc/v3La documentación de la API de WooCommerce las ata a un usuario. Ese usuario debe tener acceso a los recursos que pedirá el ERP.
Firma del mensajeWebhooks entrantesNo identifica a un usuario, comprueba que el cuerpo viene de quien tiene el secreto.
Cookie con nonceSolo JavaScript dentro de WordPressNo sirve para un servidor externo.

Los secretos no van en la base de datos ni en el repositorio. Los guardo como constantes en wp-config.php o como variables de entorno del servidor, y los cambio si alguien que los conocía deja de trabajar contigo.

#Webhooks: recibir rápido, validar y soltar el trabajo

Un webhook es un aviso que un sistema envía a una URL tuya cuando algo cambia. La documentación de WooCommerce lo resume así: los eventos de un sitio invocan una acción en otro, por ejemplo al crear, editar o borrar pedidos, productos, cupones o clientes. Tres detalles de ese documento condicionan el diseño:

  • Al guardar por primera vez un webhook activo, WooCommerce envía un ping a la URL de entrega.
  • Un webhook se desactiva solo tras más de cinco fallos de entrega seguidos. Se cuenta como fallo cualquier respuesta que no sea 2xx, 301 o 302. Si tu endpoint devuelve un 500 durante una tarde, el aviso se apaga y nadie se entera.
  • Cada entrega queda registrada en webhooks-delivery dentro de WooCommerce, Estado, Registros.

El código de WooCommerce en GitHub (class-wc-webhook.php) muestra cómo firma: añade la cabecera X-WC-Webhook-Signature con el HMAC SHA-256 del cuerpo en base64, usando el secreto del webhook, y también X-WC-Webhook-ID y X-WC-Webhook-Delivery-ID. Un ERP que envía a WordPress suele tener su propio esquema, así que adapto la comprobación a lo que documente. La estructura es siempre la misma, y este es el esqueleto mínimo de un receptor:

add_action( 'rest_api_init', function () {
	register_rest_route( 'erp-sync/v1', '/eventos', array(
		'methods'             => 'POST',
		'callback'            => 'erp_sync_recibir',
		'permission_callback' => 'erp_sync_firma_valida',
	) );
} );

function erp_sync_firma_valida( WP_REST_Request $request ) {
	$recibida = (string) $request->get_header( 'x-signature' );
	$esperada = hash_hmac( 'sha256', $request->get_body(), ERP_SYNC_SECRET );
	return hash_equals( $esperada, $recibida );
}

function erp_sync_recibir( WP_REST_Request $request ) {
	$evento = $request->get_json_params();
	as_enqueue_async_action( 'erp_sync_procesar', array( 'evento' => $evento ), 'erp-sync' );
	return new WP_REST_Response( null, 202 );
}

El nombre de la cabecera y el formato de la firma (hexadecimal o base64) dependen del ERP, y el secreto vive en wp-config.php. Lo importante es el orden: primero se comprueba la firma con hash_equals, que compara sin filtrar información por tiempo, luego se encola y se responde con un 202. El proceso pesado no corre dentro de la petición.

#Enviar datos al ERP: la cola, no la petición del cliente

La tentación es llamar al ERP desde el mismo hook que guarda el pedido. Es lo que más daño hace. Según su referencia, wp_remote_post toma por defecto un tiempo máximo de 5 segundos, y un ERP lento convierte cada compra en una espera para el cliente, o en un error si se agota.

Mi patrón es otro. El pedido se guarda en WordPress y se encola un trabajo. Action Scheduler, la librería de colas que usa WooCommerce, lo ejecuta en segundo plano. Su documentación describe lo que importa aquí:

  • Guarda el hook, los argumentos y la fecha de cada acción, y las acciones asíncronas son las que se ejecutan lo antes posible.
  • Se activa cada minuto mediante WP-Cron, y procesa lotes de 25 acciones hasta agotar el tiempo o la memoria disponibles.
  • Registra cuándo se creó, empezó, terminó o falló cada acción, con el error si se pudo capturar, y lo muestra en el administrador.

Si el ERP responde con un error, el trabajo falla con una excepción y yo programo otro intento con as_schedule_single_action. Si responde con un 4xx por un dato mal formado, reintentar no sirve, así que el trabajo se marca como fallido con el motivo y aparece en una pantalla de WordPress para que alguien lo corrija y lo relance. Distinguir un error pasajero de uno permanente es la parte de la integración que más se nota con el uso diario.

#Idempotencia: el mismo mensaje dos veces

Los webhooks y los reintentos hacen que un mismo evento llegue más de una vez. Para que no se duplique un cliente o una factura:

  1. Cada evento se guarda con su identificador y se ignora si ya consta como procesado.
  2. Las altas usan una clave del sistema externo (el identificador del cliente en el CRM, por ejemplo) y actualizan si ya existe.
  3. La última modificación se compara antes de sobrescribir, para que un evento antiguo que llega tarde no deshaga uno reciente.

No doy por hecho que el orden de llegada sea el de los hechos. Es una regla que escribo en el alcance, porque cambia cuánto trabajo lleva la integración.

#Datos personales: qué sale de WordPress y con qué base

Un CRM guarda personas, y un ERP también. El RGPD, en su texto consolidado que publica el BOE, da tres puntos de apoyo para una integración:

  • El artículo 5.1 c) pide datos adecuados, pertinentes y limitados a lo necesario. Mando al CRM los campos que el flujo usa, no la ficha completa del usuario de WordPress.
  • El artículo 28 obliga a que el tratamiento por un encargado se regule en un contrato u otro acto jurídico, que fija objeto, duración, naturaleza, tipo de datos y que el encargado actúe solo con instrucciones documentadas. Es el contrato con tu proveedor de CRM o de ERP, y suele estar en sus condiciones.
  • El artículo 32 pide medidas técnicas y organizativas adecuadas al riesgo. Aquí entran las cuentas técnicas con permisos mínimos, https, la firma de los mensajes y no dejar secretos a la vista.

Si el proveedor trata datos fuera del Espacio Económico Europeo, el capítulo V del RGPD (desde el artículo 44) fija las condiciones de la transferencia. Esa comprobación la haces tú con tu proveedor, y yo la dejo anotada en el alcance. Tu registro de actividades del artículo 30 debería reflejar que el CRM o el ERP existe como destino de los datos.

#Cómo llevo un proyecto de integración

Es un trabajo por escrito, sin reuniones ni llamadas, y el diseño de pantallas, si las hay, lo aportas tú.

  1. Me envías la lista de datos de arriba, la documentación de la API del ERP o CRM y un usuario de pruebas.
  2. Te devuelvo preguntas por escrito y, con las respuestas, un alcance con supuestos y exclusiones.
  3. Trabajo en un entorno de staging con datos ficticios y pruebo tres casos: todo bien, el ERP caído y el mismo evento recibido dos veces.
  4. Te entrego el código en un repositorio Git, con una nota que explica qué ruta hace qué, dónde están los secretos y cómo relanzar un fallo.
  5. Si quieres, el mantenimiento posterior se acuerda aparte, y como consejo conviene revisar la integración tras cada actualización grande de WordPress, de WooCommerce o de la API del ERP.

#Qué necesito de tu lado

  • La dirección de tu web y el ERP o CRM que usas, con su versión.
  • Acceso de pruebas al ERP o CRM y a la documentación de su API.
  • La lista de datos y la regla de quién manda en cada campo.
  • Quién en tu empresa puede responder sobre cómo se factura y cómo se numera.

Si la integración afecta a una tienda, mira también WooCommerce con ERP y mi página de WooCommerce en Madrid.

#Preguntas frecuentes

#¿Mejor webhooks o consultar la API cada cierto tiempo?

Los webhooks avisan en cuanto ocurre el cambio y evitan peticiones inútiles. Aun así los combino con una consulta de repaso, porque un webhook perdido no se reenvía solo y la consulta detecta lo que faltó.

#¿Cómo sé que un webhook viene de mi ERP y no de un tercero?

Comprobando una firma. WooCommerce, por ejemplo, firma el cuerpo con HMAC SHA-256 en base64. Mi endpoint calcula la misma firma con el secreto compartido y la compara con hash_equals antes de hacer nada.

#¿Qué pasa si el ERP está caído cuando WordPress le envía un pedido?

El pedido ya está guardado en WordPress y el envío queda en una cola. Se reintenta más tarde y, si sigue fallando, aparece en una pantalla de errores para relanzarlo a mano.

#¿Puede un pedido llegar dos veces al ERP?

Puede, porque los sistemas reintentan. Por eso cada mensaje lleva un identificador y el receptor ignora el que ya procesó.

#¿Necesito un contrato de encargado del tratamiento con mi proveedor de CRM?

Si el CRM trata datos personales por tu cuenta, el artículo 28 del RGPD exige un contrato o acto jurídico que lo regule. Suele venir en las condiciones del proveedor, pero conviene leerlo.

#¿Hace falta un plugin de integración ya hecho?

Si un conector del propio proveedor cubre tus flujos, es la opción más sencilla y te lo digo. El código propio compensa cuando tus reglas de campos, estados o series de facturación no caben en el conector.

#Escríbeme con tu ERP o tu CRM

Si quieres conectar WordPress con tu ERP o tu CRM, mándame tu caso desde la página de contacto. Me sirven la dirección de tu web, el nombre y la versión del ERP o del CRM, qué datos deben viajar y en qué sentido, y la fecha a la que quieres llegar. Con esos datos te envío una primera estimación por escrito, gratuita, y te hago por escrito las preguntas que falten.

¿Buscas el servicio: Desarrollo WordPress personalizado en Madrid?

Describe tu proyecto por e-mail. Respondo en 48 horas.

Describe tu proyecto

Explora otros servicios WordPress y base de conocimiento