Calcular o custo do frete e o handling time
Conteúdos
→Descrição de atributos →Cálculo conforme local, CEP e dimensões do produto →Cálculo conforme usuário e CEP →Cálculo conforme cidade e dimensões no MCO (Colômbia) →Cálculo conforme usuário, cidade e dimensões no MCO (Colômbia) →Cálculo conforme produto e cidade no MCO (Colômbia)
Descrição de atributos
A seguir, uma rápida descrição de cada um dos recursos que você encontrará em seu recurso calculator.
Destination (destino): Detalhes do endereço do destinatário:
Attributes
- zip_code: CEP de destino.
- city (cidade): Destination city info.
- state (estado): Informações sobre o estado de destino.
- country: Nome do estado de destino.
- extended_attributes (atributos extendidos): Informações adicionais do endereço de destino.
id: ID da cidade de destino. name (nome): Nome da cidade de destino.
id: Destination state id. name (nome): ID do estado de destino.
id: ID do país de destino. name (nome): Nome do país de destino.
address: Linha do endereço de destino. owner_name: Titular do endereço de destino. zip_code_type: Informações sobre o tipo de CEP de destino. - type (tipo): ID do tipo de CEP de destino. - Description: Nome do tipo de CEP de destino. city_type (tipo de cidade): ID do tipo de cidade de destino. city_name: Nome da cidade de destino. version (Versão): Versão interna desses dados na API de CEPs.
Options: Coleção de custos de envio para cada um dos métodos disponibilizados.
Atributos
- id: ID da regra de frete aplicada.
- name (nome): Nome do modo de envio.
- currency_id (ID da moeda): ID da moeda utilizada para mostrar os custos de envio.
- list_cost: Custo real do frete; sem a aplicação do frete grátis.
- cost (custo): Custo final do frete; pode ser aplicado o frete grátis.
- tracks_shipments_status: Indica como pode ser feito o rastreamento desse modo.
- display: ID do modo de envio para processamento inicial.
- speed (velocidade): Informações sobre a velocidade da entrega.
verified: Pode ser feito o rastreamento internamente. not_verified: As informações do rastreamento deverão ser fornecidas pelo vendedor. no: Não é possível realizar rastreamento.
always: Deve ser mostrado o modo de envio. optional: O modo pode não ser mostrado porque existe outro mais rápido e acessível.
shipping (envio): Média de horas do envio. handling: Média de horas para que o vendedor realize o despacho.
Cálculo conforme local, CEP e dimensões do produto
Exemplo:
curl -X GET https://api.mercadolibre.com/sites/MLB/shipping_options?zip_code_from=01310909&zip_code_to=01310909&dimensions=16x16x16,1500
Resposta:
{
"destination": {
"zip_code": "01310909",
"city": {
"id": "BR-SP-44",
"name": "São Paulo"
},
"state": {
"id": "BR-SP",
"name": "São Paulo"
},
"country": {
"id": "BR",
"name": "Brasil"
},
"extended_attributes": {
"address": "Avenida Paulista, 688",
"owner_name": "Edifício Santa Filippa",
"zip_code_type": {
"type": "LO",
"description": "Logradouro"
},
"city_type": "CI",
"city_name": "São Paulo",
"neighborhood": "Bela Vista",
"status": "active"
}
},
"options": [
{
"id": 27554373,
"name": "Normal",
"shipping_method_id": 100009,
"currency_id": "BRL",
"list_cost": 9.66,
"cost": 9.66,
"tracks_shipments_status": "not_verified",
"display": "recommended",
"speed": {
"shipping": 96,
"handling": 48
},
"estimated_delivery": {
"date": "2016-02-26T00:00:00.000-02:00",
"pay_before": null,
"time_from": null,
"time_to": null
},
"estimated_delivery_time": {
"type": "known_frame",
"date": "2016-02-24T00:00:00.000-02:00",
"shipping": 48,
"handling": 48,
"unit": "hour",
"offset": {
"date": "2016-02-26T00:00:00.000-02:00",
"shipping": 48
},
"time_frame": {
"from": null,
"to": null
},
"pay_before": null
},
"discount": {
"rate": 0,
"type": "none",
"promoted_amount": 0
}
},
{
"id": 27551043,
"name": "Expresso",
"shipping_method_id": 182,
"currency_id": "BRL",
"list_cost": 9.83,
"cost": 9.83,
"tracks_shipments_status": "not_verified",
"display": "always",
"speed": {
"shipping": 48,
"handling": 48
},
"estimated_delivery": {
"date": "2016-02-24T00:00:00.000-02:00",
"pay_before": null,
"time_from": null,
"time_to": null
},
"estimated_delivery_time": {
"type": "known_frame",
"date": "2016-02-23T00:00:00.000-02:00",
"shipping": 24,
"handling": 48,
"unit": "hour",
"offset": {
"date": "2016-02-24T00:00:00.000-02:00",
"shipping": 24
},
"time_frame": {
"from": null,
"to": null
},
"pay_before": null
},
"discount": {
"rate": 0,
"type": "none",
"promoted_amount": 0
}
}
]
}
Calcula conforme a usuario y código postal
Exemplo:
curl -X GET https://api.mercadolibre.com/users/190990642/shipping_options?zip_code=01310909&dimensions=16x16x16,1500
Resposta:
{
"destination": {
"zip_code": "01310909",
"city": {
"id": "BR-SP-44",
"name": "São Paulo"
},
"state": {
"id": "BR-SP",
"name": "São Paulo"
},
"country": {
"id": "BR",
"name": "Brasil"
},
"extended_attributes": {
"address": "Avenida Paulista, 688",
"owner_name": "Edifício Santa Filippa",
"zip_code_type": {
"type": "LO",
"description": "Logradouro"
},
"city_type": "CI",
"city_name": "São Paulo",
"neighborhood": "Bela Vista",
"status": "active"
}
},
"options": [
{
"id": 27555383,
"name": "Normal",
"shipping_method_id": 100009,
"currency_id": "BRL",
"list_cost": 11.86,
"cost": 11.86,
"tracks_shipments_status": "not_verified",
"display": "recommended",
"speed": {
"shipping": 96,
"handling": 48
},
"estimated_delivery": {
"date": "2016-03-01T00:00:00.000-02:00",
"pay_before": null,
"time_from": null,
"time_to": null
},
"estimated_delivery_time": {
"type": "known_frame",
"date": "2016-02-26T00:00:00.000-02:00",
"shipping": 48,
"handling": 48,
"unit": "hour",
"offset": {
"date": "2016-03-01T00:00:00.000-02:00",
"shipping": 48
},
"time_frame": {
"from": null,
"to": null
},
"pay_before": null
},
"discount": {
"rate": 0,
"type": "none",
"promoted_amount": 0
}
},
{
"id": 27843879,
"name": "Expresso",
"shipping_method_id": 182,
"currency_id": "BRL",
"list_cost": 16.48,
"cost": 16.48,
"tracks_shipments_status": "not_verified",
"display": "always",
"speed": {
"shipping": 48,
"handling": 48
},
"estimated_delivery": {
"date": "2016-02-26T00:00:00.000-02:00",
"pay_before": null,
"time_from": null,
"time_to": null
},
"estimated_delivery_time": {
"type": "known_frame",
"date": "2016-02-25T00:00:00.000-02:00",
"shipping": 24,
"handling": 48,
"unit": "hour",
"offset": {
"date": "2016-02-26T00:00:00.000-02:00",
"shipping": 24
},
"time_frame": {
"from": null,
"to": null
},
"pay_before": null
},
"discount": {
"rate": 0,
"type": "none",
"promoted_amount": 0
}
}
]
}
Cálculo conforme cidade e dimensões no MCO (Colômbia)
Você pode calcular o custo do frete para um local determinado. O MCO é diferente de outros sites porque o cálculo é realizado conforme os parâmetros city_from, city_to e as dimensões. Como você pode observar no exemplo abaixo, esse recurso permite multiget. Você deve vincular os códigos de cidade isoladamente:
Exemplo:
curl -X GET https://api.mercadolibre.com/sites/MCO/shipping_options?city_from=Q08tRENCb2dvdA&city_to=TUNPQ0NBUjcwNTYz,TUNPQ01FRGRjNjc4&dimensions=10x10x10,1000
Resposta:
{
"TUNPQ01FRGRjNjc4": {
"destination": {
"zip_code": null,
"city": {
"id": "TUNPQ01FRGRjNjc4",
"name": "Medellín"
},
"state": {
"id": "CO-ANT",
"name": "Antioquia"
},
"country": {
"id": "CO",
"name": "Colombia"
}
},
"options": [
{
"id": 523836053,
"name": "Servientrega Normal",
"shipping_method_id": 501745,
"currency_id": "COP",
"list_cost": 7500,
"cost": 7500,
"tracks_shipments_status": "not_verified",
"display": "recommended",
"speed": {
"shipping": 24,
"handling": 72
},
"estimated_delivery": {
"date": "2016-02-26T00:00:00.000-05:00",
"pay_before": null,
"time_from": null,
"time_to": null
},
"estimated_delivery_time": {
"type": "known",
"date": "2016-02-26T00:00:00.000-05:00",
"shipping": 24,
"handling": 72,
"unit": "hour",
"offset": {
"date": null,
"shipping": null
},
"time_frame": {
"from": null,
"to": null
},
"pay_before": null
},
"discount": {
"rate": 0,
"type": "none",
"promoted_amount": 0
}
}
]
},
"TUNPQ0NBUjcwNTYz": {
"destination": {
"zip_code": null,
"city": {
"id": "TUNPQ0NBUjcwNTYz",
"name": "Cartagena De Indias"
},
"state": {
"id": "CO-BOL",
"name": "Bolivar"
},
"country": {
"id": "CO",
"name": "Colombia"
}
},
"options": [
{
"id": 523835977,
"name": "Servientrega Normal",
"shipping_method_id": 501745,
"currency_id": "COP",
"list_cost": 7500,
"cost": 7500,
"tracks_shipments_status": "not_verified",
"display": "recommended",
"speed": {
"shipping": 48,
"handling": 72
},
"estimated_delivery": {
"date": "2016-02-29T00:00:00.000-05:00",
"pay_before": null,
"time_from": null,
"time_to": null
},
"estimated_delivery_time": {
"type": "known",
"date": "2016-02-29T00:00:00.000-05:00",
"shipping": 48,
"handling": 72,
"unit": "hour",
"offset": {
"date": null,
"shipping": null
},
"time_frame": {
"from": null,
"to": null
},
"pay_before": null
},
"discount": {
"rate": 0,
"type": "none",
"promoted_amount": 0
}
}
]
}
}
Cálculo conforme usuário, cidade e dimensões no MCO (Colômbia)
Se quiser, você pode calcular o custo do frete para um usuário específico e uma cidade e dimensões determinadas. Como você pode observar no exemplo abaixo, esse recurso permite multiget. Você deve vincular os códigos da cidade isoladamente.
Exemplo:
GET https://api.mercadolibre.com/users/454271894/shipping_options?city_to=Q08tRENCb2dvdA,TUNPQ01FRGRjNjc4&dimensions=15x15x15,650
Resposta:
{
"destination": {
"zip_code": null,
"city": {
"id": "Q08tRENCb2dvdA",
"name": "Bogotá"
},
"state": {
"id": "CO-DC",
"name": "Bogota D.C."
},
"country": {
"id": "CO",
"name": "Colombia"
}
},
"options": [
{
"id": 11110,
"name": "Servientrega Estandar",
"shipping_method_id": 501745,
"currency_id": "COP",
"list_cost": 7.5,
"cost": 7.5,
"tracks_shipments_status": "verified",
"display": "recommended",
"speed": {
"shipping": 48,
"handling": null
},
"estimated_delivery": {
"date": null,
"pay_before": null,
"time_from": null,
"time_to": null
},
"discount": {
"rate": 0
}
}
],
"settings": {
"allow_add_cost": null
}
}
Cálculo conforme produto e cidade no MCO (Colômbia)
Cálculo do custo do frete para um produto enviando somente os parâmetros Item_id e City_to.
Exemplo:
GET https://api.mercadolibre.com/items/MCO415774919/shipping_options?city_to=Q08tRENCb2dvdA
Resposta:
{
"destination": {
"zip_code": null,
"city": {
"id": "Q08tRENCb2dvdA",
"name": "Bogotá"
},
"state": {
"id": "CO-DC",
"name": "Bogota D.C."
},
"country": {
"id": "CO",
"name": "Colombia"
}
},
"options": [
{
"id": 523835933,
"name": "Servientrega Normal",
"shipping_method_id": 501745,
"currency_id": "COP",
"list_cost": 5000,
"cost": 0,
"tracks_shipments_status": "verified",
"display": "recommended",
"speed": {
"shipping": 24,
"handling": 72
},
"estimated_delivery": {
"date": "2015-06-22T00:00:00.000-05:00",
"pay_before": null,
"time_from": null,
"time_to": null
},
"discount": {
"rate": 0,
"type": "none",
"promoted_amount": 0
}
}
]
}