Conecta tu negocio con Emove API

Ten a mano el catálogo de Emove, la disponibilidad y tus precios en la tienda online o el programa de gestión que ya utilizas.

Ir a la documentación técnica

Qué puedes hacer con la API

  • Catálogo

    Mantén tu tienda al día con los productos y las fotos de Emove.

  • Disponibilidad

    Consulta en tiempo real qué productos están disponibles y actualiza el stock en tu sistema.

  • Tu tarifa profesional

    Consulta los precios que tienes como cliente de Emove.

  • Pedidos

    Consulta el total antes de comprar y haz tus pedidos desde tu propio sistema.

  • Seguimiento y anulaciones

    Sigue tus envíos y solicita una anulación si la necesitas.

  • Pagos

    Paga tus pedidos con las opciones disponibles para tu cuenta.

Cómo empezar

  1. Solicita el acceso. Cuéntanos qué sistema quieres conectar con Emove.
  2. Conecta tu sistema. Te facilitamos el acceso y la guía para tu equipo.
  3. Haz una prueba. Comprueba que todo funciona antes de hacer tu primer pedido.
Contactar con soporte técnico

Documentación técnica de Emove API

Inicio rápido

URL base https://emovedistribution.com/wp-json/emove-api/v1

Ejemplo de petición · cURL

curl -X GET "https://emovedistribution.com/wp-json/emove-api/v1/catalogo?limite=5" \
  -H "Authorization: Bearer <TU_CLAVE>" \
  -H "User-Agent: TuERP/1.0"

Operaciones disponibles

GET/catalogoProductos, variantes y cambios
POST/stock/consultasDisponibilidad aproximada por lote
POST/precios/consultasTarifa neta para SKU y cantidad
GET/pedidos/{id}Estado y seguimiento de tus pedidos
POST/pedidos/{id}/solicitudes-anulacionSolicitar una anulación

Autenticación

Envía Authorization: Bearer <TU_CLAVE> en cada petición HTTPS y usa un User-Agent que identifique tu integración.

El enlace para recoger la clave caduca a las 48 horas. Guarda la clave en el servidor de tu integración.

Stock aproximado

Envía hasta 100 SKU en skus. La respuesta indica 0 para agotado, de 1 a 9 unidades, o 100 cuando hay 10 o más.

curl -X POST "https://emovedistribution.com/wp-json/emove-api/v1/stock/consultas" \
  -H "Authorization: Bearer <TU_CLAVE>" \
  -H "User-Agent: TuERP/1.0" \
  -H "Content-Type: application/json" \
  -d '{"skus":["SKU-DEMO-01"]}'

Precios por cuenta

Envía articulos con sku y cantidad. La respuesta incluye el precio_unitario_neto aplicable a tu cuenta y la moneda. Los importes se devuelven como texto decimal.

curl -X POST "https://emovedistribution.com/wp-json/emove-api/v1/precios/consultas" \
  -H "Authorization: Bearer <TU_CLAVE>" \
  -H "User-Agent: TuERP/1.0" \
  -H "Content-Type: application/json" \
  -d '{"articulos":[{"sku":"SKU-DEMO-01","cantidad":1}]}'

Consultar pedidos

Consulta GET /pedidos/{id} con el identificador de tu pedido. La respuesta incluye el estado y, cuando está disponible, el seguimiento.

curl -X GET "https://emovedistribution.com/wp-json/emove-api/v1/pedidos/100000" \
  -H "Authorization: Bearer <TU_CLAVE>" \
  -H "User-Agent: TuERP/1.0"

Solicitar anulación

Envía el motivo para solicitar la anulación. Emove revisará la solicitud en producción.

curl -X POST "https://emovedistribution.com/wp-json/emove-api/v1/pedidos/100000/solicitudes-anulacion" \
  -H "Authorization: Bearer <TU_CLAVE>" \
  -H "User-Agent: TuERP/1.0" \
  -H "Content-Type: application/json" \
  -d '{"motivo":"Solicito anular el pedido"}'

Integración de pedidos y pagos

Si quieres realizar pedidos desde tu sistema o conocer los métodos de pago disponibles para tu cuenta, contacta con nuestro soporte técnico. Te indicaremos cómo habilitar la integración y te facilitaremos su documentación.

Consultar con soporte técnico

Errores y límites

HTTPAcción
400Corrige los datos de entrada.
401 / 403Comprueba la clave, sus permisos y su IP autorizada.
404Comprueba el recurso solicitado.
409Revisa el motivo indicado en el mensaje.
429Espera los segundos de Retry-After.
503Reintenta tras unos instantes.

Por minuto se permiten 120 peticiones por clave y 300 por cuenta y entorno. El catálogo admite 12 por clave y 24 por cuenta. Las peticiones admiten hasta 64 KiB.