Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 06/07/2023

Horarios de despacho por logística

El recurso /schedule te permite obtener los horarios de despacho que el vendedor necesita, para evitar retrasos e impacto en su reputación. Para consultar esta información, debes conocer los tipos de logísticas habilitadas en su cuenta.



Consultar horarios de despacho

Obtén los datos de los servicios cuando el despacho sea por el vendedor (ME2). Utiliza los parámetros:
user_id: Id del usuario.
logistic_type: Tipo de envío:

  • drop_off: Mercado Envíos
  • xd_drop_off: Mercado Envíos Places
  • self_service: Mercado Envíos Flex
  • cross_docking: Mercado Envíos Colecta
  • Llamada:

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

    Ejemplo:

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

    Respuesta:

    {
       "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 de respuesta

    seller_id: id del vendedor.
    work: indica si el vendedor trabaja ese día. Aplica a todas las logísticas. No tiene en cuenta los feriados.
    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 es el horario de fin de ventana de recolección.
    cutoff: horario de corte.
    carrier.id: para cross_docking es Id del carrier.
    carrier.name: para cross_docking es el nombre del carrier.
    vehicle: para cross_docking es la descripción del vehículo.
    vehicle.id: para cross_docking es el ID del vehículo.
    vehicle.license_plate: para cross_docking es la patente del vehículo.
    vehicle.only_for_today: para cross_docking es si la colecta es solo por el día de hoy.
    vehicle.new_driver: para cross_docking si hubo un cambio en el conductor que pasará.
    driver.id: para cross_docking es el ID del conductor de la colecta.
    driver.name: para cross_docking es el nombre del conductor de la colecta.
    sla:

    drop_off, Flex:

    “same_day”: En el día

    “monday”: lunes

    “tuesday”: martes

    “wednesday”: miércoles

    “thursday”:jueves

    “friday”: viernes

    “satuday”: sábado

    “sunday”: domingo


    Errores

    Error Descripción
    401 (Unauthorized) El usuario no está autorizado para acceder a la información.
    403 (Forbidden) El usuario está intentando acceder a la información de otro.
    404 (not found) El usuario quiere acceder a la información de una logística que no posee.


    Siguiente: Envío gratis.