Connect
API REST

Consultar propuesta de compras de SUNAT

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.

POST
/v1/tools/sunat_beta.compras.consultar/execute

Authorization

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/sunat_beta.compras.consultar/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {      "periodo": "string"    }  }'
{  "data": {    "documentos": [      {        "origen": "propuesta",        "libro": "rvie",        "periodo": "string",        "tipoIdentificadorEmisor": "string",        "identificadorEmisor": "string",        "tipoComprobante": "string",        "serie": "string",        "numero": "string",        "fechaEmision": "2019-08-24",        "tipoIdentificadorReceptor": "string",        "identificadorReceptor": "string",        "moneda": "string",        "monedaOriginal": "string",        "baseMonetaria": "contabilidad_sire",        "tipoCambio": "string",        "total": "string",        "baseImponible": "string",        "igv": "string",        "carSunat": "string"      }    ],    "cursor": "string",    "sincronizacion": {      "sincronizadoEn": "2019-08-24T14:15:22Z",      "completo": true,      "cantidad": 0    }  },  "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  }}

Opciones del receptor en el SII POST

Devuelve lo que el Facturador Gratuito del SII muestra al escribir el RUT del receptor de una factura: razón social, giros y direcciones (sucursales incluidas), cada una con su comuna y ciudad. Úsala cuando 'sii.dte.previsualizar' responda que el receptor tiene varios giros o direcciones: elige uno de cada uno y envíalos en el receptor; la comuna y la ciudad salen de la dirección elegida. Puedes acotar las direcciones con 'comuna'. Consulta en vivo con la sesión de la conexión, no guarda nada y no emite. Requiere la emisión autorizada en la conexión.

Sincronizar conexión SUNAT POST

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.