Catálogo de errores
Todos los códigos que la API puede emitir, con su status HTTP, su semántica de reintento y qué hacer con cada uno.
Cada error llega con la misma forma, pensada para que un humano o un agente sepan qué hacer sin adivinar. Ejemplo real (falta el connectionId en una tool que lo exige):
{
"error": {
"code": "validation_error",
"message": "'sii.rcv.consultar' requiere una conexión concreta.",
"suggested_fix": "Pasa el connectionId de la conexión de 'sii' (MCP: campo 'connectionId' de execute; REST: header 'X-Connect-Connection'). Lístalos con la tool 'conexiones.estado.consultar'.",
"request_id": "req_5tYw2nRk88Ma"
},
"meta": {
"request_id": "req_5tYw2nRk88Ma",
"tool_id": "sii.rcv.consultar",
"plane": "action",
"latency_ms": 12,
"audit_status": "recorded"
}
}Reglas de manejo:
- Decide por
code, nunca por el texto:messagepuede cambiar, los códigos no. suggested_fixestá escrito para ejecutarse: si tu agente recibe el error crudo, ya sabe el paso siguiente.request_idcorrelaciona con la fila de la bitácora y es lo primero que pedirá soporte. Guárdalo en tus logs.- Reintenta solo lo reintentable (columna de cada tabla). En una acción destructiva, manda una clave de idempotencia desde el primer intento (
Idempotency-Keyen REST,idempotencyKeyen MCP) y repite la misma al reintentar: sin ella, cada reintento es una operación nueva, y reintentar a ciegas una acción regulada es la receta del doble pago.
Honorarios
| Código | HTTP | Reintentable | Qué significa | Qué hacer |
|---|---|---|---|---|
honorarios_request_not_found | 404 | no | La solicitud de honorarios no está disponible para este actor. | Verifica el identificador y usa la identidad que creó la solicitud. |
honorarios_beta_disabled | 403 | no | La modalidad de honorarios no está habilitada para esta organización. | Solicita la habilitación de la beta antes de crear una solicitud. |
honorarios_policy_denied | 403 | no | Los datos exceden los límites habilitados para honorarios. | Revisa el emisor, receptor, fecha y monto contra la política de tu organización. |
honorarios_duplicate_reference | 409 | no | La referencia ya pertenece a otra solicitud del mismo emisor. | Consulta la solicitud original; no cambies la referencia para repetir una emisión incierta. |
honorarios_annulment_conflict | 409 | no | La boleta tiene una solicitud de anulación que impide esta operación. | Consulta la solicitud existente. No vuelvas a enviarla ni cambies la clave de idempotencia para repetir la anulación. |
Carpeta tributaria puntual
| Código | HTTP | Reintentable | Qué significa | Qué hacer |
|---|---|---|---|---|
collection_not_found | 404 | no | La solicitud o el documento no están disponibles. | Verifica el identificador y la retención con la organización solicitante. |
collection_not_enabled | 403 | no | La obtención puntual no está habilitada. | Solicita la habilitación del piloto. |
collection_configuration_missing | 428 | no | Falta configurar el destinatario o la entrega. | Completa la configuración de la organización antes de crear el enlace. |
collection_scope_forbidden | 403 | no | La solicitud no autoriza esta operación. | Usa únicamente las operaciones de esta solicitud. |
collection_expired | 410 | no | La autorización temporal venció. | Crea una nueva solicitud con autorización del cliente. |
collection_inconclusive | 409 | no | No se pudo confirmar la emisión o completar la entrega de la carpeta. | Revisa el historial; no repitas la emisión automáticamente. |
collection_identity_mismatch | 409 | no | El contribuyente no coincide con la solicitud. | Verifica el RUT esperado y el acceso autorizado. |
collection_document_invalid | 422 | no | El documento no superó la validación. | Revisa el original sin generar otra carpeta. |
collection_document_too_large | 413 | no | El documento supera el límite permitido. | Solicita revisión de la carpeta emitida. |
collection_cleanup_pending | 503 | no | El cierre del acceso está pendiente. | Espera la finalización de la limpieza; no vuelvas a emitir. |
Petición
| Código | HTTP | Reintentable | Qué significa | Qué hacer |
|---|---|---|---|---|
validation_error | 400 | no | El input no cumple el esquema de la tool. | Revisa error.details: viene el detalle campo a campo. Corrige el input y reenvía. |
malformed_request | 400 | no | El cuerpo no es JSON válido. | Verifica la serialización y el Content-Type antes de reenviar. |
unsupported_media_type | 415 | no | El Content-Type no es application/json. | Envía el cuerpo con el header Content-Type: application/json. |
payload_too_large | 413 | no | El cuerpo supera el límite de 256 KB. | Reduce el payload; si es una lista, pagina con cursor. |
idempotency_key_missing | 400 | no | La operación exige una Idempotency-Key explícita generada por quien llama. | Genera un UUID v4, envíalo como Idempotency-Key y reutilízalo solo para reintentos de esta misma operación. |
idempotency_conflict | 409 | no | Esa Idempotency-Key ya se usó con un cuerpo distinto. | Genera una clave nueva para una operación nueva; reutiliza la clave solo para reintentar la misma. |
idempotency_in_progress | 409 | sí | Otro intento con esa misma Idempotency-Key todavía está corriendo. | Espera unos segundos y reintenta con la MISMA clave. Generar una nueva para la misma operación es lo que duplica el efecto. |
tool_not_found | 404 | no | Ese id de tool no existe para tu organización. | Confirma el id con conexiones.sistemas.listar o search_docs. También cubre conectores que tu organización no tiene habilitados. |
Autenticación y permisos
| Código | HTTP | Reintentable | Qué significa | Qué hacer |
|---|---|---|---|---|
unauthorized | 401 | no | Falta el bearer o el token no es válido. | Envía Authorization: Bearer connect_sk_… con una API key vigente. Si usas OAuth, renueva el access token. |
forbidden | 403 | no | La identidad autenticó pero no tiene permiso para esta operación. | Confirma el rol y la organización de la credencial que estás usando. |
scope_not_granted | 403 | no | La API key no tiene el scope que la tool exige. | Crea o edita la key en /api-keys con el scope requerido. Recuerda: scopes vacíos significan cero autoridad, no comodín. |
Conexiones y sincronización
| Código | HTTP | Reintentable | Qué significa | Qué hacer |
|---|---|---|---|---|
connection_ambiguous | 409 | no | Hay más de una conexión de ese sistema y la llamada no dijo cuál. | Indica la conexión: header X-Connect-Connection en REST o campo connectionId en MCP. |
connection_busy | 409 | sí | La conexión está en uso o el servicio alcanzó temporalmente su capacidad. | Espera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez. |
connection_disabled | 403 | no | La conexión existe pero está deshabilitada. | Reactívala en /connections o usa otra conexión del mismo sistema. |
connection_not_found | 404 | no | El connectionId indicado no corresponde a ninguna conexión de ese sistema que la credencial pueda usar. | Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada. |
connection_scope_not_enabled | 403 | no | El actor sí tiene el scope que la tool exige, pero la conexión elegida no lo tiene habilitado. | Pide a un owner/admin que habilite el scope en /connections para esa conexión, o usa otra que ya lo tenga activo. Cambiar la credencial del actor no resuelve este error. |
connection_credential_required | 428 | no | La conexión no tiene una credencial viva: nunca se vinculó, venció o fue revocada. | Crea un enlace con conexiones.enlace.crear (modo reconectar si la conexión ya existe) y pide a la persona que entregue la credencial de nuevo. No reintentes con la credencial anterior. |
connection_identity_mismatch | 409 | no | La respuesta del sistema externo no corresponde a la identidad de esta conexión, o no trajo la prueba de identidad que Emisso exige. | No reintentes: la respuesta es determinista. Si el RUT de empresa de la conexión es el correcto, vincula una credencial habilitada en esa empresa. Si el RUT quedó mal al crearla, borra la conexión y créala de nuevo: el RUT de empresa no se puede cambiar. |
connected_account_required | 428 | no | La tool exige una cuenta conectada del usuario y no existe. | Completa el flujo de autorización que indica el challenge de la respuesta. |
connection_session_pending | 409 | sí | El acceso a ese sistema todavía no está listo y esta llamada no puede prepararlo. | Ejecuta la sincronización de esa conexión o espera la programada, y reintenta. |
connection_sync_in_progress | 409 | sí | Ya corre una sincronización de esa conexión para ese período. | Espera a que termine y reintenta, o consulta directamente: puede que ya haya datos. |
connector_onboarding_required | 428 | no | El sistema externo exige completar su configuración antes de operar. En Notta, por ejemplo, el certificado digital y los folios. | Lee el mensaje: dice qué falta. Se completa en el portal de ese sistema, no en Emisso, y después la llamada funciona sin cambios. |
too_many_pending | 429 | sí | La cola de sincronizaciones pendientes de la conexión está llena. | Deja terminar los trabajos en curso antes de encolar más. |
sync_job_not_found | 404 | no | Ese id de trabajo de sincronización no existe en tu organización. | Usa los job_ids que devolvió el POST que encoló el trabajo. |
previred_documento_not_found | 404 | no | Esta conexión no tiene guardado ese documento de Previred, o todavía no se ha descargado. | Busca el identificador en la consulta correspondiente y confirma que su campo de disponibilidad venga en true. Si viene en false, el próximo sync lo descarga. |
alcance_not_enabled | 403 | no | La conexión no tiene habilitado el módulo de datos que la tool pide. | Habilita el alcance en /connections o quítalo del input de la sincronización. |
alcance_scheme_unsupported | 422 | no | El módulo de datos pedido no está disponible con el tipo de acceso de esta conexión. | Crea otra conexión del mismo sistema con el acceso que trae ese módulo: el suggested_fix lo nombra y la guía del sistema lo indica. El acceso de una conexión no cambia. Si no necesitas el módulo, quítalo del input de la sincronización. |
connector_variant_unsupported | 422 | no | Ese sistema sirve este dato en variantes, y la de tu conexión todavía no la lee Emisso. El mensaje dice cuál es. | No hay nada que arreglar de tu lado ni en el portal de ese sistema: la credencial y los permisos están bien. Escríbenos para que te avisemos cuando la cubramos. |
requiere_clave_de_persona | 409 | no | La conexión entra con la clave tributaria de la empresa, y el SII solo deja emitir a una persona que la represente. | Crea una conexión nueva con credential_scheme portal_credentials_representante y emitir true. El acceso de una conexión no cambia. |
emision_ya_activa | 409 | no | La conexión ya emite en el SII. | Emite con esta misma conexión. No hace falta pedir otro enlace. |
emision_no_activa | 409 | no | La conexión todavía no emite en el SII, así que no tiene una clave del certificado que cambiar. | Pide un enlace con mode activar_emision: también pide la clave del certificado y deja la conexión emitiendo. |
Límites y plan
| Código | HTTP | Reintentable | Qué significa | Qué hacer |
|---|---|---|---|---|
rate_limited | 429 | sí | Superaste un límite de tasa. | Espera y reintenta con backoff exponencial. |
quota_exceeded | 429 | no | Esta conexión alcanzó su cupo de llamadas del período. Tus demás conexiones siguen funcionando. | Espera el período siguiente o pide una ampliación. Subir de plan no cambia el cupo, y reintentar tampoco. |
feature_not_in_plan | 403 | no | Esa función no está incluida en tu plan. | Revisa /billing para habilitarla. |
billing_past_due | 402 | no | La organización tiene un pago pendiente y sus conexiones están en pausa: no sincronizan ni responden consultas. Lo ya sincronizado queda guardado. | Pídele a la persona que pague en https://connect.emisso.ai/billing. Reintentar no cambia nada. |
subscription_required | 402 | no | La organización no tiene una suscripción o una prueba vigente. Las conexiones que requieren esa cobertura están en pausa. | Revisa las condiciones para continuar en https://connect.emisso.ai/billing. Si tu cuenta está en beta, contacta a Emisso desde esa página. Reintentar no cambia la vigencia de la cuenta. |
connector_plan_limit | 402 | no | Se agotó la cuota del plan que tu organización tiene EN ESE SISTEMA. No es un límite de Emisso. | Sube el plan en el portal de ese sistema. El mensaje trae el enlace. |
Sistema externo
| Código | HTTP | Reintentable | Qué significa | Qué hacer |
|---|---|---|---|---|
sii_maximo_sesiones | 409 | no | El SII indica que hay demasiadas sesiones abiertas con este RUT. | Cierra tus sesiones en sii.cl o espera unos minutos y vuelve a intentar. No cambies la clave. |
upstream_error | 502 | sí | El sistema externo (SII, banco) falló o respondió mal. | Reintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración. |
upstream_unexpected_response | 502 | no | El sistema externo respondió con una forma que Emisso no reconoce. | No reintentes: la respuesta es determinista. Repórtalo con el request_id para que actualicemos el conector. |
external_resource_not_found | 404 | no | El recurso pedido no existe en el sistema externo o la cuenta conectada no tiene acceso a él. | Verifica el identificador con la tool de búsqueda del mismo sistema. Reintentar con el mismo identificador da el mismo resultado. |
timeout | 504 | sí | La operación superó su tiempo máximo, casi siempre esperando al sistema externo. | Reintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo. |
Webhooks
| Código | HTTP | Reintentable | Qué significa | Qué hacer |
|---|---|---|---|---|
webhook_endpoint_not_found | 404 | no | Ese endpoint de webhook no existe en tu organización. | Lista tus endpoints con GET /v1/webhooks y usa un id vigente. |
webhook_delivery_not_found | 404 | no | Esa entrega de webhook no existe para ese endpoint. | Lista las entregas con GET /v1/webhooks/{id}/deliveries y usa un id vigente. |
invalid_webhook_url | 422 | no | La URL del webhook no es válida para recibir entregas. | Usa una URL https pública. Direcciones internas o no resolubles se rechazan. |
Internos de Emisso
| Código | HTTP | Reintentable | Qué significa | Qué hacer |
|---|---|---|---|---|
service_unavailable | 503 | sí | Emisso no pudo atender la petición por una falla transitoria propia. | Reintenta con backoff. No es un problema de tu petición ni de tu key. |
output_contract_error | 500 | no | El resultado interno no cumplió el contrato de salida de la tool. | Es un defecto de Emisso. Repórtalo con el request_id. |
handler_error | 500 | no | La tool falló de forma no clasificada. | Repórtalo con el request_id si persiste. No reintentes a ciegas. |
internal_error | 500 | no | Error interno no clasificado de Emisso. | Repórtalo con el request_id. No reintentes a ciegas. |
not_implemented | 501 | no | La operación existe en el contrato pero aún no está implementada. | Consulta el changelog o espera su disponibilidad. |
Facturador Gratuito SII
| Código | HTTP | Reintentable | Qué significa | Qué hacer |
|---|---|---|---|---|
sii_facturador_not_enabled | 428 | no | La conexión no tiene habilitado el Facturador Gratuito del SII. | Pide a un owner o admin que habilite el facturador para esta conexión antes de volver a intentarlo. |
sii_dte_variant_not_enabled | 422 | no | La variante o versión de contrato DTE no está habilitada en las capabilities de esta conexión. | Elige una variante y versión actualmente habilitadas, o pide a un owner o admin que revise las capabilities. |
sii_dte_validation_failed | 422 | no | El candidato o sus totales no cumplen el contrato del DTE antes de cualquier red destructiva. | Corrige los campos indicados en details y genera una previsualización nueva. |
sii_facturador_contract_changed | 502 | no | El formulario o la transición del SII ya no coincide con el contrato reconocido por Emisso. | No reintentes ni habilites emisión. Repórtalo con el request_id para revisar el conector y su kill switch. |
sii_facturador_not_enrolled | 422 | no | La empresa no aparece en el Facturador Gratuito del SII con esta clave: factura con otro sistema, todavía no activó este, o esta persona no la representa ahí. | Desde esta conexión sólo se leen datos. Si la empresa pasa al Facturador Gratuito, o conectas con una clave que sí la represente ahí, vuelve a intentarlo desde el detalle de la conexión: no hace falta crear otra. |
sii_dte_type_not_authorized | 422 | no | El SII no autoriza a la persona de esta conexión a emitir ese tipo de documento en esta empresa. | Emite uno de los tipos de 'tiposDte.autorizados' en conexiones.estado.consultar. Si la empresa le da esa autorización en el SII, vuelve a comprobarlo desde el panel «Emisión en el SII» de la conexión. |
sii_preview_token_invalid | 400 | no | El token de previsualización no corresponde a esta operación o no supera sus verificaciones. | Comprueba que el previewRef llegue completo y sin recortes: mide cientos o miles de caracteres. Si llegó completo, genera una previsualización nueva desde la misma organización, conexión y actor; no reutilices este token. |
sii_preview_token_expired | 410 | no | El token de previsualización venció y ya no autoriza continuar. | Genera una previsualización nueva y usa su token antes de que expire. |
sii_anulacion_documento_no_encontrado | 404 | no | Ese documento no está entre los que se pueden anular por esta vía: la factura no está en los emitidos del Facturador Gratuito del SII, o la boleta no la emitió Emisso en esta conexión. | Revisa tipo, folio y fecha. Sólo se anulan facturas emitidas con el Facturador Gratuito y boletas emitidas por Emisso en la misma conexión: un documento emitido con otro proveedor no aparece. |
sii_anulacion_en_curso | 409 | no | Ya hay una anulación preparada y sin resolver para ese mismo documento. | Termina o deja vencer la anulación en curso antes de preparar otra sobre el mismo documento. |
sii_anulacion_ya_emitida | 409 | no | Ese documento ya tiene una nota de crédito de anulación emitida por Emisso. | No la anules de nuevo: la nota ya está en el SII. Revísala en el libro de emisión. |
sii_anulacion_no_admitida | 422 | no | El Facturador Gratuito del SII no admite esta nota de crédito tal como está el documento. | Lee el motivo en details. Si es una corrección cuyo total supera el de la factura (correccion_supera_factura), revisa las líneas. Un total de boleta que no se puede escribir como neto más IVA redondeado, o un receptor que el SII no habilita o del que no tiene razón social, dirección y giro, no se resuelve por esta vía: anula el documento en el portal del SII. |
sii_emision_igual_en_curso | 409 | no | Hace pocos minutos se emitió un documento igual en esta conexión y el SII todavía no confirma si lo recibió. Emitirlo ahora podría duplicarlo. | Espera hasta la hora de 'reintentarDesde' en details y vuelve a llamar a sii.dte.emitir; si la vista previa venció, genera una nueva. Antes, puedes consultar la emisión anterior con el 'operacionId' de details: si se confirma emitida, no emitas de nuevo. |
sii_emision_igual_ya_emitida | 409 | no | Un documento igual ya se emitió en esta conexión: quedó sin respuesta del SII y después se confirmó emitido. | No lo emitas de nuevo: sería un duplicado. Consulta el documento con el 'operacionId' de details. Si de verdad necesitas otro documento igual, cambia algún dato que los distinga, como la descripción de un ítem. |
sii_preview_changed | 409 | no | La previsualización fresca ya no coincide con la que quedó ligada al token. | Genera y revisa una previsualización nueva. No emitas usando el token anterior. |
sii_emitter_profile_required | 428 | no | La conexión todavía no tiene configuradas la actividad y la dirección del emisor. | Pide a un owner o admin que configure el perfil emisor antes de crear otra previsualización. |
sii_emitter_profile_changed | 409 | no | Los datos del emisor guardados ya no coinciden con los que la empresa tiene hoy en el SII; por ejemplo, cambió su dirección o sumó un giro. | Pide a un owner o admin que abra Ajustes de la conexión, pulse «Cambiar giro o dirección» y elija los vigentes; después genera una previsualización nueva. Este paso no se puede hacer por API. |
sii_preparation_confirmation_required | 428 | no | La preparación todavía no está confirmada, y esta llamada no puede confirmarla sola: eso solo ocurre cuando la emisión la pide una clave de API. | Pide a un owner o admin que revise y confirme esta preparación en Emisso. Conserva el mismo previewRef y la misma Idempotency-Key para continuar. |
sii_signing_material_required | 428 | no | La conexión no tiene material de firma centralizado configurado. | Pide a un owner o admin que configure el certificado antes de intentar una emisión. |
sii_signing_material_invalid | 422 | no | El certificado o su credencial de firma fueron rechazados, sin invalidar el acceso de lectura al SII. | Corrige o reemplaza el material de firma. Si cambió la clave del certificado (por ejemplo, al renovarlo), pídele la nueva a la empresa con un enlace en modo cambiar_clave_certificado. No necesitas volver a vincular el acceso de lectura si sigue vigente. |
sii_emission_rejected | 422 | no | La emisión fue rechazada antes de quedar como resultado terminal serializado. | Revisa la clasificación segura, corrige el documento y genera una previsualización nueva. No reintentes la misma emisión a ciegas. |
sii_emission_outcome_unknown | 500 | no | La operación cruzó una barrera externa, pero Emisso no pudo serializar un resultado concluyente. | No reintentes ni generes otra Idempotency-Key. Repórtalo con el request_id para reconciliar la operación comprometida. |
sii_emission_not_found | 404 | no | No hay un documento emitido por Emisso con ese operacionId en esta conexión. | Usa el operacionId que devolvió la emisión, con la misma conexión. Si la emisión quedó en resultado desconocido, espera a que se reconcilie. |
Motivos de un fallo
Cuando falla un sistema conectado, el motivo precisa el código: dice qué pasó y quién tiene que actuar. En un error, message trae el texto del motivo; en una sincronización, cada alcance fallido trae outcomes[].motivo en GET /v1/syncs/{id}. La lista es cerrada. Decide igual por code: el motivo sirve para explicarle el fallo a la persona. Dos motivos no acompañan un fallo: sin_empresas_inscritas y empresa_no_listada llegan en un alcance ok sin registros, con completo: false, cuando la clave entra pero el sistema todavía no muestra la empresa. La conexión no se pausa, se revisa una vez al día y trae los datos sola cuando la empresa aparece. movimientos_por_confirmar acompaña movimientos pendientes: Banco de Chile queda partial, con completo: false, si dejó fuera provisorios sin hora; sólo se incorporan si el banco los vuelve a informar con hora mientras el período se siga leyendo. BICE queda ok y conserva las versiones guardadas hasta confirmarlas con la cartola al cierre del mes.
| Motivo | Qué significa | Qué hacer |
|---|---|---|
historial_en_carga | El historial anterior todavía se está cargando. Los datos ya guardados están disponibles. | Se sigue cargando solo en las próximas sincronizaciones. Revisa desde cuándo hay datos antes de calcular totales históricos. |
historial_sin_avance | Esta sincronización no avanzó en el historial anterior que falta cargar. | La próxima sincronización lo vuelve a intentar. Si se repite, contacta a soporte con el request_id. |
sin_datos_periodo | Previred todavía no entrega el archivo del F30-1 de este período; suele aparecer cuando la planilla está pagada. | Se reintenta en la próxima sincronización. Los datos ya guardados se conservan. |
estados_cuenta_no_disponibles | El banco no entrega los estados de cuenta de una o más tarjetas. Los datos ya guardados se conservan. | Consulta con tu ejecutivo de Banco de Chile. Las compras no facturadas del mes actual se cargan cuando el banco las entrega. |
sin_mipyme | El SII no tiene información de esta empresa en MiPyme, su sistema gratuito de facturas, guías y notas. | Si emites solo boletas o con otro sistema, consulta tus ventas y compras en el RCV. Este alcance no aplica y no requiere cambiar la autorización. |
portal_itau_empresas | Itaú indica que tu usuario entra por el portal Empresas. | En Conexiones, elige Itaú Empresas para conectar esta empresa. |
portal_itau_corporate | Itaú indica que tu usuario entra por el portal Corporate. | En Conexiones, elige Itaú Corporate para conectar esta empresa. |
portal_bci_express | Este usuario de BCI entra a BCI Express, el portal de empresas, y no a BCI 360. | Prueba conectando BCI con la opción BCI PyME y los mismos datos. Si funciona, puedes eliminar esta conexión. |
portal_bci_360 | Este usuario de BCI entra a BCI 360 y no a BCI Express, el portal de la opción BCI PyME. | Conecta BCI con la opción BCI 360 y los mismos datos. Si funciona, puedes eliminar esta conexión. |
credencial_rechazada | El sistema no aceptó el RUT o la clave, o rechazó el permiso entregado. | Revisa que el RUT y la clave sean los que usas en el sistema y actualízalos en la conexión. No repitas el intento si no estás seguro. |
persona_no_autorizada | Tu usuario no está autorizado para esta empresa en el sistema. | Pide al representante legal que te autorice en el sistema, o conecta con la clave tributaria de la empresa. |
falta_autorizacion_reportes | Falta autorizar los reportes de este alcance. | Autoriza los reportes en Ajustes de la conexión. |
ingreso_sin_confirmar | No pudimos confirmar el ingreso al sistema. Lo estamos revisando. | No hace falta que cambies la clave. |
clave_bloqueada | La clave está bloqueada o vencida, o el sistema exige cambiarla. | Resuélvelo en el portal del sistema y después actualiza la credencial en la conexión. |
accion_en_el_portal | El sistema pide un paso que solo puede completar la persona dueña del acceso, como confirmar un dispositivo, verificar su identidad o aceptar un aviso. | Entra al portal con ese acceso, completa el paso y vuelve a sincronizar. |
empresa_no_coincide | El sistema no reconoce esta empresa para tu usuario. | Si el RUT está bien, conecta con un usuario que la administre. Si quedó mal, elimina la conexión y créala de nuevo. |
sin_empresas_inscritas | Este usuario todavía no tiene empresas inscritas en el sistema. | Empezaremos a traer datos cuando aparezca la empresa, por ejemplo al declarar su primera cotización. |
empresa_no_listada | La empresa indicada no aparece entre las empresas de este usuario en el sistema. Puede que la administre otro usuario o que todavía no esté inscrita. | Si la administra otro usuario, conecta con esa clave. |
movimientos_por_confirmar | El banco informó movimientos provisorios o versiones con datos distintos de los ya guardados. Quedan pendientes de confirmar y se conservan los guardados. | Revisa el detalle del módulo para saber qué quedó pendiente y cómo puede confirmarse. |
nominas_por_pagar | Previred sólo entregó las nóminas por pagar. La información de nóminas quedó incompleta y se conservan los datos anteriores. | Emisso volverá a revisarlas en la próxima sincronización. No necesitas cambiar la clave. |
sin_permiso | El acceso entró, pero no tiene permiso para este producto o módulo. | Pide al administrador del sistema que habilite ese permiso para el usuario. |
sii_maximo_sesiones | El SII indica que hay demasiadas sesiones abiertas con este RUT. | Cierra tus sesiones en sii.cl o espera unos minutos y vuelve a intentar. No cambies la clave. |
sesion_ocupada | Otra sesión del mismo usuario estaba abierta en el sistema. | Cierra la sesión en el portal o espera unos minutos; la sincronización programada lo vuelve a intentar. |
sesion_pendiente | La conexión no tiene una sesión activa con el sistema, o la sesión se cerró antes de terminar. | La próxima sincronización la abre de nuevo. Si necesitas los datos antes, ejecuta la sincronización de la conexión. |
acceso_no_disponible | El sistema no permitió el acceso en este momento. Esto no indica que la clave sea incorrecta. | No cambies la clave: la sincronización programada lo vuelve a intentar. |
sistema_no_disponible | El sistema no respondió o está en mantención. | La sincronización programada lo vuelve a intentar. |
tiempo_agotado | La operación no alcanzó a terminar en el tiempo disponible. | La próxima sincronización continúa con lo que faltó. |
respuesta_inesperada | El sistema respondió en un formato que no reconocemos, y esa respuesta no se guardó. | No reintentes en seguida. Si se repite, contacta a soporte con el request_id. |
documento_no_disponible | El sistema no tiene disponible ese documento, archivo o registro. | Revisa que exista en el sistema de origen o vuelve a intentarlo más tarde. |
periodo_no_disponible | El sistema no entrega datos para ese período. | Pide un período dentro de lo que el sistema conserva. |
limite_excedido | El resultado supera el tamaño o la cantidad que se procesa en una sola operación. | Acota la consulta, por ejemplo con un período o un filtro más corto. |
funcion_no_habilitada | Esta función no está habilitada para la organización o la conexión. | Solicita la habilitación a soporte. |
resultado_por_confirmar | No se pudo confirmar si la operación se completó en el sistema. | No la repitas. Revisa el resultado en el sistema de origen o contacta a soporte con el request_id. |
error_interno | Ocurrió un error en Emisso. | Contacta a soporte con el request_id. |