Manual de Referencia DigitalStamp :::: REFERENCIA TECNICA

Manual de Referencia
DigitalStamp
•1•
© 2006 IT COMPLEMENTS S.A DE C.V.
:::: REFERENCIA TECNICA ::::
Autor:
Edgar Adrián Muñoz Morales
Fecha de Creación:
Marzo, 2013
Fecha de Actualización:
pág. 2
• CONTROL DE CAMBIOS •
Registro de cambios
Fecha
pág. 3
Autor
Versión
Observaciones
• DigitalStamp •
DigitalStamp
v2.0.0.0
- Componente WebService Cliente que se conecta con el PAC ATEB para el timbrado de CFDIs.
Sintaxis:
java -jar DigitalStamp.jar <requestFile> <responseFile> -mode <mode> -target <target> username <user> -password <pwd> [-connection <http> | <saaj>]
-trustStore <trustStoreFile> -trustStorePass <trustStoreFilePassword>
Donde:
<requestFile> es el archivo de entrada. Pero para la cancelación este archivo es armado al
vuelo con los datos de RFC y Folios a cancelar, por tal razón no se usa.
<responseFile> es el archivo de salida retornado por el target.
<mode> es el modo de conexión:
TEST = Ambiente de pruebas (Por defecto)
PROD = Ambiente productivo
<target> es el destino al cual conectarse. Valores posibles:
ATEB : Conexión al PAC de ATEB
<user> es el usuario de autentificación para la conexión. Esto lo proporciona el PAC a cada
cliente.
<pwd> es la contraseña de autentificación.
<trustStoreFile> es el archivo almacén de llaves donde se almacenan todos los certificados
que se consideran de confianza.
Las conexiones https envían el certificado del servidor al cual se está conectando. Si este
certificado está dentro de este almacén, la conexión se efectúa. Caso contrario es rechazado.
Para importar certificados X509 a un almacén de llaves de confianza, checar la
documentación de Java keytool.
<trustStoreFilePassword> es la contraseña del almacén de llaves. Esta contraseña es
requerida al momento de la creación de este archivo y protege al almacén de uso indebido.
<http> Tipo de conexión http para conectarse con el Web Service Servidor. Ventaja:
Consume poco CPU
<saaj> Tipo de conexión saaj para conectarse con el Web Service Servidor.
Nota: Si no se define el tipo de conexión, toma por defecto la conexión saaj.
Ejemplo:
java -jar DigitalStamp.jar dummy.xml salida.xml -mode PROD -target ATEB -username
0000000001 -password pwd -connection http
pág. 4
• DigitalStamp •
DigitalStamp v2.0.0.1
Contiene nueva funcionalidad para cancelar CFDIs, se indica mediante el parámetro
-cancelar.
Ejemplo:
java -jar DigitalStamp.jar dummy.xml salida_cancel.xml -mode PROD target ATEB -username 0000000001 -password pwd -connection http -cancelar
Contiene nuevo parámetro para definir la url donde se va a conectar el Web Service.
-endPoint <url a conectar>
Ejemplo:
java -jar DigitalStamp.jar dummy.xml salida.xml -mode PROD -target
ATEB -username 0000000001 -password pwd -connection http -endPoint
•1•
© 2006 IT COMPLEMENTS S.A DE C.V.
• DigitalStamp •
DigitalStamp v2.0.0.2
Se eliminó parámetro -endpoint.
Se modificó funcionalidad de cancelación de CFDIs, se agregaron los siguientes
parámetros para la cancelación:
Ejemplo:
java -jar DigitalStamp.jar <requestFile> <responseFile> -mode <mode> -target
<target> -username <user> -password <pwd> [-connection <http> | <saaj>]
java -jar DigitalStamp2.jar dummy.xml Salida_cancel.xml -username 0000001 password pwd -connection http -trustStore ds.keystore -trustStorePass sat-prueba -mode
test -cancelar -privateKey iep921123j76_1104041717s.key -publicKey
00001000000103214196.cer -privateKeyPass xx1pwd -rfc IEP921123J76 -uuids
80B93B4C-4EAF-428B-BC2C-5AAD7CA72BB1
"Para cancelación"
Donde:
<dummy.xml> Parametro comodín pero requerido para <requestFile>
-cancelar Parámetro que indica que se va a cancelar. Si no se pone este parámetro,
por la función por defecto es TIMBRAR.
<privateKey> Nombre del archivo de la llave privada de la empresa a cancelar UUID.
Archivo con extensión .key
<publicKey> Nombre del archivo del certificado de la empresa a cancelar UUID.
Archivo con extensión .cer
<privateKeyPass> Password de la llave privada.
<rfc> RFC de la empresa a Cancelar UUID(s)
<uuids> Lista de UUID o UUIDs a Timbrar. Si se va a timbrar más de 1, agruparlos
entre " (comillas) y separarlos por , (coma)