All Collections
Integrations
Syncing with Phonecheck
Syncing with Phonecheck

Using the Phonecheck integration to import inventory into WholeCell

Brennan Zelener avatar
Written by Brennan Zelener
Updated over a week ago

Phonecheck is software for testing the functionality of mobile devices. This integration allows you to import inventory information (product attributes, grades, failed tests, etc) from your Phonecheck cloud portal into WholeCell.

This integration syncs:

  • Inventory (Phonecheck β†’ WholeCell)

Enabling the Integration

From the Phonecheck Integration page in WholeCell, enter your Phonecheck credentials to connect your account:

Station Username

Any of your Phonecheck station usernames will work here, and will allow you to import information for inventory tested at any of your stations.

API Key

Your Phonecheck API key can be found on the Phonecheck Cloud Portal under General Settings > API Key.

Add Notes to Conditions

If you'd like to map comments/notes in Phonecheck to Damage Conditions in WholeCell, you can enable that here. Multiple conditions must be separated by a comma.

Custom Inventory Field Mapping

Want to import battery health information, software version, or some other specific device data from Phonecheck? You can create custom inventory fields in WholeCell and map those fields to the values from Phonecheck. Here's a list of what can be imported:

  • TransactionID

  • Serial

  • Version

  • Firmware

  • Notes

  • BatteryPercentage

  • BatteryCycle

  • BatteryHealthPercentage

  • BatteryDesignMaxCapacity

  • BatteryCurrentMaxCapacity

  • BatterySerial

  • BatteryModel

  • BatterySource

  • TesterName

  • Cosmetics

  • Custom1

  • CocoCurrentCapacity

  • CocoDesignCapacity

  • OEMBatteryHealth

  • CocoBatteryHealth

  • VendorName

  • InvoiceNo

Importing New Inventory by Invoice Number

Screen capture:

Walkthrough:

Using the invoice number from Phonecheck is a fast way to import a batch of devices into WholeCell.

When testing devices in Phonecheck you can set the Invoice Number by clicking on Update Vendor Info in the sidebar:

In WholeCell, click on the blue + button from the purchase order page and select PhoneCheck Import. (This option will not appear until your Phonecheck account is connected to WholeCell):

From the import page, click on Invoice Number and enter the invoice number used in Phonecheck:

Click Next and you'll be able to use the Validation stage to map any unrecognized product information, conditions, and grades that come from Phonecheck to the existing information you have in WholeCell:

Clicking Save will save the inventory with the selected mappings to your purchase order in WholeCell:

Importing New Inventory by ESN

Screen capture:

Walkthrough:

To import devices from Phonecheck by ESN, go to the purchase order you want to add inventory to, click on the blue + button, and select PhoneCheck Import. (This option will not appear until your Phonecheck account is connected to WholeCell):

From the import page, paste a list of ESNs for the devices you want to import:

Click Next and you'll be able to use the Validation stage to map any unrecognized product information, conditions, and grades that come from Phonecheck to the existing information you have in WholeCell:

Clicking Save will save the inventory with the selected mappings to your purchase order in WholeCell:

Importing Duplicate Inventory

Want to import an invoice multiple times to add new devices that have been tested in Phonecheck since a prior import? No problem. WholeCell will automatically ignore the duplicates and only import the newly added devices:

Updating Existing Inventory

If you want to update your inventory in WholeCell with Phonecheck data, you can do so by doing a bulk-action update. Notice that I have a lot of unknowns here:

To update these, put a check on the items and then click on the 'Bulk Action'' button, then select 'Import Phonecheck data'.

On the window that pops up, select the attributes and custom fields that you want to update.

When this window shows, you can mainly do two things. One is to map the attributes being imported to the current ones that you have in WholeCell or two if they're not existing in WholeCell, to create those with this import.

You have the option to save the mapping for each attribute.

If you want to see attributes that you have saved before and edit or delete them, they're stored here: https://www.wholecell.io/settings/inventory_feed_replacements

You need to map each attribute to be able to successfully save the import. Hit 'Next' and wait a few seconds.

Done.

Known Issues

  • Using whitelisted IPs in Phonecheck's application will prevent WholeCell from importing. Phonecheck's IP whitelisting needs to be disabled for the integration to work.

  • When importing devices, if the invoice number that you type in WholeCell is not identical to the one in Phonecheck, the import will fail. Check for spaces before and after the number, both in Phonecheck and in WholeCell.

  • If you had incorrectly put in your credentials before then corrected it at some point in time, you might still see the error message "Your Phonecheck credentials appear to be invalid. Please double check your station username and API key" on the Phonecheck settings page in WholeCell. Simply make sure you have the correct ones there and save. Then, try to import inventory to WholeCell to test if it's already working.

Did this answer your question?