/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.

La búsqueda no arrojó ningún resultado.

Verifica la la ortografía de los términos de búsqueda o prueba con otras palabras clave.