Skip to main content

General Context

Goal of the integration​

The Accor OMS API is an interface designed to help our Partner Systems (your internal systems or ERPs) to

  • Import all our Marketplace catalog (1 million+ references),
  • Send purchase orders to our suppliers via the API of our AStoreShop platform,
  • Track order status

Procure To Pay (P2P)​

Procure to pay (P2P) is the end-to-end process organizations use to acquire goods and services. This API enables the Order phase of your P2P process by providing real-time cart validation and purchase order submission.

Accor's Hybrid Approach : SFTP + API​

This integration uses a hybrid approach. Large datasets, such as the catalog, are exposed via our SFTP, while real-time purchase order transactions are performed via our APIs.

  • Getting the Catalog : The SFTP protocol is used to securely share large files, specifically for exchanging our catalog, hotels, addresses, suppliers, and delivery calendars. It allows you to import all the data and adapt to your existing data model.
  • Place a Purchase Order : We expose REST/JSON APIs, a standard protocol supported by most Partner Systems, to allow you to
    • check your cart against our suppliers' last updated stocks and pricing,
    • create and transmit your purchase order to our suppliers, and
    • check a supplier logistical order's status.

Integration workflow diagram​

Here are the interactions between the two layers as a sequence diagram (SFTP and API) and all the technical steps you will have to integrate your system with our API:

  • Phase 1: SFTP : Download all the catalog files and integrate them into your tools.
  • Phase 2: API : Authenticate your client against our OAuth2 server (M2M), then :
    • validate-cart : Ensure the cart has updated stock availability and pricing.
    • purchase-order : Send the Purchase Order (The Accor OMS Procure To Pay (P2P) solution then sends this order to our suppliers).
    • status : Get the order status (accepted by the supplier, rejected, shipped, or...).

Getting Started - Prerequisites

Onboarding Requirements​

At the onboarding phase, you will need two identities per environment. Please ensure you have:

  • SFTP credentials - Username and password for catalog access Details for obtaining these credentials are available in the links below:
  • SFTP credentials
  • OAuth2 credentials

Environment​

We will provide you access to two environments:

  • Test servers https://oms-api-pp.astoreshop.com/oms-api
  • Production servers https://oms-api.astoreshop.com/oms-api

Catalog Data synchronization (SFTP layer)

This is the first step : you need to import our full marketplace catalog.

Order Transaction Operations (API layer)

This is the second step : you will place purchase orders for our marketplace

Licence

The code is Accor's property and strictly confidential. Unauthorized use is prohibited.