Conecte su tienda con nuestra logística

Empezar

Tres pasos. El primero puede hacerlo ahora mismo sin registrarse: los catálogos son públicos.

curl https://demoapi.ewl-cr.com/provincia

1. Obtenga su clave. Entre al Portal de Clientes y abra la sección API. Ahí ve su clave y puede regenerarla cuando quiera.
2. Integre contra el entorno de desarrollo. Tiene su propia base de datos, así que puede equivocarse sin crear envíos reales.
3. Cambie el dominio a producción cuando todo funcione. No hay nada más que cambiar.

Autenticación

Una sola cosa que recordar: la clave va en la cabecera Authorization, con el prefijo Bearer.

curl https://demoapi.ewl-cr.com/v2/paqueteria/tracking/ANA5922554BD \
  -H "Authorization: Bearer ewl_live_tu_clave_aqui"

const res = await fetch(
  "https://demoapi.ewl-cr.com/v2/paqueteria/tracking/ANA5922554BD",
  { headers: { Authorization: `Bearer ${process.env.EWL_API_KEY}` } }
);
const { response } = await res.json();
console.log(response.status, response.data);

$ch = curl_init("https://demoapi.ewl-cr.com/v2/paqueteria/tracking/ANA5922554BD");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer " . getenv("EWL_API_KEY"),
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$respuesta = json_decode(curl_exec($ch), true);

Entornos

Mismo código, distinto dominio. El de desarrollo tiene su propia base de datos: nada de lo que haga ahí toca sus envíos reales.

Probar en vivo

Esta consola hace peticiones reales al entorno de desarrollo desde su navegador. Los catálogos no piden credencial: elija uno y pulse enviar.

Crear una guía

El caso más común: su tienda recibe un pedido y crea el envío.

curl -X POST https://demoapi.ewl-cr.com/v2/paqueteria/crearPaquete \
  -H "Authorization: Bearer ewl_live_tu_clave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "destinatario":      "Ana Rojas",
    "telefono_cliente":  "+50688887777",
    "correo_web":        "[email protected]",
    "direccion_entrega": "200 m sur de la iglesia",
    "distrito_entrega":  37,
    "direccion_origen":  "Bodega central",
    "distrito_origen":   1,
    "envia":             "Mi Tienda",
    "peso":              2.4,
    "send_email":        1
  }'

El distrito va por código, no por nombre. Lo obtiene de los catálogos. Si su tienda guarda el código postal, le sirve directo: en Costa Rica son cinco dígitos con el formato PCCDD — provincia, cantón y distrito.

Rastrear un envío

Devuelve el recorrido completo, con fecha y hora de cada etapa.

curl https://demoapi.ewl-cr.com/v2/paqueteria/tracking/ANA5922554BD \
  -H "Authorization: Bearer ewl_live_tu_clave_aqui"

Cada envío atraviesa estas ocho etapas, siempre en este orden:

Catálogos

Provincias, cantones y distritos de Costa Rica. No requieren credencial, así que puede cargarlos al construir su formulario de checkout.

# 1. Provincias
curl https://demoapi.ewl-cr.com/provincia

# 2. Cantones de San José (cod_provincia = 1)
curl https://demoapi.ewl-cr.com/canton/1

# 3. Distritos de un cantón
curl https://demoapi.ewl-cr.com/distrito/1

Referencia completa

Webhooks

Si vende con Shopify o WooCommerce, no hace falta que programe nada: configura un webhook y nosotros creamos la guía cuando entra el pedido.

Shopify

1. En Shopify: Settings → Notifications → Webhooks.
2. Evento Order creation, formato JSON.
3. URL: https://api.ewl-cr.com/webhooks/shopify
4. Copie el signing secret que muestra Shopify y envíenoslo junto al dominio de su tienda para darle de alta.

WooCommerce

1. En WooCommerce: Ajustes → Avanzado → Webhooks.
2. Tema Pedido creado, versión WP REST API v3.
3. URL de entrega: https://api.ewl-cr.com/webhooks/woocommerce
4. Defina un secreto y compártanoslo junto a la dirección de su tienda.

Qué esperar

Verificamos la firma de cada aviso con su secreto, así que nadie puede crear envíos falsos a su nombre. Si su plataforma reintenta el mismo pedido, no se duplica: devolvemos la guía que ya habíamos creado.

Estados y errores

Todas las respuestas traen un campo status legible junto al código HTTP. Con mirar ese campo alcanza para saber qué pasó.

{
  "response": {
    "code": 103,
    "data": [ … ],
    "status": "ok"
  }
}

El campo code numérico identifica al endpoint y se conserva por compatibilidad. Para saber cómo fue la petición, use status.