The Factory Test or Test Ready feature allows testing of sim cards without having to pay for the monthly sim hosting fees. Sim cards in “Factory test” are allowed to consume 100KB of data and 10 SMS MT/MO free of charge for sim testing purpose. After the consumption of “allowed data/sms limit in Factory Test status, sim cards will automatically transition to “Activated” status.

1. SIM Statuses
2. Sim lifecycle
3. What is Factory-Test feature?
4. Factory Test guide
   • Factory test activation via the Portal
   • Factory test activation via API
     • 1. Register your SIM
     • 2. Patch your sim to “Factory Test”
5. Additional Information

SIM Statuses

EMnify sims have the following sim Id’s and status:
id:0 → Issued
id:1 → Activated
id:2 → Suspended
id:3 → Deleted
id:4 → Factory Test

Sim lifecycle

EMnify sim life-cycle is easy to understand and easy to manage. After the registration, the sim cards move between different status depending on customer need and requirement.

Sim Registration: This is not a sim status but a registration process to enable your sim cards to be registered within your organization.

Issued: After registration, the sim status will be set to “Issued”. Sim cards in “Issued” status can be patched to “Factory Test” or “Activated” status. It is not possible to transition sim status back to “Issued” from any other sim statuses.

Activated: When sim cards are activated, they are in “Activated” status. In this status, sim cards will allow usage of radio access network and you will be billed for any SIM card in this status. Sim cards can transition to “Activated” status from "Issued", “Factory Test” or “Suspended” statuses. From “Activated” status, sim cards can only transition back -and-forth to and from “Suspended” status. Transition from “Activated” to “Factory Test” is not allowed.

Factory Test: Sim cards in “Factory test” are allowed to consume 100KB of data and 10 SMS MT/MO free of charge for sim testing purpose. Sim cards can patched to “Factory Test” from “Issued” status but no other sim status can transition to “Factory Test” status. After the consumption of “allowed data/sms limit in Factory Test status, sim cards will automatically transition to “Activated” status.

Suspended: In the “Suspended” sim status, the sim cards will not connect/attach to any wireless network. A sim card can transition back-and-forth between “Suspended” and “Activated” statuses.

What is Factory-Test feature?

Factory Test feature, built for sim testing purpose, allows customers to test sim cards prior to their deployment in the production environment. Sim cards in “Factory Test” status provides 100KB of data usage and 10 SMS MT/MO free of charge. In this status, customers will not be charged for sim hosting fees nor the limited data consumption provided, will affect inclusive or pooled volume.

Factory Test guide

Factory test activation via the Portal

Patching of sim cards is only allowed via API and is not possible from the portal.

Factory test activation via API

1. Register your SIM

Use the BIC 1 or 2 to register your SIM.

2. Patch your sim to “Factory Test”

A sim card can only be patched to “Factory Test” from “Issued” status only. This guide explains how to patch your sim cards from “Issued” status to “Factory Test”.

(Example shown using API Swagger)
Click on this link to access EMnify System Documentation Swagger API Reference.

1. 1. 1. Go to the SIMs Section and select “​/api​/v1​/sim​/{sim_id}" Update a SIM”
         
         

         

      2. Select " Try it out" and enter the SIM ID

      3. Edit the “Request Body” to change the status Id to 4 and click “Execute”
         Note: The sim status id for Factory Test is 4 (Sim Status ID:4 → Factory Test)
         The server will respond with a code 204 if successful.
         All sim cards in Factory Test status will be indicated by a Factory icon in the Sim inventory tab
         
         

      4. Assign the sim card to a device. On the EUI, under “connected devices”, the device status will indicate “Factory Test".
         

         When the 100KB of data or 10 SMS MT/MO are reached, the sim card will automatically move to “Activated” status and the device status will change to “Enabled”.

Additional Information

1. On the EUI, if the status of the device with Factory Test status is altered, then the sim card will be automatically be activated.

2. Running a reset connectivity will transition the sim card from Factory test status to Activated.
3. When activating Factory Test in bulk, please use the below API calls via postman.

First, update the SIMs' status into Factory Test:

PATCH https://cdn.emnify.net/api/v1/sim/{{sim_id}}

{
"status": {
"id": 4
}
}

Second, create the endpoints:

Important note: Please make sure to assign the Factory Test SIM cards to an enabled endpoint (status_id=0), otherwise, assigning SIM cards to a disabled endpoint will activate the SIM once the endpoint gets enabled. 

POST https://cdn.emnify.net/api/v1/endpoint

{
"name": "{{name}}",
"status": {
"id": 0
},
"service_profile": {
"id": 1234
},
"tariff_profile": {
"id": 1234
},
"sim": {
"id": {{sim_id}},
"activate": false
}
}