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-7434*********159-03141*********cee51edf8*********f94f589-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"
}