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.

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

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