Integrar con Shopify

Crea pedidos en Falconext desde tus órdenes de Shopify.

Automatiza el despacho creando un pedido en Falconext cada vez que se paga una orden en Shopify.

Suscríbete al webhook orders/paid de Shopify

En tu app de Shopify, registra el webhook orders/paid apuntando a tu backend.

Transforma la orden y crea el pedido

Al recibir la orden de Shopify, mapéala y llama a Falconext.

JavaScript

// handler del webhook orders/paid de Shopify
export async function onOrderPaid(order) {
  await fetch("https://api.falconext.pe/api/v1/logistics/orders", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.FALCONEXT_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      external_order_id: order.name, // p.ej. "#1042"
      customer: {
        name: order.shipping_address.name,
        phone: order.shipping_address.phone,
      },
      delivery_address: {
        address: `${order.shipping_address.address1}, ${order.shipping_address.city}`,
        city: order.shipping_address.city,
      },
    }),
  });
}

Devuelve el rastreo a Shopify

Con los webhooks de Falconext, añade el tracking_code al fulfillment de Shopify y notifica al cliente.

Verifica el HMAC de Shopify también

Valida la firma de los webhooks de Shopify (cabecera X-Shopify-Hmac-Sha256) además de la firma de Falconext.