API del NIT: consulte las empresas de Guatemala por su NIT

Las personas jurídicas que ofertaron al Estado guatemalteco o le vendieron, según los datos abiertos de Guatecompras, en el mismo formato que los demás países. Es una lista parcial de oferentes y 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 Guatemala

Prometiam es una API REST de pago que devuelve los datos oficiales de empresas de cada país en un formato único. Para Guatemala, envíe country=GT con el NIT (Número de Identificación Tributaria) o un nombre. La fuente son los datos abiertos de Guatecompras (Ministerio de Finanzas Públicas): una lista parcial de oferentes y proveedores del Estado, no el registro de empresas de Guatemala.

CampoContenido
company_numberEl NIT, escrito cuerpo, guion y dígito de control (por ejemplo 10021019-8)
company_nameLa razón social, la de su adjudicación más reciente
address, city, regionLa dirección, la localidad (ciudad) y el departamento (región)
legal_form_fullEl tipo de persona jurídica como texto; no hay código de forma jurídica
statusSiempre null: los datos no llevan estado

El NIT

El NIT es un cuerpo de 3 a 11 dígitos, un guion y un dígito de control (0 a 9 o K), escrito 10021019-8; el guion es opcional. El dígito de control (módulo 11) se exige: uno erróneo o un número mal formado recibe un error 400 (validation_error).

La llamada

curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=GT&company_number=10021019-8' \
  -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 Guatemala

  • Oferentes y proveedores del Estado solamente: personas jurídicas con NIT que ofertaron al Estado guatemalteco o le vendieron. Los datos no separan a los adjudicatarios de los oferentes, así que también se sirve una empresa que solo ofertó; una que nunca ofertó no figura. Las personas naturales (tipo INDIVIDUAL) y las copropiedades de personas (tipo COPROPIEDAD) nunca se sirven.
  • Sin estado: los datos no llevan estado, así que status es null; una empresa sigue en la lista después de cerrar.
  • Sin fechas: ni constitución, ni inscripción, ni antigüedad; sin código de forma jurídica ni 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: Guatemala no es uno de los dieciséis mercados de insolvencia.
  • Sin eventos de cambios del registro y sin monitorización: POST /monitor rechaza Guatemala.
  • 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.

Contains data from Guatecompras, Ministerio de Finanzas Públicas of Guatemala, the legal entities that bid to or sold to the Guatemalan state, published as open contracting data (https://ocds.guatecompras.gt/descarga-datos) under the Creative Commons Attribution 4.0 (CC BY 4.0) licence. Adapted by Prometiam (legal entities only, one record per company); not Guatemala'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: Guatemala 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 NIT?
El Número de Identificación Tributaria es el número tributario que la SAT asigna a un contribuyente guatemalteco: un cuerpo de dígitos, un guion y un dígito de control (0 a 9 o K) de módulo 11.
¿La lista cubre todas las empresas de Guatemala?
No. Es una lista parcial: solo las personas jurídicas que ofertaron al Estado guatemalteco o le vendieron. Una empresa que nunca ofertó no figura.
¿La API da el estado, el IVA, los administradores o las cuentas?
No. Guatemala 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 guatemalteca?
No. POST /monitor rechaza Guatemala: los datos se leen una vez al mes y no llevan estado ni fechas.