Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 06/07/2023

Horários de despacho por logística

O recurso /schedule permite ao integrador obter informação sobre os horários de despacho que o vendedor necessita para evitar atrasos e impacto na sua reputação. Para consultar esta informação, é necessário saber os tipos de logísticas habilitadas na conta.



Consultar horários de despacho por logística

Obtenha os dados dos serviços quando são parte de ME2 e o despacho é responsabilidade do vendedor, com os parâmetros:

user_id: Id do usuário.

logistic_type: Tipo de logística. Pode ser:

  • drop_off: Mercado Envios
  • xd_drop_off: Mercado Envios Places
  • self_service: Mercado Envios Flex
  • cross_docking: Mercado Envios Coleta
  • Chamada:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/shipping/schedule/$LOGISTIC_TYPE

    Exemplo:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/9984538542/shipping/schedule/cross_docking

    Resposta:

    {
       "seller_id": "84538542",
       "schedule": {
           "monday": {
               "work": true,
               "detail": [
                   {
                       "from": "13:00",
                       "to": "15:00",
                       "cutoff": "12:00",
                       "carrier": {
                           "id": "17501840",
                           "name": "Iflow"
                       },
                       "vehicle": {
                           "id": "12345",
                           "license_plate": "AZ541VW",
                           "vehicle_type": "Camioneta",
                           "only_for_today": false,
                           "new_driver": false
                       },
                       "driver": {
                           "id": "12345",
                           "name": "Test User"
                       },
                       "sla": ""
                   }
               ]
           },
           "tuesday": {
               "work": true,
               "detail": [
                   {
                       "from": "13:00",
                       "to": "15:00",
                       "cutoff": "12:00",
                       "carrier": {
                           "id": "17501840",
                           "name": "Iflow"
                       },
                       "vehicle": {
                           "id": "12345",
                           "license_plate": "AZ541VW",
                           "vehicle_type": "Camioneta",
                           "only_for_today": false,
                           "new_driver": false
                       },
                       "driver": {
                           "id": "12345",
                           "name": "Test User"
                       },
                       "sla": ""
                   }
               ]
           },
           "wednesday": {
               "work": true,
               "detail": [
                   {
                       "from": "13:00",
                       "to": "15:00",
                       "cutoff": "12:00",
                       "carrier": {
                           "id": "17501840",
                           "name": "Iflow"
                       },
                       "vehicle": {
                           "id": "12345",
                           "license_plate": "AZ541VW",
                           "vehicle_type": "Camioneta",
                           "only_for_today": false,
                           "new_driver": false
                       },
                       "driver": {
                           "id": "12345",
                           "name": "Test User"
                       },
                       "sla": ""
                   }
               ]
           },
           "thursday": {
               "work": true,
               "detail": [
                   {
                       "from": "13:00",
                       "to": "15:00",
                       "cutoff": "12:00",
                       "carrier": {
                           "id": "17501840",
                           "name": "Iflow"
                       },
                       "vehicle": {
                           "id": "12345",
                           "license_plate": "AZ541VW",
                           "vehicle_type": "Camioneta",
                           "only_for_today": false,
                           "new_driver": false
                       },
                       "driver": {
                           "id": "12345",
                           "name": "User de prueba"
                       },
                       "sla": ""
                   }
               ]
           },
           "friday": {
               "work": true,
               "detail": [
                   {
                       "from": "13:00",
                       "to": "15:00",
                       "cutoff": "12:00",
                       "carrier": {
                           "id": "17578840",
                           "name": "Iflow"
                       },
                       "vehicle": {
                           "id": "12345",
                           "license_plate": "AZ541VW",
                           "vehicle_type": "Camioneta",
                           "only_for_today": false,
                           "new_driver": false
                       },
                       "driver": {
                           "id": "12345",
                           "name": "Test User"
                       },
                       "sla": ""
                   }
               ]
           },
           "saturday": {
               "work": false,
               "detail": null
           },
           "sunday": {
               "work": false,
               "detail": null
           }
       }
    }

    Campos da resposta

    seller_id: Id do vendedor.
    work: para cross_docking é o horário de início da janela de coleta. Para xd_drop_off é o horário máximo de despacho.
    from: para cross_docking es el horario de inicio de la ventana de recolección. Para xd_drop_off es el horario máximo de despacho.
    to:: para cross_docking é o horário do fim da janela de coleta.
    cutoff: horário de corte.
    carrier.id: para cross_docking é o id da transportadora.
    carrier.name: para cross_docking é o nome da transportadora.
    vehicle: para cross_docking é a descrição do veículo.
    vehicle.id: para cross_docking é o ID do veículo.
    vehicle.license_plate: para cross_docking é a placa do veículo.
    vehicle.only_for_today: para cross_docking informa se a coleta é só para o dia de hoje.
    vehicle.new_driver: para cross_docking informa se houve alteração de motorista que fará a coleta.
    driver.id: para cross_docking é o ID do motorista da coleta.
    driver.name: para cross_docking o nome do motorista da coleta.
    sla:

    drop_off, Flex

    “same_day”: no dia

    “monday”: segunda

    “tuesday”: terça

    “wednesday”: quarta

    “thursday”: quinta

    “friday”: sexta

    “satuday”: sábado

    “sunday”: domingo


    Erros

    Erro Descrição
    401 (Unauthorized) O usuário não está autorizado a acessar as informações.
    403 (Forbidden) O usuário está tentando acessar informações de outro.
    404 (not found) O usuário que acessar informações de uma logística não habilitada na conta.

    Seguinte: Frete grátis.