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.

Crear sucursal - Sucursales físicas - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

Crear sucursal

POST

https://api.mercadopago.com/users/{user_id}/stores
Este endpoint permite la creación de tiendas físicas para la venta de productos o servicios. Cada cuenta puede establecer múltiples tiendas. Un estado 200 indica que la solicitud se ha procesado con éxito.
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.
BODY
name
string

REQUERIDO

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
Identificador único de la tienda es establecido por el sistema integrador y puede contener hasta 60 caracteres.
location
object

REQUERIDO

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_created
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

UNKNOWN_FIELD

Campo desconocido.

INVALID_NAME

The `name` field must be string - Asegúrese de que el valor de `name` sea textual, sin caracteres numéricos ni especiales.

BAD_REQUEST

Errores causados por inconsistencias en la información de la solicitud. Vea a continuación las posibles respuestas.

bad_request:

The name of the following parameters is wrong [additional_info.payer] - Este error se muestra cuando `additional_info.payer` se informa incorrectamente. En este caso, revise si el nombre ingresado es correcto y realice una nueva solicitud.

bad_request:

The store coordinates are outside the site - Asegúrese de que las coordenadas ingresadas estén dentro del lugar especificado.

INVALID_BUSINESS_HOURS

The `business_hours` field must be a json_object - Verifique el formato e incluya atributos necesarios como horarios de apertura y cierre.

INVALID_DAY

The `day` field must be a json_array - Asegúrese de que el campo contenga un arreglo de nombres de días válidos.

INVALID_LOCATION

The `location` field must be json_object - Verifique que los detalles de la ubicación como la latitud y longitud estén correctamente formateados como JSON.

INVALID_STREET_NAME

The `street_name` field must be string - Confirme que el campo contenga solo información textual sin caracteres especiales o números.

INVALID_STREET_NUMBER

The `street_number` field must be string - Asegúrese de que el campo contenga representaciones textuales de números o caracteres especiales si es necesario.

INVALID_CITY_NAME

The `city_name` field must be a string - Verifique que el campo esté correctamente lleno con nombres de ciudades y no contenga números o caracteres especiales.

INVALID_STATE_NAME

The `state_name` field must be a string - Compruebe que los nombres de estados estén correctamente ingresados sin caracteres numéricos o especiales.

INVALID_REFERENCE

The `reference` field must be a string - Asegúrese de que el campo esté lleno de información textual que ayude a identificar la ubicación.

VALIDATION_ERROR

Este error se genera debido a un fallo o ausencia en algún campo específico. También puede ocurrir cuando no se proporciona un parámetro requerido en la solicitud. Verifique la 'description' o el 'message' asociados al error para obtener más detalles y proceder con la corrección adecuada.

validation_error:

`Name must be defined`. Verifique todos os campos obrigatórios e garanta que todos foram preenchidos conforme indicado na descrição.

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:

location.state_name was invalid - Este error ocurre al insertar el nombre de una ciudad que no corresponde a la ciudad previamente definida. Para corregirlo, verifique los campos 'location.state_name' y 'location.city_name' y asegúrese de que estén completados correctamente. También puede ocurrir cuando hace falta algún parámetro en el request, por favor valide el 'description' o el 'message' del error para más información.

validation_error:

`The business_hours field can't be null`. Por favor, revise el campo `business_hours` e ingrese la información según las instrucciones.

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.

403Error

Forbidden

Usted no tiene permiso para realizar esta operación. Por favor, contacte con un administrador para obtener ayuda y asegúrese de que el user_id utilizado sea el mismo de su cuenta.

Solicitud
curl -X POST \
    'https://api.mercadopago.com/users/{user_id}/stores'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-7719*********832-03141*********ec9309854*********f1e54b5-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": "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"
  }
}'
Respuesta de ejemplo
{
  "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"
}