How chemanc/consultarucsunat works
ConsultaRucSunat is a small Python library for looking up Peruvian taxpayer records from SUNAT. A client calls consultaRuc, which maintains a session, obtains SUNAT’s token, retrieves the RUC page, parses its taxpayer fields, requests condition history, and adds the historical record before returning the result. The README documents RUC 10 and RUC 20 parsing and additional structured fields. The source excerpts show the request and parser calls; no separate SUNAT service implementation is included.
Main entry points: consulta.py RUC lookup · clean_consulta.py Taxpayer parser · clean_consulta_historica.py History parser
Components 9
Lookup workflow
- RUC lookup
consultaRuc/consulta.py - Session init
consultaRuc/consulta.py - Token request
consultaRuc/consulta.py - RUC request
consultaRuc/consulta.py - History request
consultaRuc/consulta.py
Response parsing
- Taxpayer parser
consultaRuc/clean_consulta.py - History parser
consultaRuc/clean_consulta_historica.py
Other components
- Client app
- SUNAT portal
Connections 12
- Client app → RUC lookup: calls
README.md - RUC lookup → Session init: starts
consultaRuc/consulta.py - Session init → SUNAT portal: GET session
consultaRuc/consulta.py - RUC lookup → Token request: requests token
consultaRuc/consulta.py - Token request → SUNAT portal: POST token
consultaRuc/consulta.py - RUC lookup → RUC request: requests RUC
consultaRuc/consulta.py - RUC request → SUNAT portal: POST lookup
consultaRuc/consulta.py - RUC lookup → Taxpayer parser: parses HTML
consultaRuc/consulta.py - RUC lookup → History request: requests history
consultaRuc/consulta.py - History request → SUNAT portal: POST history
consultaRuc/consulta.py - RUC lookup → History parser: parses HTML
consultaRuc/consulta.py - RUC lookup → Client app: returns data
consultaRuc/consulta.py