Qerdos API

## Sections
• [Promotions API](https://app.theneo.io/2a338d1a-0a51-45e1-bb0c-840aee9b6906/theneo-sample-project/promotions-api.md): The Promotions API provides a set of endpoints designed to manage and calculate discounts for various promotions. It includes three key requests: the first allows you to retrieve all active promotions, while the other two are focused on calculating discounts—one for a specific promotion and another for determining the best available discount. These requests are essential for integrating promotional discount functionality into your platform, enabling dynamic pricing and enhanced customer experiences.
  • [Get all promotions](https://app.theneo.io/2a338d1a-0a51-45e1-bb0c-840aee9b6906/theneo-sample-project/promotions-api/promotions.md): This API request allows users to retrieve a list of all promotions that are currently active or available. The response includes all relevant details about the promotions, such as id, tenantId, name, code, valid from, valid to, calculation definition, and description.
  • [Calculate discount promotion](https://app.theneo.io/2a338d1a-0a51-45e1-bb0c-840aee9b6906/theneo-sample-project/promotions-api/calculate-discount-promotion.md): This API request allows you to calculate the final invoice amount by applying a selected discount promotion to the items in the cart. The request receives a invoice with the list of items, and it returns the same invoice with the updated prices for each item and the final total after the discount has been applied, based on the promotion benefits the user has qualified for.
  • [Calculate discount](https://app.theneo.io/2a338d1a-0a51-45e1-bb0c-840aee9b6906/theneo-sample-project/promotions-api/calculate-discount.md): This API request calculates the final invoice by evaluating all active promotions and selecting the most beneficial discount for the customer. It receives the invoice with a list of items, processes all available promotions, and returns the updated invoice with the best discount applied. The returned invoice includes updated item prices and the final total after the most advantageous promotion is applied.
• [Authorization](https://app.theneo.io/2a338d1a-0a51-45e1-bb0c-840aee9b6906/theneo-sample-project/authorization-1.md): In order to access the API, users must authenticate and obtain the necessary authorization. The API supports various authentication mechanisms, including OAuth2, and JWT tokens. This section outlines the available authorization methods and the process for obtaining the necessary credentials to interact with the API securely. Make sure to follow the authentication flow appropriate for your use case to ensure successful integration.
  • [Get Authorization token](https://app.theneo.io/2a338d1a-0a51-45e1-bb0c-840aee9b6906/theneo-sample-project/authorization-1/get-authorization-token-1.md): To obtain a Benefit Service Authorization Token, send a POST request to the designated API endpoint, providing the necessary query parameters. Upon a successful request, the API will return a JSON response with an access_token , which can be used to authenticate subsequent requests to protected resources.
• [Loyalty API](https://app.theneo.io/2a338d1a-0a51-45e1-bb0c-840aee9b6906/theneo-sample-project/loyalty-api.md): The Loyalty API provides a set of endpoints designed to manage and track customer loyalty program activities. It includes request for recording loyalty purchases. These endpoint enable seamless integration of loyalty functionality into your platform, allowing you to reward repeat customers, track engagement, and deliver personalized experiences based on purchase history and earned points.
  • [Record Loyalty Purchase](https://app.theneo.io/2a338d1a-0a51-45e1-bb0c-840aee9b6906/theneo-sample-project/loyalty-api/record-loyalty-purchase.md): This API request records a purchase made by a loyalty program member. It receives the customer information, a list of purchased items, and transaction details, then updates the member’s loyalty points balance and purchase history. After processing, it returns a confirmation of the recorded purchase, the updated points balance, and any rewards or benefits earned during the transaction.