Procedimiento de conexión en ambiente de pruebas Formas Continuas de Guadalajara, S.A. de C.V. Clasificación: Uso Interno Versión: 1.2 Código: PT-01 Revisión: 02 Fecha de Revisión: 06/08/2013 Procedimiento de conexión en ambiente de pruebas Versión: 1.2 Código: PT-01 Revisión:02 Fecha de Revisión: 06/08/2013 Página2de6 Tabla de Contenido 1 Historia de Cambios al Documento .............................................................................. 3 2 Proceso .................................................................................................................... 4 3 Proceso de conexión (Flujo de validación) .................................................................... 4 4 Glosario ................................................................................................................... 6 Todos los Derechos Reservados ©2013 Formas Continuas de Guadalajara, S.A. de C.V Información Confidencial de Uso Interno Procedimiento de conexión en ambiente de pruebas Versión: 1.2 Código: PT-01 Revisión:02 Fecha de Revisión: 06/08/2013 Página3de6 1 Historia de Cambios al Documento Historia de Cambios Versión Fecha de Liberación 1.0 06/08/2013 Resumen de Cambios Publicación de Documento Sección: Creado por: Evaluado por: Documento Global Consultoría Sistemas Todos los Derechos Reservados ©2013 Formas Continuas de Guadalajara, S.A. de C.V Información Confidencial de Uso Interno Autorizado por: Sistemas Procedimiento de conexión en ambiente de pruebas Versión: 1.2 Código: PT-01 Revisión:02 Fecha de Revisión: 06/08/2013 Página4de6 2 Proceso Propósito El propósito del documento indicarle al usuario el procedimiento para la configuración de la URL del Web Service tanto de timbrado como de cancelación en el ambiente de pruebas. Alcance Solo se mostrará el procedimiento, por lo que en caso de dudas el usuario tendrá que ponerse en contacto con el área de soporte, o en su defecto con el área de consultoria. 3 Proceso de conexión (Flujo de validación) Liga donde se encuentra el web service para la elaboración de pruebas de timbrado y cancelación: https://dev.facturacfdi.mx:8081/WSTimbrado/WSForcogsaService?wsdl Para poder trabajar con el web service, es indispensable la autentificación para obtener un token temporal y posteriormente realizar las transacciones (timbrado o cancelación). Autenticarse: Se envía un usuario y contraseña al web service y este regresara un token el cual tendrá una vigencia temporal. Utilizando el método: autenticar(String usuario, String contrasena){ return WsAuthenticarResponse; /* Regresa un token temporal */ } Datos de acceso para pruebas: Usuario: pruebasWS Contraseña: pruebasWS Timbrado: Dentro del mensaje se envía el XML a timbrar como cadena (String), además del token obtenido en el proceso de autenticación. Aquí mandamos llamar al método: timbrar(String CFD, String Token){ return WsTimbradoResponse; /*El parámetro CFD es el XML como cadena de texto y regresa el mismo CFD con el complemento del timbre*/ } Todos los Derechos Reservados ©2013 Formas Continuas de Guadalajara, S.A. de C.V Información Confidencial de Uso Interno Procedimiento de conexión en ambiente de pruebas Versión: 1.2 Código: PT-01 Revisión:02 Fecha de Revisión: 06/08/2013 Página5de6 Cancelación: Actualmente contamos con dos métodos: 1. El primero es el más sencillo debido a que sólo se envía la información pero es necesario el envío del CSD. <xs:complexType name="Cancelacion_1"> <xs:sequence> <xs:element name="rfcEmisor" type="xs:string" minOccurs="0"/> <xs:element name="fecha" type="xs:string" minOccurs="0"/> <xs:element name="folios" type="xs:string" minOccurs="0" maxO ccurs="unbounded"/> <xs:element name="publicKey" type="xs:base64Binary" nillable= "true" minOccurs="0"/> <xs:element name="privateKey" type="xs:base64Binary" nillable ="true" minOccurs="0"/> <xs:element name="password" type="xs:string" minOccurs="0"/> <xs:element name="token" type="xs:string" minOccurs="0"/> </xs:sequence> </xs:complexType> cancelacion1(String rfcEmisor, String fecha, List<String> folios, byte[] publicKey, byte[] privateKey, String password, String token){ return WsCancelacionResponse; } 2. El segundo, es para quienes no desean enviar el sello, el cual recibe el XML con la información de la cancelación ya sellada por lo que no se requiere dicha información. <xs:complexType name="Cancelacion_2"> <xs:sequence> <xs:element name="rfcEmisor" type="xs:string" minOccurs="0"/> <xs:element name="fecha" type="xs:string" minOccurs="0"/> <xs:element name="folios" type="xs:string" minOccurs="0" maxO ccurs="unbounded"/> <xs:element name="signatureType" type="ns1:SignatureType" min Occurs="0"/> <xs:element name="token" type="xs:string" minOccurs="0"/> </xs:sequence> </xs:complexType> cancelacion2(String rfcEmisor, String fecha, SignatureType signatureType, String token){ return WsCancelacionResponse; } List<String> Todos los Derechos Reservados ©2013 Formas Continuas de Guadalajara, S.A. de C.V Información Confidencial de Uso Interno folios, Procedimiento de conexión en ambiente de pruebas Versión: 1.2 Código: PT-01 Revisión:02 Fecha de Revisión: 06/08/2013 Página6de6 Con ello se deberá generar el firmado del documento para enviarlo al SAT mediante nuestro web service. El objeto que contendrá esto es el SignatureType. La información referente a este proceso se encuentra en el anexo 20 en las últimas páginas. Cualquier duda, contactanos y te asesoraremos. Periferico Pte. 7301 Vallarta Parque Industrial C.P. 45010 Zapopan, Jal. Tel: +52 (33) 3777-1610 y 01 800 00 MI CFD (64233) consultoria@formasdigitales.com.mx www.formasdigitales.com.mx 4 Glosario Término Definición URL Liga o dirección de Internet que hace referencia a nuestro ambiente de pruebas Web Service Servicio de Internet proveído por Formas Digitales para la generación de transacciones, llámense: Autentificación, Timbrado o Cancelación Token Conjunto de caracteres que es utilizado para facilitar el proceso de autenticación de usuarios. XML Formato de archivo estandarizado por el SAT que contiene la información del comprobante fiscal digital String Cadena de texto Certificado de Sello Digital. Se incluyen los 3 elementos: CSD 1. Certificado de sello digital (archivo “.cer”) 2. Llave privada (archivo “.key”) 3. Contraseña de llave privada Todos los Derechos Reservados ©2013 Formas Continuas de Guadalajara, S.A. de C.V Información Confidencial de Uso Interno