Inicio
Documentación
Recursos
Certificaciones
Comunidad

Recursos

Revisa las actualizaciones de nuestras soluciones y operatividad del sistema o pide soporte técnico.

Comunidad

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

Actualizar sucursal - Sucursales físicas - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

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. Es fundamental que este campo se complete con los datos reales de la ubicación de la tienda, ya que esto puede evitar problemas relacionados con la cobranza de impuestos. Además, un llenado corr...Ver más
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-3322*********190-03031*********46528954c*********0339910-1*********' \
    -d '{
  "name": "Sucursal Instore",
  "business_hours": {
    "monday": [
      {
        "open": "08:00",
        "close": "12:00"
      }
    ],
    "tuesday": [
      {
        "open": "09:00",
        "close": "18:00"
      }
    ]
  },
  "external_id": "SUC001",
  "location": {
    "street_number": "3040",
    "street_name": "Example Street Name.",
    "city_name": "City name.",
    "state_name": "State name.",
    "latitude": 27.175193925922862,
    "longitude": 78.04213533235064,
    "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, 0123, City name, State name.",
    "latitude": 27.175193925922862,
    "longitude": 78.04213533235064,
    "reference": "Near to Mercado Pago"
  },
  "external_id": "SUC002",
  "date_created": "2019-08-08T19:29:45.019Z"
}