Documentación de los Servicios Web
Zoom International Services C.A.

RIF J-00102174-4


Zoom ofrece servicios web en formato json con el motivo de extender la funcionalidad a sus clientes, proveemos un API de conexión de ejemplo realizado en PHP y Javascript (jquery) para así conectarse a los procesos que faciliten la integración entre distintas empresas. A continuación se describen los principales servicios de nuestro API, asi como algunos ejemplos.

Requisitos


Servicios

getLastTracking
Definición: Retorna el último estatus de un envío, según un código de referencia o número de guía asociado a un determinado cliente,es decir, retorna el último estatus en toda la trayectoria del envío desde que es procesado hasta que es entregado. ver ejemplo
Parámetros de Entrada:
Atributos de salida:
Ejemplo de respuesta:[{"referencia":"HG4567HSD3","receptor":"ROSABIN","codigo_cliente":"1312","guia":"372623128","fecha":"23-03-2012","codigo_estatus":"7","siglas":"E","descripcion_estatus":"ENTREGADO AL DESTINO","hora":"05:41p.m.","fechapro":"2012-03-23","sello":"SIN SELLO"}]
getInfoTracking
Definición: Retorna todos los estatus de uno o varios envios, según un código de referencia o número de guia. Es similar a getLastTracking con la diferencia de retornar todos los estatus en toda la trayectoria del envio o envios asociados a una referencia. ver ejemplo
Parámetros de Entrada:
Atributos de salida:
Ejemplo de respuesta:[{"referencia":"HG4567HSD3","receptor":"ROSABIN","codigo_cliente":"1312","guia":"372623128","fecha":"23-03-2012","codigo_estatus":"7","siglas":"E","descripcion_estatus":"ENTREGADO AL DESTINO","hora":"05:41p.m.","fechapro":"2012-03-23","sello":"SIN SELLO"},{"referencia":"HG4567HSD3","receptor":"","codigo_cliente":"1312","guia":"372623128","fecha":"23-03-2012","codigo_estatus":"12","siglas":"OD","descripcion_estatus":"AFUERA PARA ENTREGA","hora":"","fechapro":"2012-03-23","sello":""},{"referencia":"HG4567HSD3","receptor":"","codigo_cliente":"1312","guia":"372623128","fecha":"23-03-2012","codigo_estatus":"1","siglas":"PR","descripcion_estatus":"ENVIO PROCESADO","hora":"","fechapro":"2012-03-23","sello":""}]
getTipoTarifa
Definición: Devuelve los tipos de tarifa con su código respectivo para ser llamado en el WebService de Cálculo de Tarifas. La respuesta viene dada en pares "codigo_tarifa":"nombre_tarifa"
Parámetros de Entrada: ninguno.
Ejemplo de respuesta: {"1":"COD (Cobro en Destino)","2":"Envios Nacionales"}
getModalidadTarifa
Definición: Devuelve los tipos de modalidad para el calculo de tarifa con su codigo respectivo para ser llamado en el Web Service del Cálculo de Tarifas. La respuesta viene dada en pares "codigo":"nombre"
Parámetros de Entrada: ninguno.
Ejemplo de respuesta: {"1":"RETIRAR POR OFICINA","2":"PUERTA A PUERTA"}
getCiudades
Definición: Devuelve la lista de ciudades según el servicio que se esté utilizando.
Parámetros de Entrada:
Atributos de salida:
Ejemplo de respuesta: {"codciudad":"25","nombre_ciudad":"ACARIGUA","nombre_estado":"PORTUGUESA"},{"codciudad":"24","nombre_ciudad":"ANACO","nombre_estado":"ANZOATEGUI"},{"codciudad":"68","nombre_ciudad":"BARCELONA","nombre_estado":"ANZOATEGUI"},{"codciudad":"33","nombre_ciudad":"BARINAS","nombre_estado":"BARINAS"},{"codciudad":"44","nombre_ciudad":"BARQUISIMETO","nombre_estado":"LARA"},{"codciudad":"29","nombre_ciudad":"CABIMAS","nombre_estado":"ZULIA"}
getMunicipios
Definición: Permite obtener información del Municipio o los Municipios de una Ciudad.
Parámetros de Entrada:
Atributos de salida:
Ejemplo de respuesta: [{"codigo_municipio":"515 ","nombre_municipio":"URDANETA"}]
getParroquias
Definición: Permite obtener información de la Parroquia o las Parroquias de una Ciudad con su respectivo Código Postal.
Parámetros de Entrada:
Atributos de salida:
Ejemplo de respuesta: [{"codigo_parroquia":"51501 ","nombre_parroquia":"CAPITAL URDANETA","codigo_postal":"2301"},{"codigo_parroquia":"51502 ","nombre_parroquia":"NO URBANA LAS PENITAS","codigo_postal":"2334"},{"codigo_parroquia":"51503 ","nombre_parroquia":"NO URBANA SAN FRANCISCO DE CARA","codigo_postal":"2334"},{"codigo_parroquia":"51504 ","nombre_parroquia":"NO URBANA TAGUAY","codigo_postal":"2334"}]
getOficinas
Definición: Devuelve la lista de oficinas destino de una ciudad y Tipo de Tarifa especificado. La respuesta viene en dada en pares de valores, "codigo_oficina : nombre_oficina"
Parámetros de Entrada:
Ejemplo de respuesta: {"1171":"INVERSIONES RIO BLANCO, C.A.","308":"LA BOUTIQUE DEL CELULAR YARITAGUA, C.A.","612":"ZOOM AEROPUERTO JACINTO LARA","15":"ZOOM BARQUISIMETO","873":"ZOOM CABUDARE","950":"ZOOM CARORA","1025":"ZOOM CDO BRM"}
getOficinasGE
Definición: Devuelve la lista de oficinas destino pertencientes a una ciudad. La respuesta varía según la opciónes modalidad_tarifa y tipo_tarifa.
Parámetros de Entrada:
Atributos de salida:
Ejemplo de respuesta:[{"codoficina":"47","nombre":"ZOOM BELLO CAMPO","direccion":"FINAL AV. PRINCIPAL DE BELLO CAMPO, QTA GRUPO ZOOM. URB. BELLO CAMPO, (FRENTE A FRIOCAR). CHACAO."},{"codoficina":"539","nombre":"ZOOM C.C. GALERIAS EL PARAISO","direccion":"AV. JOSE ANTONIO PAEZ CENTRO COMERCIAL, GALERIAS EL PARAISO, NIVEL PARAISO, LOCAL 17-A PISO P-A. URBANIZACION EL PARAISO."},{"codoficina":"48","nombre":"ZOOM CDO CATIA","direccion":"AV.PPAL DE ALTAVISTA, A 50 METROS DE LA TEXTILERIA OVEJITA, GALPON GRUPO ZOOM."},{"codoficina":"825","nombre":"ZOOM CHACAITO I","direccion":"AV. TAMANACO, CENTRO COMERCIAL ARTA, PISO 1, LOCAL 1-3. URBANIZACION EL ROSAL"},{"codoficina":"1137","nombre":"ZOOM EL JUNQUITO (INVERSIONES MAR2405)","direccion":"KM. 13, C.C. EL CASTILLO, SOTANO 1, LOCAL 43. EL JUNQUITO."},{"codoficina":"160","nombre":"ZOOM PALO VERDE (NO UTILIZAR)","direccion":"AV. PRINCIPAL DE PALO VERDE, CENTRO COMERCIAL PALO VERDE PLAZA, SEGUNDO NIVEL, LOCAL 13-B."},{"codoficina":"49","nombre":"ZOOM PLAZA VENEZUELA","direccion":"AV. LA SALLE, EDIFICIO LA SALLE, PB LOCALES PB3 Y PB4, PLAZA VENEZUELA."},{"codoficina":"50","nombre":"ZOOM SAN MARTIN","direccion":"AV. SAN MARTIN ENTRE LA 2DA Y 3ERA CALLE LOS MOLINOS URB. LOS MOLINOS, EDIFICIO KOMPLOT, PB (FTE. AL BANCO PROVINCIAL)."},{"codoficina":"433","nombre":"ZOOM TAQUILLA LA URBINA","direccion":"CALLE 7. SECTOR SUR. EDIF. GRUPO ZOOM. URB. LA URBINA."},{"codoficina":"885","nombre":"ZOOM TELARES LOS ANDES","direccion":"AV. PPAL DEL CEMENTERIO, CIUDAD COMERCIAL TELARES LOS ANDES, SECTOR VERDE, LOCAL 24."}]
CalcularTarifa
Definición: Proceso para calcular tarifas según tipo de tarifa, tipo de servicio,ciudades y valor.ver ejemplo
Parámetros de Entrada:
Atributos de salida:
Ejemplo de respuesta: {"flete":"778,86","seguro":"3,90","combustible":"140,90","subtotal":"0,00","franqueo_postal":"0,00","iva":"55,42","total":"979,08"}
getEstatus
Definición: Permite obtener información de los estatus relacionados a los envíos
Parámetros de Entrada:
Atributos de salida:
Ejemplo de respuesta: [ {"codestatus":"57","siglas":"CS","nombre":"BAJO CUSTODIA DE SEGURIDAD","color":"red","icono":"1"}, {"codestatus":"58","siglas":"CS","nombre":"BAJO CUSTODIA DE SEGURIDAD","color":"red","icono":"1"}, {"codestatus":"102","siglas":"BAG","nombre":"CIERRE DE VALIJA","color":"Yellow","icono":"2"}, {"codestatus":"108","siglas":"FR","nombre":"ELABORANDO FACTURA POR GASTOS DE NACIONALIZACION","color":"Yellow","icono":"2"}, {"codestatus":"74","siglas":"CD","nombre":"DESTRUCCION AUTORIZADA POR CLIENTE","color":"Blue","icono":"3"}, {"codestatus":"86","siglas":"DT","nombre":"COMUNIQUESE CON EL 0800-SOS-ZOOM","color":"Blue","icono":"3"} {"codestatus":"7","siglas":"E","nombre":"ENTREGADO","color":"Blue","icono":"3"} ]
getEstados
Definición: Permite obtener información de los estados Nacionales e Internacionales en donde ZOOM presta sus servicios. Funciona como complemento para el uso del WebService getCiudadesOfi
Parámetros de Entrada:
Atributos de salida:
Ejemplo de respuesta: [{"codestado":"17","nombre":"AMAZONAS"},{"codestado":"18","nombre":"ANZOATEGUI"},{"codestado":"19","nombre":"APURE"},{"codestado":"20","nombre":"ARAGUA"},{"codestado":"21","nombre":"BARINAS"},{"codestado":"22","nombre":"BOLIVAR"},{"codestado":"23","nombre":"CARABOBO"},{"codestado":"24","nombre":"COJEDES"},{"codestado":"26","nombre":"DELTA AMACURO"},{"codestado":"37","nombre":"DEPENDENCIAS FEDERALES"},{"codestado":"2","nombre":"DISTRITO CAPITAL"},{"codestado":"3","nombre":"FALCON"},{"codestado":"27","nombre":"FLORIDA"},{"codestado":"4","nombre":"GUARICO"},{"codestado":"6","nombre":"LARA"},{"codestado":"7","nombre":"MERIDA"},{"codestado":"8","nombre":"MIRANDA"},{"codestado":"9","nombre":"MONAGAS"},{"codestado":"10","nombre":"NUEVA ESPARTA"},{"codestado":"11","nombre":"PORTUGUESA"},{"codestado":"12","nombre":"SUCRE"},{"codestado":"13","nombre":"TACHIRA"},{"codestado":"14","nombre":"TRUJILLO"},{"codestado":"25","nombre":"VARGAS"},{"codestado":"15","nombre":"YARACUY"},{"codestado":"16","nombre":"ZULIA"}]
getCiudadesOfi
Definición: Permite obtener información de las Ciudades Nacionales e Internacionales en donde ZOOM presta sus servicios. Funciona como complemento para el WebService getSucursales
Parámetros de Entrada:
Atributos de salida:
Ejemplo de respuesta: [{"codciudad":"3","nombre":"MARACAY"},{"codciudad":"86","nombre":"CAGUA"},{"codciudad":"244","nombre":"LA VICTORIA"},{"codciudad":"404","nombre":"TURMERO"}]
getSucursales
Definición: Permite obtener información de las Sucursales Nacionales e Internacionales (Oficinas y Aliados ZOOM). ver ejemplo
Parámetros de Entrada:
Atributos de salida:
Ejemplo de respuesta: [{"codoficina":"765","nombre":"ZOOM LA VICTORIA","direccion":"CALLE RIVAS DAVILA, C.C. VICTORIA CENTER, PRIMERA ETAPA, NIVEL PLANTA BAJA, LOCAL A-6","latitud":"0.000000","longitud":"0.000000","telefonos":"0-800-SOS-ZOOM (0-800-767-79666)","horarios":[{"dia":"Jueves","hora":"08:00 AM - 12:00 PM - 02:00 PM - 06:00 PM"},{"dia":"Viernes","hora":"08:00 AM - 12:00 PM - 02:00 PM - 06:00 PM"},{"dia":"Sabado","hora":"08:00 AM - 05:00 PM"}],"servicios":[{"codservicio":"1","nombre":"Envíos"},{"codservicio":"2","nombre":"Publicación"},{"codservicio":"3","nombre":"Casilleros"},{"codservicio":"4","nombre":"Western Union"},{"codservicio":"5","nombre":"Recepción"}],"cod":"f","retirarofi":"Retirar por Oficina"},{"codoficina":"389","nombre":"CENTRO CANTV. (LA VICTORIA)","direccion":"AV. VICTORIA. EDIF. MESCHIARI. P.B. LOCAL 1. SECTOR SOCO. URB. BOLIVAR SUR.","latitud":null,"longitud":null,"telefonos":"0-800-SOS-ZOOM (0-800-767-79666)","horarios":"NULL","servicios":[{"codservicio":"1","nombre":"Envíos"},{"codservicio":"2","nombre":"Publicación"},{"codservicio":"3","nombre":"Casilleros"},{"codservicio":"5","nombre":"Recepción"}],"cod":"f","retirarofi":"f"}]
getTipoEnvio
Definición: Retorna los Tipos de Envíos permitidos en Zoom International Services, C.A.
Parámetros de Entrada:
Atributos de salida:
Ejemplo de respuesta:{"D":"DOCUMENTO","M":"MERCANCIA"}
getPaises
Definición: Retorna los Códigos de Países a los que Zoom International Services, C.A. realiza envíos.
Parámetros de Entrada:
Atributos de salida:
Ejemplo de respuesta:[{"codpais":"83","nombre_pais":"AFGANISTAN"},{"codpais":"141","nombre_pais":"ALBANIA"},{"codpais":"39","nombre_pais":"ALEMANIA"},{"codpais":"142","nombre_pais":"ALGERIA"},{"codpais":"180","nombre_pais":"AMERICAN SAMOA"},{"codpais":"143","nombre_pais":"ANDORRA"},{"codpais":"144","nombre_pais":"ANGOLA"},{"codpais":"145","nombre_pais":"ANGUILA"},{"codpais":"4","nombre_pais":"ANTIGUA"},{"codpais":"80","nombre_pais":"ARABIA SAUDI"}]
getTipoRutaEnvio
Definición: Retorna el Tipo de Ruta de un envío de acuerdo a una ciudad origen y una ciudad destino.
Parámetros de Entrada:
Atributos de salida:
Ejemplo de respuesta:["1"]

Ejemplos

 

 

Ir al cielo