Sei sulla pagina 1di 167

MODELO FACTURA ELECTRNICA.

Actualizaciones:
2003 08 18 Se Agrega punto que describe el proceso de Postulacin y
Certificacin para obtener Resolucin SII que autoriza a operar con
Factura Electrnica.
I. Introduccin.
La importancia de implementar un sistema que permita operar con factura electrnica nace de la
innegable necesidad de otorgar validez legal al ejemplar electrnico de los documento tributarios de
compra y venta tales como facturas, notas de crdito, notas de dbito, guas de despacho, yaque con ello
se optimiza la operacin de las empresas y del Servicio de Impuestos Internos (SII).
Actualmente, el Servicio de Impuestos Internos exige a los contribuyentes que sus documentos
tributarios en papel, sean registrados y autorizados antes de utilizarlos. Esta autorizacin del SII se
materializa a travs de un timbre de cuo que el contribuyente est obligado a aplicar sobre sus
documentos en papel, previo a utilizarlos. Para aplicar este timbre de cuo, que autoriza que un papel sea
utilizadocomo documento tributario, el contribuyente debe concurrir peridicamente a la Unidad del SII
que le corresponde, llevando los documentos que desea timbrar foliados en forma previa. Tanto para el
Servicio como para los contribuyentes, especialmente para los que requieren timbrar un gran volumen de
documentos, este es un procedimiento molesto y costoso. Adicionalmente el utilizar estos formularios
para imprimir sus documentos tributarios provoca molestias en el procesamiento masivo al obligar a
respetar la foliacin en la impresin y al no poder utilizar tecnologa de impresin lser, como es el deseo
de muchos contribuyentes.
En relacin con el almacenamiento de las facturas y otros documentos tributarios, el contribuyente est
obligado a guardar los papeles que los sustentan durante 6 aos para su posterior posible revisin. Esta
obligacin deviene, especialmente para los generadores de grandes volmenes de documentos, una
exigencia costosa en administracin y bodegas.
Como una respuesta a estas necesidades, y en concordancia con la poltica adoptada de modernizar su
gestin y utilizar la red Internet como elemento de comunicacin con los contribuyentes, el Servicio de
Impuestos Internos ha impulsado, con la colaboracin de un grupo de empresas piloto, un modelo de
operacin con Factura Electrnica que actualmente se encuentra en su etapa de Marcha Blanca y que
prximamente estar abierto a todos los contribuyentes. En dicho modelo, los contribuyentes pueden
generar, transmitir, y almacenar en forma electrnica sus documentos tributarios, autenticados con firma
electrnica, adems deben enviar un ejemplar electrnico del documento tributario al SII, antes de que
sea recibido por su receptor o utilizado para el transporte fsico de bienes. La autorizacin de los folios
que se usan en estos documentos se obtiene en el sitio Web del SII, como alternativa al timbre fsico con
cuo.
En este modelo se incorpora la facilidad de la firma electrnica de los documentos como un medio de
asegurar la autenticidad de sus emisores, y cautelar la integridad de los documentos a transmitir.
Servicio de Impuestos Internos
SII -Modelo Factura-Electrnica 18 Agosto 2003
Pg. 2 de 9
II. Descripcin del Sistema.
Cuando se inicie la masificacin del sistema de Factura Electrnica el SII habilitar una opcin en su
sitio Web. En dicha opcin, todos los contribuyentes interesados en ser emisores de documentos
tributarios electrnicos y que tengan desarrollado el sistema para la generacin de dichos documentos,
podrn registrar sus antecedentes y postular para obtener la certificacin del SII y la correspondiente
autorizacin de emisor de documentos tributarios electrnicos.
Para operar con la factura electrnica los contribuyentes deben estar autorizados por SII como emisores
de documentos electrnicos. Esto no los obliga a generar todos sus documentos en forma electrnica
pero s a recibir documentos electrnicos de otros emisores. Los contribuyentes enrolados en el sistema,
una vez que han obtenido la autorizacin del SII, puede conseguir la autorizacin de sus folios a travs
del Web del SII, y, utilizando esos folios, emitir, transmitir y almacenar sus documentos tributarios en
forma electrnica. Los contribuyentes enrolados en el sistema requieren almacenar los documentos
tributarios electrnicos emitidos y recibidos slo en forma electrnica y estn eximidos de la obligacin
de almacenar dichos documentos en papel para una posible revisin del SII. El contribuyente debe enviar
el documento al SII, va Internet, antes de que sea recibido por su destinatario o utilizado para el
transporte fsico de bienes. El contribuyenteemisor debe enviar el documento al receptor, ya sea manual
o electrnico. Al receptor manual, no enrolado en el sistema, le debe enviar la representacin en papel
del documento, la que este ltimo s est obligado a almacenar.
Cada documento debe ser generado en el estndar definido por las especificaciones del SII. Debe
incorporar una firma electrnica digital de la totalidad del documento, la que permite asegurar la
identidad del emisor y cautelar la integridad del documento. Como resguardo adicional, se exige
incorporar un timbre electrnico, el que se imprime en cdigo de barras en la representacin impresa
de los documentos. Este timbre electrnico, obtenido segn un algoritmo de seguridad especificado por
el SII, permite a los fiscalizadores verificar fuera de lnea, en los controles mviles, la validez de los
documentos impresos que acompaan mercaderas.
El Servicio de Impuestos Internos habilit una verificacin de documentos en su sitio Web, lo que
permite a los contribuyentes receptores y a los fiscalizadores del SII, cerciorarse de la validez de un
documento. Prximamente, esta verificacin tambin estar disponible a travs del telfono.
En la figuras 1 y 2 se pueden apreciar cuadros comparativo entre la situacin actual y el sistema de
facturacin electrnica propuesto.
FUNCION SISTEMA ACTUAL SISTEMA PROPUESTO
Foliacin de documentos Pre-impreso en los documentos Autorizado a travs del Web del SII
Timbrado de documentos En oficinas del Servicio Por el contribuyente
Timbre De cuo Electrnico
Almacenamiento Del papel.
Contribuyente, durante 6 aos
Electrnico. SII ejemplar tributario.
Contribuyente para sus propsitos y para
eventuales solicitudes del SII
Verificacin de Validez Slo de autorizacin en Web SII. Autorizacin, recepcin y validez.
En el Web SII .
Impresin del documento Papel autocopiativo, formulario continuo,
prefoliado, impresora de impacto
Papel normal, hoja suelta, impresora lser.
Figura 1
Servicio de Impuestos Internos
SII -Modelo Factura-Electrnica 18 Agosto 2003
Pg. 3 de 9
IMPRENTA
RECEPTOR
EMISOR
SII Revisin
Compradores
SII Revisin
Vendedores
SII Autorizacin
de Folios
SII
RECEPTOR
EMISOR
Revisin
Autorizacin de folios
Envo de documento
E
n
v
o
d
e
d
o
c
u
m
e
n
to
SISTEMA ACTUAL
SISTEMA Con FACTURA ELECTRNICA
Almacenamiento Almacenamiento
CORREO Resguardo Papeles
sin utilizar
( Valorados)
Figura 2
III. Modelo de Operacin.
El contribuyente debe obtener la autorizacin del SII para operar como Emisor de Documentos
Tributarios Electrnicos. El contribuyente podr solicitar autorizacin slo para emitir factura
electrnica, lo cual significa que estar autorizado tambin para notas de crdito y de dbito, o podr
solicitar en forma adicional autorizacin para guas de despacho, facturas de compra o boletas. Las
boletas slo se le autorizarn en el caso que sea un proveedor de servicios peridicos.
Una vez autorizado para operar con documentos tributarios electrnicos el contribuyente tiene la
obligacin de almacenar en forma electrnica, informacin de los libros de ventas y compras, de
acuerdo al formato establecido por el SII. Esta informacin deber incluir la totalidad de los documentos
emitidos y recibidos, tanto electrnicos como manuales y deber ser enviada al SII en forma mensual de
acuerdo con los procedimientos establecidos para ello por el SII. Excepcionalmente podr ser solicitada
en forma especial (de acuerdo con alguna seleccin o clasificacin especfica) si ello es requerido por
necesidades de fiscalizacin.
Servicio de Impuestos Internos
SII -Modelo Factura-Electrnica 18 Agosto 2003
Pg. 4 de 9
En el sitio Web del SII, se encuentra disponible un registro pblico de los contribuyentes enrolados en el
sistema, en el que se indica el tipo de documentos (facturas, notas de dbito y crdito, guas, facturas de
compra, etc), que estn autorizados a generar en forma electrnica. Todo contribuyente registrado en el
SII como generador de un tipo de documento electrnico, est obligado a recibir documentos tributarios
electrnicos. Al estar autorizado para generar cierto tipo de documento en forma electrnica, no est
obligado a generar todos sus documentos de ese tipo en forma electrnica, ya que estar permitido que
maneje en forma paralela un stock de documentos tributarios manuales para ser usados eventualmente,
los cuales timbrar en el SII con el procedimiento habitual del timbre de cuo y estarn sujetos a las
normas establecidas para dichos documentos.
Los contribuyentes enrolados deben mantener actualizada en el sitio Web del SII la informacin acerca
de los Rut de las personas autorizadas al interior de su empresa a interactuar con el SII en el sistema de
factura electrnica. Deben identificar l o los Rut de los titulares de los certificados digitales habilitados
en su empresa para firmar documentos y, designar en forma especial, quin o quienes estn autorizados
para la solicitud de folios.
Previo a la generacin de un documento tributario electrnico es preciso que el contribuyente obtenga,
desde el sitio Web del SII, un rango de nmeros o folios autorizados para un tipo de documento que
generar en forma electrnica. El SII entrega junto a cada rango autorizado un cdigo de autorizacin
asociado a ese rango de folios, que debe ser utilizado para la obtencin del timbre electrnico cuya
representacin en cdigo de barras 2D se incluye en los documentos impresos. Para autenticar y evitar la
alteracin del rango de folios autorizados se incluir en el cdigo de autorizacin una firma del Servicio.
Se considera que los documentos electrnicos son tipos de documentos distintos de los manuales, por lo
que el SII se entrega para ellos un rango diferente a los folios de los documentos manuales.
La estructura de contenido de los documentos, est definida por el SII, bajo el formato estndar XML; la
obligatoriedad de los campos depende de tipo de documento. El contribuyente debe convertir sus
documentos al formato XML definido por el SII.
Los documentos deben incluir un timbre electrnico, como parte del documento electrnico y su
representacin grfica, a travs de un cdigo de barras bidimensional (PDF417), en las impresiones de
los documentos tributarios electrnicos. El timbre es una firma digital de los datos relevantes de un
documento, incluido el Cdigo de autorizacin de Folios que el Servicio entreg al contribuyente junto
con el rango de folios autorizados.
El Servicio de Impuestos Internos verifica la validez del timbre electrnico de los documentos, tanto en
la presencia fiscalizadora y en la fiscalizacin mvil que se realiza en carreteras, como en la recepcin
masiva de ellos.
Una vez generado el documento en el formato establecido, incluyendo el timbre electrnico, debe ser
firmado, en su contenido completo, por un emisor autorizado. Es importante que el contribuyente
resguarde adecuadamente tanto sus cdigo de folios autorizados como sus certificados digitales. Los
mecanismos de seguridad que el contribuyente implemente para asegurar el acceso a los folios
autorizados, y a sus llaves privadas, son de su responsabilidad.
Todo documento electrnico debe ser transmitido al SII en el momento de ser generado. En el caso de
traslado de mercaderas, debe ser enviado al SII antes de que el ejemplar impreso sea utilizado para
realizar el transporte. En los procesos de facturacin masiva, se deben transmitir tan pronto se complete
el proceso correspondiente. En el caso de no existir transporte de productos asociado al documento
electrnico, este podr ser transmitido en un plazo no mayor a 12 horas desde su generacin. El
Servicio de Impuestos Internos
SII -Modelo Factura-Electrnica 18 Agosto 2003
Pg. 5 de 9
mecanismo de envo de estos documentos ser va Internet y permite el envo de documentos en forma
unitaria o en lotes, segn procedimientos determinados por el SII.
El Servicio de Impuestos Internos almacena el ejemplar tributario del documento pero no se hace cargo
de almacenar ejemplares para el contribuyente. Si el contribuyente desea acceder a los ejemplares de sus
documentos debe almacenar, bajo su responsabilidad, sus documentos tributarios para sus fines
particulares
Es necesaria la impresin de un documento para enviarlo a un receptor manual, as como para acompaar
los bienes fsicos a entregar, mediante factura o gua de despacho, a un receptor, electrnico o manual.
La impresin debe cumplir las normas establecidas por el SII. Los productos siempre deben ir
acompaados de una impresin del documento (factura o gua), en dos ejemplares. La impresin de los
documentos est acotada a un mximo de una sola hoja de tamao oficio, segn reglamentacin del SII.
El emisor podr eximirse de hacer la impresin para un receptor manual cuando el documento no
acompaa bienes, siempre que cuente con la autorizacin expresa del receptor, de acuerdo con lo que
establece la Resolucin Exenta N 11 del 14 de Febrero de 2003. En este caso, la imagen que se ponga a
disposicin del receptor deber cumplir con las especificaciones del SII en cuanto a que sea en un
formato que permita la correcta verificacin posterior del timbre electrnico. En ese caso el receptor
manual se obliga, a travs de esa misma autorizacin, a imprimir en la calidad y forma establecida por el
SII.
La modalidad tecnolgica de transmisin del documento electrnico, desde el emisor al receptor
electrnico, debe ser acordada entre ambos e incluir la firma del emisor e informacin del certificado
digital del firmante y respetar el estndar mnimo establecido por el SII. Los contribuyentes deben
intercambiar documentos tributarios electrnicos en el mismo formato XML en que dichos documentos
se envan al SII, y se obligan a responder la recepcin. Adicionalmente se ha definido un formato XML
para la respuesta de recepcin o rechazo del envo y la obligacin de definir una casilla de correo
electrnico para recibir la informacin relacionada con factura electrnica que le enven otros emisores
electrnicos, en el caso que no convengan un medio alternativo.
Desde el punto de vista de un receptor, si el documento recibido da cuenta de una transaccin que se ha
realizado, existe la obligacin de registrar el documento en la contabilidad, debiendo solicitar que se
realicen los ajustes va Nota de Crdito o de Dbito, si corresponde. Si la transaccin no se ha realizado, o
hay error en el Rut del receptor, puede rechazar los documentos como lo hace con los documentos no
electrnicos, sin registrarlo y constituye obligacin del emisor generar y enviar al SII la nota de crdito
electrnica que anule el documento.
Los documentos tributarios electrnicos recibidos por un Receptor Electrnico al ser almacenados
electrnicamente debe adjuntrseles la firma y el Certificado que permite verificar la firma. Los registros
de un documento electrnico, hechos en la contabilidad, tendrn como respaldo vlido slo los
documentos archivados electrnicamente; no se podr utilizar como respaldo un documento impreso, an
cuando ste cumpla con las normas de impresin.
Se considera que un documento electrnico est vlidamente emitido si cumple con las especificaciones
del formato electrnico (schema XML) y por lo tanto es aceptado en la recepcin por parte del SII.
Toda factura que no cumpla con estas condiciones, an cuando hubiera tenido una representacin en
papel, se considerar como no emitida y en consecuencia el SII podr rechazar el crdito fiscal. En este
caso el receptor deber acreditar a satisfaccin del Servicio que se han cumplido las exigencias
establecidas en el artculo 23 N 5 de la Ley del IVA.
Servicio de Impuestos Internos
SII -Modelo Factura-Electrnica 18 Agosto 2003
Pg. 6 de 9
Toda correccin de una factura vlidamente emitida debe ser realizada va Notas de Crdito o de Dbito
electrnicas.
Se habilit para receptores, o contribuyentes en general, una verificacin va Internet de documentos
(prximamente tambin disponible por va telefnica), en la que el contribuyente debe indicar el Rut del
emisor, el tipo de documento y el N de Folio, a lo que el SII responde si el documento ha sido recibido
por el SII, y si no lo ha sido, si el folio est autorizado, no autorizado o anulado. Opcionalmente, si el
documento se reconoce recibido, en la consulta el contribuyente puede indicar otros valores del DTE
(Rut del receptor y monto, por ejemplo) y el SII indicar si esos valores coinciden con los del DTE
existente en su Base de Datos.
IV. Postulacin al Sistema y Certificacin de Emisores Electrnicos
En el sitio Web del SII est publicada toda la informacin, incluyendo antecedentes generales y tcnicos,
que le permiten al contribuyente planificar e iniciar las actividades necesarias para generar documentos
tributarios electrnicos.
En la pgina Web del SII habr una opcin de Postulacin a la emisin, que describe los requisitos y
condiciones de la postulacin. En esta opcin, si la empresa cumple con lo estipulado en estos requisitos
y desea postular a emitir documentos tributarios electrnicos bajo las condiciones estipuladas por el SII,
el representante legal de la empresa, autenticado con Certificado digital, deber ingresar los datos
requeridos en la postulacin.
El Certificado de Rut Digital debe ser obtenido con una de las Entidades Proveedoras de Certificados
Digitales acreditadas ante el SII o ante la Subsecretara de Economa. (Ver sitios de Inters en
www.sii.cl).
Se debe ingresar la identificacin del Usuario-Administrador y las direcciones de correo electrnico
exigidas para la comunicacin con el SII y con otras empresas emisoras de factura Electrnica.
El Usuario-Administrador es la persona nominada por el contribuyente, a travs de su representante
legal, para efectuar las pruebas de certificacin, mantener actualizada la informacin en el sitio Webdel
SII, nombrar otros usuarios autorizados del contribuyente y en general efectuar operaciones relacionadas
con la Factura Electrnica ante el SII.
Antes de aceptar la postulacin el sistema verificar en lnea que la persona que ingresa la postulacin
sea un Representante Legal de la empresa postulante, y que no existen impedimentos para otorgar la
autorizacin.
Una vez aceptada la postulacin, la empresa postulante quedar registrada en el ambiente de
Certificacin del SII y podr iniciar las pruebas. El SII pondr a su disposicin un archivo con un Set de
Pruebas y la documentacin que le permitir iniciar dichas pruebas en el ambiente de Certificacin del
SII.
El Set de Pruebas le indicar un conjunto de datos con los que debe construir un envo de documentos al
SII, el que debe ser recibido sin rechazos ni reparos. Como documentacin adicional, en el ambiente de
Certificacin estarn disponibles, para las empresas autorizadas, los Manuales de Operacin y de
Servicios de operacin automtica.
Si la postulacin no fuese aceptada por el SII, se debe aclarar ante el Servicio la situacin objetada antes
de postular nuevamente.
Servicio de Impuestos Internos
SII -Modelo Factura-Electrnica 18 Agosto 2003
Pg. 7 de 9
A travs de una opcin el contribuyente podr notificar que complet cada hito exigido en la
Certificacin, y los antecedentes que permitan al SII verificar su cumplimiento.
El proceso de Certificacin contempla las siguientes actividades:
1. Envo al SII de los documentos preparados con el Set de Pruebas entregado por el SII, recibido
sin rechazos ni reparos.
2. Simulacin, que contempla la generacin de entre 10 y 100 documentos, con datos
representativos de la operacin del contribuyente que desea certificarse.
3. Envo de documentos impresos que incluyan el timbre electrnico en representacin PDF417.
4. Pruebas de envo de la Informacin Electrnica de Ventas.
5. Pruebas de envo de la Informacin Electrnica de Compras.
6. Otras pruebas de envo de otros documentos que debe tener a disposicin del SII como registros
de guas de despacho, libro de boletas, etc.
Si todas las pruebas de certificacin se completan exitosamente, el SII emitir una Resolucin que
autoriza al contribuyente a operar con la Factura Electrnica y lo registrar en su ambiente de Produccin
para que comience a generar documentos tributarios electrnicos tributaria y legalmente vlidos.
El contribuyente podr comenzar a generar documentos tributarios a partir del perodo tributario
indicado en la Resolucin correspondiente.
V. Boletas de Servicios Electrnicas.
Las boletas electrnicas, se restringirn a las boletas de servicios peridicos, las que se emiten para
receptores conocidos y en forma masiva.
Con respecto a las boletas de Servicios Peridicos su tratamiento es similar al resto de los documentos
con la diferencia de que no se exige firmar cada boleta individual, sino que se firma un resumen, el que
ser trasladado al libro de ventas.
VI. Resumen de las actividades a efectuar por los contribuyentes para la
generacin de Documentos Tributarios Electrnicos.
Todos los contribuyentes debern acreditarse ante el SII, efectuando pruebas en un ambiente de
certificacin que el SII habilitar para ese efecto. A continuacin se detalla las principales actividades
que el SII recomienda efectuar para ser autorizado a emitir Documentos Tributarios Electrnicos. En la
pgina Web del SII se encuentra la informacin general y tcnica que permite planificar y realizar las
actividades indicadas.
1. Definir los usuarios autorizados por la empresa para solicitar folios autorizados, firmar con sus
certificados digitales los documentos tributarios electrnicos de su empresa y enviarlos al SII.
2. Obtener Certificados digitales para los usuarios autorizados por su empresa, definidos en el punto
anterior. Estos certificado digitales deben obtenerse de las entidades certificadoras acreditadas
ante el SII o ante la Subsecretara de Economa, para proveer certificados digitales con fines
tributarios.
Servicio de Impuestos Internos
SII -Modelo Factura-Electrnica 18 Agosto 2003
Pg. 8 de 9
3. Disear el procedimiento que le permita obtener un rango de folios autorizados desde el SII, va
Internet y alimentar con dicha informacin su software de facturacin o emisin de documentos
tributarios electrnicos y cautelar adecuadamente su seguridad.
4. Adecuar su sistema computacional de facturacin para incorporar la generacin de los
documentos tributarios electrnicos, en el formato estndar definido por el SII, y generar el timbre
electrnico de acuerdo con el algoritmo especificado por el SII.
5. Disear un procedimiento que le permita firmar, con llave privada del signatario autorizado, el
DTE completo.
6. Contar con software de manejo de cdigos de barra bidimensionales (PDF417) que le permita
generar e imprimir un cdigo de barra bidimensional que contenga la informacin especificada
por el SII (el timbre electrnico y la informacin requerida para verificarlo).
7. Adecuar sus procedimientos y formularios de impresin, para la correcta impresin del
documento, segn la norma del SII, incluyendo el timbre electrnico en representacin grfica
PDF417.
8. Disear la generacin computacional de la informacin de los libros de compra y de venta, en el
formato estndar definido por el SII.
9. Disear la generacin computacional de la informacin que el SII podra requerir en forma
electrnica para la fiscalizacin.
10. Disear el mecanismo para enviar los documentos e informacin de los libros al SII, va Internet,
y al receptor electrnico (contribuyentes incorporados al sistema) los documentos, por el medio
que acuerden mutuamente, respetando el estndar mnimo establecido por el SII.
11. Definir un procedimiento de respaldo y recuperacin de DTEs, yaque el ejemplar enviado al SII
se conservar slo para uso tributario.
12. Contar con lo necesario para realizar la recepcin de documentos tributarios electrnicos que le
enviarn otros contribuyentes autorizados y que est obligado a recibir. La recepcin debe
contemplar la emisin del comprobante de recepcin y de rechazo, de acuerdo al estndar mnimo
establecido por el SII. A este punto se le debe poner mucha atencin ya que en el momento de
ingresar al sistema empezar a recibir documentos desde otros emisores electrnicos y debe
tener muy bien definido cual ser el flujo que stos tomarn al interior de su empresa.
13. Proveer las opciones de consulta e impresin de informacin que eventualmente sern utilizadas
por los fiscalizadores del SII, en el cumplimiento de su labor.
14. Postular enwww.sii.cl a la emisin de documentos tributarios electrnicos. Esta postulacin debe
ser hecha por un representante de la empresa, con certificado digital, ingresando los datos
requeridos de la empresa.
15. Obtener Set de pruebas y documentacin para certificacin. Aprobada la postulacin el
contribuyente tendr acceso al ambiente de certificacin de SII, a documentacin para operar en l
y a un set de pruebas que indicar un conjunto de datos con los que debe construir un envo de
documentos al SII, el que debe ser recibido sin rechazos ni reparos.
16. Informar al SII del avance en las pruebas, notificando a travs de la pgina web el xito de cada
hito de la certificacin.
Servicio de Impuestos Internos
SII -Modelo Factura-Electrnica 18 Agosto 2003
Pg. 9 de 9
17. Obtener la Resolucin que lo autoriza como Emisor de Documentos Tributarios Electrnicos. Si
las pruebas de certificacin se completan exitosamente, el SII emitir una Resolucin que autoriza
al contribuyente a operar con la Factura Electrnica a partir del perodo tributario
correspondiente.
MANUAL PARA EMPRESAS USUARIAS
AMBIENTE DE CERTIFICACIN
FACTURA ELECTRONICA
Fecha Documento: 2 Febrero 2009
2009 Servicio de Impuestos Internos SII Chile
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 2 de 29
REGISTRO DE CAMBIOS:
26 de Noviembre 2003.
Se incorpora paso de Intercambio dedocumentos en certificacin de contribuyentes.
2 de Febrero 2009.
Correccin en descripcin etapa de Documentos Impresos
Actualizacin del orden de las etapasde Intercambio y Documentos Impresos.
TABLA DE CONTENIDOS
1. DATOS DE LA EMPRESA .............................................................................................. 4
1.1 USUARIOS AUTORIZADOS................................................................................... 5
2. AMBIENTE DE CERTIFICACIN................................................................................ 5
2.1 AGREGAR USUARIOS............................................................................................ 6
2.1 AGREGAR USUARIOS............................................................................................ 7
2.2 SOLICITUD DE TIMBRAJE ELECTRONICO.................................................... 9
2.3 ENVO DE DOCUMENTOS .................................................................................. 12
2.4 CONSULTA DE ENVOS....................................................................................... 14
2.5 OTRAS OPCIONES ................................................................................................ 15
3. DOCUMENTOS TRIBUTARIOS ELECTRONICOS (DTE) ....................................... 17
3.1 Estructura de un DTE.............................................................................................. 17
3.2 Proceso de Validacin .............................................................................................. 18
VALIDAR SCHEMA ..................................................................................................19
VALIDAR FIRMA DIGITAL .....................................................................................19
VALIDAR TIMBRE ELECTRONICO SII .................................................................19
4. AUTOMATIZACIN DE PROCESOS.......................................................................... 20
5. ANEXOS.......................................................................................................................... 21
5.1 DTE DE EJEMPLO................................................................................................. 21
6. CERTIFICACION........................................................................................................... 26
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 3 de 29
2009 Servicio de Impuestos Internos SII Chile
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 4 de 29
1. DATOS DE LA EMPRESA
Su empresa operar en el ambiente de certificacin de Documentos Tributarios
Electrnicos (DTE en adelante), con los siguientes datos:
Rut Emisor, Fecha Resolucin, Numero Resolucin
Documentos Autorizados (TipoDTE)
Factura Electrnica (33)
Nota de Crdito Electrnica (61)
Nota de Dbito Electrnica (56)
Gua de Despacho Electrnica (52)
Confirme estos datos para Su Empresa en la opcin Consultar Empresas Autorizadas
Usuario Administrador(*)
Nombre:
RUT:
(*) Previamente debe obtener un Certificado Digital (Rut Digital) emitido por alguna de las
Empresas acreditadas ante el SII (Ver Proveedores de Certificados Digitales)
e-mail Contacto SII: (*)
(*) A este correo electrnico se enviarn las respuestas del resultado de los envos de
documentos al SII. Se recomienda utilizar un e-mail genrico destinado exclusivamente a
estos fines (ejemplorecepciondte@suempresa.cl ).
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 5 de 29
1.1 USUARIOS AUTORIZADOS
Inicialmente existe 1 nico usuario autorizado, denominado Usuario Administrador, quien a
su vez es el nico encargado de ingresar otros usuarios al sistema.
Los Usuarios Autorizados deben cumplir con:
Estar autenticados ante el sitio web del SII, es decir debe poseer Rut-Clave en el SII
Visite el web SII, bajo la Opcin Clave Secreta y Certificado Digital (Fig.1)
Poseer un Certificado Digital extendido para su RUT personal, por alguna de las
empresas Certificadoras autorizadas por el SII (Acepta.com, E-CertChile, Once).
Modificar su modalidad de autenticacin ante el SII para que acepte su Certificado
Digital. Recomendamos dejar habilitada la autenticacin con ambas opciones (Rut
clave y Certificado Digital) (Fig.
Fig.1
Fig.2
2. AMBIENTE DE CERTIFICACIN
El SII ofrece un ambiente de pruebas para los contribuyentes que desean ingresar al
sistema, a travs de un ambiente de certificacin que es idntico al ambiente que utilizan las
empresas que ya estn operando con el sistema de facturacin electrnica.
Ingrese a la siguiente direccin web:
https://maullin.sii.cl/cvc/dte/certificacion_dte.html
(*) Se recomienda utilizar Internet Explorer versin 5.5 o superior.
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 6 de 29
(*) Previamente debe tener instalado su Certificado Digital para acceder a las opciones para
contribuyentes autorizados y estar dentro de la lista de usuarios autorizados de la empresa
(Captulo 1. Usuarios Autorizados).
En adelante nos referiremos a las opciones indicadas bajo el ttulo de Opciones para
contribuyentes autorizados (*)
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 7 de 29
2.1 AGREGAR USUARIOS
Esta opcin es realizada solamente por el Usuario Administrador. Puede agregar cuantos
usuarios quiera y darle las atribuciones o perfiles que se indican:
El Usuario Administrador debe ingresar a la Opcin Mantencin de Usuarios
Autorizados, y digitar el Rut de la empresa.
en donde inicialmente se muestra la lista de usuarios y el perfil o atributo que tiene:
Actualmente hay 5 atributos asociados a un Usuario Autorizado:
1. Usuario Administrador: Tiene el atributo de poder hacer Mantencin de Usuarios,
Agregar, Eliminar, o Modificar perfiles.
2. Solicitar Folio: Persona autorizada a solicitar Rango de Folios.
3. Anular Folio: Persona autorizada para anular Folios
4. Firmar Doctos: Persona autorizada a Firmar Documentos Electrnicos
5. Enviar Doctos: Persona autorizada a hacer los Envios de documentos al SII y a
firmar el envio de DTE.
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 8 de 29
Al ingresar un nuevo usuario debe ingresar el RUT y el (los) perfil (es) correspondiente a la
funcin que ejecutar (Fig.3)
Fig. 3
Estos perfiles son independientes entre s y un Usuario puede tener uno o varios atributos.
A modo de ejemplo, el Usuario Administrador inicialmente tiene solamente el atributo de
Usuario Administrador, es decir no puede Solicitar Folios o Enviar documentos. Para
realizar esas tareas debe habilitar para s mismolos respectivos atributos.
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 9 de 29
2.2 SOLICITUD DE TIMBRAJE ELECTRONICO
Ingrese a la opcin Solicitud de Timbraje Electrnico de Documentos. Luego de
identificarse con su Certificado Digital, ingrese el RUT de la Empresa, seleccione el Tipo
de Documento y digite la cantidad de folios solicitados. (Fig.5)
(*) El usuario que ingresa a esta opcin debe tener perfil para Solicitar Folios
Fig.5
Luego se le pide confirmar la solicitud, para lo cual debe pinchar el botn Obtener
Folios. Entonces aparece un Comprobante de Solicitud de Folios, que se recomienda
imprimir para sus registros internos. (Fig.6)
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 10 de 29
Fig.6
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 11 de 29
Desde esta pantalla puede bajar el archivoxml que contiene el Cdigo de Autorizacin de
Folios (CAF).
Fig.7 CAF
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 12 de 29
2.3 ENVO DE DOCUMENTOS
Ir a la opcin Envo de Documentos Tributarios Electrnicos del men de contribuyentes
autorizados. (Fig.8)
(*) El usuario que ingresa a esta opcin debe tener perfil para Enviar Documentos
Fig.8
Ingrese el Rut de la Empresa y Seleccione el archivo a enviar (debetener extensin *.xml).
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 13 de 29
El Sistema le entregar una respuesta en donde se indica los datos del envo (fecha, hora,
Rut Empresa, Rut Enviador) y en la esquina superior derecha un Identificador de envo,
con el cual podr posteriormente consultar el resultado de la validacin (Documentos
Aceptados, Rechazados). (Fig.9)
Fig.9
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 14 de 29
2.4 CONSULTA DE ENVOS
Ir a la opcin Consulta Estado de un Envo, ingrese el Rut de la Empresa y el
Identificador de Envo que fue entregado al momento de realizar el envo. (Fig.10)
Fig.10
En forma posterior a la revisin del envo tambin se genera un e-mail con la respuesta de
la validacin del envo, en donde se indican fecha, hora, Ruts, e identificador del envo.
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 15 de 29
Existe la opcin Historia de Envos que entrega un resumen de los ltimos envos
realizado por la Empresa (Fig.11)
Fig.11
2.5 OTRAS OPCIONES
Para las empresas autorizadas tambin existen las siguientes opciones:
Anulacin de Folios : Para inutilizar o anular 1 o ms folios.
Reobtencin de Folios: Para obtener un nuevo archivo CAF de un Rango que haba
sido autorizado anteriormente. Si por algn motivo necesita una copia del archivo
de autorizacin que realiz anteriormente.
Informacin de Timbrajes Histricos: Resumen de todas las Solicitudes de Folio
autorizadas por el SII, fecha, rango y quin lo solicit.
Consulta de Folios Anulados: Resumen de todas las Solicitudes de Folio
autorizadas por el SII, fecha, rango y quin lo solicit.
Consulta entre Contribuyentes Autorizados: Permite a una empresa conocer datos
de otras empresas autorizadas como los documentos que tiene autorizado emitir y la
direccin del correo electrnico que tienedestinada al intercambio de documentos
electrnicos con otras empresas.
Documentacin para empresas autorizadas: Documentacin tcnica que incluye la
documentacin necesaria para operar en el sistema, las instrucciones para construir
el set de prueba de certificacin y la documentacin de los servicios automticos.
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 16 de 29
Actualizacin de Datos de la Empresa: Opcin habilitada para Representantes
Legales de las empresas, en que pueden cambiar el Usuario Administrador y los
datos de correos y otros que seingresaron en la postulacin.
Para todos los contribuyentes que ingresan al sitio web del SII se encuentran disponibles las
opciones de consulta de:
- Empresas Autorizadas. Es un listado de las empresas autorizadas por el SII
a emitir documentos electrnicos.
- Verificacin del contenido de un documento electrnico. Previo ingreso de
los datos relevantes de un documentos (Ruts, fecha, montos) el SII responde
acerca de si ese documento ha sido recibido y si los datos ingresados
coinciden.
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 17 de 29
3. DOCUMENTOS TRIBUTARIOS ELECTRONICOS (DTE)
3.1 Estructura de un DTE
Los DTE tienen estructura de un archivo xml en donde se distinguen las siguientes
secciones:
- SetDTE, seccin del documento que contiene toda la data del envo, esto es la
Cartula y 1 o ms DTE, y su respectiva firma electrnica
- Cartula, seccin que contiene los datos principales de quien hace el envo, a quin
va dirigido, y el tipo y cantidad dedocumentos que contiene el envo.
- DTE, seccin que contiene la data de un nico Documento y su respectiva firma
electrnica.
- Documento, seccin que contiene la informacin en detalle del dte, emisor,
receptor, tems de detalle, etc
- Signature, seccin que contiene la firma electrnica y los parmetros con los cuales
fue generada, de acuerdo al estndar XML Digital Signature.
Fig. Estructura de un DTE
El detalle completo del formato de un DTE se encuentra en la especificacin del schema.
->Ver archivo: EnvioDTE_v10.xsd
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 18 de 29
3.2 Proceso de Validacin
Los DTE recibidos por el SII pasan por un proceso de validacin cuyo resultado puede ser
uno de los siguientes:
- Envo Procesado: El envo completo fue validado de acuerdo al schema y su firma
electrnica. Sin embargo en su interior pueden haber documentos Aceptados o
Rechazados, a nivel individual. Se individualizan los documentos que presentan
algn Reparo o que han sido Rechazados.
- Envo Rechazado. El envo completo es rechazado, ningn documento contenido
dentro del envo fue aceptado. Generalmente esto es debido a errores de Schema,
error en la firma del envo, o usuario no autorizado. Estos documentos deben ser
reenviados por la empresa una vez corregido los errores.
El siguiente diagrama muestra las validaciones generales por las que pasa un envo.
Para el envo de documentos tributarios electrnicos (DTE) vlidos recomendamos seguir
los siguientes pasos:
1- Validar Schema
2- Validar Firma Digital
3- Validar Timbre Electrnico SII
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 19 de 29
VALIDAR SCHEMA
Los DTE deben ser validados contra el schema EnvioDTE_v10.xsd (disponible en sitio
web SII). Como primer paso es imprescindible ajustar el formato de los documentos a esta
especificacin.
Existen software para verificar un xml contra un schema, lo cual facilita la validacin sin
tener que enviar al SII y esperar la respuesta. (Ej. XMLSpy.com)
Otra alternativa es utilizar herramientas de validacin en internet, por ejemplo visite la web:
http://apps.gotdotnet.com/xmltools/xsdvalidator/
VALIDAR FIRMA DIGITAL
Una vez aprobada la validacinde schema se procede a verificar la firma digital. Esta firma
digital debe ajustarse al estndar XML Digital Signature
visitar link http://www.w3c.org/Signature/
En esa misma direccin se informan sobre libreras para el desarrollo en diferentes
plataformas (J ava, C, .Net, etc). Algunas de estas libreras son gratuitas y otras comerciales
para el desarrollo de aplicaciones para este tipo de firma.
VALIDAR TIMBRE ELECTRONICO SII
Como un tercer paso sugerimos dedicarse a generar un Timbre Electrnico SII vlido, de
acuerdo a las especificaciones indicadas en ladocumentacin tcnica disponible en el sitio
web del SII.
La firma del Timbre Electrnico es una firma RSA Standard (PKCS#1), en donde el
mtodo de hashing es SHA-1, la llave privada (Private Key) es la que entrega el SII dentro
del Cdigo de Autorizacin de Folios (CAF), yel Mensaje a firmar es un string formado de
acuerdo a lo indicado en la documentacin tcnica.
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 20 de 29
4. AUTOMATIZACIN DE PROCESOS
En forma opcional las empresas pueden implementar la automatizacin de los procesos de
envo de documentos al SII y de consulta de los mismos. Para ello el SII ha implementado
estas funcionalidades a travs de webservices. Existe documentacin para los siguientes
webservices:
- Autenticacin con Certificado Digital
- Upload automtico (*)
- Consulta Estado de un Envo
- Verificacin Detalle de un DTE
(*) El upload automtico no es un webservice sino una emulacin de la conexin https,
pero su documentacin est asociada a las especificaciones del webservice de
autenticacin.
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 21 de 29
5. ANEXOS
5.1 DTE DE EJEMPLO
Se adjunta el siguiente documento de ejemplo de acuerdo a los siguientes datos de una
Empresa ficticia:
Rut Emisor: 97975000-5 (Rut Empresa)
Rut Envia: 7880442-4 (Rut Usuario autorizado a Enviar)
Fecha Resolucin: 2002-10-20 (Variable particular para cada Empresa)
Numero Resolucin: 0 (Valor fijo en Ambiente de Certificacin)
Tipo DTE: 33 (Factura Electrnica)
Folio: 1582
NroDTE: 1 (Cantidad Total de DTE incluidos en este envio)
Este es un archivo DTE vlido en el ambiente de Certificacin.
<?xml version="1.0" encoding="ISO-8859-1"?>
<EnvioDTE xmlns="http://www.sii.cl/SiiDte" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.sii.cl/SiiDte EnvioDTE_v10.xsd" version="1.0">
<SetDTE ID="SetDoc">
<Caratula version="1.0">
<RutEmisor>97975000-5</RutEmisor>
<RutEnvia>7880442-4</RutEnvia>
<RutReceptor>60803000-K</RutReceptor>
<FchResol>2003-09-02</FchResol>
<NroResol>0</NroResol>
<TmstFirmaEnv>2003-09-08T12:31:59</TmstFirmaEnv>
<SubTotDTE>
<TpoDTE>33</TpoDTE>
<NroDTE>1</NroDTE>
</SubTotDTE>
</Caratula>
<DTE version="1.0">
<Documento ID="F27T33">
<Encabezado>
<IdDoc>
<TipoDTE>33</TipoDTE>
<Folio>27</Folio>
<FchEmis>2003-09-08</FchEmis>
</IdDoc>
<Emisor>
<RUTEmisor>97975000-5</RUTEmisor>
<RznSoc>RUT DE PRUEBA</RznSoc>
<GiroEmis>Insumos de Computacion</GiroEmis>
<Acteco>31341</Acteco>
<CdgSIISucur>1234</CdgSIISucur>
<DirOrigen>Teatinos 120, Piso 4</DirOrigen>
<CmnaOrigen>Santiago</CmnaOrigen>
<CiudadOrigen>Santiago</CiudadOrigen>
</Emisor>
<Receptor>
<RUTRecep>8414240-9</RUTRecep>
<RznSocRecep>J ORGE GONZALEZ LTDA</RznSocRecep>
<GiroRecep>COMPUTACION</GiroRecep>
<DirRecep>SAN DIEGO 2222</DirRecep>
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 22 de 29
<CmnaRecep>LA FLORIDA</CmnaRecep>
<CiudadRecep>SANTIAGO</CiudadRecep>
</Receptor>
<Totales>
<MntNeto>426226</MntNeto>
<TasaIVA>18</TasaIVA>
<IVA>76720</IVA>
<MntTotal>502946</MntTotal>
</Totales>
</Encabezado>
<Detalle>
<NroLinDet>1</NroLinDet>
<CdgItem>
<TpoCodigo>INT1</TpoCodigo>
<VlrCodigo>011</VlrCodigo>
</CdgItem>
<NmbItem>Cajon AFECTO</NmbItem>
<DscItem/>
<QtyItem>139</QtyItem>
<PrcItem>1807</PrcItem>
<MontoItem>251173</MontoItem>
</Detalle>
<Detalle>
<NroLinDet>2</NroLinDet>
<CdgItem>
<TpoCodigo>INT1</TpoCodigo>
<VlrCodigo>022</VlrCodigo>
</CdgItem>
<NmbItem>Relleno AFECTO</NmbItem>
<DscItem/>
<QtyItem>59</QtyItem>
<PrcItem>2967</PrcItem>
<MontoItem>175053</MontoItem>
</Detalle>
<Referencia>
<NroLinRef>1</NroLinRef>
<TpoDocRef>SET</TpoDocRef>
<FolioRef>1</FolioRef>
<FchRef>2003-08-01</FchRef>
<CodRef>1</CodRef>
<RazonRef>Caso 4256-1</RazonRef>
</Referencia>
<TED version="1.0">
<DD>
<RE>97975000-5</RE>
<TD>33</TD>
<F>27</F>
<FE>2003-09-08</FE>
<RR>8414240-9</RR>
<RSR>J ORGE GONZALEZ LTDA</RSR>
<MNT>502946</MNT>
<IT1>Cajon AFECTO</IT1>
<CAF version="1.0">
<DA>
<RE>97975000-5</RE>
<RS>RUT DE PRUEBA</RS>
<TD>33</TD>
<RNG>
<D>1</D>
<H>200</H>
</RNG>
<FA>2003-09-04</FA>
<RSAPK>
<M>0a4O6Kbx8Qj3K4iWSP4w7KneZYeJ +g/prihYtIEolKt3cykSxl1zO8vSXu397QhTmsX7SBEudTUx++2zDXBhZw
==</M>
<E>Aw==</E>
</RSAPK>
<IDK>100</IDK>
</DA>
<FRMA
algoritmo="SHA1withRSA">g1AQX0sy8NJ ugX52k2hTJ EZAE9Cuul6pqYBdFxj1N17umW7zG/hAavCALKByHzdYAfZ3LhGT
XCai5zNxOo4lDQ==</FRMA>
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 23 de 29
</CAF>
<TSTED>2003-09-08T12:28:31</TSTED>
</DD>
<FRMT
algoritmo="SHA1withRSA">pqjXHHQLJ myFPMRvxScN7tYHvIsty0pqL2LLYaG43jMmnfiZfllLA0wb32lP+HBJ
/tf8nziSeorvjlx410ZImw==</FRMT>
</TED>
<TmstFirma>2003-09-08T12:28:31</TmstFirma>
</Documento>
<Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
<SignedInfo>
<CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
<SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/>
<Reference URI="#F27T33">
<Transforms>
<TransformAlgorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
</Transforms>
<DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
<DigestValue>C9T6trZSt8zZUQK2+YUkYuIw5pE=</DigestValue>
</Reference>
</SignedInfo>
<SignatureValue>kAxNuhGppcs1mTd6sXYGwy+etbKBlOqboMvnO2qyARJ YmibHEGb3NOsunmPQS8D+ZHZH/QENE47m
wVSKb/HgqjfIU1zsQcxEnTLQgbG9H6J YmSVXNh5DfVYXFmIDv/1kQOoeu8w8zPLeGLSQzVZ2fK9M9zzcUGWRWvZ6aNP
p59o=</SignatureValue>
<KeyInfo>
<KeyValue>
<RSAKeyValue>
<Modulus>
tNEknkb1kHiD1OOAWlLKkcH/UP5UGa6V6MYso++J B+vYMg2OXFROAF7G8BNFFPQx
iuS/7y1azZljN2xq+bW3bAou1bW2ij7fxSXWTJ YFZMAyndbLyGHM1e3nVmwpgEpx
BHhZzPvwLb55st1wceuKjs2Ontb13J 33sUb7bbJ MWh0=
</Modulus>
<Exponent>
AQAB
</Exponent>
</RSAKeyValue>
</KeyValue>
<X509Data>
<X509Certificate>MIIEPjCCA6mgAwIBAgIDAgGKMAsGCSqGSIb3DQEBBDCBsTEdMBsGA1UECBQUUmVn
aW9uIE1ldHJ vcG9saXRhbmExETAPBgNVBAcUCFNhbnRpYWdvMSIwIAYDVQQDFBlF
LUNlcnRjaGlsZSBDQSBJ bnRlcm1lZGlhMTYwNAYDVQQLFC1FbXByZXNhIE5hY2lv
bmFsIGRlIENlcnRpZmljYWNpb24gRWxlY3Ryb25pY2ExFDASBgNVBAoUC0UtQ0VS
VENISUxFMQswCQYDVQQGEwJ DTDAeFw0wMjEwMDIxOTExNTlaFw0wMzEwMDIwMDAw
MDBaMIHXMR0wGwYDVQQIFBRSZWdpb24gTWV0cm9wb2xpdGFuYTEnMCUGA1UECxQe
U2VydmljaW8gZGUgSW1wdWVzdG9zIEludGVybm9zMScwJ QYDVQQKFB5TZXJ 2aWNp
byBkZSBJ bXB1ZXN0b3MgSW50ZXJ ub3MxETAPBgNVBAcUCFNhbnRpYWdvMR8wHQYJ
KoZIhvcNAQkBFhB3Z29uemFsZXpAc2lpLmNsMSMwIQYDVQQDFBpXaWxpYmFsZG8g
R29uemFsZXogQ2FicmVyYTELMAkGA1UEBhMCQ0wwXDANBgkqhkiG9w0BAQEFAANL
ADBIAkEAvNQyaLPd3cQlBr0fQWooAKXSFan/WbaFtD5P7QDzcE1pBIvKY2Uv6uid
ur/mGVB9IS4Fq/1xRIXy13FFmxLwTQIDAQABo4IBgjCCAX4wIwYDVR0RBBwwGqAY
BggrBgEEAcNSAaAMFgowNzg4MDQ0Mi00MDwGA1UdHwQ1MDMwMaAvoC2GK2h0dHA6
Ly9jcmwuZS1jZXJ 0Y2hpbGUuY2wvRWNlcnRjaGlsZUNBSS5jcmwwIwYDVR0SBBww
GqAYBggrBgEEAcEBAqAMFgo5NjkyODE4MC01MIHmBgNVHSAEgd4wgdswgdgGCCsG
AQQBw1IAMIHLMDYGCCsGAQUFBwIBFipodHRwOi8vd3d3LmUtY2VydGNoaWxlLmNs
L3BvbGl0aWNhL2Nwcy5odG0wgZAGCCsGAQUFBwICMIGDGoGARWwgdGl0dWxhciBo
YSBzaWRvIHZhbGlkYWRvIGVuIGZvcm1hIHByZXNlbmNpYWwsIHF1ZWRhbmRvIGhh
YmlsaXRhZG8gZWwgQ2VydGlmaWNhZG8gcGFyYSB1c28gdHJ pYnV0YXJ pbywgcGFn
b3MsIGNvbWVyY2lvIHUgb3Ryb3MwCwYDVR0PBAQDAgTwMAsGCSqGSIb3DQEBBAOB
gQB2V4cTj7jo1RawmsRQUSnnvJ jMCrZstcHY+Ss3IghVPO9eGoYzu5Q63vzt0Pi8
CS91SBc7xo+LDoljaUyjOzj7zvU7TpWoFndiTQF3aCOtTkV+vjCMWW3sVHes4UCM
DkF3VYK+rDTAadiaeDArTwsx4eNEpxFuA/TJ wcXpLQRCDg==</X509Certificate>
</X509Data>
</KeyInfo>
</Signature></DTE>
</SetDTE><Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
<SignedInfo>
<CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
<SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/>
<Reference URI="#SetDoc">
<Transforms>
<TransformAlgorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
</Transforms>
<DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 24 de 29
<DigestValue>z4vLb55G61Q3156xX9/PiUR0d5A=</DigestValue>
</Reference>
</SignedInfo>
<SignatureValue>FD0hdAwcAk/UkpPZHZfKRDdgN2x0MtLgcXBgkyloo2Q5Ufd7KQrbIwqydNtS3KKWcoAVjQ9C7UeWN1xM
R8KD1p07Lt/Yq1Fr1rbq4/naTFEN4AlMlx3R8Z3oZcjB7J q+Buazeff4iadPWdw0osz6/eQlfyUe/TSRV9mnz8Azok8=</Signature
Value>
<KeyInfo>
<KeyValue>
<RSAKeyValue>
<Modulus>
tNEknkb1kHiD1OOAWlLKkcH/UP5UGa6V6MYso++J B+vYMg2OXFROAF7G8BNFFPQx
iuS/7y1azZljN2xq+bW3bAou1bW2ij7fxSXWTJ YFZMAyndbLyGHM1e3nVmwpgEpx
BHhZzPvwLb55st1wceuKjs2Ontb13J 33sUb7bbJ MWh0=
</Modulus>
<Exponent>
AQAB
</Exponent>
</RSAKeyValue>
</KeyValue>
<X509Data>
<X509Certificate>MIIEPjCCA6mgAwIBAgIDAgGKMAsGCSqGSIb3DQEBBDCBsTEdMBsGA1UECBQUUmVn
aW9uIE1ldHJ vcG9saXRhbmExETAPBgNVBAcUCFNhbnRpYWdvMSIwIAYDVQQDFBlF
LUNlcnRjaGlsZSBDQSBJ bnRlcm1lZGlhMTYwNAYDVQQLFC1FbXByZXNhIE5hY2lv
bmFsIGRlIENlcnRpZmljYWNpb24gRWxlY3Ryb25pY2ExFDASBgNVBAoUC0UtQ0VS
VENISUxFMQswCQYDVQQGEwJ DTDAeFw0wMjEwMDIxOTExNTlaFw0wMzEwMDIwMDAw
MDBaMIHXMR0wGwYDVQQIFBRSZWdpb24gTWV0cm9wb2xpdGFuYTEnMCUGA1UECxQe
U2VydmljaW8gZGUgSW1wdWVzdG9zIEludGVybm9zMScwJ QYDVQQKFB5TZXJ 2aWNp
byBkZSBJ bXB1ZXN0b3MgSW50ZXJ ub3MxETAPBgNVBAcUCFNhbnRpYWdvMR8wHQYJ
KoZIhvcNAQkBFhB3Z29uemFsZXpAc2lpLmNsMSMwIQYDVQQDFBpXaWxpYmFsZG8g
R29uemFsZXogQ2FicmVyYTELMAkGA1UEBhMCQ0wwXDANBgkqhkiG9w0BAQEFAANL
ADBIAkEAvNQyaLPd3cQlBr0fQWooAKXSFan/WbaFtD5P7QDzcE1pBIvKY2Uv6uid
ur/mGVB9IS4Fq/1xRIXy13FFmxLwTQIDAQABo4IBgjCCAX4wIwYDVR0RBBwwGqAY
BggrBgEEAcNSAaAMFgowNzg4MDQ0Mi00MDwGA1UdHwQ1MDMwMaAvoC2GK2h0dHA6
Ly9jcmwuZS1jZXJ 0Y2hpbGUuY2wvRWNlcnRjaGlsZUNBSS5jcmwwIwYDVR0SBBww
GqAYBggrBgEEAcEBAqAMFgo5NjkyODE4MC01MIHmBgNVHSAEgd4wgdswgdgGCCsG
AQQBw1IAMIHLMDYGCCsGAQUFBwIBFipodHRwOi8vd3d3LmUtY2VydGNoaWxlLmNs
L3BvbGl0aWNhL2Nwcy5odG0wgZAGCCsGAQUFBwICMIGDGoGARWwgdGl0dWxhciBo
YSBzaWRvIHZhbGlkYWRvIGVuIGZvcm1hIHByZXNlbmNpYWwsIHF1ZWRhbmRvIGhh
YmlsaXRhZG8gZWwgQ2VydGlmaWNhZG8gcGFyYSB1c28gdHJ pYnV0YXJ pbywgcGFn
b3MsIGNvbWVyY2lvIHUgb3Ryb3MwCwYDVR0PBAQDAgTwMAsGCSqGSIb3DQEBBAOB
gQB2V4cTj7jo1RawmsRQUSnnvJ jMCrZstcHY+Ss3IghVPO9eGoYzu5Q63vzt0Pi8
CS91SBc7xo+LDoljaUyjOzj7zvU7TpWoFndiTQF3aCOtTkV+vjCMWW3sVHes4UCM
DkF3VYK+rDTAadiaeDArTwsx4eNEpxFuA/TJ wcXpLQRCDg==</X509Certificate>
</X509Data>
</KeyInfo>
</Signature></EnvioDTE>
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 25 de 29
5.2 TIMBRE ELECTRONICO DE EJEMPLO
Para el ejemplo anterior (5.1) el timbre fue generado como sigue:
1) Del xml indicado se arma el string que ser firmado (Mensaje)
Mensaj e=
<DD><RE>97975000- 5</ RE><TD>33</ TD><F>27</ F><FE>2003- 09- 08</ FE>
<RR>8414240- 9</ RR><RSR>J ORGE GONZALEZ LTDA</ RSR><MNT>502946</ M
NT><I T1>Caj on AFECTO</ I T1><CAF ver si on=" 1. 0" ><DA><RE>97975000-
5</ RE><RS>RUT DE PRUEBA</ RS><TD>33</ TD><RNG><D>1</ D><H>200</ H>
</ RNG><FA>2003- 09- 04</ FA><RSAPK><M>0a4O6Kbx8Qj 3K4i WSP4w7KneZYe
J +g/ pr i hYt I Eol Kt 3cykSxl 1zO8vSXu397QhTmsX7SBEudTUx++2zDXBhZw==<
/ M><E>Aw==</ E></ RSAPK><I DK>100</ I DK></ DA><FRMA al gor i t mo="SHA1
wi t hRSA" >g1AQX0sy8NJ ugX52k2hTJ EZAE9Cuul 6pqYBdFxj 1N17umW7zG/ hAa
vCALKByHzdYAf Z3LhGTXCai 5zNxOo4l DQ==</ FRMA></ CAF><TSTED>2003- 09
- 08T12: 28: 31</ TSTED></ DD>
2) Desde el Cdigo de Autorizacin de Folios (CAF) el SII entrega la llave privada en
formato PEM con la cual se firmar el Mensaje.
- - - - - BEGI N RSA PRI VATE KEY- - - - -
MI I BOwI BAAJ BANGuDui m8f EI 9yuI l kj +MOyp3mWHi f oP6a4oWLSBKJ Sr d3MpEsZd
czvL0l 7t / e0I U5r F+0gRLnU1Mf vt sw1wYWcCAQMCQQCLyV9FxKFLW09yWw7bVCCd
xpRDr 7FRX/ EexZB4VhsNxm/ vt J f DZyYl e0Lf y42Ll csXxPm1w6Q6Nnj uW+AeBy67
Ai EA7i Mi 5q5xj swqq+49RP55o/ / j qdZL/ pC9r dnUKxsNRMMCI QDhaHdI ct Er N2hC
I P9knS3+9zr a4R+5j SXOvI +3xVhWj QI hAJ 7CF0R0S7SI HHKe04NUURf / 7RvkMqm1
08k74sdnXi 3XAi EAl kWk2vc2HM+a1sCqQxNz/ 098ket qe7Nui dMKeoOQObMCI QCk
FAMS9I cPcMj k7zI 2r / 4EEW63PSXyN7MFAX7TYe25mw==
- - - - - END RSA PRI VATE KEY- - - - -
3) El resultado obtenido de la firma RSA-SHA1, utilizado la llave privada 2) sobre el
mensaje 1) es:
pqj XHHQLJ myFPMRvxScN7t YHvI st y0pqL2LLYaG43j Mmnf i Zf l l LA0wb32l P+HBJ
/ t f 8nzi Seor vj l x410ZI mw==
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 26 de 29
6. CERTIFICACION
La Certificacin es un proceso compuesto por varios pasos en cada uno de los cuales los
postulantes van completando las pruebas solicitadas y declarando su avance al SII. Una vez
terminadas las pruebas, el postulante debe efectuar una declaracin en donde seala que
adems de haber completado exitosamente las pruebas requeridas, cuenta en su instalacin
con los procedimientos y condiciones solicitados por el SII para generar y recibir
adecuadamente documentos tributarios electrnicos. El proceso de certificacin contempla
los siguientes pasos:
1. Set de Prueba asignado por el SII.
2. Simulacin.
3. Intercambio de Informacin
4. Envo de Muestras de Impresin.
5. Declaracin de Cumplimiento de Requisitos.
6. Autorizacin del Contribuyente.
Si todas las pruebas de certificacin se completan exitosamente, el Postulante ser
autorizado por el SII para operar con la Factura Electrnica
A continuacin se describen en detalle los pasos de la certificacin
1. Set de Prueba asignado por el SII.
Este paso consiste en la recepcin en el SII, sin rechazos ni reparos, de un envo de
documentos que el postulante construye en base a un archivo con datos de prueba que el SII
genera en forma nica para cada Postulante, en funcin de su giro y de los documentos que
desea certificar. Adems de documentos tributarios electrnicos, en este paso los
Postulantes deben enviar tambin al SII, como parte de las pruebas, la Informacin
Electrnica de Ventas y la Informacin Electrnica de Compras.
Se recomienda realizar el Set de Pruebas, una vez que Ud. haya realizado pruebas de envos
exitosos al SII (Aceptados sin Reparos). En cualquier momento, adems, tiene la opcin de
obtener un nuevo Set de Pruebas (Fig. Generacin Nuevo Set de Pruebas). Recuerde que
los envos correspondientes al Set de Prueba sern evaluados respecto al ltimo Set de
Pruebas que haya bajado.
Para la construccin de los Documentos Tributarios Electrnicos, as como la Informacin
Electrnica de Ventas y Informacin Electrnica de Compras, con los datos del Set de
Pruebas entregado por el SII, se deben seguir las indicaciones del documento
Instrucciones para la Construccin del Set de Prueba, disponible en la opcin
Documentacin para Empresas Autorizadas.
Los envos con los documentos generados a partir de los datos del set de prueba deben ser
enviados al SII dentro del plazo de 2 meses contados a partir del momento de obtener el set
de prueba. Los envos que excedan ese plazo sern rechazados y el postulante deber
Generar un Nuevo Set de pruebas para realizar las pruebas. El postulante puede iterar
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 27 de 29
cuanto desee enviando archivos correspondientes al set de prueba. Cuando el resultado de
la validacin de dichos envos resulte sin rechazos ni reparos el usuario administrador
puede declararlos para la revisin del SII. Esta revisin consistir en comprobar que el
envo haya sido realizado con los datos del set de prueba entregado al postulante.
Usando la opcin Declarar Avance de la Postulacin, el Postulante puede informar al SII
que complet exitosamente el Set de Pruebas, sealando la fecha y nmero de cada envo
para permitir al SII verificar su validez.
Una vez que el SII haya verificado que el postulante complet satisfactoriamente el set de
prueba, el SII le permitir avanzar al siguiente paso, la Simulacin.
2. Simulacin.
La simulacin es una etapa que contempla la generacin de un envo, recibido en el SII sin
rechazos ni reparos, con los documentos tributarios electrnicos correspondientes a su
facturacin de los ltimos 2 meses, con un mximo de 100 documentos, con datos
representativos, paralelos dela operacin real del contribuyente que desea certificarse.
En el caso de los contribuyentes con gran volumen de facturacin, los 100 documentos
pueden corresponder a un slo mes y en el caso de las empresas con bajo volumen de
facturacin, los documentos pueden abarcar un perodo de ms de 2 meses, con un mnimo
de 10 documentos, si no tiene facturacin suficiente. El Servicio chequear el nmero de
documentos enviados en la Simulacin con el volumen histrico de timbraje de papeles.
Usando la opcin Declarar Avance de la Postulacin, el Postulante puede informar al SII
que complet exitosamente la simulacin, sealando la fecha y nmero de envo para
permitir al SII verificar su validez
Una vez que el SII haya verificado que el postulante complet satisfactoriamente la
simulacin, se le permitir avanzar al siguiente paso, las pruebas de impresin
3. Intercambio de Informacin
En esta etapa el SII enva documentos tributarios electrnicos al contribuyente postulante
para comprobar que ste entrega un acuse de recibo del envo y la aceptacin o rechazo de
los documentos enviados, de acuerdo a las definiciones que el SII ha establecido para el
intercambio de informacin entre contribuyentes autorizados.
El SII har envo de DTEs, a la casilla de correo electrnico que el postulante tiene
registrada en el SII como Mail de Contacto Empresas. El postulante deber enviar un acuse
de recibo del envo y la aceptacin o rechazo de los documentos de acuerdo al schema
XML establecido por el SII para el intercambio de informacin entre contribuyentes
autorizados a la siguiente casilla: SII_dte_intercambio@sii.cl
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 28 de 29
Una vez que el SII haya revisado y verificado la consistencia de las respuestas enviadas, se
considera que la empresa ha superado la prueba de Intercambio de Informacin y la
empresa pasar a la siguiente etapa del proceso de certificacin.
4. Pruebas de Impresin de DTEs.
Esta etapa considera la entrega al SII de la imagen de un conjunto de documentos impresos
de acuerdo a la normativa y que incluyan el timbre electrnico en representacin PDF417.
Estas imgenes se deben entregar en un archivo de tipo PDF adjunto a un correo
electrnico enviado a la siguiente casilla: sii_dte_impresos@sii.cl.
El archivo enviado al SII debecontener la imagen de la impresin de todos los documentos
del set de pruebas adems de 10 documentos de la etapa de simulacin, representativos de
todos los tipos de documentoscon que el postulante operar.
Una vez que el SII haya revisado y aprobado las imgenes de impresin enviadas, se
considera que la empresa ha superado las pruebas de certificacin y que est preparada para
que el Representante Legal haga en el web, en la opcin correspondiente, la declaracin de
cumplimiento de requisitos
5. Declaracin de Cumplimiento de Requisitos
Una vez realizadas correctamente todas las pruebas de Certificacin el contribuyente
deber declarar en el web del SII, a travs de su representante legal, que se obliga a cumplir
con las resoluciones del SII que norman el sistema de Facturacin Electrnica y cuenta con
la implementacin de procedimientos formales y establecidos, que podrn ser auditados por
el SII, que realicen adecuadamente lassiguientes funciones, estimadas crticas:
a) Gestin de Cdigos de Autorizacin de Folios (almacenamiento y control de
acceso).
b) Foliacin controlada (asignacin nicade cada folio autorizado por el SII).
c) Respaldo de los documentos e informacin generada.
d) Envo de documentos al SII.
e) Intercambio (envo y recepcin) de documentos con otros contribuyentes
f) Cuadratura de envos aceptados, rechazados y aceptados con reparos por el SII
g) Administracin de contingencias.
AMBIENTE DE CERTIFICACIN FACTURA ELECTRONICA - SII
2 de Febrero de 2009
Pg. 29 de 29
Adicionalmente el representante legal del contribuyente declarar conocer las obligaciones
que emanan de la resolucin que lo autorizar a operar en el sistema de documentos
tributarios electrnicos.
6. Autorizacin del Contribuyente
Si todas las pruebas de certificacin se completan exitosamente, y el Postulante, a travs de
su Representante Legal, efecta la declaracin de cumplimiento de Requisitos, el SII
emitir una Resolucin que autoriza al contribuyente a operar con Documentos Tributarios
Electrnicos y lo registrar en su ambiente de Produccin para que comience a generar
documentos tributarios electrnicos legalmente vlidos a partir del perodo tributario
indicado en dicha Resolucin.
INSTRUCCIONES PARA LA CONSTRUCCIN DE DOCUMENTOS TRIBUTARIOS
ELECTRNICOS CON LOS DATOS DEL SET DE PRUEBAS.
INTRODUCCIN
Este es el primer paso del proceso de certificacin para convertirse en emisor, autorizado
por el SII, de Factura Electrnica.
Varias de las actividades que debe efectuar el Usuario Administrador para completar esta
etapa se realizan a travs de las opciones del ambiente de Certificacin (tambin conocido
como ambiente de pruebas), por lo que recomendamos obtener el Manual de Operacin
desde el submen Documentacin para Empresas Autorizadas. En dicho Manual se
describen las opciones disponibles en el ambiente de Certificacin que el SII ha habilitado
para que las empresas postulantes efecten las pruebas.
En esta primera etapa del proceso de certificacin el Usuario Administrador debe enviar al
SII documentos tributarios electrnicos preparados con los datos entregados por el SII en el
Set de Pruebas y generados de acuerdo al formato XML establecido por el SII.
I.- RESPECTO A LA CONFECCIN DE CADA DOCUMENTO
1. Ud. ha recibido un conjunto de datos que debe utilizar para confeccionar los
documentos de prueba.
2. Previo a emitir los documentos debe solicitar folios por tipo de documento.
3. Debe generar un documento DTE para cada caso incluido en el SET.
4. Para generar cada documento del SET:
a. Asigne un folio autorizado.
b. Agregue un Rut receptor de un cliente existente. Utilice RUT distintos para las
distintas facturas.
c. Agregue fecha del da.
d. En la glosa del temdebe anotar exactamente lo indicado en el caso; debe incluir
acentos, u otros que se indiquen. No debe agregar lneas adicionales de tems.
e. Debe registrar los valores de cantidad y precio unitario que se indiquen en cada
caso.
- En el Caso de las Notas de Crdito por devolucin de mercaderas, el precio
unitario debe corresponder al precio de la Factura original.
- En el caso de Notas de Crdito por diferencia de precio, la diferencia se
debe aplicar a todas las unidades del temrespectivo
f. Las lneas de detalle deben ir en el orden especificado.
g. Utilice la tasa del IVA que corresponda a la fecha de emisin del DTE.
5. En el sector encabezado: Calcule los valores de Monto Neto, Exento y otros, que
correspondan segn el caso. Asegrese de incorporar todos los datos que son
obligatorios, segn el tipo de documento y el caso.
6. En el sector de referencias: En la primera lnea de referencia de cada DTE del set de
prueba debe indicar:
- El texto SET como Tipo de Documento de Referencia y
- El texto CASO xxxxx-x en el campo Razn referencia
Como ejemplo, si ha confeccionado un DTE del Set de prueba, cuyo N de caso es
1062-1,
Ud. debe agregar en el campo correspondiente a tipo de documento de referencia
la palabraSET y en el campo Razn referencia el textoCASO 1062-1
Las otras referencias que sea preciso agregar dado el tipo de documento
correspondiente a la prueba, deben ir a partir de la lnea 2.
II.- RESPECTO AL ENVIO DEL SET DE PRUEBAS
Mientras realice las pruebas, puede enviar los documentos en tantos envos como desee,
peroen el envo de los Set reportados para la Revisin del SII, debe incluir todos los
documentos de los Sets de pruebas y en el mismo orden en que le fueron entregados.
En la cartula de cada envo debe indicar:
Rut del Contribuyente
Rut del firmante autorizado (quien enva)
Rut del Receptor. Indicar Rut 60803000-K, que corresponde al RUT del SII
Nmero y Fecha de Resolucin: Indique el nmero y fecha que est publicado en
los datos de su empresa en el ambiente de certificacin
Tipos de documentos enviados y cantidad de cada uno
Si enva un documento del Set de prueba y ste es aceptado con reparos, deber usar un
folio distinto para enviar el documento nuevamente, ya que en caso contrario el documento
ser rechazado por folio duplicado.
III.- RESPECTO A LA CONFECCIN DEL ARCHIVO INFORMACIN ELECTRONICA DE
VENTAS (IEV)
Debe confeccionar este Libro, incorporando slo la informacin de los documentos que son
parte de sus SET de prueba y que han sido reportados para revisin. En el Archivo IEV, se
deben incluir Facturas, Notas de Crdito y Notas de Dbito electrnicas.
1. Zona Cartula: Debe indicar la siguiente informacin:
Rut del Contribuyente
Rut del firmante autorizado
Perodo Tributario: Los documentos del SET de prueba deben ser emitidos de forma
que sean todos del mismo perodo tributario. En la cartula deber indicarse ese
perodo tributario.
Nmero y Fecha de Resolucin: Indique el nmero y fecha que est publicado en los
datos de su empresa en el ambiente de certificacin
Tipo de Operacin. Venta
Tipo de Libro: ESPECIAL
Tipo de envo: TOTAL
Folio Notificacin: Registrar 1
2. Zona Resumen perodo: Debe entregar totalizados los campos por tipo de documento
3. Zona Detalle: Debe registrar para cada documento del SET de Prueba
Los datos contenidos del documento
Agregar datos obligatorios en caso que se requiera. Verificar el documento Formato
Informacin Electrnica de Compras y Ventas .
IV.- RESPECTO A LA CONFECCIN DEL ARCHIVO INFORMACIN ELECTRONICA DE
COMPRAS
Ud. debe confeccionar este Libro, incorporando slo la informacin de los documentos que
se le han entregado en el SET de prueba de Libro de Compras.
1. Zona Cartula: Debe indicar la siguiente informacin:
Rut del Contribuyente
Rut del firmante autorizado
Perodo Tributario: Se asume que el perodo tributario es el mismo del Libro de
Ventas.
Nmero y Fecha de Resolucin: Indique el nmero y fecha que est publicado en los
datos de su empresa en el ambiente de certificacin
Tipo de Operacin. Compra
Tipo de Libro: ESPECIAL
Tipo de envo: TOTAL
Folio Notificacin: Registrar 2
2. Zona Resumen perodo: Debe entregar totalizados los campos por tipo de documento
3. Zona Detalle: Debe registrar la informacin que se le ha entregado en el Set respectivo
Considerar los datos informados en el Set de prueba de Compras.
Calcular los datos que se requieran para completar la informacin necesaria de un
documento de compra; se deber completar, segn sea el caso, el Monto Neto,
Exento, tasa de IVA, IVA, Monto Total.
Agregar datos del emisor del documento para lo cual se debern usar Rut vlidos.
Agregar otros datos obligatorios que se requieran segn el documento y sus
caractersticas. Verificar el documento Formato Informacin Electrnica de Compras
y Ventas
Manual de Desarrollador Externo
Solicitud Reenvo de Correo Validacin DTE
Oficina Factura Electrnica
Subdireccin Informtica
Servicio Impuestos Internos
Fecha:11/05/2007
WS para Reenvo de Correoscon Diagnstico de Validacin DTE
Versin 1.0 10/01/2006
Pgina2 de 10
INDICE
INTRODUCCIN.................................................................................................................................3
CAPITULO 1........................................................................................................................................4
OBJ ETIVOS Y CARACTERISTICAS ..................................................................................................4
1.1 OBJ ETIVOS DE LA APLICACIN.......................................................................................................4
1.2 CARACTERSTICA DE LA APLICACIN ..............................................................................................4
CAPITULO 2........................................................................................................................................5
WSDL DE WSDTECORREO .................................................................................................................5
2.1 GRAMTICA DEL WSDL...............................................................................................................5
2.1.1 WSDL de wsDTECorreo...................................................................................................5
CAPITULO 3........................................................................................................................................6
DETALLE DE PARMETROS DEL SERVICIO...................................................................................6
3.1 PARMETROS DE ENTRADA ..........................................................................................................6
3.1.1 Ejemplo Real Parmetros de Entrada Formato WSDL ........................................................6
3.2 PARMETROS DE SALIDA.............................................................................................................7
3.2.1 Ejemplos de Salida Formato WSDL ...................................................................................7
3.3 VALORES DE SALIDA ...................................................................................................................8
3.4 VALORES DE ESTADO PARA SALIDAS CON ERROR..........................................................................8
3.4.1 Errores de Datos:.............................................................................................................8
3.4.2 Errores por Autenticacin: .................................................................................................8
3.4.3 Otros Errores: ..................................................................................................................8
CAPITULO 4........................................................................................................................................9
GUIAPARA REALIZAR PRUEBAS....................................................................................................9
4.1 PRUEBA DEL SERVICIO ................................................................................................................9
REFERENCIAS................................................................................................................................. 10
WS para Reenvo de Correoscon Diagnstico de Validacin DTE
Versin 1.0 10/01/2006
Pgina3 de 10
INTRODUCCIN
El servicio wsDTECor r eo, forma parte del proyecto Documentos Tributarios Electrnicos (DTE), y
corresponde a un servicio que permite a las empresas (contribuyentes) solicitar en forma automtica al SII
el reenvo de los correos con diagnostico de validacin DTE para trackids especficos.
Este documento est dirigido a quienes tengan la misin de utilizar y probar este servicio.
La forma de acceder a este servicio es a travs de WSDL (Web Services Definition Language). Este es un
lenguaje descriptor, basado en XML, que permite conocer en forma abstracta, la gramtica de los
componentes de un webservice (ubicacin, formato, tipos de datos, servicios, funciones, parmetros de
entrada, salida, etc).
El WSDL que se detalla en este documento apunta al ambiente de certificacin del SII, sin embargo este
ambientees una copia fiel del ambiente de produccin.
La ubicacin del WSDL dewsDTECor r eo es:
Certificacin : ht t ps: / / maul l i n. si i . cl / DTEWS/ ser vi ces/ wsDTECor r eo?wsdl
Produccin : ht t ps: / / pal ena. si i . cl / DTEWS/ ser vi ces/ wsDTECor r eo?wsdl
Una vez que el cliente conoce el WSDL del webservice, debe construir un Request en formato SOAP
(Simple Object Access Protocolo), para luego enviarlo hacia el proveedor de servicio (SII), previa
Autenticacin.
Respecto a la Autenticacin, para poder realizar consultas hacia cualquier webservice entregado por el
SII, los clientes deben estar previamente autenticados a travs de la AUTENTICACIN AUTOMATICA.
Requisitos de uso.
Para poder utilizar este manual, es necesario tener previo conocimiento de XML, Web Services y
Certificado Digital.
Recomendaciones.
Se recomienda el uso de la herramienta XMLSPY5 de la Altova ( ht t p: / / www. al t ova. com ).
WS para Reenvo de Correoscon Diagnstico de Validacin DTE
Versin 1.0 10/01/2006
Pgina4 de 10
CAPITULO 1
OBJETIVOS Y CARACTERISTICAS
1.1 Objetivos de la aplicacin
El servicio wsDTECor r eo, forma parte del proyecto Documentos Tributarios Electrnicos (DTE), y
corresponde a un servicio que permite a las empresas (contribuyentes) solicitar en forma automtica al SII
el reenvo de los correos con diagnostico de validacin DTE para trackids especficos.
1.2 Caracterstica de la aplicacin
El servicio wsDTECor r eo es de tipo Consulta-Respuesta
Es una aplicacin B2B.
Esta aplicacin puede ser utilizada por aquellos usuarios habilitados para su uso.
Para solicitar un reenvo de correo el contribuyente autenticado, debe tener representacin sobre la
empresa emisora de los documentos.
WS para Reenvo de Correoscon Diagnstico de Validacin DTE
Versin 1.0 10/01/2006
Pgina5 de 10
CAPITULO 2
WSDL de wsDTECorreo
2.1 Gramtica del WSDL
El siguiente cuadro muestra el WSDL del webservice wsDTECor r eo.
2.1.1 WSDL de wsDTECorreo
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
- <wsdl : def i ni t i ons t ar get Namespace=" http://DefaultNamespace"
xml ns =" http://schemas.xmlsoap.org/wsdl/"
xml ns: apachesoap=" http://xml.apache.org/xml-soap"
xml ns: i mpl ="http://DefaultNamespace"
xml ns: i nt f ="http://DefaultNamespace"
xml ns: soapenc=" http://schemas.xmlsoap.org/soap/encoding/"
xml ns: wsdl ="http://schemas.xmlsoap.org/wsdl/"
xml ns: wsdl soap="http://schemas.xmlsoap.org/wsdl/soap/"
xml ns: xsd=" http://www.w3.org/2001/XMLSchema">
- <wsdl : message name="reenvioCorreoRequest" >
<wsdl : par t name=" Token" t ype="xsd:string" / >
<wsdl : par t name=" RutEmpresa" t ype=" xsd:string" / >
<wsdl : par t name=" DvEmpresa" t ype="xsd:string" / >
<wsdl : par t name=" TrackId" t ype=" xsd:string" / >
</ wsdl : message>
<wsdl : message name="getEnvRequest" / >
+ <wsdl : message name="getVersionMayorResponse">
- <wsdl : message name="reenvioCorreoResponse" >
<wsdl : par t name=" reenvioCorreoReturn" t ype=" xsd:string" / >
</ wsdl : message>
<wsdl : message name="getVersionMenorRequest" / >
<wsdl : message name="getVersionMayorRequest" / >
+ <wsdl : message name="getEnvResponse" >
<wsdl : message name="getVersionPatchRequest" / >
+ <wsdl : message name="getVersionMenorResponse">
+ <wsdl : message name="getVersionPatchResponse">
+ <wsdl : por t Type name=" wsDTECorreo" >
+ <wsdl : bi ndi ng name="wsDTECorreoSoapBinding"
t ype="impl:wsDTECorreo" >
+ <wsdl : ser vi ce name="wsDTECorreoService" >
</ wsdl : def i ni t i ons>
Figura 2-1
WS para Reenvo de Correoscon Diagnstico de Validacin DTE
Versin 1.0 10/01/2006
Pgina6 de 10
CAPITULO 3
DETALLE DE PARMETROS DEL SERVICIO
3.1 Parmetros de Entrada
Los parmetros de entrada requeridos por el servicio, se detallan en el siguiente ejemplo:
3.1.1 Ejemplo Real Parmetros de Entrada Formato WSDL
<SOAP-ENV:Envelopexmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-
ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<SOAP- ENV:Body>
<m:reenvioCorreo xmlns:m="http://DefaultNamespace" SOAP-
ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<Token xsi:type="xsd: string">String</Token>
<RutEmpresa xsi:type=" xsd: string">String</ RutEmpresa>
<DvEmpresa xsi:type="xsd: string">String</ DvEmpresa>
<TrackId xsi:type="xsd: string">String</TrackId>
</m:reenvioCorreo>
</SOAP- ENV:Body>
</SOAP- ENV:Envelope>
Figura 3-1
Donde:
Campo Tipo Largo Detalle Obligatorio
Token String Alfanumrico 1-40 El Token es un identificador nico que
identifica a un contribuyente , el cual es
almacenado y enviado al cliente en el
Header del Response de la
Autenticacin Automtica con
Certificado Digital (CD), y permite la
bsqueda de toda la informacin
relacionada a una sesin del cliente.
El contribuyente autenticado debe tener
representacin sobre la empresa
emisora.
S
Rut Empr esa String numrico 1-8 Rut de la Empresa emisora del envio S
DvEmpr esa String Alfanumrico 1-1 Dv del Emisor. S
Tr ackI d String numrico 1-10 Trackid al que se le solicita el reenvo. S
Tabla 3-1
WS para Reenvo de Correoscon Diagnstico de Validacin DTE
Versin 1.0 10/01/2006
Pgina7 de 10
3.2 Parmetros de Salida
La salida del servicio corresponden a un string XML codificado, por lo tanto, es necesario que el
programa cliente sea capaz de decodificar el string y llevarlo a formato original, los campos de retorno
son: ESTADO y GLOSA, ERR_CODE, GLOSA_ERR, NUM_ATENCIN.
3.2.1 Ejemplos de Salida Formato WSDL
<?xml version="1.0" encoding="UTF-8"?>
<SII:RESPUESTA xmlns:SII="http://www.sii.cl/XMLSchema">
<SII:RESP_HDR>
<SII:ESTADO>0</SII: ESTADO>
</SII:RESP_HDR>
<SII:RESP_BODY />
</SII:RESPUESTA>
Figura 3-2 Respuesta Correcta
<?xml version="1.0" encoding="UTF-8"?>
<SII:RESPUESTA xmlns:SII="http://www.sii.cl/XMLSchema">
<SII:RESP_HDR>
<SII:ESTADO>105</SII:ESTADO>
<SII: GLOSA>TRACKID NO EXISTE</SII: GLOSA>
</SII:RESP_HDR>
<SII:RESP_BODY />
</SII:RESPUESTA>
Figura 3-3 Respuesta con error
<?xml version="1.0" encoding="UTF-8"?>
<SII:RESPUESTA xmlns:SII="http://www.sii.cl/XMLSchema">
<SII:RES P_HDR>
<SII:ESTADO>114</SII:ESTADO>
<SII:GLOSA>ENVIO NO HA CONCLUIDO VALIDACION</SII:GLOSA>
</SII:RESP_HDR>
<SII:RESP_BODY />
</SII:RESPUESTA>
Figura 3-4 Respuesta con error, no existe correo para reenvio
Donde:
Campo Tipo Largo Detalle Obligatori os
ESTADO String 1-3 Cdigo Estado de la
operacin
S
GLOSA String Alfanumrico 1-40 En caso de Error indica
una glosa descriptiva del
error.
S
Tabla 3-2
WS para Reenvo de Correoscon Diagnstico de Validacin DTE
Versin 1.0 10/01/2006
Pgina8 de 10
3.3 Valores de Salida
El resultado del requerimiento puede arrojar uno de los siguientes valores:
Estado Tipo Largo Glosa
0 String 1-3 Requerimiento recibido OK.
<> 0 String 1-3 Ha ocurrido un error.
Tabla 3-3
3.4 Valores de estado para salidas con ERROR
3.4.1 Errores de Datos:
El resultado de la consulta puede arrojar uno de los siguientes Estados de Error:
Estado Tipo Largo Glosa
101 String 1-3 Error en dgito verificador del Rut de la
empresa.
102 String 1-3 Faltan datos de entrada
105 String 1-3 Error TrackId no existe
106 String 1-3 Usuario autenticado no tiene permisos sobre
Empresa.
114 String 1-3 Envo solicitado no ha concluido su validacin,
por lo tanto no existe correo.
Tabla 3-4
3.4.2 Errores por Autenticacin:
Estado Tipo Largo Glosa
104 String numrico 1-3 Token Inactivo o No Existe
Tabla 3-5
3.4.3 Otros Errores:
Estado Tipo Largo Glosa
103 String 1-3 Error Interno.
107 String 1-3 Error Interno
108 String 1-3 Error Interno
110 String 1-3 Error Interno
111 String 1-3 Error Interno
112 String 1-3 Error Interno
113 String 1-3 Error Interno
Tabla 3-6
WS para Reenvo de Correoscon Diagnstico de Validacin DTE
Versin 1.0 10/01/2006
Pgina9 de 10
CAPITULO 4
GUIA PARA REALIZAR PRUEBAS
4.1 Prueba del Servicio
Para probar el servicio, se deben seguir los siguientes pasos:
1.- Autenticarse mediante Autenticacin Automtica con Certificado Digital (CD).
Nota: El proceso de la Autenticacin Automtica con CD, permitir obtener un Token, el cul es
requerido como parmetro de entrada por el webservice wsDTECor r eo.
Para la implementacin de la autenticacin, se recomienda ver Manual del Desarrollador
Autenticacin Automtica .
2.- Una vez obtenido el Token, se debe invocar al sitio donde se encuentra el webservice wsDTECor r eo,
ejemplo:
Certificacin : ht t ps: / / maul l i n. si i . cl / DTEWS/ ser vi ces/ wsDTECor r eo?wsdl
Produccin : ht t ps: / / pal ena. si i . cl / DTEWS/ ser vi ces/ wsDTECor r eo?wsdl
3.- Luego, para realizar las pruebas, al WS invocado, se le deben pasar los parmetros de entrada
requeridos por la funcinr eenvi oCor r eo, estos son: Token, Rut Empr esa, DvEmpr esa, Tr ackI d.
4.- Como respuesta del WS se obtiene un XML con los siguientes tags:
ESTADO
GLOSA (solo en caso de error)
WS para Reenvo de Correoscon Diagnstico de Validacin DTE
Versin 1.0 10/01/2006
Pgina10 de 10
REFERENCIAS
Para mayor informacin sobre temas tratados en este manual, se recomienda visitar:
Documentacin WSDL:
ht t p: / / www. w3. or g/ TR/ wsdl
Herramienta XMLSPY :
ht t p: / / www. xml spy. com/ f eat ur es_wsdl . ht ml
Manual del Desarrollador Autenticacin Automtica :
ht t p: / / www. si i . cl / f act ur a_el ect r oni ca/ aut ent i caci on. pdf
Manual de Desarrollador Externo
Consulta Avanzada Estado deDTE
OficinaInformtica Factura Electrnica
Subdireccin Informtica
Servicio Impuestos Internos
Versin : 1.0
Fecha : 03/05/2007
WS de Consulta Avanzada del Estado de un DTE
Versin 1.0 03/05/2007
Subdireccin de Informtica Oficina Factura Electrnica
Pgina : 1 de 13
INDICE
CONTROL DE VERSIONES.................................................................................................................2
INTRODUCCIN.................................................................................................................................3
CAPITULO 1........................................................................................................................................4
OBJ ETIVOS Y CARACTERISTICAS ..................................................................................................4
1.1 OBJ ETIVOS DE LA APLICACIN.......................................................................................................4
1.2 CARACTERSTICA DE LA APLICACIN ..............................................................................................4
CAPITULO 2........................................................................................................................................5
WSDL DE QUERY ESTDTEAV...............................................................................................................5
2.1 GRAMTICA DEL WSDL...............................................................................................................5
CAPITULO 3........................................................................................................................................6
DETALLE DE PARMETROS DE LA FUNCION GETESTDTEAV.............................................................6
3.1 PARMETROS DE ENTRADA..........................................................................................................6
3.2 PARMETROS DE SALIDA.............................................................................................................7
3.2.1 SeccinRESP_HDR...........................................................................................................7
3.2.2 SeccinRESP_BODY.........................................................................................................7
3.3 VALORES DE SALIDA ...................................................................................................................8
3. 3. 1 RESP_HDR/ ESTADO......................................................................................................8
3. 3. 2 RESP_BODY/ RECI BI DO...............................................................................................8
3. 3. 3 RESP_BODY/ ESTADO...................................................................................................8
3.4 EJ EMPLOS DE SALIDA ................................................................................................................9
3.4.1 Documento Recibido y Datos Coinciden............................................................................9
3.4.2 Documento Recibido y Datos No Coinciden.......................................................................9
3.4.3 Error de Autenticacin......................................................................................................9
3.4.4 Error en Parmetros de Entrada......................................................................................10
CAPITULO 4......................................................................................................................................11
GUIA PARA REALIZAR PRUEBAS..................................................................................................11
4.1 PRUEBA DEL SERVICIO ..............................................................................................................11
REFERENCIAS................................................................................................................................. 12
WS de Consulta Avanzada del Estado de un DTE
Versin 1.0 03/05/2007
Subdireccin de Informtica Oficina Factura Electrnica
Pgina : 2 de 13
CONTROL DE VERSIONES
Versin Fecha Motivo
1.0 24-07-2006 Versin Inicial.
WS de Consulta Avanzada del Estado de un DTE
Versin 1.0 03/05/2007
Subdireccin de Informtica Oficina Factura Electrnica
Pgina : 3 de 13
INTRODUCCIN
El servicio Quer yEst Dt eAv, forma parte del proyecto Documentos Tributarios Electrnicos (DTE), y
corresponde a un servicio que permite a las empresas (contribuyentes) consultar en forma automtica por
el estado en que se encuentra un DTE enviado al SII, adems de corroborar los datos asociados al
documento.
La forma de acceder a este servicio es a travs de WSDL
1
(Web Services Definition Language).
El WSDL que se detalla en este documento apunta al ambiente de certificacin del SII, sin embargo este
ambientees una copia fiel del ambiente de produccin.
La ubicacin del WSDL deQuer yEst Dt eAv es:
Certificacin : ht t ps: / / maul l i n. si i . cl / DTEWS/ ser vi ces/ Quer yEst Dt eAv?wsdl
Produccin : ht t ps: / / pal ena. si i . cl / DTEWS/ ser vi ces/ Quer yEst Dt eAv?wsdl
Una vez que el cliente conoce el WSDL del webservice, debe construir un Request en formato SOAP
(Simple Object Access Protocolo), para luego enviarlo hacia el proveedor de servicio (SII), previa
Autenticacin.
Respecto a la Autenticacin, para poder realizar consultas hacia cualquier webservice entregado por el
SII, los clientes deben estar previamente autenticados a travs de la AUTENTICACIN AUTOMATICA.
Este documento est dirigido a quienes tengan la misin de utilizar y probar este servicio.
Requisitos de uso.
Para poder utilizar este manual, es necesario tener previo conocimiento de XML, Web Services y
Certificado Digital.
Recomendaciones.
Se recomienda el uso de la herramienta XMLSPY5 de la Altova ( ht t p: / / www. al t ova. com ).
1
WSDL: Lenguaje descriptor, basado en XML, que permite conocer en forma abstracta, la gramtica de
los componentes de un web service (ubicacin, formato, tipos de datos, servicios, funciones, parmetros
de entrada, salida, etc).
WS de Consulta Avanzada del Estado de un DTE
Versin 1.0 03/05/2007
Subdireccin de Informtica Oficina Factura Electrnica
Pgina : 4 de 13
CAPITULO 1
OBJETIVOS Y CARACTERISTICAS
1.1 Objetivos de la aplicacin
El objetivo de este servicio es entregar una herramienta que permita consultar por el estado de un DTE y
corroborar los datos asociados a dicho DTE.
1.2 Caracterstica de la aplicacin
El servicio Quer yEst Dt eAv, es de tipo Consulta-Respuesta.
Es una aplicacin B2B.
Esta aplicacin puede ser utilizada por aquellos usuarios habilitados para su uso.
Para realizar una consulta el contribuyente autenticado, debe tener representacin sobre la empresa
emisora del documento.
WS de Consulta Avanzada del Estado de un DTE
Versin 1.0 03/05/2007
Subdireccin de Informtica Oficina Factura Electrnica
Pgina : 5 de 13
CAPITULO 2
WSDL de QueryEstDteAv
2.1 Gramtica del WSDL
El siguiente cuadro muestra el WSDL del web serviceQuer yEst Dt eAv.
<?xml ver si on="1. 0" encodi ng=" UTF- 8" ?>
- <wsdl : def i ni t i ons t ar get Namespace="http://DefaultNamespace"
xml ns=" http://schemas.xmlsoap.org/wsdl/"
xml ns: apachesoap=" http://xml.apache.org/xml-soap"
xml ns: i mpl =" http://DefaultNamespace" xml ns: i nt f ="http://DefaultNamespace"
xml ns: soapenc=" http://schemas.xmlsoap.org/soap/encoding/"
xml ns: wsdl =" http://schemas.xmlsoap.org/wsdl/"
xml ns: wsdl soap="http://schemas.xmlsoap.org/wsdl/soap/"
xml ns: xsd="http://www.w3.org/2001/XMLSchema">
+ <wsdl : message name=" getVersionResponse" >
+ <wsdl : message name=" getVersionPatchResponse" >
+ <wsdl : message name=" getVersionMayorResponse" >
- <wsdl : message name="getEstDteAvRequest" >
<wsdl : par t name=" RutEmpresa" t ype=" xsd:string" / >
<wsdl : par t name=" DvEmpresa" t ype=" xsd:string" / >
<wsdl : par t name=" RutReceptor" t ype=" xsd:string" / >
<wsdl : par t name=" DvReceptor" t ype=" xsd:string" / >
<wsdl : par t name=" TipoDte" t ype="xsd:string" / >
<wsdl : par t name=" FolioDte" t ype="xsd:string" / >
<wsdl : par t name=" FechaEmisionDte" t ype=" xsd:string" / >
<wsdl : par t name=" MontoDte" t ype="xsd:string" / >
<wsdl : par t name=" FirmaDte" t ype="xsd:string" / >
<wsdl : par t name=" Token" t ype=" xsd:string" / >
</ wsdl : message>
- <wsdl : message name="getEstDteAvResponse" >
<wsdl : par t name=" getEstDteAvReturn" t ype=" xsd:string" / >
</ wsdl : message>
<wsdl : message name=" getVersionPatchRequest" / >
<wsdl : message name=" getVersionMayorRequest" / >
+ <wsdl : message name=" getVersionMenorResponse" >
<wsdl : message name=" getVersionMenorRequest" / >
<wsdl : message name=" getVersionRequest" / >
+ <wsdl : por t Type name=" QueryEstDteAv">
+ <wsdl : bi ndi ng name=" QueryEstDteAvSoapBinding" t ype=" intf:QueryEstDteAv">
+ <wsdl : ser vi ce name=" QueryEstDteAvService" >
</ wsdl : def i ni t i ons>
Como se muestra en los recuadros del WSDL, el servicio Quer yEst Dt eAv, tiene la funcin
get Est Dt eAv, la que permite realizar la consulta. A continuacin se detallan los parmetros de entrada y
la salida de esta funcin.
WS de Consulta Avanzada del Estado de un DTE
Versin 1.0 03/05/2007
Subdireccin de Informtica Oficina Factura Electrnica
Pgina : 6 de 13
CAPITULO 3
DETALLE DE PARMETROS DE LA FUNCIONgetEstDteAv
3.1 Parmetros de Entrada
Los parmetros de entrada requeridos por el servicio, se detallan en el siguiente cuadro:
<SOAP- ENV:Envelope xmlns:SOAP- ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-
ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<SOAP-ENV:Body>
<m:getEstDteAv xmlns:m="http://DefaultNamespace" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<RutEmpresaxsi:type="xsd:string">String</RutEmpresa>
<DvEmpresaxsi:type="xsd:string">String</DvEmpresa>
<RutReceptor xsi:type="xsd:string">String</RutReceptor>
<DvReceptorxsi:type="xsd:string">String</DvReceptor>
<TipoDte xsi:type="xsd:string">String</TipoDte>
<FolioDte xsi:type="xsd:string">String</FolioDte>
<FechaEmisionDte xsi:type="xsd:string">String</FechaEmisionDte>
<MontoDte xsi:type="xsd:string">String</MontoDte>
<FirmaDte xsi:type="xsd:string">String</FirmaDte>
<Tokenxsi:type="xsd:string">String</Token>
</m:getEstDteAv>
</SOAP- ENV:Body>
</SOAP-ENV:Envelope>
Donde:
Campo Tipo Largo Detalle Obligatorio
Rut Empr esa String numrico 1-8 Rut del Emisor. S
DvEmpr esa String Alfanumrico 1-1 Dv del Emisor. S
Rut Recept or String numrico 1-8 Rut del Receptor. S
DvRecept or String Alfanumrico 1-1 Dv del receptor. S
Ti poDt e String numrico 1-3 Tipo del DTE. S
Fol i oDt e String numrico 1-10 Folio del DTE. S
FechaEmi si onDt e String Date 1-10 Fecha de Emisin del DTE, en formato
DD-MM-AAAA.
S
Mont oDt e String numrico 1-15 Monto Total del DTE. S
Fi r maDt e String Alfanumrico 1-500 Firma del DTE.
Corresponde al tag:
DTE/Signature/SignatureValue del
xml asociado al documento.
S
Token String Alfanumrico 1-40 Identificador nico de autenticacin que
identifica a un contribuyente. Se obtiene
como respuesta de servicio de
Autenticacin Automtica con
Certificado Digital (CD).
S
WS de Consulta Avanzada del Estado de un DTE
Versin 1.0 03/05/2007
Subdireccin de Informtica Oficina Factura Electrnica
Pgina : 7 de 13
3.2 Parmetros de Salida
La salida del servicio corresponde a un string XML codificado. La respuesta esta organizada en dos
secciones:
RESP_HDR
RESP_BODY
3.2.1 Seccin RESP_HDR
Esta seccin entrega el resultado de la operacin a travs de los campos :
Campo Tipo Largo Detalle Obligatorio
ESTADO Numrico 1-2 Indica el resultado de la operacin S
GLOSA String 1-238 En caso de error, breve descripcin del
error
N
3.2.2 Seccin RESP_BODY
Esta seccin entrega el detalle del estado del documento consultado a travs de los campos:
Campo Tipo Largo Detalle Obligatorio
RECI BI DO String 1-2 Indica si el documento fue recibido por el
SII
S
ESTADO String 1-3 Estado en que se encuentra S
GLOSA String 1-238 Descripcin del estado S
TRACKI D Numrico 1-20 Trackid asociado al documento N
NUMATENCI ON String 1-40 Numero de Atencin asociado a la
consulta
S
WS de Consulta Avanzada del Estado de un DTE
Versin 1.0 03/05/2007
Subdireccin de Informtica Oficina Factura Electrnica
Pgina : 8 de 13
3.3 Valores de Salida
Algunos de los campos tienen asociado valores codificados, los que se detallan a continuacin:
3.3.1 RESP_HDR/ESTADO
ESTADO Descripcin
0 Consulta procesada OK.
1 Token inactivo (expirado)
2 Token no existe
3 Error Interno (ver glosa)
4 Error Interno
5 Error parmetros de entrada (ver glosa)
6 Error Interno
7 Error Interno
8 Error Interno
9 Usuario no autorizado en empresa
10 Error Interno
11 Error Interno
12 Error Interno
13 Error Interno
14 Error Interno
3.3.2 RESP_BODY/RECIBIDO
RECIBIDO Descripcin
SI Documento fue recibido por el SII
NO Documento no ha sido recibido por el SII
3.3.3 RESP_BODY/ESTADO
ESTADO Descripcin
EMP Empresa No Autorizada a Emitir Documentos Tributarios Electrnicos
TMD Existe Nota de Dbito que Modifica Textos Documento
TMC Existe Nota de Crdito que Modifica Textos Documento
MMD Existe Nota de Dbito que Modifica Montos Documento
MMC Existe Nota de Crdito que Modifica Montos Documento
AND Existe Nota de Dbito que Anula Documento
ANC Existe Nota de Crdito que Anula Documento
DOK Documento Recibido por el SII. Datos Coinciden con los Registrados
DNK Documento Recibido por el SII pero Datos NO Coinciden con los
registrados
FNA Documento No Autorizado
FAN DocumentoAnulado
FAU Documento No Recibido por el SII
WS de Consulta Avanzada del Estado de un DTE
Versin 1.0 03/05/2007
Subdireccin de Informtica Oficina Factura Electrnica
Pgina : 9 de 13
3.4 Ejemplos de Salida
A continuacin se muestran algunos ejemplos de salidas.
3.4.1 Documento Recibido y Datos Coinciden
<?xml version="1.0" encoding="UTF-8"?>
<SII:RESPUESTA xmlns:SII="http://www.sii.cl/XMLSchema">
<SII:RESP_HDR>
<SII:ESTADO>0</SII:ESTADO>
</SII:RESP_HDR>
<SII:RESP_BODY >
<RECIBIDO>SI</RECIBIDO>
<ESTADO>DOK</ESTADO>
<GLOSA>Documento Recibido por el SII. Datos Coinciden con los Registrados</GLOSA>
<TRACKID>36440</TRACKID>
<NUMATENCION>137416 [25/07/2006 12:08:20]</NUMATENCION>
</SII:RESP_BODY >
</SII:RESPUESTA>
3.4.2 Documento Recibido y Datos No Coinciden
<?xml version="1.0" encoding="UTF-8"?>
<SII:RESPUESTA xmlns:SII="http://www.sii.cl/XMLSchema">
<SII:RESP_HDR>
<SII:ESTADO>0</SII:ESTADO>
</SII:RESP_HDR>
<SII:RESP_BODY >
<RECIBIDO>SI</RECIBIDO>
<ESTADO>DNK</ESTADO>
<GLOSA>Documento Recibido por el SII pero Datos NO Coinciden con los registrados</GLOSA>
<NUMATENCION>137417 [25/07/2006 12:11:03]</NUMATENCION>
</SII:RESP_BODY >
</SII:RESPUESTA>
3.4.3 Error de Autenticacin
<?xml version="1.0" encoding="UTF-8"?>
<SII:RESPUESTA xmlns:SII="http://www.sii.cl/XMLSchema">
<SII:RESP_HDR>
<SII:ESTADO>2</SII:ESTADO>
<SII:GLOSA>Token no existe</SII:GLOSA>
</SII:RESP_HDR>
<SII:RESP_BODY />
</SII:RESPUESTA>
WS de Consulta Avanzada del Estado de un DTE
Versin 1.0 03/05/2007
Subdireccin de Informtica Oficina Factura Electrnica
Pgina : 10 de 13
3.4.4 Error Autenticacin Expirada
<?xml version="1.0" encoding="UTF-8"?>
<SII:RESPUESTA xmlns:SII="http://www.sii.cl/XMLSchema">
<SII:RESP_HDR>
<SII:ESTADO>1</SII:ESTADO>
<SII:GLOSA>Token Inactivo</SII:GLOSA>
</SII:RESP_HDR>
<SII:RESP_BODY />
</SII:RESPUESTA>
3.4.5 Error en Parmetros de Entrada
<?xml version="1.0" encoding="UTF-8"?>
<SII:RESPUESTA xmlns:SII="http://www.sii.cl/XMLSchema">
<SII:RESP_HDR>
<SII:ESTADO>5</SII:ESTADO>
<SII:GLOSA>DV Rut Empresa no corresponde.</SII:GLOSA>
</SII:RESP_HDR>
<SII:RESP_BODY />
</SII:RESPUESTA>
3.4.6 Error de Permisos
<?xml version="1.0" encoding="UTF-8"?>
<SII:RESPUESTA xmlns:SII="http://www.sii.cl/XMLSchema">
<SII:RESP_HDR>
<SII:ESTADO>9</SII:ESTADO>
<SII:GLOSA>Usuario no tiene permiso en empresa</SII:GLOSA>
</SII:RESP_HDR>
<SII:RESP_BODY />
</SII:RESPUESTA>
WS de Consulta Avanzada del Estado de un DTE
Versin 1.0 03/05/2007
Subdireccin de Informtica Oficina Factura Electrnica
Pgina : 11 de 13
CAPITULO 4
GUIA PARA REALIZAR PRUEBAS
4.1 Prueba del Servicio
Para probar el servicio, se deben seguir los siguientes pasos:
1.- Autenticarse mediante Autenticacin Automtica con Certificado Digital (CD).
Nota: El proceso de la Autenticacin Automtica con CD, permitir obtener un Token, el cul es
requerido como parmetro de entrada por el web service Quer yEst Dt eAv.
Para la implementacin de la autenticacin, se recomienda ver Manual del Desarrollador
Autenticacin Automtica .
2.- Una vez obtenido el Token, se debe invocar al sitio donde se encuentra el web service
Quer yEst Dt eAv, ejemplo:
Certificacin : ht t ps: / / maul l i n. si i . cl / DTEWS/ ser vi ces/ Quer yEst Dt eAv?wsdl
Produccin : ht t ps: / / pal ena. si i . cl / DTEWS/ ser vi ces/ Quer yEst Dt eAv?wsdl
3.- Luego, para realizar las pruebas, al WS invocado, se le deben pasar los parmetros de entrada
requeridos por la funcin get Est Dt eAv, estos son: Rut Empr esa, DvEmpr esa, Rut Recept or ,
DvRecept or , Ti poDt e, Fol i oDt e, FechaEmi si onDt e, Mont oDt e, Fi r maDt e, Token.
4.- Como respuesta del WS se obtiene un XML.
WS de Consulta Avanzada del Estado de un DTE
Versin 1.0 03/05/2007
Subdireccin de Informtica Oficina Factura Electrnica
Pgina : 12 de 13
REFERENCIAS
Para mayor informacin sobre temas tratados en este manual, se recomienda visitar:
Documentacin WSDL:
ht t p: / / www. w3. or g/ TR/ wsdl
Herramienta XMLSPY :
ht t p: / / www. xml spy. com/ f eat ur es_wsdl . ht ml
Manual del Desarrollador Autenticacin Automtica :
ht t p: / / www. si i . cl / f act ur a_el ect r oni ca/ aut ent i caci on. pdf
Manual de Desarrollador
Autenticacin Automtica
OI2007_AUTAUTOM_MDE_1.9
Subdireccin Informtica
Servicio Impuestos Internos
Fecha:18/11/2007
SII
WS de Autenticacin con Certificado Digital
INTRODUCCIN................................................................................................................................................ 5
CAPTULO 1....................................................................................................................................................... 6
ANLISIS DEL SISTEMA................................................................................................................................ 6
1.2OBJ ETIVOS DE LA APLICACIN. ...................................................................................................................... 7
1. 3CARACTERSTICA DE LA APLICACIN.............................................................................................................. 7
CAPTULO 2....................................................................................................................................................... 8
VISINGENERAL DEL SISTEMA.................................................................................................................. 8
CAPITULO 3..................................................................................................................................................... 11
WSDL DE AUTENTICIONAUTOMATICA..................................................................................................... 11
3.1.1 WSDL DE CRSEED.J WS ................................................................................................................... 11
3.1.2 WSDL DE GETTOKENFROMSEED.J WS ............................................................................................... 12
CAPTULO 4..................................................................................................................................................... 14
PARMETROS DE ENTRADA..................................................................................................................... 14
4.1.1PARMETROS DE ENTRADA PARACRSEED.J WS ......................................................................................... 14
4.1.2EJ EMPLO REAL PARMETROS DE ENTRADAFORMATO WSDL..................................................................... 14
4.1.3PARMETROS DE ENTRADA PARAGETTOKENFROMSEED.J WS..................................................................... 14
4.1.4EJ EMPLO REAL PARMETROS DE ENTRADAFORMATO WSDL..................................................................... 14
4.1.5EJ EMPLO FORMATO XML DE ENTRADA..................................................................................................... 16
CAPTULO 5..................................................................................................................................................... 17
CAPTULO 5..................................................................................................................................................... 17
PARMETROS DE SALIDA.......................................................................................................................... 17
5.1.1PARMETROS DE SALIDA......................................................................................................................... 17
5.2.1ESTADOS DE SALIDA............................................................................................................................... 17
5.2.2 ESTADOS DE SALIDA DE CRSEED SON:..................................................................................................... 17
5.2.3EJ EMPLOS DE SALIDA............................................................................................................................ 19
5.2.3.1EJ EMPLO PARMETROS DE SALIDAWSDL CODIFICADO CRSEED.J WS ..................................................... 19
FORMATO DECODIFICADO DE LOS PARMETROS DE SALIDACRSEED.J WS............................................................. 19
5.2.3.2EJ EMPLO PARMETROS DE SALIDAWSDL CODIFICADO GETTOKENFROMSEED.J WS................................. 20
CAPTULO 6..................................................................................................................................................... 21
EJ EMPLOS XML DE RESPUESTA.............................................................................................................. 21
6.1EJ EMPLO SALIDA GENERASEMILLA:............................................................................................................. 21
6.1.1 EJ EMPLO DE SALIDA, ESTADO 00(GENERASEMILLA)................................................................................ 21
6.1.2 EJ EMPLO DE SALIDA, ESTADO -1(ERRORNO GENERA SEMILLA) .............................................................. 21
6.1.3 EJ EMPLO DE SALIDA, ESTADO -2(ERROR: BD) ....................................................................................... 21
6.2EJ EMPLO SALIDA GENERATOKEN................................................................................................................ 22
6.2.1 EJ EMPLO DE SALIDA, ESTADO 00(GENERATOKEN).................................................................................. 22
6.2.2EJ EMPLO DE SALIDA, ESTADO 01(ERROR:XML INVALIDO (IOEXCEPTION), FUNCIN VALSIGNEDXML) ............ 22
6.2.3EJ EMPLO DE SALIDA, ESTADO 02(ERROR: XML INVALIDO, (SAXEXCEPTION), FUNCIN VALSIGNEDXML)....... 22
6.2.4EJ EMPLO DE SALIDA, ESTADO 03(ERROR: XML INVALIDO PARSERCONFIGURATIONEXCEPTION), FUNCION
VALSIGNEDXML).............................................................................................................................................. 23
6.2.5EJ EMPLO DE SALIDA, ESTADO 04(ERROR: XML INVALIDO, ELEMENTO SIGNATURENO EXISTE, FUNCION
VALSIGNEDXML).............................................................................................................................................. 23
6.2.6EJ EMPLO DE SALIDA, ESTADO 05(ERROR: XML INVALIDO, FIRMA INVALIDA, FUNCIN VALSIGNEDXML)........... 23
6.2.7EJ EMPLO DE SALIDA, ESTADO 06(ERROR: XML INVALIDO, ELEMENTO SEMILLANO EXISTE, FUNCIN GETSEED)24
6.2.8EJ EMPLO DE SALIDA, ESTADO 07(ERROR(MESSAGEEXCEPTION) ............................................................ 24
6.2.9EJ EMPLO DE SALIDA, ESTADO 08(ERROR:RETORNO)............................................................................. 24
6.2.10EJ EMPLO DE SALIDA, ESTADO 09(ERROR(MESSAGEEXCEPTION)) ......................................................... 25
6.2.11EJ EMPLO DE SALIDA, ESTADO 10(ERROR: RETORNODATOS)........................................................... 25
6.2.12EJ EMPLO DE SALIDA, ESTADO 11(ERROR: XML INVLIDO, ELEMENTO CERTIFICATE NO EXISTE, FUNCIN
GETCERTIFICADO) ........................................................................................................................................... 25
6.2.13EJ EMPLO DE SALIDA, ESTADO 12(ERROR(12) (MESSAGEEXCEPTION)).................................................. 26
6.2.14EJ EMPLO DE SALIDA, ESTADO -3(ERROR EN AUTENTICACIN).................................................................. 26
Versin 1.9 del 18.11.2007 Pg.2de 32
SII
WS de Autenticacin con Certificado Digital
CAPITULO 7..................................................................................................................................................... 27
GUIAPARAREALIZARPRUEBAS .............................................................................................................. 27
CAPITULO 8..................................................................................................................................................... 28
COMO FIRMAR UNASEMILLA ............................................................................................................................. 28
ANEXO 1 .......................................................................................................................................................... 32
1.- EJ EMPLO DE TOKEN.................................................................................................................................. 32
Versin 1.9 del 18.11.2007 Pg.3de 32
SII
WS de Autenticacin con Certificado Digital
CONTROL DE VERSIONES
Versin Fecha
1.0 21/01/2003
1.2 17/02/2003
Se Modifico Introduccin
Se Agrego:
Capitulo 3, Capitulo 4, Capitulo 5
1.3 08/03/2004
Se modifico Url en Capitulo 7 (Gua para
Pruebas, le faltaba la s al http).
Donde deca:
http://palena.sii.cl/DTEWS/CrSeed.jws?
WSDL
http://palena.sii.cl/DTEWS/GetTokenFro
mSeed.jws?WSDL
Se cambio por:
https://palena.sii.cl/DTEWS/CrSeed.jws?
WSDL
https://palena.sii.cl/DTEWS/GetTokenFr
omSeed.jws?WSDL
1.4 08/04/2004
Se modifico texto de introduccin
(como acceder a los WS del SII)
1.5 07/05/2004
Se modifico texto de los mensajes
de salida
1.6 31/05/2004
Se agrego Capitulo 8: Como Firmar
una semilla.
1.7 18/11/2005
Se agrego Error 21, en punto 5.2.2
1.8 03/07/2006 en punto.
Se agrego error 12, en punto 5.2.2
1.9 18/11/2007
Se modifico detalle del errores :
11, 12 y 3 (Captulo 6).
Versin 1.9 del 18.11.2007 Pg.4de 32
SII
WS de Autenticacin con Certificado Digital
INTRODUCCIN
El mtodo de autenticacin automtica (AUTAUTOM), es un chequeo del uso de la
llave privada del certificado del cliente, mediante el uso de Web Services (WS).
Para cumplir su objetivo AUTAUTOM, entrega a las empresas dos Web services
(WS) CrSeed y GetTokenFromSeed, mediante los cuales se podr obtener un
Texto aleatorio o Semilla y un Token (requisitos de la autenticacin), los que sern
detallados ms adelante.
Este documento est dirigido a quienes tengan la misin de utilizar y probar los WS
mencionados anteriormente (CrSeed y GetTokenFromSeed).
Para acceder a los servicios que ofrece el SII, se debe utilizar WSDL(Web Services
Definition Language).
WSDL es un lenguaje descriptor, basado en XML, que permite conocer en forma
abstracta, la gramtica de los componentes de un Web Service (ubicacin, formato,
tipos de datos, servicios, funciones, parmetros de entrada, salida, etc).
Para poder acceder a un WSDL, se debe conocer su ubicacin, por ejemplo el
WSDL de los WS entregados son:
https://palena.sii.cl/DTEWS/CrSeed.jws?WSDL.
https://palena.sii.cl/DTEWS/GetTokenFromSeed.jws?WSDL.
Cuando el cliente conoce el WSDL del servicio, puede construir un Request en
formato SOAP (Simple Object Access Protocolo), para luego enviarlo hacia el
proveedor de servicio.
Requisitos de uso.
Para poder utilizar este manual, es necesario tener previo conocimiento de XML,
Web Services y Certificado Digital.
Recomendaciones: Se recomienda el uso de la herramientaXMLSPY5 de la Altova
GmbH http://www.altova.com
Versin 1.9 del 18.11.2007 Pg.5de 32
SII
WS de Autenticacin con Certificado Digital
CAPTULO 1
ANLISIS DEL SISTEMA
Este sistema permite la implementacin de la Autenticacin Automtica, mediante el
uso de WS y Certificado Digital.
AUTAUTOM es un sistema implementado bajo la tecnologa B2B, que permite que
las aplicaciones se comuniquen entre s con llamadas de programa a programa.
A grandes rasgos la utilizacin de esta aplicacin, requiere que un cliente remoto se
pueda autenticar en el SII mediante Certificado Digital. Para esto es necesario que
dicho cliente solicite a la aplicacin del SII un texto aleatorio llamado Semilla.
Una vez entregada la semillaal cliente, ste deber firmarla y enviarla nuevamente
hacia el sitio del SII, quien se encargar de validar la firma y la vigencia de dicho
texto. Si la validacin es OK, la aplicacin le entrega al cliente un identificador de
autenticacin llamado Token. Dicho identificador, le permitir al cliente navegar por
las otras aplicaciones del SII, sin tener que autenticarse nuevamente.
Versin 1.9 del 18.11.2007 Pg.6de 32
SII
WS de Autenticacin con Certificado Digital
1.1 Quienes pueden utilizar esta aplicacin.
Esta aplicacin puede ser utilizada por todas aquellas Personas o Empresas, que
tengan registrada una clave secreta en las BD del SII.
Actualmente la aplicacin solo permite autenticarse con Certificado Digital Vlido
para el SII.
1.2 Objetivos de la aplicacin.
El objetivo de la aplicacin es dar solucin a la Autenticacin Automtica del SII.
1. 3 Caracterstica de la aplicacin
Autenticacin programa a programa
Autenticacin sin intervencinde humanos por parte de servidor
Desarrollo en base WS
Actualmente slo permite Autenticarse con Certificado Digital
Cliente necesita estar registrado en las bases de datos del SII como un
contribuyente habilitado para ingresar a las aplicaciones de Internet que
requieren autenticacin.
Versin 1.9 del 18.11.2007 Pg.7de 32
SII
WS de Autenticacin con Certificado Digital
CAPTULO 2
VISIN GENERAL DEL SISTEMA
Lado Cliente Lado Web Services
Aplicacin
Usuario
WS
Server
Request Semilla
Response Semilla
Semilla
Datos
Firma
Certificado
Enva Semilla Firmada
Enva Token
GetTokenFromSeed.jws
CrSeed.jws
Si NO OK, genera
Error en XML
Valida Semilla Si Ok
Genera Token
Figura 1.0
Versin 1.9 del 18.11.2007 Pg.8de 32
SII
WS de Autenticacin con Certificado Digital
De acuerdo al diagrama superior (figura 2.0), para que un cliente se pueda
autenticar, lo primero que debe hacer es solicitar una Semilla mediante un Request,
hacia el WS CrSeed.jws.
Cuando el WS recibe el requerimiento, genera automticamente una Semilla en
formato XML.
Una vez que se ha generado una semilla, es almacenada en una base de datos y
luego es enviada al clienteen el Header del Response.
Una Semilla es un nmero nico y aleatorio que sirve como identificador para la
sesin de un cliente y que tiene un time out de 2 (dos) minutos.
Cuando el cliente recibe la Semilla, debe firmarla, para luego enviarla en formato
estndar XML(definido por el SII), hacia nuestro sitio.
Una vez recibida la semilla firmada, se validar su firma y su vigencia.
Si la validacin de la Semilla es OK, se genera automticamente un Token, el cual es
almacenado en una Base de Datos y luego es enviado hacia el cliente.
Un Token es un identificador nico el cual es almacenado y enviado al cliente en el
Body (Cuerpo) del Response.
La generacin del Token la realiza el WS GetTokenFromSeed.jws
Cuando el cliente recibe el Token, ya est Autenticado y puede ingresar a cualquier
aplicacin del SII.
Nota : Ver Ejemplode Token, ANEXO 1
Si la validacin fall, el Web Services enva un mensaje de error en formato XML.
Ver ejemplo Mensaje Error enPunto 4.2
Versin 1.9 del 18.11.2007 Pg.9de 32
SII
WS de Autenticacin con Certificado Digital
La informacin que debe contener el XML que Firma la Semilla (XML Entrada) es:
Semilla
Firma
Mdulo
Certificado Digital
Ver Ejemplo Archivo XML Entrada (Semilla Firmada) en: Punto 3.2
La validacin del XML, consiste en:
Validar que su formato XML este OK (que cumpla formato solicitado por el
SII).
Validar que la Semilla este vigente ( yaque la semilla tiene una duracin de 2
min.).
Validar su certificado Digital.
Validar su firma.
Versin 1.9 del 18.11.2007 Pg.10de 32
SII
WS de Autenticacin con Certificado Digital
CAPITULO 3
WSDL DE AUTENTICION AUTOMATICA
Tal como se menciono anteriormente la AUTAUTOM, entrega dos WS:
CrSeed
GetTokenFromSeed.jws
3.1.1 WSDL de CrSeed.jws
Cr Seed , entrega un solo mtodo get Seed, el cual permite Obtener una Semilla.
La ubicacin del WSDL, para CrSeed.jws es:
ht t ps: / / pal ena. si i . cl / DTEWS/ Cr Seed. j ws?WSDL
<?xml ver si on=" 1. 0" encodi ng="UTF- 8"?>
<wsdl : def i ni t i ons t ar get Namespace=" ht t ps: / / pal ena. si i . cl / DTEWS/ Cr Seed. j ws"
xml ns=" ht t p: / / schemas. xml soap. or g/ wsdl / " xml ns: apachesoap=" ht t p: / / xml . apache. or g/ xml - soap"
xml ns: i mpl =" ht t ps: / / pal ena. si i . cl / DTEWS/ Cr Seed. j ws"
xml ns: i nt f =" ht t ps: / / pal ena. si i . cl / DTEWS/ Cr Seed. j ws"
xml ns: soapenc=" ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
xml ns: wsdl =" ht t p: / / schemas. xml soap. or g/ wsdl / "
xml ns: wsdl soap=" ht t p: / / schemas. xml soap. or g/ wsdl / soap/ "
xml ns: xsd=" ht t p: / / www. w3. or g/ 2001/ XMLSchema">
<wsdl : t ypes/ >
<wsdl : message name=" get SeedRequest ">
</ wsdl : message>
<wsdl : message name=" get SeedResponse">
<wsdl : par t name=" get SeedRet ur n" t ype="xsd: st r i ng"/ >
</ wsdl : message>
<wsdl : por t Type name=" Cr Seed">
<wsdl : oper at i on name=" get Seed">
<wsdl : i nput message=" i mpl : get SeedRequest " name=" get SeedRequest "/ >
<wsdl : out put message=" i mpl : get SeedResponse" name=" get SeedResponse"/ >
</ wsdl : oper at i on>
</ wsdl : por t Type>
<wsdl : bi ndi ng name=" Cr SeedSoapBi ndi ng" t ype=" i mpl : Cr Seed">
<wsdl soap: bi ndi ng st yl e=" r pc" t r anspor t =" ht t p: / / schemas. xml soap. or g/ soap/ ht t p"/ >
<wsdl : oper at i on name=" get Seed">
<wsdl soap: oper at i on soapAct i on=" "/ >
<wsdl : i nput name=" get SeedRequest ">
<wsdl soap: body encodi ngSt yl e="ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
namespace=" ht t ps: / / pal ena. si i . cl / DTEWS/ Cr Seed. j ws" use=" encoded"/ >
</ wsdl : i nput >
<wsdl : out put name=" get SeedResponse">
<wsdl soap: body encodi ngSt yl e="ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
namespace=" ht t ps: / / pal ena. si i . cl / DTEWS/ Cr Seed. j ws" use=" encoded"/ >
</ wsdl : out put >
</ wsdl : oper at i on>
</ wsdl : bi ndi ng>
<wsdl : ser vi ce name=" Cr SeedSer vi ce">
<wsdl : por t bi ndi ng=" i mpl : Cr SeedSoapBi ndi ng" name=" Cr Seed">
<wsdl soap: addr ess l ocat i on=" ht t ps: / / pal ena. si i . cl / DTEWS/ Cr Seed. j ws"/ >
</ wsdl : por t >
</ wsdl : ser vi ce>
</wsdl : def i ni t i ons>
Diagrama 1-1 WSDL CrSeed.j ws
Versin 1.9 del 18.11.2007 Pg.11de 32
SII
WS de Autenticacin con Certificado Digital
3.1.2 WSDL de GetTokenFromSeed.jws
Get TokenFr omSeed, entrega un solo servicio llamado get Token, el cual permite
Obtener un Token.
La ubicacin del WSDL, para GetTokenFromSeed.jws:
ht t ps: / / pal ena. si i . cl / DTEWS/ Get TokenFr omSeed. j ws?WSDL
<?xml ver si on=" 1. 0" encodi ng="UTF- 8" ?>
- <wsdl : def i ni t i ons t ar get Namespace="ht t ps: / / pal ena. si i . cl / DTEWS/ Get TokenFr omSeed. j ws"
xml ns=" ht t p: / / schemas. xml soap. or g/ wsdl / "
xml ns: apachesoap=" ht t p: / / xml . apache. or g/ xml - soap"
xml ns: i mpl =" ht t ps: / / pal ena. si i . cl / DTEWS/ Get TokenFr omSeed. j ws"
xml ns: i nt f =" ht t ps: / / pal ena. si i . cl / DTEWS/ Get TokenFr omSeed. j ws"
xml ns: soapenc=" ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
xml ns: wsdl =" ht t p: / / schemas. xml soap. or g/ wsdl / "
xml ns: wsdl soap=" ht t p: / / schemas. xml soap. or g/ wsdl / soap/ "
xml ns: xsd=" ht t p: / / www. w3. or g/ 2001/ XMLSchema">
<wsdl : t ypes / >
- <wsdl : message name=" get TokenResponse">
<wsdl : par t name="get TokenRet ur n" t ype=" xsd: st r i ng" / >
</ wsdl : message>
- <wsdl : message name=" get Ver si onResponse">
<wsdl : par t name="get Ver si onRet ur n" t ype=" xsd: st r i ng" / >
</ wsdl : message>
<wsdl : message name=" get Ver si onRequest " / >
- <wsdl : message name=" get TokenRequest ">
<wsdl : par t name="pszXml " t ype=" xsd: st r i ng" / >
</ wsdl : message>
- <wsdl : por t Type name=" Get TokenFr omSeed">
- <wsdl : oper at i on name=" get Ver si on">
<wsdl : i nput message=" i mpl : get Ver si onRequest " name="get Ver si onRequest "
/ >
<wsdl : out put message=" i mpl : get Ver si onResponse"
name="get Ver si onResponse" / >
</ wsdl : oper at i on>
- <wsdl : oper at i on name=" get Token" par amet er Or der =" pszXml ">
<wsdl : i nput message=" i mpl : get TokenRequest " name=" get TokenRequest " / >
<wsdl : out put message=" i mpl : get TokenResponse" name=" get TokenResponse" / >
</ wsdl : oper at i on>
</ wsdl : por t Type>
- <wsdl : bi ndi ng name=" Get TokenFr omSeedSoapBi ndi ng" t ype=" i mpl : Get TokenFr omSeed">
<wsdl soap: bi ndi ng st yl e=" r pc"
t r anspor t =" ht t p: / / schemas. xml soap. or g/ soap/ ht t p" / >
- <wsdl : oper at i on name=" get Ver si on">
<wsdl soap: oper at i on soapAct i on=" " / >
- <wsdl : i nput name=" get Ver si onRequest ">
<wsdl soap: body
encodi ngSt yl e=" ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
namespace="ht t ps: / / pal ena. si i . cl / DTEWS/ Get TokenFr omSeed. j ws"
use=" encoded" / >
</ wsdl : i nput >
- <wsdl : out put name=" get Ver si onResponse">
<wsdl soap: body
encodi ngSt yl e=" ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
namespace=" ht t ps: / / pal ena. si i . cl / DTEWS/ Get TokenFr omSeed. j ws"
use=" encoded" / >
</ wsdl : out put >
</ wsdl : oper at i on>
- <wsdl : oper at i on name=" get Token">
<wsdl soap: oper at i on soapAct i on=" " / >
- <wsdl : i nput name=" get TokenRequest ">
<wsdl soap: body
encodi ngSt yl e=" ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
Versin 1.9 del 18.11.2007 Pg.12de 32
SII
WS de Autenticacin con Certificado Digital
namespace="ht t ps: / / pal ena. si i . cl / DTEWS/ Get TokenFr omSeed. j ws"
use=" encoded" / >
</ wsdl : i nput >
- <wsdl : out put name=" get TokenResponse">
<wsdl soap: body
encodi ngSt yl e=" ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
namespace=" ht t ps: / / pal ena. si i . cl / DTEWS/ Get TokenFr omSeed. j ws"
use=" encoded" / >
</ wsdl : out put >
</ wsdl : oper at i on>
</ wsdl : bi ndi ng>
- <wsdl : ser vi ce name=" Get TokenFr omSeedSer vi ce">
- <wsdl : por t bi ndi ng=" i mpl : Get TokenFr omSeedSoapBi ndi ng"
name=" Get TokenFr omSeed">
<wsdl soap: addr ess
l ocat i on=" ht t ps: / / pal ena. si i . cl / DTEWS/ Get TokenFr omSeed. j ws" / >
</ wsdl : por t >
</ wsdl : ser vi ce>
</ wsdl : def i ni t i ons>
Diagrama 1-2 WSDL GetTokenFromSeed.jws
Versin 1.9 del 18.11.2007 Pg.13de 32
SII
WS de Autenticacin con Certificado Digital
CAPTULO 4
PARMETROS DE ENTRADA
4.1.1 Parmetros de Entrada para CrSeed.jws
CrSeed.jws no tiene parmetros deentrada, tal como se detalla en el ejemplo 3.1.2
4.1.2 Ejemplo Real Parmetros de Entrada Formato WSDL
<SOAP- ENV: Envel ope xml ns: SOAP- ENV="ht t p: / / schemas. xml soap. or g/ soap/ envel ope/ " xml ns: SOAP-
ENC="ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
xml ns: xsi ="ht t p: / / www. w3. or g/ 2001/ XMLSchema- i nst ance"
xml ns: xsd="ht t p: / / www. w3. or g/ 2001/ XMLSchema" SOAP-
ENV: encodi ngSt yl e="ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ " >
<SOAP- ENV: Body>
<m: get Seed xml ns: m=" ht t ps: / / pal ena. si i . cl / DTEWS/ Cr Seed. j ws" / >
</ SOAP- ENV: Body>
</ SOAP- ENV: Envel ope>
4.1.3 Parmetros de Entrada para GetTokenFromSeed.jws
Los parmetros de Entrada para GetTokenFromSeed.jws, corresponden a un String
formado por loscampos del XML, que enviara la Semilla Firmada.
4.1.4 Ejemplo Real Parmetros de Entrada Formato WSDL
<SOAP- ENV: Envel ope xml ns: SOAP- ENV="ht t p: / / schemas. xml soap. or g/ soap/ envel ope/ " xml ns: SOAP-
ENC="ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
xml ns: xsi ="ht t p: / / www. w3. or g/ 2001/ XMLSchema- i nst ance"
xml ns: xsd="ht t p: / / www. w3. or g/ 2001/ XMLSchema" SOAP-
ENV: encodi ngSt yl e="ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ " >
<SOAP- ENV: Body>
<m: get Token xml ns: m="ht t ps: / / pal ena. si i . cl / DTEWS/ Get TokenFr omSeed. j ws" >
<pszXml xsi : t ype="xsd: st r i ng" >String</pszXml >
</ m: get Token>
</ SOAP- ENV: Body>
</ SOAP- ENV: Envel ope>
Versin 1.9 del 18.11.2007 Pg.14de 32
SII
WS de Autenticacin con Certificado Digital
Los parmetros de entrada que deben formar el XML para el envo de la Semilla
Firmada son:
Parmetros de Entrada XML:
Etiqueta de inicio
XML
Semilla, es nmero
nico, generado por
nuestro Web Server.
Urls Signature
Corresponde a la
Firma.
Mdulo de la llave
Pblica.
Exponente de la
llave Pblica.
Certificado.X509
<getToken>
<Semilla>1234567890123</ Semilla>
<SignedInfo></ SignedInfo>
<SignatureValue>gfnpbQ8vKMQzAJF/nuQxC/Gg=</SignatureV
alue>
<Modulus>pvzPlABsnc9V4M2Wc+QcI8=</Modulus>
<Exponent>AQAB</Exponent>
<X509Certificate>MlBR08xDjAMBgNVBAcTBUNIRUxFMQww
CgYDVQQtvAfDCCQxMeLAtNJ KWJ DCN199bO5CUiA3iTlr5BEtu
DjmnF5dg6L0z03pXOfoaF9bD3zsgPjMRxYAZP33uj/prVHUv0E9g
U8d/xvdWE21d6AGKGtklmQGSuW8wKogWokKkP
UfKDlmcWkaSAv056hkvzPlABsnc9V4M2Wc+QcI8CAwEAATANB
gkqhkiG9w0BAakRk8i3bCCAakRk8i==</X509Certificate>
Figura 1.3
Versin 1.9 del 18.11.2007 Pg.15de 32
SII
WS de Autenticacin con Certificado Digital
4.1.5 Ejemplo Formato XML de Entrada
Este es un ejemplo del formato XML para el envi de Semilla firmada de acuerdo al
Estndar XML Digital Signature. Los dems nombres y etiquetas son Obligatorios. s.
<?xml ver si on=" 1. 0" ?>
<get Token>
<item>
<Semi l l a>10</ Semi l l a>
</item>
<Signature xml ns=" ht t p: / / www. w3. or g/ 2000/ 09/ xml dsi g#">
<Si gnedI nf o>
<Canoni cal i zat i onMet hod Al gor i t hm=" ht t p: / / www. w3. or g/ TR/ 2001/ REC- xml - c14n- 20010315"/ >
<Si gnat ur eMet hod Al gor i t hm=" ht t p: / / www. w3. or g/ 2000/ 09/ xml dsi g#r sa- sha1"/ >
<Ref er ence URI =" ">
<Tr ansf or ms>
<Tr ansf or mAl gor i t hm=" ht t p: / / www. w3. or g/ 2000/ 09/ xml dsi g#envel oped- si gnat ur e"/ >
</ Tr ansf or ms>
<Di gest Met hod Al gor i t hm=" ht t p: / / www. w3. or g/ 2000/ 09/ xml dsi g#sha1"/ >
<Di gest Val ue>8sl cL05kmr M8NGw4I 9NSf RqYA9E=</ Di gest Val ue>
</ Ref er ence>
</ Si gnedI nf o>
<Si gnat ur eVal ue>j l bzat I I BLW8Aj H++5uVTTr GI MVwGBut uoAR88y/ hvSc1+6/ eW1K864f K3cKi 76oAr qk7l AM4pP
okoXme0J T/ hRXXGo6ecuKzO18z2Wf PWwgnN0f 3ac03TDu7Pwf qi DG9mhQpYf I kNp6GNJ I i ql g9PG2w1f OJ 1Qoypsr QmKq6
YU=</ Si gnat ur eVal ue>
<KeyI nf o>
<KeyVal ue>
<RSAKeyVal ue>
<Modul us>2Pb4kEB19m7NmOUYew9f 36325yr TLTPMU7qzYG2A0/ BsubxDdgQw2Op0x6zXvOVX
sYI 9KkPXt D5or KJ Mj wxYRv9wUWdyi E776Rv4l j f J O7EQhI K1f DQDnPt 0Hef BS06Xzg2QLBvLR+pe1vc6C02Dr 99v+l nLA8
mnZi J l RHndhNU=
</ Modul us>
<Exponent >AQAB</ Exponent >
</ RSAKeyVal ue>
</ KeyVal ue>
<X509Dat a>
<X509Cer t i f i cat e>MI I F1DCCBLygAwI BAgI DAQNt MA0GCSqGSI b3DQEBBQUAMI HGMQswCQYDVQQG
EwJ DTDEYMBYGA1UEChMPQWNl cHRhLmNvbSBTLkEuMTgwNgYDVQQLEy9BdXRv
cml kYWQgY2VydGl maWNhZG9yYSBDbGFzZSAzI HBl cnNvbmEgbmF0dXJ hbDFD
MEEGA1UEAxM6QWNl cHRhLmNvbSBBdXRvcml kYWQgY2VydGl maWNhZG9yYSBD
bGFzZSAzI HBl cnNvbmEgbmF0dXJ hbDEeMBwGCSqGSI b3DQEJ ARYPaW5mb0Bh
Y2VwdGEuY29t MB4XDTAxMDkyNTI xMDgxMl oXDTAyMDkyNTI xMDgxMl owgZ8x
CzAJ BgNVBAYTAkNMMRgwFgYDVQQKEw9BY2VwdGEuY29t I FMuQS4xLDAqBgNV
BAsTI 0Nl cnRpZml j YWRvI ENsYXNl I DMgUGVyc29uYSBOYXR1cmFsMRwwGgYJ
KoZI hvcNAQkBFg1uY2hl bGVAc2l pLmNsMSowKAYDVQQDEyFOSUNPTEFTI FpB
UFJ J QU4gQ0hFTEVCSUZTS0kgQkFFWkEwgZ8wDQYJ KoZI hvcNAQEBBQADgY0A
MI GJ AoGBANj 2+J BAdf ZuzZj l GHsPX9+t 9ucq0y0zzFO6s2Bt gNPwbLm8Q3YE
MNj qdMes17zl V7GCPSpD17Q+aKyi TI 8MWEb/ cFFncohO++kb+J Y3yTuxEI SC
t Xw0A5z7dB3nwUt Ol 84NkCwby0f qXt b3Ogt Ng6/ f b/ pZywPJ p2Yi ZUR53YTV
AgMBAAGj ggJ yMI I Cbj AdBggr BgEEAbVr DwQRFg9BY2VwdGEuY29t I FMuQS4w
J QYDVR0RBB4wHKAaBggr BgEEAcEBAaAOFgwxMC40MTEuODcxLTI wDwYI KwYB
J h0z1DR3Pl 3xOi aFI j SXsQO2PSzcA3wZXYF+KDr Mul 8e5l AF2NNi LmMVt XEx
ZykMaTGGWS0ZETDhJ mBwEZGpP4+l t / J hgwF1Sb6wdr Xp7MFCJ Uc1Tj +/ 5J qH
1kP0E63/ hVEl r cP0g8Zn8Z+vr / PMGW1kKgE0I yS4i J 8eI hNSK5phFyKJ Un0l
BmI ZX7u89d5u7X8=</ X509Cer t i f i cat e>
</ X509Dat a>
</ KeyI nf o>
</ Signature>
</ get Token>
Figura 1.4
Versin 1.9 del 18.11.2007 Pg.16de 32
SII
WS de Autenticacin con Certificado Digital
CAPTULO 5
PARMETROS DE SALIDA
5.1.1 Parmetros de Salida
La salida de los Servicios corresponden a un string XML codificado segn estndar
XML, por lo tanto es necesario que el programa cliente sea capaz de decodificar el
string y llevarlo a formato original - decodificado, los campos de retorno son:
ESTADO, GLOSA, DATOS(SEED o TOKEN)
Donde
Campo Tipo Largo Detalle Obligatorios
ESTADO String Alfanum 1-8 Cdigo Estado
S
GLOSA String Alfanum. 1-1 Detalle Estado
S
DATOS String numrico 1-5 El nombre de este tag, varia
dependiendo de los datos
solicitados(Token, Seed), por ejemplo,
si estamos solicitando Token el tag de
datos se llamara <TOKEN>, lo mismo
para el Seed.
S
Figura 1.5
5.2.1 Estados de Salida
Los Estados de Salida se detallaran dependiendo del WS que corresponda.
5.2.2 Estados de Salida de CrSeed son:
Estado DetalleEstado
00 OK genera Semilla
-1 No se registro lnea en el Archivo de Configuracin
-2 ERROR: RETORNO.
"ERROR RETORNO"
"NO PUEDO CREAR O ACT. TOKEN"
Figura 1.6
Versin 1.9 del 18.11.2007 Pg.17de 32
SII
WS de Autenticacin con Certificado Digital
5.2.2 Los Estados de Salida de GetTokenFromSeed son:
Estado DetalleEstado
00 Token Creado
01 XML Invlido (IOException), funcin valSignedXml
02 XML Invlido (SAXException), funcin valSignedXml
03 XML Invlido (ParserConfigurationException), funcin valSignedXml
04 XML Invlido, elemento Signature no existe, funcin valSignedXml
05 XML Invlido, firma invalida, funcin valSignedXml
06 XML Invlido, elemento Semilla no existe, funcin getSeed
07 ERROR (MessageException).
08 ERROR RETORNO :
" PARAMETROS I NCORRECTOS"
" TI ME- OUT DEL SEED"
" NO GENERA TOKEN f unc: Cr eaToken"
" NO PUEDO ACT. SEED CON TOKEN"
" TI ME- OUT del SEED"
" NO Exi st e SEED"
09 ERROR (MessageException).
10 ERROR RETORNO:
" ERROR RETORNO DATOS"
" NO PUEDO CREAR O ACT. TOKEN"
11 XML Invlido, elemento Certificate no existe, funcin getCertificado
12 ERROR ( 12) ( MessageExcept i on)
21 Firma invalida( La llave pblica no coincide con la del certificado).
-3 Error en Autenticacin
-07 Error (12) parse ERROR en Validacindel RUT (verificar que el usuario se
encuentre registrado en el SII conla opcin de autenticacin mediante
Certificado Digital
Figura 1.7
Versin 1.9 del 18.11.2007 Pg.18de 32
SII
WS de Autenticacin con Certificado Digital
5.2.3 Ej emplos de Salida
A continuacin se mostrar una serie de ejemplos de salida en ambos formatos
Codificado y Decodificado.
5.2.3.1 Ejemplo Parmetros de Salida WSDL Codificado CrSeed.jws
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
<soapenv: Envel ope xml ns: soapenv=" ht t p: / / schemas. xml soap. or g/ soap/ envel ope/ "
xml ns: xsd="ht t p: / / www. w3. or g/ 2001/ XMLSchema" xml ns: xsi ="ht t p: / / www. w3. or g/ 2001/ XMLSchema-
i nst ance" >
<soapenv: Body>
<ns1: get SeedResponse
soapenv: encodi ngSt yl e="ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
xml ns: ns1="ht t ps: / / pal ena. si i . cl / DTEWS/ Cr Seed. j ws" >
<get SeedRet ur n xsi : t ype=" xsd: st r i ng" >&l t ; ?xml ver si on=&quot ; 1. 0&quot ;
encodi ng=&quot ; UTF- 8&quot ; ?&gt ;
&l t ; SI I : RESPUESTA
xml ns: SI I =&quot ; ht t p: / / www. si i . cl / XMLSchema&quot ; &gt ; &l t ; SI I : RESP_HDR&gt ; &l t ; ESTADO&gt ; 00
&l t ; / ESTADO&gt ; &l t ; / SI I : RESP_HDR&gt ; &l t ; SI I : RESP_BODY&gt ; &l t ; SEMI LLA&gt ; 000000000078&l t ; /
S EMI LLA&gt ; &l t ; / SI I : RESP_BODY&gt ; &l t ; / SI I : RESPUESTA&gt ; </ get SeedRet ur n>
</ ns1: get SeedResponse>
</ soapenv: Body>
</ soapenv: Envel ope>
Formato Decodificado de los Parmetros de Salida CrSeed.jws
<SI I : RESPUESTA xml ns: SI I =" http://www.sii.cl/XMLSchema" >
- < > SI I : RESP_HDR
<ESTADO>00</ ESTADO>
</ SI I : RESP_HDR>
- <SI I : RESP_BODY>
<SEMI LLA>000000000078</ SEMI LLA>
</ SI I : RESP_BODY>
</ SI I : RESPUESTA>
Figura 1.8
Versin 1.9 del 18.11.2007 Pg.19de 32
SII
WS de Autenticacin con Certificado Digital
5.2.3.2 Ejemplo Parmetros de Salida WSDL Codificado GetTokenFromSeed.jws
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
<soapenv: Envel ope xml ns: soapenv=" ht t p: / / schemas. xml soap. or g/ soap/ envel ope/ "
xml ns: xsd="ht t p: / / www. w3. or g/ 2001/ XMLSchema" xml ns: xsi ="ht t p: / / www. w3. or g/ 2001/ XMLSchema-
i nst ance" >
<soapenv: Body>
<ns1: get TokenResponse
soapenv: encodi ngSt yl e="ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
xml ns: ns1="ht t p: / / pal ena. si i . cl / DTEWS/ Get TokenFr omSeed. j ws" >
<get TokenRet ur n xsi : t ype="xsd: st r i ng" >&l t ; ?xml ver si on=&quot ; 1. 0&quot ;
encodi ng=&quot ; UTF- 8&quot ; ?&gt ;
&l t ; SI I : RESPUESTA
xml ns: SI I =&quot ; ht t p: / / www. si i . cl / XMLSchema&quot ; &gt ; &l t ; SI I : RESP_HDR&gt ; &l t ; ESTADO&gt ; 00
&l t ; / ESTADO&gt ; &l t ; GLOSA&gt ; Token
Cr eado&l t ; / GLOSA&gt ; &l t ; / SI I : RESP_HDR&gt ; &l t ; SI I : RESP_BODY&gt ; &l t ; TOKEN&gt ; XAuSbYXi Nh9I k&
l t ; / TOKEN&gt ; &l t ; / SI I : RESP_BODY&gt ; &l t ; / SI I : RESPUESTA&gt ; </ get TokenRet ur n>
</ ns1: get TokenResponse>
</ soapenv: Body>
</ soapenv: Envel ope>
5.2.3.4 Ejemplo Parmetros de Salida WSDL Decodificado
GetTokenFromSeed.jws
<SI I : RESPUESTA xml ns: SI I =" http://www.sii.cl/XMLSchema" >
- <SI I : RESP_HDR>
<ESTADO>00</ ESTADO>
<GLOSA>Token Creado</ GLOSA>
</ SI I : RESP_HDR>
- < I I : RESP S _BODY>
<TOKEN>XAuSbYXiNhIk</ TOKEN>
</ SI I : RESP_BODY>
</ SI I : RESPUESTA>
Figura 1.9
Versin 1.9 del 18.11.2007 Pg.20de 32
SII
WS de Autenticacin con Certificado Digital
CAPTULO 6
EJEMPLOS XML DE RESPUESTA
6.1 Ejemplo Salida genera Semilla:
6.1.1 Ejemplo de Salida, Estado 00 (genera Semilla)
<?xml version="1.0" encoding="UTF-8" ?>
- <SII:RESPUESTA xmlns:SII="http://www.sii.cl/xxx">
- <SII:RESP_HDR>
<ESTADO>00</ESTADO>
</SII:RESP_HDR>
- <SII:RESP_BODY>
<SEED>00000000064</SEED>
</SII:RESP_BODY>
</SII:RESPUESTA>
6.1.2 Ejemplo de Salida, Estado -1 (Error No genera Semilla)
<?xml version="1.0" encoding="UTF-8" ?>
- <SII:RESPUESTA xmlns:SII="http://www.sii.cl/xxx">
- <SII:RESP_HDR>
<ESTADO>-1</ESTADO>
<GLOSA>Error : (Message Exception) </GLOSA>
</SII:RESP_HDR>
</SII:RESPUESTA>
6.1.3 Ejemplo de Salida, Estado -2 (Error : BD)
<?xml version="1.0" encoding="UTF-8" ?>
- <SII:RESPUESTA xmlns:SII="http://www.sii.cl/xxx">
- <SII:RESP_HDR>
<ESTADO>-2</ESTADO>
<GLOSA>ERROR RETORNO</GLOSA>
</SII:RESP_HDR>
</SII:RESPUESTA>
Nota: El estado -2, tiene asociado dos errores, detallados en la tabla Estados
de Salida Genera Semilla. Aqu se hace mencin a slo uno de ellos a modo
de ejemplo.
Versin 1.9 del 18.11.2007 Pg.21de 32
SII
WS de Autenticacin con Certificado Digital
6.2 Ejemplo Salida genera Token
6.2.1 Ejemplo de Salida, Estado 00 (genera Token)
<SII:RESPUESTA xmlns:SII="http://www.sii.cl/xxx">
- <SII:RESP_HDR>
<ESTADO>00</ESTADO>
<GLOSA>Token Creado</GLOSA>
</SII:RESP_HDR>
- <SII:RESP_BODY>
<TOKEN /> AB82001ABRT<TOKEN />
</SII:RESP_BODY>
</SII:RESPUESTA>
6.2.2 Ejemplo de Salida, Estado 01 (Error:XML invalido (IOException), funcin
valSignedXml)
<SII:RESPUESTA xmlns:SII="http://www.sii.cl/xxx">
- <SII:RESP_HDR>
<ESTADO>01</ESTADO>
<GLOSA> XML invalido (IOException), funcin valSignedXml</GLOSA>
</SII:RESP_HDR>
</SII:RESPUESTA>
6.2.3 Ejemplo de Salida, Estado 02 (Error: XML invalido, (SAXException),
funcin valSignedXml)
<SII:RESPUESTA xmlns:SII="http://www.sii.cl/xxx">
- <SII:RESP_HDR>
<ESTADO>02</ESTADO>
<GLOSA>XML Invalido (SAXException), funcion valSignedXml</GLOSA>
</SII:RESP_HDR>
</SII:RESPUESTA>
Versin 1.9 del 18.11.2007 Pg.22de 32
SII
WS de Autenticacin con Certificado Digital
6.2.4 Ejemplo de Salida, Estado 03 (Error: XML Invalido
ParserConfigurationException), funcion valSignedXml)
<SII:RESPUESTA xmlns:SII="http://www.sii.cl/xxx">
- <SII:RESP_HDR>
<ESTADO>03</ESTADO>
<GLOSA>XML Invalido (ParserConfigurationException), funcion valSignedXml </GLOSA>
</SII:RESP_HDR>
</SII:RESPUESTA>
6.2.5 Ejemplo de Salida, Estado 04 (Error: XML Invalido, elemento Signature
no existe, funcion valSignedXml)
<SII:RESPUESTA xmlns:SII="http://www.sii.cl/xxx">
- <SII:RESP_HDR>
<ESTADO>04</ESTADO>
<GLOSA>XML Invalido, elemento Signature no existe, funcin valSignedXml </GLOSA>
</SII:RESP_HDR>
</SII:RESPUESTA>
6.2.6 Ejemplo de Salida, Estado 05 (Error: XML Invalido, firma invalida, funcin
valSignedXml)
<SII:RESPUESTA xmlns:SII="http://www.sii.cl/xxx">
- <SII:RESP_HDR>
<ESTADO>05</ESTADO>
<GLOSA>XML Invalido, firma invalida, funcion valSignedXml
</GLOSA>
</SII:RESP_HDR>
</SII:RESPUESTA>
Versin 1.9 del 18.11.2007 Pg.23de 32
SII
WS de Autenticacin con Certificado Digital
6.2.7 Ejemplo de Salida, Estado 06 (Error: XML Invalido, elemento Semilla no
existe, funcin getSeed)
<?xml version="1.0" encoding="UTF-8" ?>
- <SII:RESPUESTA xmlns:SII="http://www.sii.cl/xxx">
- <SII:RESP_HDR>
<ESTADO>06</ESTADO>
<GLOSA> XML Invalido, elemento Semilla no existe, funcin
getSeed</GLOSA>
</SII:RESP_HDR>
</SII:RESPUESTA>
6.2.8 Ejemplo de Salida, Estado 07 (ERROR (MessageException)
<?xml version="1.0" encoding="UTF-8" ?>
- <SII:RESPUESTA xmlns:SII="http://www.sii.cl/xxx">
- <SII:RESP_HDR>
<ESTADO>07</ESTADO>
<GLOSA> ERROR (MessageException)</GLOSA>
</SII:RESP_HDR>
</SII:RESPUESTA>
6.2.9 Ejemplo de Salida, Estado 08 (ERROR:Retorno)
<?xml version="1.0" encoding="UTF-8" ?>
- <SII:RESPUESTA xmlns:SII="http://www.sii.cl/xxx">
- <SII:RESP_HDR>
<ESTADO>08</ESTADO>
<GLOSA> TIME-OUT DEL SEED </GLOSA>
</SII:RESP_HDR>
</SII:RESPUESTA>
Nota : El estado 08, tiene varios errores asociados, los que se detallan en la
tabla Estados de Salida de Genera Token. Aqu se hace mencin a slo uno
de ellos a modo de ejemplo.
Versin 1.9 del 18.11.2007 Pg.24de 32
SII
WS de Autenticacin con Certificado Digital
6.2.10 Ejemplo de Salida, Estado 09 (ERROR (MessageException))
<?xml version="1.0" encoding="UTF-8" ?>
- <SII:RESPUESTA xmlns:SII="http://www.sii.cl/xxx">
- <SII:RESP_HDR>
<ESTADO>09</ESTADO>
<GLOSA> ERROR (MessageException) </GLOSA>
</SII:RESP_HDR>
</SII:RESPUESTA>
6.2.11 Ejemplo de Salida, Estado 10 (ERROR: RETORNO DATOS)
<?xml version="1.0" encoding="UTF-8" ?>
- <SII:RESPUESTA xmlns:SII="http://www.sii.cl/xxx">
- <SII:RESP_HDR>
<ESTADO>10</ESTADO>
<GLOSA> ERROR RETORNO DATOS</GLOSA>
</SII:RESP_HDR>
</SII:RESPUESTA>
6.2.12 Ejemplo de Salida, Estado 11 (ERROR: XML Invlido, elemento
Certificate no existe, funcin getCertificado)
<?xml version="1.0" encoding="UTF-8" ?>
- <SII:RESPUESTA xmlns:SII="http://www.sii.cl/xxx">
<SII:RESP_HDR>
<ESTADO>11</ESTADO>
<GLOSA>XML Invalido, elemento Certificate no existe, funcin getCertificado
</GLOSA>
</SII:RESP_HDR>
</SII:RESPUESTA>
Versin 1.9 del 18.11.2007 Pg.25de 32
SII
WS de Autenticacin con Certificado Digital
6.2.13 Ejemplo de Salida, Estado 12 (ERROR (12) (MessageException))
<?xml version="1.0" encoding="UTF-8" ?>
- <SII:RESPUESTA xmlns:SII="http://www.sii.cl/xxx">
<SII:RESP_HDR>
<ESTADO>12</ESTADO>
<GLOSA>ERROR (12) (MessageException)</GLOSA>
</SII:RESP_HDR>
</SII:RESPUESTA>
6.2.14 Ejemplo de Salida, Estado -3 (Error en Autenticacin)
<?xml version="1.0" encoding="UTF-8" ?>
- <SII:RESPUESTA xmlns:SII="http://www.sii.cl/xxx">
<SII:RESP_HDR>
<ESTADO>-3</ESTADO>
<GLOSA>Error en Autenticacin </GLOSA>
</SII:RESP_HDR>
</SII:RESPUESTA>
Versin 1.9 del 18.11.2007 Pg.26de 32
SII
WS de Autenticacin con Certificado Digital
CAPITULO 7
GUIA PARA REALIZAR PRUEBAS
Para probar los WS de Autenticacin Automtica, se deben seguir los siguientes
pasos:
1.- Para obtener una Semilla, se debe invocar el servicio:
https://palena.sii.cl/DTEWS/CrSeed.jws?WSDL
2.- Firmar Semilla Mediante un Cliente (ver Formato XML Entrada)
3.- Invocando el servicio GetTokenFromSeed.jws, para el envi del XML con las
Semilla Firmada.
https://palena.sii.cl/DTEWS/GetTokenFromSeed.jws?WSDL
4.- Se Obtiene Token
Nota: Si bien en este manual se detalla la autenticacin automtica para el ambiente
de produccin, el procedimiento es el mismopara el ambiente de certificacin, solo
se debe cambiar el nombre del servidor, reemplazando a palena.sii.cl por
maullin.sii.cl.
Por ejemplo:
1.- Para obtener una Semilla en certificacin:
https://maullin.sii.cl/DTEWS/CrSeed.jws?WSDL
2.- Generar un Token
https://maullin.sii.cl/DTEWS/GetTokenFromSeed.jws?WSDL
Versin 1.9 del 18.11.2007 Pg.27de 32
SII
WS de Autenticacin con Certificado Digital
CAPITULO 8
Como firmar una Semilla
Para firmar una semilla, se deben seguir los siguientes pasos:
Obtener una semilla (invocando al WS CrSeed.jws de certificacin o
produccin)
La salida de CrSeed.jws corresponde al siguiente XML:
<?xml ver si on=" 1. 0" encodi ng="UTF- 8" ?>
<SI I : RESPUESTA xml ns: SI I ="http://www.sii.cl/XMLSchema">
<SI I : RESP_BODY>
<SEMI LLA>000002360958</ SEMI LLA>
</ SI I : RESP_BODY>
< > SI I : RESP_HDR
<ESTADO>00</ ESTADO>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
Una vez obtenido el xml, que incluye la semilla, se debe rescatar el campo a
firmar, el campo a firmar corresponde a:
<SEMI LLA>000002360958</ SEMI LLA>
Una vez determinado el campo a firmar, este debe ser entregado al objeto
(getToken), tal como se muestra en la figura 1.10.
<get Token>
<i t em>
<Semi l l a>000002360958</ Semi l l a>
</ i t em>
</ get Token>
Figura 1.10
Versin 1.9 del 18.11.2007 Pg.28de 32
SII
WS de Autenticacin con Certificado Digital
Una vez integrado el objeto getToken con la semilla, se deben realizar los siguientes
pasos.
Aplicar la transformacin y la canonicalizacin a este objeto.(Corresponde a
una funcin interna propia de la librera de firma).
Calcular el hash al objeto, para luego crear el elemento DigestValue
(Corresponde a una funcin interna propia de la librera de firma).
Crear el elemento SignedInfo .(Corresponde a una funcin interna propia de la
librera de firma).
Canonical izar y calcular la firma.(Corresponde a una funcin interna propia
de la librera de firma)
Crear el elemento SignatureValue con el valor de la firma (Corresponde a una
funcin interna propia de la librera de firma)-
Generar la informacin de claves(elemento keyInfo). .(Corresponde a una
funcin interna propia de la librera de firma).
Nota: Estos pasos pueden ser realizados en forma manual o mediante el uso de una
librera)
Versin 1.9 del 18.11.2007 Pg.29de 32
SII
WS de Autenticacin con Certificado Digital
Por ltimo se debe construir el elementoSi gnat ur e que incluye los elementos
Si gnedI nf o, Si gnat ur eVal ue y keyI nf o, tal como se puede observar en la
figura 1.11, el cual comienza con <?xml ver si on="1. 0"?> (todo el elemento debe estar
codificado ejemplo: < por &lt; etc).
<?xml ver si on=" 1. 0" ?>
<get Token>
<i t em>
<Semi l l a>000002248802</ Semi l l a></ i t em>
<Si gnat ur e xml ns="ht t p: / / www. w3. or g/ 2000/ 09/ xml dsi g#" >
<Si gnedI nf o>
<Canoni cal i zat i onMet hod Al gor i t hm="ht t p: / / www. w3. or g/ TR/ 2001/ REC- xml - c14n- 20010315"/ >
<Si gnat ur eMet hod Al gor i t hm="ht t p: / / www. w3. or g/ 2000/ 09/ xml dsi g#r sa- sha1" / >
<Ref er ence URI ="">
<Tr ansf or ms>
<Tr ansf or mAl gor i t hm="ht t p: / / www. w3. or g/ 2000/ 09/ xml dsi g#envel oped- si gnat ur e" / >
</ Tr ansf or ms>
<Di gest Met hod Al gor i t hm=" ht t p: / / www. w3. or g/ 2000/ 09/ xml dsi g#sha1"/ >
<Di gest Val ue>kZvDbar enZxZPbWY7gNLxOan/ NI =</ Di gest Val ue>
</ Ref er ence>
</ Si gnedI nf o>
<Si gnat ur eVal ue>ozuCSQX5uoHzOOI S0V3bRe5WK8MNMzL6pm2dEpRVLDDAqj 8f Gt f Oj PBAOzoY9MHt B9O1Ml 4l pj RYEJ
6+9uAI +g/ mC6PT20wFcOMr 0J 2SmJ ml f +6MkNhoHbf VkGJ 4zxGvCx1Zvt NLAkJ ovFqBl FaaoJ 08Rvkd2Fr SXj RI f +NqUYo=
</ Si gnat ur eVal ue>
<KeyI nf o>
<KeyVal ue>
<RSAKeyVal ue>
<Modul us>
wFgMvA/ vy1BXOBXOWI 5f W/ n45OHf 4g1WYWLvBd68A6vpFl v6bEapsMabeyaQj wa/
UCAt 75dNQdf j STgLxMeKvj uat I t Av4Sq4ncAe5POHRVwu9ezi U+9+LQBa5FemDEM
7pVHj GR1heSAgeI uPBv7j 1TKwv+kRE+i UcYFi KwXH9M=
</ Modul us>
<Exponent >AQAB</ Exponent >
</ RSAKeyVal ue>
</ KeyVal ue>
<X509Dat a>
<X509Cer t i f i cat e>MI I EbDCCA9egAwI BAgI DAgSAMAsGCSqGSI b3DQEBBDCBsTEdMBsGA1UECBQU
UmVnaW9uI E1l dHJ vcG9saXRhbmExETAPBgNVBAcUCFNhbnRpYWdvMSI wI AYD
VQQDFBl FLUNl cnRj aGl sZSBDQSBJ bnRl cm1l ZGl hMTYwNAYDVQQLFC1FbXBy
ZXNhI E5hY2l vbmFsI GRl I ENl cnRpZml j YWNpb24gRWxl Y3Ryb25pY2ExFDAS
BgNVBAoUC0Ut Q0VSVENI SUxFMQswCQYDVQQGEwJ DTDAeFw0wMzA3MTUxODQx
NTJ aFw0wNDA3MTQwMDAwMDBaMI G6MQswCQYDVQQGEwJ DTDEWMBQGA1UECBQN
TWV0cm9wb2xpdGFuYTERMA8GA1UEBxQI U2FudGl hZ28xKDAmBgNVBAoUH1Nl
cnZpY2l vcyBkZSBJ bXB1ZXN0b3MgSW50ZXJ ub3MxGTAXBgNVBAsUEE9maWNp
bmEgSW50ZXJ uZXQxHDAaBgNVBAMUE1p1bGVt YSBPbGd1aW4gVHJ hcm8xHTAb
Bgkqhki G9w0BCQEWDnpvbGd1aW5Ac2l pLmNsMI Gf MA0GCSqGSI b3DQEBAQUA
A4GNADCBi QKBgQDAWAy8D+/ LUFc4Fc5Yj l 9b+f j k4d/ i DVZhYu8F3r wDq+kW
W/ psRqmwxpt 7J pCPBr 9QI C3vl 01B1+NJ OAvEx4q+O5q0i 0C/ hKr i dwB7k84d
FXC717OJ T734t AFr kV6YMQzul UeMZHWF5I CB4i 48G/ uPVMr C/ 6RET6J RxgWI
r Bcf 0wI DAQABo4I Bi TCCAYUwI wYDVR0RBBwwGqAYBggr BgEEAcEBAaAMFgox
MDQ1MDM1NC0zMAwGA1UdEwEB/ wQCMAAwPAYDVR0f BDUwMzAxoC+gLYYr aHR0
cDovL2NybC5l LWNl cnRj aGl sZS5j bC9FY2VydGNoaWxl Q0FJ LmNybDAj BgNV
HRI EHDAaoBgGCCsGAQQBwQECoAwWCj k2OTI 4MTgwLTUwgd8GA1UdI ASB1zCB
1DCB0QYI KwYBBAHDUgUwgcQwLwYI KwYBBQUHAgEWI 2h0dHA6Ly93d3cuZS1j
ZXJ 0Y2hpbGUuY2wvMj AwMC9DUFMvMI GQBggr BgEFBQcCAj CBgxqBgEVsI HRp
dHVsYXI gaGEgc2l kbyB2YWxpZGFkbyBl bi Bmb3J t YSBwcmVzZW5j aWFsLCBx
dWVkYW5kbyBoYWJ pbGl 0YWRvI GVsI ENl cnRpZml j YWRvI HBhcmEgdXNvI HRy
aWJ 1dGFyaW8sI HBhZ29zLCBj b21l cmNpbyB5I G90cm9zMAsGA1UdDwQEAwI E
8DALBgkqhki G9w0BAQQDgYEAka3Y5Vbyj bHwF9sew2+6ZRaL4zI Qgv0Cnd9p
VGYqSVFQz2YK/ AEyasFoWm2evdl o5QJ 8Tj Kqd+Ql I 674t vAumNI ARksCZeUW
hpj dD/ vLp7exQUoVKOCI nQVQQ6LUDAf 6v9vgI B9Mwf 6yTbnxwdvv1Eei LQEBd
2Af 9oF7f VsXKLsY=</ X509Cer t i f i cat e>
</ X509Dat a>
</ KeyI nf o>
</ Si gnat ur e>
</ get Token>
Figura 1.11
Versin 1.9 del 18.11.2007 Pg.30de 32
SII
WS de Autenticacin con Certificado Digital
El elemento Signature, indicado en la figura 1.11, corresponde al parmetro de
entrada requerido por el WS GetTokenFromSeed.jws, que permite generar un token.
Ver punto: 4.1.3 del manual.
https://palena.sii.cl/DTEWS/GetTokenFromSeed.jws?WSDL.
Versin 1.9 del 18.11.2007 Pg.31de 32
SII
WS de Autenticacin con Certificado Digital
Versin 1.9 del 18.11.2007 Pg.32de 32
ANEXO 1
1.- Ejemplo de TOKEN
En este anexo de muestra un ejemplo de un Token
TOKEN=gd43dh6sfE34Kd3
Manual Desarrollador Externo
Envo Automtico Documentos Tributarios
Electrnicos
OI2003_UPDTE_MDE_1.5
Oficina Internet
Subdireccin Informtica
Servicio Impuestos Internos
Fecha:31/10/2003
BORRADOR SII
ENVOAUTOMTICO (WS) DE DTES
Versin 1.3 del 28.07.2003 Pg.2 de16
CONTROL DE VERSIONES...................................................................................................... 3
INTRODUCCIN...................................................................................................................... 4
CAPTULO 1............................................................................................................................. 5
ANLISIS DEL SISTEMA....................................................................................................... 5
1.1 QUIENES PUEDEN UTILIZAR ESTA APLICACIN. ...................................................................... 5
CAPTULO 2............................................................................................................................. 6
VISIN GENERAL ENVO AUTOMTICO DE DTE ................................................................ 6
2.1 LOS TIPOS DE STATUS SON:................................................................................................. 8
2.2 FORMATO DE SALIDA.......................................................................................................... 9
2. REQUERIMIENTOS DEL REQUEST..................................................................................... 11
CAPTULO 3............................................................................................................................ 12
PRUEBAS DE ENVIO ...........................................................................................................12
ANEXO 1.................................................................................................................................13
1.- EJ EMPLO DE TOKEN..........................................................................................................13
ANEXO 2.................................................................................................................................14
1.- FORMATOARCHIVO PARA ENVO PORUPLOAD( XML)..............................................................14
ANEXO 3.................................................................................................................................15
1.- EJ EMPLO ARCHIVO GENERADOS PORCLIENTE CON SU RESPECTIVO HEADER...............................15
ANEXO 4.................................................................................................................................16
PROBLEMAS FRECUENTES DETECTADOS EN LAIMPLEMENTACIN DEL ENVO....................................16
BORRADOR SII
ENVOAUTOMTICO (WS) DE DTES
Versin 1.3 del 28.07.2003 Pg.3 de16
CONTROL DE VERSIONES
CONTROL DE VERSIONES
Versin Fecha Autor Revisor
1.0 27/11/2002 Zulema Olgun T. Quentin Sherman

1.1 12/02/2003 Zulema Olgun T. Quentin Sherman
Se agrego Capitulo 3 (Pruebas
Envo)

1.2 01/04/2003 Zulema Olgun T. Quentin Sherman
Se reemplazo parmetro MSIE
5.5 por PROG 1.0, en
Requerimiento de Requestyen
Anexo 3
El cambio en este parmetro permitir que el
formato de Salida sea en XML
1.3 Zulema Olgun Traro Nicolas Chelebifski
Se modificaron los Tipos de
Status
Se modificaron mensajes de Status
1.4 Zulema Olgun T. Nicolas Chelebifski
Se agrego Anexo 4 Se detallan problemas frecuentes en uso del
manual
1.5 31/10/2003 Zulema Olgun Traro
Se agregaron Status : 7,8,9, ver
punto 2.1
Se agregaron Status 7,8,9
BORRADOR SII
ENVOAUTOMTICO (WS) DE DTES
Versin 1.3 del 28.07.2003 Pg.4 de16
INTRODUCCIN
Estedocumento est dirigido a quienes tengan la misin de implementar el envo
automtico de Documentos Tributarios Electrnicos( DTE).
La misin del programador, ser simular las operaciones de autenticacin,
mediante certificado digital, y el proceso de upload que normalmente son
realizadas por un browser.
En este manual se aborda el proceso de Upload.
Para poder utilizar este manual, es necesario tener previo conocimiento de
Formato RFC1867, XML y Certificado Digital.
Nota : Para implementar el envo de DTE, mediante la Autenticacin Automtica,
se recomienda ver: Manual Desarrollador Ws Autenticacin Automtica con
Certificado Digital (OI2003_AUTAUTOM_MDE_1.2).
BORRADOR SII
ENVOAUTOMTICO (WS) DE DTES
Versin 1.3 del 28.07.2003 Pg.5 de16
CAPTULO 1
ANLISIS DEL SISTEMA
Esta aplicacin, permite a los usuarios el enviar los de documentos tributarios
Electrnicos , mediante upload.
Esta es una aplicacin basada en los mtodos browser programa a programa
1.1Quienes pueden utilizar esta aplicacin.
Esta aplicacin puede ser utilizada por todas aquellas Empresas que requieran
enviar archivos DTE, por Upload.
BORRADOR SII
ENVOAUTOMTICO (WS) DE DTES
Versin 1.3 del 28.07.2003 Pg.6 de16
CAPTULO 2
VISIN GENERAL ENVO AUTOMTICO DE DTE
Figura 2.0
De acuerdo al diagrama superior (figura 2.0), para que un usuario pueda enviar en
forma automtica los archivos DTE, lo primero que debe hacer es autenticarse,
mediante el uso de la Autenticacin Automtica.
Tal como se mencion anteriormente, esta es una aplicacin basada en los
mtodos browser programa a programa, por lo que se debe simular la
autenticacin, tal como si se tratara de una autenticacin por browser.
Usuario
Web Server CGI
DTE
Campos
C1 C2 C3
XML-RFC
Enva DTE Formato
RFC1867
CRL
Autentica-Automtica
Valida Cert. Revocados
Ambiente Usuario
Se genera Token
ChequeaCertificado
Si Ok.
Status, TrackID
XML
RESPUESTA
XML
Ambiente Servidor
BORRADOR SII
ENVOAUTOMTICO (WS) DE DTES
Versin 1.3 del 28.07.2003 Pg.7 de16
La autenticacin valida el certificado y chequea que no est revocado.
Si los datos del certificado no son vlidos, el sistema rechaza la autenticacin.
Si los datos del certificado son vlidos, el Web Server genera en forma automtica
una cookie llamada TOKEN.
Un Token es un identificador nico el cual es almacenado en el Header del
Response, y permite la bsqueda de toda la informacin relacionada a una sesin
del usuario.
Ver Ejemplo Token, ANEXO 1
Cuando la aplicacin Cliente recibe los datos del Response, el usuario puede
enviar su archivo por Upload.
Normalmente el envo de archivos mediante Upload se realiza a travs del
browser, sin embargo como este sistema se basa en el mtodo programa a
programa, la parte browser es reemplazada por una aplicacin Cliente que simula
el tradicional proceso de upload, para lo cual se debe conectar hacia el sitio del
SII mediante Socket.
El archivo que se enviar por upload debe tener formato XML, cuyos campos
deben ser validados contra un archivo Schema entregado por el SII
(EnvioDTE.xsd) y debe cumplir con las normas descritas en los estndares RFC-
1867 ( The Requests for Comments).
Ver ejemplo: Formato Archivo para envo por Upload ANEXO 2
BORRADOR SII
ENVOAUTOMTICO (WS) DE DTES
Versin 1.3 del 28.07.2003 Pg.8 de16
El programa Cliente al momento de hacer upload al archivo DTE (en formato
XML), agrega los datos del Response, incluido el Token en el Header del archivo
y lo enva hacia el sitio del SII.
Ver ejemplo : Archivo Upload generado por Cliente con su Header ANEXO 3
Una vez recibido el archivo DTE, nuestro sistema, genera una salida en formato
XML, que indica el status de la recepcin del archivo.
2.1 Los tipos de Status son:
0 = Upload OK
1 = El Sender no tiene permiso para enviar
2 = Error en tamao del archivo (muy grande o muy chico)
3 = Archivo cortado (tamao <> al parmetro size)
5 = Noest autenticado
6 = Empresa no autorizada a enviar archivos
7= Esquema Invalido
8= Firma del Documento
9= Sistema Bloqueado
Otro = Error Interno.
BORRADOR SII
ENVOAUTOMTICO (WS) DE DTES
Versin 1.3 del 28.07.2003 Pg.9 de16
2.2 Formato de Salida
Como se mencion anteriormente, una vez que el SII, ha recepcionado el archivo
DTE, nuestro sistema genera una respuesta en formato XML, que indica el status
de la recepcin del archivo recibido.
Los Parmetros de Salida son:
Rut y Dv de quien enva
Rut y Dv de la Compaa
Nombre archivo DTE enviado
Fecha, Hora, min., seg, de
recepcin.
Estado de la recepcin del DTE
Indica Nmero de Atencin
<RUTSENDER>1-9</RUTSENDER>
<RUTCOMPANY>3-5</RUTCOMPANY>
<FILE>EnvioEjemplo.xml</FILE>
<TIMESTAMP>2002-11-25 18:51:44</TIMESTAMP>
<STATUS>0</STATUS >
<TRACKID>39</TRACKID>
Ejemplo Formato de Salida, Status 0 (Recepcin OK)
<?xml version="1.0" ?>
- <RECEPCIONDTE>
<RUTSENDER>1- 9</RUTSENDER>
<RUTCOMPANY >3-5</RUTCOMPANY >
<FILE>EnvioEjemplo.xml</FILE>
<TIMESTAMP>2002-11-25 18:51:44</TIMESTAMP >
<STATUS>0</STATUS>
<TRACKID>39</TRACKID>
</RECEPCIONDTE>
Figura 2.1
Nota: De acuerdo a la figura 2.1 ,si la recepcin del archivo DTE, tiene status 0, se
le asigna un TrackID, que corresponde al nmero de atencin o identificador del
envo.
<TRACKID>39</TRACKID>
BORRADOR SII
ENVOAUTOMTICO (WS) DE DTES
Versin 1.3 del 28.07.2003 Pg.10 de16
Ejemplo Formato de Salida, Status 5 (Error Interno (WRT).
<?xml version="1.0" ?>
- <RECEPCIONDTE>
<RUTSENDER>1- 9</RUTSENDER>
<RUTCOMPANY >3-5</RUTCOMPANY >
<FILE>EnvioEjemplo.xml</FILE>
<TIMESTAMP>2002-11-25 18:51:44</TIMESTAMP >
<STATUS>5</STATUS>
</RECEPCIONDTE>
Figura 2.2
Ejemplo Formato de Salida, Status 7 (Eschema invalido).
<RECEPCIONDTE>
<RUTSENDER>07880442-4</RUTSENDER>
<RUTCOMPANY>88888888-8</RUTCOMPANY>
<FILE>ENVFIN_100_sign.xml</FILE>
<TIMESTAMP>2003-10-31 10:04:26</TIMESTAMP>
<STATUS>7</STATUS>
<DETAIL>
<ERROR>LSX-00265: attribute "version" value "3.2" is wrong (must be ".2")
</ERROR>
<ERROR>LSX-00213: only 0 occurrences of particle "sequence", minimum is 1</ERROR>
</DETAIL>
</RECEPCIONDTE>
Figura 2.3
BORRADOR SII
ENVOAUTOMTICO (WS) DE DTES
Versin 1.3 del 28.07.2003 Pg.11 de16
2. REQUERIMIENTOS DEL REQUEST
Como se mencion anteriormente, el programa Cliente, debe incluir en el
header del request lo siguiente:
POST / cgi _dt e/ UPL/ DTEUpl oad HTTP/ 1. 0^M
Accept : i mage/ gi f , i mage/ x- xbi t map, i mage/ j peg, i mage/ pj peg,
appl i cat i on/ vnd. ms - power poi nt , appl i cat i on/ ms- excel ,
appl i cat i on/ mswor d, */ *^M
Ref er er : {URL que referencia a upload Ej.
http://empresaabc.cl/test.html}^M
Accept - Language: es- cl ^M
Cont ent - Type: mul t i par t / f or m- dat a: boundar y={boundary data: Ej. ------
---------------------7d23e2a11301c4}^M
Accept - Encodi ng: gzi p, def l at e^M
User - Agent : Mozi l l a/ 4. 0 ( compat i bl e; PROG 1. 0; Wi ndows NT 5. 0; YComp
5. 0. 2. 4) ^M
Host : {Host Id. Ej: https://maullin.sii.cl}^M
Cont ent - Lengt h: {largo total de mensaje sin Req. Header. Ej.: 10240}^M
Connect i on: Keep- Al i ve^M
Cache- Cont r ol : no- cache^M
Cooki e: TOKEN={Entregado por Autenticacin. Ej.: YZD0II2ApZjlM}^M
^M
Figura 2.3
Nota: El parmetro (PROG 1.0) , encerrado en el circulo, ver Figura 2.3, permitir que
el formato de salida sea en un XML
BORRADOR SII
ENVOAUTOMTICO (WS) DE DTES
Versin 1.3 del 28.07.2003 Pg.12 de16
CAPTULO 3
PRUEBAS DE ENVIO
Para realizar un UPLOAD en forma automtica, el programa cliente debe simular
un Browser, es decir, el programa debe realizar la comunicacin tipo Socket de
TCP/IP con encriptacin de datos SSL. Una vez conectado al sitio, el programa
debe enviar los datos tal como se muestra en ANEXO 3, para lo cul, debe
reemplazar los campos con sus datos correspondientes. Los siguientes son los
datos para realizar la conexin:
1. Host : maullin.sii.cl
2. Puerto : 443
3. Tipo de encriptacin : SSL
BORRADOR SII
ENVOAUTOMTICO (WS) DE DTES
Versin 1.3 del 28.07.2003 Pg.13 de16
ANEXO 1
1.- Ejemplo de TOKEN
TOKEN=gd43dh6sfE34Kd3
Figura 2.4
BORRADOR SII
ENVOAUTOMTICO (WS) DE DTES
Versin 1.3 del 28.07.2003 Pg.14 de16
ANEXO 2
1.- Formato Archivo para envo por Upload ( XML)
<?xml ver si on=" 1. 0" encodi ng=" I SO- 8859- 1" ?>
<Envi oDTE xml ns=" ht t p: / / www. si i . cl / Si i Dt e"
xml ns: xsi =" ht t p: / / www. w3. or g/ 2001/ XMLSchema- i nst ance"
xsi : schemaLocat i on=" ht t p: / / www. si i . cl / Si i Dt e Envi oDTE. xsd"
ver si on=" 1. 0" >
<Set DTE I D=" Set Doc" >

</ Envi oDTE>


Figura 2.5
BORRADOR SII
ENVOAUTOMTICO (WS) DE DTES
Versin 1.3 del 28.07.2003 Pg.15 de16
ANEXO 3
1.- Ejemplo Archivo generados por Cliente Con su respectivo Header
Nota: Lo destacado con rojo corresponde al Header.
POST / cgi _dt e/ UPL/ DTEUpl oad HTTP/ 1. 0^M
Accept : i mage/ gi f , i mage/ x- xbi t map, i mage/ j peg, i mage/ pj peg,
appl i cat i on/ vnd. ms - power poi nt , appl i cat i on/ ms- excel ,
appl i cat i on/ mswor d, */ *^M
Ref er er : {URL que referencia a upload Ej.
http://empresaabc.cl/test.html}^M
Accept - Language: es- cl ^M
Cont ent - Type: mul t i par t / f or m- dat a: boundar y={boundary data: Ej. ------
---------------------7d23e2a11301c4}^M
Accept - Encodi ng: gzi p, def l at e^M
User - Agent : Mozi l l a/ 4. 0 ( compat i bl e; PROG 1. 0; Wi ndows NT 5. 0; YComp
5. 0. 2. 4) ^M
Host : {Host Id. Ej: https://maullin.sii.cl}^M
Cont ent - Lengt h: {largo total de mensaje sin Req. Header. Ej.: 10240}^M
Connect i on: Keep- Al i ve^M
Cache- Cont r ol : no- cache^M
Cooki e: TOKEN={Entregado por Autenticacin. Ej.: YZD0II2ApZjlM}^M
^M
{Comienzo de Multipart/Form-data}
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - 7d23e2a11301c4^M
Cont ent - Di sposi t i on: f or m- dat a; name=" r ut Sender "^M
^M
1^M
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - 7d23e2a11301c4^M
Cont ent - Di sposi t i on: f or m- dat a; name=" dvSender " ^M
^M
9^M
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - 7d23e2a11301c4^M
Cont ent - Di sposi t i on: f or m- dat a; name="r ut Company" ^M
^M
3^M
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - 7d23e2a11301c4^M
Cont ent - Di sposi t i on: f or m- dat a; name=" dvCompany"^M
^M
5^M
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - 7d23e2a11301c4^M
Cont ent - Di sposi t i on: f or m- dat a; name=" ar chi vo"; f i l ename="EnvioEjemplo.xml"^M
Cont ent - Type: t ext / xml ^M
^M
<?xml ver si on="1. 0" encodi ng=" I SO- 8859- 1" ?>^M
<Envi oDTE xml ns=" ht t p: / / www. si i . cl / Si i Dt e" ^M
xml ns: xsi =" ht t p: / / www. w3. or g/ 2001/ XMLSchema- i nst ance" ^M
xsi : schemaLocat i on=" ht t p: / / www. si i . cl / Si i Dt e Envi oDTE. xsd" ^M
ver si on=" 1. 0" >^M
<Set DTE I D=" Set Doc" >^M
.
</ Envi oDTE>^M
^M
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - 7d23e2a11301c4- - ^M
Figura 2.6
BORRADOR SII
ENVOAUTOMTICO (WS) DE DTES
Versin 1.3 del 28.07.2003 Pg.16 de16
ANEXO 4
Problemas Frecuentes Detectados en la Implementacin del Envo.
Algunos de los problemas frecuentes detectados en el envi se relacionan con:
Campo Problema Solucin
boundary Diferencia en la composicin del
boundary (Header y Cuerpo del
Mensaje)
El boundary del Cuerpo del Mensaj e , debe llevar dos
caracteres ms que los caracteres del boundary del
Header.
Adems el boundary, del Final de mensaje, debe llevar dos
guiones al comienzo y dos guiones al final, antes del control M.
Ver Ejemplos.
1-Ejemploboundary: Header
Cont ent - Type: mul t i par t / f or m- dat a:
boundar y=7d23e2a11301c4^M
2-Ejemploboundary: Cuerpo del mensaje, debe tener 2
guiones al inicio.
- - 7d23e2a11301c4^M
3-Ejemploboundary: Final de mensaje, debe llevar dos
guiones del comienzo ms dos adicionales antes del control M.
- - 7d23e2a11301c4- - ^M
Largo del Mensaje El largo del mensaje incluye
datos del Header
El largo del mensaje no debe incluir datos del Header, tal
como se muestra en la figura 2.6 el Header corresponde
a los datos encerrado en el recuadro, la lnea
{Comienzo de Multipart/Form-data},
corresponde a una lnea en blanco, por lo que el inicio
del mensaje comenzara en el primer carcter o guin
despus de{Comienzo de Multipart/Form-data}
Ejemplo:
{Comienzo de Multipart/Form-data}
- - 7d23e2a11301c4^M
Donde el circulo indica el inicio del mensaje.
Host Uso del campo Host en
programas C y que adems
estn utilizando la librera de
OpenSSL
Los programas en lenguaje C, los cuales adems utilizan
la librera OpenSSL, NO deben incluir el Campo
Host .
Control M (^M)
Falta el Control M -Los caracteres Control M (^M), forman parte del archivo,
por lo que estos deben ser enviados.
-La forma de parsear los Control M (^M), depende del de
Cliente:
Si el Cliente es un programa en C++ y utiliza el
obj eto string para la concatenacin, se debe indicar
cada fin de lnea con \r\n, para parsear el^M.
Si el Cliente es un programa en C o C++y utiliza
char, se debe indicar cada fin de lnea con \n.
Manual de Desarrollador Externo
Consulta de Estado de Upload Dte
OI2004_ CEUPDTE _MDE_1.10
Oficina Internet
Subdireccin Informtica
Servicio Impuestos Internos
Fecha: 08/11/2004
1
INDICE
CONTROL DE VERSIONES.................................................................................................................3
INTRODUCCIN.................................................................................................................................4
CAPITULO 1........................................................................................................................................5
OBJ ETIVOS Y CARACTERISTICAS ..................................................................................................5
1. OBJ ETIVOS DE LA APLICACIN............................................................................................................5
2. CARACTERSTICA DE LA APLICACIN ...................................................................................................5
CAPITULO 2........................................................................................................................................6
WSDL DE QUERYESTUP....................................................................................................................6
2.1.1 WSDL DE QUERY ESTUP.J WS .....................................................................................................6
2.1.2 DETALLE PARMETROS DEL WSDL .........................................................................................9
CAPITULO 3......................................................................................................................................10
DETALLE PARMETROS DEL SERVICIO.......................................................................................10
3.1 PARMETROS DE ENTRADA .........................................................................................................10
3.1.1 EJ EMPLO REAL PARMETROS DE ENTRADAFORMATO WSDL..........................................................10
3.2 PARMETROS DE SALIDA .............................................................................................................11
3.3 ESTADOS DE SALIDA ...................................................................................................................11
3.4 EJ EMPLOS DE SALIDA .................................................................................................................12
3.4.1 EJ EMPLO PARMETROS DE SALIDAWSDL CODIFICADO ESTADOEPR............................................12
CAMBIAR SALIDA DEACURDO AEJ EMPLO 3.4.1.1....................................................................................12
3.4.1.1 EJ EMPLO PARMETROS DE SALIDADECODIFICADO.....................................................................12
3.5 ESTADOS DE SALIDA PORERROR..............................................................................................13
3.5.1 Errores de Consulta: ..........................................................................................................13
3.5.2 Errores por Autenticacin: ..................................................................................................14
3.5.3 Otros Errores: ....................................................................................................................14
3.5.1 EJ EMPLODE SALIDAERROR WSDL CODIFICADO (ERR_CODE 2) ..............................................15
3.5.1.1 EJ EMPLO DE SALIDAERROR WSDL DECODIFICADO(ERR_CODE 2: ERROR: DE PROCESO).....15
CAPITULO 4......................................................................................................................................16
EJ EMPLOS DE SALIDA FORMATO XML........................................................................................16
4.1 EJ EMPLOPARMETROS DE SALIDAESTADO RSC (RECHAZADO POR ERROR EN SCHEMA).....................16
4.2 EJ EMPLOPARMETROS DE SALIDAESTADO SOK (SCHEMA VALIDADO)..............................................16
4.3 EJ EMPLOPARMETROS DE SALIDAESTADO CRT (CARATULA OK) .....................................................16
4.4 EJ EMPLOPARMETROS DE SALIDAESTADO RFR (PARAMETROS DE ENTRADA INCOMPLETOS)...............17
4.5 EJ EMPLOPARMETROS DE SALIDAESTADO FOK (ERROR: RETORNO DATOS) ...............................17
4.6 EJ EMPLOPARMETROS DE SALIDAESTADO PRD (ERROR: RETORNO DATOS)....................................17
4.7 EJ EMPLOPARMETROS DE SALIDAESTADO RCT (RECHAZADO POR ERROR ENCARTULA)..................18
4.8 EJ EMPLOPARMETROS DE SALIDAESTADO EPR (ENVO PROCESADO)..............................................18
4.9 EJ EMPLOPARMETROS DE SALIDASRV_CODE 1(ERROR: DE PROCESO).......................................18
4.10 EJ EMPLO PARMETROS DE SALIDAERR_CODE 2(ERROR: DE PROCESO).....................................18
4.11 EJ EMPLO PARMETROS DE SALIDAESTADO-3 (ERROR: RUT USUARIO NO EXISTE) ................19
4.12 EJ EMPLO PARMETROS DE SALIDAESTADO-4(ERROR: OBTENCIN DE DATOS )....................19
4.13 EJ EMPLO PARMETROS DE SALIDAESTADO-5(ERROR: RETORNO DATOS) ...............................19
4.14 EJ EMPLO PARMETROS DE SALIDAESTADO-6(ERROR: USUARIO NO AUTORIZADO) ..............19
4.15 EJ EMPLO PARMETROS DE SALIDAESTADO-7(ERROR: RETORNO DATOS)...............................19
4.16 EJ EMPLO PARMETROS DE SALIDAESTADO-8(ERROR: RETORNO DE DATOS) .........................20
4.17 EJ EMPLO PARMETROS DE SALIDAESTADO-9(ERROR: RETORNO DE DATOS )........................20
4.18 EJ EMPLO PARMETROS DE SALIDAESTADO-10(ERROR: VALIDA RUT)......................................20
2
4.19 EJ EMPLO PARMETROS DE SALIDAESTADO-11(ERROR: CONSULTA) .........................................20
4.20 EJ EMPLO PARMETROS DE SALIDAESTADO-12(ERROR: RETORNO CONSULTA) ......................20
4.21 EJ EMPLOPARMETROS DE SALIDAESTADO-13(ERROR: USUARIO NULO) ................................21
4.22EJ EMPLO PARMETROS DE SALIDAESTADO-14(ERROR: XML RETORNO) ..............................21
4.23 EJ EMPLO PARMETROS DE SALIDAESTADO 002 (ERROR: TOKEN INACTIVO) .............................21
4.24 EJ EMPLO PARMETROS DE SALIDAESTADO 003 (ERROR: TOKEN NO EXISTE)............................21
4.25 EJ EMPLO PARMETROS DE SALIDAESTADO 001 (ECOOKIE INACTIVO)........................................21
CAPITULO 5......................................................................................................................................22
GUIA PARA REALIZAR PRUEBAS..................................................................................................22
REFERENCIAS ..............................................................................................................................23
3
CONTROL DE VERSIONES
CONTROL DE VERSIONES
Versin Fecha Autor Revisor
1.0 29/01/2003 Zulema Olgun T. Quentin Sherman
1.1 24/04/2003 Zulema Olgun T. QuentinSherman
1.3 22/04/2003 Zulema Olgun T. Quentin Sherman
1.4 11/08/2003 Zulema Olgun T.
Se agregaron Estados de salida
1.5 08/04/2004 Zulema Olgun T
Se modifico Url en Capitulo 5 (Gua
para Pruebas, le faltaba la s al http)
Donde deca:
http://maullin.sii.cl/DTEWS/QueryEstUp.j
ws?WSDL
http://maullin.sii.cl/DTEWS/QueryEstUp.j
ws?WSDL
Se cambio por:
https://maullin.sii.cl/DTEWS/QueryEstUp
.jws?WSDL
https://maullin.sii.cl/DTEWS/QueryEstUp
.jws?WSDL
1.6 08/04/2004 Zulema Olgun T.
Se modifico texto de introduccin
(como acceder a los WS del SII)
1.7 07/05/2004 Zulema Olgun T.
Se modifico texto de los mensajes
de salida: 3.5.3 Otros Errores
1.8 15/06/2004 Zulema Olgun T.
Se agrego al XML de salida un
nmero de atencin
(<NUM_ATENCI N>), ver punto3.2
1.9 11/08/2004 Zulema Olgun T.
Se modifica URL WS:
https://maullin.sii.cl/DTEWS/QueryE
stUp.jws?WSDL
1.10 08/11/2004 Zulema Olgun T
Se agrego estado 001 (Cookie
Inactivo), ver punto : 3.5.2
.
4
INTRODUCCIN
Consulta Estado de Upload DTE (CEUPDTE), como parte del proyecto Documentos
Tributarios Electrnicos (DTE), entrega a las empresas un servicio (QueryEstUp), el
cual permite consultar a travs de WEB SERVICES, el estado de un archivo DTE
enviado al SII, mediante Upload.
Este documento est dirigido a quienes tengan la misinde utilizar y probar el servicio
mencionado anteriormente (QueryEstUp).
Para acceder a los servicios que ofrece el SII, se debe utilizar WSDL(Web Services
Definition Language).
WSDL es un lenguaje descriptor, basado en XML, que permite conocer en forma
abstracta, la gramtica de los componentes de un Web Service (ubicacin, formato,
tipos de datos, servicios, funciones, parmetros de entrada, salida, etc).
Para poder acceder a un WSDL, se debe conocer su ubicacin, por ejemplo:
La ubicacin del WSDL, para el ambiente de certificacin de QueryEstUp.jws, es:
https://maullin.sii.cl/DTEWS/QueryEstUp.jws?WSDL.
Cuando el cliente conoce el WSDL del servicio, puede construir un Request en formato
SOAP (Simple Object Access Protocolo), para luego enviarlo hacia el proveedor de
servicio, previa Autenticacin.
Respecto a la Autenticacin, para poder realizar consultas hacia cualquier Web Service
entregado por el SII, los clientes deben estar previamente autenticados a travs de la
AUTENTICACIN AUTOMATICA.
Para la implementacin de la Autenticacin Automtica, es necesario ver Manual de
Desarrollador
Requisitos de uso.
Para poder utilizar este manual, es necesario tener previo conocimiento de XML, Web
Services y Certificado Digital.
Recomendaciones: Se recomienda el uso de la herramientaXMLSPY5 de la Altova
GmbH http://www.altova.com
5
CAPITULO 1
OBJETIVOS Y CARACTERISTICAS
1. Objetivos de la aplicacin
El objetivo de este servicio es informar el Estado de un archivo DTE, enviado mediante
Upload.
2. Caracterstica de la aplicacin
El servicio QueryEstUp, es de tipo Consulta-Respuesta
Es una aplicacin B2B.
Esta aplicacin puede ser utilizada por aquellos usuarios habilitados para su uso.
6
CAPITULO 2
WSDL DE QueryEstUp
La ubicacin del WSDL, para esta aplicacin (QueryEstUp) es:
https://maullin.sii.cl/DTEWS/QueryEstUp.jws?WSDL
2.1.1 WSDL de QueryEstUp.jws
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
<wsdl : def i ni t i ons t ar get Namespace="ht t ps: / / maul l i n. si i . cl / DTEWS/ Quer yEst Up. j ws"
xml ns=" ht t p: / / schemas. xml soap. or g/ wsdl / "
xml ns: apachesoap=" ht t p: / / xml . apache. or g/ xml - soap"
xml ns: i mpl =" ht t ps: / / maul l i n. si i . cl / DTEWS/ Quer yEst Up. j ws"
xml ns: i nt f =" ht t ps: / / maul l i n. si i . cl / DTEWS/ Quer yEst Up. j ws"
xml ns: soapenc=" ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
xml ns: wsdl =" ht t p: / / schemas. xml soap. or g/ wsdl / "
xml ns: wsdl soap="ht t p: / / schemas. xml soap. or g/ wsdl / soap/ "
xml ns: xsd="ht t p: / / www. w3. or g/ 2001/ XMLSchema">
<wsdl : t ypes / >
<wsdl : message name="get Est UpResponse">
<wsdl : par t name=" get Est UpRet ur n" t ype=" xsd: st r i ng" / >
</ wsdl : message>
<wsdl : message name=" get Ver si onMenor Request " / >
<wsdl : message name=" get Ver si onPat chRequest " / >
<wsdl : message name="get Ver si onMayor Response" >
<wsdl : par t name=" get Ver si onMayor Ret ur n" t ype="xsd: st r i ng" / >
</ wsdl : message>
<wsdl : message name=" get Ver si onMayor Request " / >
<wsdl : message name="get Ver si onPat chResponse" >
<wsdl : par t name=" get Ver si onPat chRet ur n" t ype="xsd: st r i ng" / >
</ wsdl : message>
<wsdl : message name="get Est UpRequest " >
<wsdl : par t name=" Rut Compani a" t ype=" xsd: st r i ng" / >
<wsdl : par t name=" DvCompani a" t ype=" xsd: st ri ng" / >
<wsdl : par t name=" Tr ackI d" t ype=" xsd: st r i ng" / >
<wsdl : par t name=" Token" t ype=" xsd: st r i ng" / >
</ wsdl : message>
<wsdl : message name="get Ver si onMenor Response" >
<wsdl : par t name=" get Ver si onMenor Ret ur n" t ype="xsd: st r i ng" / >
</ wsdl : message>
<wsdl : por t Type name=" Quer yEst Up" >
<wsdl : oper at i on name="get Ver si onMayor" >
<wsdl : i nput message="i mpl : get Ver si onMayor Request "
name="get Ver si onMayor Request" / >
<wsdl : out put message="i mpl : get Ver si onMayor Response"
name="get Ver si onMayor Response" / >
</ wsdl : oper at i on>
<wsdl : oper at i on name="get Ver si onMenor" >
<wsdl : i nput message="i mpl : get Ver si onMenor Request "
name="get Ver si onMenor Request" / >
<wsdl : out put message="i mpl : get Ver si onMenor Response"
name="get Ver si onMenor Response" / >
</ wsdl : oper at i on>
<wsdl : oper at i on name="get Ver si onPat ch" >
<wsdl : i nput message="i mpl : get Ver si onPat chRequest "
name="get Ver si onPat chRequest" / >
<wsdl : out put message="i mpl : get Ver si onPat chResponse"
name="get Ver si onPat chResponse" / >
7
</ wsdl : oper at i on>
<wsdl : oper at i on name="get Est Up" par amet er Or der ="Rut Compani a DvCompani a
Tr ackI d Token" >
<wsdl : i nput message="i mpl : get Est UpRequest " name=" get Est UpRequest "
/ >
<wsdl : out put message="i mpl : get Est UpResponse"
name="get Est UpResponse" / >
</ wsdl : oper at i on>
</ wsdl : por t Type>
<wsdl : bi ndi ng name="Quer yEst UpSoapBi ndi ng" t ype="i mpl : Quer yEst Up" >
<wsdl soap: bi ndi ng st yl e=" r pc"
t r anspor t=" ht t p: / / schemas. xml soap. or g/ soap/ ht t p" / >
<wsdl : oper at i on name="get Ver si onMayor" >
<wsdl soap: oper at i on soapAct i on="" / >
<wsdl : i nput name=" get Ver si onMayor Request " >
<wsdl soap: body
encodi ngSt yl e=" ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
namespace=" ht t ps: / / maul l i n. si i . cl / DTEWS/ Quer yEst Up. j ws "
use=" encoded" / >
</ wsdl : i nput >
<wsdl : out put name=" get Ver si onMayor Response" >
<wsdl soap: body
encodi ngSt yl e=" ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
namespace=" ht t ps: / / maul l i n. si i . cl / DTEWS/ Quer yEst Up. j ws "
use=" encoded" / >
</ wsdl : out put >
</ wsdl : oper at i on>
<wsdl : oper at i on name="get Ver si onMenor" >
<wsdl soap: oper at i on soapAct i on="" / >
<wsdl : i nput name=" get Ver si onMenor Request " >
<wsdl soap: body
encodi ngSt yl e=" ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
namespace=" ht t ps: / / maul l i n. si i . cl / DTEWS/ Quer yEst Up. j ws "
use=" encoded" / >
</ wsdl : i nput >
<wsdl : out put name=" get Ver si onMenor Response" >
<wsdl soap: body
encodi ngSt yl e=" ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
namespace=" ht t ps: / / maul l i n. si i . cl / DTEWS/ Quer yEst Up. j ws "
use=" encoded" / >
</ wsdl : out put >
</ wsdl : oper at i on>
<wsdl : oper at i on name="get Ver si onPat ch" >
<wsdl soap: oper at i on soapAct i on="" / >
<wsdl : i nput name=" get Versi onPat chRequest " >
<wsdl soap: body
encodi ngSt yl e=" ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
namespace=" ht t ps: / / maul l i n. si i . cl / DTEWS/ Quer yEst Up. j ws "
use=" encoded" / >
</ wsdl : i nput >
<wsdl : out put name=" get Ver si onPat chResponse" >
<wsdl soap: body
encodi ngSt yl e=" ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
namespace=" ht t ps: / / maul l i n. si i . cl / DTEWS/ Quer yEst Up. j ws "
use=" encoded" / >
</ wsdl : out put >
</ wsdl : oper at i on>
<wsdl : oper at i on name="get Est Up" >
<wsdl soap: oper at i on soapAct i on="" / >
<wsdl : i nput name=" get Est UpRequest " >
<wsdl soap: body
encodi ngSt yl e=" ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
8
namespace=" ht t ps: / / maul l i n. si i . cl / DTEWS/ Quer yEst Up. j ws "
use=" encoded" / >
</ wsdl : i nput >
<wsdl : out put name=" get Est UpResponse" >
<wsdl soap: body
encodi ngSt yl e=" ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
namespace=" ht t ps: / / maul l i n. si i . cl / DTEWS/ Quer yEst Up. j ws "
use=" encoded" / >
</ wsdl : out put >
</ wsdl : oper at i on>
</ wsdl : bi ndi ng>
<wsdl : ser vi ce name="Quer yEst UpSer vi ce" >
<wsdl : por t bi ndi ng=" i mpl : Quer yEst UpSoapBi ndi ng" name="Quer yEst Up" >
<wsdl soap: addr ess
l ocat i on=" ht t ps: / / maul l i n. si i . cl / DTEWS/ Quer yEst Up. j ws" / >
</ wsdl : por t>
</ wsdl : ser vi ce>
</ wsdl : def i ni t i ons>
Figura 2.1.1
9
2.1.2 Detalle Parmetros del WSDL
De acuerdo a lo destacado en el recuadro del esquema WSDL figura 2.1.1,
Quer yEst Up entrega slo un servicio get Est Up, el cual requiere de los siguientes
parmetros de entrada: Rut, Dv, TrackId y Token.
10
CAPITULO 3
DETALLE PARMETROS DEL SERVICIO
3.1 Parmetros de Entrada
Los parmetros de entrada requeridos por el servicio, se detallan en el siguiente
ejemplo:
3.1.1 Ejemplo Real Parmetros de Entrada Formato WSDL
<SOAP- ENV: Envel ope xml ns: SOAP-
ENV=" ht t p: / / schemas. xml soap. or g/ soap/ envel ope/ " xml ns: SOAP-
ENC=" ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
xml ns: xsi ="ht t p: / / www. w3. or g/ 2001/ XMLSchema- i nst ance"
xml ns: xsd="ht t p: / / www. w3. or g/ 2001/ XMLSchema" SOAP-
ENV: encodi ngSt yl e=" ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ ">
<SOAP- ENV: Body>
<m: get Est Up xml ns: m=" ht t ps: / / maul l i n. si i . cl / DTEWS/ Quer yEst Up. j ws " >
<Rut xsi : t ype="xsd: st r i ng" ></ Rut >
<Dv xsi : t ype=" xsd: st r i ng" ></ Dv>
<Tr ackI d xsi : t ype=" xsd: st r i ng" ></ Tr ackI d>
<Token xsi : t ype=" xsd: st r i ng" ></ Token>
</ m: get Est Up>
</ SOAP- ENV: Body>
</ SOAP- ENV: Envel ope>
Donde:
Campo Tipo Largo Detalle Obligatorios
Rut String numrico 1-8 Corresponde al Rut Consultado
S
Dv String Alfanumrico 1-1 Corresponde al DV del Rut
Consultado
S
Tr ackI d String numrico 1-10 Corresponde al identificador de
Envi(similar al nmero de
atencin o folio)
S
Token String Alfanumrico 1-40 Es un Token es un identificador
nico el cual es almacenado y
enviado al cliente en el Header del
Response de la Autenticacin
Automtica con Certificado
Digital (CD), y permite la
bsqueda de toda la informacin
relacionada a una sesin del
cliente.
S
11
3.2 Parmetros de Salida
La salida del Servicio corresponden a un string XML codificado, por lo tanto necesario
que el programa cliente sea capaz de decodificar el string y llevarlo a formato original,
los campos de retorno son: TRACKID, ESTADO y GLOSA, NUM_ATENCIN.
Donde:
Campo Tipo Largo Detalle Obligatorios
TRACKI D String numrico
1-10
identificador de Envi(similar al
nmero de atencin o folio)
S
ESTADO String numrico
1-3
Cdigo Estado
S
GLOSA String Alfanumrico
1-40
Detalle Cdigo
S
NUM_ATENCI ON String 1-40 Nmero de Atencin,
Identificador de la consulta
S
3.3 Estados de Salida
El resultado de la consulta puede arrojar uno de los siguientes Estados:
Estado Tipo Glosa
RSC String Rechazado por Error en Schema
SOK String Schema Validado
CRT
String numrico
Cartula OK
RFR
String numrico
Rechazado por Error en Firma
FOK
String numrico
Firma de Envi Validada
PDR
String numrico
Envi en Proceso
RCT
String numrico
Rechazado por Error en Cartula
EPR
String numrico
Envi Procesado
12
3.4 Ej emplos de Salida
A continuacin se mostrar una serie de ejemplos de salida en ambos formatos
Codificado y Decodificado.
3.4.1 Ejemplo Parmetros de Salida WSDL Codificado Estado EPR
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
<soapenv: Envel ope xml ns: soapenv="ht t p: / / schemas. xml soap. or g/ soap/ envel ope/ "
xml ns: xsd=" ht t p: / / www. w3. or g/ 2001/ XMLSchema" xml ns: xsi ="ht t p: / / www. w3. or g/ 2001/ XMLSchema-
i nst ance">
<soapenv: Body>
<ns1: get Est UpResponse
soapenv: encodi ngSt yl e="ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ "
xml ns: ns1=" ht t ps: / / maul l i n. si i . cl / DTEWS/ Quer yEst Up. j ws " >
<get Est UpRet ur n xsi : t ype =" xsd: st r i ng" >&l t ; ?xml ver si on=&quot ; 1. 0&quot ;
encodi ng=&quot ; UTF- 8&quot ; ?&gt ;
&l t ; SI I : RESPUESTA
xml ns: SI I =&quot ; ht t p: / / www. si i . cl / XMLSchema&quot ; &gt ; &l t ; SI I : RESP_HDR&gt ; &l t ; TRACKI D&gt ; 5329
2&l t ; / TRACKI D&gt ; &l t ; ESTADO&gt ; EPR&l t ; / ESTADO&gt ; &l t ; GLOSA&gt ; Envi o
Pr ocesado&l t ; / GLOSA&gt ; &l t ; / SI I : RESP_HDR&gt ; &l t ; SI I : RESP_BODY&gt ; &l t ; TI PO_DOCTO&gt ; 56&l t ; / TI
PO_DOCTO&gt ; &l t ; I NFORMADOS&gt ; 1&l t ; / I NFORMADOS&gt ; &l t ; ACEPTADOS&gt ; 0&l t ; / ACEPTADOS&gt ; &l t ; RE
CHAZADOS&gt ; 1&l t ; / RECHAZADOS&gt ; &l t ; REPAROS&gt ; 0&l t ; / REPAROS&gt ; &lt;NUM_ATENCION&gt;532 (
2004/06/14
16:44:20)&lt;/NUM_ATENCION&gt;&l t ; / SI I : RESP_BODY&gt ; &l t ; / SI I : RESPUESTA&gt ; </ get Est UpRet ur n>
</ ns1: get Est UpResponse>
</ soapenv: Body>
</ soapenv: Envel ope>
Cambiar salida deacurdo a Ejemplo 3.4.1.1
3.4.1.1 Ejemplo Parmetros de Salida Decodificado
<?xml version="1.0" encoding="UTF-8" ?>
- <SII:RESPUESTA xmlns:SII="http://www.sii.cl/XMLSchema">
- <SII:RESP_HDR>
<TRACKID>53292</TRACKID>
<ESTADO>EPR</ESTADO>
<GLOSA>Envio Procesado</GLOSA>
</SII:RESP_HDR>
- <SII:RESP_BODY>
<TIPO_DOCTO>56</TIPO_DOCTO>
<INFORMADOS>1</INFORMADOS>
<ACEPTADOS>0</ACEPTADOS>
<RECHAZADOS>1</RECHAZADOS>
<REPAROS>0</REPAROS>
<NUM_ATENCION>532 ( 2004/06/14 16:44:20) </NUM_ATENCION>
</SII:RESP_BODY>
</SII:RESPUESTA>
13
3.5 Estados de Salida por ERROR
El resultado de la consulta puede arrojar uno de los siguientes Estados de Error:
3.5.1 Errores de Consulta:
SRV_CODE
SQL_CODE
ERR_CODE
Donde:
SRV_CODE Tipo Largo Glosa
0 String numrico 1-1 Todo Ok
1 String numrico 1-1 Error en Entrada
2 String numrico 1-1 Error SQL
SQL_CODE Tipo Largo Glosa
0 String numrico 1-2 Schema Validado
OTRO String numrico 1-2 Cdigo de Oracle
ERR_CODE Tipo Largo Glosa
0 String numrico 1-1 Se retorna el estado
1 String numrico 1-1 El envo no es de la Empresa, faltan
parmetros de entrada.
2 String numrico 1-1 Error de Proceso
14
3.5.2 Errores por Autenticacin:
TOKEN Tipo Largo Glosa
001 String 1-3 Cookie Inactivo(o Token Inactivo)
002 String 1-3 Token Inactivo
003 String 1-3 Token No Existe
3.5.3 Otros Errores:
ESTADO Tipo Largo Glosa
- 1 String numrico 1-1
ERROR: RETORNO CAMPO ESTADO, NO
EXISTE
- 2 String numrico 1-1
ERROR RETORNO
- 3 String numrico 1-1
ERROR: RUT USUARIO NO EXISTE
- 4 String numrico 1-1
ERROR OBTENCION DE DATOS
- 5 String numrico 1-1
ERROR RETORNO DATOS
- 6 String numrico 1-1
ERROR: USUARIO NO AUTORIZADO
- 7 String numrico 1-1
ERROR RETORNO DATOS
- 8 String numrico 1-1
ERROR: RETORNO DATOS
- 9 String numrico 1-1
ERROR: RETORNO DATOS
- 10 String numrico 1-2
ERROR: VALIDA RUT USUARIO
- 11 String numrico 1-2
ERR_CODE, SQL_CODE, SRV_CODE
- 12 String numrico 1-2
ERROR: RETORNO CONSULTA
- 13 String numrico 1-2
ERROR RUT USUARIO NULO
- 14 String numrico 1-2
ERROR XML RETORNO DATOS
Ot r os
15
3.5.1 Ej emplode Salida ERROR WSDL Codificado(ERR_CODE 2)
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
<soapenv: Envel ope xml ns: soapenv=" ht t p: / / schemas. xml soap. or g/ soap/ envel ope/ "
xml ns: xsd=" ht t p: / / www. w3. or g/ 2001/ XMLSchema"
xml ns: xsi =" ht t p: / / www. w3. or g/ 2001/ XMLSchema- i nst ance" >
<soapenv: Body>
<ns1: get Est UpResponse
soapenv: encodi ngSt yl e=" ht t p: / / schemas. xml soap. or g/ soap/ encodi ng/ " xml ns: ns1="
ht t ps: / / maul l i n. si i . cl / DTEWS/ Quer yEst Up. j ws " >
<get Est UpRet ur n xsi : t ype=" xsd: st r i ng" >&l t ; ?xml ver si on=&quot ; 1. 0&quot ;
encodi ng=&quot ; UTF- 8&quot ; ?&gt ;
&l t ; SI I : RESPUESTA
xml ns: SI I =&quot ; ht t p: / / www. si i . cl / XMLSchema&quot ; &gt ; &l t ; SI I : RESP_HDR&gt ; &l t ; E
STADO&gt ; -
1&l t ; / ESTADO&gt ;&lt;ERR_CODE&gt;2&lt;/ERR_CODE&gt; &l t ; SQL_CODE/ &gt ; &l t ; SRV_COD
E/ &gt ; &l t ; / SI I : RESP_HDR&gt ; &lt;NUM_ATENCION&gt;532 ( 2004/06/14
16:44:20)&lt;/NUM_ATENCION&gt;&l t ; / SI I : RESPUESTA&gt ; </ get Est UpRet ur n>
</ ns1: get Est UpResponse>
</ soapenv: Body>
</ soapenv: Envel ope>
3.5.1.1 Ejemplo de Salida ERROR WSDL Decodificado (ERR_CODE 2: ERROR: De
proceso)
<?xml version="1.0" encoding="UTF-8" ?>
- <SII:RESPUESTA xmlns:SII="http://www.sii.cl/XMLSchema">
- <SII:RESP_HDR>
<ESTADO>-1</ESTADO>
<ERR_CODE>2</ERR_CODE>
<SQL_CODE />
<SRV_CODE />
</SII:RESP_HDR>
<NUM_ATENCION>532 ( 2004/06/14 16:44:20)</NUM_ATENCION>
</SII:RESPUESTA>
16
CAPITULO 4
EJEMPLOS DE SALIDA FORMATO XML
En este captulo, se muestran los ejemplos de los posibles Estados de Salida de la
aplicacin.
4.1 Ejemplo Parmetros de Salida Estado RSC (Rechazado por Error en Schema)
<SI I : RESPUESTA xml ns: SI I =" http://www.sii.cl/XMLSchema" >
- <SI I : RESP_HDR>
<ESTADO>RSC</ ESTADO>
<GLOSA>Rechazado por Error en Schema</ GLOSA >
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20)</NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.2 Ejemplo Parmetros de Salida Estado SOK (Schema Validado)
<SI I : RESPUESTA xml ns: SI I =" http://www.sii.cl/XMLSchema" >
- <SI I : RESP_HDR>
<ESTADO>SDK</ ESTADO>
<GLOSA >Schema Validado</ GLOSA >
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20)</NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.3 Ej emplo Parmetros de Salida Estado CRT(Caratula OK)
<SI I : RESPUESTA xml ns: SI I =" http://www.sii.cl/XMLSchema" >
- <SI I : RESP_HDR>
<ESTADO>CRT</ ESTADO>
<GLOSA >Caratula OK</ GLOSA >
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20)</NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
17
4.4 Ejemplo Parmetros de Salida Estado RFR (Parametros de Entrada
Incompletos)

- <SI I : RESPUESTA xml ns: SI I ="http://www.sii.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>RFR</ ESTADO>
<GLOSA>Rechazado por Error en Firma</ GLOSA>
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20)</NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.5 Ejemplo Parmetros de Salida Estado FOK (Error: RETORNO DATOS)

- <SI I : RESPUESTA xml ns: SI I ="http://www.sii.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>05</ ESTADO>
<GLOSA>Error: RETORNO DATOS</ GLOSA>
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20)</NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.6 Ejemplo Parmetros de Salida Estado PRD (Error: Retorno Datos)

- <SI I : RESPUESTA xml ns: SI I ="http://www.sii.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>PRD</ ESTADO>
<GLOSA>Error Retorno Datos</ GLOSA>
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20)</NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
18
4.7 Ejemplo Parmetros de Salida Estado RCT (Rechazado por Error en Cartula)
- <SI I : RESPUESTA xml ns: SI I ="http://www.sii.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>RCT</ ESTADO>
<GLOSA>Rechazado por Error en Cartula</ GLOSA>
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20)</NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.8 Ejemplo Parmetros de Salida Estado EPR (Envo Procesado)

<SI I : RESPUESTA xml ns: SI I =" http://www.sii.cl/XMLSchema" >
- <SI I : RESP_HDR>
<TRACKI D>251</ TRACKI D>
<ESTADO>EPR</ ESTADO>
<GLOSA>Envio Procesado</ GLOSA>
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20)</NUM_ATENCI ON>
</ SI I : RESP_HDR>
- <SI I : RESP_BODY>
<TI PO_DOCTO>33</ TI PO_DOCTO>
<I NFORMADOS>1</ I NFORMADOS>
<ACEPTADOS>1</ ACEPTADOS>
<RECHAZADOS>0</ RECHAZADOS>
<REPAROS>0</ REPAROS>
</ SI I : RESP_BODY>
</ SI I : RESPUESTA>
4.9 Ejemplo Parmetros de SalidaSRV_CODE 1(ERROR: De proceso)
<SI I : RESPUESTA xml ns: SI I =" http://www.sii.cl/XMLSchema" >
- <SI I : RESP_HDR>
<ESTADO>-11</ ESTADO>
<ERR_CODE/ >
<SQL_CODE / >
<SRV_CODE/ >1</ ERR_CODE>
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20)</NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.10 Ej emplo Parmetros de Salida ERR_CODE 2(ERROR: De proceso)
<SI I : RESPUESTA xml ns: SI I =" http://www.sii.cl/XMLSchema" >
- <SI I : RESP_HDR>
<ESTADO>-11</ ESTADO>
<ERR_CODE>2</ ERR_CODE>
<SQL_CODE / >
<SRV_CODE / >
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20)</NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
19
4.11 Ejemplo Parmetros de Salida ESTADO-3 (ERROR: RUT USUARIO NO EXISTE )
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
- <SI I : RESPUESTA xml ns: SI I ="http://www.sii.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>- 3</ ESTADO>
<GLOSA>ERROR : RUT USUARIO NO EXISTE </ GLOSA>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.12 Ejemplo Parmetros de Salida ESTADO-4(ERROR: OBTENCIN DE DATOS )
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
- <SI I : RESPUESTA xml ns: SI I ="http://www.sii.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>- 4</ ESTADO>
<GLOSA>ERROR : OBTENCIN DE DATOS </ GLOSA>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA
4.13 Ejemplo Parmetros de Salida ESTADO-5(ERROR: RETORNO DATOS)
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
- <SI I : RESPUESTA xml ns: SI I ="http://www.sii.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>- 5</ ESTADO>
<GLOSA>ERROR : RETORNO DE DATOS</ GLOSA>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA
4.14 Ejemplo Parmetros de Salida ESTADO-6(ERROR: USUARIO NO AUTORIZADO)
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
- <SI I : RESPUESTA xml ns: SI I ="http://www.sii.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>- 6</ ESTADO>
<GLOSA>ERROR :USUARIO NO AUTORIZADO</ GLOSA>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA
4.15 Ejemplo Parmetros de Salida ESTADO-7(ERROR: RETORNO DATOS)
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
- <SI I : RESPUESTA xml ns: SI I ="http://www.sii.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>- 7</ ESTADO>
<GLOSA>ERROR: RETORNO DATOS </ GLOSA>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA
20
4.16 Ejemplo Parmetros de Salida ESTADO-8(ERROR: RETORNO DE DATOS)
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
- <SI I : RESPUESTA xml ns: SI I ="http://www.sii.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>- 8</ ESTADO>
<GLOSA>ERROR: RETORNO DE DATOS </ GLOSA>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.17 Ejemplo Parmetros de Salida ESTADO-9(ERROR: RETORNO DE DATOS )
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
- <SI I : RESPUESTA xml ns: SI I ="http://www.sii.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>- 9</ ESTADO>
<GLOSA>ERROR: RETORNO DE DATOS </ GLOSA>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA
4.18 Ejemplo Parmetros de Salida ESTADO-10(ERROR: VALIDA RUT)
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
- <SI I : RESPUESTA xml ns: SI I ="http://www.sii.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>- 10</ ESTADO>
<GLOSA>ERROR: VALIDA RUT </ GLOSA>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA
4.19 Ejemplo Parmetros de Salida ESTADO-11(ERROR: CONSULTA)
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
- <SI I : RESPUESTA xml ns: SI I =" ht t p: / / www. si i . cl / XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>-11</ ESTADO>
<ERR_CODE>1</ ERR_CODE>
<SQL_CODE>0</ SQL_CODE>
<SRV_CODE>0</ SRV_CODE>
<NUM_ATENCI ON>555 ( 2004/06/15 12:46:08)</ NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.20 Ejemplo Parmetros de Salida ESTADO-12(ERROR: RETORNO CONSULTA)
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
- <SI I : RESPUESTA xml ns: SI I ="http://www.sii.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>- 12</ ESTADO>
<GLOSA>ERROR: RETORNO DATOS </ GLOSA>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA
21
4.21 Ejemplo Parmetros de Salida ESTADO-13(ERROR: USUARIO NULO)
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
- <SI I : RESPUESTA xml ns: SI I ="http://www.sii.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>- 13</ ESTADO>
<GLOSA>ERROR: RUT USUARIO</ GLOSA>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA
4.22 Ej emplo Parmetros de Salida ESTADO-14 (ERROR: XML RETORNO)
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
- <SI I : RESPUESTA xml ns: SI I =" ht t p: / / www. si i . cl / XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>-14</ ESTADO>
<GLOSA>ERROR: XML RETORNO</ GLOSA>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.23 Ejemplo Parmetros de Salida Estado 002 (ERROR: TOKEN INACTIVO)
- <SI I : RESPUESTA xml ns: SI I ="http://www.sii.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>002</ ESTADO>
<GLOSA>TOKEN+INACTIVO</ GLOSA>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.24 Ejemplo Parmetros de Salida Estado 003 (ERROR: TOKEN NO EXISTE)
- <SI I : RESPUESTA xml ns: SI I ="http://www.sii.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>003</ ESTADO>
<GLOSA>NO+EXISTE</ GLOSA>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.25 Ejemplo Parmetros de Salida Estado 001 (ECOOKIE INACTIVO)
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
<SI I : RESPUESTA xml ns: SI I =" http://www.sii.cl/XMLSchema" >
<SI I : RESP_HDR>
<ESTADO>001</ ESTADO>
<GLOSA>COOKIE INACTIVO</ GLOSA>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
22
CAPITULO 5
GUIA PARA REALIZAR PRUEBAS
Para probar el servicio, se deben seguir los siguientes pasos:
1.- Autenticarsemediante Autenticacin Automtica con Certificado Digital(CD).
El proceso de la Autenticacin Automtica con CD, permitir obtener un Token, el cul
es requerido como parmetro de Entrada por la aplicacin (QueryEstUp).
Para la implementacin de la Autenticacin Automtica, se recomienda ver Manual del
Desarrollador Ws Autenticacin con Certificado Digital .
2.- Una vez obtenido el Token(de acuerdo a lo detallado ms arriba en paso 1), se debe
invocar al sitio de Certificacin, en donde se encuentrael WS para QueryEstUp:
https://maullin.sii.cl/DTEWS/QueryEstUp.jws?WSDL
3.- Luego, para realizar las pruebas, se le deben pasar los parmetros de entrada de la
consulta, Rut, Dv, TrackID y Token.
4.- Se obtiene Respuesta.
TRACKI D
ESTADO
GLOSA
NUM_ATENCI N
TI PO_DOCTO ( Solo si Estado es EPR)
I NFORMADOS ( Solo si Estado es EPR)
ACEPTADOS ( Solo si Estado es EPR)
RECHAZADOS ( Solo si Estado es EPR)
REPAROS ( Solo si Estado es EPR)
Nota: El ambiente de produccin, es idntico al de certificacin, solo cambia el nombre del servidor, tal
como se indica ms abajo.
https://palena.sii.cl/DTEWS/QueryEstUp.jws?WSDL
23
REFERENCIAS
Para mayor informacin sobre temas tratados en este manual, se recomienda visitar:
Documentacin WSDL: http://www.w3.org/TR/wsdl
Herramienta XMLSPY : http://www.xmlspy.com/features_wsdl.html
Manual de Desarrollador Externo
Consulta de Estado DTE
OI2004_CEDTE_MDE_1.10
Oficina Internet
Subdireccin Informtica
Servicio Impuestos Internos
Fecha:22/12/2010
1
INDICE
CONTROL DE VERSIONES .......................................................................................................................... 3
INTRODUCCIN............................................................................................................................................ 4
CAPITULO 1 .................................................................................................................................................. 6
OBJ ETIVOS Y CARACTERISTICAS .......................................................................................................... 6
1. OBJ ETIVOS DE LA APLICACIN .................................................................................................................... 6
2. CARACTERSTICA DE LA APLICACIN ........................................................................................................... 6
CAPITULO 2 .................................................................................................................................................. 7
WSDL DE QUERYESTDTE ............................................................................................................................ 7
2.1GRAMTICA DEL WSDL ........................................................................................................................... 7
2.1.1 WSDL DE QUERYESTDTE.J WS ........................................................................................................ 7
2.1.2 DETALLE PARMETROS DEL WSDL ................................................................................................ 9
CAPITULO 3 ................................................................................................................................................ 10
DETALLE PARMETROS DEL SERVICIO .............................................................................................. 10
3.1 PARMETROS DE ENTRADA .................................................................................................................. 10
3.1.1EJ EMPLO REAL PARMETROS DE ENTRADAFORMATO WSDL .............................................................. 10
3.2 PARMETROS DE SALIDA ...................................................................................................................... 12
3.3 VALORES DE SALIDA ............................................................................................................................. 12
3.4EJ EMPLOS DE SALIDA .......................................................................................................................... 13
3.4.1EJ EMPLO PARMETROS DE SALIDAWSDL CODIFICADO...................................................................... 13
FIGURA3-5 ................................................................................................................................................. 13
3.4.1.1EJ EMPLO PARMETROS DE SALIDADECODIFICADO .......................................................................... 13
FIGURA3-6 ................................................................................................................................................. 13
3.5 VALORES DE SALIDA POR ERROR ...................................................................................................... 14
3.5.1 Errores de Consulta: ................................................................................................................... 14
3.5.2 Errores porAutenticacin: .......................................................................................................... 16
3.5.3OTROS ERRORES:................................................................................................................... 16
TABLA3-11 .................................................................................................................................................. 16
3.5.1EJ EMPLO DE SALIDAERROR WSDL CODIFICADO (ERR_CODE 1) ................................................. 17
FIGURA3-12............................................................................................................................................... 17
3.5.1.1EJ EMPLO DE SALIDAERRORWSDL DECODIFICADO (ERR_CODE 1: DOCUMENTO RECIBIDO POR EL
SII PERO DATOS NOCOINCIDEN CON LOS REGISTRADOS) ............................................................................ 17
FIGURA3-13............................................................................................................................................... 17
CAPITULO 4 ................................................................................................................................................ 18
EJ EMPLOS DE SALIDA FORMATOXML ............................................................................................... 18
4.1EJ EMPLO PARMETROS DE SALIDAERR_CODE, ESTADO DOK (DTE RECIBIDO) ........................... 18
4.2EJ EMPLO PARMETROS DE SALIDAERR_CODE, ESTADO DNK (DOCUMENTOS RECIBIDOS, DATOS NO
COINCIDEN) ............................................................................................................................................... 18
4.3EJ EMPLO PARMETROS DE SALIDAERR_CODE, ESTADO FAU(DTE NO RECIBIDO) ........................... 18
4.4 EJ EMPLO PARMETROS DE SALIDAERR_CODE, ESTADO FNA (DTE NO RECIBIDO ) ....................... 19
4.5 EJ EMPLO PARMETROS DE SALIDAERR_CODE, ESTADO FAN (DOCUMENTO ANULADO ) ................ 19
4.6 EJ EMPLO PARMETROS DE SALIDAERR_CODE, ESTADO EMP(EMPRESA NO AUTORIZADA ... ) ........ 19
4.7 EJ EMPLO PARMETROS DE SALIDAERR_CODE, ESTADO TMD (EXISTE NOTA DE DEBITO ... ) ........ 20
4.8 EJ EMPLO PARMETROS DE SALIDAERR_CODE, ESTADO TMC(EXISTE NOTA DE CRDITO ... ) ........ 20
4.9 EJ EMPLO PARMETROS DE SALIDAERR_CODE, ESTADO MMD(EXISTE NOTA DE DEBITO ... ) .......... 20
4.10 EJ EMPLO PARMETROS DE SALIDAERR_CODE, ESTADO NNC(EXISTE NOTA DE CRDITO ... ) ...... 21
4.11 EJ EMPLO PARMETROS DE SALIDAERR_CODE, ESTADO AND(EXISTE NOTA DE DEBITO... ).......... 21
2
4.12 EJ EMPLO PARMETROS DE SALIDAERR_CODE, ESTADO ANC (EXISTE NOTA DE CRDITO... ) ..... 21
4.13EJ EMPLO PARMETROS DE SALIDATOKEN ESTADO 002(ERROR: TOKEN INACTIVO) ................... 22
4.14EJ EMPLO PARMETROS DE SALIDATOKEN ESTADO 003(ERROR: TOKEN NO EXISTE) ................... 22
4.15EJ EMPLO PARMETROS DE SALIDATOKEN ESTADO 003(ERROR: TOKEN NO EXISTE) ................... 22
4.16EJ EMPLO PARMETROS DE SALIDAOTROS ERRORES 1(ERROR: RETORNO CAMPOESTADO,
NO EXISTE) ............................................................................................................................................. 22
4.17EJ EMPLO PARMETROS DE SALIDAOTROS ERRORES 2(ERRORRETORNO) ............................... 22
4.18EJ EMPLO PARMETROS DE SALIDAOTROS ERRORES 3(ERRORRETORNO) ............................... 23
CAPITULO 5 ................................................................................................................................................ 24
GUIAPARAREALIZARPRUEBAS .......................................................................................................... 24
REFERENCIAS ........................................................................................................................................ 25
3
CONTROL DE VERSIONES
CONTROL DE VERSIONES
Versin Fecha Cambio
1.0 29/01/2003
1.1 17/03/2003 Se agrego Log QuryEstDte_yyyymm.log
1.2 28/05/2003
- Se modifico lista de Estados de salida de la
aplicacin.
- Se modificaron Ejemplos en XML
1.3 11/08/2003 Se Agregaron Otros Estados de Errores y sus
respectivas salidas en XML
1.4 08/03/2004 Se modifico Url en Capitulo 5 (Gua para Pruebas, le
faltaba la s al http)
Donde deca:
http://maullin.sii.cl/DTEWS/QueryEstDte.jws?WSDL
Se cambio por:
https://maullin.sii.cl/DTEWS/QueryEstDte.jws?WSDL
1.5 08/04/2004 Se modifico texto de introduccin (como acceder a los
WS del SII)
1.6 07/05/2004 Se modifico texto de los mensajes de salida : 3.5.3
1.7 14/06/2004 Se agrego al XML de salida un nmero de atencin
(<NUM_ATENCIN>), ver punto3.2
1.8 08/11/2004 Se agrego estado 001 (Cookie Inactivo), ver punto :
3.5.2
1.9 12/11/2004 Se modifico largo estado Glosa, ver punto 3.2
1.10 22/12/2010 Se cambia estado: NNC por MMC
4
INTRODUCCIN
Consulta Estado DTE, como parte del proyecto Documentos Tributarios Electrnicos
(DTE), permite consultar el estado de un DTE.
Existen dos maneras de realizar la consulta de estado de un DTE:
Consulta Mediante Web Service (WS)
Consulta Mediante pgina Web
En este manual solo abordar el tema relacionado con la consulta mediante Web
Services.
Para acceder a la consultamediante pgina web, se debe ingresar ala pgina principal
del SII (http://www.sii.cl), donde encontrar el link : Factura Electrnica
Por lo tanto, este documento est dirigido a quienes tengan la misin de utilizar y probar
el Web Services de consulta estado DTE (QueryEstDte.jws).
Para acceder a los servicios que ofrece el SII, se debe utilizar WSDL(Web Services
Definition Language).
WSDL es un lenguaje descriptor, basado en XML, que permite conocer en forma
abstracta, la gramtica de los componentes de un Web Service (ubicacin, formato,
tipos de datos, servicios, funciones, parmetros de entrada, salida, etc).
Para poder acceder a un WSDL, se debe conocersu ubicacin, la ubicacin del WSDL
que se detalla en este documento apunta al ambiente de certificacin del SII, sin
embargo este ambientees una copia fiel del ambiente de produccin.
La ubicacin del WSDL de QueryEstDte.jws es:
https://maullin.sii.cl/DTEWS/QueryEstDte.jws?WSDL
5
Una vez que el cliente conoce el WSDL del WS, puede construir un Request en formato
SOAP (Simple Object Access Protocolo), para luego enviarlo hacia el proveedor de
servicio, previa Autenticacin.
Respecto a la Autenticacin, para poder realizar consultas hacia cualquier Web Service
entregado por el SII, los clientes deben estar previamente autenticados a travs de la
AUTENTICACIN AUTOMATICA.
Para la implementacin de la Autenticacin Automtica, es necesario ver Manual de
Desarrollador
Requisitos de uso.
Para poder utilizar este manual, es necesario tener previo conocimiento de XML, Web
Services y Certificado Digital.
Recomendaciones: Se recomienda el uso de la herramientaXMLSPY5 de la Altova
GmbH http://www.altova.com
6
CAPITULO 1
OBJETIVOS Y CARACTERISTICAS
1. Objetivos de la aplicacin
El objetivo de este servicio es informar el Estado de un DTE.
2. Caracterstica de la aplicacin
El servicio QueryEstDte.jws, es de tipo Consulta -Respuesta
Es una aplicacin B2B.
Esta aplicacin puede ser utilizada por aquellos usuarios habilitados para su uso.
7
CAPITULO 2
WSDL de QueryEstDte
2.1 Gramtica del WSDL
En el siguiente ejemplo se detallan los parmetros utilizados por el WSDL de
QueryEsDte.jws.
2.1.1 WSDL de QueryEstDte.jws
<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions targetNamespace="https://maullin.sii.cl/DTEWS/QueryEstDte.jws" xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:apachesoap="http://xml.apache.org/xml-soap" xmlns:impl="https://maullin.sii.cl/DTEWS/QueryEstDte.jws"
xmlns:intf="https://maullin.sii.cl/DTEWS/QueryEstDte.jws" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<wsdl:types/>
<wsdl:message name="getEstDteRequest">
<wsdl:part name="RutConsultante" type="xsd:string"/>
<wsdl:part name="DvConsultante" type="xsd:string"/>
<wsdl:part name="RutCompania" type="xsd:string"/>
<wsdl:part name="DvCompania" type="xsd:string"/>
<wsdl:part name="RutReceptor" type="xsd:string"/>
<wsdl:part name="DvReceptor" type="xsd:string"/>
<wsdl:part name="TipoDte" type="xsd:string"/>
<wsdl:part name="FolioDte" type="xsd:string"/>
<wsdl:part name="FechaEmisionDte" type="xsd:string"/>
<wsdl:part name="MontoDte" type="xsd:string"/>
<wsdl:part name="Token" type="xsd:string"/>
</wsdl:message>
<wsdl:message name="getEstDteResponse">
<wsdl:part name="getEstDteReturn" type="xsd:string"/>
</wsdl:message>
<wsdl:portType name="QueryEstDte">
<wsdl:operation name="getEstDte" parameterOrder="RutConsultante DvConsultante RutCompania DvCompania
RutReceptor DvReceptor TipoDte FolioDte FechaEmisionDte MontoDte Token">
<wsdl:input message="impl:getEstDteRequest" name="getEstDteRequest"/>
<wsdl:output message="impl:getEstDteResponse" name="getEstDteResponse"/>
</wsdl:operation>
</wsdl:portType>apBinding" type="impl:QueryEstDte">
<wsdlsoap:binding style="rpc" transport="http://s
<wsdl:binding name="QueryEstDteSo chemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="getEstDte">
<wsdlsoap:operation soapAction=""/>
<wsdl:input name="getEstDteRequest">
<wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
namespace="https://maullin.sii.cl/DTEWS/QueryEstDte.jws" use="encoded"/>
</wsdl:input>
<wsdl:output name="getEstDteResponse">
<wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
namespace="https://maullin.sii.cl/DTEWS/QueryEstDte.jws" use="encoded"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="QueryEstDteService">
<wsdl:port binding="impl:QueryEstDteSoapBinding" name="QueryEstDte">
<wsdlsoap:address location="https://maullin.sii.cl/DTEWS/QueryEstDte.jws"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
Figura 2-1
8
9
2.1.2 Detalle Parmetros del WSDL
De acuerdo a lo destacado en el recuadro del Figura 2-1, Quer yEst Dt e entrega slo
un metodoget Est Dt e, el cual requiere los siguientes parmetros de entrada:
Rut Consul t ant e
DvConsul t ant e
Rut Compani a
DvCompani a
Rut Recept or
DvRecept or
Ti poDt e
Fol i oDt e
FechaEmi si onDt e
Mont oDt e
Token.
10
CAPITULO 3
DETALLE PARMETROS DEL SERVICIO
3.1 Parmetros de Entrada
Los parmetros de entrada requeridos por el servicio, se detallan en el siguiente
ejemplo:
3.1.1 Ejemplo Real Parmetros de Entrada Formato WSDL
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-
ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<m:getEstDte xmlns:m="http://maullin.sii.cl/DTEWS/QueryEstDte.jws">
<RutConsultante xsi:type="xsd:string">String</RutConsultante>
<DvConsultante xsi:type="xsd:string">String</DvConsultante>
<RutCompania xsi:type="xsd:string">String</RutCompania>
<DvCompania xsi:type="xsd:string">String</DvCompania>
<RutReceptor xsi:type="xsd:string">String</RutReceptor>
<DvReceptor xsi:type="xsd:string">String</DvReceptor>
<TipoDte xsi:type="xsd:string">String</TipoDte>
<FolioDte xsi:type="xsd:string">String</FolioDte>
<FechaEmisionDte xsi:type="xsd:string">String</FechaEmisionDte>
<MontoDte xsi:type="xsd:string">String</MontoDte>
<Token xsi:type="xsd:string">String</Token>
</m:getEstDte>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Figura 3-1
Donde:
Campo Tipo Largo Detalle Obligatorios
Rut Consul t ant e String numrico 1-8 Rut Consultante S
DvConsul t ant e String Alfanumrico 1-1 DV del Rut del Consultante. S
Rut Compani a String numrico 1-8 Rut del Emisor. S
DvCompani a String Alfanumrico 1-1 Dv del Emisor. S
Rut r ecept or String numrico 1-8 Rut del Receptor. S
DvRecept or String Alfanumrico 1-1 Dv del receptor. S
Ti poDt e String numrico 1-3 Tipo del DTE. S
Fol i oDt e String numrico 1-10 Folio del DTE. S
FechaEmi si onDt e String Date 1-10 Fecha de Emisin del DTE, en
formato DDMMAAAA.
S
Mont oDt e String numrico 1-15 Monto Total del DTE. S
Token String Alfanumrico 1-40 Es un Token es un identificador nico
el cual es almacenado y enviado al
cliente en el Header del Response
de la Autenticacin Automtica con
Certificado Digital (CD), y permite la
bsqueda de toda la informacin
relacionada a una sesin del cliente.
S
Tabla 3-2
11
12
3.2 Parmetros de Salida
La salida del Servicio corresponden a un string XML codificado, por lo tanto necesario
que el programa cliente sea capaz de decodificar el string y llevarlo a formato original,
los campos de retorno son: ESTADO y GLOSA, ERR_CODE, GLOSA_ERR, NUM_ATENCIN.
Donde:
Campo Tipo Largo Detalle Obligatorios
ESTADO String
1-3
Cdigo Estado
S
GLOSA String
1-238
Detalle Cdigo
S
ERR_CODE String
1-3
Cdigo Error
S
GLOSA_ERR String
1-238
Glosa Error
S
NUM_ATENCI ON String
1-40
Nmero de Atencin,
Identificador de la
consulta.
S
Tabla 3-3
3.3 Valores de Salida
El resultado de la consulta puede arrojar uno de los siguientes valores:
Estado
Tipo Largo Glosa
DOK String 1-3 Documento Recibido por el SII. Datos
Coinciden con los Registrados.
DNK String 1-3 Documento Recibido por el SII pero Datos NO
Coinciden con los registrados.
FAU String 1-3 Documento No Recibido por el SII.
FNA String 1-3 Documento No Autorizado.
FAN String 1-3 Documento Anulado.
EMP String 1-3 Empresa no autorizada a Emitir Documentos
Tributarios Electrnicos
TMD String 1-3 Existe Nota de Debito que Modifica Texto
Documento.
TMC String 1-3 Existe Nota de Crdito que Modifica Textos
Documento.
MMD String 1-3 Existe Nota de Debito que Modifica Montos
Documento.
MMC String 1-3 Existe Nota de Crdito que Modifica Montos
Documento.
AND String 1-3 Existe Nota de Debito que Anula Documento
ANC String 1-3 Existe Nota de Crdito que Anula Documento
Tabla 3-4
13
3.4 Ejemplos de Salida
A continuacin se mostrarn algunos ejemplos de salida en ambos formatos
Codificado y Decodificado.
3.4.1 Ejemplo Parmetros de Salida WSDL Codificado
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Body>
<ns1:getEstDteResponse soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:ns1="https://maullin.sii.cl/DTEWS/QueryEstDte.jws">
<getEstDteReturn xsi:type="xsd:string">&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
&lt;SII:RESPUESTA
xmlns:SII=&quot;http://www.sii.cl/XMLSchema&quot;&gt;&lt;SII:RESP_HDR&gt;&lt;ESTADO&gt;DNK&lt;/ESTADO&gt;&lt;GL
OSA&gt;DTE Recibido&lt;/GLOSA&gt;&lt;ERR_CODE&gt;1&lt;/ERR_CODE&gt;&lt;GLOSA_ERR&gt;Documento Recibido
por el SII pero Datos NO Coinciden con los registrados&lt;/GLOSA_ERR&gt; &lt;NUM_ATENCION&gt;532 ( 2004/06/14
16:44:20)&lt;/NUM_ATENCION&gt;&lt;/SII:RESP_HDR&gt;&lt;/SII:RESPUESTA&gt;</getEstDteReturn>
</ns1:getEstDteResponse>
</soapenv:Body>
</soapenv:Envelope>
Figura 3-5
3.4.1.1 Ejemplo Parmetros de Salida Decodificado
<?xml version"I.0" encoding"UTF-8" ?>
- <soapenv.Envelope xmlns.soapenv"http.//schemas.xmlsoap.org/soap/envelope/"
xmlns.xsd"http.//www.w.org/?00I/XMLSchema"
xmlns.xsi"http.//www.w.org/?00I/XMLSchema-instance">
- <soapenv.Body>
- <nsI.getEstDteResponse
soapenv.encodingStyle"http.//schemas.xmlsoap.org/soap/encoding/"
xmlns.nsI"https.//maullin.sii.cl/DTEWS/QueryEstDte.jws">
<getEstDteReturn xsi.type"xsd.string"><?xml version"I.0" encoding"UTF-
8"?> <SII.RESPUESTA
xmlns.SII"http.//www.sii.cl/XMLSchema"><SII.RESP_HDR><ESTADO>DNK</ESTAD
O><GLOSA>DTE Recibido</GLOSA><ERR_CODE>I</ERR_CODE><GLOSA_ERR>Documento
Recibido por el SII pero Datos NO Coinciden con los
registrados</GLOSA_ERR> <NUM_ATENCION>S? ( ?004/08/I4
I8.44.?0)</NUM_ATENCION></SII.RESP_HDR></SII.RESPUESTA></getEstDteReturn
>
</nsI.getEstDteResponse>
</soapenv.Body>
</soapenv.Envelope>
Figura 3-6
14
3.5 Valores de Salida por ERROR
El resultado de la consulta puede arrojar uno de los siguientes Estados de Error:
3.5.1 Errores de Consulta:
SRV_CODE
SQL_CODE
ERR_CODE
NUM_ATENCI ON
Donde :
SRV_CODE
Tipo Largo Glosa
0 String numrico 1-1
Todo Ok
1 String numrico 1-1
Error en Entrada
2 String numrico 1-1
Error SQL
Tabla 3-7
SQL_CODE
Tipo Largo Glosa
0 String numrico 1-2
Schema Validado
OTRO String numrico 1-2
Cdigo de Oracle
Tabla 3-8
ERR_CODE
Tipo Largo Glosa
0 String numrico 1-1 Documento Recibido por el SII. Datos Coinciden
con los Registrados.
1 String numrico 1-1 Documento Recibido por el SII pero Datos NO
Coinciden con los registrados.
3 String numrico 1-1 Documento No Recibido por el SII.
4 String numrico 1-1 Documento No Autorizado.
5 String numrico 1-1 Documento Anulado.
6 String numrico 1-1 Empresa no autorizada a Emitir Documentos
Tributarios Electrnicos
10 String numrico 1-2 Existe Nota de Debito que Modifica Texto
Documento.
11 String numrico 1-2 Existe Nota de Crdito que Modifica Textos
Documento.
12 String numrico 1-2 Existe Nota de Debito que Modifica Montos
Documento.
13 String numrico 1-2 Existe Nota de Crdito que Modifica Montos
Documento.
14 String numrico 1-2 Existe Nota de Debito que Anula Documento
15 String numrico 1-2 Existe Nota de Crdito que Anula Documento
Ot r o Error Interno.
Tabla 3-9
15
16
3.5.2 Errores por Autenticacin:
TOKEN
Tipo Largo Glosa
001 String 1-3
Cookie Inactivo (o token no existe)
002 String 1-3
Token Inactivo
003 String 1-3
Token No Existe
Tabla 3-10
3.5.3 Otros Errores:
Estado
Tipo Largo Glosa
- 1 String 1-1 ERROR: RETORNO CAMPO ESTADO
- 2 String 1-1 ERROR RETORNO
- 3 String 1-1 ERROR RETORNO
- 4 String 1-1 ERROR RETORNO.
Ot r os String 1-1
Tabla 3-11
17
3.5.1 Ej emplo de Salida ERROR WSDL Codificado (ERR_CODE 1)
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Body>
<ns1:getEstDteResponse soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:ns1="https://maullin.sii.cl/DTEWS/QueryEstDte.jws">
<getEstDteReturn xsi:type="xsd:string">&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
&lt;SII:RESPUESTA
xmlns:SII=&quot;http://www.sii.cl/XMLSchema&quot;&gt;&lt;SII:RESP_HDR&gt;&lt;ESTADO&gt;DNK&lt;/ESTADO&gt;&lt;GL
OSA&gt;DTE Recibido&lt;/GLOSA&gt;&lt;ERR_CODE&gt;1&lt;/ERR_CODE&gt;&lt;GLOSA_ERR&gt;Documento Recibido
por el SII pero Datos NO Coinciden con los registrados&lt;/GLOSA_ERR&gt; &lt;NUM_ATENCION&gt;532 ( 2004/06/14
16:44:20)&lt;/NUM_ATENCION&gt;&lt;/SII:RESP_HDR&gt;&lt;/SII:RESPUESTA&gt;</getEstDteReturn>
</ns1:getEstDteResponse>
</soapenv:Body>
</soapenv:Envelope>
Figura 3-12
3.5.1.1 Ejemplo de Salida ERROR WSDL Decodificado (ERR_CODE 1: Documento
Recibido por el SII pero Datos NO Coinciden con los registrados)
<?xml version"I.0" encoding"UTF-8" ?>
~ <SII.RESPUESTA xmlns.SII"http://www.sii.cl/XMLSchema">
~ <SII.RESP_HDR>
<ESTADO>DNK</ESTADO>
<GLOSA>DTF Recibido</GLOSA>
<ERR_CODE>1</ERR_CODE>
<GLOSA_ERR>Documento Recibido por el SII pero Datos No Coinciden con
los registrados</GLOSA_ERR>
<NUM_ATENCION>532 ( 2004/06/14 16:44:20)</NUM_ATENCION>
</SII.RESP_HDR>
</SII.RESPUESTA>
Figura 3-13
18
CAPITULO 4
EJEMPLOS DE SALIDA FORMATO XML
En este captulo, se muestran los ejemplos de los posibles Estados de Salida de la
aplicacin.
4.1 Ejemplo Parmetros de SalidaERR_CODE, Estado DOK (DTE Recibido)
<SI I : RESPUESTA xml ns: SI I =" http://www.ssi.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>DOK</ ESTADO>
<GLOSA_ESTADO>DTE Recibido</ GLOSA_ESTADO>
<ERR_CODE>0</ ERR_CODE>
<GLOSA_ERR>Documento Recibido por el SII. Datos Coinciden con
los Registrados</ GLOSA_ERR>
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20) </NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.2 Ejemplo Parmetros de SalidaERR_CODE, Estado DNK (Documentos Recibidos,
datos no Coinciden)
<SI I : RESPUESTA xml ns: SI I =" http://www.ssi.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>DNK</ ESTADO>
<GLOSA_ESTADO>DTE Recibido</ GLOSA_ESTADO>
<ERR_CODE>1</ ERR_CODE>
<GLOSA_ERR>Documento Recibido por el SII pero Datos NO
Coinciden con los registrados</ GLOSA_ERR>
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20) </NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.3 Ejemplo Parmetros de SalidaERR_CODE, Estado FAU (DTE no Recibido)
- <SI I : RESPUESTA xml ns: SI I =" http://www.ssi.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>FAU</ ESTADO>
<GLOSA_ESTADO>DTE No Recibido</ GLOSA_ESTADO>
<ERR_CODE>3</ ERR_CODE>
<GLOSA_ERR>Documento No Recibido por el SII</ GLOSA_ERR>
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20) </NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
19
4.4 Ejemplo Parmetros de SalidaERR_CODE, EstadoFNA (DTE no Recibido )
- <SI I : RESPUESTA xml ns: SI I =" http://www.ssi.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>FNA</ ESTADO>
<GLOSA_ESTADO>DTE No Recibido</ GLOSA_ESTADO>
<ERR_CODE>4</ ERR_CODE>
<GLOSA_ERR>Documento No Autorizado</ GLOSA_ERR>
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20) </NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.5 Ejemplo Parmetros de SalidaERR_CODE, EstadoFAN (Documento Anulado )
- <SI I : RESPUESTA xml ns: SI I =" http://www.ssi.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>FAN</ ESTADO>
<GLOSA_ESTADO>DTE No Recibido</ GLOSA_ESTADO>
<ERR_CODE>5</ ERR_CODE>
<GLOSA_ERR>Documento Anulado</ GLOSA_ERR>
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20) </NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.6 Ejemplo Parmetros de SalidaERR_CODE, Estado EMP(Empresa No autorizada
... )
<SI I : RESPUESTA xml ns: SI I =" http://www.ssi.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>EMP</ ESTADO>
<GLOSA_ESTADO>DTE No Recibido</ GLOSA_ESTADO>
<ERR_CODE>6</ ERR_CODE>
<GLOSA_ERR>Empresa No Autorizada a Emitir Documentos
Tributarios Electronicos</ GLOSA_ERR>
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20) </NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
20
4.7 Ejemplo Parmetros de SalidaERR_CODE, Estado TMD (Existe Nota de Debito
... )
<SI I : RESPUESTA xml ns: SI I =" http://www.ssi.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>TMD</ ESTADO>
<GLOSA_ESTADO>DTE Recibido</ GLOSA_ESTADO>
<ERR_CODE>10</ ERR_CODE>
<GLOSA_ERR>Existe Nota de Debito que Modifica el Texto
Documento</ GLOSA_ERR>
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20) </NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
Nota: Este ejemplo corresponde a un Documento Referenciado, lo que significa que los
datos coinciden, pero el documento est referenciado por una Nota de Crdito o
Debito.
4.8 Ejemplo Parmetros de Salida ERR_CODE, Estado TMC(Existe Nota de Crdito
... )
<SI I : RESPUESTA xml ns: SI I =" http://www.ssi.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>TMC</ ESTADO>
<GLOSA_ESTADO>DTE Recibido</ GLOSA_ESTADO>
<ERR_CODE>11</ ERR_CODE>
<GLOSA_ERR>Existe Nota de Crdito que Modifica el Texto
Documento</ GLOSA_ERR>
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20) </NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.9 Ejemplo Parmetros de Salida ERR_CODE, Estado MMD(Existe Nota de Debito
... )
<SI I : RESPUESTA xml ns: SI I =" http://www.ssi.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>MMD</ ESTADO>
<GLOSA_ESTADO>DTE Recibido</ GLOSA_ESTADO>
<ERR_CODE>12</ ERR_CODE>
<GLOSA_ERR>Existe Nota de Debito que Modifica Montos
Documento</ GLOSA_ERR>
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20) </NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
21
4.10 Ejemplo Parmetros de Salida ERR_CODE, Estado MMC(Existe Nota de
Crdito ... )
<SI I : RESPUESTA xml ns: SI I =" http://www.ssi.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>MMC</ ESTADO>
<GLOSA_ESTADO>DTE Recibido</ GLOSA_ESTADO>
<ERR_CODE>13</ ERR_CODE>
<GLOSA_ERR>Existe Nota de Crdito que Modifica Montos
Documento</ GLOSA_ERR>
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20) </NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.11 Ejemplo Parmetros de Salida ERR_CODE, Estado AND(Existe Nota de
Debito... )
<SI I : RESPUESTA xml ns: SI I =" http://www.ssi.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>AND</ ESTADO>
<GLOSA_ESTADO>DTE Recibido</ GLOSA_ESTADO>
<ERR_CODE>14</ ERR_CODE>
<GLOSA_ERR>Existe Nota de Debito que anula
Documento</ GLOSA_ERR>
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20) </NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.12 Ejemplo Parmetros de Salida ERR_CODE, Estado ANC (Existe Nota de
Crdito... )
<SI I : RESPUESTA xml ns: SI I =" http://www.ssi.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>ANC</ ESTADO>
<GLOSA_ESTADO>DTE Recibido</ GLOSA_ESTADO>
<ERR_CODE>15</ ERR_CODE>
<GLOSA_ERR>Existe Nota de Crdito que anula
Documento</ GLOSA_ERR>
<NUM_ATENCI ON>532 ( 2004/06/14 16:44:20) </NUM_ATENCI ON>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
22
4.13 Ejemplo Parmetros de Salida Token Estado 002 (ERROR: TOKEN INACTIVO)
<SI I : RESPUESTA xml ns: SI I ="http://www.sii.cl/XMLSchema">
<SI I : RESP_HDR>
<ESTADO>002</ ESTADO>
<GLOSA>TOKEN+INACTIVO</ GLOSA>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.14 Ejemplo Parmetros de Salida Token Estado 003 (ERROR: TOKEN NO EXISTE)
<SI I : RESPUESTA xml ns: SI I ="http://www.sii.cl/XMLSchema">
<SI I : RESP_HDR>
<ESTADO>003</ ESTADO>
<GLOSA>NO+EXISTE</ GLOSA>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.15 Ejemplo Parmetros de Salida Token Estado 003 (ERROR: TOKEN NO EXISTE)
<?xml version"I.0" encoding"UTF-8" ?>
<SII.RESPUESTA xmlns.SII"http://www.sii.cl/XMLSchema">
<SII.RESP_HDR>
<ESTADO>001</ESTADO>
<GLOSA>CooKIF INACTIVo</GLOSA>
</SII.RESP_HDR>
</SII.RESPUESTA>
4.16 Ejemplo Parmetros de Salida Otros ERRORES 1 (ERROR: RETORNO CAMPO
ESTADO, NO EXISTE)
<SI I : RESPUESTA xml ns: SI I =" http://www.sii.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>-1</ ESTADO>
<GLOSA>ERROR RETORNO CAMPO ESTADO, NO EXISTE</ GLOSA>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
4.17 Ejemplo Parmetros de Salida Otros ERRORES 2 (ERROR RETORNO)
<SI I : RESPUESTA xml ns: SI I =" http://www.sii.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>-2</ ESTADO>
<GLOSA>ERROR RETORNO </ GLOSA>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
23
4.18 Ejemplo Parmetros de Salida Otros ERRORES 3 (ERROR RETORNO)
<SI I : RESPUESTA xml ns: SI I =" http://www.sii.cl/XMLSchema">
- <SI I : RESP_HDR>
<ESTADO>-3</ ESTADO>
<GLOSA>ERROR RETORNO </ GLOSA>
</ SI I : RESP_HDR>
</ SI I : RESPUESTA>
24
CAPITULO 5
GUIA PARA REALIZAR PRUEBAS
Para probar el servicio, se deben seguir los siguientes pasos:
1.- Autenticarse medianteAutenticacin Automticacon Certificado Digital(CD).
Nota:
El proceso de la Autenticacin Automtica con CD, permitir obtener unToken, el
cul es requerido como parmetro de Entrada por el WS QueryEstDte.jws.
Para la implementacin de la Autenticacin Automtica, se recomienda ver
Manual del Desarrollador Ws Autenticacin con Certificado Digital .
2.- Una vez obtenido el Token(de acuerdo a lo detallado ms arriba en paso 1), se debe
invocar al sitio donde se encuentra el WS (QueryEstDte), Ejemplo:
https://maullin.sii.cl/DTEWS/QueryEstDte.jws?WSDL
3.- Luego, para realizar las pruebas, al WS invocado, se le deben pasar los parmetros
de entrada requeridos para la consulta, estos son: Rut Consul t ant e , DvConsul t ant e,
Rut Compani a, DvCompani a , Rut Recept or , DvRecept or , Ti poDt e, Fol i oDt e,
FechaEmi si onDt e, Mont oDt e y Token
4.- Como respuesta del WS se obtiene los siguientes tag.
ESTADO
GLOSA
ERR_CODE
GLOSA_ERR
NUM_ATENCION
Nota: El ambiente de produccin, es idntico al de certificacin, solo cambia el nombre del servidor, tal
como se indica ms abajo.
ht t ps: / / pal ena. si i . cl / DTEWS/ Quer yEst Dt e. j ws?WSDL
25
REFERENCIAS
Para mayor informacin sobre temas tratados en este manual, se recomienda visitar:
Documentacin WSDL: http://www.w3.org/TR/wsdl
Herramienta XMLSPY : http://www.xmlspy.com/features_wsdl.html
POST / cgi _dt e/ UPL/ DTEUpl oad HTTP/ 1. 0
Accept : i mage/ gi f , i mage/ x- xbi t map, i mage/ j peg, i mage/ pj peg, appl i cat i on/ vnd. ms- power poi nt , appl i cat i on/ ms- excel , appl i cat i on/ mswor d, */ *
Ref er er : ht t p: / / www. empr esa. cl
Accept - Language: es- cl
Cont ent - Type: mul t i par t / f or m- dat a: boundar y=- - - - - - - - - - - - - - - 9022632e1130l c4
Accept - Encodi ng: gzi p, def l at e
User - Agent : Mozi l l a/ 4. 0 ( compat i bl e; PROG 1. 0; Wi ndows NT 5. 0; YComp 5. 0. 2. 4)
Cont ent - Lengt h: 8653
Connect i on: Keep- Al i ve
Cache- Cont r ol : no- cache
Cooki e: TOKEN=YJ yar 2VB0HWzg
- - - - - - - - - - - - - - - - - 9022632e1130l c4
Cont ent - Di sposi t i on: f or m- dat a; name=" r ut Sender "
Cont ent - Type: t ext / pl ai n; char set =US- ASCI I
Cont ent - Tr ansf er - Encodi ng: 8Bi t
66000000
- - - - - - - - - - - - - - - - - 9022632e1130l c4
Cont ent - Di sposi t i on: f or m- dat a; name=" dvSender "
Cont ent - Type: t ext / pl ai n; char set =US- ASCI I
Cont ent - Tr ansf er - Encodi ng: 8Bi t
0
- - - - - - - - - - - - - - - - - 9022632e1130l c4
Cont ent - Di sposi t i on: f or m- dat a; name=" r ut Company"
Cont ent - Type: t ext / pl ai n; char set =US- ASCI I
Cont ent - Tr ansf er - Encodi ng: 8Bi t
77777777
- - - - - - - - - - - - - - - - - 9022632e1130l c4
Cont ent - Di sposi t i on: f or m- dat a; name=" dvCompany"
Cont ent - Type: t ext / pl ai n; char set =US- ASCI I
Cont ent - Tr ansf er - Encodi ng: 8Bi t
7
- - - - - - - - - - - - - - - - - 9022632e1130l c4
Cont ent - Di sposi t i on: f or m- dat a; name=" ar chi vo" ; f i l ename=" d: \ ENVFI N_100_si gn. xml "
Cont ent - Type: appl i cat i on/ oct et - st r eam
Cont ent - Tr ansf er - Encodi ng: bi nar y
<?xml ver si on=" 1. 0" encodi ng=" I SO- 8859- 1" ?>
<Envi oDTE xml ns=" ht t p: / / www. si i . cl / Si i Dt e" xml ns: xsi =" ht t p: / / www. w3. or g/ 2001/ XMLSchema- i nst ance" xsi : schemaLocat i on=" ht t p: / / www. si i . cl / Si i Dt e Envi oDTE_v10. xsd" ver si on=" 1. 0" >
<Set DTE I D=" Set Doc" >
<Car at ul a ver si on=" 1. 0" >
<Rut Emi sor >77777777- 7</ Rut Emi sor >
<Rut Envi a>66000000- 0</ Rut Envi a>
<Rut Recept or >60803000- K</ Rut Recept or >
<FchResol >2002- 10- 20</ FchResol >
<Nr oResol >0</ Nr oResol >
<Tmst Fi r maEnv>2003- 08- 29T19: 34: 59</ Tmst Fi r maEnv>
<SubTot DTE>
<TpoDTE>33</ TpoDTE>
<Nr oDTE>1</ Nr oDTE>
</ SubTot DTE>
</ Car at ul a>
<DTE ver si on=" 1. 0" >
<Document o I D=" F996286T33" >
<Encabezado>
<I dDoc>
<Ti poDTE>33</ Ti poDTE>
<Fol i o>996286</ Fol i o>
<FchEmi s>2003- 08- 29</ FchEmi s>
<FmaPago>1</ FmaPago>
</ I dDoc>
<Emi sor >
<RUTEmi sor >77777777- 7</ RUTEmi sor >
<RznSoc>SI N RAZON SOCI AL/ NOMBRES</ RznSoc>
<Gi r oEmi s>Pr ueba SI I </ Gi r oEmi s>
<Act eco>31341</ Act eco>
Pgina1 de5
21-04-2014 http://www.sii.cl/factura_electronica/factura_mercado/ejem_upload.txt
<CdgSI I Sucur >1234</ CdgSI I Sucur >
<Di r Or i gen>Teat i nos 120, Pi so 4</ Di r Or i gen>
<CmnaOr i gen>Sant i ago</ CmnaOr i gen>
<Ci udadOr i gen>Sant i ago</ Ci udadOr i gen>
</ Emi sor >
<Recept or >
<RUTRecep>55555555- 5</ RUTRecep>
<RznSocRecep>J . L. LTDA</ RznSocRecep>
<Gi r oRecep>COMPUTACI ON</ Gi r oRecep>
<Di r Recep>SAN DI EGO 55228</ Di r Recep>
<CmnaRecep>LA FLORI DA</ CmnaRecep>
<Ci udadRecep>SANTI AGO</ Ci udadRecep>
</ Recept or >
<Tot al es>
<Mnt Net o>9000</ Mnt Net o>
<I VA>1620</ I VA>
<Mnt Tot al >10620</ Mnt Tot al >
</ Tot al es>
</ Encabezado>
<Det al l e>
<Nr oLi nDet >1</ Nr oLi nDet >
<CdgI t em>
<TpoCodi go>I NT1</ TpoCodi go>
<Vl r Codi go>011</ Vl r Codi go>
</ CdgI t em>
<NmbI t em>Comput ador es Per sonal es</ NmbI t em>
<DscI t em/ >
<Qt yI t em>3</ Qt yI t em>
<Pr cI t em>3000</ Pr cI t em>
<Mont oI t em>9000</ Mont oI t em>
</ Det al l e>
<TED ver si on=" 1. 0" >
<DD>
<RE>77777777- 7</ RE>
<TD>33</ TD>
<F>996286</ F>
<FE>2003- 08- 29</ FE>
<RR>55555555- 5</ RR>
<RSR>J . L. LTDA</ RSR>
<MNT>10620</ MNT>
<I T1>Comput ador es Per sonal es</ I T1>
<CAF ver si on=" 1. 0" >
<DA>
<RE>77777777- 7</ RE>
<RS>SI N RAZON SOCI AL/ NOMBRES</ RS>
<TD>33</ TD>
<RNG>
<D>996281</ D>
<H>996290</ H>
</ RNG>
Pgina2 de5
21-04-2014 http://www.sii.cl/factura_electronica/factura_mercado/ejem_upload.txt
<FA>2003- 08- 22</ FA>
<RSAPK>
<M>0u0BSJ DPr 2LCXj 6keU/ Qzi akYvgwVr N6qQe7l ozf pqr Yok33HJ pSXFbUTSGi vT0Yj +j DKxXvFe3hZt 8UQzgV/ Q==</ M>
<E>Aw==</ E>
</ RSAPK>
<I DK>100</ I DK>
</ DA>
<FRMA al gor i t mo=" SHA1wi t hRSA" >gRgTi x54vI l 4d3Zl 1I 0L+ESmXbVi Aw+SbANU0ACOKSI vW68ci gBW/ Oj Uekep2FPr PwKy1DaKJ I QaDD7xaxWMNg==</ FRMA>
</ CAF>
<TSTED>2003- 08- 29T19: 17: 10</ TSTED>
</ DD>
<FRMT al gor i t mo=" SHA1wi t hRSA" >UWT6qg4c/ T2t hvO8Lj LQ9NMG52ym0ZnJ j Op7G3zRsXSk46+OH2hoNR/ GUqt kWf wI PgOI on7gnzDdv0Wame2BbA==</ FRMT>
</ TED>
<Tmst Fi r ma>2003- 08- 29T19: 17: 10</ Tmst Fi r ma>
</ Document o>
<Si gnat ur e xml ns=" ht t p: / / www. w3. or g/ 2000/ 09/ xml dsi g#" >
<Si gnedI nf o>
<Canoni cal i zat i onMet hod Al gor i t hm=" ht t p: / / www. w3. or g/ TR/ 2001/ REC- xml - c14n- 20010315" / >
<Si gnat ur eMet hod Al gor i t hm=" ht t p: / / www. w3. or g/ 2000/ 09/ xml dsi g#r sa- sha1" / >
<Ref er ence URI =" #F996286T33" >
<Tr ansf or ms>
<Tr ansf or mAl gor i t hm=" ht t p: / / www. w3. or g/ TR/ 2001/ REC- xml - c14n- 20010315" / >
</ Tr ansf or ms>
<Di gest Met hod Al gor i t hm=" ht t p: / / www. w3. or g/ 2000/ 09/ xml dsi g#sha1" / >
<Di gest Val ue>U4UKWVXeeDf Zf 6Z2GLpdyI r 9qS4=</ Di gest Val ue>
</ Ref er ence>
</ Si gnedI nf o>
<Si gnat ur eVal ue>UT4Hvspx+kKQWCSGPZePM5F2mi kp3LW9LYP20TWl 3Bcu+51AOhWeUwj 61Uf r Y+L+GhCkDC0cI 2ushVRJ I I NGr 4yt t f 7r i I puECbAyi C3G2mZP6GHk+Vf +r oLDYvbhR1t Gyct FFzzBobW+n4GQcLZ+vI u6KC24Kvj 5KK2Y1HKh5s=</ Si gnat ur eVal ue>
<KeyI nf o>
<KeyVal ue>
<RSAKeyVal ue>
<Modul us>
t NEknkb1kHi D1OOAWl LKkcH/ UP5UGa6V6MYso++J B+vYMg2OXFROAF7G8BNFFPQx
i uS/ 7y1azZl j N2xq+bW3bAou1bW2i j 7f xSXWTJ YFZMAyndbLyGHM1e3nVmwpgEpx
BHhZzPvwLb55st 1wceuKj s2Ont b13J 33sUb7bbJ MWh0=
</ Modul us>
<Exponent >
AQAB
</ Exponent >
</ RSAKeyVal ue>
</ KeyVal ue>
<X509Dat a>
<X509Cer t i f i cat e>WJ CATj pLA6mgAwI BAgI DAgGKMAsGCSqGSI b3DQEBBDCBsTEdMBsGA1UECBQUUmVn
aW9uI E1l dHJ vcG9saXRhbmExETAPBgNVBAcUCFNhbnRpYWdvMSI wI AYDVQQDFBl F
LUNl cnRj aGl sZSBDQSBJ bnRl cm1l ZGl hMTYwNAYDVQQLFC1FbXByZXNhI E5hY2l v
bmFsI GRl I ENl cnRpZml j YWNpb24gRWxl Y3Ryb25pY2ExFDASBgNVBAoUC0Ut Q0VS
VENI SUxFMQswCQYDVQQGEwJ DTDAeFw0wMj EwMDI xOTExNTl aFw0wMzEwMDI wMDAw
MDBaMI HXMR0wGwYDVQQI FBRSZWdpb24gTWV0cm9wb2xpdGFuYTEnMCUGA1UECxQe
U2Vydml j aW8gZGUgSW1wdWVzdG9zI El udGVybm9zMScwJ QYDVQQKFB5TZXJ 2aWNp
byBkZSBJ bXB1ZXN0b3MgSW50ZXJ ub3MxETAPBgNVBAcUCFNhbnRpYWdvMR8wHQYJ
Pgina3 de5
21-04-2014 http://www.sii.cl/factura_electronica/factura_mercado/ejem_upload.txt
KoZI hvcNAQkBFhB3Z29uemFsZXpAc2l pLmNsMSMwI QYDVQQDFBpXaWxpYmFsZG8g
R29uemFsZXogQ2Fi cmVyYTELMAkGA1UEBhMCQ0wwXDANBgkqhki G9w0BAQEFAANL
ADBI AkEAvNQyaLPd3cQl Br 0f QJ CSAKXSFan/ WbaFt D5P7QDzcE1pBI vKY2Uv6ui d
ur / mGVB9I S4Fq/ 1xRI Xy13FFmxLwTQI DAQABo4I Bgj CCAX4wI wYDVR0RBBwwGqAY
Bggr BgEEAcNSAaAMFgowNzg4MDQ0Mi 00MDwGA1UdHwQ1MDMwMaAvoC2GK2h0dHA6
Ly9j cmwuZS1j ZXJ 0Y2hpbGUuY2wvRWNl cnRj aGl sZUNBSS5j cmwwI wYDVR0SBBww
GqAYBggr BgEEAcEBAqAMFgo5Nj kyj Cs4MC01MI HmBgNVHSAEgd4wgdswgdgGCCsG
AQQBw1I AMI HLMDYGCCsGAQUFBwI BFi podHRwOi 8vd3d3LmUt Y2VydGNoaWxl LmNs
L3BvbGl 0aWNhL2Nwcy5odG0wgZAGCCsGAQUFBwI CMI GDGoGARWwgdGl 0dWxhci Bo
YSBzaWRvI HZhbGl kYWRvI GVuI GZvcm1hI HByZXNl bmNpYWwsI HF1ZWRhbmRvI Ghh
Yml saXRhZG8gZWwgQ2VydGl maWNhZG8gcGFyYSB1c28gdHJ pYnV0YXJ pbywgcGFn
b3MsI GNvbWVyY2l vI HUgb3Ryb3MwCwYDVR0PBAQDAgTwMAsGCSqGSI b3DQEBBAOB
gQB2V4cTj 7j o1RawmsRQUSnnvJ j MCr Zst cHY+Ss3I ghVPO9eGoYzu5Q63vzt 0Pi 8
CS91SBc7xo+LDol j aUyj Ozj 7zvU7TpWoFndi TQF3aCOt TkV+vj CMWW3sVHes4UCM
DkF3VYK+r DTAadi aeDAr Twsx4eNEpxFuA/ TJ wcXpLQRCDg==</ X509Cer t i f i cat e>
</ X509Dat a>
</ KeyI nf o>
</ Si gnat ur e></ DTE>
</ Set DTE><Si gnat ur e xml ns=" ht t p: / / www. w3. or g/ 2000/ 09/ xml dsi g#" >
<Si gnedI nf o>
<Canoni cal i zat i onMet hod Al gor i t hm=" ht t p: / / www. w3. or g/ TR/ 2001/ REC- xml - c14n- 20010315" / >
<Si gnat ur eMet hod Al gor i t hm=" ht t p: / / www. w3. or g/ 2000/ 09/ xml dsi g#r sa- sha1" / >
<Ref er ence URI =" #Set Doc" >
<Tr ansf or ms>
<Tr ansf or mAl gor i t hm=" ht t p: / / www. w3. or g/ TR/ 2001/ REC- xml - c14n- 20010315" / >
</ Tr ansf or ms>
<Di gest Met hod Al gor i t hm=" ht t p: / / www. w3. or g/ 2000/ 09/ xml dsi g#sha1" / >
<Di gest Val ue>B58sD6Zj bP/ D+dcucr U1oXzqyAM=</ Di gest Val ue>
</ Ref er ence>
</ Si gnedI nf o>
<Si gnat ur eVal ue>mDSRXEXI Pob8CL9UG5PI 09Vm4B84nKqSnG+xr t gFPqqE3Y3t 5bLVyuNBJ gOj gLV5RAngogXoGeJ D/ CPn/ sFxym7ZCJ nFt RHl i p6Wt a7nQNPeNLvaAbBJ Yzvusqn7r J emUi Oop/ qGec9Bf w353f Nuc/ V2/ GyV89J qVWgSK4273M0=</ Si gnat ur eVal ue>
<KeyI nf o>
<KeyVal ue>
<RSAKeyVal ue>
<Modul us>
t NEknkb1kHi D1OOAWl LKkcH/ UP5UGa6V6MYso++J B+vYMg2OXFROAF7G8BNFFPQx
i uS/ 7y1azZl j N2xq+bW3bAou1bW2i j 7f xSXWTJ YFZMAyndbLyGHM1e3nVmwpgEpx
BHhZzPvwLb55st 1wceuKj s2Ont b13J 33sUb7bbJ MWh0=
</ Modul us>
<Exponent >
AQAB
</ Exponent >
</ RSAKeyVal ue>
</ KeyVal ue>
<X509Dat a>
<X509Cer t i f i cat e>WJ CATj pLA6mgAwI BAgI DAgGKMAsGCSqGSI b3DQEBBDCBsTEdMBsGA1UECBQUUmVn
aW9uI E1l dHJ vcG9saXRhbmExETAPBgNVBAcUCFNhbnRpYWdvMSI wI AYDVQQDFBl F
LUNl cnRj aGl sZSBDQSBJ bnRl cm1l ZGl hMTYwNAYDVQQLFC1FbXByZXNhI E5hY2l v
bmFsI GRl I ENl cnRpZml j YWNpb24gRWxl Y3Ryb25pY2ExFDASBgNVBAoUC0Ut Q0VS
VENI SUxFMQswCQYDVQQGEwJ DTDAeFw0wMj EwMDI xOTExNTl aFw0wMzEwMDI wMDAw
MDBaMI HXMR0wGwYDVQQI FBRSZWdpb24gTWV0cm9wb2xpdGFuYTEnMCUGA1UECxQe
U2Vydml j aW8gZGUgSW1wdWVzdG9zI El udGVybm9zMScwJ QYDVQQKFB5TZXJ 2aWNp
byBkZSBJ bXB1ZXN0b3MgSW50ZXJ ub3MxETAPBgNVBAcUCFNhbnRpYWdvMR8wHQYJ
KoZI hvcNAQkBFhB3Z29uemFsZXpAc2l pLmNsMSMwI QYDVQQDFBpXaWxpYmFsZG8g
R29uemFsZXogQ2Fi cmVyYTELMAkGA1UEBhMCQ0wwXDANBgkqhki G9w0BAQEFAANL
Pgina4 de5
21-04-2014 http://www.sii.cl/factura_electronica/factura_mercado/ejem_upload.txt
ADBI AkEAvNQyaLPd3cQl Br 0f QJ CSAKXSFan/ WbaFt D5P7QDzcE1pBI vKY2Uv6ui d
ur / mGVB9I S4Fq/ 1xRI Xy13FFmxLwTQI DAQABo4I Bgj CCAX4wI wYDVR0RBBwwGqAY
Bggr BgEEAcNSAaAMFgowNzg4MDQ0Mi 00MDwGA1UdHwQ1MDMwMaAvoC2GK2h0dHA6
Ly9j cmwuZS1j ZXJ 0Y2hpbGUuY2wvRWNl cnRj aGl sZUNBSS5j cmwwI wYDVR0SBBww
GqAYBggr BgEEAcEBAqAMFgo5Nj kyj Cs4MC01MI HmBgNVHSAEgd4wgdswgdgGCCsG
AQQBw1I AMI HLMDYGCCsGAQUFBwI BFi podHRwOi 8vd3d3LmUt Y2VydGNoaWxl LmNs
L3BvbGl 0aWNhL2Nwcy5odG0wgZAGCCsGAQUFBwI CMI GDGoGARWwgdGl 0dWxhci Bo
YSBzaWRvI HZhbGl kYWRvI GVuI GZvcm1hI HByZXNl bmNpYWwsI HF1ZWRhbmRvI Ghh
Yml saXRhZG8gZWwgQ2VydGl maWNhZG8gcGFyYSB1c28gdHJ pYnV0YXJ pbywgcGFn
b3MsI GNvbWVyY2l vI HUgb3Ryb3MwCwYDVR0PBAQDAgTwMAsGCSqGSI b3DQEBBAOB
gQB2V4cTj 7j o1RawmsRQUSnnvJ j MCr Zst cHY+Ss3I ghVPO9eGoYzu5Q63vzt 0Pi 8
CS91SBc7xo+LDol j aUyj Ozj 7zvU7TpWoFndi TQF3aCOt TkV+vj CMWW3sVHes4UCM
DkF3VYK+r DTAadi aeDAr Twsx4eNEpxFuA/ TJ wcXpLQRCDg==</ X509Cer t i f i cat e>
</ X509Dat a>
</ KeyI nf o>
</ Si gnat ur e></ Envi oDTE>
- - - - - - - - - - - - - - - - - 9022632e1130l c4- -
Pgina5 de5
21-04-2014 http://www.sii.cl/factura_electronica/factura_mercado/ejem_upload.txt

Potrebbero piacerti anche