1. FreeOrder
Example be.open API
  • be.open API
    • be.open API
    • Auth
      • Get api auth token
    • Attributes & Options
      • get all available attributes
      • add or update an attribute
      • get an attribute
      • adds or updates an option
      • get attribute categories
      • get options of a type
    • Basket
      • get Basket
    • Price
      • get Price list
    • Categories
      • get product categories
      • Returns the products of a category.
    • Products & Combinations
      • get product configuration
      • get option configuration
      • get product attributes
      • get product independant attributes
      • Returns the products.
      • adds or updates a product with attributes, options and combinations.
      • Returns the single product.
      • adds or updates attributes, options and combinations of a product. Used to import combinations in parts
      • delete combinations.
      • get country attribute with options
    • Serviceprovider
      • change attribute settings just for this service provider
      • change option settings just for this service provider
      • change attribute category setting just for this service provider
      • /api/serviceproviders/{serviceproviderId}/orders
      • /api/serviceproviders/{serviceproviderId}/orders/{orderId}
      • /api/serviceproviders/{serviceproviderId}/orders/{orderId}
    • Order
      • create an order
      • create order with upload
      • get order
    • Dashboard API (MOVE TO ANOTHER PROJECT)!
      • Customer
        • whoAmI
        • addExternalClient
      • Orders
        • create order
        • update order
        • update order cart
    • Schemas
      • Schemas
        • Attribute
        • DeleteQuantityShipping
        • DeleteQuantityDelivery
        • Authentication
        • AuthenticationResponse
        • AttributeCategory
        • CreateAttribute
        • CreateOption
        • CategoryModel
        • Product
        • CreateProductCombination
        • DeleteProductCombination
        • BasicOrder
        • Order
        • Option
        • ProductMetaInformation
        • DeleteProductVariant
        • Client
        • OrderDetail
        • OrderCustomField
        • OrderFile
        • OrderUpload
        • File
        • ProductAttribute
        • DeleteProductQuantity
        • PartialDelivery
        • OrderDetailFile
        • ProductCombination
        • Address
        • OrderDetailPrice
        • OrderDetailCombination
        • Address2
        • PriceConfiguration
        • Currency
        • ConfigurationOption
        • Price
        • ConfigurationOptionSize
      • Improved Schemas
        • ExampleAttributesCollection
        • Attribute
        • AttributeMetaData
        • Category
      • Responses
      • Custom Schemas
        • ProductResponse
        • OptionOfAttribute
        • CreateProduct
        • ProductTypeData
        • ProductQuantity
        • QuantityShipping
        • QuantityDelivery
        • LooseLeafData
        • DependableAttribute
        • DependableOption
        • ProductVariant
        • AttributeResponse
        • OrderResponse
        • OrderDetailResponse
        • OrderDetailPage
        • OrderAttributeOption
        • UpdateServiceproviderOrderResponse
        • ServiceproviderOrderDetail
        • BasketPrice
        • OrderAddressResponse
        • AttributeOption
        • CreateOrderAddress
        • CreateOrder
        • PatchServiceProviderOrder
      • placedOrder
  • Druckshop API
    • Cart
      • getByJobNumber
    • Tracking
      • getByJobNumber
      • addTrackingId
    • Order
      • getOrder
      • getOrders
      • getOrderByReference
      • getOrderCart
    • FreeOrder
      • addFreeOrder
        POST
    • Schemas
      • FreeOrder
      • FreeOrderResponse
      • ApiAddress
      • FreeOrderPrice
      • FreeOrderCart
      • FreeOrderArticle
      • FreeOrderDataKeyValuePrice
  1. FreeOrder

addFreeOrder

POST
/api/component/Order

Request

Body Params application/json

Example
{
    "externalReferenceNumber": "AX-33724-O",
    "billingAddress": {
        "company": "Company",
        "firstname": "Max",
        "lastname": "Mustermann",
        "street": "Main road 7",
        "zip": "12345",
        "city": "Berlin",
        "countryListId": "1",
        "mail": "max@mustermann.com",
        "phone": "+4933759964",
        "mobilephone": "+4915233486",
        "fax": "+4933759965",
        "homepage": "https://beprint.app",
        "ustid": "DE123456789",
        "gender": "m"
    },
    "deliveryAddress": {
        "company": "Company",
        "firstname": "Max",
        "lastname": "Mustermann",
        "street": "Main road 7",
        "zip": "12345",
        "city": "Berlin",
        "countryListId": "1",
        "mail": "max@mustermann.com",
        "phone": "+4933759964",
        "mobilephone": "+4915233486",
        "fax": "+4933759965",
        "homepage": "https://beprint.app",
        "ustid": "DE123456789",
        "gender": "m"
    },
    "senderAddress": {
        "company": "Company",
        "firstname": "Max",
        "lastname": "Mustermann",
        "street": "Main road 7",
        "zip": "12345",
        "city": "Berlin",
        "countryListId": "1",
        "mail": "max@mustermann.com",
        "phone": "+4933759964",
        "mobilephone": "+4915233486",
        "fax": "+4933759965",
        "homepage": "https://beprint.app",
        "ustid": "DE123456789",
        "gender": "m"
    },
    "price": {
        "orderPriceNet": "12.23",
        "orderPriceGross": "12.23",
        "vat": "12.23",
        "vatPrice": "12.23",
        "shipping": "12.23"
    },
    "customsOrderFields": {
        "info": "Special Request",
        "Key2": "Clean"
    },
    "items": [
        {
            "serviceProviderId": "1",
            "itemPriceNet": "12.23",
            "deliveryDate": "2024-12-30",
            "article": {
                "articleNumber": "Etc 344 PCL",
                "description": "Article description",
                "additionalArticleData": [
                    {
                        "key": "Unique Key",
                        "value": "Value",
                        "price": "12.23"
                    }
                ]
            },
            "persId": "766492",
            "persData": {
                "name": "Jessica Smith",
                "phone": 12345678
            }
        }
    ]
}

Responses

🟢201
application/json
Add FreeOrder
Body

Example
{
    "order_id": "123456",
    "externalReferenceNumber": "ReferenceKey"
}
🟠401
🟠422
Modified at 2026-04-10 14:48:20
Previous
getOrderCart
Next
FreeOrder
Built with