ReferenciaÓrdenesCargar identificadores de dispositivo
POST

Cargar identificadores de dispositivo

Endpoint

https://sellercenter-api.falabella.com/?Action=SetDeviceIdentifiers
POSTCargar identificadores de dispositivo
?Action=SetDeviceIdentifiers
curl -X POST "https://sellercenter-api.falabella.com/" \
  --data-urlencode "Action=SetDeviceIdentifiers" \
  --data-urlencode "OrderId=1" \
  --data-urlencode "OrderItemId=1" \
  --data-urlencode "Imei=VALUE" \
  --data-urlencode "Format=XML" \
  --data-urlencode "Timestamp=2015-07-01T11:11:00+0000" \
  --data-urlencode "[email protected]" \
  --data-urlencode "Version=1.0" \
  --data-urlencode "Signature=YOUR_SIGNATURE" \
  --data-binary @request.xml
# request.xml
<?xml version="1.0" encoding="UTF-8" ?>
<Request>
    <OrderId>1001715169</OrderId>
    <OrderItems>
        <OrderItem>
            <OrderItemId>101373231</OrderItemId>
            <Imei>123456789012347</Imei>
            <Imei>356938035643809</Imei>
            <Imei>352099001761481</Imei>
            <SerialNumber>ABC123</SerialNumber>
        </OrderItem>
    </OrderItems>
</Request>

Aplica solo para sellers que venden bajo el modelo internacional

Por requisitos aduaneros, los productos con SIM vendidos bajo el modelo internacional deben declarar los identificadores del equipo antes del despacho. Los identificadores se incluyen en la etiqueta de envío. Los productos sin SIM no requieren esta carga.

Aplicabilidad por país

País¿Aplica?Identificadores requeridos
PerúSíIMEI + Número de serie (S/N)
ColombiaSíIMEI
ChileNo aplica—
Este endpoint permite cargar los identificadores del equipo (IMEI y número de serie) de los ítems de una orden que utilizan tarjeta SIM, en Perú y Colombia. Los ítems que los requieren se identifican con RequiresDeviceIdentifiers = true en GetOrderItems y GetMultipleOrderItems.
Los identificadores se pueden cargar una sola vez por ítem. Una vez cargados correctamente, RequiresDeviceIdentifiers cambia a false y, tras unos minutos, se habilitan PackageId, TrackingCode y la etiqueta de envío. Consulta el detalle en la página "[Internacional] Flujo de carga de IMEI / S/N para productos con SIM".

Parámetros

Action

string
Requerido
Nombre de la función que se va a llamar. Es obligatorio y debe ser 'SetDeviceIdentifiers' en este caso. Si se omite, se devuelve un error 'E001: Parameter Action is mandatory'. Si se suministra una cadena de función desconocida, se devuelve un mensaje de error 'E008: Invalid Action'.

Format

string
Opcional
Si se suministra, debe ser "JSON" o "XML". Si no se suministra, se asume que es "XML".

Timestamp

date
Requerido
La hora actual en formato ISO8601 relativo a UTC (por ejemplo, Timestamp=2015-04-01T10:00:00+02:00 para Berlín), para que las llamadas no puedan ser reproducidas por un tercero que las escuche (es decir, las llamadas demasiado lejanas en el pasado o en el futuro producen un mensaje de error). Obligatorio. Si no se suministra, aparece el mensaje de error 'E001: Parameter Timestamp is mandatory'. Si la marca de tiempo es demasiado antigua o está en el futuro, aparece un mensaje de error 'E003: Timestamp has expired'.

UserID

string
Requerido
El ID del usuario que realiza la llamada. La lista de usuarios autorizados se mantiene en la interfaz web de Seller Center en Configuración/Gestión de usuarios.

Version

string
Requerido
La versión de la API contra la que se va a ejecutar esta llamada, en formato mayor-punto-menor. Debe ser actualmente 1.0, aunque la versión real de la API sea 2.6.20. Si se omite, se devuelve un mensaje de error 'E001: Parameter Version is mandatory'.

Cuerpo de la solicitud

OrderId

string
Requerido
Identificador de la orden a la que se agregan los identificadores.

OrderItemId

string
Requerido
Identificador único de cada ítem de la orden.

Imei

string
Requerido
IMEI del equipo. Máximo 3 por ítem, de exactamente 15 dígitos y que cumpla el checksum de Luhn. La etiqueta se repite por cada IMEI.

SerialNumber

string
Requerido en Perú
Número de serie del equipo, de 3 a 20 letras o dígitos ASCII. Aplica solo para Perú; en Colombia no se envía.

Ejemplo de cuerpo:

<?xml version="1.0" encoding="UTF-8" ?>
<Request>
    <OrderId>1001715169</OrderId>
    <OrderItems>
        <OrderItem>
            <OrderItemId>101373231</OrderItemId>
            <Imei>123456789012347</Imei>
            <Imei>356938035643809</Imei>
            <Imei>352099001761481</Imei>
            <SerialNumber>ABC123</SerialNumber>
        </OrderItem>
    </OrderItems>
</Request>

Comportamiento de la solicitud

  • ●La solicitud debe incluir todos los ítems de la orden que requieren identificadores (error E130 si se omite alguno).
  • ●La solicitud se procesa de forma atómica: si los datos de uno de los ítems son incorrectos, no se procesa ninguno. Corrige los datos y envía la solicitud completa nuevamente.
  • ●No hay un máximo definido de ítems por solicitud. En la práctica, la mayoría de las órdenes tienen un solo ítem que requiere identificadores.

Respuesta 200

Los campos de respuesta proporcionados por esta API se encuentran detallados en la siguiente tabla:

NombreTipoDescripción
OrderIdStringIdentificador de la orden.
OrderItemIdStringIdentificador de cada ítem de la solicitud, cuyos identificadores se cargaron correctamente.
<?xml version="1.0" encoding="UTF-8"?>
<SuccessResponse>
    <Head>
        <RequestId/>
        <RequestAction>SetDeviceIdentifiers</RequestAction>
        <ResponseType/>
        <Timestamp>2026-09-16T13:58:19.261Z</Timestamp>
        <RequestParameters/>
    </Head>
    <Body>
        <OrderId>1001715169</OrderId>
        <OrderItems>
            <OrderItem>
                <OrderItemId>101373231</OrderItemId>
            </OrderItem>
        </OrderItems>
    </Body>
</SuccessResponse>

Errores

HTTPCódigoCondiciónDescripción
40416E016: "<OrderId>" Invalid Order IDNo se encontró la orden del seller para el OrderId enviado.
40420E020: "<OrderItemId>" Invalid Order Item IDUno o más OrderItemId enviados no pertenecen a la orden.
400125E125: "<OrderItemId>" Device identifiers are not required for this itemEl ítem enviado no requiere IMEI ni número de serie.
400126E126: "<OrderItemId>" Device identifiers were already submitted for this itemLos identificadores ya se cargaron correctamente para el ítem.
400127E127: "<IMEI>" Duplicate IMEI in requestEl mismo IMEI aparece más de una vez en la solicitud, incluso entre distintos ítems.
400128E128: At least 1 IMEI is requiredUn ítem no tiene IMEI.
400128E128: "<IMEI>" Invalid IMEIEl IMEI no tiene exactamente 15 dígitos o no cumple el checksum de Luhn.
400128E128: Reached maximum no. of IMEI (3) allowed per itemSe enviaron más de tres IMEI para un ítem.
400129E129: "" Serial Number is requiredFalta el número de serie en una solicitud que no es de Colombia.
400129E129: "<SerialNumber>" Invalid Serial NumberEl número de serie no tiene entre 3 y 20 letras o dígitos ASCII.
400130E130: "<OrderItemId>" Device identifiers are required for this itemLa orden contiene un ítem que requiere identificadores y se omitió de la solicitud.
400131E131: "<OrderItemId>" Duplicate Order Item ID in requestEl mismo OrderItemId aparece más de una vez en la solicitud.
400132E132: "<IMEI>" Duplicate Serial Number in requestEl mismo número de serie aparece más de una vez en la solicitud, incluso entre distintos ítems.

Ejemplo de respuesta de error:

<?xml version="1.0" encoding="UTF-8"?>
<ErrorResponse>
    <Head>
        <RequestAction>SetDeviceIdentifiers</RequestAction>
        <ErrorType>Sender</ErrorType>
        <ErrorCode>126</ErrorCode>
        <ErrorMessage>E126: "101373231" Device identifiers were already submitted for this item</ErrorMessage>
    </Head>
    <Body/>
</ErrorResponse>
Los valores <USER_ID> y <SIGNATURE> son marcadores de posición.