Este endpoint possibilita a criação de lojas físicas para a venda de produtos ou serviços. Cada conta pode estabelecer múltiplas lojas. Um status 200 indica que a solicitação foi processada com sucesso.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
400Erro
UNKNOWN_FIELD
Campo desconhecido.
INVALID_NAME
The `name` field must be string - Garanta que o valor de `name` seja textual, sem caracteres numéricos ou especiais.
BAD_REQUEST
Erros causados por inconsistências nas informações do request. Veja abaixo os possíveis retornos.
bad_request:
The name of the following parameters is wrong [additional_info.payer] - Esse erro é exibido quando em additional_info.payer é informado erroneamente. Neste caso, revise se o nome inserido está correto e faça uma nova requisição.bad_request:
The store coordinates are outside the site - Garanta que as coordenadas inseridas estejam dentro do local determinado.INVALID_BUSINESS_HOURS
The `business_hours` field must be a json_object - Verifique o formato e inclua atributos necessários como horários de abertura e fechamento.
INVALID_DAY
The `day` field must be a json_array - Certifique-se de que o campo contenha um array de nomes de dias válidos.
INVALID_LOCATION
The `location` field must be json_object - Verifique se os detalhes da localização, como latitude e longitude, estão corretamente formatados como JSON.
INVALID_STREET_NAME
The `street_name` field must be string - Confirme que o campo contenha apenas informações textuais, sem caracteres especiais ou números.
INVALID_STREET_NUMBER
The `street_number` field must be string - Garanta que o campo contenha representações textuais de números ou caracteres especiais, se necessário.
INVALID_CITY_NAME
The `city_name` field must be a string - Verifique se o campo está corretamente preenchido com nomes de cidades e não contém números ou caracteres especiais.
INVALID_STATE_NAME
The `state_name` field must be a string - Verifique se os nomes dos estados estão corretamente inseridos, sem caracteres numéricos ou especiais.
INVALID_REFERENCE
The `reference` field must be a string - Garanta que o campo esteja preenchido com informações textuais que ajudem a identificar a localização.
VALIDATION_ERROR
Este erro é gerado devido a uma falha ou ausência em algum campo específico. Também pode ocorrer quando um parâmetro necessário não é fornecido na solicitação. Verifique a 'description' ou o 'message' associados ao erro para obter mais detalhes e proceder com a correção adequada.
validation_error:
`Name must be defined`. Verifique todos los campos obligatorios y asegúrese de que todos se hayan completado según lo indicado en la descripción.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:
location.state_name was invalid - Esse erro ocorre ao inserir o nome de uma cidade que não corresponde à cidade previamente definida. Para corrigi-lo, verifique os campos 'location.state_name' e 'location.city_name' e certifique-se de que estejam preenchidos corretamente. Também pode ocorrer quando falta algum parâmetro na solicitação, por favor, valide a 'description' ou o 'message' do erro para mais informações.validation_error:
`The business_hours field can't be null`. Verifique o campo `business_hours` e insira as informações conforme orientação.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.403Erro
Forbidden
Você não tem permissão para realizar esta operação. Por favor, entre em contato com um administrador para obter ajuda e garanta que o user_id utilizado seja o mesmo da sua conta.
curl -X POST \
'https://api.mercadopago.com/users/{user_id}/stores'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********88776-122*********fc20dede6*********a497d7225*********64' \
-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": "0123",
"street_name": "Example Street Name.",
"city_name": "City name.",
"state_name": "State name.",
"latitude": 27.175193925922862,
"longitude": 78.04213533235064,
"reference": "Near to Mercado Pago"
}
}'{
"id": 1234567,
"name": "Sucursal Instore",
"date_created": "2019-08-08T19:29:45.019Z",
"business_hours": {
"monday": [
{
"open": "08:00",
"close": "12:00"
}
],
"tuesday": [
{
"open": "09:00",
"close": "18: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": "SUC001"
}