Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Especificación Técnica de
WebService ConsultasReglasDeEvaluacion
Versión 1.1
21/10/2010
Tabla de Contenidos
2. WebService ConsultaReglasDeEvaluacion 5
2.1 Objetivo 5
2.2 WSDL 5
2.3 Características del servicio 5
Confidencial Página 2 de 21
4. Mensajes informativos de respuestas del servicio 20
Confidencial Página 3 de 21
Objetivo del Documento
El objetivo del presente documento consiste en exponer las especificaciones técnicas del
servicio web de consultas de ubicaciones para el Proyecto Servicios de Visación
Electrónica - ZOFRI.
Acrónimo Significado
http Hypertext Transfer Protocol (Protocolo de transferencia de hipertexto)
SOAP Simple Object Access Protocol http://www.w3.org/TR/soap/
SVE Servicio de Visación Electrónica
XML Extensible Markup Language (Lenguaje de Marcas)
Abreviación Significado
No Aplica
Referencias
Título Fecha Autor
No Aplica
Confidencial Página 4 de 21
WebService ConsultaReglasDeEvaluacion
Objetivo
El objetivo del servicio es permitir a los usuarios llevar a cabo las consultas de reglas de
evaluación a través de la aplicación SVE.
WSDL
http://198.41.32.146/sveConsultasWSN/ConsultasReglasDeEvaluacion?WSDL
Protocolo: HTTP
Estándar: SOAP
Confidencial Página 5 de 21
Métodos del WebService
WebMethod “consultarDetallesVisacionesRechazadas”
1.1.1 Objetivo
Permitir que los usuarios de ZOFRI puedan consultar las visaciones rechazadas sobre un
documento.
1.1.2 Descripción
Toda vez que un usuario desee consultar las visaciones rechazadas sobre un documento,
podrá invocar al servicio mediante el cual el sistema SVE le devolverá el conjunto de
resultados de acuerdo a la consulta especificada.
Resultado: Síncrono.
Pre-Condición: N/A.
ArrayOfJa
Rut de la o las empresas para las cuales se
0 rutEmpresaUsuaria vaLangstri 1..n S
desea obtener los resultados.
ng_literal
NOTA: Para los Servicios Web Tipados que reciben parámetros de tipo String, Date o
BigDecimal, los mismos no admiten ser informados como opcionales ni nulos, en esos
casos se deberá utilizar los siguientes valores por defecto cuando se requiera no
informar un valor para el parámetro:
String: <texto></texto>
Especificación Técnica de WebService Versión Template: 1.0 Fecha:21/10/10
Consultas Reglas de Evaluación
ZOFRI - SVE
Confidencial Página 6 de 21
Date: <fecha>1900-01-01T00:00:00</fecha>
BigDecimal: <granDecimal>0</granDecimal>
Confidencial Página 7 de 21
1.1.7 Ejemplo XML de salida del servicio
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header>
<cl:token xmlns:cl="cl.zofri.sve">0d27e807541f3f024--5f011c30-44-d-91f4-4b6c b021-9b15-
7:44e30749d23:95336-d778827a40fff123-05-0-1c31-c40d79-fb-1b8c4b82
-9b157714de:0543dd399f3:6</cl:token>
<cl:respuesta xmlns:cl="cl.zofri.sve">
<java:resCodigo xmlns:java="java:cl.zofri.sve.utl.bo">0</java:resCodigo>
<java:resMensaje xmlns:java="java:cl.zofri.sve.utl.bo">Se ejecutó correctamente el
servicio.</java:resMensaje>
<java:resSeveridad xmlns:java="java:cl.zofri.sve.utl.bo">O</java:resSeveridad>
</cl:respuesta>
</env:Header>
<env:Body>
<m:consultarDetallesVisacionesRechazadasResponse xmlns:m="http://cl/zofri/sve/cns/wsn">
<m:return><![CDATA[<srv alias="" id="executeSrvDataMultiple"
knaToken="<header><token>0d27e807541f3f024--5f011c30-44-d-91f4-4b6c b021-9b15-
7:44e30749d23:95336-d778827a40fff123-05-0-1c31-c40d79-fb-1b8c4b82 -
9b157714de:0543dd399f3:6</token><idUsuario>pgranados</
idUsuario><CodigoTipoUsuario>TUSU3</CodigoTipoUsuario><RutUsuario></
RutUsuario><RutEmpresa></RutEmpresa><RutAgencia></RutAgencia></
header>">
<result>
<srvs result="ok" rowCount="1"><data TTotal="31" id="consultarDetalleVisacionesRechazadas"
result="ok" rowCount="102" rowCountTotal="102">
<row CODIGO_RECHAZO="311" DESCRIPCION_RECHAZO="Se informó una garantía que no es
utilizada." FECHA_HORA_BLOQUEO="16-04-2010 00:00:00 AM" NOMBRE_RECHAZO="Rechazar Garantia no
utilizada" NOMBRE_TIPO="SOLICITUD DE SALIDA TEMPORAL" NUMERO_PROVISORIO="88860"
RAZON_SOCIAL="EMPRESA SA" RUT_EMPRESA="76048345-1"/>
....
<row CODIGO_RECHAZO="239" DESCRIPCION_RECHAZO="Empresa usuaria informada en el
Documento debe estar relacionado a usuario de sesión" FECHA_HORA_BLOQUEO="19-07-2010 00:00:00 AM"
NOMBRE_RECHAZO="Rechazo empresa usuaria" NOMBRE_TIPO="SOLICITUD DE SALIDA TEMPORAL"
NUMERO_PROVISORIO="88860" RAZON_SOCIAL="EMPRESA SA" RUT_EMPRESA="76048345-1"/>
<statics TExecuteSQL="15" TGetConnection="0" TPopulate="0" TSQLParser="16" TXMLParser="0"/>
<prmsQuery><prm NRO_PROVISORIO_BUSQUEDA="88860" RAZON_SOCIAL_BUSQUEDA=""
rutEmpresaUsuaria="" tipoDocumentos=""/>
</prmsQuery><query authentication="true" authenticationKey="consulta" con="zofriDesa"
id="consultarDetalleVisacionesRechazadas" method="query" rol="*" viewAcc="edit, del">
<params>
<prm name="RAZON_SOCIAL_BUSQUEDA" type="varchar"/>
<prm name="RAZON_SOCIAL_BUSQUEDA" type="varchar"/>
<prm name="NRO_PROVISORIO_BUSQUEDA" type="varchar"/>
<prm name="NRO_PROVISORIO_BUSQUEDA" type="varchar"/>
</params>
</query></data></srvs></result></srv>]]></m:return>
</m:consultarDetallesVisacionesRechazadasResponse>
</env:Body>
</env:Envelope>
1.2.1 Objetivo
Permitir que los usuarios de ZOFRI puedan consultar las ubicaciones bloqueadas.
Especificación Técnica de WebService Versión Template: 1.0 Fecha:21/10/10
Consultas Reglas de Evaluación
ZOFRI - SVE
Confidencial Página 8 de 21
1.2.2 Descripción
Toda vez que un usuario desee consultar las ubicaciones bloqueadas podrá invocar al
servicio mediante el cual el sistema SVE procesará dicha consulta y le devolverá una
respuesta del resultado de la ejecución llevada a cabo. Esta respuesta incluye la
información necesaria para luego poder rastrear las ubicaciones en el SVE.
Resultado: Síncrono.
Pre-Condición: N/A.
NOTA: Para los Servicios Web Tipados que reciben parámetros de tipo String, Date o
BigDecimal, los mismos no admiten ser informados como opcionales ni nulos, en esos
casos se deberá utilizar los siguientes valores por defecto cuando se requiera no
informar un valor para el parámetro:
String: <texto></texto>
Date: <fecha>1900-01-01T00:00:00</fecha>
BigDecimal: <granDecimal>0</granDecimal>
Confidencial Página 9 de 21
</soapenv:Header>
<soapenv:Body>
<wsn:consultarUbicacionesBloqueadas>
<wsn:ubicacionOrigen/>
<wsn:ubicacionDestino/>
<wsn:rutEmpresa>
<!--Zero or more repetitions:-->
<java:JavaLangstring>?</java:JavaLangstring>
</wsn:rutEmpresa>
<wsn:razonSocialEmprUsuaria/>
</wsn:consultarUbicacionesBloqueadas>
</soapenv:Body>
</soapenv:Envelope>
RAZON_SOCIAL_EMPRESA_US
4 String 1..1 Razón social de empresa usuaria.
UARIA
Confidencial Página 10 de 21
<java:resSeveridad xmlns:java="java:cl.zofri.sve.utl.bo">O</java:resSeveridad>
</cl:respuesta>
</env:Header>
<env:Body>
<m:consultarUbicacionesBloqueadasResponse xmlns:m="http://cl/zofri/sve/cns/wsn">
<m:return><![CDATA[<srv alias="" id="executeSrvDataMultiple"
knaToken="<header><token>7224e801841efb0e1--92f1af80-74-a-d1b0-4979 1e11-5932-
8:c4f19bd6ba2:6e110-2349821a40e0b1e3-09-f-ac81-e40a0d-b3-19694131 -
d912383cdf:99d1b8266e1:0</token><idUsuario>resteves</
idUsuario><CodigoTipoUsuario>TUSU2</CodigoTipoUsuario><RutUsuario></
RutUsuario><RutEmpresa></RutEmpresa><RutAgencia></RutAgencia></
header>"><result><srvs result="ok" rowCount="1"><data TTotal="32"
id="consultarUbicacionesBloqueadas" result="ok" rowCount="1" rowCountTotal="1"><row
CODIGO_REGLA="BLODPT" DESCRIPCION_REGLA="Bloqueo por Documentos Pendientes de Terminar 101-
10-365813" FECHA_HORA_BLOQUEO="13-10-2010 00:00:01 AM" NOMBRE_REGLA="Documento Pendiente
Terminar 101-10-365813" RAZON_SOCIAL_EMPRESA_USUARIA="EMPRESA CERO" REVI="2780"
RUT_DOCU="15678839-2" RUT_EMPRESA_USUARIA="15678839-2" UBIC_DESTINO=""
UBIC_ORIGEN="111"/><statics TExecuteSQL="16" TGetConnection="0" TPopulate="0" TSQLParser="0"
TXMLParser="16"/><prmsQuery><prm RAZON_SOCIAL_EMPRESA_USUARIA=""
RUT_EMPRESA="<srvs><row rut='?'/></srvs>" UBIC_DESTINO=""
UBIC_ORIGEN=""/></prmsQuery><query authentication="true" authenticationKey="consulta"
con="zofriDesa" id="consultarUbicacionesBloqueadas" method="query" viewAcc="edit, del">
<params>
<prm name="RAZON_SOCIAL_EMPRESA_USUARIA" type="varchar"/>
<prm name="RAZON_SOCIAL_EMPRESA_USUARIA" type="varchar"/>
<prm name="UBIC_ORIGEN" type="varchar"/>
<prm name="UBIC_ORIGEN" type="varchar"/>
<prm name="UBIC_DESTINO" type="varchar"/>
<prm name="UBIC_DESTINO" type="varchar"/>
<prm name="UBIC_ORIGEN" type="varchar"/>
<prm name="UBIC_ORIGEN" type="varchar"/>
<prm name="UBIC_DESTINO" type="varchar"/>
<prm name="UBIC_DESTINO" type="varchar"/>
</params>
</query></data></srvs></result></srv>]]></m:return>
</m:consultarUbicacionesBloqueadasResponse>
</env:Body>
</env:Envelope>
1.3.1 Objetivo
Permitir que los usuarios de ZOFRI puedan consultar las empresas usuarias bloqueadas.
1.3.2 Descripción
Toda vez que un usuario desee consultar las empresas usuarias bloqueadas podrá
invocar al servicio mediante el cual el sistema SVE procesará dicha consulta y le
devolverá una respuesta del resultado de la ejecución llevada a cabo. Esta respuesta
incluye la información necesaria para luego poder rastrear las ubicaciones en el SVE.
Confidencial Página 11 de 21
Resultado: Síncrono.
Pre-Condición: N/A.
NOTA: Para los Servicios Web Tipados que reciben parámetros de tipo String, Date o
BigDecimal, los mismos no admiten ser informados como opcionales ni nulos, en esos
casos se deberá utilizar los siguientes valores por defecto cuando se requiera no
informar un valor para el parámetro:
String: <texto></texto>
Date: <fecha>1900-01-01T00:00:00</fecha>
BigDecimal: <granDecimal>0</granDecimal>
Confidencial Página 12 de 21
Dato iones
RAZON_SOCIAL_EMPRESA_USUA
4 String 1..1 Razón social de empresa usuaria.
RIA
Confidencial Página 13 de 21
<query authentication="true" authenticationKey="consulta" con="zofriDesa"
id="consultarEmpresasUsuariasBloqueadas" method="query" viewAcc="edit, del">
<params>
<prm name="RAZON_SOCIAL_EMPRESA_USUARIA" type="varchar"/>
<prm name="RAZON_SOCIAL_EMPRESA_USUARIA" type="varchar"/>
</params>
</query></data></srvs></result></srv>]]></m:return>
</m:consultarEmpresasUsuariasBloqueadasResponse>
</env:Body>
</env:Envelope>
1.4.1 Objetivo
Permitir que los usuarios de ZOFRI puedan consultar las reglas de evaluación.
1.4.2 Descripción
Toda vez que un usuario desee consultar las reglas de evaluación podrá invocar al
servicio mediante el cual el sistema SVE procesará dicha consulta y le devolverá una
respuesta del resultado de la ejecución llevada a cabo. Esta respuesta incluye la
información necesaria para luego poder rastrear las ubicaciones en el SVE.
Resultado: Síncrono.
Pre-Condición: N/A.
Confidencial Página 14 de 21
0 vigencia String 1..1 S Vigencia del registro.
Confidencial Página 15 de 21
ArrayOfJ
avaLang Códigos de aduaneros de los ítems para los
0 codigosAduanerosItem 1..n S
string_lit cuales se desea obtener resultados.
eral
ArrayOfJ
avaLang Códigos arancelarios para los cuales se desea
0 codigosArancelarios 1..n S
string_lit obtener resultados.
eral
NOTA: Para los Servicios Web Tipados que reciben parámetros de tipo String, Date o
BigDecimal, los mismos no admiten ser informados como opcionales ni nulos, en esos
casos se deberá utilizar los siguientes valores por defecto cuando se requiera no
informar un valor para el parámetro:
String: <texto></texto>
Date: <fecha>1900-01-01T00:00:00</fecha>
BigDecimal: <granDecimal>0</granDecimal>
Confidencial Página 16 de 21
<wsn:codigosDestinoMerc></wsn:codigosDestinoMerc>
<wsn:codigosPaisProcedencia></wsn:codigosPaisProcedencia>
<wsn:codigosAduanerosItem></wsn:codigosAduanerosItem>
<wsn:fechaInicVigHasta>1900-01-01T00:00:00</wsn:fechaInicVigHasta>
<wsn:codigosLocalidadesDestino></wsn:codigosLocalidadesDestino>
<wsn:totalCIF></wsn:totalCIF>
</wsn:consultarReglasEvaluacion>
</soapenv:Body>
</soapenv:Envelope>
Confidencial Página 17 de 21
Fecha del documento que autoriza la activación
4 FEC_DOCUMENTO_ACT Fecha 1..1
desactivación de la regla.
Numér
4 ID_CAUSAL_RECHAZO 1..1 Identificador de la causal de rechazo.
ico
Numér Identificador del código de la regla asociada a la
4 ID_CODIGO_REGLA 1..1
ico regla.
Numér
4 ID_REGLA 1..1 Identificador de la regla.
ico
Numér
4 ID_TIPO_REGLA 1..1 Identificador del tipo de regla.
ico
4 TOTAL_CIF String 1..1 Valor del total CIF que se validará en la regla.
Confidencial Página 18 de 21
1.4.7 Ejemplo XML de salida del servicio
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header>
<cl:token xmlns:cl="cl.zofri.sve">23292a05ca1b220e5--fd713e41-54-7-7039-18ab 12a1-630b-
2:94138411c39:70c04-3299a251a0b921e3-0f-7-3c41-8417f7-3d-087b118a
-a31bf209e1:8e13cf917ec:4</cl:token>
<cl:respuesta xmlns:cl="cl.zofri.sve">
<java:resCodigo xmlns:java="java:cl.zofri.sve.utl.bo">0</java:resCodigo>
<java:resMensaje xmlns:java="java:cl.zofri.sve.utl.bo">Se ejecutó correctamente el
servicio.</java:resMensaje>
<java:resSeveridad xmlns:java="java:cl.zofri.sve.utl.bo">O</java:resSeveridad>
</cl:respuesta>
</env:Header>
<env:Body>
<m:consultarReglasEvaluacionResponse xmlns:m="http://cl/zofri/sve/cns/wsn">
<m:return><![CDATA[<srv alias="" id="executeSrvDataMultiple"
knaToken="<header><token>23292a05ca1b220e5--fd713e41-54-7-7039-18ab 12a1-630b-
2:94138411c39:70c04-3299a251a0b921e3-0f-7-3c41-8417f7-3d-087b118a
-a31bf209e1:8e13cf917ec:4</token><idUsuario>pgranados</
idUsuario><CodigoTipoUsuario>TUSU3</CodigoTipoUsuario><RutUsuario>1111111-k</
RutUsuario><RutEmpresa>76048345-1</RutEmpresa><RutAgencia></RutAgencia></
header>">
<result><srvs result="ok" rowCount="1">
<data TTotal="78" id="consultarReglasEvaluacion" result="ok" rowCount="59" rowCountTotal="59">
<row ALMA_WARRANT="" CANT_MINIMA_STOCK="[101-10-357921-002,5000.5]" CODIGO_ARANCELARIO=""
CODIGO_REGLA="EBLOCWAR" COD_ADUA_DOCUMENTO="" COD_ADUA_ITEM="101-10-357921-002"
CONDICION="A" CON_EXCEPCION="NO" DESC_REGLA="BLOQUEO POR CONSTITUCION DE WARRANTS"
DESTINO_MERCANCIA="" EMISOR_DOCUMENTO_ACT="" EMP_ASOCIADA_DOCUMENTO="76038195-0"
EMP_COMPRADORA_DOCUMENTO="" EXIGENCIA_GARANTIA="" FECH_ACTIVACION="13-10-2010"
FECH_DESACTIVA="13-10-2010" FECH_INICIO="13-10-2010" FECH_VENCE="" FEC_DOCUMENTO_ACT=""
IDENTIFICA_REGLA="BLOCWAR" ID_CAUSAL_RECHAZO="9" ID_CODIGO_REGLA="507" ID_REGLA="2818"
ID_TIPO_REGLA="4" LOCALIDAD_DESTINO="" LOCALIDAD_ORIGEN="" NOMBRE_REGLA="BLOQUEO POR
WARRANTS NUMERO: 51" NRO_DOCUMENTO_ACT="" OBSERVACIONES="" PAIS_DESTINO=""
PAIS_PROCEDENCIA="" PROCEDENCIA_MERCANCIA="" PROC_APLICACION="" REGL_FECH_CREA="2010-10-13"
REGL_FECH_FINA_REVI="2010-10-13" REGL_USUA_CREA="SVE" TIPO_AFORO="" TIPO_DOCUMENTO=""
TIPO_REGLA="Reglas de Excepcion" TOTAL_CIF="" UBICACION_DESTINO="" UBICACION_ORIGEN=""
VERSION_REGLA="1" VIGENCIA_REGLA="S"/>
......
<row ALMA_WARRANT="" CANT_MINIMA_STOCK="" CODIGO_ARANCELARIO=""
CODIGO_REGLA="BDOCSINTER" COD_ADUA_DOCUMENTO="" COD_ADUA_ITEM="" CONDICION="A"
CON_EXCEPCION="NO" DESC_REGLA="Bloqueo por Documentos Pendientes de Terminar 101-10-366301"
DESTINO_MERCANCIA="" EMISOR_DOCUMENTO_ACT="" EMP_ASOCIADA_DOCUMENTO="76038195-0"
EMP_COMPRADORA_DOCUMENTO="" EXIGENCIA_GARANTIA="" FECH_ACTIVACION="13-10-2010"
FECH_DESACTIVA="" FECH_INICIO="13-10-2010" FECH_VENCE="" FEC_DOCUMENTO_ACT=""
IDENTIFICA_REGLA="BLODPT" ID_CAUSAL_RECHAZO="9" ID_CODIGO_REGLA="502" ID_REGLA="2815"
ID_TIPO_REGLA="1" LOCALIDAD_DESTINO="" LOCALIDAD_ORIGEN="" NOMBRE_REGLA="Documento Pendiente
Terminar 101-10-366301" NRO_DOCUMENTO_ACT="" OBSERVACIONES="" PAIS_DESTINO=""
PAIS_PROCEDENCIA="" PROCEDENCIA_MERCANCIA="" PROC_APLICACION="" REGL_FECH_CREA="2010-10-13"
REGL_FECH_FINA_REVI="" REGL_USUA_CREA="SVE" TIPO_AFORO="" TIPO_DOCUMENTO=""
TIPO_REGLA="Reglas de Bloqueos" TOTAL_CIF="" UBICACION_DESTINO="" UBICACION_ORIGEN=""
VERSION_REGLA="1" VIGENCIA_REGLA="S"/>
<statics TExecuteSQL="78" TGetConnection="0" TPopulate="0" TSQLParser="0" TXMLParser="0"/>
<prmsQuery><prm CANT_MINIMA_STOCK="" CODIGO_REGLA="" COD_ADUANERO_DOCU=""
EMP_ASOCIADA_DOCUMENTO="" EMP_COMPRADORA_DOCUMENTO="" FECHA_FIN_DESDE=""
FECHA_FIN_HASTA="" FECHA_INICIO_DESDE="" FECHA_INICIO_HASTA="" NOMBRE_REGLA="" TIPO_REGLA=""
TOTAL_CIF="" VIGENCIA="0" cod_aduanero_item="" codigo_arancelario="" destino_mercancia=""
localidad_destino="" localidad_origen="" pais_destino="" pais_procedencia="" procedencia_mercancia=""
tipoDocumentos="" ubicacion_destino="" ubicacion_origen=""/>
</prmsQuery>
Confidencial Página 19 de 21
<query authentication="true" authenticationKey="consulta" author="rferreyra" con="zofriDesa"
id="consultarReglasEvaluacion" method="query" rol="*" viewAcc="edit, del">
<params>
<prm name="FECHA_INICIO_DESDE" type="varchar"/>
<prm name="FECHA_INICIO_DESDE" type="varchar"/>
<prm name="FECHA_INICIO_HASTA" type="varchar"/>
<prm name="FECHA_INICIO_HASTA" type="varchar"/>
<prm name="FECHA_FIN_DESDE" type="varchar"/>
<prm name="FECHA_FIN_DESDE" type="varchar"/>
<prm name="FECHA_FIN_HASTA" type="varchar"/>
<prm name="FECHA_FIN_HASTA" type="varchar"/>
<prm name="VIGENCIA" type="varchar"/>
<prm name="VIGENCIA" type="varchar"/>
<prm name="VIGENCIA" type="varchar"/>
<prm name="VIGENCIA" type="varchar"/>
<prm name="VIGENCIA" type="varchar"/>
<prm name="VIGENCIA" type="varchar"/>
<prm name="TIPO_REGLA" type="varchar"/>
<prm name="TIPO_REGLA" type="varchar"/>
<prm name="CODIGO_REGLA" type="varchar"/>
<prm name="CODIGO_REGLA" type="varchar"/>
<prm name="NOMBRE_REGLA" type="varchar"/>
<prm name="EMP_ASOCIADA_DOCUMENTO" type="varchar"/>
<prm name="EMP_ASOCIADA_DOCUMENTO" type="varchar"/>
<prm name="EMP_COMPRADORA_DOCUMENTO" type="varchar"/>
<prm name="EMP_COMPRADORA_DOCUMENTO" type="varchar"/>
<prm name="TOTAL_CIF" type="varchar"/>
<prm name="TOTAL_CIF" type="varchar"/>
<prm name="CANT_MINIMA_STOCK" type="varchar"/>
<prm name="CANT_MINIMA_STOCK" type="varchar"/>
</params>
</query></data></srvs></result></srv>]]></m:return>
</m:consultarReglasEvaluacionResponse>
</env:Body>
</env:Envelope>
Confidencial Página 20 de 21
Especificación Técnica de WebService Versión Template: 1.0 Fecha:21/10/10
Consultas Reglas de Evaluación
ZOFRI - SVE
Confidencial Página 21 de 21