Inicio
DocumentaciĂłn
Recursos
Partners
Comunidad

Recursos

Revisa las actualizaciones de nuestras soluciones y operatividad del sistema o pide soporte técnico.

Partners

Conoce nuestro programa para agencias o desarrolladores que ofrecen servicios de integraciĂłn y vendedores que quieren contratarlos.

Comunidad

Recibe las Ășltimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

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-7434*********159-03141*********cee51edf8*********f94f589-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"
}