Fixje Partner Web API (2.0)

Version: 1.0

Introduction

The Fixje Partner Web API provides seamless integration for partners to interact with the Fixje platform. This API allows partners to manage orders, retrieve product details, access available shipping methods, and interact with their storefronts efficiently. It is designed for B2B integrations, enabling automated order processing and inventory management.

Authentication

The API uses OAuth 2.0 Client Credentials Flow for authentication. Partners must obtain an access token by providing their clientId and clientSecret to the /api/v1/login endpoint. This token must be included in all subsequent API requests for authorization.

Key Features

• Order Management: Retrieve, create, and manage orders through /api/v1/orders.
• Product Listings: Fetch available products with pagination support via /api/v1/products.
• Shipping Methods: Retrieve the list of available shipping methods for a partner.
• Storefront Management: Access storefront configurations and categories.

Response Format

• All responses are available in JSON and XML formats.
• Standard HTTP status codes are used for error handling (400, 401, 404, 500).

Best Practices

• Always use HTTPS to ensure secure communication.
• Implement token expiration handling to refresh authentication as needed.
• Use pagination parameters (page, pageSize) for large data requests.
• Handle API errors by checking response codes and ProblemDetails objects.