Scribd
Cargar
29 vistas5 páginas

REST Simplificado

Este documento describe la implementación de dos endpoints para obtener tarifas y crear cotizaciones de envíos a través de la API de MiEnvio. El primer endpoint (/quoteShipment) devuelve una tarifa para un envío. El segundo endpoint (/quoteShipment/rate) toma la tarifa seleccionada y crea una cotización de envío. Esto permite obtener tarifas y crear cotizaciones de envíos de forma programática a través de la API de MiEnvio.

Cargado por

Daniel Camilo Garay Cano
Derechos de autor
© © All Rights Reserved
Nos tomamos en serio los derechos de los contenidos. Si sospechas que se trata de tu contenido, reclámalo aquí.
Formatos disponibles
Descarga como PDF, TXT o lee en línea desde Scribd
29 vistas5 páginas

REST Simplificado

Este documento describe la implementación de dos endpoints para obtener tarifas y crear cotizaciones de envíos a través de la API de MiEnvio. El primer endpoint (/quoteShipment) devuelve una tarifa para un envío. El segundo endpoint (/quoteShipment/rate) toma la tarifa seleccionada y crea una cotización de envío. Esto permite obtener tarifas y crear cotizaciones de envíos de forma programática a través de la API de MiEnvio.

Cargado por

Daniel Camilo Garay Cano
Derechos de autor
© © All Rights Reserved
Nos tomamos en serio los derechos de los contenidos. Si sospechas que se trata de tu contenido, reclámalo aquí.
Formatos disponibles
Descarga como PDF, TXT o lee en línea desde Scribd
Está en la página 1/ 5

IMPLEMENTACIÓN TWO ENDPOINTS

2020

Obtención de tarifas

La implementación de estos llamados considera una reducción considerable en el tiempo de respuesta


en la obtención de tarifas.

Endpoint:

{base_url}/api/quoteShipment

Type: POST

URL: Sandbox – https://sandbox.mienvio.mx

Api token (Baerer Token)

Request:
{
"address_from":{
"name":"Nombre de Remitente",
"phone":"5555555555",
"email":"[email protected]",
"level_1":"Ciudad Capital",
"level_2":"Guatemala",
"level_3":"Guatemala",
"country":"GT",
"street":"Av. Principal 34",
"street2":"Col centro.",
"alias":"Alias de la dirección",
"object_type":"PURCHASE"
},
"address_to":{
"name":"Nombre de Destinatario",
"phone":"2222222222",
"email":"[email protected]",
"level_1":"Coban",
"level_2":"Alta Verapaz",
"level_3":"Coban",
"country":"GT",
"street":"Calle Quetzal 9",
"street2":"Colonia bella",
"alias":"Alias de la dirección",
"object_type":"PURCHASE"
},
"quote":{

1
IMPLEMENTACIÓN TWO ENDPOINTS

2020

"items":[
{
"declared_value":5000,
"height":2,
"id":"id-1",
"length":2,
"qty":1,
"weight":3.22,
"width":2
}
],
"object_purpose":"QUOTE"
}
}

Response:

{
"total_count": 1,
"total_pages": 1,
"current_page": 1,
"next_page_url": null,
"prev_page_url": null,
"results": [
{
"object_id": 36445,
"amount": 38,
"currency": "Q",
"min_weight": 0,
"max_weight": 65,
"servicelevel": "estandar",
"duration_terms": "1 a 5 días hábiles",
"days": 5,
"trackable": true,
"collect_home": true,
"provider": "Guatex",
"provider_img": "/media/providers/guatex.png",
"extended_zone": false,
"from_level_1": "Ciudad de Guatemala",
"from_level_1_id": 13421,
"from_level_2": "Ciudad de Guatemala",
"from_level_3": "Guatemala",
"from_country": "GT",
"to_level_1": "Cobán",
"to_level_1_id": 13424,
"to_level_2": "Cobán",
"to_level_3": "Alta Verapáz",

2
IMPLEMENTACIÓN TWO ENDPOINTS

2020

"to_country": "GT"
}
]
}

Colocar envío con la tarifa seleccionada


En el índice “results” de la respuesta seleccionamos el object_id con el que queremos realizar una
cotización, y lo colocamos en un siguiente llamado para realizar la creación de cotización del envío, para
ser posteriormente procesada en el panes de mienvio.

Endpoint: [base_url}/api/quoteShipment/rate

Type: POST

URL: Sandbox – https://sandbox.mienvio.mx

Api token (Baerer Token)

Request:
{
"address_from":{
"name":"Nombre de Remitente",
"phone":"5555555555",
"email":"[email protected]",
"level_1":"Ciudad Capital",
"level_2":"Guatemala",
"level_3":"Guatemala",
"country":"GT",
"street":"Av. Principal 34",
"street2":"Col centro.",
"alias":"Alias de la dirección",
"object_type":"PURCHASE"
},
"address_to":{
"name":"Nombre de Destinatario",
"phone":"2222222222",
"email":"[email protected]",
"level_1":"Coban",
"level_2":"Alta Verapaz",
"level_3":"Coban",
"country":"GT",
"street":"Calle Quetzal 9",
"street2":"Colonia bella",
"alias":"Alias de la dirección",
"object_type":"PURCHASE"
},
"quote":{
"items":[
3
IMPLEMENTACIÓN TWO ENDPOINTS

2020

{
"declared_value":5000,
"height":2,
"id":"id-1",
"length":2,
"qty":1,
"weight":3.22,
"width":2
}
],
"object_purpose":"QUOTE"
}
“rate”: 36445
}

Response:

{
"quote_id": 24643,
"bins": [
{
"package": {
"id": 1757,
"height": 35.56,
"width": 88.9,
"length": 53.34,
"weight": 3.22,
"declared_value": 5000
},
"items": [
{
"id": "id-1",
"height": 2,
"width": 2,
"length": 2,
"weight": 3.22
}
]
}
],
"servicelevel": "Estándar",
"courier": "Guatex",
"cost": 30
}

Con esto ya tendremos creada la cotización y la podremos visualizar en el Panel de administración de mienvio.

4
IMPLEMENTACIÓN TWO ENDPOINTS

2020

Panel de mienvio
Para visualizar las cotizaciones creadas se deberá ingresar al panel de mienvio e ingresar al menú de cotizaciones.

Ingresar el número de cotización obtenida y se visualizará como se muestra en la figura.

Para generar la guía se deberá hacer clic en Procesar cotización.

También podría gustarte