Inicio
Documentación
Recursos
Certificaciones
Comunidad
Actualizar caja - Cajas - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

Actualizar caja

PUT

https://api.mercadopago.com/pos/{id}
Este endpoint permite actualizar los datos de una caja (punto de venta). Para utilizarlo, es necesario proporcionar la identificación del punto de venta y enviar los parámetros con la información que se debe actualizar.
Parámetros para la solicitud
PATH
id
string

REQUERIDO

ID de creación del punto de venta. Al registrar un punto de venta, recibirás un ID correspondiente. Este ID puede ser utilizado para varias operaciones, incluida la actualización de los datos del punto de venta.
BODY
name
string
Nombre de la caja (punto de venta).
fixed_amount
boolean
Determina si el cliente puede insertar el monto a pagar.
category
number
Código MCC que indica el rubro del punto de venta. Si no se especifica, queda como categoría genérica
Gastronomy: Gastronomía
621102: Argentina
5611203: Brasil
Ver más
store_id
string
Identificador de la sucursal a la que pertenece el punto de venta.
Parámetros de respuesta
id
number
ID de creación del punto de venta. Al registrar un punto de venta, recibirás un ID correspondiente. Este ID puede ser utilizado para varias operaciones, incluida la consulta de los datos del punto de venta.
qr
object
Código QR creado automáticamente para recibir los pagos del punto de venta.
status
string
Estado de la actualización de los datos del punto de venta.
date_created
string
Fecha de creación de la caja. Este campo muestra la fecha y hora en el formato ISO 8601, como 2024-08-08T19:29:45.019Z.
Errores

400Error

MISSING_BODY

El cuerpo del HTTP es requerido para modificar el punto de venta.

UNKNOWN_FIELD_EXCEPTION

El campo indicado no está permitido para esta operación o es desconocido.

INVALID_POS_ID

El ID del punto de venta es inválida, debe ser numérica.

INVALID_NAME

NOMBRE debe ser string.

NAME_TOO_LONG

NAME debe ser menor de 45 caracteres.

INVALID_FIXED_AMOUNT

FIXED_AMOUNT debe ser boolean.

INVALID_CATEGORY

CATEGORY debe ser numérico.

POS_UNKNOWN_MCC

CATEGORY debe ser válida para el sitio del usuario.

POS_INVALID_STORE_ID

STORE_ID debe ser numérico.

INVALID_EXTERNAL_STORE_ID

EXTERNAL_STORE_ID debe ser string.

EXTERNAL_STORE_ID_NOT_MATCH

El EXTERNAL_STORE_ID no hace referencia al STORE_ID indicado.

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_URL

La URL debe ser una cadena y debe tener el formato de una URL válida.

URL_TOO_LONG

La URL debe ser menor de 300 caracteres.

FIXED_AMOUNT_FALSE

Si se indica el campo URL, el campo FIXED_AMOUNT debe ser verdadero. No soportamos la modalidad de monto abierto en este caso.

403Error

1

Si está utilizando el campo URL, el host debe estar habilitado por Mercado Pago. Si no lo está, recibirá este error. Por favor, comuníquese con su asesor técnico asignado.

404Error

1

Si el punto de venta no existe para un ID o EXTERNAL_ID indicado y para el usuario.

409Error

1

Ya existe un punto de venta con el mismo EXTERNAL_ID.

Solicitud
curl -X PUT \
    'https://api.mercadopago.com/pos/{id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-3322*********190-03031*********46528954c*********0339910-1*********' \
    -d '{
  "name": "First POS",
  "fixed_amount": false,
  "category": 621102,
  "store_id": 1234567,
  "external_id": "SUC001POS001",
  "external_store_id": "SUC001"
}'
Respuesta de ejemplo
{
  "id": 2711382,
  "qr": {
    "image": "https://www.mercadopago.com/instore/merchant/qr/2711382/0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1.png",
    "template_document": "https://www.mercadopago.com/instore/merchant/qr/2711382/template_0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1.pdf",
    "template_image": "https://www.mercadopago.com/instore/merchant/qr/2711382/template_0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1.png"
  },
  "status": "active",
  "date_created": "2019-08-22T14:11:12.000Z",
  "date_last_updated": "2019-08-25T15:16:12.000Z",
  "uuid": "0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1",
  "user_id": 446566691,
  "name": "First POS",
  "fixed_amount": false,
  "category": 621102,
  "store_id": 1234567,
  "external_store_id": "SUC001",
  "external_id": "SUC001POS002",
  "site": "MLB",
  "qr_code": "00020101021226940014BR.GOV.BCB.PIX2572pix-qr-h.mercadopago.com/instore/h/p/v2/db12b6e2ec4844839825c6dce7cd2f2243530016com.mercadolibre0129https://mpago.la/pos/212798995204000053039865802BR5924VICTOR CORREA DE ALMEIDA6008CAMPINAS62070503***63040B44"
}