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= XXXXXX
user= XXXXXX
password= XXXXXX
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.