Set rates
POST /api/connector/v1/rates/set
Adds new Rates or updates existing ones if they are matched by Id or ExternalIdentifier property. This operation supports Portfolio Access Tokens.
Request Body
Section titled “Request Body ”object
Token identifying the client application.
Access token of the client application.
Name and version of the client application.
Unique identifier of the enterprise. Required when using Portfolio Access Tokens, ignored otherwise.
Rates to be added or updated.
object
Unique identifier of the rate. If it matches an existing rate, that rate will be updated. If no match is found, an error will be returned.
Unique identifier of the rate in the external system. If Id is not provided and ExternalIdentifier matches an existing rate, the corresponding rate will be updated. If no match is found, a new rate will be created.
Unique identifier of the service. Ignored in case of updating an existing rate.
Unique identifier of the rate group under which rate is assigned. Empty value means that rate is added to a default group or the current group is kept for update, respectively.
Whether the rate is available to customers. true will be used as a default if not provided.
Type of the rate. Private will be used as a default if not provided.
Public
Private
All translations of the name of the rate.
object
All translations of the description.
object
Rate pricing type. Must match existing pricing type in case of update.
BaseRatePricing
DependentRatePricing
Contains additional data about pricing of the rate.
object
Additional data for rates with base rate pricing. Used when PricingType is BaseRatePricing. Defaults are applied if not specified: amount is set to 10000 in default Enterprise’s currency and with its default accommodation tax rate code.
object
Price of the product that overrides the price defined in Mews.
object
Additional data for rate with dependent rate pricing. Required when PricingType is DependentRatePricing.
object
Unique identifier of the base rate.
Relative amount which shows the difference between this rate and the base rate.
Specific amount which shows the difference between this rate and the base rate.
Example
{ "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D", "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D", "Client": "Sample Client 1.0.0", "Rates": [ { "Id": "e1b0bf46-32a3-4f7c-99c1-1ff78447d55d", "ServiceId": "956176af-e10b-4f3c-beb7-274801bce328", "RateGroupId": "d7adfddc-c2dc-4798-ace2-28de7b25408f", "IsEnabled": true, "Type": "Public", "Names": { "en-US": "Base rate" }, "Descriptions": { "en-US": "Base rate with all fields specified using GUID identifiers." }, "PricingType": "BaseRatePricing", "Pricing": { "BaseRatePricing": { "Amount": { "Currency": "EUR", "NetValue": 100 } } } }, { "ExternalIdentifier": "55698", "ServiceId": "eid:Stay", "RateGroupId": "eid:RG10", "IsEnabled": false, "Type": "Private", "Names": { "en-US": "Dependent rate" }, "Descriptions": { "en-US": "Dependent rate with all field specified using eid identifiers." }, "PricingType": "DependentRatePricing", "Pricing": { "DependentRatePricing": { "BaseRateId": "00392166-3869-4174-b491-cf0162524a38", "RelativeAdjustment": 0, "AbsoluteAdjustment": 0 } } } ], "EnterpriseId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"}Responses
Section titled “ Responses ”OK
object
Rates that were added or updated.
object
Unique identifier of the rate.
Unique identifier of Rate Group where the rate belongs.
Unique identifier of the Service.
Unique identifier of the base Rate.
Indicates if this is a base rate.
Unique identifier of the Business Segment.
Indicates if this rate is active.
Indicates if this rate is currently available to customers.
Indicates if this rate is publicly available.
Indicates if this rate is the default rate for the service. Assigned automatically to the first rate of a service.
Type of the rate.
Public
Private
AvailabilityBlock
Name of the rate (in the default language).
All translations of the name.
object
Short name of the rate (in the default language).
Interval in which the rates were updated.
All translations of the external name of the rate.
object
All translations of the description of the rate.
object
Identifier of the rate from external system.
Specifies the reason a rate is exempt from tax.
IT_N1 (N1 - Escluse ex art.15)
IT_N2_2 (N2.2 - Non soggette – altri casi)
IT_N3_5 (N3.5 - Non imponibili – a seguito di dichiarazioni d’intento)
IT_N4 (N4 - Esenti)
IT_N5 (N5 - Regime del margine / IVA non esposta in fattura)
PL_ZW (ZW - Zwolniony)
PL_NP (NP - Nie podlega)
Legal reference that states why this rate is exempt from tax.
Example
{ "Rates": [ { "Id": "e1b0bf46-32a3-4f7c-99c1-1ff78447d55d", "GroupId": "d7adfddc-c2dc-4798-ace2-28de7b25408f", "ServiceId": "956176af-e10b-4f3c-beb7-274801bce328", "BaseRateId": null, "IsBaseRate": true, "BusinessSegmentId": "dc9188f6-fb61-412c-b3fd-af32dab082ed", "IsActive": true, "IsEnabled": true, "IsPublic": true, "IsDefault": false, "Type": "Public", "Name": null, "Names": { "en-US": "Base rate" }, "ShortName": "BR", "UpdatedUtc": "2024-11-20T00:00:00Z", "ExternalNames": { "en-US": "External base rate" }, "Description": { "en-US": "Base rate description." }, "ExternalIdentifier": null, "TaxExemptionReason": null, "TaxExemptionLegalReference": null }, { "Id": "8eb1f163-bce7-49ca-a62c-c9261951c85f", "GroupId": "d7adfddc-c2dc-4798-ace2-28de7b25408f", "ServiceId": "956176af-e10b-4f3c-beb7-274801bce328", "BaseRateId": "00392166-3869-4174-b491-cf0162524a38", "IsBaseRate": false, "BusinessSegmentId": "dc9188f6-fb61-412c-b3fd-af32dab082ed", "IsActive": true, "IsEnabled": false, "IsPublic": false, "IsDefault": false, "Type": "Private", "Name": null, "Names": { "en-US": "Dependent rate" }, "ShortName": "DR", "UpdatedUtc": "2024-11-20T00:00:00Z", "ExternalNames": { "en-US": "External dependent rate" }, "Description": { "en-US": "Dependent rate description." }, "ExternalIdentifier": "55698", "TaxExemptionReason": null, "TaxExemptionLegalReference": null } ]}Server has successfully fulfilled the request and there is no additional information to send back.
object
Error caused by the client app, e.g. in case of malformed request or invalid identifier of a resource. In most cases, such an error signifies a bug in the client app (consumer of the API).
object
Error caused by usage of invalid ClientToken, AccessToken, or you may not have the necessary permission to use the endpoint.
object
Server error that should be reported to the end user of the client app. Happens for example when the server-side validation fails or when a business-logic check is violated.
object
Error caused by heavy request that takes too long to process (typically tens of seconds). To get around this, request data in smaller batches. For more information, see Request timeouts
object
Error caused by too many requests sent in a given amount of time. Response contains Retry-After header indicating how long the user agent should wait before making a follow-up request. For more information, see Request limits.
object
Unexpected error on the Mews side. This may be due to a software fault. If such a situation occurs, the error will be logged and the development team notified, however you can raise an issue through GitHub on our documentation repository.