|
Documentación de los Servicios Web para RECLAMOS 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, así como algunos ejemplos.
Requisitos
- URL de conexión. Es otorgado por Zoom International Services.
Servicios
- getTipoEnvio
- Definición: Retorna los Tipos de Envíos permitidos en Zoom International Services, C.A.
- Parámetros de Entrada:
- Atributos de salida:
- codigo_tipo_envio:nombre_tipo_envio
- Ejemplo de respuesta:{"D":"DOCUMENTO","M":"MERCANCIA"}
- getProtecMercancia
- Definición: Retorna las opciones de Protección de Mercancía permitidos en Zoom International Services, C.A.
- Parámetros de Entrada:
- Atributos de salida:
- Ejemplo de respuesta:{"1":"SI","2":"NO"}
- getTipodeReclamo
- Definición: Retorna las los estatus de tipo de reclamos permitidos en Zoom International Services, C.A.
- Parámetros de Entrada:
- Atributos de salida:
- Ejemplo de respuesta:[{"codestatus":"GEE","descripcion":"Caso Resuelto \/ No procedente"},{"codestatus":"ME","descripcion":"Envio Entregado\/ Recibido incorrectamente"},{"codestatus":"REN","descripcion":"Envio no recibido"},{"codestatus":"DM","descripcion":"Envio Recibido con Daños"},{"codestatus":"SP","descripcion":"Envio Recibido con faltante de contenido"},{"codestatus":"RCI","descripcion":"Reclamos por cobro Indebido"},{"codestatus":"POD","descripcion":"Solicitud de Prueba de Entrega de un Envio"}]
- getDescripcionReclamo
- Definición: Retorna un texto que le indica al usuario los datos que debe llenar en la Descripción del Reclamo luego de seleccionar el Tipo de Reclamo (servicio: getTipodeReclamo)
- Parámetros de Entrada:
- tiporeclamo: NOT NULL Se envía el codestatus que seleccionó el usuario del servicio getTipodeReclamo
- Atributos de salida:
- infodescripcion: Detalle de la información que debe colocar el usuario en la Descripción del Reclamo
- Ejemplo de respuesta:
Se envía como parámetro "tiporeclamo"=>"DM" y el servicio retorna:
[{"infodescripcion":"\r\n\r\n- Indique el tipo de Pieza dañada.
\r\n- Suministre la marca o modelo.
\r\n- Explique las características del embalaje al momento de la recepción del envío, describiendo si el mismo estaba en buen estado al momento de la recepción o si por lo contrario presentó signos de maltrato (Roto, deformado, etc)
\r\n- Describa el tipo de daños presentado a la mercancía (Observaciones).
\r\n- Indique el valor de la mercancía.
\r\nImportante:<\/b> No deseche el embalaje del envío ni la mercancía que presentó daños. Le estaremos contactando para solicitarle la siguiente información:
\r\n *\tFotos en las que se observe el embalaje externo del envío y daño presentado a la mercancía.
\r\n *\tCarta de reclamo
\r\n *\tFactura original de la mercancía o copia con sello húmedo
\r\n\r\n"}]
- getPrioridad
- Definición: Retorna los tipos de prioridades permitidos en Zoom International Services, C.A.
- Parámetros de Entrada:
- Atributos de salida:
- Ejemplo de respuesta:{"1":"BAJA","2":"MEDIA","3":"ALTA","4":"CRITICA"}
- getGuiawebInactiva
- Definición: Se verifica si el envío fue realizado por Guía Electrónica o no
- Parámetros de Entrada:
- tipobusqueda: Para definir si la búsqueda es por guía (1) o referencia (2) NOT NULL
- codguia: Numero de la guíaNOT NULL
- Atributos de salida:
- Respuesta de Éxito o Error: errormessage
- Ejemplo de respuesta: En el caso de los envíos que fueron realizados por guía electrónica retorna: {"errormessage":"GE"} sino {"errormessage":"NO"}
- GuardarReclamo
- Definición: Se guarda el reclamo en el sistema
- Parámetros de Entrada:
- nombrecontacto: Nombre de la persona que realiza el reclamo NOT NULL
- telefonocontacto: Número telefónico de la persona que realiza el reclamo NOT NULL
- emailcontacto: Email de la persona que realiza el reclamo NOT NULL
- codguia: Numero de la guía NOT NULL
- tipoenvio: Tipo de envío NOT NULL
- clienteenvioasegurado: Identifica si el cliente va a proteger la mercancía Solo aplica para los tipos de envios de mercancía
- montoasegurado: Monto del valor de la mercancía NOT NULL
- tiporeclamoini: Tipo de reclamo inicial NOT NULL
- prioridad: Prioridad del caso NOT NULL
- descripcionreclamo: El cliente debe realizar una descripción detallada del caso tomando como base el detalle de la descripcion del reclamo NOT NULL
- codcliente: Código de cliente del usuario que realiza el reclamo NOT NULL
- codusuario: Código del usuario que realiza el reclamo NOT NULL
- tipobusqueda: Se indica es Referencia (2) ó Guía (1) NOT NULL
- sistema: sistema desde donde se esta creando el reclamo NOT NULL (NUEVO)
- codvia: Indica desde que via fue realizado el reclamoNOT NULL (NUEVO)
- Atributos de salida:
- Respuesta de Éxito o Error: errormessage ó resultado
- Ejemplo de respuesta:
Se pasaron los siguientes valores al servicio:
("nombrecontacto"=>"CARMEN PEREZ", "telefonocontacto"=>"02126357799","emailcontacto"=>"MNETO@GRUPOZOOM.COM","codguia"=>"1000114784","tipoenvio"=>"D","clienteenvioasegurado"=>"2","montoasegurado"=>"122","tiporeclamoini"=>"SP","prioridad"=>"1","descripcionreclamo"=>"DESCRIPCION DEL RECLAMO","codcliente"=>"1","codusuario"=>"1563","tipo_busqueda"=>"1"),"llamadaExitosa", "llamadaError");
Posibles respuestas del servicio:
{"errormessage":"El envio 23444332 ya tiene asociado un reclamo identificado con el numero de caso # 605. Puede escribanos al correo de reclamos@grupozoom.com o llamar por el 0800-SOS-ZOOM para que los operadores de Atencion al Cliente les suministre mayor informacion"}
{"resultado":"Se agrego con exito el reclamo numero (3415) para en envio 1000114784. Usted recibira un correo electronico a la direccion: MNETO@GRUPOZOOM.COM. En caso de dudas puede llamar al 0800-SOS-ZOOM para que los operadores de Atencion al Cliente les suministre mayor informacion","codcaso":"2965"}
- getResumTrackingCasos
- Definición: Retorna informción de un caso en especifico
- Parámetros de Entrada:
- codCaso: Numero del Caso NOT NULL
- Atributos de salida:
- fecha_creacion: Fecha de creación del caso
- nombrecontacto: Nombre del contacto
- via: Se muestra por que vía fue realizado el reclamo: (WEB, EMAIL, EN PERSONA, ESCRITA, JABBER, TELEFONO)
- motivo: Se muestra el motivo del reclamo (Daño, Mala entrega, Retardo en entrega, Envío Involucrado En Siniestro, etc)
- codclientews: Código del cliente que realizó el reclamo
- Ejemplo de respuesta:
[{"fecha_creacion":"15-06-2015 04:26 pm","nombrecontacto":"GRUPO TERRA","via":"WEB","motivo":"Daño","codclientews":"1"}]
- getTrackingCasos
- Definición: Retorna el historial de un caso en especifico
- Parámetros de Entrada:
- codCaso: Numero del Caso NOT NULL
- Atributos de salida:
- descfase: indica la descripción de la fase
- fecha_creacionfase: fecha de la creación de la fase
- duracion: Tiempo que tiene el caso en la fase actual
- fecha_cierrefase: Fecha de cierre de la fase
- descripcion: Descripción del caso
- unidadresponsable: Departamento que está actualmente gestionando el caso
- nombre: Usuario del caso
- Ejemplo de respuesta:
[{"descfase":"A1 - Caso Abierto","fecha_creacionfase":"15-06-2015 04:26 pm","duracion":"463 dias ","fecha_cierrefase":"En espera","descripcion":"Caso creado a traves del sistema de Guía Electrónica","unidadresponsable":"ATC","nombre":"USUARIO NO CONECTADO"}]
Reporte de reclamos/quejas ó sugerencias
- getListarReclamos
- Definición: Retorna el listado de reclamos generados por el cliente
- Parámetros de Entrada:
- codtablaw: Código del cliente NOT NULL
- codusuariow: Código del usuario NOT NULL
- master: Verifica si el caso es creado por un usuario master o un subusuario del sistema de GE NOT NULL
- codguia: Numero de la guía NULL
- referencia: Numero de referencia NOT NULL
- codcaso: Numero del caso NOT NULL
- fecharecl: Fecha inicial de los casos que se están consultando NOT NULL
- clic: si el valor de este campo es igual a (2) se muestra los casos creados desde hace una semana, de lo contrario se muestran los casos de las fechas indicadas por el usuario NULL
- ver: Si se pasa como parámetro igual a true se listaran los casos creados por los subusuarios del usuario master NULL
- fecha_reclhast: Fecha fin de consulta de los casos NOT NULL
- Atributos de salida:
- codcaso: Código del Caso
- codguia: Código de la Guía.
- tiporeclamoini: Tipo de reclamo en que se encuentra el caso
- fechareclamo: fecha en que se realizo el reclamo
- faseact: Fase en la que se encuentra el caso
- referencia: Código de la referencia
- Ejemplo de respuesta:
Se envían los siguientes parámetros ("getListarReclamos", array("codtablaw"=>"1","codusuariow"=>"1563","master"=>"1","codguia"=>""," referenciaws"=>"","codcaso"=>"","fecharecl"=>"14-09-2016","clic"=>"","ver"=>"","fecha_reclhast"=>"21-09-16"), "llamadaExitosa", "llamadaError");
y el servicio retorna:
[{"codcaso":"3415","codguia":"1000114784","tiporeclamoini":"Envio Recibido con faltante de contenido","fechareclamo":"20-09-2016 12:29 pm","faseact":"A1 - Caso Abierto","referencia":"0"}]
Ejemplo
Ir al cielo