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écnicaQué 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
- Solicita el acceso. Cuéntanos qué sistema quieres conectar con Emove.
- Conecta tu sistema. Te facilitamos el acceso y la guía para tu equipo.
- Haz una prueba. Comprueba que todo funciona antes de hacer tu primer pedido.
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 | /catalogo | Productos, variantes y cambios |
| POST | /stock/consultas | Disponibilidad aproximada por lote |
| POST | /precios/consultas | Tarifa neta para SKU y cantidad |
| GET | /pedidos/{id} | Estado y seguimiento de tus pedidos |
| POST | /pedidos/{id}/solicitudes-anulacion | Solicitar 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.
Catálogo
Devuelve productos, variantes, SKU, EAN, fotos y categorías. Usa limite (hasta 100) y pasa siguiente_cursor como cursor hasta que sea nulo.
Para actualizar el catálogo usa desde en UTC. Cuando recibas estado: retirado para un ID guardado, retíralo de tu catálogo. Una descarga completa periódica cubre los borrados definitivos.
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"
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écnicoErrores y límites
| HTTP | Acción |
|---|---|
| 400 | Corrige los datos de entrada. |
| 401 / 403 | Comprueba la clave, sus permisos y su IP autorizada. |
| 404 | Comprueba el recurso solicitado. |
| 409 | Revisa el motivo indicado en el mensaje. |
| 429 | Espera los segundos de Retry-After. |
| 503 | Reintenta 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.