Title: WS Digitzalizacion
1ventanilla única del comercio exterior mexicano
Revisión del consumo del Web Service de
Digitalización de la VUCEM y Errores comunes
detectados
2- Contacto SAT Web Service
- Luis Oscar Albarrán
- contacto_at_ventanilla.gob.mx
3Índice
- Introducción del Webservice de Digitalización
- Qué es la Digitalización de Documentos de
Comercio Exterior? - Hojas informativas relacionadas
- Operaciones del Webservice de Digitalización
- Protocolo MTOM
- Errores más comunes
- Error de autenticidad
- Referencia CID
- Adjuntar archivo .pdf
- ID del tipo de documento
- Estructura de la cadena original
- Hash
- Firma inválida
- Codificación del Certificado y Firma
4- Qué es la Digitalización de Documentos de
Comercio Exterior? - Es el almacenamiento de los documentos
digitalizados necesarios para el despacho
aduanero de mercancías, el cual se comunicará con
el Sistema Automatizado Aduanero Integral y con
los sistemas del Despacho Aduanero con el objeto
de la eliminación del papel. -
- Las notas informativas relacionadas con la
Digitalización de Documentos, relacionadas al
Portal Web y al Servicio Web se encuentran en - https//www.ventanillaunica.gob.mx/vucem/SobreVU/D
escargas/index.htm -
- Hoja Informativa No. 06 - Digitalización
- Hoja informativa No. 46 - Servicio Web
Digitalización - Hoja Informativa No. 49 - Servicio Web
Digitalización - Hoja Informativa No. 52 - Liga para pruebas de
Servicios Web
Introducción del Webservice de Digitalización
5- El Webservice para digitalizar documentos cuenta
con tres operaciones - 1. Consulta del catálogo de tipos de documentos.
- La Cadena original
- RFC del Solicitante
- 2. Registro de documentos digitalizados.
- La Cadena Original
- RFC del Solicitante
- Correo electrónico
- Clave Tipo de documento
- Nombre del documento
- RFC para consulta
- Hash del Documento Digitalizado
- 3. Consulta de Estatus de Registro.
- La Cadena Original
- RFC del Solicitante
Operaciones del Webservice de Digitalización
6Protocolo MTOM
- Para consumir el servicio Web service
digitalización' debe estar habilitado el
protocolo MTOM (Message Transmission Optimization
Mechanism) que permite el envÍo y recepción de
datos binarios de forma óptima
7Errores Comunes
- Error de autenticidad
- Se presenta cuando el Password no corresponde
al RFC de la persona que registra el COVE, o
viceversa, o en su defecto, no se está importando
correctamente la política de seguridad, por lo
que la aplicación no puede obtener el RFC y el
Password del usuario.
8CID es una referencia para que el contenido sepa
por donde va viajar el archivo adjunto, en este
caso nosotros usamos esta referencia por la
aplicación que se utiliza (SOAPui).En el archivo
XSD que se encuentra en la sección de descargas
de Ventanilla Unica, está establecido que el
usuario declarará un arreglo de bytes indicando
el archivo .pdf a adjuntar.
9Adjuntar .pdf
- Para adjuntar un archivo .pdf se debe declarar
un arreglo de bytes en base 64 - ltdigarchivogt 31c8628382d7f94a8e49a1b44b2f6d74b
e49a1b44b2f6d74bff09c5c - lt/digarchivogt
10El id tipo de documento va hacer referencia al
nombre del documento que se va a adjuntar, hay
varios tipos de documentos los cuales se pueden
consultar mediante el webservice.
Ejemplo ltns2tipoDeDocumentogt
ltns2idTipoDeDocumentogt421lt/ns2idTipoDeDocumen
togt ltns2descripciongtComprobante de la
importación temporal de la embarcación
debidamente formalizado.lt/ns2descripciongt lt/n
s2tipoDeDocumentogt
11Estructura de la Cadena Original
- La Cadena Original del solicitante debe estar
formada y ordenada como a continuación se
describe - RFC del Solicitante
- Correo electrónico
- Clave Tipo de documento
- Nombre del documento
- RFC para consulta
- Hash del Documento Digitalizado
-
12Hash
-
- Generar el Hash del documento a digitalizar,
de lo contrario mostrará el mensaje de cadena
inválida. - Para obtener el hash se usa el algoritmo
SHA-1 el cual produce una salida resumen de 160
bits (20 - bytes) de un mensaje que puede tener un
tamaño máximo de 264 bits. - 5341062dde72465f40dcb3becd987416a67bf432
13Firma Inválida
- Se recibe cuando ya no existe ningún error en la
cadena original. - Se presenta debido a que cualquier cambio en la
Cadena Original es visto como una Cadena nueva,
por lo que el firmado de esta debe ser cada vez
que se le realice alguna modificación por muy
pequeña que esta sea.
14Codificación de Certificado y Firma
El certificado y la firma es incorrecto , Lo
correcto es base64
15Fin
Implementación de trámites AGA/COVE