Consultar un RUT

Consulta los datos de un RUT en DGI (razón social, domicilio fiscal y tipo de contribuyente), útil para prellenar los datos de un cliente antes de emitir un comprobante. Requiere que la empresa cuente con firma electrónica vigente en Fixed.

Límite: 20 consultas por minuto por empresa. Si se supera, responde 429.

La guía correspondiente está en Clientes.

Solicitud

La ruta POST /consultarRUTDGI se agrega a la URL base del ambiente.

Enviá los headers x-api-key y x-api-secret. Cómo obtenerlos está en Credenciales.

El cuerpo es JSON (Content-Type: application/json).

Campos

Si falta un campo obligatorio, la API rechaza la solicitud.

Campo	Tipo	Obligatorio	Descripción	Ejemplo
rut	string	Sí	RUT a consultar en DGI.	219314970014

Respuesta 200

Datos del RUT encontrados en DGI

Si la operación sale bien, codigoError viene vacío.

Campo	Tipo	Obligatorio	Descripción	Ejemplo
descripcion	string	Sí	—	—
codigoError	string	Sí	—	—
razonSocial	string	Sí	Razón social del contribuyente según DGI.	Panadería El Buen Pan S.A.
domicilioFiscal	string	Sí	Domicilio fiscal tal cual lo devuelve DGI (dirección y localidad juntas, sin separar).	Av. Italia 1234 - Montevideo
tipoContribuyente	string	Sí	Tipo de contribuyente según DGI.	IVA MINIMO

Errores

Una respuesta de error trae codigoError y descripcion. El mismo código puede significar cosas distintas según el endpoint. El índice completo está en Códigos de error.

Si fallan las credenciales o el formato del body, aplican los códigos comunes: A01 a A06, V01 y V02.

Código	Significado
E01	Empresa no encontrada
E02	Sin firma electrónica vigente
E03	RUT no encontrado en DGI
E04	Se superó el límite de 20 consultas por minuto. La API responde HTTP 429

HTTP 429

Se superó el límite de 20 consultas por minuto de esta empresa. codigoError es E04. Esperá un minuto y reintentá.

HTTP 500

Error al consultar el RUT (ver codigoError)

{
  "descripcion": "El RUT '219314970014' no fue encontrado en DGI.",
  "codigoError": "E03",
  "razonSocial": "",
  "domicilioFiscal": "",
  "tipoContribuyente": ""
}

Ejemplos

Ejemplo con el valor de cada campo del contrato.

{
  "rut": "219314970014"
}