WooCommerce API Python. Breve guía para principiantes

Si tienes una tienda online que está desarrollada en WordPress con WooCommerce, es probable que en algún momento hayas tenido que exportar datos para algún reporte o para conocer el detalle de tus pedidos. En este artículo, vamos a ver unas nociones básicas de la WooCommerce API Python para principiantes y podrás descargar dos plantillas para extraer tus datos.

1. La API de WooCommerce

La API de WooCommerce para Python cuenta con una documentación muy amplia y bien estructurada en la que se detalla su funcionamiento. A través de ella puedes:

  • Recuperar información de pedidos, productos y clientes
  • Crear y eliminar pedidos, productos y clientes
  • Procesar pagos
  • Gestionar los envíos

En este caso, nosotros nos vamos a centrar solo en la primera aplicación: recuperar la información de nuestros pedidos.

Los objetos más utilizados en la API de WooCommerce (algunos ya mencionados) son:

  • Pedidos
  • Productos
  • Clientes
  • Categorías de productos
  • Etiquetas de productos
  • Atributos de productos
  • Cupones

Y algunos elementos más. Para este ejemplo, sólo utilizaremos pedidos y productos. Pasemos ahora a buscar las credenciales para autenticarnos en la API

2. Activando las credenciales de la API

Para crear una clave válida para la API de WooCommerce, tendremos que ir, dentro de nuestro WordPress a WooCommerce -> Ajustes -> Avanzado -> API Rest:

Aquí haremos clic en «Añadir clave». Una vez aquí, le daremos una descripción que nos permita identificarla y le daremos permisos de lectura. Para este uso y por seguridad, con «lectura» es suficiente. También se pueden dar accesos de escritura y lectura/escritura. Esto permitiría a esta clave modificar la información de tus pedidos, lo cual no pretendemos hacer.

Tras hacer clic en «Generar clave de API», obtendrás una clave del cliente, cuyos caracteres comienzan por «ck_» y una clave secreta de cliente, cuyos caracteres comienzan por «cs_»:

Copia estas claves en algún lugar seguro, pues las necesitarás para poder trabajar con los scripts que vamos a ver a continuación.

3. Descargar y utilizar los scripts de Python

Con la API de Python de WooCommerce vamos a trabajar con dos scripts:

  1. Un script para recuperar información de pedidos e ítems de pedidos, que puedes ver aquí.
  2. Un script para recuperar información de los productos que tienes en tu tienda, que puedes ver aquí.

Guárdate una copia de ellos, y podrás editarlo. En ambos archivos, tan solo tendrás que modificar la información de credenciales del paso 2. Recuerda: URL de tu sitio web, clave del cliente y clave secreta de cliente:

Una vez modificado, tan solo tendrás que ir a «Entorno de ejecución» -> «Ejecutar todas» y el código hará:

  1. Para el caso de la información de pedidos, te generará dos archivos de excel
    • Uno con los datos de pedido, con estos campos:
      • order id
      • total
      • shipping_total
      • payment_method
      • date_paid
      • hour_paid
      • billing_postcode
      • billing_country
      • billing_email
      • cart_tax
      • shipping_tax
    • Otro con los datos de los productos adquiridos en cada pedido, con estos campos:
      • order id
      • date_paid
      • item_name
      • price
      • total
      • quantity
      • coupon_code
  1. Para el caso de la información de productos, te generará un archivo con
    • Datos de producto:
      • product id
      • name
      • permalink
      • type
      • status
      • catalog_visibility
      • stock_status
      • description
      • short_description
      • sku
      • price
      • regular_price
      • sale_price
      • on_sale
      • purchasable
      • virtual
      • downloadable
      • tax_status
      • tax_class
      • manage_stock
      • stock_quantity
      • weight
      • dimensions_length
      • dimensions_width
      • dimensions_height
      • shipping_required
      • shipping_taxable
      • shipping_class
      • tags_id
      • tags_name
      • categories_id
      • categories_name

Puedes añadir o quitar más variables. Chequea la documentación y adáptalo a la información que quieres sacar:

Un detalle sobre la WooCommerce API Python

Una última consideración. A través de este archivo podrás sacar hasta un máximo de 100 pedidos y 100 productos. Si quieres sacar más, tan solo modifica el parámetro «page», que por defecto marca el valor «1» y te sacará los 100 más recientes. Si quieres obtener del pedido 101 al 200, pon el valor «2»; del 201 al 300 pon el valor «3», y así sucesivamente.

Con esto, tendrías todo para recuperar la información de tus pedidos y productos en WooCommerce con Python a través de estas plantillas, que espero que te resulten útiles.

Otra opción sería utilizar funnel.io para descargar los datos, pero eso quizá lo podamos ver en otra ocasión.

¡Nos vemos en la próxima! 🙂

Deja un comentario