| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Contacts (contacts)
• Discuss (mail) • Invoicing (account) |
| Community Apps Dependencies | Show |
| Lines of code | 1337 |
| Technical Name |
ruc_validation_sunat |
| License | OPL-1 |
| Website | https://www.ganemo.co |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Contacts (contacts)
• Discuss (mail) • Invoicing (account) |
| Community Apps Dependencies | Show |
| Lines of code | 1337 |
| Technical Name |
ruc_validation_sunat |
| License | OPL-1 |
| Website | https://www.ganemo.co |
RUC Validation
Real-Time SUNAT Connection
Eliminate manual errors. Fetch official company data directly from SUNAT by simply entering the RUC number. Fast, accurate, and essential for Peruvian invoicing.
What We're Solving
----------------
Instant Data Entry
Typing company details manually is slow and prone to typos. This module automatically fills the Legal Name, Street, District, Province, and Department the moment you validate the RUC.
Fiscal Compliance
Ensure you only do business with active taxpayers. The system retrieves the Taxpayer Status (Active, Retired) and Condition (Habido, No Habido) ensuring your electronic invoices are valid.
Setup & User Manual
Step-by-Step implementation
1. Configuration Guide
No complex setup required. Just install and verify permissions:
- Go to Apps and install RUC Validation SUNAT.
- Ensure the Peru - Catalogues (l10n_pe_catalog) module is installed.
- Crucial Step: Go to Settings > Companies > [Your Company]. Switch to the "General Information" tab.
- Locate the "RUC Query Token" field. Enter your valid API Token provided by Ganemo (or your service provider).
- Ensure your Company's country is set to Peru.
2. Operating Manual (Workflow)
How to validate a partner:
Create Contact
Go to Contacts and click New. Select Company or Individual (with RUC 10...).
Enter RUC
Select "Tax ID Type" as RUC. Enter the 11-digit number in the "Tax ID" (VAT) field.
Auto-Fetch
The system will automatically query SUNAT (or press the "Update" button if configured). Wait a second for the data to populate.
Verify Data
Review the filled Name, Address, and verify the State is "Active" and Condition is "Habido". Save the record.
Global Ready | Multi-Language Support
This module is fully translated into English and Spanish (en_US, es_ES, es_PE, es_MX), ensuring a professional experience for international organizations.
Why Choose Ganemo?
----------------
Ganemo is the world's leading Odoo App developer and a multi-award-winning Gold Partner. For over 5 years, we have been recognized as the #1 seller of high-quality apps on the Odoo App Store. Trusted as the "Best Partner" in USA, Mexico, Chile, Spain, Colombia, Ecuador, and Peru, we deliver robust, secure, and localization-compliant solutions for global businesses.
Get a Quote & Resolve Commercial Doubts
Join thousands of satisfied clients on Odoo. Contact our sales team directly.
Official WhatsApp
Fastest response time.
LINK
+1 (828) 672-6150
Book a Demo
Let's explore your needs.
LINK
Schedule Meeting
Need More? We Do It All
Professional Odoo Services
ERP Implementation
Transform your business with a full Odoo implementation. We analyze, configure, and train your team to maximize productivity. From Accounting to Inventory, we handle the complexity so you can focus on growth.
Module Dev & Migration
Need a custom feature? Or stuck on an older version? We develop high-performance custom modules and migrate your existing code to Odoo 19 with zero data loss. Expert developers at your service.
QA / User Testing Scenarios
Enterprise Validation Plan
Scenario 1: Valid Active Company (RUC 20)
- Create a new Contact. Select "Company".
- Set Tax ID Type to RUC.
- Enter a known active RUC (e.g., 20100041376 - SUNAT).
- Result: Name updates to "SUPERINTENDENCIA NACIONAL DE ADUANAS...". Address fields (District: Lima, Province: Lima, Department: Lima) are filled. Status is "Active", Condition is "Habido".
Scenario 2: Individual with Business (RUC 10)
- Create a new Contact. Select "Individual".
- Set Tax ID Type to RUC.
- Enter a valid person's RUC (e.g., 10099684144).
- Result: Name fields (First Name, Last Name) are correctly parsed and filled. Address is populated.
Scenario 3: Invalid RUC (Checksum Error)
- Create a new Contact.
- Enter an invalid RUC (e.g., 20100041370 - changed last digit).
- Result: System displays a warning/notification: "RUC does not exist" or "Invalid RUC". No data is overwritten.
Scenario 4: Missing Token Configuration
- Temporarily remove the Token from Company Settings.
- Try to validate a RUC.
- Result: A clear User Error message appears: "No se agregó un token de consulta RUC...". This confirms error handling is working.
Scenario 5: Update Existing Data (Retroactive)
- Open an existing Partner with an old/incorrect address.
- Ensure Tax ID Type is RUC and Number is correct.
- Click the "SUNAT Query" button (or re-enter RUC).
- Result: Data refreshes with the latest information from SUNAT. Old address is updated.
FAQ & Troubleshooting
Common Resolutions
Data is not loading?
Reason: SUNAT service might be down or blocked by your network.
Fix: Check if you can access sunat.gob.pe. Retry in a few minutes.
Does it validate DNI?
Reason: This module is specialized for RUC (Companies/Individuals with Business).
Note: Check our other modules for DNI validation if needed.
Can I use it for other countries?
Reason: No, this connects specifically to Peruvian government databases.
Is it compatible with e-Invoicing?
Answer: Yes!
Detail: accurate RUC data is critical for successful electronic invoice signing.
How do I get the RUC Query Token?
Answer: You need a valid subscription.
Detail: Contact the Ganemo Sales team (see below) to purchase your API Token plan.
Difference between RUC 10 and 20?
Answer: Both are supported.
Detail: RUC 20 is for Legal Entities (Companies). RUC 10 is for Natural Persons with a Business. This module handles both logic automatically.
Commercial & Sales
For inquiries about licenses, demos, or partnerships.
Official WhatsApp
Fastest response time.
LINK
+1 (828) 672-6150
Book a Demo
Let's explore your needs.
LINK
Technical Support
Existing customers regarding module functionality.
© 2026 Ganemo. All rights reserved.
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module