Notificaciones Pull

Contenidos

El Web Service del carrier debe proporcionar un endpoint HTTP REST contra el cuál Mercado Libre pueda consultar el estado actual de todas las agencias que el correo tiene disponibles por contrato.

POST service_url/agencies

Formato Request

Dentro del body se enviará un objeto JSON con los campos listados a continuación:

Formato Response

Se espera una lista de agencias habilitadas para Mercado Libre con sus correspondientes estados usando los siguientes campos:

Ejemplos

Request:

{
  "country_id": "AR"
  "carrier_information": {
      "user": "",
      "password": ""
    }
  }
}

Response:

Response satisfactorio con open hours detallado:

{
    "agencies": [
        {
            "agency_id": "AAFF29",
            "agency_name": "AGENCIA PICK UP",
            "business_name": "AGENCIA PICK UP",
            "agency_type": "AGENCY",
            "is_movable": false
            "location": {
                "country_name": "Argentina",
                "state_name": "Córdoba",
                "city_name": "Córdoba",
                "city_id": "TUxBQ0NBUGNiZGQx",
                "neighborhood_name": "",
                "street_name": "Av. Colón",
                "street_number": "176",
                "other_info": "",
                "zip_code": "5000",
                "geolocation": {
                    "latitude": -10.4343768,
                    "longitude": -10.42437
                }
            },
            "package_reception": true,
            "pickup_availabilty": true,
            "open_hours": {
                "monday": [
                    {
                        "from": "00:00",
                        "to": "23:59"
                    }
                ],
                "tuesday": [
                    {
                        "from": "08:00",
                        "to": "12:00"
                    },
                    {
                        "from": "14:00",
                        "to": "19:00"
                    }
                ],
                "wednesday": [
                    {
                        "from": "08:00",
                        "to": "12:00"
                    },
                    {
                        "from": "14:00",
                        "to": "19:00"
                    }
                ],
                "thursday": [
                    {
                        "from": "08:00",
                        "to": "12:00"
                    },
                    {
                        "from": "14:00",
                        "to": "19:00"
                    }
                ],
                "friday": [
                    {
                        "from": "08:00",
                        "to": "12:00"
                    },
                    {
                        "from": "14:00",
                        "to": "19:00"
                    }
                ],
                "saturday": [
                    {
                        "from": "09:00",
                        "to": "13:00"
                    },
                    {
                        "from": "15:00",
                        "to": "20:00"
                    }
                ],
                "sunday": null,
                "holidays": null
            },
            "delivery_cell": true,
            "delivery_cell_capacity": {
                "monday": {
                    "max_capacity": 20
                },
                "tuesday": {
                    "max_capacity": 20
                },
                "wednesday": {
                    "max_capacity": 20
                },
                "thursday": {
                    "max_capacity": 20
                },
                "friday": {
                    "max_capacity": 20
                },
                "saturday": {
                    "max_capacity": 0
                },
                "sunday": {
                    "max_capacity": 0
                }
            },
            "status": "active",
            "activation_date": "2017-08-15T12:10:32.000-04:00",
            "deactivation_date": "2019-10-17T00:00:00.000-04:00",
            "replacement_agency_id": "BB223",
            "package_capacity": 3000,
            "volumetric_capacity": 25000,
            "maximum_package_dimensions": {
                "length": 101,
                "height": 101,
                "width": 101,
                "weight": 25000.0
            }
        }
    ]
}

Response satisfactorio con open hours resumido:

{
    "agencies": [
        {
            "agency_id": "AAFF29",
            "agency_name": "AGENCIA PICK UP",
            "business_name": "AGENCIA PICK UP",
            "agency_type": "AGENCY",
            "location": {
                "country_name": "Argentina",
                "state_name": "Córdoba",
                "city_name": "Córdoba",
                "city_id": "TUxBQ0NBUGNiZGQx",
                "neighborhood_name": "",
                "street_name": "Av. Colón",
                "street_number": "176",
                "other_info": "",
                "zip_code": "5000",
                "geolocation": {
                    "latitude": -10.4343768,
                    "longitude": -10.42437
                }
            },
            "package_reception": true,
            "pickup_availabilty": true,
            "open_hours": {
                "monday": [
                    {
                        "from": "00:00",
                        "to": "23:59"
                    }
                ],
                "tuesday": [
                    {
                        "from": "08:00",
                        "to": "12:00"
                    },
                    {
                        "from": "14:00",
                        "to": "19:00"
                    }
                ],
                "wednesday": [
                    {
                        "from": "08:00",
                        "to": "12:00"
                    },
                    {
                        "from": "14:00",
                        "to": "19:00"
                    }
                ],
                "thursday": [
                    {
                        "from": "08:00",
                        "to": "12:00"
                    },
                    {
                        "from": "14:00",
                        "to": "19:00"
                    }
                ],
                "friday": [
                    {
                        "from": "08:00",
                        "to": "12:00"
                    },
                    {
                        "from": "14:00",
                        "to": "19:00"
                    }
                ],
                "saturday": [
                    {
                        "from": "08:00",
                        "to": "12:00"
                    },
                    {
                        "from": "14:00",
                        "to": "19:00"
                    }
                ],
                "sunday": null,
                "holidays": null
            },
            "delivery_cell": true,
            "delivery_cell_capacity": {
                "monday": {
                    "max_capacity": 20
                },
                "tuesday": {
                    "max_capacity": 20
                },
                "wednesday": {
                    "max_capacity": 20
                },
                "thursday": {
                    "max_capacity": 20
                },
                "friday": {
                    "max_capacity": 20
                },
                "saturday": {
                    "max_capacity": 0
                },
                "sunday": {
                    "max_capacity": 0
                }
            },
            "status": "active",
            "activation_date": "2017-08-15T12:10:32.000-04:00",
            "deactivation_date": "2019-10-17T00:00:00.000-04:00",
            "replacement_agency_id": "BB223",
            "package_capacity": 3000,
            "volumetric_capacity": 25000,
            "maximum_package_dimensions": {
                "length": 101,
                "height": 101,
                "width": 101,
                "weight": 25000.0
            }
        }
    ]
}

Failed (400 FAILED)

{
  "status":"FAILED",
  "status_message":"Invalid user"
}

Error (500 ERROR)

{
  "status":"ERROR",
  "status_message":"Internal error occurred"
}