The SIM card inventory is a flexible tool that enables the MVNOs and LTE service providers to bulk upload SIM cards via the administrator web interface and therefore, easily manage them.

The SIM card inventory is used for adding, viewing, removing, and assigning SIM cards to accounts. Its convenient search function makes it possible to quickly find the desired record by simply inputting a key word.

SIM cards can be added to a SIM card inventory either manually, i.e. one at a time, or can be bulk uploaded from a file. See the file structure in the Upload SIM cards chapter.

Once a SIM card is added to a SIM card inventory, its status is "Available." This means that this SIM card is not yet assigned to any account. When a SIM card is assigned, its status is "In use." Note that a SIM card having the "In Use" status cannot be removed from the SIM card inventory until it is first unassigned. You can trace any changes in the SIM card statuses in the PortaBilling audit logs on the SIM page.

SIM card inventory

Assign a SIM card

When a SIM card is assigned to an account, it acquires the MSISDN value that equals the account ID of the linked account. Therefore, both the account and the assigned SIM card are now connected and PortaBilling can automatically provision the information into HSS/HLR by using the External System Provisioning Framework.

With the increasing need to manage and maintain large numbers of SIM cards and provision them into external systems, this SIM card inventory is becoming a great tool for LTE service providers and MVNOs.

Comprehensive details and group operations in SIM card inventory

Link copied to clipboard

You can store a comprehensive set of parameters for a SIM card in PortaBilling:

For example, you can store PUK codes within the SIM card inventory, so if a user loses their code, the admin can quickly find it in PortaBilling. And by including information about the marketplace or the sales partner, you can keep track of SIM cards distributed via different sales channels.

You can change these details for multiple SIM cards at once using the group operations functionality in the SIM card inventory.

Group operations panel

  • You can fully manage SIM cards in PortaBilling, instead of doing this in an external system and switching back and forth
  • With full information about SIM cards, you can save time when addressing customers’ queries
  • You can track the SIM cards that are being sold via a specific sales partner

Essential SIM card details

Link copied to clipboard

Alongside the basic identifiers like IMSI (International Mobile Subscriber Identity) and ICCID (Integrated Circuit Card Identifier), you can specify PIN for inactive cards, PUK1, PUK2, or the eSIM activation code for each physical (SIM) or virtual (eSIM) card.

These details can be specified when you add SIM cards or upload them from a file to the SIM card inventory.

Custom SIM card details

Link copied to clipboard

If the default fields are not enough, you can also create custom fields to keep additional information about SIM cards, such as the marketplace where the SIM cards are being offered or the name of the SIM card provider. You will then be able to filter SIM cards by these custom fields, e.g., filter active SIM cards by the “Marketplace” parameter, e.g., to check how many active SIM cards are sold via Amazon.

The custom field data can then be retrieved for statistics/reporting.

SIM card allocation to sales partners and customers

Link copied to clipboard

You have the ability to allocate SIM cards to your sales partners, such as distributors and representatives. This allows you to keep track of SIM cards that are being sold via distributors and representatives.

Also, SIM cards are automatically allocated to the corresponding customer once it is assigned to an account of this customer. You can allocate SIM cards to a customer manually, e.g., if a business customer orders SIM cards for activating them in the future for the new employees. The status of such SIM cards changes from “Available” to "Reserved."

The "Reserved" status indicates that even though these SIM cards are not in use, they can only be assigned to this specific customer’s accounts. This allows you to avoid a situation where one customer’s SIM cards are assigned to another customer's account by mistake.

The “Available” status doesn't change if you allocate SIM cards to your sales partners, such as distributors and representatives.

You can filter SIM cards in the SIM card inventory by their allocation – by a specific distributor, representative, or customer.


An MVNO called Mega Telecom receives 1000 SIM cards and a file with the full SIM card data, including PIN, PUK1, and PUK2 codes from their MNO. Adam Smith is a distributor of Mega Telecom and will receive a batch of 100 SIM cards to sell. Also, Mega Telecom plans to sell 100 SIM cards via Amazon.

Mega Telecom’s admin uploads the file with the SIM card data to the SIM card inventory. Now, these SIM cards are ready to be assigned to new accounts.

To allocate 100 SIM cards to Adam Smith, the admin checks the physical SIM cards that will be shipped to Adam Smith (e.g., these are SIM cards with ICCID from 1949177921756150001 to 1949177921756150100). The admin filters these SIM cards by ICCID in the SIM inventory, and allocates them to Adam Smith using the Group operations panel.

Since there is no default field “Marketplace” in the SIM card inventory, the admin creates the corresponding custom field.

The admin filters the next 100 SIM cards to be sold via Amazon and sets “Amazon” in the “Marketplace” custom field using the Group operations panel as well.

At the end of the month, Mega Telecom can filter active SIM cards and check how many SIM cards are sold per sales channel.

  • You can add the data to the created custom fields when uploading SIM cards from a file the same way as adding the data to the default fields – you just need to add another column to the file for upload. For example, if you created a custom field “Marketplace,” you need to add the column with the header "Marketplace custom" or "Marketplace CUSTOM" to the file and fill in the corresponding values.
  • Resellers can allocate the SIM cards they manage to their distributors and customers as well.

Automatic cleanup of SIM cards with the “Disposed” status

Link copied to clipboard

If an account is terminated or a SIM card is deactivated (for example, it is lost or damaged), the SIM card is unassigned from the account and the SIM card status changes from "In use" to "Disposed."

The "Disposed" status indicates that this SIM card is no longer usable and cannot be assigned to any account. By default, the SIM cards with the “Disposed” status are retained in the inventory for 365 days and subsequently automatically deleted. You can change this period using the SIM_cards.KeepDisposedSIMDays option on the Configuration server web interface.

SIM_cards.KeepDisposedSIMDays option

Also, you can manually delete such SIM cards on the spot on the PortaBilling web interface by selecting a specific SIM card and pressing Delete on the toolbar.

Click Delete to manually delete SIM cards

Reuse of unassigned SIM cards that haven’t been activated

Link copied to clipboard

If a SIM card was assigned to an account but then unassigned without being activated in the mobile operator's network, the system can change the SIM card status to "Reserved" (not "Disposed"), making the SIM card available for reuse.


Say an admin mistakenly assigns a SIM card to an account. The SIM card status changes from "Available" to "In use" (and the SIM card is automatically allocated to the corresponding customer). The admin notices the mistake and unassigns the SIM card from the account before the SIM card is activated. The SIM card status is changed to "Reserved." The admin unassigns the SIM card from the customer and the SIM card status changes to “Available” again.


By default, when a SIM card is unassigned, its status automatically changes from “In use” to “Disposed.” To configure reverting to “Reserved” status based on the activation information received from the mobile network, set “Yes” for the SIM_cards.UseDetailedSIMStatuses option on the Configuration server web interface.

SIM_cards.UseDetailedSIMStatuses option

Sending status change events

Link copied to clipboard

PortaBilling can now notify external systems such as CRM, about SIM card status changes, e.g., from “Available” to “Reserved.” The admins need to subscribe the event handler to the SIMCard/StatusChanged event.

SIMCardStatusChanged event


Service providers avoid human errors when managing SIM cards.

On this page

What's new
Admin manuals
UI help
Back to main menu