Cómo recuperar trabajos de escritura masiva en Zoho

Recuperar un trabajo de escritura masiva en Zoho CRM te permite comprobar el estado actual y los detalles de una operación de escritura masiva enviada previamente, utilizando su ID de trabajo único.

Por qué esto es importante

Cuando envías grandes volúmenes de registros a Zoho CRM a través de la API de escritura masiva, el trabajo se ejecuta de forma asíncrona. Necesitas una forma de consultar o inspeccionar ese trabajo más adelante para confirmar si se completó correctamente, sigue procesándose o encontró errores. Este endpoint es tu herramienta principal para esa verificación de estado, y está clasificado como una operación segura de solo lectura. ^[4]

---

Paso a paso

Paso 1. Confirma que tu token OAuth incluye el scope de CRM masivo correcto antes de realizar cualquier solicitud. El scope requerido es ZohoCRM.bulk.ALL, que otorga acceso completo a las operaciones masivas en Zoho CRM. Sin este scope, la API rechazará tu solicitud. ^[2]

Paso 2. Identifica el ID de trabajo (jid) del trabajo de escritura masiva que deseas inspeccionar. Este ID se devuelve cuando creas originalmente un trabajo de escritura masiva mediante POST /bulk/v1/write. Guarda un registro del mismo en el momento de la creación para poder referenciarlo más adelante. ^[7]

Paso 3. Envía una solicitud GET al endpoint del trabajo de escritura masiva, sustituyendo tu ID de trabajo en la ruta:

GET /bulk/v1/write/{jid}

Reemplaza {jid} con la cadena del ID de trabajo real. Esta llamada no requiere cuerpo en la solicitud — el ID de trabajo en la ruta es el único parámetro obligatorio. ^[1]

Paso 4. Si estás trabajando en Python, la llamada puede realizarse a través del wrapper del cliente CRM de la siguiente manera:

def get_bulk_write_job(self, jid: str):
    return self.c.request("GET", f"/bulk/v1/write/{jid}")

Pasa el ID de trabajo como argumento de cadena. El método emite la solicitud GET autenticada y devuelve los detalles del trabajo como un objeto de respuesta. ^[1]

Paso 5. Al invocar esto a través de una capa de herramientas de nivel superior, proporciona el ID de trabajo mediante la clave de parámetro jobid. Internamente, esto se asigna directamente a la función getbulkwritejob descrita anteriormente. ^[5]

Paso 6. Analiza la respuesta para revisar el estado actual del trabajo. La respuesta contendrá metadatos sobre la operación de escritura masiva, incluido su estado de procesamiento. Si el trabajo sigue en ejecución, repite la solicitud tras una breve pausa para consultar la finalización. ^[4]

---

Errores comunes

• Confundir los endpoints de escritura masiva y lectura masiva. El endpoint para verificar un trabajo de *lectura* masiva es GET /bulk/v1/read/{jid}, que es una operación completamente distinta. Asegúrate de usar /bulk/v1/write/{jid} al verificar un trabajo de escritura. ^[6]
• Scope ausente o incorrecto. Si tu token OAuth se generó sin ZohoCRM.bulk.ALL, la solicitud fallará con un error de autorización. Vuelve a generar tu token incluyendo el scope correcto. ^[2]
• Uso de un ID de trabajo incorrecto. El jid debe corresponder a un trabajo creado mediante POST /bulk/v1/write. Pasar el ID de un trabajo de lectura al endpoint de escritura, o viceversa, devolverá un error o un resultado inesperado. ^[6][7]

---

Qué verificar

• El scope está presente: Verifica que ZohoCRM.bulk.ALL aparezca en la lista de scopes de tu token OAuth activo antes de realizar la llamada. ^[2]
• Ruta del endpoint correcta: Confirma que la URL contiene /bulk/v1/write/ (no /read/) seguido del ID de trabajo exacto que recibiste en el momento de la creación. ^[1][6]
• Origen del ID de trabajo: Asegúrate de que el valor jid fue capturado de la respuesta original de POST /bulk/v1/write, y no de un trabajo de lectura u otra operación no relacionada. ^[7]

---

*Beam Help ofrece soporte experto independiente para Zoho — no somos el soporte oficial de Zoho. Para problemas a nivel de plataforma, consulta siempre la documentación oficial de Zoho.*