Use Advanced Shipment Notification

  • Release version: Yokohama
  • Updated January 30, 2025
  • 4 minutes to read
  • Use Advanced Shipment Notification (ASN) to automate and create asset records when your assets are in transit.

    Before you begin

    • Download the ASN template and share it with the vendor for completion.
    • Before importing asset records using the ASN template, validate the following data requirements:
      • The model ID provided in the template is defined in your ServiceNow instance.
      • The shipping address in the template matches the shipping address in the Location [cmn_location] table.
      • The shipping carrier in the template is available in the Shipping carrier [sn_itam_shipping_carrier] table.
    Role required:
    • Hardware Asset Management version 15.0.0 and later: ham_admin, ham_user, procurement_admin, asset, or admin
    • Hardware Asset Management versions prior to 15.0.0: admin

    About this task

    Note:

    If the asset records that you want to create belong to model categories linked to a CI class with identification rules defined for fields like the Asset tag, Serial number, or MAC address, you must provide details for at least one of these fields in the ASN template. Otherwise, the asset record isn't created. For example, if identification rules are defined for the Serial number and MAC address, you should provide a value for either of these fields.

    The identification rules for a CI class are defined in the CMDB Identification and Reconciliation engine (IRE). For more details, see Identification rules and Create a CI identification rule. These rules help to uniquely identify the asset through these required fields and maintain accurate asset records.

    Procedure

    1. Navigate to ASN import page.
      HAM versionSteps
      Version 15.0.0 and later
      1. Navigate to Workspaces > Hardware Asset Workspace > Procurement.
      2. Select the Procurement tab.
      Versions prior to 15.0.0 Navigate to All > Procurement > Orders > Import Shipment Notification.
    2. Attach or upload the ASN template.
      • HAM version 15.0.0 and later:
        1. Select New.
        2. On the Create New Shipment Notification Upload page, enter a unique name in the Name field.
        3. Select Attach file to upload the updated ASN template (.xlsx) that you received from your vendor.
          Note:
          If you do not have a sample ASN template, select Download template and share it with the vendor for completion.
      • HAM versions prior to 15.0.0: Select Browse files and select the updated template.
        Note:
        If you don’t have a sample ASN template, on the Import Template page, select the Download Template File (.xlsx) link to download the template and share it with your vendor for completion.

      The ASN template includes fields such as:

      • Serial number: Unique identifier for the asset
      • Asset tag: Alphanumeric tag assigned by your organization for asset tracking
      • Vendor: Vendor from whom the asset was purchased
      • PO number: Number associated with the purchase order
        Note:
        This field isn't the vendor PO number.
      • Model id: Model number of the product
      • SVC contract end date: Warranty expiration date for the asset
      • Carrier: Shipping carrier name
      • Tracking number: Number to track the assets that are in transit
    3. Start the import.
      • HAM version 15.0.0 and later: Select Import.

        The status of the shipment notification upload transitions as follows:
        • Moves from Draft to Pending after the import is initiated.
        • Progresses through the Extracting Rows and Importing stages as the system processes the data.
        • Finalizes the process by updating the status to one of the following based on the outcome:
          • Completed: The import finished successfully without issues.
            Note:
            Even if some rows fail validation, the overall import status is marked as Completed. Error details for failed records are displayed in the Comment field on the Shipment Notifications Upload Stagings tab.
          • Failed: The system couldn’t complete the import process.
        • The Shipment Upload Result section summarizes the import by showing the number of records inserted, ignored, and skipped.
      • HAM versions prior to 15.0.0: Select Upload.

        The upload may take some time as the import process runs asynchronously. Wait for the import process to complete before proceeding.

        Check the status of importing the template in one of the following ways.
        • Navigate to Procurement > Orders > Import Status.
        • To open directly the import set record, select the link on the message bar that shows View import progress here.
        The Import Sets page shows a list of import set records.
    4. Review the import results.
      • HAM version 15.0.0 and later: Select the Shipment Notifications Upload Stagings tab to view the state all rows included in the ASN template. A row can have any of the following states:
        • Inserted- Indicates that the row passed all validations and was considered for asset creation.
        • Ignored- Indicates that the row failed one or more validations and was excluded from asset creation. Rows containing software licenses are also automatically excluded, as software licenses are not supported through ASN import.

        The Comment field displays error details.

      • HAM versions prior to 15.0.0:
        1. Select the import set record to view the import status.
        2. If the import was not successful, select the Import Set Rows tab and check the Comment field to understand the reason for the failure.

    Result

    For rows validated successfully:

    • Asset records are created in the In Transit state.
    • Asset records are linked to their corresponding purchase order line items.
    • Purchase order statuses are updated to Pending Delivery.

    What to do next

    For rows that were ignored or resulted in a failed import, perform the following steps:

    1. Review the Comment field to identify errors or details for each row.
    2. Resolve the identified issues in the ASN template.
    3. HAM version 15.0.0 and later: Create a new Shipment Notification Upload record to import the updated template.
    4. HAM versions prior to 15.0.0: Import the updated template again.