Formación del Ubigeo para Perú en Multivende

Guía para formar el Ubigeo de Perú desde Ripley y MELI con datos normalizados por Multivende.

📌 ¿Qué es el Ubigeo?

El Ubigeo es un código numérico de seis cifras que identifica de manera única cada división político-administrativa del Perú: dse compone de tres elementos principales:

• Departamento (Ciudad)
• Provincia
• Distrito

Canal: Ripley

¿Cómo llega la información desde Ripley?

Ripley proporciona los datos de ubicación en los siguientes campos:

• "City" → Ciudad
• "State" → Provincia
• "Street_2" → Distrito

🔄 ¿Cómo lo normaliza Multivende?

Multivende transforma esta información y la expone de forma estándar en el Checkout, en la ruta:

DeliveryOrderInCheckouts → DeliveryOrder → ShippingAddress

Con los siguientes campos:

• "city" → Ciudad
• "state" → Provincia
• "address_2" → Distrito

Canal: MercadoLibre (MELI)

¿Cómo llega la información desde MercadoLibre?

MercadoLibre informa los datos de la dirección en:

• Shipping.receiver_address.state → Departamento
• Shipping.receiver_address.city → Provincia
• Shipping.receiver_address.neighborhood → Distrito

🔄 ¿Cómo lo normaliza Multivende?

En el Checkout, dentro de:

DeliveryOrderInCheckouts → DeliveryOrder → ShippingAddress

Los datos se exponen como:

• "city" → Ciudad
• "state" → Provincia
• "neighborhood" → Distrito

Canal: Falabella

¿Cómo llega la información desde Falabella?

Falabella proporciona los datos de ubicación directamente en un campo denominado PostCode

• "PostCode": 150140 

🔄 ¿Cómo lo normaliza Multivende?

Multivende transforma esta información y la expone de forma estándar en el Checkout, en la ruta:

Checkout → Client → BillingAddresses → zipCode

Con los siguientes campos:

• "zipCode":150140

   

✅ Resumen por canal

Notas adicionales

• La información se encuentra siempre dentro del Checkout, por lo que recomendamos a los integradores acceder a los campos mencionados a través del objeto DeliveryOrderInCheckouts.
• Multivende se encarga de normalizar los datos geográficos para Perú, lo que facilita la implementación multicanal.
• Si otros canales llegaran a incluir datos similares, Multivende los procesará del mismo modo.
• El campo zipCode puede ser utilizado para asignación de zonas de envío, validación de direcciones, cálculo de impuestos, entre otros fines logísticos.
• No se requiere ninguna transformación adicional desde el lado del integrador: Multivende se encarga de mapear y normalizar automáticamente los datos.