Imports of license data: Reference
Refer to the table below for a detailed description on the required data when you want to import new license purchases or update existing licenses with new metadata in SAM on Snow Atlas. For more information on how to import data, see Manage imports of license data
To perform a successful import, the following information must be provided:
-
Application name, Application part number, or SKU (stock keeping unit)
Select your preferred identifier under Identity mapping in the Import settings step of the import wizard. -
Legal organization
-
Purchase date
Information indicated as “Required to get complete status” must be provided, otherwise the license purchase will be indicated as incomplete. An incomplete license purchase will not be included in the compliance calculations.
| Field name in the import view | Data type | Required | Description | Example |
|---|---|---|---|---|
| License ID | Number | No | The ID of an existing license. To check the License ID:
| 486 |
| Application name | Text | Yes | The name of an existing application. | Adobe Photoshop CS4 |
| SKU (stock keeping unit) | Text | Yes | The SKU number of an existing application. Note: For SKU numbers that are not in the database, the license purchase will be imported as incomplete (with the ALLOW_INCOMPLETE_LICENSES setting enabled). | SFKJHDF34 |
| Legal organisation | Text | Yes | The legal organization that made the purchase. Delimiter between organization IDs is dependent on setting. Required to get complete status. If the import is unable to map to the organization, find the identities for each organization node and add the identities to the import file. To find the Organization ID, also called GUID do the following:
|
|
| Purchase date | Date | Yes | The date of the purchase. Required to get complete status. Supported date formats:
| 2025-10‐28 |
| Metric | Text | No | The unit of measurement for the license. Required to get complete status. An empty value in this field will mark the license purchase as incomplete. Allowed values are:
| USERS |
| Assignment type | Text | Yes | Provides information on how a certain license purchase assigns licenses to relevant consumers. Available values are:
| Organization |
| Is upgrade | Boolean | No | Defines if the license is an upgrade license or not. Allowed values are:
| YES |
| Upgrade from license ID | Number | No | The ID of the license to upgrade from. Required to get complete status if Is upgrade is set to YES. To check the ID:
| 242 |
| Base license quantity to upgrade | Number | No | The number of base licenses to upgrade. | 50 |
| Quantity | Number | No | The number of licenses. Required to get complete status. If used for an upgrade license, this number should reflect the quantity that you are entitled to convert. Example: For metrics Number of processors and Number of processor cores, the Quantity refers to the number of licensed processors/processor cores. | 50 |
| Subscription valid from | Date | No | Start date of the subscription period. Required to get complete status if Is subscription is set to YES. Supported date formats:
| 2025-01-01 |
| Subscription valid to | Date | No | End date of the subscription period. Required to get complete status if Is subscription is set to YES. Supported date formats:
| 2026-12-31 |
| Is subscription | Boolean | No | Defines if it is a subscription license:
| |
| Purchase price | Number | No | The value of the license purchase. | 100 |
| Purchase currency | Text | No | The currency of the license purchase. | EUR |
| Cross edition rights | Boolean | No | The right to use the same and/or lower editions of the product. Allowed values are:
| YES |
| Downgrade rights | Boolean | No | The right to use the lower product version of the product. Allowed values are:
| YES |
| Auto allocate (distribute) license | Boolean | No | Activates auto allocation. Allowed values are:
| NO |
| Maintenance includes upgrade rights | Boolean | No | The license includes a support or maintenance agreement. The field defines whether or not a maintenance agreement includes upgrade rights. Allowed values are:
Should be set to NO if the license is purchased without upgrade rights. Note: The Maintenance and Support fields should only be used if:
| YES |
| Maintenance according to agreement | Boolean | No | Defines whether or not automatic upgrade will use agreement period. Allowed values are:
Note: The Maintenance and Support fields should only be used if:
| NO |
| Maintenance and support valid from | Date | No | Defines what date automatic upgrade is valid from. Required for the license to be complete if Automatic upgrade is activated, and Maintenance according to agreement is set to NO. Supported date formats:
| 2025-10‐28 |
| Maintenance and support valid to | Date | No | Defines what date automatic upgrade is valid to. Required for the license to be complete if Automatic upgrade is activated, and Maintenance according to agreement is set to NO. Supported date formats:
| 2026‐08‐31 |
| Agreement number | Text | No | An external agreement number. This field can be left empty if Maintenance according to agreement is set to NO. If used, this agreement must already exist. Note: The agreement needs to exist prior to the license import. Also, the purchase date of the license must be within the agreement period. | HP19289182 |
| External ID | Text | No | Used to assign an ID from an external system, such as ERP, CRM or sales/order systems. | ABC123 |
| Vendor/reseller | Text | No | The name of the vendor/reseller that this license was purchased from. | Amazon |
| License proof location | Text | No | The location where proof of license purchase is stored. | Safe at the office |
| Purchase notes | Text | No | Information specific to the license purchase, as free text. | |
| Serial numbers/ license keys | Text | No | The serial numbers/license keys received for this purchase. | |
| Installation media location | Text | No | The location where the installation media is stored. | File server 1 |
| Purchase invoice reference | Text | No | The reference number found on the invoice. | ADB00889912 |
| Product description | Text | No | Use the Product description to add either an own product description or the manufacturer's. | OfficeStd 2010 SNGL MVL |
| Maintenance cost | Number | No | The maintenance cost per period. | 100 |
| Support cost | Number | No | The support cost per period. | 100 |
| Maintenance and support notes | Text | No | Notes on the maintenance and support. | |
| Maintenance and support invoice | Text | No | The reference to the maintenance and support invoice. | SHB00375297 |
| [Custom fields] | No | Import of data to existing license custom fields. Supported custom field data types are:
|