check_preorder (PUT)

This feature adds an order to system (it was designed for specific plans). As input parameters are required.

  • the token
  • departure date(DD/MM/AAAA)
  • arrival date(DD/MM/AAAA)
  • reference
  • reference id of the plan
  • id destination territory (get_regions calls)
  • country of origin (get_countries calls)
  • exchange rate
  • ISO currency code (get_currencies calls)
  • number of passengers or beneficiaries
  • date of birth of the beneficiaries (DD/MM/AAAA)
  • number of documents of beneficiaries
  • names of beneficiaries
  • lastnames of beneficiaries
  • phone number of beneficiaries
  • emails beneficiaries
  • emergency contact name
  • emergency contact phone
  • email contact emergency
  • medical observations
  • general considerations
  • emission code
  • language (get_languages calls)

Returns the order number generated, passenger document, reference and link the report of the order.

  • Observation. In the input parameter 'id_plan' can be issued with the code of the Plan Id code (generated by the system) or the Public Id code (indicated by the customer).

  • Endpoint : preview.ilsbsys.com/apirest_v1/quote

Input Fields

Tag Name Type Size Priority
token string 16 (Mandatory)
fecha_salida string
(DD/MM/YYYY)		 11 (Mandatory)
fecha_llegada string
(DD/MM/YYYY)		 11 (Mandatory)
referencia string 100 (Optional)
id_plan string 11 (Mandatory)
pais_destino string 4 (Mandatory)
pais_origen string 4 (Mandatory)
moneda string 3 (Mandatory)
tasa_cambio string 11 (Mandatory)
pasajeros string 11 (Mandatory)
upgrades string 11 (Mandatory)
nacimientos array 50 (Mandatory)
documentos array 50 (Mandatory)
nombres array 300 (Mandatory)
apellidos array 300 (Mandatory)
telefonos array 300 (Mandatory)
correos array 300 (Mandatory)
condiciones_med array 300 (Mandatory)
nombre_contacto string 300 (Mandatory)
telefono_contacto string 50 (Mandatory)
email_contacto string 50 (Mandatory)
consideraciones_generales string 50 (Mandatory)
emision string 1 (Mandatory)
lenguaje string 3 (Mandatory)


The 'emision' field has the following options:

  • 1 = Displays status, code, value, route, document, reference, and sends the voucher link to the beneficiary's email.
  • 2 = Displays status, code, value, and reference.
  • 3 = Displays status, code, document, reference, and sends the voucher link to the email.

Fields

{
    "request" : "pre_order",
    "token" : "123456789ABC",
    "fecha_salida" : "01/01/2022",
    "fecha_llegada" : "02/02/2022",
    "referencia" : "REFEXAMPLE1234",
    "id_plan" : "1835",
    "pais_destino" : "1",
    "pais_origen" : "AR",
    "moneda" : "usd",
    "tasa_cambio" : "1",
    "pasajeros" : "1",
    "upgrades" : ["123"],
    "nacimientos" : ["01/01/1991"],
    "documentos" : ["12344321"],
    "nombres" : ["Rodrigo"],
    "apellidos" : ["Aristigueta"],
    "telefonos" : ["5753544243"],
    "correos" : ["correo@cliente.com"],
    "condiciones_med" : ["ninguna"],
    "nombre_contacto" : "Alfredo Rodriguez",
    "telefono_contacto" : "123455432",
    "email_contacto" : "correo@contacto.com",
    "consideraciones_generales" : "ninguna",
    "emision" : "1",
    "lenguaje" : "spa"
}
  • The field "pasajeros" indicates the ammount of passengers, the fields where the input is surrounded by brackets '[ ]' depend on this field, i.e. if there are 3 passengers, then: 
{
    "..." : "...",
    "nacimientos" : ["01/01/1991","02/02/1992","03/03/1993"],
    "..." : "..."
}
  • The only exception to this rule is the "upgrades" field, which doesn't depends of the ammount of passengers.

Results

 {
  "status":"OK",
  "codigo":"EN-BBE5AH",
  "valor":"43.400", 
  "documento":"1985698,19985632",
  "referencia":"wbsrr"
}

Common Error Codes

  • 1005 : Invalid Token
  • 9061 : Empty Token
  • 1003 : Language not implemented
  • 4006 : Invalid country ID
  • 6021 : Empty Language
  • 6022 : Empty plan
  • 1062 : Invalid Birthday
  • 1095 : Invalid upgrade
  • 6026 : Empty amount of passengers
  • 6045 : Order data already exists
  • 6027 : Origin country empty
  • 6028 : Destination territory empty
  • 6029 : Empty date of departure
  • 6030 : Empty date of arrival
  • 6034 : Empty currency
  • 6035 : Empty emission code
  • 6036 : Empty contact name
  • 6037 : All fields are empty
  • 2004 : the departure date cannot be less than the current date
  • 1050 : Invalid plan
  • 3030 : Invalid date range
  • 1022 : Invalid currency
  • 3153 : Element conflict in request (Age of passenger exceeds plan age limit)
  • 3150 : Missing required element (an obligatory field is empty)
  • 4005 : Passenger name is empty
  • 4006 : Passenger document is empty
  • 4007 : Passenger surname is empty
  • 5006 : Medic conditions is empty
  • 4008 : Passenger phone is emtpy
  • 1248 : Amount of days less than allowed in the plan
  • 1247 : Amount of days more than allowed in the plan
  • 1080 : Invalid territory
  • 1081 : Restricted territory
  • 5003 : Error in ridership
  • 5005 : Birthday required
  • 5009 : Invalid passenger phone number
  • 4010 : Invalid Beneficiary mail
  • 5012 : Required passenger email
  • 1091 : Restricted country
  • 9011 : Exchange rate invalid