4. Crear guía para envío
Esta guía te ayudará para crear una guía para un envío en particular
Primero deberás solicitar a tu cliente su dirección de envío. Te recomendamos un formulario como el siguiente.
Generalmente los campos como Número interior y Referencias suelen ser opcionales.
Una vez llenados todos los campos deberás llamar al endpoint de nuestra api v2 para generar envíos
Ver documentación de endpoint para analizar los campos solicitados en la payload.
La mayoría de estos campos en la request serán fijos. Lo que cambiara constantemente será la dirección de envío que alimentaras con el formulario de arriba.
En este punto asumiremos que ya cuentas con un correo electrónico para tu cliente. El cual alimentaste/registraste en un paso previo.
Te recomendamos construir esa solicitud de la siguiente manera.
{
// ... otros campos de la solicitud
"to_address": {
"name": "Nombre del destinatario en tu formulario",
"email": "Email de tu cliente",
"phone": "Teléfono del destinatario en tu formulario",
"street": "Calle, numero exterior",
"street2": "Numero interior, Colonia",
"reference": "Referencias destinatario en tu formulario",
"zipcode": "Código postal del destinatario en tu formulario",
"country": "MX",
"object_type": "PURCHASE"
}
// ... otros campos de la solicitud
}
Ten en cuenta que algunos de los campos tienen una extensión máxima definida en las referencias de la API.
Este es un ejemplo de payload completa para generar un envío:
{
"payment_method": "wallet",
"shipments": [
{
"packing_mode": "existing",
"from_address": {
"name": "Tienda demo Mienvío",
"street": "Higo 2776",
"street2": "Las torres",
"reference": "ref",
"city_municipality": "Guadalajara",
"email": "[email protected]",
"phone": "5555555555",
"zipcode": "44920",
"country": "MX"
},
"to_address": {
"name": "Juan Perez",
"street": "Street 1",
"street2": "Street 2",
"reference": "No reference",
"city_municipality": "Ciudad Obregon",
"email": "[email protected]",
"phone": "6441154713",
"zipcode": "85099",
"country": "MX"
},
"package": [
{
"weight": 0.1,
"length": 10,
"width": 10,
"height": 10,
"declared_value": 100,
"description": "Foco LED",
"fiscal_code": "55101530",
"package_type": "box",
"external_order_id": "150"
}
],
"service": {
"insurance": true
}
}
]
}Esta solicitud creara una guía para esa dirección. El algoritmo para seleccionar la paquetería esta definido en tus configuraciones de usuario. En el tutorial del paso anterior.
Recibirás una respuesta como la siguiente:
{
"status": 201,
"message": "Shipment purchased successfully",
"data": {
"purchase_id": 2398569,
"status": "PAYED",
"owner_id": 51306,
"invoice_id": null,
"folio_alegra": null,
"payment_provider": "mienvio_wallet",
"payment_id": "mienvio_wallet_Hb7E9t3rpT1767731947_51306",
"last4": null,
"amount": 179.73,
"created_at": "2026-01-06 14:39:07",
"shipments": [
{
"shipment_id": 7214815,
"type": "PURCHASED",
"owner_id": 51306,
"amount": {
"total": 179.73
},
"extra_services": {
"insurance": {
"insured_amount": 0,
"product": "",
"cost": 0
}
},
"pricing": {
"total": 179.73,
"breakdown": {
"base_cost": 179.73,
"additional_charges": {
"total": 0,
"breakdown": []
}
},
"extra_services": {
"total": 0,
"breakdown": [
{
"type": "insurance",
"description": "Seguro adicional",
"total": 0
}
]
}
},
"address_from": {
"address_id": 12961941,
"status": "FROMTO",
"name": "Tienda demo Mienvío",
"email": "[email protected]",
"phone": "5555555555",
"tax_id_number": "XAXX010101000",
"street": "Higo 2776",
"street2": "Las torres",
"reference": "ref",
"zipcode": "44920",
"city_municipality": "Guadalajara",
"state": "Jalisco",
"country": "MX"
},
"address_to": {
"address_id": 12907704,
"status": "FROMTO",
"tax_id_number": "XAXX010101000",
"state": "Sonora",
"name": "Juan Perez",
"street": "Street 1",
"street2": "Street 2",
"reference": "No reference",
"city_municipality": "Ciudad Obregon",
"email": "[email protected]",
"phone": "6441154713",
"zipcode": "85099",
"country": "MX"
},
"package": {
"weight": 0.1,
"length": 10,
"width": 10,
"height": 10,
"volumetric_weight": 0.2,
"real_weight": 0,
"real_volumetric_weight": 0,
"real_length": 0,
"real_width": 0,
"real_height": 0,
"declared_value": 99,
"description": "Foco LED",
"external_order_id": "150",
"package_type": "box",
"package_quantity": 1,
"product_quantity": 1
},
"rate": {
"rate_id": 13839977,
"currency": "MXN",
"amount": "0.00",
"service_name": "express",
"provider": "DHL",
"duration_terms": "2 a 4 días hábiles",
"days": 4,
"min_weight": -0,
"max_weight": 0.2,
"provider_img": "https://admin.mienvio.mx/media/providers/DHL.svg",
"is_ocurre": false
},
"label": {
"id": null,
"label_id": null,
"tracking_number": null,
"mienvio_tracking_url": null,
"label_url": null,
"created_at": null
},
"devolution": false,
"internal_order_id": null,
"order": {
"order_id": "150",
"marketplace": null,
"shop_id": null,
"shop_name": null
},
"created_at": "2026-01-06 14:39:05",
"updated_at": "2026-01-06 14:39:07"
}
]
}
}El tracking_number de tu envío se genera en un proceso separado en nuestro sistema para poder recibirlo tendrás que configurar el webhook de Nuevas guías dentro de Integraciones en el portal de MiEnvio.
En este enlace podrás ver ejemplos de nuestros webhooks. Webhooks
Una vez recibido, con estos datos podrás mostrar a tu cliente los detalles de su envío.
Cabe mencionar que estos envíos descontarán saldo de tu wallet. Asegúrate de siempre contar con fondos para mantener tu operación.
Updated about 1 month ago