Oriens: Manual de Usuario
  • 👋Bienvenido a Oriens
  • Empieza por Aquí
    • 👩‍🔧Da de alta un operador
      • 📱Autorizar un equipo nuevo
    • 🏢Da de alta un cliente
    • 🏪Da de alta un PDI
    • ⬇️Cómo se instala la app móvil de Oriens?
    • 📋Guías Interactivas
  • Servicios
    • 💼Crea una tarea para tus trabajadores
      • 📄Cómo puedo ver los reportes en PDF?
    • 👨‍🏭Crea Servicios Masivos
    • 🛣️Crea rutas
    • 📅Programa tu Ruta
    • 🗺️Geocercas: Asignar Servicios Masivamente a un Operador
  • Monitoreo
    • 🌏Rastreo por GPS
    • 🙋‍♂️Ubicación de Operadores
  • Formas
    • 🏪Asignación por PDIs
    • ✍️Asignación por Actividad
  • Reportes y KPIs
    • 🔢Reportes en Excel
    • 📊Tablero de KPIs
  • Cargas Masivas
    • 📤Layout de Servicios
    • 🗺️Layout de PDIs
  • Catálogos Generales
    • 📂Tipo de Servicio y Actividades
  • Medidas de Seguridad
    • 📲Autorización de Equipos
    • 🔐Seguridad de Oriens
    • 👩‍🔧Usuario y Contraseña
    • 👨‍💻Control de Acceso Basado en Roles (RBAC)
    • 📂Política de Retención y Eliminación de Datos
  • Soporte Técnico
    • 📞Soporte Técnico en Oriens
    • 📱Especificaciones Técnicas
    • ⁉️Preguntas Frecuentes
  • Integraciones
    • Guía de Interfaz con Oriens
    • Web Service con Clonación
Powered by GitBook
On this page
  • Clonar un servicio con un nuevo folio, cuando este ha sido finalizado
  • Actualizar Información de un Servicio
  • Actualizar información masiva de servicios
  • Alta de Clientes
  • Alta de PDIS:
  • Alta de Servicios:

Was this helpful?

  1. Integraciones

Web Service con Clonación

Clonar un servicio con un nuevo folio, cuando este ha sido finalizado

• URL: https://oriens.com.mx/OrienServices/customer/servicios/replicateServiceById/

JSON, el usuario que se le pasa es un usuario y contraseña válidos para el portal, el servicio ID es el que se quiere replicar y la regla es que tiene que estar finalizado.

{
            "servicioId": "7",
            
            "user": {
            
                        "userName": "miUsuario",
            
                        "password": "miPswd"
            
            }
}

Actualizar Información de un Servicio

URL: https://oriens.com.mx/OrienServices/customer/servicios/updateEntityById/

{
 "servicioActual" : {
 
 "servicioId" : 0,
 
 "servicioFolioCliente" : "6789"

},

 "servicioActualizado" : {
 
 "estatusId" : 4,
 
 "servicioFechaProgramada" : "20180610",
 
 "servicioFechaFechaVencimiento" : "20180620",
 
 "servicioInstrucciones" : "<html>Pasar y cobrar $500.00</html>",
 
 "servicioFolioCliente" : "FOLIO5",
 
 "servicioOperador" : "operadorgdm3"

},

"user" : {

 "userName" : "asd",
 
 "password" : "asd"

 }

}

Respuesta:

{

 "code": "00000001"

}

Códigos de error:

00009001 - Servicio terminado

00009002 - Servicio no es unico (Folio repetido y 2 o más servicios sin terminar)

00000404 - Servicio no existe

00000001 - Actualizado con éxito

00000000 - Sin cambios

Todos los métodos esperan un archivo de texto plano en el parámetro de nombre “file” sin las comillas, con un JSON en el contenido

Actualizar información masiva de servicios

URL: https://oriens.com.mx/OrienServices/customer/servicios/updateEntityByFile/

El JSON esperado para el masivo es el siguiente:

{

"lstServicios" : [ {

  "servicioActual" : {

  "servicioFolioCliente" : "489654_20180612"

},

  "servicioActualizado" : {

  "servicioInstrucciones" : "<html>Cobrar  $10,000.00</html>",

}

},{

  "servicioActual" : {

   "servicioId" : 3030
  
},

"servicioActualizado" : {

  "estatusId" : 5,

  "servicioFechaProgramada" : "20180610",

  "servicioFechaFechaVencimiento" : "20180610",

  "servicioInstrucciones" : "<html>Pasar y cobrar $5,000.00</html>",

  "servicioFolioCliente" : "1232",

  "servicioOperador" : "miguelgdm3"

  }
  
}],

"user" : {

  "userName" : "usuarioportal",

  "password" : "usuario123"
  
  }
  
}

Como podrás ver, se espera un listado de servicios como el unitario y el objeto User pasa al global para validarlo una sola vez.

El response será un JSON con el listado de servicios y la respuesta de cada uno:

{

"lstServicios" : [ {

 "response" : {

    "message" : "489654_20180612",

    "code" : "00000001"

}

},{

  "response" : {
  
    "message" : "123456_20180612",
  
    "code" : "00000404"

  }

 }]

}

Alta de Clientes

URL: https://oriens.com.mx/OrienServices/customer/clientes/addEntity/

{

"clientes" : {

"user" : {

  "userName" : "usuarioPortal", //Deberá ser un usuario valido en el portal

  "password" : "passwordUsuarioPortal" //Contraseña del usuario del portal

},

"lstClientes" : [ {

  "clienteNombre" : "Cliente 1", //Debe ser único

  "clienteSector" : "cobranza principal", //Sector valido del catalogo de sectores del portal

  "clienteRazonSocial" : "Cliente 1 SA DE CV",

  "clienteRfc" : "SJM130802T39"

},{

  "clienteNombre" : "Cliente 2",

  "clienteSector" : "cobranza secundaria",

  "clienteRazonSocial" : "Cliente 2 SA DE CV",

  "clienteRfc" : "SJM130802T39"

  }]

 }

}

Respuesta:

{

  "lstClientes" : [ {

    "response" : {

      "message" : " Cliente 1",

      "code" : "00000001"

    }

  },{

    "response" : {

      "message" : " Cliente 2",

      "code" : "00000001"

    }

  }]

}

Alta de PDIS:

URL: https://oriens.com.mx/OrienServices/customer/pdi/addEntity

{

"pdi" : {

"lstPdi" : [ {

  "pdiNombre" : "Pdi 1",

  "pdiCalle" : "Galeana",

  "pdiNumero" : "125",

  "pdiInterior" : "PA",

  "pdiColonia" : "Zapata",

  "pdiCp" : "64390",

  "municipioNombre" : "Monterrey",

  "estadoNombre" : "Nuevo Leon",

  "pdiLatitud" : "25.7013666",

  "pdiLongitud" : "-100.372989",

  "pdiComentarios" : "comentarios adicionales",

  "pdiRegionNombre" : "Norte",

  "pdiZonaNombre" : "Norte",

  "pdiUbicacionNombre" : "Local",

  "pdiIdInterno" : "10500",

  "clienteNombre" : "Cliente 1",

  "pdiTipoNombre" : "Oficinas”
  
 },{

     "pdiNombre" : "Pdi 2",

      "pdiCalle" : "Av Fundidora",

      "pdiNumero" : "501",

      "pdiInterior" : "L-53",

      "pdiColonia" : "Obrera",

      "pdiCp" : "64010",

      "municipioNombre" : "Monterrey",

      "estadoNombre" : "Nuevo Leon",

      "pdiLatitud" : "0",

      "pdiLongitud" : "0",

      "pdiComentarios" : "local blanco",

      "pdiRegionNombre" : "Norte",

      "pdiZonaNombre" : "Norte",

      "pdiUbicacionNombre" : "Centro de convenciones Cintermex",

      "pdiIdInterno" : "803057",

      "clienteNombre" : "Cliente 1",

      "pdiTipoNombre" : "Oficinas

 } ],

    "user" : {

      "userName" : "usuarioPortal",

      "password" : "passwordUsuarioPortal"

    }

  }

}

Respuesta:

{

"lstPdi" : [ {

  "response" : {
  
    "message" : “Pdi 1",
  
    "code" : "00000001"

}

}, {

"response" : {

  "message" : "Pdi 2",

  "code" : "00000001"

  }

 } ]
 
}

Alta de Servicios:

URL: https://oriens.com.mx/OrienServices/customer/servicios/addEntity

{
"servicios" : {

 "lstServicios" : [ {

    "servicioFechaProgramada" : "20181211",
  
    "servicioInstrucciones" : "<b>Saldo al día</b><br>Cobrar $500.00",
  
    "servicioFolioCliente" : "123456",
  
    "servicioOperador" : "operador",
  
    "servicioFechaVencimiento" : "20190105",
  
    "servicioPdiNombre" : "Pdi 1",
  
    "servicioPdiIdInterno" : "",
  
    "servicioTipoNombre" : "cobranza",
  
    "servicioActividadNombre" : "en sitio",
  
    "servicioHorario" : ""

},{

  "servicioFechaProgramada" : "20181211",

  "servicioInstrucciones" : "<b>Saldo al día</b><br>Realizo un pago por $700.00<br>Cobrar $200.00",

  "servicioFolioCliente" : "123457",

  "servicioOperador" : "operador",

  "servicioFechaVencimiento" : "20190105",

  "servicioPdiNombre" : "",

  "servicioPdiIdInterno" : "803057",

  "servicioTipoNombre" : "cobranza",

  "servicioActividadNombre" : "en sitio",

  "servicioHorario" : "09:00"

}],

"user":{

  "userName" : "usuarioPortal",

  "password" : "passwordUsuarioPortal"
  
  }
  
 }
 
}

Respuesta:

{

" lstServicios" : [ {

  "response" : {

    "message" : “123456", //Se regresa el folio del cliente si proporciono uno, si no se regresa el ID del portal

    "code" : "00000001"

}

},{

"response" :{

  "message" : "123457",

  "code" : "00000001"
  
    }
    
  }]
  
}
PreviousGuía de Interfaz con Oriens

Last updated 2 months ago

Was this helpful?