Embed Size (px)
Citation preview
ventanilla únicadel comercio exterior mexicano
Revisión del consumo del Web Service de Digitalización de la VUCEM y Errores comunes detectados
Í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
Introducción del Webservice de Digitalización
¿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/Descargas/index.htm Hoja Informativa No. 06 - DigitalizaciónHoja informativa No. 46 - Servicio Web DigitalizaciónHoja Informativa No. 49 - Servicio Web DigitalizaciónHoja Informativa No. 52 - Liga para pruebas de Servicios Web
Operaciones del Webservice de Digitalización
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* •Folio de la operación* •Nota:•Datos marcados con * son obligatorios.•Los datos deben estar separados por pipes “|”
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
Protocolo MTOM
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.
Errores Comunes
Referencia ‘cid:’
CID 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.
Para adjuntar un archivo .pdf se debe declarar un arreglo de bytes en base 64:
<dig:archivo> 31c8628382d7f94a8e49a1b44b2f6d74b
e49a1b44b2f6d74bff09c5c </dig:archivo>
Adjuntar .pdf
ID del Tipo de Documento
El 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:<ns2:tipoDeDocumento>
<ns2:idTipoDeDocumento>421</ns2:idTipoDeDocumento> <ns2:descripcion>Comprobante de la importación temporal de la embarcación debidamente formalizado.</ns2:descripcion>
</ns2:tipoDeDocumento>
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*
Estructura de la Cadena Original
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|
Hash
• 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.
Firma Inválida
El certificado y la firma es incorrecto , Lo correcto es base64
Codificación de Certificado y Firma
Fin
Implementación de trámites AGA/COVE
