curl --request GET \
--url https://docs.pymo.uy/v1/dgiData/{companyRut} \
--cookie connect.sid=import requests
url = "https://docs.pymo.uy/v1/dgiData/{companyRut}"
headers = {"cookie": "connect.sid="}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {cookie: 'connect.sid='}};
fetch('https://docs.pymo.uy/v1/dgiData/{companyRut}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://docs.pymo.uy/v1/dgiData/{companyRut}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_COOKIE => "connect.sid=",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://docs.pymo.uy/v1/dgiData/{companyRut}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("cookie", "connect.sid=")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://docs.pymo.uy/v1/dgiData/{companyRut}")
.header("cookie", "connect.sid=")
.asString();require 'uri'
require 'net/http'
url = URI("https://docs.pymo.uy/v1/dgiData/{companyRut}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["cookie"] = 'connect.sid='
response = http.request(request)
puts response.read_body{
"payload": {
"companyDgiData": {
"PersonaActEmpresarial": {
"RUT": "219000090011",
"Denominacion": "DGI RUC PRUEBA CEDE Y DIRECCION GENERAL IMPOSITIVA",
"NombreFantasia": "PRUEBA ENVÍO MAIL",
"TipoEntidad": "27",
"DescripcionTipoEntidad": "SOCIEDAD CIVIL",
"EstadoActividad": "AA",
"FechaInicioActivdad": "2006-09-27",
"DomFiscalLocPrincipal": {
"PersonaActEmpresarial.DomFiscalLocPrincipalItem": {
"Local_Sec_Nro": "1",
"Local_Nom_Fnt": "",
"TipoLocal_Id": "1",
"TipoLocal_Dsc": "PRINCIPAL",
"Local_Fec_Ini": "2006-09-27",
"Local_Fec_Canc": "0000-00-00",
"TipoDom_Id": "2",
"TipoDom_Des": "FISCAL",
"CalOcup_id": "2",
"Calocup_Des": "ARRENDATARIO",
"TerCod_Id": "0",
"Tercod_Des": "",
"Calle_id": "605017",
"Calle_Nom": "FERNANDEZ CRESPO AVDA. DANIEL",
"Dom_Pta_Nro": "1534",
"Dom_Bis_Flg": "",
"Dom_Ap_Nro": "0",
"Loc_Id": "2100000",
"Loc_Nom": "MONTEVIDEO",
"Dpto_Id": "10",
"Dpto_Nom": "MONTEVIDEO",
"Dom_Pst_Cod": "0",
"Dom_Coment": "",
"Dom_Err_Cod": "N",
"Contactos": {
"Domicilio.DomicilioItem.Contacto": [
{
"TipoCtt_Id": "1",
"TipoCtt_Des": "CORREO ELECTRONICO",
"DomCtt_Val": "PLANPROD@DGI.GUB.UY"
},
{
"TipoCtt_Id": "5",
"TipoCtt_Des": "TELEFONO FIJO",
"DomCtt_Val": "13446529"
}
]
},
"Complementos": "\n\t\t\t"
}
},
"PersonaActividades": {
"PersonaActEmpresarial.PersonaActividadesItem": [
{
"GiroCod": "47115",
"GiroNom": "COMERCIO AL POR MENOR REALIZADO POR LOS FREE SHOPS",
"GiroFec_Ini": "2016-03-10"
},
{
"GiroCod": "84110",
"GiroNom": "ACTIVIDADES DE LA ADMINISTRACION PUBLICA EN GENERAL",
"GiroFec_Ini": "2006-09-27"
}
]
}
}
}
},
"status": "SUCCESS"
}{
"payload": {},
"message": {
"code": "UNAUTHORIZED",
"value": "Debe iniciar sesión."
},
"status": "FAIL"
}{
"payload": {},
"message": {
"code": "FORBIDDEN",
"value": "No tiene permisos para realizar esta acción."
},
"status": "FAIL"
}Consultar en DGI los datos de un RUT
Valida un RUT y trae los datos de esa parte en DGI. Consulta a DGI.
Acceso: restringida. Requiere sesión, y sólo opera sobre el RUT de tu propia empresa: pedir otro RUT responde 403 FORBIDDEN.
Consulta los datos que DGI tiene de una empresa. El RUT a consultar va en el querystring, en rut, no en el path: el {companyRut} del path es la empresa con cuyo certificado se firma la consulta, y puede no ser la misma que se consulta.
curl --request GET \
--url https://docs.pymo.uy/v1/dgiData/{companyRut} \
--cookie connect.sid=import requests
url = "https://docs.pymo.uy/v1/dgiData/{companyRut}"
headers = {"cookie": "connect.sid="}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {cookie: 'connect.sid='}};
fetch('https://docs.pymo.uy/v1/dgiData/{companyRut}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://docs.pymo.uy/v1/dgiData/{companyRut}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_COOKIE => "connect.sid=",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://docs.pymo.uy/v1/dgiData/{companyRut}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("cookie", "connect.sid=")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://docs.pymo.uy/v1/dgiData/{companyRut}")
.header("cookie", "connect.sid=")
.asString();require 'uri'
require 'net/http'
url = URI("https://docs.pymo.uy/v1/dgiData/{companyRut}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["cookie"] = 'connect.sid='
response = http.request(request)
puts response.read_body{
"payload": {
"companyDgiData": {
"PersonaActEmpresarial": {
"RUT": "219000090011",
"Denominacion": "DGI RUC PRUEBA CEDE Y DIRECCION GENERAL IMPOSITIVA",
"NombreFantasia": "PRUEBA ENVÍO MAIL",
"TipoEntidad": "27",
"DescripcionTipoEntidad": "SOCIEDAD CIVIL",
"EstadoActividad": "AA",
"FechaInicioActivdad": "2006-09-27",
"DomFiscalLocPrincipal": {
"PersonaActEmpresarial.DomFiscalLocPrincipalItem": {
"Local_Sec_Nro": "1",
"Local_Nom_Fnt": "",
"TipoLocal_Id": "1",
"TipoLocal_Dsc": "PRINCIPAL",
"Local_Fec_Ini": "2006-09-27",
"Local_Fec_Canc": "0000-00-00",
"TipoDom_Id": "2",
"TipoDom_Des": "FISCAL",
"CalOcup_id": "2",
"Calocup_Des": "ARRENDATARIO",
"TerCod_Id": "0",
"Tercod_Des": "",
"Calle_id": "605017",
"Calle_Nom": "FERNANDEZ CRESPO AVDA. DANIEL",
"Dom_Pta_Nro": "1534",
"Dom_Bis_Flg": "",
"Dom_Ap_Nro": "0",
"Loc_Id": "2100000",
"Loc_Nom": "MONTEVIDEO",
"Dpto_Id": "10",
"Dpto_Nom": "MONTEVIDEO",
"Dom_Pst_Cod": "0",
"Dom_Coment": "",
"Dom_Err_Cod": "N",
"Contactos": {
"Domicilio.DomicilioItem.Contacto": [
{
"TipoCtt_Id": "1",
"TipoCtt_Des": "CORREO ELECTRONICO",
"DomCtt_Val": "PLANPROD@DGI.GUB.UY"
},
{
"TipoCtt_Id": "5",
"TipoCtt_Des": "TELEFONO FIJO",
"DomCtt_Val": "13446529"
}
]
},
"Complementos": "\n\t\t\t"
}
},
"PersonaActividades": {
"PersonaActEmpresarial.PersonaActividadesItem": [
{
"GiroCod": "47115",
"GiroNom": "COMERCIO AL POR MENOR REALIZADO POR LOS FREE SHOPS",
"GiroFec_Ini": "2016-03-10"
},
{
"GiroCod": "84110",
"GiroNom": "ACTIVIDADES DE LA ADMINISTRACION PUBLICA EN GENERAL",
"GiroFec_Ini": "2006-09-27"
}
]
}
}
}
},
"status": "SUCCESS"
}{
"payload": {},
"message": {
"code": "UNAUTHORIZED",
"value": "Debe iniciar sesión."
},
"status": "FAIL"
}{
"payload": {},
"message": {
"code": "FORBIDDEN",
"value": "No tiene permisos para realizar esta acción."
},
"status": "FAIL"
}Autorizaciones
Sesión por cookie de POST /v1/login, válida 1 hora. Ver Autenticación.
Parámetros de ruta
"219999990008"
Parámetros de consulta
Filtra por subcadena en el número de RUT.
"219999990008"
Respuesta
Éxito
Envoltorio común a todas las respuestas. status no se deduce del código HTTP: hay al menos nueve lugares en el gateway que responden HTTP 200 con status: "FAIL" (por ejemplo CFE_NOT_FOUND y DGI_COMPANY_NOT_READY_YET). Un cliente tiene que leer status, no el código.
Los datos de la respuesta. {} cuando el endpoint no devuelve nada.
De las 82 claves de mensaje del gateway, 29 son SUCCESS y 53 FAIL. Es lo que hay que mirar para saber si la llamada funcionó.
SUCCESS, FAIL Presente cuando la operación tiene algo que decir. Las lecturas simples responden sólo payload y status.
Show child attributes
Show child attributes