RCV y F29
Sincroniza el registro de compras y ventas del SII y obtén tu declaración mensual de IVA propuesta, lista para verificar antes de presentar.
Qué es el RCV
El Registro de Compras y Ventas es la nómina oficial del SII con todos los DTEs que tu empresa recibió (compras → crédito IVA) y emitió (ventas → débito IVA) en un período. Notta lo sincroniza desde el SII usando tu clave tributaria — custodiada cifrada, se carga durante el onboarding — y lo guarda como snapshot consultable por período. El SII actualiza el RCV con un delay de 24-48 horas; si los datos se ven viejos, fuerza un sync con force: true.
Qué es el F29
El Formulario 29 es la Declaración Mensual de IVA. Notta calcula el F29 propuesto del período a partir de los snapshots RCV:
| Línea | Cálculo |
|---|---|
| Débito fiscal | Suma del IVA de las ventas afectas del período (las exentas 34/41 no aportan) |
| Crédito fiscal | Suma del IVA de las compras afectas |
| Retenciones | Retenciones de BHE percibidas en el período |
| Neto a pagar (Línea 89) | max(0, débito − crédito − retenciones) |
| Crédito remanente (Línea 77) | El excedente, cuando el saldo queda a tu favor |
El F29 de Notta es read-only: lo verificas contra la propuesta del SII y presentas la declaración en el portal del SII.
Endpoints y tools
| Canal | Operación | Para qué |
|---|---|---|
| API | POST /api/v1/rcv | Sincroniza el snapshot de un período — body { rut, periodo, type?, force? } |
| API | GET /api/v1/rcv?periodo=YYYY-MM | Lista los snapshots del período (filtros rut y type, orden sort/dir) |
| MCP | notta_rcv_list · notta_rcv_refresh | Las mismas dos operaciones, para tu agente |
| MCP | notta_f29_get · notta_f29_recompute | F29 propuesto del período + recomputo desde el RCV |
type acepta received, issued o both (default both). Sync de ejemplo:
La respuesta es { "snapshot_id": "…", "from_cache": false }. El detalle se lee después con GET /api/v1/rcv?periodo=2026-04&rut=76123456-0, que incluye el parsed_json con las filas del registro.
Estado actual
El sync y la consulta del RCV (/api/v1/rcv) funcionan hoy con tu API key. El motor de cálculo del F29 está implementado, pero su endpoint público todavía no está montado en /api/v1, y las tools MCP de RCV/F29 responden con datos de ejemplo mientras se cablean al motor real. La presentación del F29 al SII es manual en esta etapa.
Próximos pasos
- Referencia de la API — el resto de los endpoints de
/api/v1con sus shapes. - BHE — las boletas de honorarios cuyas retenciones alimentan el F29.
- Notta para agentes — opera el RCV y el resto del flujo desde un LLM.
- Pasa a producción — el camino para que estos números tengan valor tributario real.
Última actualización