Nueva
v2.1 - valorDeclarado a Nivel Raíz
2026-05-28
✨ Cambios principales
- valorDeclarado ahora disponible a nivel de envío - Acceso más directo sin parsear dinamicouno
- Campo tipo
Floaten nivel raíz del envío - Retrocompatible: el campo sigue existiendo en dinamicouno
- Aplica para Falabella/Ibis y Marketplace/OPL
📊 Estructura
Antes:
{
"numero": "240111000010615879",
"dinamicouno": {
"valorDeclarado": 200
}
}
Ahora:
{
"numero": "240111000010615879",
"valorDeclarado": 200.0000, // ← NUEVO
"dinamicouno": {
"valorDeclarado": 200
}
}
🔄 Cómo actualizar
Opción 1: Acceso directo (recomendado)
// NUEVO - Más simple
const valor = envio.valorDeclarado;
Opción 2: Mantener compatibilidad anterior
// Sigue funcionando
const dinamicouno = JSON.parse(envio.dinamicouno);
const valor = dinamicouno.valorDeclarado;
✅ Impacto
- No breaking: El código antiguo sigue funcionando
- Mejora de performance: No necesitas parsear JSON para este campo
- API más consistente: Campos importantes a nivel raíz
Versión
v2.0 - Release Inicial
2026-05-18
🎉 Features
- Endpoint GET /v2/planillas-envios operativo
- Autenticación con Authorization-Token y Authorization-User
- Soporte para Falabella/Ibis (SellerId, parcelNumber, etc)
- Soporte para Marketplace/OPL (flujo, partners, fechaCargaOpl)
- Campo dinamicouno con datos variables por proveedor
- 14+ campos estándar en todos los envíos
- Array SKU con detalles de productos
- Información de remitente y destinatario completa
- Coordenadas GPS (latitud/longitud)
📝 Notas
- Dimensiones a nivel envío son 0; usar SKU para valores reales
- dinamicouno viene como STRING JSON; parsear antes de usar
- codigoProducto puede ser string "None"; validar antes de usar
- Pesos en OPL siempre 0; usar peso de SKU
Próximo
v2.2 - En Desarrollo
Estimado Q3 2026
🚀 Planeado
- Filtro por estado de envío en query params
- Paginación para resultados grandes
- Endpoint de seguimiento individual (GET /v2/envios/{numero})
- Webhook para cambios de estado
- Rate limiting documentado
- GraphQL alternative