Inicio
Documentación
Recursos
Certificaciones
Comunidad
Buscar en cajas - Cajas - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

Buscar en cajas

GET

https://api.mercadopago.com/pos
Este endpoint permite encontrar toda la información de las cajas (puntos de venta) creadas utilizando filtros específicos.
Parámetros para la solicitud
QUERY
external_id
string
Identificador único de la caja definido por el integrador.
external_store_id
string
El identificador único de la tienda, establecido por el sistema integrador y puede contener hasta 60 caracteres.
store_id
string
Identificador de la sucursal a la que pertenece el punto de venta.
category
string
Código MCC que indica el rubro del punto de venta. Si no se especifica, queda como categoría genérica.
Parámetros de respuesta
paging
object
Información para paginación de resultados de búsqueda.
results
array
Resultados encontrados a partir de los filtros utilizados para la búsqueda.
Errores

400Error

INVALID_CATEGORY

CATEGORY debe ser numérico.

INVALID_STORE_ID

STORE_ID debe ser numérico.

INVALID_EXTERNAL_STORE_ID

EXTERNAL_STORE_ID debe ser string.

INEXISTENT_EXTERNAL_STORE_ID

El EXTERNAL_STORE_ID no hace referencia a una tienda existente.

INVALID_EXTERNAL_ID

El campo EXTERNAL_ID debe ser alfanumérico, solo letras y números. Sin espacios, guiones o caracteres especiales.

EXTERNAL_ID_TOO_LONG

El EXTERNAL_ID debe ser menor de 40 caracteres.

INVALID_LIMIT

LIMIT debe ser numérico.

INVALID_OFFSET

OFFSET debe ser numérico.

Solicitud
curl -X GET \
    'https://api.mercadopago.com/pos?external_id=SUC001POS001'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
    
Respuesta de ejemplo
{
  "paging": {
    "total": 1,
    "offset": 0,
    "limit": 0
  },
  "results": [
    {
      "user_id": 446566691,
      "name": "Caja Principal",
      "category": 621102,
      "store_id": 1234567,
      "external_id": "SUC001POS001",
      "id": 1988157,
      "qr": {
        "image": "https://www.mercadopago.com/instore/merchant/qr/1988157/1f1da6401a4645e99fa21d3f4ffe0e702c4eab2209784fce9d45c83fa93bd5a7.png",
        "template_document": "https://www.mercadopago.com/instore/merchant/qr/1988157/template_1f1da6401a4645e99fa21d3f4ffe0e702c4eab2209784fce9d45c83fa93bd5a7.pdf",
        "template_image": "https://www.mercadopago.com/instore/merchant/qr/1988157/template_1f1da6401a4645e99fa21d3f4ffe0e702c4eab2209784fce9d45c83fa93bd5a7.png"
      },
      "date_created": "2019-06-24T13:31:56.000Z",
      "date_last_updated": "2019-08-25T15:16:12.000Z",
      "external_store_id": "SUC001"
    }
  ]
}