/instore/qr/seller/collectors/:user_id/stores/:external_store_id/pos/:external_pos_id/orders
BASE URI https://api.mercadopago.com/instore/qr/seller/collectors/{user_id}/stores/{external_store_id}/pos/{external_pos_id}/orders
HTTP Request
curl
curl -X PUT \
'https://api.mercadopago.com/instore/qr/seller/collectors/USER_ID/stores/EXTERNAL_STORE_ID/pos/EXTERNAL_POS_ID/orders' \
-H 'Authorization: Bearer PROD_ACCESS_TOKEN' \
-d '{
"external_reference": "order-id-1234",
"title": "Compra",
"description": "Compra en Mercado Pago",
"notification_url": "www.yourserver.com",
"expiration_date": "2023-08-22T16:34:56.559-04:00",
"total_amount": 100.0,
"items": [
{
"sku_number": "KS955RUR",
"category": "COMIDA",
"title": "Pasta",
"description": "Compra en Mercado Pago",
"unit_price": 20,
"quantity": 5,
"unit_measure": "unit",
"total_amount": 100
}
],
"sponsor": {
"id": 446566691
}
}'
Request Params
ParameterTypeDescription
user_id
String
Identificador del usuario. (Obligatorio)
external_store_id
String
External_id de la sucursal, definido por el integrador (external_id). (Obligatorio)
external_pos_id
String
External_id de la caja/punto de venta, definido por el integrador. (Obligatorio)
external_reference
String(256)
Referencia que puede sincronizar con su sistema de venta. (Obligatorio)
title
String(256)
Título de la compra. (Obligatorio)
description
String(256)
Descripción de la compra.
notification_url
String(500)
URL a la cual se enviará la notificación de pago o merchant_order.
expiration_date
String(500)
Data de expiración de la orden con formato "2020-08-22T16:34:56.559-04:00".
total_amount
Double
Monto total de la transacción en moneda local. (Obligatorio)
items
Array(Object)
Información de los productos involucrados en la orden.
sku_number
String
Código de artículo.
category
String
Categoría del ítem.
title
String
Título del ítem. (Obligatorio)
description
String
Descripción del ítem.
unit_price
Double
Precio unitario del producto (máximo 2 decimales). (Obligatorio)
quantity
Integer
Cantidad de unidades del ítem. (Obligatorio)
unit_measure
String
Unidad de medida del ítem. (Obligatorio)
total_amount
String
URL de imagen del producto. (Obligatorio)
sponsor
Object
Información del integrador.
id
Long
USER_ID de la cuenta de Mercado Pago del sistema integrador.
cash_out
Object
Extracción de efectivo.
amount
Double
Monto a retirar en moneda local.
Error Codes
CodeDescription
400 BAD_REQUEST
invalid_collectorId
user_id debe ser un número.
invalid_externalPosId
externalPosId debe estar presente.
invalid_external_reference
external_reference debe ser un string.
invalid_total_amount
total_amount debe ser un número.
invalid_items.sku_number
items.sku_number debe ser un string.
invalid_items.category
items.category debe ser un string.
invalid_items.title
items.title debe ser un string.
invalid_items.description
items.description debe ser un string.
invalid_items.unit_measure
items.unit_measure debe ser un string.
invalid_items.quantity
items.quantity debe ser un número.
invalid_items.currency_id
items.currency_id debe ser un string.
invalid_items.unit_price
items.unit_price debe ser un número.
invalid_items.total_amount
items.total_amount debe ser un número.
invalid_title
titulo debe estar presente.
invalid_unit_measure
unit_measure debe estar presente.
invalid_quantity
quantity debe estar presente.
invalid_unit_price
unit_price debe estar presente.
invalid_total_amount
total_amount debe estar presente.
invalid_title
title debe ser un string.
invalid_description
description debe ser un string.
invalid_sponsor.id
sponsor.id debe ser un número.
invalid_id
sponsor.id debe estar presente.
invalid_cash_out.amount
cash_out.amount debe ser un número.
invalid_amount
cash_out.amount debe estar presente.
invalid_external_reference
external_reference debe estar presente.
invalid_description
description debe estar presente.
error_creating_seller_qr_order
cash_out es requerido para una orden sin ítems.
invalid_expiration_date
Fecha de expiración debe ser una fecha futura válida.
500 SERVER_ERROR
in_store_order_creation_error
Error al intentar crear una orden.