Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Especificación Técnica de
WebService ConsultasPlantillas
Versión 1.0
19/10/2010
Tabla de Contenidos
Confidencial Página 2 de 20
4. Mensajes informativos de respuestas del servicio 20
Confidencial Página 3 de 20
Objetivo del Documento
El objetivo del presente documento consiste en exponer las especificaciones técnicas del
servicio web Consultas Plantillas 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 Servicios 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 20
WebService Consulta Plantillas
Objetivo
El objetivo del servicio es permitir a los usuarios consultar la información de las Plantillas
a través de la aplicación SVE.
WSDL
Protocolo: HTTP
Estándar: SOAP
Confidencial Página 5 de 20
Métodos del WebService
WebMethod “consultarDetallePlanDesMerEmpUsu”
1.1.1 Objetivo
Permitir que los usuarios de ZOFRI puedan consultar Detalles de Plantillas de Descripción
de Mercancías.
1.1.2 Descripción
Toda vez que un usuario desee consultar los detalles de plantillas de descripción de
mercancías 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 detalles de
plantillas de descripción de mercancías en el SVE.
Resultado: Síncrono.
Pre-Condición: N/A.
Confidencial Página 6 de 20
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>
RUT_EMPRESA
4 String 1..1 Rut de empresa.
RAZON_SOCIAL
4 String 1..1 Razón social de empresa.
CODIGO_ARANCELARIO
4 String 1..1 Nombre de código arancelario.
CODIGO_PDM
4 String 1..1 Código de plantilla de descripción de mercancía.
Confidencial Página 7 de 20
4 PDES_ID String 1..1 Id de plantilla de descripción de mercancía.
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header>
09-4-b521-540fcc-c0-095954a4 -5c07cd8694:e3b33b821fe:6</cl:token>
<cl:respuesta xmlns:cl="cl.zofri.sve">
<java:resCodigo xmlns:java="java:cl.zofri.sve.utl.bo">0</java:resCodigo>
<java:resSeveridad xmlns:java="java:cl.zofri.sve.utl.bo">O</java:resSeveridad>
</cl:respuesta>
</env:Header>
<env:Body>
<m:consultarDetallePlaDesMerEmpUsuResponse xmlns:m="http://cl/zofri/sve/cns/wsn">
9641b020-14-f-c0c2-5929 4440-9c87-d:6443e4b2368:16e06-f52aa2fd50c7315e-09-4-b521-540fcc-c0-095954a4 -
5c07cd8694:e3b33b821fe:6</token><idUsuario>resteves</idUsuario><CodigoTipoUsuario>TUSU2</
<params>
</params>
</query></data></srvs></result></srv>]]></m:return>
</m:consultarDetallePlaDesMerEmpUsuResponse>
</env:Body>
</env:Envelope>
Confidencial Página 8 de 20
WebMethod “consultarDesValPlanDesMer”
1.1.8 Objetivo
Permitir que los usuarios de ZOFRI puedan consultar Descriptores y Valores de Plantillas
de Descripción de Mercancías.
1.1.9 Descripción
Toda vez que un usuario desee consultar los descriptores y valores de plantillas de
descripción de mercancías 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
los descriptores y valores de plantillas de descripción de mercancías 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 20
1.1.12 Ejemplo XML de entrada del servicio
NOMBRE_LISTA
4 String 1..1 S Nombre de lista de valores.
Confidencial Página 10 de 20
1.1.14 Ejemplo XML de salida del servicio
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header>
01-2-c5c1-540ac1-f0-0a5355af -560fc48299:83a34b520f2:6</cl:token>
<cl:respuesta xmlns:cl="cl.zofri.sve">
<java:resCodigo xmlns:java="java:cl.zofri.sve.utl.bo">0</java:resCodigo>
<java:resSeveridad xmlns:java="java:cl.zofri.sve.utl.bo">O</java:resSeveridad>
</cl:respuesta>
</env:Header>
<env:Body>
<m:consultarDesValPlanDesMerResponse xmlns:m="http://cl/zofri/sve/cns/wsn">
1621c0c0-14-a-10f2-5a23 54f0-968f-4:249384a2465:06206-652a125d3087b16e-01-2-c5c1-540ac1-f0-0a5355af -
560fc48299:83a34b520f2:6</token><idUsuario>resteves</idUsuario><CodigoTipoUsuario>TUSU2</
viewAcc="edit, del">
<params>
</params>
</query></data></srvs></result></srv>]]></m:return>
</m:consultarDesValPlanDesMerResponse>
</env:Body>
</env:Envelope>
Confidencial Página 11 de 20
WebMethod “consultarItemsInvSinCodPDM”
1.1.15 Objetivo
Permitir que los usuarios de ZOFRI puedan consultar Ítems de Inventario sin Código
PDM.
1.1.16 Descripción
Toda vez que un usuario desee consultar los ítems de inventario sin código PDM 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 los ítems de inventario 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 12 de 20
1.1.19 Ejemplo XML de entrada del servicio
RAZON_SOCIAL
4 String 1..1 S Razón social de empresa.
CODIGO_ADUANERO_ITEM
4 String 1..1 S Código aduanero del ítem.
CODIGO_ARANCELARIO
4 String 1..1 S Código y nombre de código arancelario.
Confidencial Página 13 de 20
4 UNIDAD_MEDIDA_COMERCIAL String 1..1 S Nombre de unidad de medida comercial.
Confidencial Página 14 de 20
1.1.21 Ejemplo XML de salida del servicio
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header>
05-d-b591-5401c9-20-09575aaf -5905c88b9d:83631b726f3:a</cl:token>
<cl:respuesta xmlns:cl="cl.zofri.sve">
<java:resCodigo xmlns:java="java:cl.zofri.sve.utl.bo">0</java:resCodigo>
<java:resSeveridad xmlns:java="java:cl.zofri.sve.utl.bo">O</java:resSeveridad>
</cl:respuesta>
</env:Header>
<env:Body>
<m:consultarItemsInvSinCodPDMResponse xmlns:m="http://cl/zofri/sve/cns/wsn">
56d1b090-14-1-9022-5927 a4f0-9985-8:b4d38462167:6630a-158af2ade0b7c11e-05-d-b591-5401c9-20-09575aaf -
5905c88b9d:83631b726f3:a</token><idUsuario>resteves</idUsuario><CodigoTipoUsuario>TUSU2</
<params>
</params>
</query></data></srvs></result></srv>]]></m:return>
</m:consultarItemsInvSinCodPDMResponse>
</env:Body>
</env:Envelope>
Confidencial Página 15 de 20
WebMethod “consultarIteInvConCodPDMActFec”
1.1.22 Objetivo
Permitir que los usuarios de ZOFRI puedan consultar Ítems de Inventario con Código
PDM Actualizado por Fechas.
1.1.23 Descripción
Toda vez que un usuario desee consultar los ítems de inventario con código PDM
actualizado por fechas 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
los ítems de inventario 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 16 de 20
1.1.26 Ejemplo XML de entrada del servicio
Confidencial Página 17 de 20
4 UNIDAD_MEDIDA_COMERCIAL String 1..1 S Nombre de unidad de medida comercial.
Confidencial Página 18 de 20
1.1.28 Ejemplo XML de salida del servicio
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header>
f-e551-5408c8-30-0b5e5da4 -560bce8193:f3b36bc2cf7:f</cl:token>
<cl:respuesta xmlns:cl="cl.zofri.sve">
<java:resCodigo xmlns:java="java:cl.zofri.sve.utl.bo">0</java:resCodigo>
<java:resSeveridad xmlns:java="java:cl.zofri.sve.utl.bo">O</java:resSeveridad>
</cl:respuesta>
</env:Header>
<env:Body>
<m:consultarIteInvConCodPDMActFecResponse xmlns:m="http://cl/zofri/sve/cns/wsn">
e6f1e050-14-8-8032-5b2e d440-968b-e:1433f4b266c:c670f-351aa20df0f7513e-0e-f-e551-5408c8-30-0b5e5da4 -
560bce8193:f3b36bc2cf7:f</token><idUsuario>resteves</idUsuario><CodigoTipoUsuario>TUSU2</
<params>
</params>
</query></data></srvs></result></srv>]]></m:return>
</m:consultarIteInvConCodPDMActFecResponse>
</env:Body>
</env:Envelope>
Confidencial Página 19 de 20
4. Mensajes informativos de respuestas del servicio
Confidencial Página 20 de 20