📦 Orders

Endpoints for programmatically inserting customer orders into the system.

🔐 Authentication

All requests must include a Bearer token in the Authorization header:

Authorization: Bearer <your-access-token>

If the token is missing or invalid, the request will be rejected with a 401 Unauthorized response.

📦 Creating Orders

To create a new order in the Frisbo system, send a POST request to the /orders/order endpoint with a valid Authorization header and a properly structured JSON payload. This request should include all the details needed to process and fulfill the order.

📄 Required Headers

Header	Value	Required
`Authorization`	`Bearer <access-token>`	✅
`Content-Type`	`application/json`	✅

🧾 Request Body (JSON)

The request body must contain all the details from the basic JSON payload:

external_identifier (unique identifier from your system)
created_at (ISO 8601 timestamp)
fulfillments details (tracking number, urls and comapnies)
shipping_address and billing_address
An array of line_items (with SKU, quantity, price, currency)

A basic example JSON payload is shown below (full details in the Reference tab):

{
  "order": {
    "external_identifier": "98111",
    "cancel_reason": null,
    "cancelled_at": null,
    "created_at": "2025-02-21T14:47:52",
    "currency": "RON",
    "financial_status": "pending",
    "fulfillments": [
        {
            "tracking_company": "gls_de",
            "tracking_numbers": [
                "8213671286327"
            ],
            "tracking_urls": [
                "https://www.gls-pakete.de/reach-sendungsverfolgung?trackingNumber=8213671286327"
            ]
        }
    ],
    "line_items": [],
    "name": "#98111",
    "payment_terms": {
      "amount": 1,
      "currency": "EUR",
      "payment_terms_name": "Cash on Delivery (COD)
    },
    "payment_gateway_names": [
        "Cash on Delivery (COD)"
    ],
    "reference": "#98111",
    "shipping_address": {
      "address1": "",
      "address2": "",
      "city": "Berlin",
      "company": "",
      "country": "Deutschland",
      "country_code": "DE",
      "first_name": "John",
      "last_name": "Doe",
      "latitude": "",
      "longitude": "",
      "name": "John Doe",
      "phone": "+490741217871",
      "province": "Berlin",
      "province_code": "",
      "zip": "10115"
    },
    "total_price": "120.3",
    "current_total_price": "120.3"
  }
}

🔍 Search Orders

Use this endpoint to retrieve a list of previously created orders. You can fetch orders by order_number, filter by date range, or search by customer details.

🔁 Endpoint

GET https://ingest.apis.store-view.frisbo.dev/orders/search