Manual web service para la generación y consultar guías de transporte por documento anexo

Método de autenticación
Tener presente que se debe tener claro a que empresa se le esta realizando la conexión y cambiar el nombre en la url
Tipo: @Get

Base URL
https://empresa.tmsolutions.com.co/tmland/webservices/wstiquetes/auth?token=XXXX&user=XXXX&password=XXXX

Los parámetros son
token= bGFmZQ==
user= 900047874
password= Apache90

Retorno: Devuelve un token en formato jwt que se debe usar como header param en el llamado de cada uno de los métodos, este token se debe validar cada 1 hora.
Nota: El header param se debe llamar “token”.

Método para validar el token
Tipo: @Get.

Base URL
https://empresa.tmsolutions.com.co/tmland/webservices/wstiquetes/validarToken?token=XXXXX

Este método recibe un token previamente generado en el método auth y válida si se puede usar para realizar llamadas
Retorno boolean true or false

Método para consultar las guías por su documento anexo
Tipo: @Get

Base URL
https://empresa.tmsolutions.com.co/tmland/webservices/carga/consultarGuiasPorDoc umentoAnexo?documento=XXXXX

Este método retorna una lista de guías que coinciden con el documento anexo ingresado y la empresa a la que pertenece el usuario usado para autenticarse.

Retorno Array de Guías con los siguientes atributos

				
					String ciudadOrigen;
String ciudadDestino;
Integer unidades;
Double pesoReal;
BigDecimal valorDeclarado;
String nomRemitente;
String dirRemitente;
String telRemitente;
String idRemitente; 
String nomDestinatario;
String dirDestinatario;
String telDestinatario;
String idDestinatario;
String documentoAnexo;
String diceContener; 
String numeroGuia; 
Date fecha;
String tipoIdRem;
String tipoIdDest;
String departamentoDestino;
String departamentoOrigen;
String urlImagenCumplido;
List<TrazabilidadWS> trazabilidad = new ArrayList<TrazabilidadWS>();

Las novedades o trazabilidad están dados por la lista TrazabilidadWS y esta definido como:

				
					Date fecha;
String sede;
String detalle;
String cuidad;
String tipo;
String cun;
String estado;
String observaciones;
Método para generar la guía de transporte

Tipo: @Post

Base URL
 https://empresa.tmsolutions.com.co/tmland/webservices/carga/ generarGuia

Body: Debe ser un objeto en formato json con los siguientes atributos.

				
					private String nmImpresionRemesa;
private String cdPoblacionOrigen;
private String cdPoblacionDestino;
private String nmPesoDeclarado;
private String nmUnidPorEmbalaje;
private String nmVolumenDeclarado;
private String vmValorDeclarado;
private String dsNombreRemitente;
private String dsDireccionRemitente;
private String dsTelefonoRemitente;
private String cdTipoDniCliente;
private String dniCliente;
private String dniDestinatario;
private String dsNombreDestinatario;
private String dsDireccionDestinatario;
private String dsTelefonoDestinatario;
private String dsDocReferencia;
private String dsDiceContener;
private String dsObservaciones;
private String nmTipoMcia;
private String cdTipoDniDestinatario;

Retorno: Código Http

				
					200 Se genera correctamente.
409 Hay un conflicto.
403 Problemas de autenticación.

Juan Pablo Garcia Echeverri
Gerente Técnico
TM Solutions S.A.S.