Obtener porcentaje de comisión sobre una tarifa

Consultar el número de porcentaje de comisión sobre una tarifa de convenio en un país determinado.

Antes de utilizar este servicio se le debe asignar un id de agente para cada marca. Contacte a su ejecutivo de cuenta para arreglar las condiciones comerciales o si ya tiene asignado un ID contacte al departamento de sistemas para realizar la asociación a sus credenciales de usuario.

Protocolo soportado:
HTTPS / TLS 1.2 - TLS 1.3
Endpoint:
Solicitud
Encabezados: 
Accept-Encoding: gzip
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.goyEtVbG9naW5OYW1lIjoiURTLmqwCRJT05TIEdST1VQIEFTU09DSUFUT05TIFNSTCAyIiwiVWxvZ2luSUQiOiJSKLIMNCVI4MWU2YjUzZTc1ZWQxYzUwMzXXv98UMxYmIxNjliMDlhM2VlZmYxYzIyMDdhOwCvfAM1ZTA5ZjM4NDNq2jJhNGFjMDIwN2JhNGEzN2ZhNWQ3YWNmMzQ4OTQ0YjRmMDU3MTZmNGRmMDA1OGZmNzZhNiIsImlzcyI6ImFwaS5hYmctY2Fycy5jb20iLCJyZW50YWxjb21wYW55IjpbIkFWSVMiLCJCVURHRVQiXSwic2NvcGVzIjpbIlZlaFJldFJlc1JRIiwiVmVoQXZhaWxSYXRlUlEiLCJBdXRoVG9rZW5SUSIsIlZlaFJlc1JRIiwiVmVoTW9kaWZ5UlEiLCJWZWhDYW5jZWxSUSIsIlZlaEZsZWV0UlEiLCJWZWhMb2NhdGlvblJRIl0sImlhdCI6MTUxMTk4NTEzNCwiZXhwI2QASTg1MzE0fQ.Gy8hejPlT3KScb-g1x9KW2LSszESBSQO1zmZD4RTUIMz9e0yn8W6-UkYzxnlSdHsz1Z9Qe2CERCqpiqLUC
ejemplo consulta GET: 
          
      https://api.carrental-int.com/v2/ratecommission/?brand=AVIS&iata=111111B&rate_code=H8&country_code=US
Parámetros:
campodescripción
brand
string requerido		valores aceptados
  • AVIS
  • BUDGET
iata
string requerido		valores aceptados
Número IATA / Avis Assign / Budget Assign de la agencia.
rate_code
string requerido		valores aceptados
código de la tarifa a consultar el porcentaje de comisión
country_code
string requerido		valores aceptados
código de pais a consultar (código de 2 carácteres - ISO 3166)
Respuestas
respuesta HTTP: 200 OK
Ejemplo de respuesta exitosa : 
          
{
	"appVersion": "2.8",
	"status": true,
	"brand": "AVIS",
	"environment": "QA",
	"request_time": "2023-05-12T19:21:05",
	"commission_response": {
		"commission_info": {
			"rate_code": "H8",
			"country_code": "US",
			"commPPD": 16,
			"commPOD": 0
		},
		"requestor": {
			"agt_id": "1234",
			"agt_iata": "111111B"
		},
		"commtag": "c25a104aa5ea14562b160b828f3d43ba723f80f4f67fc22817d185b6c02b199f"
	}
}
Datos de la respuesta:
La respuesta del servicio será devueltan en formato array/objeto JSON (application/json)
 
campotipodescripción
appVersionstringNúmero de versión de la API
statusbooleanoestado de la respuesta al request, toma los valores "true/false" siendo "true" una respuesta normal positiva y "false" un error o fallo.
brandstringDevuelve la marca con la que se esta trabajando.
environmentstringEntorno en el que se esta trabajando: TEST (QA) o Producción (Production)
request_timeStringdía y hora de realización del request (estándar ISO 8601 - YYYY-MM-DDThh:mm:ss / GMT -3)
commission_responseObjetoEngloba la respuesta del servicio
commission_infoObjetoEngloba la info de porcentaje y tarifa
rate_codestring código de la tarifa
country_codestring código de pais de la tarifa (código de 2 carácteres - ISO 3166)
commPPDnúmeronúmero indicando el porcentaje de comisión sobre la tarifa prepaga
commPODnúmeronúmero indicando el porcentaje de comisión sobre la tarifa pago en destino
requestorObjetoEngloba info sobre el solicitante de la información
agt_idnúmeroID de Agente asignado por el departamento comercial y administrativo
agt_iataalfanuméricocódigo IATA del agente solicitante
commtagalfanúmericocódigo interno de verificación, se puede utilizar para revisar problemas de información con una solicitud en particular.
Errores de solicitud
respuesta HTTP: 400 Bad Request
Si se encuentra algún tipo de error en la solicitud (parámetros / headers / expiración del token de acceso) recibirá un error similar al siguiente: 
 
{
	"appVersion": "2.8",
	"status": false,
	"brand": "AVIS",
	"environment": "QA",
	"request_time": "2023-05-07T12:37:02",
	"error": "Parameters error",
	"error_description": "faltan parámetros en su consulta o los mismos están vacíos",
	"commission_response": "null"
}
respuesta HTTP: 404 Not Found
Si no se encontrase la tarifa / país / porcentaje de comisión recibirá un error similar a este: 

{
	"appVersion": "2.8",
	"status": false,
	"brand": "AVIS",
	"environment": "QA",
	"request_time": "2023-05-07T12:38:53",
	"error": "commission not found",
	"error_description": "Agent 1234 - No se han encontrado datos de comisión para esta tarifa o el código de tarifa es incorrecto para el país solicitado, verifique los datos o contacte al Departamento Administrativo",
	"commission_response": "null"
}