Introducción
Qué es la API e-commerce de Geor, qué permite hacer, en qué versión está y cómo se conecta con el ERP de cada empresa.
Qué es
La API e-commerce conecta una tienda online o una aplicación con el ERP de Geor. Con ella se puede:
- mostrar el catálogo de la empresa: productos, variantes, categorías y banners;
- gestionar la cuenta del cliente: registro, inicio de sesión, perfil, verificación, recuperación de contraseña y baja;
- llevar el carrito, calcular el envío y los cupones, y confirmar el pedido;
- consultar y anular los pedidos del cliente;
- guardar los datos del comprador: direcciones, facturación, destinatarios, tarjetas y favoritos.
Cada empresa tiene su propio catálogo, sus clientes y sus pedidos. La API siempre trabaja con los datos de una sola empresa.
Versión
| Versión de la API | v1, la que va en la dirección: /api/v1/ecommerce |
| Versión de esta documentación | 1.1.0, del 01/10/2026 |
Qué cambia en cada versión y cómo se versiona: versiones.
A quién va dirigida
A desarrolladores que construyen una tienda o una aplicación contra el ERP de una empresa que usa Geor.
Cómo se accede
| Acceso | Para qué |
|---|---|
| Sin token | El catálogo, los ajustes de la tienda y los datos públicos: países, textos legales, tipos de envío y métodos de pago |
| Token del cliente | Todo lo que hace el cliente con su cuenta: pedidos, pago y sus datos. Se obtiene al registrarse o iniciar sesión |
El carrito se identifica además con la cabecera user-ip-address, también antes de iniciar sesión. Los detalles están en autenticación.
Dirección de la API
Todas las rutas cuelgan de la dirección del ERP de la empresa:
https://<dominio-de-la-empresa>/api/v1/ecommerce
La empresa se identifica por el dominio: la misma ruta en dos dominios distintos devuelve los datos de dos empresas distintas.
La tienda tiene que estar publicada en el ERP. Si no lo está, el catálogo y el carrito responden 404 STORE_NOT_FOUND, o 503 STORE_PAUSED si la empresa la cerró un tiempo.
Cómo seguir
- Lee primeros pasos: autenticación, formato de las respuestas, errores y límites.
- Muestra los productos con el catálogo y los datos generales con tienda.
- Da de alta al cliente con cuenta.
- Monta la compra con compra: carrito, pago y pedidos.
- Guarda sus datos con datos del comprador.
Si programas con una IA (Claude, ChatGPT, Cursor o VS Code), conéctala al MCP de Geor y consultará esta documentación sola. Ver usar con tu IA.