OCASA API · v1.0

La API que mueve
tu logística.

Integrá cotizaciones, envíos, tracking y webhooks en tu plataforma. REST sobre HTTPS, respuestas en JSON, autenticación por Bearer token. Sandbox gratuito con datos reales.

API uptime
99,98%
↗ Últimos 90 días
Latencia P95
142ms
Global average
Requests / día
2,4M
↗ +18% MoM
Integraciones activas
847
PyMEs + Enterprise
Tu cuenta · área autenticada

Gestión de API keys

Creá, rotá y revocá credenciales desde un solo lugar. Cada key se muestra una sola vez al momento de generarla — después de eso, solo verás un preview enmascarado.

Mi cuenta — API Keys
Logueado como dev@mitienda.com · Workspace: Mi Tienda Online

Claves de acceso

Usá las claves de producción (live) para envíos reales. Las claves de sandbox (test) son gratuitas y no generan envíos reales.

Nombre Entorno Preview Último uso Creada Acciones
Producción web LIVE ocs_live_••••••••••3f2a hace 3 min 12 mar 2026
Integración Tiendanube LIVE ocs_live_••••••••••9b74 hace 12 min 28 feb 2026
Sandbox dev TEST ocs_test_••••••••••a1c8 hace 2h 03 abr 2026
Testing QA TEST ocs_test_••••••••••7d92 hace 5 días 18 mar 2026
Nunca compartas tus keys de producción. Guardalas como variables de entorno en tu backend (nunca en frontend). Si sospechás que una key fue comprometida, rotala inmediatamente desde esta pantalla — las integraciones seguirán funcionando con la nueva key apenas la actualices en tu código.
Ejemplo · nueva key recién generada
ocs_live_ 9xK2pR4mN7qT5fVwA3bHjL8dY1sE6cZ
Esta es la única vez que verás la key completa. Copiala y guardala en un lugar seguro (como AWS Secrets Manager, HashiCorp Vault, o tu gestor de secrets). Si la perdés, tendrás que generar una nueva.
Monitoreo · últimos 14 días

Uso de la API en tiempo real

Visualizá consumo, rate limits, errores y latencia. Configurable con alertas por email o webhook cuando te acerques al 80% de tu quota.

Requests por día
Últimos 14 días
6/abr 13/abr 19/abr
Plan actual · Growth
68.432
de 100.000 requests / mes
Reinicia el 1 de mayo · Upgrade →
API Reference · v1

Documentación y quickstart

La API de OCASA sigue convenciones REST. Todas las respuestas son JSON UTF-8. Base URL: https://api.ocasa.com/v1

Método Endpoint Descripción
POST /v1/quotes Cotizar un envío antes de crearlo
POST /v1/shipments Crear un envío y generar etiqueta
GET /v1/shipments/{id} Obtener detalles de un envío
GET /v1/tracking/{code} Consultar estado público de tracking
POST /v1/shipments/{id}/cancel Cancelar un envío no despachado
GET /v1/branches Listar sucursales por ciudad / código postal
GET /v1/services Servicios disponibles para un origen/destino
POST /v1/pickups Agendar retiro en domicilio del remitente
cURL
Node.js
Python
PHP
# Cotizar un envío desde CABA a Córdoba
curl -X POST https://api.ocasa.com/v1/quotes \
  -H "Authorization: Bearer $OCASA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": {
      "postal_code": "1425",
      "city": "CABA"
    },
    "destination": {
      "postal_code": "5000",
      "city": "Córdoba"
    },
    "parcel": {
      "weight_kg": 2.5,
      "dimensions_cm": { "length": 30, "width": 20, "height": 15 },
      "declared_value_ars": 45000
    },
    "services": ["express", "standard"]
  }'

# Respuesta
{
  "quotes": [
    {
      "service": "express",
      "cost_ars": 4825.00,
      "eta_business_days": 1,
      "carrier": "OCASA Última Milla"
    },
    {
      "service": "standard",
      "cost_ars": 2940.00,
      "eta_business_days": 3,
      "carrier": "OCASA Última Milla"
    }
  ]
}
Autenticación

Bearer Token

Enviá tu API key en el header Authorization. Todas las requests deben usar HTTPS.

Authorization: Bearer ocs_live_...
Manejo de errores

HTTP standard + JSON body

Errores retornan códigos 4xx/5xx con detalle estructurado.

{
  "error": {
    "code": "invalid_postal_code",
    "message": "CP inválido",
    "field": "destination.postal_code"
  }
}
Events · push en tiempo real

Webhooks

Suscribite a eventos para recibir notificaciones cuando cambia el estado de tus envíos. OCASA hace POST a tu URL con firma HMAC-SHA256 para validación.

shipment.created
Envío creado exitosamente. Incluye código de tracking y URL de etiqueta.
shipment.picked_up
Paquete retirado del remitente por el transportista.
shipment.in_transit
Paquete en tránsito — puede disparar múltiples veces por hop.
shipment.out_for_delivery
Paquete en camino al destinatario en el vehículo de reparto.
shipment.delivered
Entrega confirmada con timestamp, receptor y foto (si aplica).
shipment.exception
Incidencia en el envío: dirección errónea, ausente, rechazado, etc.
Libraries oficiales

SDKs para tu lenguaje favorito

Clientes mantenidos oficialmente por OCASA con manejo automático de reintentos, paginación, rate limiting y tipado fuerte.

Node.js

Compatible con TypeScript. Node 18+.

npm i @ocasa/sdk

Python

Con async/await. Python 3.9+.

pip install ocasa

PHP

Compatible con Composer. PHP 8.1+.

composer require ocasa/sdk

Go

Tipado fuerte. Go 1.21+.

go get github.com/ocasa/go-sdk
Infraestructura · transparencia

Status page

Monitoreo en vivo del estado de cada endpoint. Suscribite a alertas por email, Slack o RSS.

Todos los sistemas operativos
Actualizado hace 30 seg
API de cotizaciones
Operativo
API de envíos
Operativo
API de tracking
Operativo
Webhooks
Operativo
Sandbox
Operativo
Dashboard
Operativo

Empezá a integrar hoy

Creá tu cuenta, obtené una key de sandbox y mandá tu primera request en menos de 5 minutos.