Creación de envíos especiales con Moova
Esta guía cubre todos los casos especiales de creación de envíos: configuraciones avanzadas mediante settings, envíos de ida y vuelta, integraciones con Mercado Libre y ajustes especiales disponibles por flujo logístico o necesidad de negocio.
Settings: ajustes especiales
Los settings permiten definir condiciones especiales en el tratamiento del envío. Se incluyen como array en el payload:
"settings": [1, 2]
Estos settings se pueden poner en los envíos. Si se requieren especificaciones especiales, se deben agregar al momento de la creación como "settings": [<id del setting>].
Para consultar dinámicamente los settings disponibles, se puede utilizar el siguiente comando CURL:
curl -X GET "https://api-dev.moova.io/b2b/shipping-setting-options?filters=PickupSignature" -H "accept: application/json"
Lista completa de settings disponibles:
ID | Nombre | Descripción |
1 | PickupSignature | Requiere firma al momento del retiro. |
2 | PickupPhoto | Requiere que el Moover tome una foto en el retiro. |
3 | SignaturePhoto | En lugar de solicitar una firma, se debe tomar una foto del paquete. |
4 | DeliveryUserIdentification | Solicita identificación del usuario al momento de la entrega. |
5 | BackAndForth | Envío de ida y vuelta. |
6 | UpdateDeliveredItems | Al entregar el envío, actualizar los ítems entregados. |
7 | DeliverySurvey | Muestra una encuesta de la empresa al momento de la entrega. |
8 | OnlyDeliverToAuthorized | Solo entregar el envío a personas autorizadas. |
9 | ScanReceiverId | Al entregar el envío, escanear la identificación del receptor. |
10 | ViaWarehouse | El envío debe pasar por un almacén antes de ser entregado al destinatario. |
Endpoint sugerido para consulta dinámica: /shipping-setting-options
Envíos ida y vuelta (logística inversa)
Para configurar un envío que deberá retornar al origen:
"settings": [5], "return_settings": { "to": { "address": "Av. Belgrano 800", "city": "CABA", "state": "Buenos Aires", "country": "AR", "postalCode": "1405", "contact": { "name": "Punto de retorno", "phone": "+541133344455" } } }Cobro contra entrega (Cash on Delivery)
Si se requiere que el Moover cobre dinero al entregar:
"services": ["cash_on_delivery"], "cash_on_delivery": { "amount": 4500, "currency": "ARS" }Este servicio debe ser coordinado y habilitado con tu ejecutivo comercial.
Integración con Mercado Libre
Para crear un envío automático desde una venta en Mercado Libre:
Payload obligatorio:
{ "shippingType": "mercado_flex", "from": { "googlePlaceId": "ChIJy_LnszJZwokRLKy1iqU0L4A" }, "to": { "address": "Dirección completa destino", "contact": { "name": "Nombre del destinatario", "phone": "+541111111111" } }, "items": [ { "description": "Remera Talle M", "price": 1500, "currency": "ARS", "weight": 300, "length": 20, "width": 20, "height": 5, "quantity": 1 } ], "internalCode": "MLA123456789" }El campo
internalCodese utiliza para trackear el pedido dentro del flujo Moova y es obligatorio para Flex.El
googlePlaceIddel origen deberá estar previamente autorizado para operar con Mercado Libre.
⚠️ Mercado Libre Flex exige que el Moover escanee el envío desde la app de Flex. Moova recordará esta acción mediante su app de Moover.
Validaciones adicionales
Si se necesita reforzar la seguridad y verificación en la entrega:
"settings": [3, 4, 8, 9]
Estos ajustes permiten:
Reemplazar firma por foto (setting 3)
Solicitar identificación (setting 4)
Validar receptor autorizado (setting 8)
Escanear DNI receptor (setting 9)
Flujo de almacén
Para envíos que deben ingresar o salir desde un warehouse de Moova:
"flow": "warehouse", "settings": [10]
Esto debe estar previamente coordinado y habilitado por el equipo comercial.
📦 Información sobre depósitos y cómo obtener el más cercano por API
En algunos casos, la mercadería se encuentra en los depósitos de Moova. Para operar correctamente, es necesario determinar cuál es el depósito más cercano a la dirección de destino del envío.
Esto se puede consultar mediante un endpoint específico, antes de crear el envío.
🔗 Endpoint para buscar depósito más cercano
GET /b2b/warehouses/closest
📌 Formas de indicar la dirección de destino
Podés consultar el depósito más cercano utilizando cualquiera de estas formas:
✅ 1. Por placeId (ID de Moova)
GET /b2b/warehouses/closest?appId=<APPID>&placeId=444
✅ 2. Por dirección completa (encoded)
GET /b2b/warehouses/closest?appId=<APPID>&address=Amenabar%201444,%20CABA,%20Argentina
✅ 3. Por coordenadas geográficas
GET /b2b/warehouses/closest?appId=<APPID>&coords[lat]=-34.568869&coords[lng]=-58.447516
✅ 4. Por dirección compuesta (campos separados)
GET /b2b/warehouses/closest?appId=<APPID>&street=Amenabar&number=1444&city=Colegiales&state=CABA&country=AR
📦 Ejemplo de respuesta exitosa
{ "placeId": 258, "reference": "Sucursal 1", "address": { "formatted": "Av. Córdoba 1500, C1055AAR CABA, Argentina", "extra": null }, "contact": { "name": "Marcelo", "email": "[email protected]", "phone": "+54 11 4567 890" } }
Consulta relacionada: