API del RUC: consulte las empresas de Perú por su RUC

Las personas jurídicas que vendieron al Estado peruano desde 2003, según los datos abiertos de contrataciones del OECE, en el mismo formato que los demás países. Es una lista parcial de proveedores del Estado, no un registro mercantil. Esta es la llamada, los campos y lo que la lista no contiene.

Qué devuelve la API para Perú

Prometiam es una API REST de pago que devuelve los datos oficiales de empresas de cada país en un formato único. Para Perú, envíe country=PE con el RUC (Registro Único de Contribuyentes, 11 dígitos) o un nombre. La fuente son los datos abiertos de contrataciones del OECE (Organismo Especializado para las Contrataciones Públicas Eficientes): una lista parcial de proveedores del Estado, no el registro de empresas de Perú.

CampoContenido
company_numberEl RUC, 11 dígitos (por ejemplo 20100001498)
company_nameLa razón social, la de su adjudicación más reciente
addressLa dirección, cuando los datos la dan (pocas fichas la tienen); ciudad, región y código postal nunca se sirven
statusSiempre null: la lista no lleva estado

El RUC

El RUC son 11 dígitos que empiezan por 20 (una persona jurídica). El último es un dígito de control (módulo 11 de la SUNAT) que se exige: uno erróneo, un RUC que empieza por 10, 15 o 17 (una persona natural) o un número mal formado recibe un error 400 (validation_error). Se aceptan espacios, puntos, guiones y un RUC inicial.

La llamada

curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=PE&company_number=20100001498' \
  -H 'Authorization: Bearer rk_live_...'

La respuesta es una lista data; el id de cada entrada sirve para llamar a GET /companies/{id} y obtener la ficha completa. Una búsqueda por nombre (name=) funciona igual.

Lo que la API no devuelve para Perú

  • Proveedores del Estado solamente: personas jurídicas con RUC que empieza por 20 que vendieron al Estado peruano desde 2003 (las E.I.R.L. se incluyen). Una empresa que nunca vendió al Estado no figura. Los empresarios individuales (RUC 10, 15 y 17), los números fiscales extranjeros y toda persona natural nunca se sirven.
  • Sin estado: la lista no lleva estado, así que status es null; un proveedor sigue en la lista después de cerrar.
  • Sin fechas: ni constitución, ni inscripción, ni antigüedad; sin forma jurídica ni código de actividad.
  • Sin capital, plantilla, administradores ni contactos.
  • Sin número de IVA: una búsqueda vat se rechaza.
  • Sin estados financieros ni avisos de insolvencia: Perú no es uno de los dieciséis mercados de insolvencia.
  • Sin eventos de cambios del registro y sin monitorización: POST /monitor rechaza Perú.
  • Actualización mensual, con retraso: las adjudicaciones más recientes aún no figuran. El nombre y la dirección son los de la adjudicación más reciente, así que un nombre puede cambiar de un mes a otro.

Contains data from the Organismo Especializado para las Contrataciones Públicas Eficientes (OECE) of Peru, the legal entities that sold to the Peruvian state since 2003, published through the Open Contracting Data Registry (https://data.open-contracting.org/en/publication/135) under the Creative Commons Attribution 4.0 (CC BY 4.0) licence. Adapted by Prometiam (legal entities only, one record per company); not Peru's company register and not an official extract.

Qué ofrece Prometiam

Una clave y la misma llamada para todos los países abiertos. Los precios son públicos: Starter 9,99 € al mes con 1.000 créditos, Professional 29,99 € con 10.000, Scale 99,99 € con 50.000; Enterprise a medida. Una búsqueda o una ficha cuesta 1 crédito; un error no cuesta nada.

Versión en inglés: Peru company data API.

Páginas relacionadas

Regístrate · Documentación de la API

La prueba dura 14 días e incluye 500 créditos. Se pide una tarjeta, pero no se cobra nada durante la prueba; después sigue el plan Starter (9,99 € al mes) salvo que la canceles.

Preguntas frecuentes

¿Qué es el RUC?
El Registro Único de Contribuyentes es el número de contribuyente que la SUNAT asigna a cada persona jurídica: 11 dígitos que empiezan por 20, con un dígito de control de módulo 11.
¿La lista cubre todas las empresas de Perú?
No. Es una lista parcial: solo las personas jurídicas que vendieron al Estado peruano desde 2003. Una empresa que nunca vendió al Estado no figura.
¿La API da el estado, el IVA, los administradores o las cuentas?
No. Perú no tiene estado, número de IVA, administradores, estados financieros ni avisos de insolvencia, y no tiene eventos ni monitorización.
¿Se puede monitorizar una empresa peruana?
No. POST /monitor rechaza Perú: la lista se lee una vez al mes y no lleva estado ni fechas.