Desarrolladores

INTEGRA PIQUÉKU DELIVERY EN TU NEGOCIO.

Una API REST para cotizar, crear y seguir repartos desde tu web, tu app, tu TPV o tu marketplace. Con entorno de pruebas desde el primer minuto.

Ver documentación Crear cuenta de empresa

Todo lo que necesitas para integrar

API REST

JSON sobre HTTPS, autenticación con clave Bearer, errores con códigos estables.

Seguimiento en tiempo real

Estado de cada reparto y enlace público de seguimiento para tu cliente.

Webhooks firmados

Eventos de cada cambio de estado, firmados con HMAC-SHA256 y con reintentos.

SDKs

Librerías de JavaScript y PHP para integrar en menos tiempo.

Plugins

Plugin de WooCommerce. Shopify y PrestaShop, en preparación.

Sandbox

Claves pkd_test_, eventos simulados y datos de prueba que nunca se mezclan con los reales.

Marca blanca

Seguimiento y comunicaciones con tu marca, bajo acuerdo.

Soporte

Soporte técnico por email y, según el plan, prioritario o dedicado.

Sandbox desde el primer día

Las claves que empiezan por pkd_test_ trabajan en un entorno aislado: puedes crear repartos, simular eventos y probar tus webhooks sin repartidores reales ni cargos. Nada de lo que hagas en sandbox se mezcla con datos reales.

POST /api/v1/quotes

curl -X POST https://delivery.piqueku.com/api/v1/quotes \
  -H "Authorization: Bearer pkd_test_…" \
  -H "Content-Type: application/json" \
  -d '{ … }'

Webhooks verificables

Cada evento llega con la cabecera PKD-Signature. Calcula el HMAC-SHA256 de «t.cuerpo» con tu secreto y compáralo con v1. Rechaza eventos con una marca de tiempo antigua.

verify.js

// Node.js — verify "PKD-Signature: t=…,v1=…"
import { createHmac, timingSafeEqual } from "node:crypto";

function verify(rawBody, header, secret) {
  const parts = header.split(",").map((p) => p.trim().split("="));
  const t = parts.find(([k]) => k === "t")?.[1];
  const sigs = parts.filter(([k]) => k === "v1").map(([, v]) => v);
  if (!t || Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const expected = Buffer.from(
    createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex"),
  );
  return sigs.some(
    (s) => s.length === expected.length && timingSafeEqual(Buffer.from(s), expected),
  );
}

Endpoints

Resumen de la API v1. Consulta la documentación para ver parámetros, respuestas y errores.

POST/api/v1/quotesCalcula el precio de un reparto antes de crearlo.
GET/api/v1/coverageComprueba si una dirección está en zona de reparto.
GET/api/v1/availabilityDisponibilidad de servicio por tipo y franja.
POST/api/v1/deliveriesCrea un reparto (a partir de una cotización o directamente).
GET/api/v1/deliveries/{id}Consulta un reparto y su estado.
GET/api/v1/deliveries/{id}/trackingEstado de seguimiento y enlace público.
POST/api/v1/deliveries/{id}/cancelCancela un reparto.
POST/api/v1/deliveries/{id}/assignAsigna un reparto a una organización colaboradora.
GET/api/v1/pricingTarifas vigentes por tipo de servicio.
GET/api/v1/businesses/{id}/deliveriesRepartos de un negocio (marketplaces y multi-negocio).
GET/api/v1/organizations/{id}/statusEstado de una organización colaboradora.
POST/api/v1/webhooksRegistra un endpoint para recibir eventos.
GET/api/v1/usageConsumo de peticiones y entregas del periodo.

Estado de los plugins

WooCommerce· Plugin oficial
Shopify· En preparación
PrestaShop· En preparación

Ningún plugin está publicado todavía en tiendas de aplicaciones de terceros.

Empieza a integrar hoy

Crea tu cuenta de empresa, genera una clave pkd_test_ y haz tu primera cotización en minutos.

Crear cuenta de empresa Ver documentación