Primeros Pasos (ES)
Aquí encontrará ejemplos y una lista detallada de puntos finales que le permitirá integrar WoowUp con los sistemas que utiliza via API.
Last updated
Was this helpful?
Aquí encontrará ejemplos y una lista detallada de puntos finales que le permitirá integrar WoowUp con los sistemas que utiliza via API.
Last updated
Was this helpful?
Esta es una API de estilo REST que utiliza JSON para la serialización.
Para comenzar a utilizar la API necesitará:
Inicie sesión en WoowUp y obtenga su clave API en la sección Configuración / Mi cuenta.
Lea los documentos de la API para comprender lo que puede hacer.
La API está limitada a 10 peticiones / segundo. Si superas este límite, recibirás una excepción.
Toda solicitud recibe y devuelve datos en formato JSON.
Recuerde incluir en el header Basic Authentication al llamar a cualquier endpoint. encontrarás cómo hacerlo.
Para identificar a un cliente use el campo "service_uid". Normalmente, usará el correo electrónico o la ID (DNI, CPF, RUT, Pasaporte) para identificar al cliente.
Cada vez que vaya a usar service_uid como parte de la URL, primero deberá codificarlo con base64 y luego con URL encode. Puedes leer aquí una explicación detallada .
Los formatos de fecha válidos son: AAAA-mm-dd HH: mm: ss (predeterminado en UTC) o formato ISO 8601 que incluye la zona horaria Ej .: 2004-02-12T15: 19: 21 + 03: 00
Normalmente, incluirá toda la Información del producto (sku, título, categoría, stock, etc.) en el punto final de Crear pedido de compra. Pero si lo prefiere, hay un endpoint específico para sincronizar .
Antes de enviar una orden de compra, debe crear el cliente si no existe. En el ejemplo, puede ver cómo funciona este proceso en el archivo "import_from_csv.php".
Por favor, preste atención a los mensajes de las respuestas de nuestra API porque le informaremos si algo está mal con sus solicitudes o con la información que envía.
En cualquier llamada a la API, debe enviar el API Key en la cadena de consulta como un parámetro.
Por ejemplo, si su API Key es 'abcdefghijklmnopqrstuvwxyz', debe hacer una solicitud para
Otro método, y el recomendado, es a través del encabezado de autenticación, en cada llamada debe enviar el encabezado
Cuando estás haciendo una búsqueda, paginamos los resultados. En todos los puntos finales paginados, los parámetros de la paginación son:
Parameter
Description
Default
limit
Items per page returned. Max: 100
25
page
Number of the page. First page is 0
0
Todos los endpoints devuelven datos en formato JSON, con el encabezado:
Para un uso correcto tienes que enviar en todas las solicitudes el encabezado
Cuando intenta encontrar un usuario, puede identificarlo por su id o su service_uid (comúnmente es el correo electrónico), cuando usa service_uid debe codificar esto en Base64 y codificar el resultado como URL seguro, por ejemplo, si necesita hacer esto en php:
Cómo empezar a enviarnos sus pedidos de compra En el siguiente enlace encontrará un ejemplo completamente funcional en PHP que procesa un archivo CSV con pedidos y clientes y utiliza la API para enviarlos a WoowUp: