Skip to navigation

Welcome to Mily Technologies!

Delivery analytics made for parcel and postal operators
image

Integration methods with Mily Tech

This document outlines how to integrate with our platform. We offer two integration methods: 

  • SFTP integration  - A push-based method where your team periodically uploads data files to a secure SFTP server that we manage. 
  • API integration - A pull-based method that allows for automated data retrieval from your systems, ensuring continuous access to up-to-date information. This method also supports direct connectivity to data platforms such as Snowflake, Databricks, or other third-party systems.

ℹ️ The two methods can be approached as sequential phases, giving you the flexibility to start quickly, while still supporting scalable, automated integration as your needs evolve.

API integration

API integration enables automated data exchange between your systems and our platform. This eliminates the need for manual uploads and ensures that your data remains up-to-date.

To use this method, you will need to provide a secure API endpoint that we can connect to.

Data requirements for API integration

Below is a list of common data entities your API should provide for a smooth integration. It is shown in a relational structure based on the requirements of our platform.

  • Hub
|_ ID
    |_ Name
  • OOH Point
OOH Point

|_ OOH Point ID

|_ Name

|_ Address

|_ Latitude

|_ Longitude

|_ Activation date

|_ Type (Locker, PUDO)

|_ External OOH Point ID

|_ Capacity

|_ Working hours

ℹ️  If your network includes partner or affiliated locations, these can be mapped under subType. Simply provide the same data structure as OOH Point for those locations.

  • Shipment
|_ Shipment ID

|_ OOH Point ID

|_ Event type (e.g., collection, pickup, return, unsuccessful)
|_ Client ID (if available)

|_ Timestamp

|_ Receiver Address (if available)

  • Shipment event
|_ Shipment Event ID

|_ Event Name

ℹ️ *We also have the data requirements available in ****OpenAPI ***format. If this is more convenient for you, please let a member of our team know.


Note on delivery areas

To display shipment and location data accurately, we need to map delivery areas. These are typically defined by dividing the country into zones using ZIP codes, provinces, or your own predefined regions. Please let us know your preferred structure early in the process so we can configure the delivery areas accordingly.

Frequently asked questions

  • Why choose the API integration method?
This method is ideal if you want to automate data sync and have continuous access to up-to-date data for analytics and reporting.

  • Who is responsible for providing the API?
    Your team is responsible for exposing an API endpoint with the required data. We will handle the integration from our side once the endpoint is available and accessible.
  • How frequently is the data pulled?
    • If you’re using only the network planning features (Build), without management features, data is pulled once per week.
    • If you’re using the full OOH delivery analytics solution, data is pulled once per day. 

In both cases, data pulls are scheduled during off-peak hours (typically late evening or overnight) to avoid impacting system performance.  If you require a different frequency, please inform the Mily Tech team. 

  • What if our API changes?
    Please notify the Mily Tech team of any changes to your API’s structure. We aim to avoid disruptions and can adjust our integration accordingly.
  • What are the next steps after we provide the API?
    Once you provide the API endpoint, we will review the structure and response format and perform a test data pull. If no issues arise, we can activate scheduled data pulls based on the agreed frequency. This process typically takes up to 2 weeks from the time we receive full API access.
  • How secure is the Mily Tech platform?
    We take data security seriously. Mily Tech is GDPR-compliant and has obtained the ISO 27001:2022 certification, ensuring that all data is handled in accordance with recognized security and privacy standards. For more information, visit our Trust Center.