API documentationIncident ManagementFeedback
Edit

Requirements for using applications

Application-specific requirements

Operations App (Android)

  • Android smartphone or Mobile Data Entry (MDE) scanning device.

  • Software min. Android Version 8 (API Level 26).

  • Software max. Android Version 14 (API Level 34), which requires application version 1.22.0 or higher.

  • The application is developed and tested on Google Pixel devices (4a or newer).

  • A range of MDE devices, such as Honeywell (e.g., EDA-52) and Zebra (e.g., TC 21 and TC 26), is supported. A list of recommended devices or approval for specific devices is available upon request.

  • MDE devices may require additional software to be installed and activated so the hardware scanner is accessible by the application.

  • Devices not managed by a Mobile Device Management (MDM) tool must be able to access Google Play for application downloads and updates.

  • Alternatively, APK download is possible via the REST API when using a custom MDM solution. In this case, the application is downloaded through a channel provided by fulfillmenttools instead of from Google Play.

  • Required application permissions must be granted on the device.

  • Ports and URLs for Google Firebase Cloud Messaging (FCM) must be accessible to support push notifications. Refer to FCM ports and your firewall for details.

  • The current version of Google Play Services must be installed. This is usually present when a Google account is configured on the device.

  • Ports and URLs for Google Play Services must be accessible. See the appendix.

  • A stable internet connection or sufficient WiFi signal is required in the entire area where the application is used (e.g., 50 Mbit/s or Long-Term Evolution (LTE)). The required bandwidth depends on the number of active devices.

Operations App (Web)

  • The latest version of a modern web browser, such as Google Chrome.

  • Stable internet connection (50 Mbit/s).

  • Honeywell devices may need a separate license for the hardware scanner to be usable.

Inventory App (Android)

  • Android smartphone or MDE scanning device.

  • Software min. Android Version 8 (API Level 26).

  • Software max. Android Version 14 (API Level 34), which requires application version 1.22.0 or higher.

  • The application is developed and tested on Google Pixel devices (4a or newer).

  • A range of MDE devices, such as Honeywell (e.g., EDA-52), is supported. A list of recommended devices or approval for specific devices is available upon request.

  • MDE devices may require additional software to be installed and activated so the hardware scanner is accessible by the application.

  • Devices not managed by an MDM tool must be able to access Google Play for application downloads and updates.

  • Alternatively, APK download is possible via the REST API when using a custom MDM solution. In this case, the application is downloaded through a channel provided by fulfillmenttools instead of from Google Play.

  • Required application permissions must be granted on the device.

  • The current version of Google Play Services must be installed. This is usually present when a Google account is configured on the device.

  • Ports and URLs for Google Play Services must be accessible. See the appendix.

  • A stable internet connection or sufficient WiFi signal is required in the entire area where the application is used (e.g., 50 Mbit/s or LTE). The required bandwidth depends on the number of active devices.

Backoffice

  • It is recommended to use one of the two most recent versions of a modern web browser, such as Google Chrome.

  • Recommended minimum screen resolution: 1024x768.

  • Stable internet connection (50 Mbit/s).

Returns App

Returns App (iOS)

  • Apple iOS device with a camera.

  • Minimum software: iOS Version 14.1, which requires application version 1.2.1 or higher.

  • The application is developed and tested on iPhone SE (iOS version 14.1 or newer).

  • Devices must be able to access the Apple App Store for application downloads and updates.

  • Required application permissions must be granted on the device.

  • A stable internet connection or sufficient WiFi signal is required in the entire area where the application is used (e.g., 50 Mbit/s or LTE). The required bandwidth depends on the number of active devices.

Returns App (Android)

  • Android smartphone or MDE scanning device.

  • Minimum software: Android Version 8 (API Level 26).

  • Maximum software: Android Version 14 (API Level 34), which requires application version 1.2.1 or higher.

  • The application is developed and tested on Google Pixel devices (4a or newer).

  • A range of MDE devices, such as Honeywell (e.g., EDA-52) and Zebra (e.g., TC 21 and TC 26), is supported. A list of recommended devices or approval for specific devices is available upon request.

  • MDE devices may require additional software to be installed and activated so the hardware scanner is accessible by the application.

  • Devices not managed by an MDM tool must be able to access Google Play for application downloads and updates.

  • Alternatively, APK download is possible via the REST API when using a custom MDM solution. In this case, the application is downloaded through a channel provided by fulfillmenttools instead of from Google Play.

  • Required application permissions, such as camera access on smartphones, must be granted on the device.

  • A stable internet connection or sufficient WiFi signal is required in the entire area where the application is used (e.g., 50 Mbit/s or LTE). The required bandwidth depends on the number of active devices.

Android-specific requirements

The Android mobile application utilizes Google Play Services and therefore requires access to the following services:

  • Firebase Analytics requires access to:

    • app-measurement.com/a

  • Firebase App Distribution requires access to:

    • firebaseappdistribution.googleapis.com

    • appdistribution-uploads.crashlytics.com

  • Firebase Authentication requires access to:

    • www.googleapis.com

    • firebaseauth.googleapis.com

    • identitytoolkit.googleapis.com

    • securetoken.googleapis.com

  • Firebase Crashlytics requires access to:

    • *.crashlytics.com

    • *.fabric.io

    • crashlyticsreports-pa.googleapis.com

    • firebasecrashlyticssymbols.googleapis.com

  • Firebase Performance requires access to:

    • play.googleapis.com

    • www.googleapis.com

  • Play Services and Firebase Installations require access to:

    • device-provisioning.googleapis.com

    • firebaseinstallations.googleapis.com

Hosts and ports

To use the applications, the following hosts and protocols must be accessible from the network. Dedicated URLs are used for each tenant.

  • Google Identity Toolkit service:

    • https://identitytoolkit.googleapis.com/

    • https://securetoken.googleapis.com/

  • Sentry.IO service:

    • https://*.ingest.sentry.io/api/

  • Operations App (Web):

    • https://pick-<tenant>-prd.web.app/

  • Backoffice:

    • https://ocff-<tenant>-prd.web.app/

  • REST API:

    • https://ocff-<tenant>-prd.api.fulfillmenttools.com/

  • GraphQL API:

    • https://ocff-<tenant>-prd.graphql.fulfillmenttools.com/

    • wss://ocff-<tenant>-prd.graphql.fulfillmenttools.com/

  • Download API:

    • https://ocff-<tenant>-prd.download.fulfillmenttools.com/

  • Public configuration files:

    • https://storage.googleapis.com/ocff-<tenant>-prd-config-public/

Last updated