Crear caja/posGenera un punto de venta en una sucursal. Cada caja tendrá vinculado un código QR unívoco.
POST
Productos que lo utilizan:
Parámetros para la solicitud
category
Localización: bodyCódigo MCC que indica el rubro del Punto de Venta. Si no se especifica, queda como categoría genéricanumber
Gastronomy:
621102: Argentina
5611203: Brazil
5812: Mexico
5611: Colombia
5520: Peru
56101: Uruguay
561000: Chile
Gas station:
473000: Argentina
4731300: Brazil
468419: Mexico
4731: Colombia
5050: Peru
47300: Uruguay
473001: Chile
external_id
Localización: bodyIdentificador único de la caja definido por el integradorstring
external_store_id
Localización: bodyExternal_id de la sucursal a la cual pertenece la caja, definido por el integradorstring
fixed_amount
Localización: bodyDetermina si el cliente puede insertar el monto a pagarboolean
Parámetros de respuesta
id
Localización: bodyidnumber
qr
Localización: bodyqrobject
status
Localización: bodystatusstring
date_created
Localización: bodydate_createdstring
Solicitud
curl
curl -X POST \
'https://api.mercadopago.com/pos' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"name": "First POS",
"fixed_amount": false,
"store_id": 1234567,
"external_store_id": "SUC001",
"external_id": "SUC001POS001",
"category": 621102
}'
Respuesta
json
{
"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-22T14:11:12.000Z",
"uuid": "0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1",
"user_id": 446566691,
"name": "First POS",
"fixed_amount": false,
"category": 621102,
"store_id": 1234567,
"external_store_id": "SUC001",
"external_id": "SUC001POS001"
}
Errores
400bad_request
MISSING_BODY
UNKNOWN_FIELD_EXCEPTIONEl campo indicado no se permite para esta operación o es desconocido.
INVALID_NAMENombre inválido. Debe ser String.
NAME_TOO_LONGEl NAME debe ser menor a 45 caracteres.
INVALID_FIXED_AMOUNTEl campo FIXED_AMOUNT debe ser Boolean.
INVALID_CATEGORYEl campo CATEGORY debe ser numérico.
UNKNOWN_MCCEl campo CATEGORY debe ser uno válido para el site del usuario.
INVALID_STORE_IDEl campo STORE_ID debe ser numérico.
INVALID_EXTERNAL_STORE_IDEXTERNAL_STORE_ID muste be string
EXTERNAL_STORE_ID_NOT_MATCHEl campo EXTERNAL_STORE_ID no hace referencia al STORE_ID indicado.
INEXISTENT_EXTERNAL_STORE_IDEl campo EXTERNAL_STORE_ID no hace referencia a ningún sucursal existente.
INVALID_EXTERNAL_IDEl campo EXTERNAL_ID debe ser alfanumérico, solo letras y números. Sin espacios ni guiones, ni caracteres especiales.
EXTERNAL_ID_TOO_LONGEl campo EXTERNAL_ID debe ser menor a 40 caracteres.
INVALID_URLThe URL must be string and muste have the format of a valid url
URL_TOO_LONGEl campo URL debe ser menor a 300 caracteres.
FIXED_AMOUNT_FALSESi se indica el campo URL, el campo FIXED_AMOUNT debe ser true. No soportamos la modalidad de monto abierto en este caso.
403bad_request
1Si estás usando el campo URL, el host de la misma tiene que estar habilitado por Mercado Pago. Si no lo está, recibirás este error. Por favor contactá a tu asesor técnico asignado.
404bad_request
1Si no existe el POS para un ID o EXTERNAL_ID y user indicados.
409bad_request
1Ya existe una caja con el mismo EXTERNAL_ID.