La API de Lengow te permite recuperar los pedidos realizados en los mercados y tomar medidas sobre estos pedidos. Actualmente, la API solo se refiere a los mercados y pedidos, no a los productos o catálogos.
¡Todo lo que necesitas saber sobre nuestra querida API de Lengow!
En esta página te ayudaremos a comenzar con nuestros casos de uso de la API y los conceptos clave explicados.
Por favor, ten en cuenta que ofrecemos una solución de plugin para my.lengow.io que puedes usar en lugar de nuestra API si tienes un back office en Prestashop, Magento, Shopify, Shopware o Woocommerce.
Antes de comenzar a conectarte a nuestra API necesitas para registrarte para una cuenta de Lengow. Esto te permitirá autenticarte y conectarte a la API.
Nuestra documentación técnica de la API está aquí.
La API de Lengow es una API basada en REST que te permite:
- Listar y recuperar los pedidos de tu cuenta
- Ejecutar acciones en los pedidos: aceptación, envío, cancelación y reembolso
- Mostrar la lista completa de posibles acciones de pedido autorizadas por cada mercado, en qué estado y con qué parámetros obligatorios u opcionales
- Recuperar documentos de factura
- Comunicarse con el almacén de Zalando
Consejos de Lengow:
A lo largo de esta guía te recomendamos que uses Postman para ayudarte a integrar y probar nuestra API.
Lengow no proporciona soporte en Postman.
El balanceador de carga entrante tiene un tiempo de espera de 350 segundos en el Keep-Alive. Si la solicitud es más larga que esto, se producirá un error de conexión debido a que la solicitud excede este límite.
Conceptos clave
Antes de comenzar, debes entender algunos conceptos centrales en la API:
- API
Una interfaz de programación de aplicaciones (API) es una interfaz informática que define las interacciones entre varios intermediarios de software.
Funciona en un principio de entrada y salida, es decir, se utiliza para enviar acciones y recuperar información entre dos sistemas.
La propia API define los tipos de llamadas a la acción y solicitudes que se pueden hacer, cómo hacerlas y el formato esperado que debe usarse para que funcione.
Más información aquí.
- Token de acceso
Para autenticarte necesitas obtener un token de acceso. Es un bloque de caracteres que contiene las credenciales de seguridad para una sesión de inicio de sesión e identifica al usuario (tú).
Ejemplo de token: "6b7280eb-e7d4-4b94-a829-7b3853a20126"
- Encabezado de autorización
>El encabezado de autorización contiene tus credenciales de autenticación. Una vez que tienes tu token, todas tus solicitudes de API necesitarán un encabezado de autorización.
- Punto final
La ubicación donde la API envía una solicitud y de donde emana la respuesta se conoce como un punto final.
- Paginación
Un ejemplo común para los parámetros de consulta es la paginación. Los recursos que devuelven listas de entidades están todos paginados. Para usar la paginación, el usuario especifica un parámetro de consulta de página con un número de página dado, un número entero no negativo. Cuando se omite, el valor predeterminado para la página es 1.
Ejemplo: /orders/?account_id=1&page=5&page_size=50
Parámetros de consulta (Filtrado)
Con el uso de parámetros de consulta, los usuarios pueden definir filtros adicionales que pueden limitar el número de entidades devueltas en la respuesta. Los usuarios pueden especificar opcionalmente los parámetros de consulta y combinarlos a voluntad. Los parámetros de consulta se agregan al final de una ruta de recurso.
El primer parámetro de consulta está prefijado por "?", todos los parámetros de consulta adicionales están separados por el símbolo "&".
Ejemplo: /orders/?account_id=1&marketplace=menlook
- Productos
Un producto es cualquier artículo que puede ser enviado desde Lengow a un canal. Generalmente se define por su código de numeración de artículos europeos (EAN), o por un ID único que elegiste y enriquecido con descripciones, imágenes y otros contenidos.
- Pedidos y artículos de pedido
Cuando un cliente compra uno o más artículos en un canal se crea un pedido. El pedido contiene uno o más artículos de pedido. Cada artículo de pedido contiene un ID único, cantidad, precio, referencia del cliente, etc...
- Otros conceptos y flujos
Un se crea cuando uno o más artículos de pedido son enviados al cliente, se crea una devolución cuando un cliente quiere devolver un artículo de pedido y una cancelación se utiliza para cancelar un pedido o artículo de pedido.
El proceso completo de pedidos con Lengow se describe aquí.