Documentación de la API

{
  "id": "3515555999",
  "customer_id": "b7c2d419-3f80-4a15-9e6d-0c48ab52f731",
  "role": "USER",
  "expiresIn": 43661,
  "iat": 1784818338,
  "exp": 1784861999
}

{
  "phone": "3515555999",
  "email": "usuario@example.com",
  "name": "Mi Empresa S.A.",
  "password": "MiPassword123"
}

curl --location 'https://dev-ar.e-pick.com.ar/api/users/register' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
  "phone": "3515555999",
  "email": "usuario@example.com",
  "name": "Mi Empresa S.A.",
  "password": "MiPassword123"
}'

{
  "expiresIn": 43661,
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHBpcmVzSW4iOjQzNjYxLCJpYXQiOjE3ODQ4MTgzMzh9…",
  "full_confirmation": null,
  "customer": null,
  "mustAcceptTerm": false,
  "forceAcceptTerm": false
}

{
  "phone": "3515555999",
  "password": "MiPassword123",
  "source": "API"
}

curl --location 'https://dev-ar.e-pick.com.ar/api/users/login' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
  "phone": "3515555999",
  "password": "MiPassword123",
  "source": "API"
}'

{
  "id": "3515555999",
  "customer_id": "b7c2d419-3f80-4a15-9e6d-0c48ab52f731",
  "role": "USER",
  "expiresIn": 43579,
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9…",
  "name": "Mi Empresa S.A.",
  "dni": null,
  "full_confirmation": null,
  "image": null,
  "email": "usuario@example.com",
  "address": {
    "street": "Av. Colón",
    "number": "500",
    "coords": {
      "lat": -31.4201,
      "lng": -64.1888,
      "formatted_address": "Av. Colón 500, Córdoba, Argentina"
    },
    "city": "Córdoba",
    "province": "Córdoba",
    "postal_code": "5000"
  },
  "phone": "3515555999",
  "customer": {
    "id": "b7c2d419-3f80-4a15-9e6d-0c48ab52f731",
    "name": "Mi Empresa S.A.",
    "cuit": "30123456789",
    "invoice_type": 1,
    "invoice_condition": 1,
    "address": "Av. Colón 500",
    "phone": "1145550000",
    "email": "usuario@example.com",
    "auto_invoice": false,
    "allow_account": true,
    "created_at": "2024-10-01T15:16:36.000Z",
    "updated_at": "2025-01-17T15:04:41.000Z"
  },
  "mustAcceptTerm": false,
  "forceAcceptTerm": false
}

{
  "package": {
    "long": 10,
    "width": 12,
    "height": 11,
    "weight": "1.2",
    "value": 5000
  },
  "sender": {
    "postal_code": "5000"
  },
  "addressee": {
    "postal_code": "1425"
  }
}

{
  "info": {
    "customer_id": "b7c2d419-3f80-4a15-9e6d-0c48ab52f731"
  },
  "package": {
    "long": 10,
    "width": 12,
    "height": 11,
    "weight": "1.2",
    "value": 5000
  },
  "sender": {
    "postal_code": "5000"
  },
  "addressee": {
    "postal_code": "1425"
  }
}

curl --location 'https://dev-ar.e-pick.com.ar/api/orders/calculator/www' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Origin: https://dev-ar.e-pick.com.ar' \
--data '{
  "package": {
    "long": 10,
    "width": 12,
    "height": 11,
    "weight": "1.2",
    "value": 5000
  },
  "sender": {
    "postal_code": "5000"
  },
  "addressee": {
    "postal_code": "1425"
  }
}'

{
  "isValid": true,
  "price": 11060,
  "equivalence": 1,
  "eta": [3, 4],
  "service": "E-PICK",
  "package": "Route"
}

{
  "isValid": false,
  "price": 0,
  "equivalence": 0,
  "eta": [0, 0]
}

{
  "info": {
    "webhook": "https://tu-dominio.com/webhooks/epick",
    "id": "87821",
    "creator_id": "3515555999"
  },
  "package": {
    "long": 10,
    "width": 12,
    "height": 11,
    "weight": 1.2,
    "value": 5000
  },
  "sender": {
    "postal_code": "5000",
    "name": "Mi Tienda",
    "phone": "3515555999",
    "email": "tienda@example.com",
    "street": "Av. Colón",
    "number": "500",
    "city": "Córdoba",
    "province": "Córdoba",
    "extra": "Piso 2",
    "info": "Llamar antes de retirar"
  },
  "addressee": {
    "postal_code": "1425",
    "name": "Cliente Final",
    "phone": "1145678900",
    "email": "cliente@example.com",
    "street": "Av. Rivadavia",
    "number": "3000",
    "city": "Buenos Aires",
    "province": "Buenos Aires",
    "extra": "Dpto 1B",
    "info": "Llamar al timbre"
  }
}

curl --location 'https://dev-ar.e-pick.com.ar/api/orders/integrations/confirm-order' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-access-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9…' \
--data '{
  "info": {
    "webhook": "https://tu-dominio.com/webhooks/epick",
    "id": "87821",
    "creator_id": "3515555999"
  },
  "package": {
    "long": 10,
    "width": 12,
    "height": 11,
    "weight": 1.2,
    "value": 5000
  },
  "sender": {
    "postal_code": "5000",
    "name": "Mi Tienda",
    "phone": "3515555999",
    "email": "tienda@example.com",
    "street": "Av. Colón",
    "number": "500",
    "city": "Córdoba",
    "province": "Córdoba",
    "extra": "Piso 2",
    "info": "Llamar antes de retirar"
  },
  "addressee": {
    "postal_code": "1425",
    "name": "Cliente Final",
    "phone": "1145678900",
    "email": "cliente@example.com",
    "street": "Av. Rivadavia",
    "number": "3000",
    "city": "Buenos Aires",
    "province": "Buenos Aires",
    "extra": "Dpto 1B",
    "info": "Llamar al timbre"
  }
}'

{
  "id": "ALFCM1520609",
  "account": "PENDING",
  "status": "PENDING",
  "sender_code": "A1B2C3D",
  "addressee_code": "E4F5G6H",
  "number": 1520609,
  "phisical_number": "2026AR00001520609",
  "integration_identificator": "87821",
  "total": 11060,
  "equivalence": 1,
  "package_id": "1",
  "sender_name": "Mi Tienda",
  "addressee_name": "Cliente Final",
  "sender_phone": "3515555999",
  "addressee_phone": "1145678900",
  "sender_postal_code": "5000",
  "addressee_postal_code": "1425",
  "height": 11,
  "long": 10,
  "weight": 1.2,
  "width": 12,
  "value": 5000,
  "created_at": "2026-07-23T15:01:40.171Z",
  "updated_at": "2026-07-23T15:01:40.171Z",
  "status_name": "Pendiente de Pago",
  "origin": "API",
  "paused": "NO",
  "confirmed_at": null,
  "payed_at": null,
  "delivered_at": null,
  "prime": false,
  "priority": false,
  "integration_webhook": "https://tu-dominio.com/webhooks/epick",
  "cho_url": "https://www.mercadopago.com.ar/checkout/v1/redirect?pref_id=1234567890-…",
  "mp_url": "https://www.mercadopago.com.ar/checkout/v1/redirect?pref_id=1234567890-…",
  "preference_id": "1234567890-abcd1234-…",
  "qr_image": "data:image/png;base64,iVBORw0KGgoAAAANS…"
}

curl --location 'https://dev-ar.e-pick.com.ar/api/orders/confirm/ALFCM1520651/A1B2C3D' \
--header 'Accept: application/json'

{
  "sTitle": "CONFIRMASTE TU ENVIO",
  "sContent": "En 1 a 3 días hábiles pasaremos a buscar tu paquete código ALFCM1520651."
}

curl --location --output etiqueta.pdf \
'https://dev-ar.e-pick.com.ar/api/orders/label/ALFCM1520609/normal?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9…'

curl --location --output etiquetas.pdf \
'https://dev-ar.e-pick.com.ar/api/orders/label/ALFCM1520609,ALFBO1519004/thermal?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9…'

{
  "code": "ERROR",
  "message": "Para imprimir la/s orden/es deben estar Pagadas"
}

curl --location 'https://dev-ar.e-pick.com.ar/api/orders/tracking/ALFCM1520609' \
--header 'Accept: application/json'

{
  "stage": "origin",
  "serviceTracking": false,
  "stageType": "dark",
  "message": "PAQUETE PAGADO .El 20/08/2026 se abonó este envío. Estamos esperando que quien envía lo confirme. No tenemos fecha estimada de entrega."
}

{
  "stage": "origin",
  "serviceTracking": false,
  "stageType": "ok",
  "message": "PAQUETE EN PROCESO DE RETIRO. Lo buscaremos el 21/08/2026. Fecha estimada de entrega: 26/08/2026"
}

{
  "stage": "traveling",
  "serviceTracking": false,
  "stageType": "ok",
  "message": "PAQUETE COLECTADO. Ya tenemos tu paquete! 🥳 Lo retiramos el 20/08/2026.\n                    Fecha estimada de entrega: 26/08/2026."
}

{
  "stage": "traveling",
  "serviceTracking": "https://seguimiento.transportista.com/paquetes/123456789",
  "stageType": "ok",
  "message": "PAQUETE EN CAMINO. 😉"
}

{
  "stage": "destination",
  "serviceTracking": false,
  "stageType": "ok",
  "message": "PAQUETE ENTREGADO. 🥳 Entregamos este paquete el 13/08/2026"
}

{
  "stage": "origin",
  "serviceTracking": false,
  "stageType": "light",
  "message": "PAQUETE CANCELADO. Esta solicitud se encuentra cancelada desde el 18/08/2026"
}

{
  "stage": "origin",
  "serviceTracking": false,
  "stageType": "error",
  "message": "PAQUETE EN PAUSA. El 12/08/2026 intentamos retirarlo pero la colecta no se pudo concretar con éxito. Volveremos a intentar retirarlo el 13/08/2026. Fecha estimada de entrega, 19/08/2026"
}

{
  "stage": "origin",
  "serviceTracking": false,
  "stageType": "error",
  "message": "PAQUETE EN PAUSA. Quien envía pausó el retiro de este paquete el dia 11/08/2026. Estamos esperando su confirmación para programar la colecta. No tenemos fecha estimada de entrega."
}

{
  "stage": "traveling",
  "serviceTracking": false,
  "stageType": "error",
  "message": "PAQUETE COLECTADO. Ya tenemos tu paquete! 🥳 Lo retiramos el 08/08/2026. El 12/08/2026 intentamos efectuar la entrega y no se pudo concretar con éxito. Volveremos a intentar entregarlo el 13/08/2026."
}

{
  "stage": "traveling",
  "serviceTracking": false,
  "stageType": "error",
  "message": "PAQUETE COLECTADO. Ya tenemos tu paquete! 🥳 Lo retiramos el 08/08/2026. El 12/08/2026 intentamos efectuar la entrega y ocurrió un inconveniente que necesitamos sea solucionado por quien recibe para volver a programar la misma."
}

{
  "stage": "origin",
  "serviceTracking": false,
  "stageType": "light",
  "message": "PAQUETE INEXISTENTE. No registramos paquetes con el código de operación ingresado."
}

https://dev-ar.e-pick.com.ar/tracking?id=ALFCM1520609

curl --location --request POST 'https://dev-ar.e-pick.com.ar/api/orders/ALFBO1519004/cancel' \
--header 'Content-Type: application/json' \
--header 'x-access-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9…'

PENDING → PAYED → CONFIRMED → COLLECTED → DELIVERED-TO-SERVICE → DELIVERED
                                                                 ↓
                                                            CANCELED

{
  "info": {
    "webhook": "https://tu-dominio.com/webhooks/epick",
    "id": "87821",
    "creator_id": "3515555999"
  }
}

{
  "order_id": "ALFCM1520609",
  "integration_identificator": "87821",
  "idEstado": 12,
  "estado": "DELIVERED",
  "created_at": "2026-08-20T16:35:26.000Z",
  "short_description": null,
  "long_description": null,
  "coords": null,
  "eta_start": null,
  "eta_end": null,
  "delivered_to_name": null,
  "delivered_to_dni": null,
  "delivered_to_relation": null
}

{
  "order_id": "ALFCM1520609",
  "integration_identificator": "87821",
  "idEstado": 9,
  "estado": "SCHEDULED-TO-DELIVERY",
  "created_at": "2026-08-20T16:24:56.000Z",
  "short_description": null,
  "long_description": null,
  "coords": null,
  "eta_start": "14:42:00",
  "eta_end": "17:02:00",
  "delivered_to_name": null,
  "delivered_to_dni": null,
  "delivered_to_relation": null
}

{
  "order_id": "ALFBO1519004",
  "integration_identificator": "87822",
  "idEstado": 10,
  "estado": "NOT-DELIVERED",
  "created_at": "2026-08-20T16:24:53.000Z",
  "short_description": "No pudimos encontrarte",
  "long_description": "No atendiste el timbre / puerta,",
  "coords": { "lat": -34.6037, "lng": -58.3816 },
  "eta_start": "12:06:00",
  "eta_end": "14:26:00",
  "delivered_to_name": null,
  "delivered_to_dni": null,
  "delivered_to_relation": null
}

{
  "order_id": "ALFBO1519004",
  "integration_identificator": "87822",
  "idEstado": null,
  "estado": "INVENTORY-ON-BASE",
  "created_at": "2026-08-20T16:26:37.000Z",
  "short_description": null,
  "long_description": null,
  "coords": { "lat": "-34.6037", "lng": "-58.3816" },
  "eta_start": null,
  "eta_end": null,
  "delivered_to_name": null,
  "delivered_to_dni": null,
  "delivered_to_relation": null
}

from django.http import JsonResponse
from django.views.decorators.csrf import csrf_exempt
from django.views.decorators.http import require_POST
import json

@csrf_exempt
@require_POST
def epick_webhook(request):
    data = json.loads(request.body)

    order_id = data.get("order_id")
    estado = data.get("estado")
    ocurrido = data.get("created_at")

    order = Order.objects.filter(epick_id=order_id).first()
    if not order:
        # orden desconocida: respondemos 200 igual, si no reintenta 24 horas
        return JsonResponse({"ok": True})

    # idempotencia: descartar notificaciones repetidas o fuera de orden
    if order.epick_updated_at and ocurrido <= order.epick_updated_at:
        return JsonResponse({"ok": True})

    order.estado = estado
    order.epick_updated_at = ocurrido

    # las acciones de excepción traen el motivo para mostrarle al cliente
    if estado in ("NOT-PICKEDUP", "NOT-DELIVERED"):
        order.motivo = data.get("long_description")

    if estado in ("SCHEDULED-TO-PICKUP", "SCHEDULED-TO-DELIVERY"):
        order.ventana = (data.get("eta_start"), data.get("eta_end"))

    order.save()
    return JsonResponse({"ok": True})

{
  "code": "ERROR",
  "message": "Para imprimir la/s orden/es deben estar Pagadas"
}

Producto 1:  cantidad 2   peso 1.2 kg   15 × 8 × 17 cm
Producto 2:  cantidad 3   peso 0.7 kg   10 × null × 20 cm

1. Peso total
  (1.2 × 2) + (0.7 × 3) = 2.4 + 2.1 = 4.5 kg

2. Volumen total
  Producto 1: 15 × 8 × 17 = 2040 cm³  →  × 2 = 4080 cm³
  Producto 2: 10 × 0.1 × 20 = 20 cm³  →  × 3 = 60 cm³
  Total: 4080 + 60 = 4140 cm³

3. Lado equivalente
  ∛4140 = 16.05 cm

4. Lo que mandás en package
  16.05 × 16.05 × 16.05 cm, 4.5 kg

volumen del bulto   = largo × ancho × alto
equivalence  = volumen ÷ 15.552
precio              = tarifa × equivalence

function dimensionesDelBulto(productos) {
  let pesoTotal = 0;
  let volumenTotal = 0;

  for (const producto of productos) {
    for (const dim of [producto.largo, producto.ancho, producto.alto]) {
      if (dim && dim > 100) {
        return { error: 'Ningún producto puede superar 100 cm por lado' };
      }
    }

    const cantidad = producto.cantidad || 1;
    pesoTotal += (producto.peso || 0) * cantidad;

    // una dimensión ausente vale 0.1, nunca 0
    const largo = producto.largo || 0.1;
    const ancho = producto.ancho || 0.1;
    const alto  = producto.alto  || 0.1;
    volumenTotal += largo * ancho * alto * cantidad;
  }

  if (pesoTotal > 25) {
    return { error: 'El peso total supera los 25 kg' };
  }

  const lado = Math.round(Math.cbrt(volumenTotal) * 100) / 100;

  if (lado > 50) {
    return { error: 'El bulto resultante supera los 50 cm por lado' };
  }

  return { long: lado, width: lado, height: lado, weight: pesoTotal };
}

import requests

BASE = "https://dev-ar.e-pick.com.ar"

# ---------------------------------------------------------------- 1. Registro (una sola vez)
r = requests.post(f"{BASE}/api/users/register", json={
    "phone": "3515555999",
    "email": "mitienda@example.com",
    "name": "Mi Tienda S.A.",
    "password": "MiPassword123",
})
r.raise_for_status()

# ---------------------------------------------------------------- 2. Login
r = requests.post(f"{BASE}/api/users/login", json={
    "phone": "3515555999",
    "password": "MiPassword123",
    "source": "API",
})
r.raise_for_status()
token = r.json()["token"]

# ---------------------------------------------------------------- 3. Cotización
r = requests.post(f"{BASE}/api/orders/calculator/www", json={
    "package": {"long": 10, "width": 12, "height": 11, "weight": "1.2", "value": 5000},
    "sender": {"postal_code": "5000"},
    "addressee": {"postal_code": "1425"},
})
quote = r.json()
if not quote["isValid"]:
    raise SystemExit("Cotización inválida: revisar medidas y códigos postales")

print("Precio:", quote["price"], "ETA", quote["eta"])

# ---------------------------------------------------------------- 4. Crear la orden
r = requests.post(
    f"{BASE}/api/orders/integrations/confirm-order",
    headers={"x-access-token": token},
    json={
        "info": {
            "webhook": "https://tu-dominio.com/webhooks/epick",
            "id": "87821",
            "creator_id": "3515555999",
        },
        "package": {"long": 10, "width": 12, "height": 11, "weight": 1.2, "value": 5000},
        "sender": {
            "postal_code": "5000", "name": "Mi Tienda", "phone": "3515555999",
            "email": "tienda@example.com", "street": "Av. Colón", "number": "500",
            "city": "Córdoba", "province": "Córdoba",
            "extra": "Piso 2", "info": "Llamar antes de retirar",
        },
        "addressee": {
            "postal_code": "1425", "name": "Cliente Final", "phone": "1145678900",
            "email": "cliente@example.com", "street": "Av. Rivadavia", "number": "3000",
            "city": "Buenos Aires", "province": "Buenos Aires",
            "extra": "Dpto 1B", "info": "Llamar al timbre",
        },
    },
)
r.raise_for_status()
order = r.json()
order_id = order["id"]

print("Orden creada:", order_id, order["status"])

# ---------------------------------------------------------------- 5. Seguimiento
r = requests.get(f"{BASE}/api/orders/tracking/{order_id}")
print(r.json()["message"])