DocumentaciónAPI ReferenceFlujo Internacional IMEI / S/N

[Internacional] Flujo de carga de IMEI / S/N para productos con SIM

Requisitos de identificadores para productos con SIM del modelo internacional en Perú y Colombia.

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)
Colombia	Sí	IMEI
Chile	No aplica	—

Cómo funciona

Para cada ítem, GetOrderItems o GetMultipleOrderItems indica mediante RequiresDeviceIdentifiers si se requieren identificadores. Si el valor es true, carga los identificadores correspondientes al país con SetDeviceIdentifiers. Después de una carga exitosa, el indicador cambia a false; PackageId, TrackingCode y la etiqueta pueden estar disponibles unos minutos después.

Flujo

●Una vez registrada la nueva venta, usa GetOrderItems para obtener los items. Para lotes, usa GetMultipleOrderItems. Revisa el campo RequiresDeviceIdentifiers de cada línea.
●Si el valor es true, carga los identificadores correspondientes al país con SetDeviceIdentifiers. Consulta la referencia en "Cargar identificadores de dispositivo".
●Confirma que RequiresDeviceIdentifiers cambió a false.
●Obtén el PackageId y el TrackingCode con GetOrderItems. Si aún no están disponibles, reintenta pasados 2 minutos.
●Con estos datos disponibles, se recomienda marcar el producto como listo para recolección con SetStatusToReadyToShip y luego generar la etiqueta con GetDocument. Ambas acciones no son necesariamente secuenciales.

APIs del flujo

●GetOrderItems — Incluye RequiresDeviceIdentifiers. Mientras sea true, PackageId y TrackingCode se devuelven vacíos.
●GetMultipleOrderItems — Igual que GetOrderItems, para un array de órdenes.
●SetDeviceIdentifiers — Carga los identificadores de cada ítem.
●GetDocument — Devuelve error E132 si los identificadores no se han cargado. Una vez cargados, la etiqueta los incluye.
●GetTrackingCode — (API antigua) Devuelve error E133 si los identificadores no se han cargado.
●SetStatusToReadyToShip — No es posible usarlo hasta que existan PackageId y TrackingCode.

Comportamiento mientras los identificadores están pendientes

Ejemplo de error en GetDocument:

<ErrorResponse>
  <Head>
    <RequestAction>GetDocument</RequestAction>
    <ErrorType>Sender</ErrorType>
    <ErrorCode>132</ErrorCode>
    <ErrorMessage>E132: Shipping label not available for OrderItemId(s) "59302655". IMEI/Serial Number must be submitted before the label can be generated.</ErrorMessage>
  </Head>
  <Body/>
</ErrorResponse>

Ejemplo de error en GetTrackingCode:

<ErrorResponse>
  <Head>
    <RequestAction>GetTrackingCode</RequestAction>
    <ErrorType>Sender</ErrorType>
    <ErrorCode>133</ErrorCode>
    <ErrorMessage>E133: Tracking code not available for OrderItemId(s) "59302655". IMEI/Serial Number must be submitted before tracking is generated.</ErrorMessage>
  </Head>
  <Body/>
</ErrorResponse>

Disponibilidad después de la carga

Una vez cargados los identificadores, la habilitación de PackageId, TrackingCode, la etiqueta y GetTrackingCode puede tardar algunos minutos. Si los datos aún no están disponibles, recomendamos reintentar la consulta pasados 2 minutos.

¿Qué hago si cargué un identificador incorrecto?

Los identificadores se pueden cargar una sola vez por ítem. Si se intenta enviarlos nuevamente, SetDeviceIdentifiers responde con el error E126. No existe un mecanismo para modificarlos: la orden debe cancelarse con SetStatusToCanceled, mientras se encuentre en estado pending.