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.

POST
/v1/tools/sii.conexion.sincronizar/execute
AuthorizationBearer <token>

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

X-Connect-Connection*string

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.

Match^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  }}