Skip to content

FuelU2 Supplier API (1.0.0)

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

Download OpenAPI description
supplier.json
supplier.yaml
Overview
FuelU2 API Support

support@fuelu2.com

License

MIT

Languages
Servers
Mock server

https://developers.fuelu2.com/_mock/apis/supplier/

Production server

https://api.fuelu2.com/

Authentication

Operations

Depots

Operations

Orders

Operations

List Orders

Request

Returns a list of orders.

Security
bearerAuth
Query
queryobject
curl -i -X GET \
  'https://developers.fuelu2.com/_mock/apis/supplier/Orders?Page=0&PageSize=0' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

List of orders

Bodyapplication/json
dataArray of objects
totalinteger
Example: 42
Response
application/json
{
  "data": [
    { … }
  ],
  "total": 42
}

Get Orders By ID

Request

Fetch a single order by ID.

Security
bearerAuth
Path
idstringrequired
curl -i -X GET \
  'https://developers.fuelu2.com/_mock/apis/supplier/Orders/{id}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Order full details

Bodyapplication/json
Idstring
Example: "123e4567-e89b-12d3-a456-426614174000"
Statusstring
Example: "InProgress"
CustomerNamestring
Example: "Acme Corp"
DeliveryNotestring
Example: "DN-00123"
Response
application/json
{
  "Id": "123e4567-e89b-12d3-a456-426614174000",
  "Status": "InProgress",
  "CustomerName": "Acme Corp",
  "DeliveryNote": "DN-00123"
}

Verify Orders

Request

Verifies an order using OTP or registration.

Security
bearerAuth
Bodyapplication/jsonrequired
OrderIdstring
Example: "123e4567-e89b-12d3-a456-426614174000"
OTPstring
Example: "456789"
curl -i -X POST \
  https://developers.fuelu2.com/_mock/apis/supplier/Orders/verify \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "OrderId": "123e4567-e89b-12d3-a456-426614174000",
    "OTP": "456789"
  }'

Responses

Verification successful

Bodyapplication/json
Idinteger
Example: 1
Statusstring
Example: "Verified"
Response
application/json
{
  "Id": 1,
  "Status": "Verified"
}

Fulfill Orders

Request

Fulfills an order and optionally uploads a POS/proof-of-sale file.

Security
bearerAuth
Bodymultipart/form-data
OrderIdstring
Example: "123e4567-e89b-12d3-a456-426614174000"
Filestring(binary)
curl -i -X POST \
  https://developers.fuelu2.com/_mock/apis/supplier/Orders/fulfill \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: multipart/form-data' \
  -F OrderId=123e4567-e89b-12d3-a456-426614174000 \
  -F File=string

Responses

Order fulfilled successfully

Bodyapplication/json
messagestring
Example: "Order fulfilled successfully"
Response
application/json
{
  "message": "Order fulfilled successfully"
}

Cancel Orders

Request

Allows users to cancel orders.

Security
bearerAuth
Bodyapplication/jsonrequired
OrderIdstring(uuid)required
Example: "d290f1ee-6c54-4b01-90e6-d701748f0851"
Reasonstring
Example: "Customer requested cancellation"
curl -i -X POST \
  https://developers.fuelu2.com/_mock/apis/supplier/Orders/cancel \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "OrderId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "Reason": "Customer requested cancellation"
  }'

Responses

Order cancelled successfully

Bodyapplication/json
messagestring
Example: "Order cancelled successfully"
Response
application/json
{
  "message": "Order cancelled successfully"
}

Add An Order To An Invoice

Request

Submits a new supplier invoice and links related orders.

Security
bearerAuth
Bodymultipart/form-datarequired
supplierInvoicestring

JSON stringfiels supplier invoice submission command.

Example: "{\"SupplierId\": \"guid\", \"Orders\": [{\"Id\": \"guid\", \"ActualFillAmount\": 100}]}"
filestring(binary)

PDF or document file of the supplier invoice.

curl -i -X POST \
  https://developers.fuelu2.com/_mock/apis/supplier/SupplierInvoices/submitinvoice \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: multipart/form-data' \
  -F 'supplierInvoice={"SupplierId": "guid", "Orders": [{"Id": "guid", "ActualFillAmount": 100}]}' \
  -F file=string

Responses

Supplier invoice submitted successfully.

Bodyapplication/json
messagestring
Example: "Supplier invoice submitted successfully."
Response
application/json
{
  "message": "Supplier invoice submitted successfully."
}

Remove Orders From Invoices

Request

Removes an order from an invoice.

Security
bearerAuth
Bodyapplication/jsonrequired
OrderIdstring
Example: "123e4567-e89b-12d3-a456-426614174000"
InvoiceIdstring
Example: "INV-00123"
curl -i -X POST \
  https://developers.fuelu2.com/_mock/apis/supplier/Orders/removeOrderFromInvoice \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "OrderId": "123e4567-e89b-12d3-a456-426614174000",
    "InvoiceId": "INV-00123"
  }'

Responses

Order removed from invoice successfully

Bodyapplication/json
messagestring
Example: "Order removed from invoice successfully"
Response
application/json
{
  "message": "Order removed from invoice successfully"
}

Invoices

Operations

Price Change

Operations