Inicio
Documentação
Recursos
Parcerias
Comunidade

Recursos

Confira as atualizações das nossas soluções e do funcionamento do sistema ou peça suporte técnico.

Parcerias

Conheça nosso programa para agências ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratá-los.

Comunidade

Fique por dentro das últimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Atualizar loja - Lojas físicas - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Atualizar loja

PUT

https://api.mercadopago.com/users/{user_id}/stores/{id}
Este endpoint permite a atualização dos dados de um estabelecimento físico. Para utilizá-lo, é necessário fornecer a identificação do vendedor e da filial, além de enviar os parâmetros com as informações a serem atualizadas. Você receberá uma resposta 200 como resultado de uma requisição bem sucedida.
Parâmetros de requisição
PATH
user_id
string

OBRIGATÓRIO

O user_id corresponde ao collector_id. Trata-se do user_id da conta do Mercado Pago que recebe o dinheiro das vendas, ou seja, a conta responsável pela arrecadação dos valores.
id
string

OBRIGATÓRIO

ID de criação da loja. Ao registrar uma loja, você receberá um ID correspondente. Esse ID pode ser utilizado para várias operações, incluindo a atualização de dados da loja.
BODY
name
string
Nome da loja
business_hours
object
Horário comercial. Eles são divididos por dia da semana e são permitidos até quatro horários de abertura e fechamento por dia.
external_id
string
Identificador único da loja, definido pelo sistema integrador e pode conter até 60 caracteres.
location
object
Localização da loja. É fundamental que este campo seja preenchido com os dados reais da localização da loja, pois isso pode evitar problemas relacionados à cobrança de impostos. Além disso, o preenchimento correto garant...Ver mais
Parâmetros de resposta
id
string
ID de criação da loja. Ao registrar uma loja, você receberá um ID correspondente. Esse ID pode ser utilizado para várias operações, incluindo a atualização de dados da loja.
name
string
Nome da loja.
date_creation
string
Data de criação da loja. Este campo exibe a data e hora no formato ISO 8601, como 2024-08-08T19:29:45.019Z.
business_hours
object
Horário comercial. Eles são divididos por dia da semana e são permitidos até quatro horários de abertura e fechamento por dia.
Erros

400Erro

bad_request

`Field description too long.` Ao receber esse erro, verifique o parâmetro `external_id` e garanta que ele não exceda o limite máximo de 60 caracteres.

bad_request:

`Store coordinates (latitude xxx and longitude xxxx) are invalid`. Este erro é exibido quando coordenadas inválidas são inseridas nos parâmetros de latitude e longitude. Os 'x' serão substituídos pelos valores erroneamente adicionados. Verifique os parâmetros de longitude e latitude, corrija as informações e faça uma nova requisição.

bad_request:

`external id 'xxx' is already assigned to this user 1234567. Este erro é exibido quando um `external_id` que já pertence a outra loja, é inserido no seu respectivo campo. Caso receba este retorno, verifique o parâmetro `external_id` e garanta que o mesmo seja único. Os caracteres 'xxx' serão substituídos pela informação inserida erroneamente.

INVALID_USER_ID

user_id deve ser um número.

UNKNOWN_FIELD

Campo desconhecido.

INVALID_STORE_ID

store_id inválido

INVALID_NAME

O campo `name` deve ser uma string.

INVALID_BUSINESS_HOURS

O campo `business_hours` deve ser um json_object.

INVALID_DAY

O campo `day` deve ser um json_array.

INVALID_LOCATION

O campo `location` deve ser um json_object.

INVALID_STREET_NAME

O campo `stret_name` deve ser uma string.

INVALID_STREET_NUMBER

O campo `street_number` deve ser uma string.

INVALID_CITY_NAME

O campo `city_name` deve ser uma string.

INVALID_STATE_NAME

O campo `state_name` deve ser uma string.

INVALID_REFERENCE

O campo `reference` deve ser uma string.

validation_error

`Monday exceeds the maximum length of 4 for Opening Hours`. Revise o campo `opening_hours` e garanta não exceder o limite máximo de 4 horários. O dia da semana retornado no código irá variar de acordo com o dia que está excedendo a quantidade de horários permitida.

validation_error:

`Monday has overlapping hours`. Este erro ocorre quando se insere dias e horários que se sobrepõem. O dia da semana retornará de acordo com os dias em que os horários estão sobrepostos. Revise os horários de abertura e garanta que nenhum se sobreponha.

validation_error:

`Closing hours must be greater than opening hours`. Revise o parâmetro `business_hours` e garanta que os atributos de horários de abertura e encerramento estejam corretos.

validation_error:

`Monday can't be empty`. Este erro é exibido sempre que um dia da semana é enviado vazio. O dia irá variar de acordo com a informação que ficou faltando. Revise os parâmetros de business_hours e garanta que os dias definidos tenham horários estabelecidos.

403Erro

Forbidden

`You don't have permission to access the URL on this server.` Caso receba esse erro, verifique se o store_id utilizado está correto e faça uma nova requisição.

Requisição
curl -X PUT \
    'https://api.mercadopago.com/users/{user_id}/stores/{id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-4599*********755-11221*********d497ae962*********ecf8d85-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"
  }
}'
Resposta de exemplo
{
  "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"
}