Integración con el Servicio Web de Consulta de ítems

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

El servicio web de Consulta de Ítems (.../aws_consultaitems.aspx), permite buscar los datos de uno o más ítems de la digitación previamente registrados en la aplicación.

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

Layout

Layout de Consulta de Ítems. 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 de ítems. 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_consultaitems.aspx?WSDL.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:gx="Gx">
   <soapenv:Header/>
   <soapenv:Body>
      <gx:WS_ConsultaItems.Execute>
         <gx:Xmlconsulta><!--(1)--></gx:Xmlconsulta>
      </gx:WS_ConsultaItems.Execute>
   </soapenv:Body>
</soapenv:Envelope>

1. Aquí estará tu XML de consulta de ítems 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.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:gx="Gx">
   <soapenv:Header/>
   <soapenv:Body>
      <gx:WS_ConsultaItems.Execute>
         <gx:Xmlconsulta>&lt;ConsultaItem&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;Pagina&gt;Informa la pagina deseada. Si no informado retorna pagina 1.&lt;/Pagina&gt;
   &lt;/Encabezado&gt;
   &lt;Filtros&gt;
      &lt;RetornarTodos&gt;Indica se retorna todos los ítems: S = Retorna todos los registros, N = Es nec&lt;/RetornarTodos&gt;
      &lt;ItemsEspecificos&gt;
         &lt;ItemsEspecificosItem&gt;
            &lt;CodigoInterno&gt;Código interno generado por la aplicación&lt;/CodigoInterno&gt;
         &lt;/ItemsEspecificosItem&gt;
      &lt;/ItemsEspecificos&gt;
   &lt;/Filtros&gt;
&lt;/ConsultaItem&gt;</gx:Xmlconsulta>
      </gx:WS_ConsultaItems.Execute>
   </soapenv:Body>
</soapenv:Envelope>

Al realizar una solicitud de consulta de ítem el servicio web traerá los datos de los ítems que corresponden al filtro informado.

Respuesta

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

<Xmlretorno><![CDATA[<?xml version="1.0" encoding="utf-8"?>
<ConsultaItemRetorno>
   <Encabezado>
      <EmpCodigo>1</EmpCodigo>
      <NroLinRetorno>1</NroLinRetorno>
      <NroLinTotalRetorno>1</NroLinTotalRetorno>
      <Pagina>1</Pagina>
      <MsgCod>0</MsgCod>
      <MsgDsc />
   </Encabezado>
   <ListaItems>
      <Item>
         <CodigoInterno>201</CodigoInterno>
         <IteNomItem>NOMBRE DEL ITEM</IteNomItem>
         <IteDscItem>ESTA ES UNA DESCRIPCIÓN.</IteDscItem>
         <IteIndAgenteResp>R</IteIndAgenteResp>
         <IteIndFact>5</IteIndFact>
         <IteUniMed>UNID</IteUniMed>
         <ItePrecioUnitario>150.675834</ItePrecioUnitario>
         <IteNCM>15487</IteNCM>
      </Item>
   </ListaItems>
</ConsultaItemRetorno>]]></Xmlretorno>

• Códigos de Resupesta General
• Tabla de Rechazos del InvoiCy

Autores : Gustavo Paluchowski