Propósito
Puede usar el método addRecords para insertar registros en el módulo requerido de Zoho Recruit.
Nota: Utilice el método POST para pasar estos parámetros en lugar del método GET.
Solicitar URL

Formato XML:
Nota: El módulo se refiere a candidatos, vacantes, clientes, entrevistas, contactos, CustomModule1, CustomModule2, CustomModule3, CustomModule4 y CustomModule5.
Para la autenticación OAuth
Nombre del encabezado
| Valor
|
Autorización
| Zoho-oauthtoken {access_token}
|
Alcances
Para la autenticación de Authtoken
Parámetro
| Tipo de datos
| Descripción
|
authtoken *
| Cuerda
| Cadena alfanumérica cifrada para autenticar sus credenciales de Zoho.
|
alcance*
| Cuerda
| Especifique el valor como recruitapi |
Solicitar parámetros
Parámetro
| Tipo de datos
| Descripción
|
xmlData *
| XML
| Esta es una cadena XML y el formato debe ser el mismo que el de getRecords en formato XML de registros recuperados.
|
wfTrigger
| Booleano
| Establezca el valor como verdadero para activar la regla de flujo de trabajo al insertar el registro en la cuenta de Recruit. De forma predeterminada, este parámetro es falso .
|
duplicateCheck
| Entero
| Establezca el valor como "1" para verificar los registros duplicados y arroje una respuesta de error o " 2 " para verificar los registros duplicados, si existe, actualice el mismo.
|
isApproval
| Booleano
| De forma predeterminada, los registros se insertan directamente. Para mantener los registros en modo de aprobación, establezca el valor como verdadero . Puede usar este parámetro para candidatos, contactos
|
nuevo formato
| Entero
| newFormat = 1 : para excluir campos con valores "nulos" al insertar datos de su cuenta de Recruit. newFormat = 2 : Para incluir campos con valores "nulos" al insertar datos de su cuenta de Recruit. |
versión*
| Entero
| versión = 1: (Valor predeterminado) Esto obtendrá respuestas basadas en la implementación de API anterior, es decir, antes de las mejoras realizadas. versión = 2: Esto obtendrá respuestas basadas en la última implementación de API. versión = 4: Para agregar varios registros en una sola llamada al método de API y activará la funcionalidad de verificación duplicada para varios registros. |
Nota: Los parámetros marcados con * son obligatorios.
Campos de verificación duplicados
Nombre del módulo
| Campo de verificación duplicado
|
Candidatos
| Correo electrónico
|
Contactos
| Correo electrónico
|
Clientela
| nombre del cliente
|
Ofertas de trabajo
| Título de la publicación
|
Entrevistas
| Nombre de la entrevista
|
Notas adicionales
Al insertar datos en su cuenta de Zoho Recruit, se aplica la seguridad basada en roles (roles, perfiles, seguridad a nivel de campo y reglas para compartir datos).
Por lo tanto, use la ID de usuario con el rol más alto (por ejemplo, el administrador de reclutamiento) y el perfil (por ejemplo, el administrador). Además, asegúrese de que todos los campos estén habilitados en la configuración de seguridad a nivel de campo.
Al insertar datos, asegúrese de que la fecha y la hora estén en los formatos "MM / dd / aaaa" y "aaaa-MM-dd | HH: mm: ss" respectivamente.
Ejemplos
Insertar registros en Zoho Recruit desde aplicaciones de terceros
Muestra XMLDATA:
<Candidatos> <fila no = "1"> <FL val = "Fuente"> Descarga web </FL> <FL val = "Empleador actual"> Su empresa </FL> <FL val = "Nombre"> Hannah </FL> <FL val = "Apellido"> Smith </FL> <FL val = "Correo electrónico"> testing@testing.com </FL> <FL val = "Phone"> 1234567890 </FL> <FL val = "Teléfono particular"> 0987654321 </FL> <FL val = "Otro teléfono"> 1212211212 </FL> <FL val = "Fax"> 02927272626 </FL> <FL val = "Móvil"> 292827622 </ FL> </row> </ Candidates>
XMLDATA candidato de muestra:
<Candidates> <row no = "1"> <FL val = "SMOWNERID"> 2000000016714 </FL> <FL val = "Candidate Owner"> Scott@zohotest.com </FL> <FL val = "Source"> Juan </FL>
<FL val = "Empleador actual"> <! [CDATA [VS & Co]]>
</FL> <FL val = "Nombre"> Juan </FL>
<FL val = "Apellido"> Chismes </FL>
<FL val = "Teléfono"> 1234567890 </FL>
<FL val = "Candidate Status"> Calificado </FL>
<FL val = "Is Hot Candidate"> verdadero </FL>
<FL val = "Salutation"> Sr. </FL> <FL val = "Street"> Calle Uno </FL> <FL val = "City"> Chennai </FL> <FL val = "State"> Tamil Nadu </FL> <FL val = "Zip Code"> 6000001 </FL> <FL val = "Country"> India </FL> </row> </Candidates>
Ejemplo de tarea XMLDATA con búsqueda de contactos y clientes:
<Tasks> <row no = "1"> <FL val = "SMOWNERID"> 2000000016714 </FL> <FL val = "Task Owner"> Scott@zohotest.com </FL> <FL val = "Subject"> Llamada de demostración </FL> <FL val = "Due Date"> 23/11/2009 </FL> <FL val = "CONTACTID"> 2000000018443 </FL> <FL val = "SEID"> 2000022218013 </FL> <FL val = "SEMODULE"> Clientes </FL> <FL val = "Status"> En curso </FL> <FL val = "Priority"> Más alto </FL> <FL val = "Enviar correo electrónico de notificación"> false </FL> <FL val = "Description"> Descripción de muestra </FL> </row></Tasks>
Ejemplo de tarea XMLDATA con búsqueda de contactos y clientes:
<Tasks> <row no = "1"> <FL val = "SMOWNERID"> 2000000016714 </FL> <FL val = "Task Owner"> Scott@zohotest.com </FL> <FL val = "Subject"> Llamada de demostración </FL> <FL val = "Due Date"> 23/11/2009 </FL> <FL val = "CONTACTID"> 2000000018443 </FL> <FL val = "SEID"> 2000022218013 </FL> <FL val = "SEMODULE"> Cuentas </FL> <FL val = "Status"> En curso </FL> <FL val = "Priority"> Más alto </FL> <FL val = "Enviar correo electrónico de notificación"> false </FL> <FL val = "Description"> Descripción de muestra </FL> </row></Tasks>
Insertar notas y relacionarse con el módulo principal

Formato XML:
Muestra XMLDATA:
<Notes> <row no = "1"> <FL val = "entityId"> 6000000119069 </FL> <FL val = "Note Type"> Reunión </FL> <FL val = "Type Id"> 6000000021005 </ FL> <FL val = "Note Content"> <! [CDATA [hello]]> </FL> <FL val = "Parent Module"> Candidatos </FL> </row> </Notes>
Aquí, el entityID es el ID único del registro principal (candidato, cliente, contacto, etc.)
Type Id es el ID de tipo de nota que puede obtener de la API getNoteTypes.
Asignar un propietario al registro
Al insertar un registro a través de la API, asegúrese de especificar la dirección de correo electrónico o el ID de usuario del propietario del registro. Si usa el nombre del propietario del registro, el registro se asignará a la credencial de inicio de sesión predeterminada que se usa en el token de autenticación. Si desea utilizar el ID de usuario para especificar el propietario del registro, agregue la etiqueta <FL val = "SMOWNERID"> ID de usuario </FL> a su xmlData.
Nota: En los siguientes ejemplos, reemplace los valores de 'authtoken' y 'scope' con los generados por usted.
Tareas:
<Tasks> <row no = "1"> <FL val = "Subject"> Llame </FL> <FL val = "Due Date"> 2009-04-20 </FL> <FL val = "Status"> Diferido </FL> <FL val = "CONTACTID"> 2000000017017 </FL> </row> </Tasks>
Eventos:
<Events> <row no = "1"> <FL val = "Subject"> Conferencia </FL> <FL val = "Start DateTime"> 2009-08-04 01:00:00 </FL> <FL val = "End DateTime"> 2009-08-05 01:00:00 </FL> <FL val = "Venue"> Estados Unidos </FL> <FL val = "Send Notification Email"> Verdadero </FL> < / fila> </Eventos>
Eventos con contactos y mapeo de clientes:
<Events> <row no = "1"> <FL val = "Subject"> Conferencia </FL> <FL val = "Start DateTime"> 2009-09-24 01:00:00 </FL> <FL val = "End DateTime"> 2009-09-25 01:00:00 </FL> <FL val = "Venue"> Chennai </FL> <FL val = "CONTACTID"> 2000000055003 </FL> <FL val = "SEID"> 2000000055007 </FL> <FL val = "SEMODULE"> Clientes </FL> </row> </Events>
Clientela:
<Clientes> <fila no = "1"> <FL val = "Nombre del cliente"> <! [CDATA [Cliente V3]]> </FL>
<FL val = "Cliente principal"> <! [CDATA [Cliente 2]]> </FL>
<FL val = "Industry"> Inmobiliaria </FL>
<FL val = "Fax"> 99999999 </FL>
</row> </Clientes>
Contactos:
<Contactos> <row no = "1"> <FL val = "Nombre"> Scott </FL> <FL val = "Apellido"> James </FL> <FL val = "Correo electrónico"> prueba @ prueba .com </FL> <FL val = "Departamento"> CG </FL> <FL val = "Teléfono"> 999999999 </FL> <FL val = "Fax"> 99999999 </FL> <FL val = " Móvil "> 99989989 </FL> </row> </Contacts>
Insertar llamadas con búsqueda de contactos y clientes:
<Calls> <row no = "1"> <FL val = "SMOWNERID"> 2000000018005 </FL> <FL val = "Subject"> Soporte de producto </FL> <FL val = "Call Type"> Inbound </ FL> <FL val = "Call Purpose"> Prospección </FL> <FL val = "CONTACTID"> 2000000018001 </FL> <FL val = "SEID"> 2000000018003 </FL> <FL val = "SEMODULE"> Clientes </FL> <FL val = "Call Start Time"> 2011-06-10 22:10:00 </FL> <FL val = "Call Duration"> 60:00 </FL> <FL val = " Description "> Demostración de producto requerida </FL> <FL val =" Billable "> true </FL> <FL val = "Resultado de la llamada"> Exitoso </FL> </row> </Calls>
Insertar llamadas con búsqueda de candidatos:
<Calls> <row no = "1"> <FL val = "SMOWNERID"> 2000000018005 </FL> <FL val = "Subject"> Demo </FL> <FL val = "Call Type"> Entrante </ FL > <FL val = "Call Purpose"> Prospección </FL> <FL val = "SEID"> 2000000017201 </FL> <FL val = "SEMODULE"> Candidatos </FL> <FL val = "Call Start Time" > 2011-06-10 22:10:00 </FL> <FL val = "Duración de la llamada"> 60:00 </FL> <FL val = "Description"> Llamada de demostración </FL> <FL val = " Facturable "> verdadero </FL> <FL val =" Resultado de la llamada "> Exitoso </FL> </row> </ Llamadas>
Uso de 'CDATA'
Propósito:
Considerar los caracteres especiales como texto sin formato y NO como datos XML
Datos XML de muestra
como POST:
<Contacts> <row no = "1"> <FL val = "First Name"> Amy </FL> <FL val = "Last Name"> Dawson </FL> <FL val = "Email"> testing @ testing .com </FL> <FL val = "Job Title"> Gerente </FL> <FL val = "Phone"> 1234567890 </FL> <FL val = "Mobile"> 292827622 </FL> <FL val = "Nombre de cuenta"> <! [CDATA ["A & A"]]> </FL> </row> </Contacts>
Insertar varios registros
Muestra XMLDATA:
<Candidates> <row no = "1"> <FL val = "Apellido"> prueba </FL> <FL val = "Email"> test1@test.com </FL> </row> <row no = "2"> <FL val = "Apellido"> prueba </FL> <FL val = "Email"> test2@test.com </FL> </row> <row no = "3"> <FL val = "Apellido"> prueba </FL> <FL val = "Email"> prueba3@test.com </FL> </row> <fila no = "4"> <FL val = "Apellido"> prueba </FL> <FL val = "Email"> test4@test.com </FL> </row> <row no = "5"> <FL val = "Apellido">prueba </FL> <FL val = "Email"> test5@test.com </FL> </row> <row no = "6"> <FL val = "Apellido"> prueba </FL> <FL val = "Correo electrónico"> test6@test.com </FL> </row>
<row no = "7"> <FL val = "Apellido"> prueba </FL> <FL val = "Email"> test7@test.com </FL> </row> <row no = "8" > <FL val = "Apellido"> prueba </FL> <FL val = "Correo electrónico"> test8@test.com </FL> </row> <row no = "9"> <FL val = "Last Name "> testing </FL> <FL val =" Email "> test9@test.com </FL> </row> <row no =" 10 "> <FL val =" Last Name "> testing </ FL > <FL val = "Enviar"> test10@test.com </ FL> </ row> : : : <fila no = "100"> <FL val ="Apellido "> prueba </FL> <FL val =" Correo electrónico "> test100@test.com </FL> </row> </ Candidates>
Notas:
- Al insertar varios registros con el método addRecords:
- Admitimos la verificación duplicada de varios registros en la versión 2
- Las reglas de flujo de trabajo no se activarán para registros que cumplan con los criterios
- Solo se considerarán los primeros 100 registros al insertar varios registros.
Verificación duplicada para varios registros
Propósito:
Puede utilizar addRecords para activar la función de verificación duplicada para varios registros. Tenga en cuenta que la versión = 4 es un parámetro obligatorio. Hemos introducido tres nuevos códigos que representarán el estado del resultado de la API para cada registro. Los códigos son los siguientes:
2000 = Registro agregado exitosamente 2001 = Registro actualizado exitosamente 2002 = Registro ya existente
Datos XML de muestra:
<Candidatos> <row no = "1"> <FL val = "Empleador actual"> Compañía1 </FL> <FL val = "Apellido"> Apellido1 </FL> <FL val = "Correo electrónico"> automatización @ recluta.com1 </FL> </row> <fila no = "2"> <FL val = "Empleador actual"> Compañía2 </FL> <FL val = "Apellido"> Apellido2 </FL> <FL val = "Correo electrónico"> automatización@recruit.com2 </FL> </row> </Candidates>
Respuesta de muestra
Si duplicateCheck = 1, version = 4, existen algunos registros con la dirección de correo electrónico y algunos registros no existen, la funcionalidad y la respuesta serán las siguientes:
<response uri = / recruta / private / xml / Candidates / addRecords> <result> <row no = 1> <success> <code> 2000 </code> <details> <FL val = Id> 2000000120006 </FL> < FL val = Hora de creación> 2013-02-11 17:55:04 </FL> <FL val = Hora de modificación> 2013-02-11 17:55:04 </FL> <FL val = Creado por> <! [CDATA [aghil123]]> </FL> <FL val = Modificado por>
<! [CDATA [aghil123]]> </FL> </details> </success> </row> <row no = 2> <success> <code> 2002 </code> <details> <FL val = Id > 2000000120007 </FL> <FL val = Hora de creación> 2013-02-11 17:55:04 </FL> <FL val = Modified Time> 2013-02-11 17:55:04 </FL> <FL val = Creado por> <! [CDATA [aghil123]]>
</FL> <FL val = Modificado por> <! [CDATA [aghil123]]> </FL> </details> </success> </row> </result> </response>
Si duplicateCheck = 1, version = 4, no existen registros con la dirección de correo electrónico, la funcionalidad y la respuesta serán las siguientes:
<response uri = / recruta / private / xml / Candidates / addRecords> <result> <row no = 1> <success> <code> 2000 </code> <details> <FL val = Id> 2000000120006 </FL> < FL val = Hora de creación> 2013-02-11 17:55:04 </FL> <FL val = Hora de modificación> 2013-02-11 17:55:04 </FL> <FL val = Creado por> <! [CDATA [aghil123]]> </FL> <FL val = Modificado por>
<! [CDATA [aghil123]]> </FL> </details> </success> </row> <row no = 2> <success> <code> 2000 </code> <details> <FL val = Id > 2000000120007 </FL> <FL val = Hora de creación> 2013-02-11 17:55:04 </FL> <FL val = Modified Time> 2013-02-11 17:55:04 </FL> <FL val = Creado por> <! [CDATA [aghil123]]>
</FL> <FL val = Modificado por> <! [CDATA [aghil123]]> </FL> </details> </success> </row> </result> </response>
Si duplicateCheck = 1, version = 4, existen registros con la dirección de correo electrónico, la funcionalidad y la respuesta serán las siguientes:
<response uri = "/ recruta / private / xml / Candidates / addRecords"> <result> <row no = "1"> <success> <code> 2002 </code> <details> <FL val = "Id"> 2000000120006 </FL> <FL val = "Hora de creación"> 2013-02-11 17:55:04 </FL> <FL val = "Modified Time"> 2013-02-11 17:55:04 </ FL > <FL val = "Creado por"> <! [CDATA [aghil123]]> </FL> <FL val = "Modificado por">
<! [CDATA [aghil123]]> </FL> </details> </success> </row> <row no = "2"> <success> <code> 2002 </code> <details> <FL val = "Id"> 2000000120007 </FL> <FL val = "Hora de creación"> 2013-02-11 17:55:04 </FL> <FL val = "Modified Time"> 2013-02-11 17:55 : 04 </FL> <FL val = "Creado por"> <! [CDATA [aghil123]]>
</FL> <FL val = "Modificado por"> <! [CDATA [aghil123]]> </FL> </details> </success> </row> </result> </response>
Si duplicateCheck = 2, version = 4, no existen registros con la dirección de correo electrónico, la funcionalidad y la respuesta serán las siguientes:
<response uri = "/ recruta / private / xml / Candidates / addRecords"> <result> <row no = "1"> <success> <code> 2000 </code> <details> <FL val = "Id"> 2000000120006 </FL> <FL val = "Hora de creación"> 2013-02-11 17:55:04 </FL> <FL val = "Modified Time"> 2013-02-11 17:55:04 </ FL > <FL val = "Creado por"> <! [CDATA [aghil123]]> </FL> <FL val = "Modificado por">
<! [CDATA [aghil123]]> </FL> </details> </success> </row> <row no = "2"> <success> <code> 2000 </code> <details> <FL val = "Id"> 2000000120007 </FL> <FL val = "Hora de creación"> 2013-02-11 17:55:04 </FL> <FL val = "Modified Time"> 2013-02-11 17:55 : 04 </FL> <FL val = "Creado por"> <! [CDATA [aghil123]]>
</FL> <FL val = "Modificado por"> <! [CDATA [aghil123]]> </FL> </details> </success> </row> </result> </response>
Si duplicateCheck = 2, version = 4, existen registros con la dirección de correo electrónico, la funcionalidad y la respuesta serán las siguientes:
<response uri = "/ recruta / private / xml / Candidates / addRecords"> <result> <row no = "1"> <success> <code> 2001 </code> <details> <FL val = "Id"> 2000000120006 </FL> <FL val = "Hora de creación"> 2013-02-11 17:55:04 </FL> <FL val = "Modified Time"> 2013-02-11 17:55:04 </ FL > <FL val = "Creado por"> <! [CDATA [aghil123]]> </FL> <FL val = "Modificado por">
<! [CDATA [aghil123]]> </FL> </details> </success> </row> <row no = "2"> <success> <code> 2001 </code> <details> <FL val = "Id"> 2000000120007 </FL> <FL val = "Hora de creación"> 2013-02-11 17:55:04 </FL> <FL val = "Modified Time"> 2013-02-11 17:55 : 04 </FL> <FL val = "Creado por"> <! [CDATA [aghil123]]>
</FL> <FL val = "Modificado por"> <! [CDATA [aghil123]]> </FL> </details> </success> </row> </result> </response>
Si duplicateCheck = 2, version = 4, existen algunos registros con la dirección de correo electrónico y otros no, la funcionalidad y la respuesta serán las siguientes:
<response uri = "/ recruta / private / xml / Candidates / addRecords"> <response uri = "/ recruta / private / xml / Candidates / addRecords"> <resultado> <fila no = "1"> <éxito> <código > 2001 </code> <details> <FL val = "Id"> 2000000120006 </FL> <FL val = "Hora de creación"> 2013-02-11 17:55:04 </FL> <FL val = " Hora de modificación "> 2013-02-11 17:55:04 </FL> <FL val =" Creado por "> <! [CDATA [aghil123]]> </FL>
<FL val = "Modificado por"> <! [CDATA [aghil123]]> </FL> </details> </success> </row> <row no = "2"> <success> <code> 2000 < / code> <details> <FL val = "Id"> 2000000120007 </FL> <FL val = "Hora de creación"> 2013-02-11 17:55:04 </FL> <FL val = "Hora de modificación "> 2013-02-11 17:55:04 </FL> <FL val =" Creado por ">
<! [CDATA [aghil123]]> </FL> <FL val = "Modificado por"> <! [CDATA [aghil123]]> </FL> </details> </success> </row> </ result > </response>
Si la versión = 4, algunos registros contienen errores y otros no, la funcionalidad y la respuesta serán las siguientes:
<response uri = "/ recruta / private / xml / Candidates / addRecords"> <result> <row no = "1"> <success> <code> 2001 </code> <details> <FL val = "Id"> 2000000120006 </FL> <FL val = "Hora de creación"> 2013-02-11 17:55:04 </FL> <FL val = "Modified Time"> 2013-02-11 17:55:04 </ FL > <FL val = "Creado por"> <! [CDATA [aghil123]]> </FL> <FL val = "Modificado por">
<! [CDATA [aghil123]]> </FL> </details> </success> </row> <row no = "2"> <error> <code> 4832 </code> <details> Ha proporcionado un valor incorrecto para el campo: Ingresos anuales </details> </error> </row> </result> </response>
Nota:
- La dirección de correo electrónico es el campo de verificación duplicado del módulo Candidatos. Para otros módulos, el campo de verificación duplicado varía.
- Los desarrolladores ahora pueden identificar fácilmente la identificación del registro, ya que el detalle del registro en la respuesta se proporciona de la misma manera que el usuario solicita en los datos xml.
- Debe pasar la versión = 2 en la URL del parámetro para la verificación duplicada en varios registros.