API para Desarrolladores

Documentación API

Integra tu sistema con Todo de Cartón & ZipNGo. Usa nuestra API REST para cotizar envíos, generar guías, gestionar inventario y más.

Autenticación

Todas las rutas protegidas requieren un header Authorization con tu token JWT:

Authorization: Bearer <tu_token_jwt>

Autenticación

POST/api/auth/login

Iniciar sesión y obtener token JWT

{"email": "tu@email.com", "password": "tu_password"}
POST/api/auth/register

Registrar nuevo usuario

{"email": "...", "name": "...", "password": "..."}

Envíos

POST/api/shipping/compare

Comparar tarifas de 6 paqueterías

Params: origin_cp, destination_cp, weight, length, width, height

GET/api/shipments/track/{tracking}

Rastrear envío por número de guía

POST/api/shipments/bulk

Crear envíos masivos desde CSV

FormData con archivo CSV (columnas: origin_cp, destination_cp, recipient_name, weight)
POST/api/shipping/volumetric-calculator

Calcular peso volumétrico

Params: length, width, height, actual_weight

Guías Prepago

POST/api/payments/checkout/guides

Comprar paquete de guías (Stripe)

{"origin_url": "...", "package_id": "pack_25"}
GET/api/guides/balance

Consultar saldo de guías

POST/api/guides/generate

Generar guía de envío

{"carrier_id": "dhl", "service_type": "standard", "origin_cp": "06600", "destination_cp": "44100", "weight": "2", "recipient_name": "Juan"}
GET/api/guides/{id}/label

Descargar etiqueta PDF con código de barras

Inventario Multicanal

GET/api/inventory/products

Listar productos

POST/api/inventory/products

Crear producto y publicar en marketplaces

{"name": "...", "sku": "ABC123", "price": 99.00, "stock": 50, "publish_to": ["mercadolibre"]}
GET/api/marketplace/orders

Obtener pedidos de todos los marketplaces

Webhooks

POST/api/webhooks/config

Registrar webhook para notificaciones

{"url": "https://tu-servidor.com/webhook", "events": ["shipment.created", "shipment.status_changed"]}
GET/api/webhooks/config

Listar webhooks configurados