Catálogo de errores
166 códigos que pueden responder la API /v1 y el servidor MCP, cada uno con su estado HTTP, qué significa y qué hacer.
Toda negativa es application/problem+json con un code estable. Cada código de abajo tiene su propio enlace: el código X_CASE_RADICADO_TAKEN está en #x-case-radicado-taken, en minúsculas y con guiones.
Cómo leer una negativa, y cuándo reintentar: Errores y códigos · Reintentos idempotentes · Volver a la referencia de la API
| Código | HTTP | Qué significa | Qué hacer |
|---|---|---|---|
X_ADDRESS_BLOCKED | 422 | La dirección de correo no puede recibir la notificación: está mal escrita, es desechable o su dominio no recibe correo. | Corrija la dirección o use otra que la persona utilice; el panel muestra el diagnóstico al agregar el destinatario. |
X_AGENT_TOKEN_SCOPE_BEYOND_ROLE | 403 | Se pidió un permiso (scope) que el rol de quien emite el token no tiene; un token nunca puede más que su emisor. | Pida solo los scopes de su rol (la página /cuenta/api los lista), o que un propietario de la firma emita el token. |
X_AGENT_TOKEN_WRONG_ENDPOINT | 403 | Se presentó un token de otra población a este endpoint: un token de firma abre /mcp y /v1, uno de afiliado /mcp/afiliados y /v1/afiliados, uno del equipo /mcp/admin. | Use el endpoint que nombra el mensaje, o emita un token de la población correcta (/cuenta/api para la firma, /afiliados para afiliados). |
X_API_ACCESS_PLAN_REQUIRED | 403 | El plan de la firma no incluye acceso por API y MCP: viene con Firma Pro (y con un contrato de Cobranza), nunca con la prueba, los paquetes de créditos, Abogado ni Firma. | Un propietario cambia de plan en /facturacion. El mismo token vuelve a funcionar de inmediato; no hay que emitir otro. |
X_ATTACHMENTS_TOO_LARGE | 413 | Los adjuntos de la notificación suman más de 6 MB. | Quite o comprima un adjunto para que el total no pase de 6 MB, o reparta los documentos en más de una notificación. |
X_ATTACHMENT_DUPLICATE | 409 | Ese mismo documento (el mismo SHA-256) ya está adjunto a la notificación. | No hace falta adjuntarlo de nuevo; puede continuar. |
X_AUTH_ACCOUNT_REQUIRED | 409 | Esta acción necesita una contraseña en la cuenta, y la cuenta todavía no tiene una (por ejemplo, entró solo con Google). | Defina una contraseña en /cuenta/seguridad y repita. |
X_AUTH_CONFIRM_BROWSER_INVALID | 401 | El enlace de confirmación se abrió en un navegador distinto del que creó la cuenta, o la marca de ese navegador venció. | Abra el enlace en el navegador donde se registró, o confirme escribiendo la contraseña que eligió al registrarse. |
X_AUTH_CONFIRM_PASSWORD_INVALID | 401 | La contraseña no coincide con la que se eligió al registrar la cuenta; el enlace de confirmación sigue sin usar. | Escriba la contraseña del registro, o continúe sin ella: esa contraseña se elimina y podrá definir otra en /cuenta/seguridad. |
X_AUTH_CURRENT_PASSWORD_INVALID | 403 | La contraseña actual no es correcta. | Escriba la contraseña con la que inicia sesión y repita; varios intentos fallidos bloquean la cuenta un tiempo. |
X_AUTH_EMAIL_CHANGE_INVALID | 401 | El enlace para cambiar el correo no es válido, ya se usó o venció. | Pida el cambio de nuevo desde /cuenta/correo. |
X_AUTH_EMAIL_UNCHANGED | 422 | El correo nuevo es el mismo que ya tiene la cuenta. | Escriba una dirección distinta en `newEmail`. |
X_AUTH_REAUTH_UNAVAILABLE | 409 | La cuenta no tiene cómo confirmar su identidad de nuevo: ni contraseña ni aplicación autenticadora. | Defina una contraseña o active la verificación en dos pasos en /cuenta/seguridad y repita. |
X_AUTH_RECENT_AUTH_REQUIRED | 403 | Esta acción pide confirmar su identidad otra vez: el código de la aplicación autenticadora o la contraseña. | Repita enviando `code` (o `password` si no tiene verificación en dos pasos). Un token no puede hacer esta acción: hágala desde el panel. |
X_AUTH_SIGN_IN_PENDING_INVALID | 401 | El paso de ingreso que pide el código venció o ya se usó. | Ingrese otra vez con su correo y contraseña; la página del código vuelve a abrirse por 15 minutos. |
X_BODY_INVALID | 422 | El cuerpo de la petición no es JSON válido, o supera el tamaño que acepta la API (1 MB). | Envíe un objeto JSON con `content-type: application/json`. Los archivos nunca van en el cuerpo: use requestUpload. |
X_CALENDAR_MISSING_YEAR | 503 | El calendario de festivos aún no tiene el año que necesita el cálculo del plazo. | Reintente en unos minutos: el año faltante se carga solo. Si persiste, escriba a admin@notificado.co. |
X_CALENDAR_YEAR_OUT_OF_RANGE | 422 | El año pedido está fuera del rango que cubre el calendario de festivos. | Use una fecha dentro del rango que indica el mensaje. |
X_CAPTCHA_FAILED | 403 | El proveedor del captcha no aceptó el token: vencido, ya usado o de otro sitio. | Resuelva el captcha de nuevo y reintente con el token nuevo; cada token sirve una sola vez. |
X_CAPTCHA_REQUIRED | 400 | La consulta anónima llegó sin el token del captcha, y el captcha está activo. | Resuelva el captcha en /verificar y envíe su token, o consulte con un token de API: una llamada autenticada no lo pide. |
X_CAPTCHA_UNAVAILABLE | 503 | No se pudo consultar al proveedor del captcha, así que la consulta anónima no se hizo. | Reintente en unos minutos, o consulte con un token de API. El paquete de evidencia se verifica sin conexión con OpenSSL. |
X_CASE_ARCHIVED | 409 | El proceso está archivado: no admite notificaciones, cambios ni partes nuevas. | Reábralo con unarchiveCase; sus notificaciones y su evidencia se conservaron. |
X_CASE_IN_FLIGHT | 409 | El proceso tiene una notificación en curso y todavía no se puede archivar. | Envíe o descarte esa notificación (`meta.notificationId`) y repita. |
X_CASE_LOCKED | 409 | El proceso ya no se puede editar: una de sus notificaciones salió de borrador y sus datos son evidencia. | Cree un proceso nuevo para los datos corregidos; la notificación enviada conserva los datos con que se envió. |
X_CASE_NOT_FOUND | 404 | No existe ese proceso en su firma. | Use un `caseId` que devuelva caseList para la misma firma. |
X_CASE_RADICADO_INVALID | 422 | El radicado no es un número de 23 dígitos válido (código DANE, año de radicación, consecutivo). | Copie el radicado del auto o de consultaprocesos.ramajudicial.gov.co; se aceptan guiones y espacios. |
X_CASE_RADICADO_TAKEN | 409 | Su firma ya tiene un proceso con ese radicado. | Use el proceso existente (su id viene en el mensaje) en lugar de crear otro. |
X_CONSTANCIA_NOT_FOUND | 404 | Aún no hay constancia para esa notificación (o no existe esa versión). | La constancia se emite cuando llegan los eventos de entrega; consulte getNotification y reintente después. |
X_CONSTANCIA_NOT_READY | 409 | La notificación todavía no se puede sellar: no se ha enviado o falta un hecho que la constancia imprime. | Espere a que el envío termine y consulte de nuevo; no hace falta hacer nada más. |
X_CORREO_BLANK | 422 | El correo tiene el asunto o el mensaje vacío. | Escriba un asunto y un mensaje, y repita. |
X_CORREO_MERGE_FIELD | 422 | Un correo no puede usar campos de un proceso, como {radicado}: no tiene proceso. | Quite el campo del asunto o del mensaje, o envíe la notificación desde el proceso. |
X_COURT_OUTCOME_ATTACHMENT_INVALID | 422 | El `attachmentUploadId` no es un documento confirmado de su firma. | Suba el auto con requestUpload, haga el PUT, llame confirmUpload y pase el id que devolvió. |
X_COURT_OUTCOME_DATE_INVALID | 422 | La fecha de la decisión (`decidedOn`) es anterior al envío o posterior a hoy (hora de Bogotá). | Envíe `decidedOn` como AAAA-MM-DD entre el día del envío y hoy. |
X_COURT_OUTCOME_NOTIFICATION_NOT_FOUND | 404 | Esa notificación no existe en su firma. | Busque el id con notificationList y repita con una notificación enviada de su firma. |
X_COURT_OUTCOME_NOT_SENT | 409 | La notificación no se ha enviado, así que ningún juzgado la ha valorado. | Reporte la decisión cuando la notificación esté enviada. |
X_COURT_OUTCOME_REASON_REQUIRED | 422 | Un rechazo o una solicitud de nulidad se reporta con el motivo del juzgado. | Repita con `reason`: lo que dice el auto o la providencia. |
X_CREDITS_INSUFFICIENT | 402 | No hay créditos suficientes para enviar a todos los destinatarios. No se envió nada. | Con `meta.mode` = `free`, escriba a admin@notificado.co; con `meta.mode` = `paid`, compre créditos en /creditos. |
X_CREDITS_LEDGER_TOO_LONG | 413 | El saldo de créditos de su firma no se pudo calcular en una sola lectura. | Escriba a admin@notificado.co con el `requestId`; no reintente. |
X_CSRF_BLOCKED | 403 | Una escritura con cookie de sesión llegó sin un `origin` del mismo sitio. | Desde un programa, autentíquese con un token (`Authorization: Bearer …`) en lugar de la cookie. |
X_CURSOR_INVALID | 400 | El cursor de paginación no es uno que esta API haya emitido, o ya no es válido. | Pida la primera página sin cursor y siga el cursor que devuelve cada respuesta. |
X_DEADLINE_CURSOR_CONFLICT | 422 | La petición de plazos trae `cursor` y `after` con posiciones distintas. | Envíe solo `cursor` (el id de la última fila de la página anterior); `after` es su nombre anterior. |
X_DOCUMENT_FILENAME_NOT_MAILABLE | 422 | El nombre del archivo no puede viajar en un encabezado de correo tal como está escrito (es muy largo o tiene caracteres que un encabezado no admite); `meta.reason` indica el límite. No se guardó nada. | Cambie el nombre del archivo dentro del límite de `meta.reason` y vuelva a subirlo. |
X_DOCUMENT_KEY_INVALID | 422 | La `key` enviada a confirmUpload no es una subida pendiente de su firma. | Pase la `key` que devolvió requestUpload, después de que el PUT a su `url` haya respondido bien. |
X_DOWNLOAD_CROSS_SITE | 403 | La descarga fue solicitada por una página que no es la página de descarga de Notificado. No se registró nada. | Abra el enlace del correo de la notificación y use el botón de esa página. Un programa llama a recordDownload sin los encabezados `Origin` ni `Sec-Fetch-Site`. |
X_DRAINING | 503 | El servidor que recibió la petición se está apagando por un despliegue. | Reintente la misma petición en unos segundos; con `Idempotency-Key` el reintento es seguro. |
X_EVIDENCE_NOT_FOUND | 404 | No existe esa evidencia en su firma. | Use un id que devuelvan getNotification o las lecturas de evidencia. |
X_EVIDENCE_ZIP_FAILED | 409 | No fue posible armar el paquete de evidencia (zip) de esa versión de la constancia. La constancia en PDF sigue disponible. | Escriba a admin@notificado.co indicando la notificación y `meta.version`; el equipo lo reconstruye. |
X_EVIDENCE_ZIP_NOT_READY | 409 | El paquete de evidencia (zip) de esa constancia se está armando. | Reintente la descarga en unos 30 segundos. |
X_FORBIDDEN | 403 | Su rol no permite esta acción, o el `orgId` enviado no es el de su firma. | Use el `orgId` que devuelve whoami y un usuario con el rol necesario (por ejemplo, abogado para enviar). |
X_IDEMPOTENCY_CONFLICT | 409 | Esa `Idempotency-Key` ya se usó con otro cuerpo, o la primera petición con esa clave aún está en curso. | Use una clave nueva por cada petición distinta; si es un reintento de la misma, espere a que la primera termine y repítala igual. |
X_IDEMPOTENCY_KEY_INVALID | 400 | La cabecera `Idempotency-Key` llegó vacía o con más de 255 caracteres. | Envíe un UUID nuevo por petición (`crypto.randomUUID()`), u omita la cabecera. |
X_IDEMPOTENCY_REPLAYED_FAILURE | 500 | La primera petición con esa `Idempotency-Key` falló; esta respuesta repite ese fallo sin volver a ejecutar nada. | Lea el código original en `meta.code`, corrija la causa y reintente con una clave nueva. |
X_IMPORT_NOT_FOUND | 404 | Esa importación no existe en su firma. | Busque el id con listImports y repita con uno de su firma. |
X_IMPORT_ROW_MOVED | 409 | Otra ejecución procesó esa fila primero; los cambios de esta se deshicieron. | No hace falta hacer nada: getImport muestra lo que quedó. |
X_IMPORT_UPLOAD_KEY_INVALID | 422 | La `key` no es una subida de importación pendiente de su firma. | Llame requestImportUpload otra vez, haga el PUT y confirme con esa misma `key`. |
X_INPUT_INVALID | 400 | Un campo no cumple el esquema de la operación; `issues` nombra cada uno. | Corrija los campos que indica `issues` según la referencia de la operación y reintente. |
X_INTERNAL | 500 | Falla del servidor que no es culpa de la petición. Los detalles quedan en nuestros registros, bajo el `requestId`. | Reintente más tarde; si persiste, escriba a admin@notificado.co con el `requestId`. |
X_INVARIANT_VIOLATED | 422 | Un valor pasó el esquema pero viola una regla de los datos (por ejemplo, un identificador que no es UUID). | Revise los identificadores y valores que envía: use los que devuelven las lecturas de la API. |
X_JURAMENTO_MISMATCH | 422 | El `juramentoText` enviado no es el juramento que el servidor redacta para el correo y el nombre de este destinatario, así que no es el juramento sobre esta dirección. No se registró nada. | Envíe el texto mostrado para exactamente este correo (sin espacios, en minúsculas) y este nombre, u omita `juramentoText` para jurar el texto del servidor. |
X_JURAMENTO_REQUIRED | 422 | Falta el juramento del art. 8 de la Ley 2213: que la dirección es la que usa la persona. | Un abogado agrega y jura cada destinatario en el panel; un agente no puede jurar. |
X_KYC_CEDULA_INVALID | 422 | El número de cédula no tiene un formato válido: después de quitar puntos, espacios y guiones deben quedar entre 5 y 12 dígitos. | Escriba la cédula tal como figura en el documento; los puntos se aceptan. |
X_KYC_CHECK_IN_FLIGHT | 409 | Todavía estamos consultando el registro con los datos actuales de la verificación; un envío nuevo competiría con esa consulta. | Espere unos minutos (myKyc deja de mostrar `checking`) y envíe de nuevo solo si algo debe cambiar. |
X_KYC_POSSESSION_CODE_EXPIRED | 410 | El código enviado al correo del SIRNA venció o agotó sus intentos. | Pida uno nuevo con resendPossessionCode o en /cuenta/verificacion, y escríbalo dentro de los 15 minutos. |
X_KYC_POSSESSION_CODE_INVALID | 422 | Ese no es el código que enviamos al correo del SIRNA. | Escriba los 6 dígitos del último correo; la respuesta dice cuántos intentos quedan. |
X_KYC_POSSESSION_CODE_LIMIT | 429 | Se pidieron demasiados códigos al correo del SIRNA en la última hora. | El último código enviado sirve hasta que vence; pida otro con resendPossessionCode después de una hora. |
X_KYC_POSSESSION_NO_CHALLENGE | 409 | No hay un código pendiente: no hay verificación enviada, o el correo ya se confirmó. | Envíe la verificación en /cuenta/verificacion, o pida un código nuevo si el último venció. |
X_KYC_POSSESSION_RESEND_TOO_SOON | 429 | Acabamos de enviar un código al correo del SIRNA. | Revise la bandeja y la carpeta de correo no deseado, o pida otro después de los segundos que indica `retry-after`. |
X_KYC_POSSESSION_UNPROVEN | 409 | Falta confirmar el código enviado al correo del SIRNA que escribió el abogado. | El abogado escribe el código en /cuenta/verificacion; sin él no hay aprobación. |
X_KYC_REQUIRED | 403 | Enviar en nombre propio exige una verificación de abogado aprobada y sin envíos en pausa; vale en todas las firmas de la persona. | Complete la verificación en /cuenta/verificacion (consulta al registro y código al correo del SIRNA); mientras tanto, requestSendApproval pide que envíe un abogado verificado de la firma. whoami muestra `kycApproved`. |
X_KYC_SIRNA_CHANGE_NOT_APPROVED | 409 | Solo un abogado con la verificación aprobada puede cambiar su correo del SIRNA con changeSirnaEmail. | Si la verificación está en curso, rechazada o revocada, corrija el correo enviando de nuevo la verificación en /cuenta/verificacion. |
X_KYC_SIRNA_EMAIL_INVALID | 422 | El correo del Registro Nacional de Abogados (SIRNA) contiene caracteres que un mensaje de correo no admite (por ejemplo tildes o eñes). | Escriba el correo exactamente como figura en el SIRNA, sin tildes ni eñes. |
X_KYC_SIRNA_EMAIL_UNCHANGED | 409 | Ese correo ya es la dirección del SIRNA verificada: no hay nada que cambiar. | Envíe la dirección nueva tal como figura hoy en el SIRNA. |
X_KYC_SUBMIT_LIMIT | 429 | La verificación se envió demasiadas veces en las últimas 24 horas. | Lea con myKyc por qué espera: una persona del equipo la revisa. Si hay algo que corregir, escriba a soporte en lugar de enviar otra vez. |
X_KYC_TARJETA_INVALID | 422 | El número de tarjeta profesional no tiene un formato válido: después de quitar puntos, espacios y guiones deben quedar solo dígitos. | Escriba el número tal como figura en la tarjeta profesional. |
X_LAWYER_IDENTITY_DUPLICATE_APPROVED | 409 | Esa cédula o esa tarjeta profesional ya está aprobada en otra cuenta. | Escríbanos a soporte desde /soporte: una persona del equipo revisa cuál es la verdadera. |
X_LAWYER_IDENTITY_EXISTS | 409 | Esta cuenta ya tiene una identidad de abogado: una cuenta es una persona. | Corrija la existente desde /cuenta/verificacion en lugar de crear otra. |
X_LAWYER_IDENTITY_NOT_FOUND | 404 | No existe esa identidad de abogado. | Use el id que devuelve myKyc; si no hay ninguna, envíe la verificación en /cuenta/verificacion. |
X_LAWYER_IDENTITY_NOT_RESUBMITTABLE | 409 | La verificación está aprobada y vale en todas sus firmas: no hay nada que enviar de nuevo. | No hay nada que hacer; myKyc muestra el estado. |
X_LAWYER_IDENTITY_TRANSITION_REFUSED | 409 | Otra decisión sobre esta verificación llegó primero. | Lea el estado con myKyc y actúe sobre el estado actual. |
X_LEGAL_ACCEPTANCE_REQUIRED | 403 | Hay una versión nueva de los términos o del aviso de privacidad que el titular del token no ha aceptado. | Inicie sesión en el navegador y acepte la versión nueva en /cuenta/aceptar-terminos; el mismo token vuelve a funcionar enseguida. |
X_LINKED_FILES_DISABLED | 409 | Los archivos enlazados (archivos que no caben como adjuntos y se entregan por enlace de descarga) no están disponibles para su firma ahora. `meta.reasons` dice por qué: aún no se ofrecen, o no hay un medio de pago registrado. | Para `no_payment_method`, registre un medio de pago en /facturacion y reintente. En otro caso adjunte los archivos (attachDocument, 6 MB en total). linkedFilesAccess responde las razones. |
X_LINKED_FILE_ALREADY_ATTACHED | 409 | El archivo enlazado ya está en otra notificación (`meta.notificationId`). Un archivo enlazado pertenece a una sola notificación, porque una vez enviado es evidencia de esa notificación. | Si esa notificación sigue en borrador, retírelo allí con detachAttachment y adjúntelo de nuevo aquí. En otro caso, suba el archivo otra vez. |
X_LINKED_FILE_DOWNLOAD_STREAMED | 409 | Ese enlace de descarga es de un archivo enlazado, que se transmite directamente y nunca se devuelve por recordDownload. No se registró nada. | Haga un POST al enlace mismo (`/r/<recipientToken>/d/<linkToken>`, cuerpo vacío) y lea el cuerpo de la respuesta como el archivo; un GET solo muestra la página de descarga. |
X_LINKED_FILE_NAME_INVALID | 422 | El `filename` de un archivo enlazado es uno que tendríamos que cambiar, o que induce a error: vacío, de más de 255 caracteres, con un carácter de control o invisible, con alguno de / \ : * ? " < > |, con un punto o un espacio al inicio o al final, o con una extensión ejecutable dentro del nombre. | Cambie el nombre del archivo y envíe su nombre propio, con una sola extensión real, por ejemplo "expediente.pdf". |
X_LINKED_FILE_NOT_ATTACHABLE | 409 | El archivo enlazado no se puede adjuntar: no está en estado `clean` (`meta.status`, con `meta.reason` si no fue aceptado), o el equipo de Notificado lo bloqueó. | Mientras `status` sea `scanning`, espere a que linkedFileStatus responda `clean` y reintente. Un archivo rechazado, retirado o ya enviado debe subirse de nuevo. |
X_LINKED_FILE_NOT_DISCARDABLE | 409 | El archivo enlazado no se puede retirar: está en análisis, o se envió con una notificación y se conserva como evidencia. | Mientras `status` sea `scanning`, espere a que linkedFileStatus cambie y reintente. Un archivo enviado no se puede retirar. |
X_LINKED_FILE_NOT_FOUND | 404 | No existe ese archivo enlazado en su firma. | Use un `id` que devolvió requestLinkedUpload; linkedFileList lista los que no se han enviado. |
X_LINKED_FILE_NOT_SENDABLE | 409 | El borrador incluye un archivo enlazado que ya no se puede enviar (`meta.filename`): no está en estado `clean`, fue bloqueado o sus datos ya no existen. No se descontó ningún crédito. | Retírelo con detachAttachment (`meta.attachmentId`), suba el archivo de nuevo, adjunte el nuevo con attachLinkedFile y envíe. |
X_LINKED_FILE_QUOTA_EXCEEDED | 409 | Su firma ya tiene tantos archivos enlazados sin enviar como puede tener (30 archivos, 10 GB). | Envíe las notificaciones que los usan, o retire con discardLinkedFile los que ya no necesita. |
X_LINKED_FILE_SIZE_INVALID | 422 | El `bytes` declarado de un archivo enlazado no es un número entero entre 1 y el máximo (`meta.maxBytes`). | Envíe el tamaño exacto del archivo. Un archivo que pasa del máximo se divide antes de subirlo. |
X_LINKED_FILE_TYPE_NOT_ALLOWED | 422 | El nombre del archivo no termina en una extensión que un archivo enlazado pueda tener, o el tipo declarado la contradice. Se admiten: pdf, png, jpg, jpeg, tif, tiff, mp3, wav, m4a, ogg, oga, mp4, m4v, mov, webm, mkv, docx, xlsx, pptx, odt y zip. | Envíe un archivo cuyo nombre termine en una de las extensiones de `meta.extensions`; pase el File.type del navegador como `contentType`, u omítalo. |
X_LINKED_FILE_UPLOAD_MISSING | 409 | Se llamó a confirmLinkedUpload antes de que el archivo llegara al almacenamiento. | Haga el PUT del archivo a la `url` que devolvió requestLinkedUpload, con su `contentType` exacto, espere el 2xx y confirme de nuevo. |
X_MCP_BODY_TOO_LARGE | 413 | La llamada MCP supera el tamaño máximo de cuerpo. | Divida la llamada; los archivos se suben con requestUpload y un PUT, nunca dentro de la herramienta. |
X_MCP_RATE_LIMITED | 429 | Demasiadas llamadas MCP con este token en poco tiempo. | Espere los segundos que indica `Retry-After` y reintente. |
X_MCP_SCOPE_DENIED | Solo MCP | El token no tiene el alcance (scope) que exige esa herramienta. | Cree en /cuenta/api un token con el alcance necesario (por ejemplo `cases:write`). |
X_MEMORIAL_BLOCKED_BOUNCE | 409 | Un destinatario rebotó: esa persona no quedó notificada, y el memorial no puede decir que sí. | Resuelva el rebote en el panel (otra dirección, otro canal) antes de generar el memorial. |
X_MEMORIAL_CONSTANCIA_PENDING | 409 | La entrega ocurrió, pero la constancia que el memorial cita aún no se ha emitido. | Reintente en unos segundos, cuando getNotification muestre la constancia. |
X_MEMORIAL_NOTIFICATION_NOT_FOUND | 404 | No existe esa notificación en su firma. | Use un `notificationId` que devuelva notificationList para la misma firma. |
X_MEMORIAL_NOT_DELIVERED | 409 | La notificación no se ha enviado, o el servidor de algún destinatario aún no aceptó el mensaje. | Espere los eventos de entrega (getNotification) y genere el memorial después. |
X_MEMORIAL_NOT_FOUND | 404 | No existe ese memorial en su firma, o su generación aún no termina. | Liste los memoriales con notificationMemorials y use un id que devuelva; uno recién pedido aparece en segundos. |
X_MEMORIAL_TERM_PENDING | 409 | La entrega ocurrió, pero el plazo de algún destinatario aún no se ha calculado. | Reintente en unos segundos; listDeadlines muestra cuándo está listo. |
X_METHOD_NOT_ALLOWED | 405 | La ruta existe pero no acepta ese método HTTP. | Las acciones se llaman con POST y las consultas con GET; revise la referencia de la operación. |
X_NOTIFICATION_ATTACHMENTS_TOO_MANY | 422 | La notificación superaría el número máximo de adjuntos. | Una los anexos en un solo PDF, o envíe el resto en una segunda notificación. |
X_NOTIFICATION_ATTACHMENT_NOT_FOUND | 404 | Ese adjunto no pertenece a esa notificación de su firma. | Use un id de `attachments` en getNotification. |
X_NOTIFICATION_CASELESS | 409 | Esta acción pide una notificación enviada desde un proceso; un correo sin proceso no tiene juzgado. | Use una notificación creada en un proceso (createNotification). |
X_NOTIFICATION_DISCARD_REFUSED | 409 | Ese borrador no se puede descartar: ya tiene evidencia o espera una aprobación o una confirmación. | Lea `meta.reason`; si espera confirmación o aprobación, deje que venza o que la decidan antes de descartarlo. |
X_NOTIFICATION_DOCUMENT_NOT_FOUND | 404 | El documento no es una subida de su firma, o no es del tipo que se necesita. | Suba el archivo primero (requestUpload, PUT, confirmUpload) y pase el id que devuelve confirmUpload. |
X_NOTIFICATION_EVIDENCE_TOO_LARGE | 413 | Con esos anexos y ese número de destinatarios, el paquete de evidencia superaría el tamaño que se puede conservar y entregar. No se cobró nada. | Reduzca los destinatarios por notificación a `meta.maxRecipients` o menos (cree otra notificación para el resto), o reduzca el tamaño de los anexos. |
X_NOTIFICATION_IS_CORREO | 409 | Este borrador es un correo sin proceso; updateDraft edita borradores del art. 8. | Use updateCorreo con el asunto y el mensaje. |
X_NOTIFICATION_NOT_CORREO | 409 | Este borrador es una notificación en un proceso; updateCorreo edita solo un correo sin proceso. | Use updateDraft para un borrador del art. 8. |
X_NOTIFICATION_NOT_DRAFT | 409 | La notificación ya no es un borrador: su contenido quedó congelado como evidencia. | Cree un borrador nuevo con createNotification en lugar de editar la notificación enviada. |
X_NOTIFICATION_NOT_FOUND | 404 | No existe esa notificación en su firma. | Use un id que devuelva notificationList para la misma firma. |
X_NOTIFICATION_NOT_MAILABLE | 422 | Uno de los datos del mensaje (`meta.field`) no se puede poner en un correo tal como está escrito. No se cobró nada. | Corrija el dato indicado en `meta.field` (por ejemplo un nombre o un correo con caracteres no admitidos) y vuelva a enviar. |
X_NOTIFICATION_NOT_SCHEDULED | 409 | La notificación no está programada: ya salió, su programación se canceló o nunca se programó. | Lea su estado con getNotification. Un borrador puede enviarse o programarse de nuevo con sendNotification. |
X_NOTIFICATION_NO_ATTACHMENTS | 422 | La notificación no tiene adjuntos: una notificación del art. 8 envía la providencia misma. | Adjunte la providencia con attachDocument y luego envíe. |
X_NOTIFICATION_NO_RECIPIENTS | 422 | La notificación no tiene destinatarios. | Un abogado agrega y jura al menos un destinatario en el panel; luego envíe. |
X_NOTIFICATION_RECIPIENT_NOT_FOUND | 404 | Ese destinatario no pertenece a esa notificación de su firma. | Use un id de `recipients` en getNotification. |
X_NOTIFICATION_SCHEDULED | 409 | La notificación está programada para enviarse: lo que se confirmó es lo que saldrá, y su contenido no puede cambiar mientras espera. | Cancele la programación con cancelScheduledSend; la notificación vuelve a ser un borrador que puede editar y enviar o programar de nuevo. |
X_NOTIFICATION_TRANSITION_REFUSED | 409 | La notificación no puede pasar a ese estado desde el actual, o su estado cambió mientras tanto. | Vuelva a leerla con getNotification y actúe según su estado actual. |
X_ORG_INVITE_SECOND_FACTOR_REQUIRED | 403 | La sesión probó la contraseña pero no el código de la aplicación autenticadora; la invitación no se usó. | Termine de iniciar sesión con el código y abra el enlace de la invitación otra vez. |
X_ORG_OWNER_CHANGE_UNPROVEN | 409 | El cambio afecta a un propietario de la firma y no trae la confirmación de identidad que exige, o los roles cambiaron desde que se cargó la página. | Recargue la página de miembros y repita con el código de la aplicación autenticadora o la contraseña. |
X_ORG_SUSPENDED | 403 | Los envíos de su firma están suspendidos, por el equipo de Notificado o automáticamente tras quejas de destinatarios. | Escriba desde el correo del titular de la cuenta a la dirección que indica el mensaje para pedir una revisión. |
X_OVERLOADED | 503 | El servidor está atendiendo más peticiones de las que admite en este momento. | Reintente tras los segundos de `Retry-After`, con espera creciente. |
X_PAGE_LIMIT_INVALID | 422 | El tamaño de página pedido está fuera del rango que admite esta lista. | Pida como máximo el límite que indica la guía de Límites y siga el cursor para leer la página siguiente. |
X_PARTY_ADDRESS_NOT_FOUND | 404 | Esa dirección guardada no existe en su firma o ya se retiró. | Tome el id de partyAddresses del mismo proceso. |
X_PARTY_ADDRESS_PROVENANCE | 422 | La dirección guardada no trae una procedencia válida. | Envíe una sola de las dos: `evidenceDocumentIds` (soportes de su firma) u `overrideReason`. |
X_PARTY_NOT_FOUND | 404 | Esa parte no existe en su firma. | Tome el id de `parties` en getCase del mismo proceso. |
X_PDF_INFLATE_LIMIT | 422 | El PDF subido es una bomba de descompresión: sus flujos de objetos se expanden a más de 64 MiB, a razón de 100:1 o más. | Imprímalo a un PDF nuevo (o `gs -o nuevo.pdf -sDEVICE=pdfwrite archivo.pdf`) y suba ese archivo. |
X_PROVENANCE_REQUIRED | 422 | Falta la prueba de cómo se obtuvo la dirección, o una razón escrita de por qué no la hay. | Indique la procedencia de la dirección al agregar el destinatario en el panel. |
X_RATE_LIMITED | 429 | Superó el límite de peticiones de esta operación para su usuario o token. | Espere los segundos que indica `Retry-After` y reintente. |
X_RECIPIENT_ACK_BY_SENDER | 403 | El acuse de recibo lo hizo un miembro de la firma que envió la notificación, con sesión iniciada; solo el destinatario puede acusar recibo. | Cierre la sesión en Notificado y deje que el destinatario abra su propio enlace; el remitente sigue el estado en el detalle de la notificación. |
X_ROUTE_NOT_FOUND | 404 | No hay ninguna operación en esa ruta. | Revise la ruta y el prefijo `/v1` en la referencia de la API. |
X_SCHEDULED_DRAFT_CHANGED | 409 | A la hora programada la notificación ya no era la que se confirmó: un archivo o un destinatario cambió. | Revise el borrador con getNotification y confírmelo de nuevo con sendNotification. |
X_SCHEDULED_SENDER_NOT_MEMBER | 403 | Quien programó el envío ya no es abogado ni propietario de la cuenta, así que el envío no salió bajo su juramento. | Otro abogado o propietario de la cuenta envía el borrador con sendNotification, bajo su propio juramento por cada dirección. |
X_SCHEDULED_SEND_NOT_SCHEDULER | 403 | Solo el abogado que programó el envío puede enviarlo antes de la hora programada: el juramento de ese envío es suyo. | Cancele la programación con cancelScheduledSend y envíe la notificación usted mismo, o deje que salga a su hora. |
X_SCHEDULE_CLOSURES_TOO_MANY | 422 | Hay más cierres de despacho registrados entre hoy y la próxima apertura de los que el registro de la programación puede declarar. | Envíe la notificación ahora con when: "now", o elimine los cierres duplicados de esos días y prográmela de nuevo. |
X_SENDER_LIMIT_REACHED | 429 | Este envío superaría el límite de destinatarios por hora o por día de su firma. | Envíe más tarde (la ventana avanza), a menos destinatarios, o pida un límite mayor a la dirección del mensaje. |
X_SEND_ALREADY_CONFIRMED | 409 | Ese envío ya se confirmó y la notificación se envió una vez; no se envía de nuevo. | No hay nada que hacer: siga la notificación con getNotification. |
X_SEND_APPROVAL_NO_DECIDER | 409 | En la firma no hay, aparte de usted, un abogado o propietario verificado que pueda aprobar el envío, así que no se creó ninguna solicitud. No se envió nada y el borrador no cambió. meta.stop dice por qué: paused, verify o invite. | paused: la revisión semanal del registro pausó sus envíos; vea /cuenta/verificacion y escríbanos a soporte. verify: termine la verificación en /cuenta/verificacion y envíe el borrador usted. invite: pida al propietario de la firma que se verifique o que invite a un abogado verificado en /cuenta/miembros, y vuelva a solicitar. |
X_SEND_CONFIRMATION_EXPIRED | 410 | Nadie confirmó el envío en 24 horas; no se envió nada. | Llame de nuevo a sendNotification para un enlace nuevo, o envíe el borrador desde el panel. |
X_SEND_CONFIRMATION_NOT_FOUND | 404 | No existe esa confirmación de envío en su firma. | Abra el `confirmUrl` que entregó el agente con una sesión de la misma firma, o envíe desde el panel. |
X_SEND_CONFIRMATION_STALE | 409 | El borrador cambió después de pedir la confirmación; lo que se confirmaría no es lo que el agente pidió enviar. | Revise el borrador y envíelo desde el panel, o llame de nuevo a sendNotification. |
X_SEND_CONFIRMATION_TOKEN_REVOKED | 410 | El token que pidió este envío fue revocado; su confirmación ya no se puede usar. | Si el envío sigue siendo correcto, revise el borrador y envíelo desde el panel. |
X_SEND_SCHEDULING_OFF | 409 | Los envíos programados no están habilitados en este servicio. | Envíe la notificación ahora con when: "now", o déjela como borrador y envíela más tarde. |
X_SEND_WHEN_REQUIRED | 422 | El envío se confirmó fuera del horario de referencia y la próxima apertura está a más de 96 horas: el servicio no lo retiene por su cuenta. | Repita sendNotification indicando when: "now" para enviarla ya, o when: "next_business_open" para programarla. |
X_STORAGE_TOO_LARGE | 413 | El archivo enviado en el PUT supera el tamaño que autoriza la subida (20 MB). | Comprima o divida el documento y pida una subida nueva con requestUpload. |
X_STORAGE_TYPE_REJECTED | 415 | El tipo del archivo del PUT no es PDF, PNG ni JPEG, o no coincide con el `contentType` pedido. | Suba un PDF, PNG o JPEG con la cabecera `Content-Type` exactamente igual al `contentType` de requestUpload. |
X_STORAGE_URL_EXPIRED | 410 | La URL de subida venció (`expiresAt` ya pasó). | Pida una subida nueva con requestUpload y una `Idempotency-Key` nueva, y haga el PUT enseguida. |
X_STORAGE_URL_INVALID | 403 | La URL de subida fue alterada o no la firmó este servidor. | Use la `url` que devolvió requestUpload tal cual, sin modificar su consulta. |
X_SUBSCRIPTION_OVERAGE_CAP | 402 | Los envíos adicionales de este ciclo de su plan llegaron a su tope. | Compre créditos en /creditos o espere al siguiente ciclo. |
X_SWITCH_CHANNEL_LINKED_FILE | 409 | La notificación entregó un archivo enlazado, y un archivo enlazado nunca se vuelve a adjuntar a una notificación reemitida. No se copió ni se cobró nada. | Envíe una notificación nueva: suba de nuevo el archivo (requestLinkedUpload, PUT, confirmLinkedUpload), adjúntelo con attachLinkedFile y llame a sendNotification. |
X_TEMPLATE_ARCHIVED | 409 | La plantilla está archivada. | Restáurela desde /cuenta/plantillas o elija otra con listMessageTemplates. |
X_TEMPLATE_FIELD_UNKNOWN | 422 | La plantilla usa un campo que ningún proceso llena. | Use solo los campos de `meta` o escriba el texto directamente. |
X_TEMPLATE_NOT_FOUND | 404 | Esa plantilla no existe en su firma. | Tome el id de listMessageTemplates. |
X_TENANCY_ACTOR_ORG_REQUIRED | 403 | La llamada no está asociada a ninguna firma. | Use un token emitido por una firma en /cuenta/api, o inicie sesión en una firma. |
X_TERM_DAYS_INVALID | 422 | El término no es un número entero de días hábiles dentro del rango permitido. | Indique el término en días hábiles tal como lo dice la providencia (por ejemplo, 20 para un traslado). |
X_TIMEOUT | 504 | La operación tardó más de lo permitido y se interrumpió. | Reintente con la misma `Idempotency-Key`: si la primera se completó, recibirá su resultado sin repetirla. |
X_UNAUTHENTICATED | 401 | La petición no trae credenciales válidas: falta el token, está revocado o venció. | Envíe `Authorization: Bearer <token>` con un token vigente de /cuenta/api. |
X_WEBHOOK_ENDPOINT_LIMIT | 409 | Su firma alcanzó el máximo de destinos de webhook. | Elimine uno que ya no use con deleteWebhookEndpoint o suscriba uno existente a más eventos. |
X_WEBHOOK_ENDPOINT_NOT_FOUND | 404 | Ese destino de webhook no existe en su firma o se eliminó. | Tome el id de listWebhookEndpoints. |
X_WEBHOOK_EVENT_TYPE_UNKNOWN | 422 | Uno de los tipos de evento no existe. | Suscríbase solo a los tipos que lista `meta.known`. |
X_WEBHOOK_URL_INVALID | 422 | La URL del webhook se rechaza: no es una URL absoluta de máximo 2000 caracteres, o lleva usuario o contraseña. | Llame a createWebhookEndpoint con una URL https absoluta de máximo 2000 caracteres y sin credenciales. |
X_WEBHOOK_URL_NOT_HTTPS | 422 | La URL del webhook se rechaza: no es https. | Llame a createWebhookEndpoint con una URL https pública en el puerto 443. |
X_WEBHOOK_URL_PORT | 422 | La URL del webhook se rechaza: nombra un puerto distinto del 443, el único que sale de nuestra red. | Llame a createWebhookEndpoint con una URL https pública en el puerto 443, sin puerto en la URL. |
X_WEBHOOK_URL_PRIVATE | 422 | La URL del webhook se rechaza: su host solo resuelve dentro de una red privada, es Notificado mismo, o resuelve a una dirección privada, de loopback, de enlace local, CGNAT o no pública. | Llame a createWebhookEndpoint con una URL https pública en el puerto 443 cuyo host resuelva solo a direcciones públicas. |
X_WEBHOOK_URL_UNRESOLVABLE | 422 | La URL del webhook se rechaza: su host no resuelve en el DNS público. | Revise el nombre del host, publique su registro DNS y llame a createWebhookEndpoint con una URL https pública en el puerto 443. |