New in SIM for Things Portal and APIs
SGP.32: localisation campaigns and Profile Pools for resellers and enterprises
-
Reseller and Enterprise accounts with eSIMs (accounts enabled for eID) can now run their own SGP.32 localisation campaigns, so that IoT eUICCs can be localised without a request to BICS.
-
New menu Tools > eUICC Localisation with the tabs Campaign Overview and Campaign Details, to follow the progress and status of your campaigns.
-
Create IoT campaigns using Profile Pools owned by your account and SIMs from your own inventory. For resellers: you can also use the Profile Pools and SIMs of your child accounts.
-
Condition rules: one "Any" rule, or up to 10 "Country" rules.
-
You can add or remove SIMs only on campaigns created by your own account. A campaign created for you by BICS or by your parent reseller is visible but cannot be modified.
-
-
Reseller and Enterprise accounts with eSIMs can now create and manage their own IoT Profile Pools, so that you control the profiles your campaigns draw from.
-
New Profile Pools page under the SIMs tab. IoT pools only, with Connectivity Type Internal or External.
-
Add internal profiles from your own inventory, or upload external profiles with an .AC file. A sample .AC file can be downloaded from the page.
-
Remove internal or external profiles from a pool with the "-" button.
-
For resellers: you can view and edit your own pools and view the pools of your child accounts. At enterprise level you view and edit your own pools.
-
NextGenSIM: warning to keep Sponsor IR1
-
For accounts with NextGenSIM cards, the portal now shows a warning before a change that could remove Sponsor IR1, so that NextGen SIM cards keep their worldwide bootstrap coverage.
-
The warning appears when you create a Destination Group (for resellers) or a Roaming Profile (at enterprise level), and when you bar or remove an IR1 network in an existing one.
-
Message: "Always ensure Sponsor IR1 is included in every destination (country) in this profile. Without it, NextGen SIM cards may experience connectivity issues. Do you want to continue?"
-
Notifications in bulk
-
Plan notifications can now be received in bulk through one callback, so that you receive fewer, structured calls instead of one call per notification.
-
In Tools > Callback API, add the URL for the new process "CallBackNotification(Bulk)".
-
In the plan definition or modification, add the new "API (Bulk)" channel. With this channel the message cannot be customised: a standard JSON payload is sent with all available information.
-
Notifications are sent every minute or every 800 notifications, with a maximum of 800 notifications per request.
-
The existing "API" channel remains available.
-
SIM export
-
The export on the SIMs page now works like the Endpoints export, so that large exports run in the background and stay available for download.
-
Export CSV or XLSX starts the export; one export can run at a time per account.
-
New "Exported Files" option to view and download your exported SIM files. Files are named
<Accountid>_SIM_yyyyMMddHHmmss.zipand are kept for 7 days. -
Maximum 20,000 records per export. A warning is shown when your Advanced Search result exceeds 20,000 records.
-
The file columns are aligned for all account levels. The "iMSIList" column is replaced by two columns, "masterIMSI" and "supplierIMSI".
-
API
Action needed: If your integration retrieves all endpoints in a single GetEndpoints call without "perPage", it will now only receive the first 2000 endpoints. Add "page" and "perPage" to your requests and loop through the pages until all records are retrieved. The same applies to GetTariff and QueryRatePlan.
-
GetTariff, QueryRatePlan and GetEndpoints now return a maximum of 2000 records per page. Before the release, GetTariff and QueryRatePlan returned all records in one response, and GetEndpoints returned all endpoints when "page" and "perPage" were not provided. After the release, use "page" and "perPage" to navigate when there are more than 2000 records.
-
GetTariff: search by "tariffId" (exact match) or "tariffName" (exact match or starts with).
-
QueryRatePlan: search by plan (exact match) or "planName" (exact match or starts with).
-
GetEndpoints: when "perPage" is not provided, 2000 records per page are returned. Requests with "page" and "perPage" work as before.
-
-
GetStatistics now accepts a "from_date" of maximum 12 weeks before the current date. An older date returns error code 10268 "from_date - maximum 12 weeks from current date".
-
Added new Bulk Delink SIM API to delink SIMs from up to 4000 endpoints in one request, at enterprise level. Select by ICCID or by endpoint ID; a JobId is returned and the success and failure lists are available via the Job Status API.
-
ICCID can now be used as resource type in the Delink SIM API.
API for SGP.32
-
Added new CreateCampaign API to create an IoT localisation campaign.
-
Added new FetchCampaignList and FetchCampaignDetails APIs to follow your campaigns and the eUICCs in them.
-
Added new AddSIMsToCampaign and RemoveSIMsFromCampaign APIs to add or remove eUICCs from a campaign. The request is processed in the background; a JobId is returned and the result is available via the Job Status API.
-
Added new CreateProfilePools API to create a Profile Pool; the Profile Pool ID is returned immediately.
-
Added new fetchProfilePools API to list the Profile Pools of your account and its hierarchy, or the details of a pool.
-
Added new addProfilesToPool and removeProfilesFromPool APIs to add internal or external profiles (ICCID and activation code) to a pool, or remove them. A JobId is returned and the result is available via the Job Status API.
For API related changes and bug fixes you can check the API documentation and release notes here: https://api.sft.bics.com