Buscar en cajas - Cajas - Mercado Pago Developers
Buscar en cajas

Este endpoint permite encontrar toda la información de las cajas (puntos de venta) creadas utilizando filtros específicos.

GET

https://api.mercadopago.com/pos
Request parameters
Header
Authorization
string

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
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.
Response parameters
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.
Errors

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.

Informa datos válidos en los request parameters antes de la ejecución.
Request
curl -X GET \
    'https://api.mercadopago.com/pos?external_id=SUC001POS001'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
    
Response
{
  "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"
    }
  ]
}