Orders

Add order
Creates a new order with the specified products and items. Only positive charges are allowed by default, in order to post negative charges (rebates), the connector integration has to be configured in Mews to allow it. If the consumption is specified, it has to be in the future or within editable history interval of the enterprise. Compared to stay service order (Reservation) which is consumed over certain span of time, the product order is consumed at one point in time.
Request
[PlatformAddress]/api/connector/v1/orders/add
{
    "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D",
    "AccessToken": "7059D2C25BF64EA681ACAB3A00B859CC-D91BFF2B1E3047A3E0DEC1D57BE1382",
    "Client": "Sample Client 1.0.0",
    "CustomerId": "407a26f8-dcfc-4e29-b978-ab440117a153",
    "ServiceId": "d2129910-1da9-4d39-be14-ab3a00c9e70c",
    "ConsumptionUtc": "2020-02-04T00:00:00Z",
    "ProductOrders": [
        {
            "ProductId": "2eb7ad8b-8dfb-4381-aba5-ab58009f2993",
            "Count": 2
        }
    ],
    "Items": [
        {
            "Name": "Beer",
            "UnitCount": 3,
            "UnitAmount": {
                "Currency": "USD",
                "NetValue": 7,
                "TaxCodes": [
                    "US-DC-G"
                ]
            },
            "AccountingCategoryId": "90eff5aa-36b4-4689-80c0-ab3a00bb412e"
        }
    ]
}
Property
Type
Contract
Description
ClientToken
string
required
Token identifying the client application.
AccessToken
string
required
Access token of the client application.
Client
string
required
Name and version of the client application.
CustomerId
string
required
Identifier of the Customer to be charged.
ServiceId
string
required
Identifier of the Service to be ordered.
ConsumptionUtc
string
optional
Date and time of the order consumption in UTC timezone in ISO 8601 format. If not specified, current date and time is used. Please note, as order consumption is one-time event, the optional parameters StartUtc and EndUtc in Product order parameters should not be used.
Notes
string
optional
Additional notes of the order.
ProductOrders
array of Product order parameters​
optional
Parameters of the ordered products.
Items
array of Item parameters​
optional
Parameters of the ordered custom items.
Product order parameters
Property
Type
Contract
Description
ProductId
string
required
Unique identifier of the Product to be ordered.
Count
number
optional
Count of products to be ordered, e.g. 10 in case of 10 beers.
UnitAmount
​Amount parameters​
optional
Unit amount of the product that overrides the amount defined in Mews.
StartUtc
string
optional
Product start in UTC timezone in ISO 8601 format. For products with charging Once and PerPerson must be set to same value as EndUtc. Use only with operation Add reservations or Add reservation product, can be omitted for Add order operation.
EndUtc
string
optional
Product end in UTC timezone in ISO 8601 format. For products with charging Once and PerPerson must be set to same value as StartUtc. Use only with operation Add reservations or Add reservation product, can be omitted for Add order operation.
Item parameters
Property
Type
Contract
Description
Name
string
required
Name of the item.
UnitCount
number
required
Count of units to be ordered, e.g. 10 in case of 10 beers.
UnitAmount
​Amount parameters​
required
Unit amount, e.g. amount for one beer (note that total amount of the item is therefore UnitAmount times UnitCount).
AccountingCategoryId
string
optional
Unique identifier of an Accounting category to be assigned to the item.
Amount parameters
Property
Type
Contract
Description
GrossValue
decimal
optional
Amount including tax. Required for Gross Pricing environments.
NetValue
decimal
optional
Amount excluding tax. Required for Net Pricing environments.
Currency
string
required
ISO-4217 code of the Currency.
TaxCodes
array of string
required
Codes of Tax rates to be applied to the item. (Note, you can only define one tax when sending GrossValue. For multiple taxes, use NetValue)
Response
{
    "OrderId": "cdfd5caa-2868-411b-ba95-322e70035f1a"
}
Property
Type
Contract
Description
OrderId
string
required
Unique identifier of the created order.

Property	Type	Contract	Description
`ClientToken`	string	required	Token identifying the client application.
`AccessToken`	string	required	Access token of the client application.
`Client`	string	required	Name and version of the client application.
`CustomerId`	string	required	Identifier of the Customer to be charged.
`ServiceId`	string	required	Identifier of the Service to be ordered.
`ConsumptionUtc`	string	optional	Date and time of the order consumption in UTC timezone in ISO 8601 format. If not specified, current date and time is used. Please note, as order consumption is one-time event, the optional parameters `StartUtc` and `EndUtc` in Product order parameters should not be used.
`Notes`	string	optional	Additional notes of the order.
`ProductOrders`	array of Product order parameters	optional	Parameters of the ordered products.
`Items`	array of Item parameters	optional	Parameters of the ordered custom items.

Property	Type	Contract	Description
`ProductId`	string	required	Unique identifier of the Product to be ordered.
`Count`	number	optional	Count of products to be ordered, e.g. 10 in case of 10 beers.
`UnitAmount`	Amount parameters	optional	Unit amount of the product that overrides the amount defined in Mews.
`StartUtc`	string	optional	Product start in UTC timezone in ISO 8601 format. For products with charging `Once` and `PerPerson` must be set to same value as `EndUtc`. Use only with operation Add reservations or Add reservation product, can be omitted for Add order operation.
`EndUtc`	string	optional	Product end in UTC timezone in ISO 8601 format. For products with charging `Once` and `PerPerson` must be set to same value as `StartUtc`. Use only with operation Add reservations or Add reservation product, can be omitted for Add order operation.

Property	Type	Contract	Description
`Name`	string	required	Name of the item.
`UnitCount`	number	required	Count of units to be ordered, e.g. 10 in case of 10 beers.
`UnitAmount`	Amount parameters	required	Unit amount, e.g. amount for one beer (note that total amount of the item is therefore `UnitAmount` times `UnitCount`).
`AccountingCategoryId`	string	optional	Unique identifier of an Accounting category to be assigned to the item.

Property	Type	Contract	Description
`GrossValue`	decimal	optional	Amount including tax. Required for Gross Pricing environments.
`NetValue`	decimal	optional	Amount excluding tax. Required for Net Pricing environments.
`Currency`	string	required	ISO-4217 code of the Currency.
`TaxCodes`	array of string	required	Codes of Tax rates to be applied to the item. (Note, you can only define one tax when sending `GrossValue`. For multiple taxes, use `NetValue`)

Property	Type	Contract	Description
`OrderId`	string	required	Unique identifier of the created order.

Message threads

Outlet bills

Last modified 8mo ago