Validate Peru RUC (tax ID)
validate_peru_rucValidate a Peruvian RUC (11-digit tax ID) and look up the company in the public SUNAT registry file (Padrón Reducido del RUC). Returns check-digit validity, legal name, taxpayer status (active or not), fiscal-address condition (HABIDO / NO HABIDO), fiscal address with district, and a pass/review/fail vendor assessment with reasons. Full data is returned for company RUCs (prefix 20). For natural-person RUCs (prefix 10, 15, 16, 17) the taxpayer status and address condition are returned; the holder's name is returned only when the connector is used with an API key (?api_key=... or Authorization header), for supplier and customer verification; never the DNI or address (privacy, Ley 29733). If that copy is unavailable the answer is a check-digit validation with verification_level "format". Typical use: checking a Peruvian supplier or customer before paying, invoicing or onboarding it.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ruc": "<ruc>"
},
"name": "validate_peru_ruc"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ruc | Yes | 11-digit Peru RUC, e.g. "20615614841". Spaces and dashes are ignored. |