Una guía simple para la API de WooCommerce

Presentamos la API REST de WooCommerce

La API de WooCommerce le permite implementar funciones personalizadas para su sitio a nivel de software. Puede codificar de una manera diseñada específicamente para integrarse con WooCommerce . Como tal, puede crear prácticamente cualquier característica o funcionalidad si tiene el tiempo, la habilidad y (potencialmente) el presupuesto.

Para comprender cómo funciona esta característica clave, querrá familiarizarse con dos términos:

• Transferencia de estado representacional (REST) ​​. Este es un tema complicado, pero para los fines de este artículo, REST es un tipo de «servicio web» que le permite acceder a elementos específicos de una página web.
• Interfaz de programación de aplicaciones (API). A diferencia de una interfaz gráfica de usuario (GUI), esta es esencialmente un conjunto de enlaces de código y filtros que le permiten trabajar con puntos de acceso. Generalmente, los codificará en ciertos archivos basados ​​en WordPress.

En otras palabras, REST define a lo que puede acceder en su sitio a través del código, y la API le brinda las herramientas para aprovechar ese acceso. Juntos, le permiten realizar cambios significativos en el funcionamiento de su sitio.

Cómo se relaciona la API de WooCommerce con la API REST de WordPress

Cuando se introdujo por primera vez, la API de WooCommerce era una sola entidad. En otras palabras, fue diseñado únicamente para acceder a los ‘puntos finales’ de WooCommerce y no afectó a otros elementos de WordPress.

Sin embargo, una vez que se introdujo la API REST de WordPress , los puntos finales de WooCommerce se fusionaron para crear un ‘ir a’ general para acceder a WordPress bajo el capó. Aun así, todavía hay documentación para la API de WooCommerce . Si lee la introducción de ese documento, la historia de la API se describe ampliamente.

A los efectos de este artículo, consideraremos que la ‘API de WooCommerce’ es la colección de puntos finales específicos para esa plataforma de comercio electrónico. Por supuesto, los puntos finales centrales también serán útiles, por lo que también mencionaremos algunos de ellos. En resumen, es mejor no obsesionarse tratando de separar estas dos API: ahora son una y la misma.

Por qué es posible que desee utilizar la API de WooCommerce

Es posible que ya vea por qué la API REST de WooCommerce es una flecha emocionante y poderosa en el carcaj de su tienda. Estas son solo algunas de las razones por las que podría considerar usarlo:

• Tiene una funcionalidad personalizada para implementar. Si no puede encontrar lo que necesita a través de complementos, temas o fragmentos de código adicionales , crear la funcionalidad usted mismo podría ser una opción.
• Los clientes pueden obtener una interfaz personalizada. Usando las características más amplias de la API REST de WordPress, puede desacoplar el front-end de su sitio desde el back-end. Esto le permite aprovechar el poder de WordPress bajo el capó, mientras crea diseños de página y diseños usando otro idioma.
• Su equipo puede usar back-ends personalizados. Así como sus clientes pueden obtener una experiencia de usuario única, puede utilizar varias partes de WooCommerce para crear un panel de control personalizado. Puede incluir casi cualquier métrica o datos que desee, esencialmente creando su propia interfaz de usuario y plataforma de análisis.

Cualesquiera que sean sus razones, la API de WooCommerce ofrece una funcionalidad muy poderosa. Para demostrarlo aún más, veamos algunos de los detalles de esta API y veamos dónde y cómo se puede usar en su sitio.

Lo que puede lograr con la API de WooCommerce (4 ejemplos)

Es tentador decir simplemente: «Todo es posible» cuando se trata de la API de WooCommerce. Sin embargo, vale la pena ver algunas tareas comunes que puede encontrar, junto con algunos casos de uso específicos.

1. Crear, actualizar y eliminar productos

Dado que los productos de su tienda son el alma de su negocio, la API de WooCommerce dedica muchas opciones para garantizar que pueda administrarlos todos. Puede trabajar con prácticamente cualquier información recopilada dentro de WooCommerce, aunque algunos puntos finales son de solo lectura. Incluso hay API separadas para productos individuales, variaciones, atributos y sus términos, taxonomías , clases de envío y reseñas.

Hay muchas maneras en que esto puede ser útil. Por ejemplo, considere un sitio de mercado, donde los usuarios cargan sus propios productos. Puede crear un cargador front-end para ayudar a llevar a cabo las tareas de administración necesarias en función de las entradas de los usuarios. También puede editar por lotes muchas reseñas de productos relacionados en función de la solicitud de un usuario, eliminar correos electrónicos de identificación y mucho más.

2. Procesar Órdenes y sus Notas Asociadas

Si los productos son el alma de su tienda, los pedidos son el combustible del cohete. Como tal, la API de WooCommerce ofrece mucho para ayudarlo a administrar pedidos y notas. Se puede acceder a prácticamente todas las propiedades que se encuentran en WooCommerce, junto con las propiedades relacionadas de facturación, envío y metadatos.

Argumentaríamos que la mayoría de los usos para este punto final serán para enumerar pedidos de alguna manera. Incluso un simple fragmento de una línea le ofrece un poder inmenso. Por ejemplo, se puede analizar una lista para múltiples menciones del mismo producto, contar para aquellos pedidos en los que una canasta múltiple contenía un artículo específico y mucho más.

La actualización por lotes de notas de pedidos es otro uso útil para este aspecto de la API. Tomar una colección de pedidos de Navidad, dividirlos según el estado de cada uno y organizar el JSON resultante en una hoja de cálculo podría ayudarlo a entregar los pedidos de manera más rápida y eficiente.

3. Ajuste las tasas y clases de impuestos

Los impuestos son un dolor de cabeza para muchos propietarios de tiendas, especialmente cuando se trata de pedidos internacionales. Como hay muchas formas diferentes de aplicar impuestos a diferentes tasas, la API de WooCommerce ofrece múltiples opciones para trabajar con estos datos. Los puntos finales se dividen en dos variantes:

• Tasas de impuestos: Aquí es donde se registra el porcentaje real, junto con algunos otros datos de identificación.
• Clases de impuestos:  Estos son amplios rangos de impuestos a los que se aplican tasas.

Por ejemplo, puede crear una tasa impositiva del 20 % que se aplique a la clase ‘Tasa estándar’. De hecho, poder actualizar por lotes las tasas de impuestos es un buen uso de la API de WooCommerce. Un ejemplo más exclusivo sería una configuración en la que se crea una tasa o clase de impuestos en función de un atributo de cliente específico. Esto es ideal para situaciones en las que necesita ‘calificar’ a un cliente antes de registrarlo o enviarlo al proceso de pago.

4. Establecer zonas de envío, ubicaciones y métodos

Si alguna vez ha intentado trabajar con envíos en WooCommerce , comprenderá el campo minado que puede ser. Si se equivoca en algún elemento, el cliente se ve afectado directamente en un área que está lista para comentarios y críticas deficientes. Afortunadamente, la API de WooCommerce puede funcionar con todos los puntos finales asociados con el envío, como zonas, ubicaciones y métodos.

En comparación con otros aspectos de la API, no hay demasiados atributos con los que trabajar aquí. Sin embargo, todavía hay muchas opciones disponibles para ayudarlo a trabajar con los datos de su tienda. Si bien a menudo querrá «configurar y olvidar» la información de envío (dada su complejidad e impacto en la experiencia del usuario), todavía hay algunas aplicaciones prácticas.

Por ejemplo, es probable que tenga en cuenta las regulaciones actuales de COVID-19 tanto a nivel estatal como nacional. Con esto en mente, puede considerar usar una combinación de puntos finales para restringir el envío a ciertas ubicaciones de manera temporal. Además, podría notificar a los usuarios sobre cualquier retraso en el momento de la compra. Esto podría suceder en la pantalla de pago o a través de la comunicación masiva.

Cómo comenzar a usar la API de WooCommerce

La API REST de WooCommerce funciona a través de un sistema basado en claves digitales para otorgar acceso y permisos. Este proceso de autenticación tiene dos pasos distintos:

• WooCommerce crea dos claves: una clave de consumidor  y una clave secreta . Están hechos de cadenas aleatorias de caracteres y son prácticamente imposibles de descifrar.
• Siempre que desee realizar una ‘llamada’ a la API REST, deberá proporcionar esas claves como prueba de autenticación.

Este proceso es sencillo, pero obtener estas claves (y usar la API en sí) requiere que te dirijas a tu panel de control de WooCommerce, específicamente a la pantalla WooCommerce> Configuración> Avanzado . Deberá buscar el enlace API REST en la parte superior, navegar a esa pantalla y luego hacer clic en el botón Crear una clave API :

A continuación, complete el campo Descripción , mientras deja los demás como están por ahora. Esta debería ser una descripción simple de para qué es el acceso:

Finalmente, seleccione el botón Generar una clave API y espere a que WordPress haga lo suyo. Verá una clave de consumidor y una clave secreta aquí, un código QR para una mayor autenticación y un enlace para revocar el acceso a la API en el futuro. Es importante copiar las claves ahora, ya que no podrá recuperarlas más tarde.

En este punto, está listo para comenzar a codificar. Si esto es algo nuevo para usted,  contratar a un desarrollador para que lo ayude es una buena idea. Sin embargo, si quiere participar usted mismo, puede usar un ‘cliente API’ como Postman o Insomnia para hacer gran parte del trabajo pesado:

Para obtener una visión real de cómo usar la API de WooCommerce, puede consultar los blogs de desarrolladores sobre el tema. Por ejemplo, James Kemp en IconicWP ofrece información útil sobre cómo una aplicación web PHP y un puñado de código pueden conectarse a una tienda de comercio electrónico y procesar sus datos.

Conclusión

Cuando se trata de elegir una plataforma que sea amigable tanto para los usuarios como para los desarrolladores, se puede decir que WordPress es el número uno. Además, WooCommerce es igual de amigable para los propietarios de tiendas que desean simplicidad, potencia y flexibilidad. Parte de lo que lo hace tan adaptable es la API REST de WooCommerce. Aunque alguna vez fue una entidad separada, ahora se ha fusionado con la API REST principal de WordPress.

Este artículo analizó la API de WooCommerce y le mostró un vistazo de lo que puede hacer con ella. Querrá tener una comprensión firme de los conceptos básicos involucrados, o puede considerar contratar a un desarrollador para implementar las funciones que desea. De cualquier manera, el poder que ofrece esta API puede tener un impacto directo y positivo en su tienda e ingresos.

¿Está considerando usar la API de WooCommerce para su tienda y, de ser así, qué es lo que más le emociona? ¡Háganos saber en la sección de comentarios!

Crédito de la imagen destacada: monkographic / shutterstock.com