FAQ

HomeKnowledge BaseFAQ

How to Restart a Failed Guest Registration

54 views /  0 like /  / admin/

Quick Links:

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

    "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 
    					
    

    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 
    					
    

    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 
    					
    

    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.
Related Articles