Troubleshooting Policy error codes
This section captures the list of common HTTP errors you can encounter together with possible solutions to fix them.
HTTP Error Code | Error Text | Reason | Possible Fix |
---|---|---|---|
400 | Expecting exactly 1 hotel ID in the request | The request has 0 or more than 1 hotel ID specified. | Make sure to specify only one hotel ID. |
400 | Bad request | The request contains invalid or missing body parameters. | Make sure to specify all the required body parameters. For a complete list of body parameters when creating/updating a policy, see Managing Policies. |
400 | Policy ID is not valid | The request contains an incorrect policy ID. | Make sure to specify the correct policy ID. To get the list of policy IDs created for a property, see Retrieving policy details. |
400 | Reached maximum number of allowed policies... | The policy limit count of 7 for individual properties has been reached. | Edit an existing policy to specify the new policy code. For more information on how to edit a policy, see Edit policy details. |
400 | Missing required field 'cancelpenalty' | The request does not contain the mandatory cancelpenalty parameter. | Make sure to specify the cancelpenalty parameter. See Managing Policies. for more information |
400 | CANCEL_PENALTY_NOT_AVAILABLE | The specified cancellation code does not exist in the list of available codes. | Make sure to specify an existing cancellation code. See List of cancellation policy codes. for more information |
403 | Request for forbidden hotel ID(s) | The specified hotel ID is invalid or the machine account credentials do not have access to the specified hotel ID. | Make sure to specify the correct hotel ID or check your machine account credentials. |
500 | Internal server error | The web server is currently not responding. | Booking.com servers are currently busy. Make sure to try again a little later. |
Creating a duplicate policy returns an error
When creating a duplicate cancellation policy with the same combination of penalty code, guarantee payment and no show penalty conditions, the API returns an error along with the details of the existing cancellation policy.
<?xml version='1.0' encoding='UTF-8'?> <Response> <Policies> <Policy Id="341337682" GroupName="general" Type="Cancellation"> <CancelPenalty PolicyCode="568"/> <NoShowPolicy Penalty="default"/> <GuaranteePayment Required="false" EffectiveFrom="after_reservation_is_made"/> <Tags> <Default/> </Tags> </Policy> </Policies> <Errors> <Error Code="DUPLICATE_POLICY" ShortText="Cannot have 2 policies with the same cancellation and prepayment codes"> <Details> <PolicyCode>341337682</PolicyCode> </Details> </Error> </Errors> </Response> <!-- RUID: [UmFuZG9tSVYkc2RlIyh9Yc2VQEtEQcWis2P7po9uf/HW/V97Zg8yxXcJRBupSbBiP1BtpRH5az5Fe10g+nziEQ==] -->