Manual web service para la integración de Maestros​

Método para obtener el token de la empresa

URL:

https://empresa.tmsolutions.com.co/tmland/webservices/wstiquetes/getTokenEmpresa?empresa=empresa

TIPO: Get

PARAMETROS: “empresa” es el nombre de la empresa

RETORNO: json con el token que debe usar en el metodo de autenticacion $tokenEMpresa

Metódo Autenticación

URL:

https://empresa.tmsolutions.com.co/tmland/webservices/wstiquetes/auth?token=$tokenEMpresa &user=usuario&password=contrasena

PARAMETROS :

  • Token de la empresa: $tokenEMpresa Usuario: Dado por personal de la empresa de transporte.
  • Password: Dado por personal de de la empresa de transporte.

RETORNO: json con el token que debe usar en el header de todos los métodos.

NOTA: El token generado se debe enviar siempre en el “header” de la petición de cada método, tener en cuenta que este token tiene una vigencia de 1 hora y la aplicación debe renovar el token antes de que se venza.

Método para subir Imágenes

Todos los campos de tipo imagen de los siguientes servicios reciben la URL de la imagen en tipo Sting, si no se cuenta con un servidor público donde cargar las imágenes es posible cargarlas a la aplicación por medio de un método POST. Con el siguiente ejemplo se puede probar el cargue de la información.

<html>
<body>
<h1>Upload File with RESTFul WebService</h1>
<form action="http://empresa.tmsolutions.com.co/FileUploadServlet?token= $tokenEMpresa
&folder=otroFolder" method="post" enctype="multipart/form-data">
<p>
Choose a file : <input type="file" name="file" /></p>
<input type="submit" value="Upload" />
</form>

RETORNO: Devuelve una lista con los links a las imágenes subidas.

Método alternativo para subir imágenes Base64

También  es posible subir las imágenes con el string en base64

URL:

https://empresa.tmsolutions.com.co/tmland/webservices/maestros/cargarImagenBase64

HEADER: token $tokenEMpresa

TIPO: POST

BODY: String de la imagen en base64

Método para guardar y actualizar Terceros.

Este metodo permite guardar tanto personas naturales como personas juridicas. La informacion de personas y organizaciones se encuentran alojadas en tablas diferentes dentro de la estructura de TM Land, para definir en que tabla se guarda se verifica el campo tipodeIdentificacion, en caso de que sea ‘C’ se guarda en la tabla personas, de lo contrario se guarda en la tabla organizaciones.

URL: 

https://empresa.tmsolutions.com.co/tmland/webservices/terceros

HEADER: token $tokenEMpresa

TIPO: POST

BODY: Array con todos los objetos a guardar.

Objeto Tercero

				
					String basedeoperaciones;
String capacidaddecarga;
String capacidaddepasajeros;
String categoriaINCO;
String categoriaINVIAS;
String clasedeVehiculo;
String color;
String conductor;
String configuracion;
String contrasenaGPS;
String fechadeCompra;
String fechadevencimientoCDA;
String fechadevencimientoTarjetaOperacion;
String fechadematricula;
String iMEITMtracker;
String kmdeCompra;
String linea;
String licenciadeTransito;
String marca;
String modelo;
String modelo_reposicion;
String numeroInterno;
String numeroCDA;
String numerodeChasis;
String numerodeMotor;
String numerodetarjetodeOperacion;
String observaciones;
String odometro;
String paginawebGPS;
String pesoVacio;
String placa;
String polizaHidrocarburos;
String tieneGPS;
String propietario;
String tieneAvantel;
String tieneotrosistemaseguridad;
String tieneradio;
String refrigerado;
String registronacionaldecarga;
String registradoraActual;
String registradoraInicial;
String semiremolque;
String soat;
String sumarTiemposConGPS;
String tenedor;
String tipodecombustible;
String tipodeServicio;
String tipodeVinculacion;
String tipodeCarroceria;
String usuarioGPS;
String fechaVencimientoSOAT;
String aseguradoraSOAT;
String aseguradoraPolizaContractual;
String aseguradoraPolizaExtracontractual;
String responsabilidadCivilContractual;
String responsabilidadCivilExtraContractual;
String fechaVencimientoContractual;
String fechaVencimientoExtracontractual;
// Se agrega por ticket lWSq2gwp
String fechaExpedicionContractual;
String fechaExpedicionExtracontractual;
String intermediarioContractual;
String intermediarioExtraContractual;
String fechaVencimientoPolizaHidrocarburos;
String aseguradoraPolizaHidrocarburos;
String sede;
String canon;
String fechavencimientopolizatodoriesgo;
String aseguradorapolizatodoriesgo;
String polizatodoriesgo;
String marcademotor;
String modelodemotor;
String tipodeequipo;
String niveldeservicio;
String cilindraje;
String organismodetransito;
String fechadeingreso;
String kmInicial;
String hrInicial;
String negociacioncarga;
boolean validarCamposVacios = true;
boolean vehremolque = false;
String fotoFrontal;
String fotoTrasera;
String fotoDerecha;
String fotoIzquierda;
String fotoSoat;
String fotoTarjetaOperacion;
String fotoTarjetaPropiedad;
String fotoRevisionTecnicoMecanica;