Guía de integración

WooCommerce

Esta guía es de uso exclusivo para la integración nativa con WooCommerce mediante webhooks. Para integraciones personalizadas o lógica avanzada, utilizar la documentación de la ruta estándar.

Paso 1

Ubicación del webhook

WooCommerce
Ajustes
Avanzado
Webhooks

Paso 2

Configuración del webhook

Evento: Pedido actualizado
Estado: Activo
URL de entrega:

http://www.servientregaapi.com/public/integration/{clientKey}/siscore/guias/woocommerce/order?env=prod

Notas:

El valor de clientKey es proporcionado por Servientrega
El valor de secret es proporcionado por Servientrega
El parámetro env define el entorno: sandbox para pruebas y prod para producción

Paso 3

Comportamiento

El webhook se ejecuta cuando un pedido es actualizado
La API solo procesa pedidos con estado completed
Los demás estados serán ignorados

Paso 4

Campos requeridos

Dentro de cada pedido de WooCommerce agregar:

Campos obligatorios

nombre_producto
ciudad_destinatario
peso_fisico
peso_volumentrico
alto
ancho
largo

Campos opcionales

cedula_destinatario
contenido
factura
caux1
caux2
caux3
valor_recaudar
piezas

Paso 5

Actualizar pedido

Una vez agregados los campos, actualizar el pedido
Si el estado es completed, se envía automáticamente al API
Se generará la guía correspondiente