Inicio
DocumentaciĂłn
Recursos
Partners
Comunidad

Partners

Conoce nuestro programa para agencias o desarrolladores que ofrecen servicios de integraciĂłn y vendedores que quieren contratarlos.

Comunidad

Recibe las Ășltimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

Actualizar sucursal - Sucursales fĂ­sicas - Mercado Pago Developers
¿Qué documentación quieres buscar?

¿No sabes cómo empezar la integración? 

Accede a los primeros pasos
Actualizar sucursal

PUT

https://api.mercadopago.com/users/{user_id}/stores/{id}
Este endpoint permite actualizar los datos de una tienda fĂ­sica. Para utilizarlo, debe proporcionar la identificaciĂłn del vendedor y de la sucursal, junto con los parĂĄmetros que contienen la informaciĂłn que desea actualizar. RecibirĂĄ una respuesta 200 como resultado de una solicitud exitosa.
ParĂĄmetros para la solicitud
PATH
user_id
string

REQUERIDO

El user_id corresponde al collector_id. Se trata del user_id de la cuenta de Mercado Pago que recibe el dinero de las ventas, es decir, la cuenta encargada de recaudar los fondos.
id
string

REQUERIDO

ID de creaciĂłn de la tienda. Al registrar una tienda, recibirĂĄs un ID correspondiente. Este ID se puede utilizar para diversas operaciones, incluida la actualizaciĂłn de datos de la tienda.
BODY
name
string
Nombre de la Sucursal
business_hours
object
Horario comercial. Se divide por dĂ­a de la semana y se permiten hasta cuatro horarios de apertura y cierre por dĂ­a.
external_id
string
El identificador Ășnico de la tienda, establecido por el sistema integrador y puede contener hasta 60 caracteres.
location
object
UbicaciĂłn de la Sucursal
ParĂĄmetros de respuesta
id
string
ID de creaciĂłn de la tienda. Al registrar una tienda, recibirĂĄs un ID correspondiente. Este ID se puede utilizar para diversas operaciones, incluida la actualizaciĂłn de datos de la tienda.
name
string
Nombre de la sucursal.
date_creation
string
Fecha de creaciĂłn de la tienda. Este campo muestra la fecha y hora en el formato ISO 8601, como 2024-08-08T19:29:45.019Z.
business_hours
object
Horario comercial. Se divide por dĂ­a de la semana y se permiten hasta cuatro horarios de apertura y cierre por dĂ­a.
Errores

400Error

bad_request

`Field description too long.` Si recibe este error, verifique el parĂĄmetro external_id y asegĂșrese de que no exceda el lĂ­mite mĂĄximo de 60 caracteres.

bad_request:

`Store coordinates (latitude xxx and longitude xxxx) are invalid`. Este error se muestra cuando se ingresan coordenadas invĂĄlidas en los parĂĄmetros de latitud y longitud. Las 'x' serĂĄn reemplazadas por los valores agregados errĂłneamente. Verifique los parĂĄmetros de longitud y latitud, corrija la informaciĂłn y haga una nueva solicitud.

bad_request:

`external id 'xxx' is already assigned to this user 1234567`. Este error se muestra cuando se ingresa un external_id que ya pertenece a otra tienda en su campo correspondiente. Si recibe este mensaje, verifique el parĂĄmetro external_id y asegĂșrese de que sea Ășnico. Los caracteres 'xxx' serĂĄn reemplazados por la informaciĂłn ingresada.

INVALID_USER_ID

user_id debe ser un nĂșmero.

UNKNOWN_FIELD

Campo desconocido.

INVALID_STORE_ID

store_id invĂĄlido

INVALID_NAME

El campo `name` debe ser una string.

INVALID_BUSINESS_HOURS

El campo `business_hours` debe ser un json_object.

INVALID_DAY

El campo `day` debe ser un json_array.

INVALID_LOCATION

El campo `location` debe ser un json_object.

INVALID_STREET_NAME

El campo `street_name` debe ser una string.

INVALID_STREET_NUMBER

El campo `street_number` debe ser una string.

INVALID_CITY_NAME

El campo `city_name` debe ser una string.

INVALID_STATE_NAME

El campo `state_name` debe ser una string.

INVALID_REFERENCE

El campo `reference` debe ser una string.

validation_error

`Monday exceeds the maximum length of 4 for Opening Hours`. Revise el campo `opening_hours` y asegĂșrese de no exceder el lĂ­mite mĂĄximo de 4 horarios. El dĂ­a de la semana que se devuelve en el cĂłdigo variarĂĄ segĂșn el dĂ­a que estĂ© excediendo la cantidad permitida de horarios.

validation_error:

`Monday has overlapping hours`. Este error ocurre cuando se introducen dĂ­as y horarios que se solapan. El dĂ­a de la semana se devolverĂĄ de acuerdo con los dĂ­as en los que los horarios estĂĄn solapados. Revise los horarios de apertura y asegĂșrese de que ninguno se solape.

validation_error:

`Closing hours must be greater than opening hours`. Revise el parĂĄmetro `business_hours` y asegĂșrese de que los atributos de horarios de apertura y cierre estĂ©n correctos.

validation_error:

`Monday can't be empty`. Este error se muestra siempre que un dĂ­a de la semana se envĂ­a vacĂ­o. El dĂ­a especĂ­fico variarĂĄ segĂșn la informaciĂłn que falte. Revise los parĂĄmetros de business_hours y asegĂșrese de que todos los dĂ­as especificados tengan horarios establecidos.

403Error

Forbidden

`You don't have permission to access the URL on this server`. Si recibe este error, verifique si el store_id utilizado es correcto y haga una nueva solicitud.

Solicitud
curl -X PUT \
    'https://api.mercadopago.com/users/{user_id}/stores/{id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
    -d '{
  "name": "Sucursal Instore 2",
  "business_hours": {
    "monday": [
      {
        "open": "08:00",
        "close": "12:00"
      }
    ],
    "tuesday": [
      {
        "open": "09:00",
        "close": "18:00"
      }
    ]
  },
  "external_id": "SUC002",
  "location": {
    "street_number": "3040",
    "street_name": "Example Street Name.",
    "city_name": "Buenos Aires",
    "state_name": "Buenos Aires.",
    "latitude": -32.8897322,
    "longitude": -68.8443275,
    "reference": "Near to Mercado Pago"
  }
}'
Respuesta de ejemplo
{
  "id": 1234567,
  "name": "Store name",
  "date_creation": "2024-08-08T19:29:45.019Z",
  "business_hours": {
    "monday": [
      {
        "open": "08:00",
        "close": "12:00"
      }
    ]
  },
  "location": {
    "address_line": "Example Street Name, 3039, Buenos Aires, Buenos Aires.",
    "latitude": -32.8897322,
    "longitude": -68.8443275,
    "reference": "Near to Mercado Pago"
  },
  "external_id": "SUC002",
  "date_created": "2019-08-08T19:29:45.019Z"
}