Passive Delivery Service Integration Module

Introduction

Connect your on-demand delivery company to Sinqro (asking Sinqro to consume your APIs and throwing webhooks to Sinqro)

Passive integration

This guide is ONLY for passive integrations, understood as integrations in which Sinqro will consume your API services and listen your webhooks.

If you don't have your own API and webhook notifications and you are not planning to develop them, please go to delivery service active integration docs.

Integration level

In Sinqro we have different integration module types.
For a market integration module, we have different module features in order to help the restaurant to understand the benefits of contracting the module.

All features are optional and defined by the limits of the company developing the integration and the company providing API or services webhook.
As this guide is for passive integrations, your API and webhooks notifications will define the features of your platform's module, because Sinqro will always integrate as many features as your platform allows.

Integration requirements

For a full integration, we would need all these API services and webhooks, but as explained before, we'll adapt the integration to what you already have working or you have decided to implement for us:

API SERVICES
  • POST Delivery
    Service/s to create a new delivery delegated to tour delivery company
  • GET Delivery
    Service/s to get the delivery information of a previously created delivery
  • GET Delivery Status
    Service/s to get the delivery status of a previously created delivery
  • POST/PATCH Delivery Status
    Service/s to change the status of a previously created delivery
  • GET Availability
    Service/s to get your delivery service availability (zones, areas, postal codes, schedules, shifts, calendar exceptions, ...). We support zones definitions by geojsons.
WEBHOOK NOTIFICATIONS

The webhook notifications are POST/PUT requests thrown by your system to a specific endpoint we provide.

  • Delivery status changed WEBHOOK
    Notification you send for a delivery status change
  • Delivery driver position changed WEBHOOK
    Notification you send for a driver's position change
  • Availability changed WEBHOOK
    Notification you send for a delivery status change from your side

We will provide two endpoints to receive your notifications. Example:
SANDBOX: https://sandbox-integrations.sinqro.com/{your-pos-code}/webhooks/{any-other-data}
PRODUCTION: https://integrations.sinqro.com/{your-pos-code}/webhooks/{any-other-data}

OTHER REQUIREMENTS
  • API and webhooks docs
    Document or whatever you normally use you document your API for third-party developers
  • Restaurant test account
    An account to test and ideally access to the restaurant's dashboard (as the restaurant user normally does)
  • Sandbox (test) and production environments credentials
    API keys or equivalent for production environment, and ideally, for sandbox/test environments

Data model

As this integration is passive, we adapt our data to your data model (to consume API services and understand the webhooks).

Despite this, in some cases we are asked to help you (developers) providing examples of what Sinqro understand as delivery, pickup/drop-off times, ... , because maybe, you'd like to improve one of your existing services or create new ones.

In order to show you examples of these entities, and only for this purpose, we invite you to check the delivery service active integration docs.

Integration request

If you already have your API and webhooks docs and you want Sinqro to develop the integration module, please send us an email to integrations@sinqro.com

Integration validation

We’ll provide a document explaining which features have been integrated and which ones were not integrated and the reasons, and of course, we’ll attend any validation session if it’s considered in your workflow.