Skip to main content

Glossary

This glossary provides definitions for terms related to the Cart API endpoints.

Terms​

  • Accor OMS API: The Application Programming Interface (API) provided by Accor for managing orders. It serves as the bridge between external systems and Accor's marketplace.

  • AStoreShop: The specific platform used by Accor to manage suppliers and send purchase orders to them.

  • Catalog: The comprehensive list of products (1 million+ references) available in the Accor marketplace, including details about hotels, addresses, and delivery schedules.

  • Catalog Authentication: The process of verifying identity to access the product catalog via the SFTP server.

  • Companies: The entities listed in the catalog, also referred to as hotels.

  • Delivery Calendars: The data files within the catalog that contain required information for the delivery-round shipping method. These calendars provide the data required to configure delivery-round shipping.

  • Delivery-round: A specific shipping method or routing method identified in the catalog data.

  • Hybrid Approach: The integration strategy that combines two methods: SFTP for large data transfers (Catalog) and REST/JSON APIs for real-time transaction processing (Purchase Orders).

  • Integration: Integrating Partner Systems with the Accor marketplace to manage data exchange and business operations (e.g., product catalog updates and purchase orders).

  • Mega Code: A unique identifier used for organizations or companies within the system, often associated with price calculations and offers.

  • Offers: The specific pricing deals or promotions linked to individual products within the catalog.

  • OAuth2: The authentication protocol (specifically the Authorization Code flow) used to secure access to the API layer, ensuring only authorized clients can interact with the system.

  • Partner Systems: The external software or platforms used by Accor's partners to manage their operations and interact with the marketplace.

  • Pricing: The section of the catalog containing specific pricing deals between supplier groups and company groups.

  • Procure To Pay (P2P): The end-to-end business process of acquiring goods or services and paying for them, managed here by the Accor OMS system.

  • Products: The items within the catalog that have associated offers and details such as name, description, price, and availability. Since AStoreShop functions as a marketplace, multiple suppliers can offer the same product.

  • REST / JSON: A software architectural style and a set of constraints for creating web services. JSON (JavaScript Object Notation) is a data interchange format used for transmitting information between systems.

  • SFTP (Secure File Transfer Protocol): The protocol used to securely transfer large files, such as the product catalog and delivery calendars, from Accor to external systems.

  • SFTP server: The specific server hosting the catalog data for transfer via the Secure File Transfer Protocol.

  • Status (Company): The current state of a company entity. Possible values include Blocked, Pending Approval, Rejected, and Active.

  • Segmentation: A filter mechanism used to categorize data based on various criteria such as customer type, price, brand, or geographic location.

  • Segmentations: The plural form of Segmentation; refers to the specific set of filters applied to products and offers.

  • Catchment Area: A geographic area defined by postal codes (e.g., 06, 83, 98) used for segmentation filtering.

  • Company: The entity representing a hotel. It contains details like the Mega Code, name, country, and segmentation filters.

  • Company Address: The physical location details associated with a Company (Hotel).

  • Shop: The item within the catalog. Since AStoreShop functions as a marketplace, multiple suppliers can offer the same Shop (product).

  • Shop State: The operational status of a Shop. Possible values include OPEN, CLOSE, SUSPENDED, and TERMINATED.

  • Delivery Method: The method by which products are shipped. Values include delivery-rounds, STD, SERVICES, SDD, extra-shipping-fee, EXP, and punch_out.

  • GTIN (Global Trade Item Number): A unique identifier used to identify products.

  • GTIN Type: The specific format of the GTIN (e.g., EAN, UPC, ISBN).

  • Allergen: A substance that can cause an allergic reaction. The catalog lists allergens separated by commas.

  • CSV File Naming Convention: Files are named with a timestamp in the format YYYY-MM-DD-hh-mm-ss to ensure unique identifiers and chronological ordering.

  • Request For Proposal (RFP): The formal document outlining the requirements for a project. In this context, it refers to the document that dictates the implementation of segmentations.

  • Cart: A temporary collection of items selected by a customer for purchase. The cart contains information about the items, such as the product ID, quantity, and price.

  • OMS: The core system handling orders, including order creation, validation, and status tracking.

  • Purchase Order (PO): The document representing an order placed with a supplier.