Update an order

PATCH /company/orders/@id

Request

Authentication

This endpoint requires authentication.

Header Value
Authorization Set the value to Bearer + + access_token

URL parameters

Replace the @ keywords in the URL with their corresponding value.

A dictionary with fields

Field Type Description
id Int The ID of the order you want to update

Body

Pass the following properties via application/json or form encoding in the body of the request.

Field Type Description
id Int Id of the product
shop_id Int Id of the shop where this order has been placed
company_id Int Id of the company of the shop where this order has been placed
status String String enumarion of 'PENDING', 'HAS_READ', 'APPROVED', 'DECLINED', 'REMOVED', 'DELETED_BY_SHOP', 'COLLECTED'
order_nr Int Unique number on a yearly basis and per shop. Visible for the shop and consumers.
prices Prices Prices
payment_method String String enumarion of 'point_of_sale', 'paid_in_shop', 'bank_transfer', 'ideal', 'bancontact', 'sofort', 'giropay', 'creditcard', 'cartes_bancaires', 'paypal', 'eps_uberweisung', 'apple_pay', 'google_pay', 'payconiq', 'monizze', 'edenred', 'webpay', 'satispay', 'stripe_card_visa_mc', 'stripe_card_amex', 'stripe_apple_pay', 'stripe_google_pay', 'payu_romania_visa', 'payu_romania_mc', 'payu_romania_visa_electron', 'payu_romania_maestro', 'payu_brazil_amex', 'payu_brazil_boleto_bancario', 'payu_brazil_diners', 'payu_brazil_elo', 'payu_brazil_hipercard', 'payu_brazil_mc', 'payu_brazil_visa', 'payu_sp_maestro', 'payu_sp_mc', 'payu_sp_pbl', 'payu_sp_visa', 'payu_sp_blik', 'payu_iyzico_amex', 'payu_iyzico_mc', 'payu_iyzico_troy', 'payu_iyzico_visa', 'pesopay_gcash', 'pesopay_visa', 'pesopay_mc', 'redsys_bizum', 'sibs_id'
checkout OrderCheckout
products [CartItem.company] A list of all the products that have been ordered. Please note that the product data (prices, name, options...) can differ from the current product data because the data of products are captured at the time of placing the order to prevent product changes to affect existing orders.
invoice Checkout.Company? Nullable. When the consumer requested an invoice, this value will contain all the invoice details.
isop Checkout.ISOP? Nullable. When this order has been placed with the ISOP module, it will contain all the isop details.
consumer company.Consumer? Nullable. Contains some information about the user that placed the order. It may not be available when the data had to be removed for GDPR compliance.
created_at Timestamp Time when the order was created, measured in the number of seconds since the Unix Epoch (January 1 1970 00:00:00 GMT).

Example request 1

PATCH /company/orders/19 HTTP/1.1
Host: api.bakeronline.be
X-VERSION: 1.0.1
Accept-Language: en-US,en;q=0.5
Content-Type: application/json
Content-Length: 1376
{
    "id": 15,
    "shop_id": 12,
    "company_id": 15,
    "status": "PENDING",
    "order_nr": 15,
    "prices": {
        "price": 12,
        "discount": 15,
        "warranty": 16,
        "delivery_cost": 16,
        "invoice_cost": 18,
        "sms_cost": 13,
        "transaction_cost": 14,
        "price_to_pay": 11
    },
    "payment_method": "point_of_sale",
    "checkout": {
        "method": "delivery",
        "date": "2019-01-31",
        "time": "12:00",
        "end_time": "12:00",
        "address": {
            "street": "Sint-Denijslaan",
            "nr": "96",
            "zipcode": "9000",
            "city": "Gent",
            "country": "BE"
        },
        "notes": "...",
        "name": "...",
        "latch_id": 16
    },
    "products": [
        [],
        [],
        []
    ],
    "invoice": {
        "name": "...",
        "vat": "BE0123456789",
        "address": {
            "street": "Sint-Denijslaan",
            "nr": "96",
            "zipcode": "9000",
            "city": "Gent",
            "country": "BE"
        }
    },
    "isop": {
        "origin": "in-store",
        "customer_id": 18,
        "employee_id": 14
    },
    "consumer": {
        "email": "example@domain.com",
        "firstname": "...",
        "lastname": "...",
        "phone": "+32 475 00 00 00"
    },
    "created_at": 1657086115
}

Response

Field Type Description
id Int Id of the product
shop_id Int Id of the shop where this order has been placed
company_id Int Id of the company of the shop where this order has been placed
status String String enumarion of 'PENDING', 'HAS_READ', 'APPROVED', 'DECLINED', 'REMOVED', 'DELETED_BY_SHOP', 'COLLECTED'
order_nr Int Unique number on a yearly basis and per shop. Visible for the shop and consumers.
prices Prices Prices
payment_method String String enumarion of 'point_of_sale', 'paid_in_shop', 'bank_transfer', 'ideal', 'bancontact', 'sofort', 'giropay', 'creditcard', 'cartes_bancaires', 'paypal', 'eps_uberweisung', 'apple_pay', 'google_pay', 'payconiq', 'monizze', 'edenred', 'webpay', 'satispay', 'stripe_card_visa_mc', 'stripe_card_amex', 'stripe_apple_pay', 'stripe_google_pay', 'payu_romania_visa', 'payu_romania_mc', 'payu_romania_visa_electron', 'payu_romania_maestro', 'payu_brazil_amex', 'payu_brazil_boleto_bancario', 'payu_brazil_diners', 'payu_brazil_elo', 'payu_brazil_hipercard', 'payu_brazil_mc', 'payu_brazil_visa', 'payu_sp_maestro', 'payu_sp_mc', 'payu_sp_pbl', 'payu_sp_visa', 'payu_sp_blik', 'payu_iyzico_amex', 'payu_iyzico_mc', 'payu_iyzico_troy', 'payu_iyzico_visa', 'pesopay_gcash', 'pesopay_visa', 'pesopay_mc', 'redsys_bizum', 'sibs_id'
checkout OrderCheckout
products [CartItem.company] A list of all the products that have been ordered. Please note that the product data (prices, name, options...) can differ from the current product data because the data of products are captured at the time of placing the order to prevent product changes to affect existing orders.
invoice Checkout.Company? Nullable. When the consumer requested an invoice, this value will contain all the invoice details.
isop Checkout.ISOP? Nullable. When this order has been placed with the ISOP module, it will contain all the isop details.
consumer company.Consumer? Nullable. Contains some information about the user that placed the order. It may not be available when the data had to be removed for GDPR compliance.
created_at Timestamp Time when the order was created, measured in the number of seconds since the Unix Epoch (January 1 1970 00:00:00 GMT).

Example response 1

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 15964

{
    "id": 11,
    "shop_id": 19,
    "company_id": 17,
    "status": "PENDING",
    "order_nr": 16,
    "prices": {
        "price": 11,
        "discount": 15,
        "warranty": 19,
        "delivery_cost": 18,
        "invoice_cost": 10,
        "sms_cost": 13,
        "transaction_cost": 19,
        "price_to_pay": 13
    },
    "payment_method": "point_of_sale",
    "checkout": {
        "method": "delivery",
        "date": "2019-01-31",
        "time": "12:00",
        "end_time": "12:00",
        "address": {
            "street": "Sint-Denijslaan",
            "nr": "96",
            "zipcode": "9000",
            "city": "Gent",
            "country": "BE"
        },
        "notes": "...",
        "name": "...",
        "latch_id": 11
    },
    "products": [
        {
            "amount": 18,
            "persons": 16,
            "gram": 15,
            "comment": "...",
            "product": {
                "id": 14,
                "name": "...",
                "images": [
                    {
                        "resolutions": [
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            },
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            },
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            }
                        ],
                        "white_background": true
                    },
                    {
                        "resolutions": [
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            },
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            },
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            }
                        ],
                        "white_background": false
                    },
                    {
                        "resolutions": [
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            },
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            },
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            }
                        ],
                        "white_background": false
                    }
                ],
                "price_type": "PER_UNIT",
                "target_price": true,
                "price": 15
            },
            "product_price": {
                "id": 18,
                "name": "...",
                "price": 16
            },
            "calculated_prices": {
                "unit_price": 14,
                "price": 12
            },
            "discount_prices": {
                "unit_price": 13,
                "price": 17
            },
            "options": [
                {
                    "id": 15,
                    "name": "...",
                    "price_change": 19,
                    "optionset": {
                        "id": 19,
                        "name": "...",
                        "allow_attachment": true
                    }
                },
                {
                    "id": 14,
                    "name": "...",
                    "price_change": 10,
                    "optionset": {
                        "id": 18,
                        "name": "...",
                        "allow_attachment": true
                    }
                },
                {
                    "id": 17,
                    "name": "...",
                    "price_change": 18,
                    "optionset": {
                        "id": 13,
                        "name": "...",
                        "allow_attachment": true
                    }
                }
            ],
            "uploads": [
                {
                    "upload": {
                        "id": 14,
                        "url": "https://example.com"
                    },
                    "optionset_id": 19
                },
                {
                    "upload": {
                        "id": 16,
                        "url": "https://example.com"
                    },
                    "optionset_id": 19
                },
                {
                    "upload": {
                        "id": 14,
                        "url": "https://example.com"
                    },
                    "optionset_id": 10
                }
            ],
            "code": "..."
        },
        {
            "amount": 16,
            "persons": 12,
            "gram": 14,
            "comment": "...",
            "product": {
                "id": 18,
                "name": "...",
                "images": [
                    {
                        "resolutions": [
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            },
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            },
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            }
                        ],
                        "white_background": true
                    },
                    {
                        "resolutions": [
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            },
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            },
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            }
                        ],
                        "white_background": false
                    },
                    {
                        "resolutions": [
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            },
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            },
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            }
                        ],
                        "white_background": true
                    }
                ],
                "price_type": "PER_UNIT",
                "target_price": false,
                "price": 19
            },
            "product_price": {
                "id": 10,
                "name": "...",
                "price": 18
            },
            "calculated_prices": {
                "unit_price": 14,
                "price": 11
            },
            "discount_prices": {
                "unit_price": 12,
                "price": 12
            },
            "options": [
                {
                    "id": 19,
                    "name": "...",
                    "price_change": 15,
                    "optionset": {
                        "id": 13,
                        "name": "...",
                        "allow_attachment": false
                    }
                },
                {
                    "id": 10,
                    "name": "...",
                    "price_change": 14,
                    "optionset": {
                        "id": 15,
                        "name": "...",
                        "allow_attachment": false
                    }
                },
                {
                    "id": 12,
                    "name": "...",
                    "price_change": 18,
                    "optionset": {
                        "id": 17,
                        "name": "...",
                        "allow_attachment": false
                    }
                }
            ],
            "uploads": [
                {
                    "upload": {
                        "id": 17,
                        "url": "https://example.com"
                    },
                    "optionset_id": 17
                },
                {
                    "upload": {
                        "id": 13,
                        "url": "https://example.com"
                    },
                    "optionset_id": 16
                },
                {
                    "upload": {
                        "id": 13,
                        "url": "https://example.com"
                    },
                    "optionset_id": 13
                }
            ],
            "code": "..."
        },
        {
            "amount": 11,
            "persons": 18,
            "gram": 10,
            "comment": "...",
            "product": {
                "id": 18,
                "name": "...",
                "images": [
                    {
                        "resolutions": [
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            },
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            },
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            }
                        ],
                        "white_background": false
                    },
                    {
                        "resolutions": [
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            },
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            },
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            }
                        ],
                        "white_background": true
                    },
                    {
                        "resolutions": [
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            },
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            },
                            {
                                "src": "https://example.com",
                                "width": 600,
                                "height": 350
                            }
                        ],
                        "white_background": false
                    }
                ],
                "price_type": "PER_UNIT",
                "target_price": false,
                "price": 17
            },
            "product_price": {
                "id": 17,
                "name": "...",
                "price": 17
            },
            "calculated_prices": {
                "unit_price": 10,
                "price": 16
            },
            "discount_prices": {
                "unit_price": 15,
                "price": 10
            },
            "options": [
                {
                    "id": 14,
                    "name": "...",
                    "price_change": 13,
                    "optionset": {
                        "id": 16,
                        "name": "...",
                        "allow_attachment": true
                    }
                },
                {
                    "id": 14,
                    "name": "...",
                    "price_change": 11,
                    "optionset": {
                        "id": 11,
                        "name": "...",
                        "allow_attachment": false
                    }
                },
                {
                    "id": 14,
                    "name": "...",
                    "price_change": 11,
                    "optionset": {
                        "id": 11,
                        "name": "...",
                        "allow_attachment": true
                    }
                }
            ],
            "uploads": [
                {
                    "upload": {
                        "id": 11,
                        "url": "https://example.com"
                    },
                    "optionset_id": 12
                },
                {
                    "upload": {
                        "id": 18,
                        "url": "https://example.com"
                    },
                    "optionset_id": 19
                },
                {
                    "upload": {
                        "id": 15,
                        "url": "https://example.com"
                    },
                    "optionset_id": 16
                }
            ],
            "code": "..."
        }
    ],
    "invoice": {
        "name": "...",
        "vat": "BE0123456789",
        "address": {
            "street": "Sint-Denijslaan",
            "nr": "96",
            "zipcode": "9000",
            "city": "Gent",
            "country": "BE"
        }
    },
    "isop": {
        "origin": "in-store",
        "customer_id": 17,
        "employee_id": 14
    },
    "consumer": {
        "email": "example@domain.com",
        "firstname": "...",
        "lastname": "...",
        "phone": "+32 475 00 00 00"
    },
    "created_at": 1657086115
}
Version update available Please adjust your integration to the latest stable version (1.9.0)
1.0.1 stable