Calcular o custo do frete e o handling time

Em nosso Marketplace, os vendedores terão uma calculadora de fretes na página de descrição de produtos. Através dela, os compradores saberão o custo do frete e o handling time.
Você pode utilizar nossos recursos para calculá-los com base nas informações disponíveis.

Assuntos:

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.
  • id: ID da cidade de destino.
    name (nome): Nome da cidade de destino.

  • state (estado): Informações sobre o estado de destino.
  • id: Destination state id.
    name (nome): ID do estado de destino.

  • country: Nome do estado de destino.
  • id: ID do país de destino.
    name (nome): Nome do país de destino.

  • extended_attributes (atributos extendidos): Informações adicionais do endereço 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.
  • 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.

  • display: ID do modo de envio para processamento inicial.
  • 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.

  • speed (velocidade): Informações sobre a velocidade da entrega.
  • 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
      }
    }
  ]
}

Cálculo conforme usuário e CEP

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
      }
    }
  ]
}

Qualifique entre 1 e 5