FAQ

Quick Links:

• API Docs

1. Check which is the cause of the error in guest statuses > details:
   Example of a failed registration:
   
   Copy Code Copied Use a different Browser

   					
   
   "statuses":{
      "police":{
         "in":{
            "code":"ERROR",
            "label":"Police verification failed",
            "details":"Error: The second surname is mandatory for Spanish people." // Error cause
         },
         "out":{
            "code":"NOT_USED",
            "label":"Not used for police registration",
            "details":""
         }
      },
      "statistics":{
         "in":{
            "code":"ERROR",
            "label":"Stat registration failed", 
            "details":"Person - residence.country field is required!" // Error cause
         },
         "out":{
            "code":"NOT_USED",
            "label":"Not used for stat registration",
            "details":"No check out registration needed"
         }
      },
      ...
   }
   
   				

   So in this example we see that police registration has failed because ‘second_surname’ is missing, and statistics registration failed because ‘residence’ is missing.

2. Update the guest data to solve the problem:
   
   Copy Code Copied Use a different Browser

   					
   
   PATCH https://a.chekin.io/api/v3/guests/27aa73500a394d56948c4846fe0a3b27/  // Guest id 
   {
      "second_surname":"Gonzalez",
      "residence":{
         "country":{
            "code":"ES"
         }
      }
   }
   
   				

3. Use the “restart police registration” endpoint, to restart failed registration within police authorities:
   
   Copy Code Copied Use a different Browser

   					
   
   POST https://a.chekin.io/api/v3/reservations/{{reservation_id}}/resend-reservation-to-police/
   	{}
   
   Response
   {
   "status": "ok"
   }
   
   				

   And use the “restart statistics registration” endpoint, to restart failed registration within statistics authorities:

   Copy Code Copied Use a different Browser

   					
   
   POST https://a.chekin.io/api/v3/reservations/{{reservation_id}}/resend-reservation-to-stat/
   	{}
   
   Response
   {
   "status": "ok"
   }
   
   				

   Only the guests with ERROR status will be retried.

   Notice: For some countries and authorities the data can be sent only once, and then the registration cannot be retried. Also, you have a time window to register guests, including retries, and it varies from country to country. You will get a proper error message in case the registration can’t be restarted due to any of these constraints.

4. You can check the legal compliance status again a little later after retrying.