Sincronizar conexión SUNAT
Sincroniza el catálogo de períodos y las propuestas de compras RCE o ventas RVIE mediante la API de SUNAT, usando una sola sesión. Descarga y valida la exportación completa antes de conservar un alcance. Un ticket pendiente o un archivo incompleto es un fallo, nunca cero comprobantes. No acepta propuestas, registra libros, presenta declaraciones ni emite comprobantes.
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/sunat_beta.conexion.sincronizar/execute" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Content-Type: application/json" \ -d '{ "input": { "periodo": "string", "alcances": [ "periodos" ] } }'{ "data": { "periodo": "string", "estado": "encolado", "jobId": "string", "yaEnCurso": true, "results": [ { "alcance": "periodos", "status": "ok", "recordsSynced": 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 }}Consultar propuesta de compras de SUNAT POST
Lee los comprobantes de la propuesta RCE ya sincronizada para esta conexión y período. No llama a SUNAT y no acredita un registro presentado. Lista vacía con sincronizacion null significa período no cargado, nunca cero documentos. Los importes conservan la base contable de SIRE y no se convierten a la moneda original del comprobante.
Verificar conexión SUNAT POST
Prueba el acceso guardado a la API de SUNAT. No sincroniza comprobantes ni realiza presentaciones tributarias. La sesión y su cierre pertenecen al pipeline.