Saltar a contenido

Integración con el Servicio Web de Consulta de RUT

¡Hola! En este artículo le guiaremos en la integración de su ERP con el servicio de consulta de RUT de InvoiCy.

El servicio web de Consulta de RUT (.../aws_consultarut.aspx) permite consultar un RUT en la DGI, devolviendo información como su estado de registro, domicilio fiscal, contactos de la empresa, giros asociados al RUT, entre otros datos relevantes.

Ejemplo: https://appuypruebas.migrate.info/InvoiCy/aws_consultarut.aspx?wsdl

Layout

Layout de Envio de la Consulta del RUT. Download

Estructura de Envio

La estructura del XML de entrada de este servicio web está detallada en el layout de envío correspondiente al proceso de consulta del rut. A continuación, se muestra un ejemplo del sobre SOAP en el que debe enviarse dicho XML, esta estructura también puede consultarse accediendo al WSDL en aws_consultarut.aspx?WSDL.

1
2
3
4
5
6
7
8
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:gx="Gx">
   <soapenv:Header/>
   <soapenv:Body>
      <gx:WS_ConsultaRut.Execute>
         <gx:Xmlenvio><!--(1)--></gx:Xmlenvio>
      </gx:WS_ConsultaRut.Execute>
   </soapenv:Body>
</soapenv:Envelope>
  1. Aquí estará tu XML de envío correspondiente al proceso de consulta del rut convertido, reemplazando < y > por < y > respectivamente.

Dentro de la etiqueta , debe enviarse el XML de la solicitud convertido a texto, como se muestra en el siguiente ejemplo.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:gx="Gx">
   <soapenv:Header/>
   <soapenv:Body>
      <gx:WS_ConsultaRut.Execute>
         <gx:Xmlenvio>&lt;!--Utilizar el namespace 'xmlns=&quot;http://www.invoicy.com.uy/&quot;' --&gt;
&lt;ConsultaRUT xmlns=&quot;http://www.invoicy.com.uy/&quot;&gt;
   &lt;Encabezado&gt;
      &lt;EmpCodigo&gt;Codigo de la empresa&lt;/EmpCodigo&gt;
      &lt;EmpPK&gt;Clave del socio&lt;/EmpPK&gt;
      &lt;EmpCK&gt;Clave de comunicacion&lt;/EmpCK&gt;
   &lt;/Encabezado&gt;
   &lt;DatosRUT&gt;
      &lt;RUT&gt;RUT de la empresa&lt;/RUT&gt;
   &lt;/DatosRUT&gt;
&lt;/ConsultaRUT&gt;</gx:Xmlenvio>
      </gx:WS_ConsultaRut.Execute>
   </soapenv:Body>
</soapenv:Envelope>

Al requerir el servicio web, se solicita los datos que quiere consultar conforme la estructura definida. En caso de falla, se responde con el código y el mensaje de error.

Respuesta

A continuación, se muestra un ejemplo de la respuesta del servicio web.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
<Xmlretorno><![CDATA[<ConsultaRUTRetorno>
    <Encabezado>
        <EmpCodigo>1</EmpCodigo>
        <MsgCod>100</MsgCod>
        <MsgDsc>Consulta realizada con éxito.</MsgDsc>
    </Encabezado>
    <DatosRUT>
        <RcpRUT>219000090011</RcpRUT>
        <RcpRazSocial>DGI RUC PRUEBA CEDE Y DIRECCION GENERAL IMPOSITIVA</RcpRazSocial>
        <RcpNombreFantasia>VERIFICACION ACTUALIZACION 051</RcpNombreFantasia>
        <RcpEstadoActividad>AA</RcpEstadoActividad>
        <RcpFechaInicioActivdad>2006-09-27</RcpFechaInicioActivdad>
        <RcpDireccion>12 METROS</RcpDireccion>
        <RcpDirNumero>6855</RcpDirNumero>
        <RcpCiudad>CASUPA</RcpCiudad>
        <RcpDepartamento>LAVALLEJA</RcpDepartamento>
        <Contactos>
            <ContactosItem>
                <RcpConCodigo>1</RcpConCodigo>
                <RcpConDescripcion>CORREO ELECTRONICO</RcpConDescripcion>
                <RcpConDetalle>PLANPROD@DGI.GUB.UY</RcpConDetalle>
            </ContactosItem>
            <ContactosItem>
                <RcpConCodigo>5</RcpConCodigo>
                <RcpConDescripcion>TELEFONO FIJO</RcpConDescripcion>
                <RcpConDetalle>25062223</RcpConDetalle>
            </ContactosItem>
        </Contactos>
        <Complementos>
            <ComplementosItem>
                <RcpComCodigo>21</RcpComCodigo>
                <RcpComDescripcion>SHOPPING</RcpComDescripcion>
                <RcpComDetalle>ROJITO</RcpComDetalle>
            </ComplementosItem>
        </Complementos>
        <Giros>
            <GirosItem>
                <RcpGroCodigo>47115</RcpGroCodigo>
                <RcpGroFechaInicio>2020-12-10</RcpGroFechaInicio>
                <RcpGroDescripcion>COMERCIO AL POR MENOR REALIZADO POR LOS FREE SHOPS</RcpGroDescripcion>
            </GirosItem>
            <GirosItem>
                <RcpGroCodigo>62020</RcpGroCodigo>
                <RcpGroFechaInicio>2025-05-08</RcpGroFechaInicio>
                <RcpGroDescripcion>ACT. DE CONSULTORIA INFORMATICA Y DE ADM. DE MEDIOS INFORMAT</RcpGroDescripcion>
            </GirosItem>
            <GirosItem>
                <RcpGroCodigo>84110</RcpGroCodigo>
                <RcpGroFechaInicio>2020-12-10</RcpGroFechaInicio>
                <RcpGroDescripcion>ACTIVIDADES DE LA ADMINISTRACION PUBLICA EN GENERAL</RcpGroDescripcion>
            </GirosItem>
        </Giros>
    </DatosRUT>
</ConsultaRUTRetorno>]]></Xmlretorno>
Autores : Gustavo Paluchowski

ENLACES ÚTILES

SOPORTE

HABLAR CON NOSOTROS

  • +55 11 4240 6556 (comercial)