# FuelU2 Supplier API

API for managing supplier accounts, configurations, and markups across the FuelU2 ecosystem.

Version: 1.0.0
License: MIT

## Servers

Production server
```
https://api.fuelu2.com
```

## Security

### bearerAuth

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

[FuelU2 Supplier API](https://developers.fuelu2.com/_bundle/apis/supplier.yaml)

## Authentication

### User Login

 - [POST /Users/login](https://developers.fuelu2.com/apis/supplier/authentication/userlogin.md): Authenticates a user and returns a token that must be included in the Authorization header for subsequent requests.

### User Logout

 - [POST /Users/logout](https://developers.fuelu2.com/apis/supplier/authentication/userlogout.md): Logs out the currently authenticated user by invalidating their session token.

## Depots

### Create/Edit A Depot

 - [POST /SupplierDepots](https://developers.fuelu2.com/apis/supplier/depots/createoreditsupplierdepot.md): Create or update a depot.

### Get A Paged Depot List

 - [GET /SupplierDepots/paged](https://developers.fuelu2.com/apis/supplier/depots/getsupplierdepotspaged.md): Retrieve depots in a paginated format.

## Orders

### List Orders

 - [GET /Orders](https://developers.fuelu2.com/apis/supplier/orders/getsupplierorders.md): Returns a list of orders.

### Get Orders By ID

 - [GET /Orders/{id}](https://developers.fuelu2.com/apis/supplier/orders/getsupplierorderbyid.md): Fetch a single order by ID.

### Verify Orders

 - [POST /Orders/verify](https://developers.fuelu2.com/apis/supplier/orders/verifysupplierorder.md): Verifies an order using OTP or registration.

### Fulfill Orders

 - [POST /Orders/fulfill](https://developers.fuelu2.com/apis/supplier/orders/fulfillsupplierorder.md): Fulfills an order and optionally uploads a POS/proof-of-sale file.

### Cancel Orders

 - [POST /Orders/cancel](https://developers.fuelu2.com/apis/supplier/orders/cancelorder.md): Allows users to cancel orders.

### Add An Order To An Invoice

 - [POST /SupplierInvoices/submitinvoice](https://developers.fuelu2.com/apis/supplier/orders/submitsupplierinvoice.md): Submits a new supplier invoice and links related orders.

### Remove Orders From Invoices

 - [POST /Orders/removeOrderFromInvoice](https://developers.fuelu2.com/apis/supplier/orders/removeorderfrominvoice.md): Removes an order from an invoice.

## Invoices

### Create/Edit An Invoice

 - [POST /SupplierInvoices](https://developers.fuelu2.com/apis/supplier/invoices/createoreditsupplierinvoice.md): Creates a new or updates an existing supplier invoice for the authenticated SupplierAdmin.

### Get Invoices

 - [GET /SupplierInvoices](https://developers.fuelu2.com/apis/supplier/invoices/getsupplierinvoices.md): Retrieves a list of supplier invoices for the authenticated SupplierAdmin user.

## Price Change

### Request A Price Change

 - [POST /pricechangerequest](https://developers.fuelu2.com/apis/supplier/price-change/requestpricechange.md): Allows a user to request a price change for a supplier depot.