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)
Note: Phonecheck’s API gives WholeCell the latest test result, which is not necessarily the test result with the most information about a device. If the latest test result is missing information like the grade, that’s what WholeCell has access to and will import.
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. https://cloudportal.phonecheck.com/cloud/setting/ApiKey
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.
We pull inventory from the Cloud Portal, https://cloudportal.phonecheck.com/cloud/cloud_db_sync/view, so make sure that you type in exactly as how the invoice number is shown in the portal
In some cases, removing the "#" sign before the number works
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.