Sincronizar conexión SII
Sincroniza los alcances solicitados (rcv, boletas, guias, boletas_honorarios, documentos, f29) para un período en una sola sincronización. En la prueba solo se cargan los 3 meses más recientes; los anteriores requieren un plan activo. Guías: solo los últimos 6 meses.
API key de la organización, en 'Authorization: Bearer connect_sk_…'. Es la credencial para tu backend y tus agentes propios; se crea en el dashboard con permisos explícitos y su valor completo se muestra una sola vez. Autentica como agente: la bitácora atribuye la acción a la clave, nunca a la persona que la creó.
In: header
Header Parameters
Cuál conexión (conn_…) ejecuta esta llamada. Obligatoria en todo sistema conectable y sin resolución implícita, ni siquiera cuando la organización tiene una sola conexión activa: la conexión ES la empresa, y elegir por ti una que hoy acierta mañana acierta distinto sin que nadie cambie nada. Los ids salen de la tool 'conexiones.estado.consultar'. Si falta, la respuesta es 'validation_error' y no se contacta al sistema externo.
^conn_Request Body
application/json
La entrada de la tool, envuelta en 'input'. Manda '{"input": {}}' cuando la tool no toma argumentos: el sobre es obligatorio aunque esté vacío.
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/tools/sii.conexion.sincronizar/execute" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Content-Type: application/json" \ -d '{ "input": { "periodo": "string", "alcances": [ "rcv" ] } }'{ "data": { "periodo": "string", "estado": "encolado", "jobId": "string", "yaEnCurso": true, "results": [ { "alcance": "string", "marcador": "string", "status": "ok", "detalle": "string", "recordsSynced": -9007199254740991, "incompletos": -9007199254740991, "completo": true, "reconMismatches": -9007199254740991, "dedupCollisions": -9007199254740991, "filasDescartadas": -9007199254740991, "fueraDeVentana": -9007199254740991, "diferidos": -9007199254740991, "totales": -9007199254740991, "agregadosEnDetalle": -9007199254740991, "incompletosPorMotivo": [ { "motivo": "string", "casillas": -9007199254740991 } ], "perspectivasFallidas": [ { "perspectiva": "emitidas", "code": "string", "marcador": "string" } ], "total": -9007199254740991, "ventanas": -9007199254740991, "ventanasRechazadas": -9007199254740991, "documentos": -9007199254740991, "faltantes": -9007199254740991, "sinIndice": -9007199254740991, "hashMismatches": -9007199254740991, "colisionesEntrePerspectivas": -9007199254740991, "hashMismatchesMismaPerspectiva": -9007199254740991, "verificadoAl": "string", "declaraciones": -9007199254740991, "nuevas": -9007199254740991, "pendientes": -9007199254740991, "diagnostico": { "version": 1, "tipo": "sii_f29", "pendientes": 0, "causas": { "pdf_no_disponible": 0, "contrato_parser": 0, "identidad": 0, "desconocido": 0, "presupuesto_agotado": 0 }, "guardas_contrato": { "sin_texto": 0, "encabezado": 0, "tabla_codigos": 0, "valor_ilegible": 0, "codigo_duplicado": 0, "numero_huerfano": 0, "periodo": 0, "otro": 0 }, "presupuesto": { "entrada_ms": 0, "duracion_ms": 0, "remanente_entrada_ms": 0, "remanente_salida_ms": 0, "margen_flush_ms": 0, "cortes": { "antes_periodo": 0, "detalle": 0, "antes_compacto": 0, "compacto": 0 } }, "valores_ilegibles": { "formas": [ { "codigo": "string", "modo": "entero", "zona": "tabla", "valor": { "tipo": "numero", "patron": "string", "espacios": [ { "posicion": 0, "tipo": "espacio" } ] }, "codigoRelativo": { "x": -1000, "y": -1000 }, "vecinos": [ { "forma": { "tipo": "numero", "patron": "string", "espacios": [ { "posicion": 0, "tipo": "espacio" } ] }, "x": -1000, "y": -1000 } ], "cantidad": 0 } ], "omitidas": 0 } }, "error": "string" } ] }, "meta": { "request_id": "string", "operation_request_id": "733a3a71-b72d-4633-94b1-070c6664565f", "tool_id": "string", "plane": "action", "latency_ms": 0, "audit_status": "recorded", "idempotency": "replayed" }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}Verificar acceso a carpeta tributaria POST
Verifica el acceso al portal de carpeta tributaria y la identidad de una solicitud puntual autorizada. La ejecuta Emisso durante el enlace alojado, no tu integración. Para obtener la carpeta, crea la solicitud y lee su resultado: [Carpeta tributaria puntual](https://connect.emisso.ai/docs/como-consultar/carpeta-tributaria).
Verificar conexión SII POST
Comprueba con el SII que las credenciales de la conexión funcionan. No sincroniza ni devuelve datos: solo confirma si las credenciales sirven.