DO MANUAL DE INTEGRACIÓN

Transcripción

1 DO MANUAL DE INTEGRACIÓN DO MANUAL DE INTEGRACIÓN Versión 1.0

2 Tabla de contenido 1 Introducción Proceso de Pago Recepción del Documento de Pago Pago a través del Home Banking Acreditación Formatos CFE OP Evento Canales WebService Correo Electrónico Manual Seguridad WS-Security y Firma Electrónica Avanzada Enlace Privado con los Bancos Validación de Certificados Página 2 / 10

3 1 Introducción Este manual presenta una visión general de los procedimientos de integración que deben utilizar las empresas para utilizar el servicio Pago Factura Electrónica (PFe). El documento está destinado al público en general, aunque por sus aspectos más técnicos es recomendable contar con conocimientos mínimos en XML, WebServices y el régimen de Facturación Electrónica en Uruguay. Página 3 / 10

4 2 Proceso de Pago Para entender los procedimientos de integración con la plataforma es importante revisar el flujo de pago y los procesos involucrados. A continuación ilustramos las 3 etapas que componen el proceso de pago: En las secciones siguientes se detalla cada uno de ellos. 2.1 Recepción del Documento de Pago Para comenzar el proceso de pago la empresa emisora, quién adhiere el servicio de recaudación, debe enviar al sitio de PFe el documento electrónico de pago, ya sea un Comprobante Fiscal Electrónico (CFE) o una Orden de Pago (OP), ver sección 3 - Formatos. Este envío es realizado normalmente por su software de Factura Electrónica quién genera el CFE, y se encarga de enviarlo a DGI y al receptor electrónico. Al trabajar PFe con los mismos formatos definidos por DGI, la integración solo requiere agregar un nuevo envío del documento, en este caso al sitio de PFe. Este envío puede hacerlo por múltiples canales, principalmente se realiza mediante por webservices pero puede utilizarse también envíos por correo electrónico o cargas manuales, vea la sección 4 - Canales por más información. Una vez recibido en PFe, el documento queda listo para ser pagado por los Bancos de plaza adheridos. Consulte con su proveedor de Factura Electrónica por el soporte para PFe. Página 4 / 10

5 2.2 Pago a través del Home Banking En esta etapa un usuario de la empresa receptora de la factura accede a su Home Banking de preferencia para realizar el pago. Al confirmar el pago, se notifica en línea a la empresa emisora de dos formas: Envío de correo electrónico a las casillas configuradas [opcional] Envío de un evento para ser procesado por un sistema de la empresa emisora, de forma que ya quede reflejado en el ERP, sistema de contabilidad, etc. que la factura fue pagada. Este envío se realiza mediante webservices, en este caso la empresa emisora pública un servicio que será invocado por PFe para enviar el evento correspondiente. El servicio debe cumplir con una especificación pre-definida. 2.3 Acreditación En esta etapa se depositan los fondos en la cuenta recaudadora de la empresa emisora, no se requiere ninguna integración ni acción alguna. La transferencia es realizada por URUTEC, como parte de la operativa de la Cámara de Compensación Interbancaria, supervisada por el BCU. Página 5 / 10

6 3 Formatos En esta sección presentamos los principales formatos de documentos XML con el que trabaja PFe. 3.1 CFE Formato de Comprobante Fiscal Electrónico (CFE) definido por DGI que puede enviarse en los siguientes formatos: Formato Sobre Entre Empresas (v15.1) definido por DGI Formato CFE DGI (v15.1) definido por DGI Para el envío de CFE a la plataforma se recomienda utilizar el formato de sobre dado que el mismo ya incorpora el certificado de firma en el cabezal del sobre. En caso de envío de CFE individuales (sin sobre) el mismo debe contar con el certificado de firma dentro de la sección X509Data de los campos de firma (XMLDSig). 3.2 OP Formato de Orden de Pago (OP) propio de la plataforma PFe, fuertemente basado en el formato CFE, con las siguientes características principales: - lleva el mismo formato de firma electrónica que un CFE - no lleva líneas de detalle - no representa un comprobante fiscal El formato de OP permite canalizar pagos sin la necesidad de enviar los CFE correspondientes, ya sea porque los mismos son generados como parte de otro proceso, otro sistema o bien porque la empresa emisora realiza una compensación interna y solo envía a PFe el importe a pagar. 3.3 Evento El formato de evento se utiliza para la comunicación de PFe hacia el Sistema Origen (empresa emisora), a través de un documento XML firmado electrónicamente que contiene la información del evento. Un evento puede referirse a uno o más documentos de la plataforma, en función del tipo de evento que se informa y de cómo se haya conformado el pago. Página 6 / 10

7 Dentro de la información que se envía en el evento figura la identificación del documento (RUT Emisor, Tipo, Serie y Número) y la información del pago como Nro. de Transacción, Banco y Fecha de Pago. Página 7 / 10

8 4 Canales PFe soporta múltiples canales para recibir los documentos de pago (CFE u OP). 4.1 WebService Consiste de una fachada de servicios seguros destinados para la empresa emisora donde se destaca la recepción del documento de pago junto con su representación impresa en PDF (opcional). Además de la recepción de documentos, también se incluyen servicios de consulta y cancelación de documentos. Esta fachada de servicios está protegida con WS-Security, ver más información en WS- Security. 4.2 Correo Electrónico Consiste en una casilla de recepción donde el sistema PFe realiza el procesamiento automático, de forma similar a cómo se realiza en el contexto de Facturación Electrónica. El correo debe tener adjuntos los documentos XML que se van a procesar, y en caso de enviar su representación impresa, deben adjuntarse manteniendo el mismo nombre (los archivos XML y PDF). Pueden enviarse múltiples XML en un mismo correo, siempre que sigan individualmente los formatos soportados por PFe como se describe en la sección 3 - Formatos. Las casillas de correo desde dónde se realiza el envío deben ser autorizadas en PFe para que los correos sean procesados. 4.3 Manual Es el procedimiento de envío más sencillo, que normalmente es utilizado para diagnóstico de problemas o como estrategia de contingencia, cuando ninguno de los canales anteriores puede ser utilizado por la empresa. El envío manual es realizado a través de la Consola Web de PFe, ingresando con usuario y password, un usuario de la empresa emisora podrá hacer el upload de documentos siempre que estos cumplan con los formatos indicados en la sección 3 - Formatos. Página 8 / 10

9 5 Seguridad En esta sección presentamos los principales aspectos de seguridad que deben ser considerados en la integración con PFe. 5.1 WS-Security y Firma Electrónica Avanzada Todos los webservices publicados por PFe se encuentran protegidos por WS-Security utilizando los profile: Signature Timestamp El uso de WS-Security permite asegurar la integridad de los mensajes recibidos, la autenticación del emisor y el no repudio. El certificado que se utiliza para la autenticación (Signature) es controlado por parte de PFe como se indica en la sección Validación de Certificados de forma de asegurar que los documentos enviados corresponden con quién los envía. Adicionalmente a los controles efectuados a nivel de WS-Security, los documentos recibidos por la plataforma deben ser firmados electrónicamente por el emisor del documento, los cuales serán validados por PFe para asegurar la integridad, autenticidad y no repudio (formato XMLDSig). En este proceso de control de firma del documento que realiza PFe también se aplican los controles de certificado indicado en la sección Validación de Certificados. Esto quiere decir que la Firma Electrónica se controla a dos niveles en el proceso de recepción, a nivel del canal (WS) y a nivel del documento XML recibido (CFE u OP). En el caso de envío por correo electrónico solo se cuenta con el control a nivel de documento. 5.2 Enlace Privado con los Bancos PFe es operado por URUTEC (empresa de servicios de BEVSA), y como tal, cuenta con un enlace privado único con los bancos de plaza, enlace por el cual día a día se canalizan las transferencias interbancarias. Esto permite que el protocolo de pago entre los bancos y PFe pueda realizarse por este canal privado y no a través de internet como lo realizan otras soluciones de plaza que deben enviar la información a través de internet. Página 9 / 10

10 5.3 Validación de Certificados Los certificados de firma que se utilizan por parte de las empresas deben pasar las siguientes validaciones que son efectuadas por PFe: Deben ser emitidos por alguna autoridad de certificación reconocida (PKI Nacional) Deben estar vigentes y no revocados (se consultan CRLs en línea) Deben cumplir con la CP de Persona Jurídica definida por UCE, esto es deben llevar el RUC de la empresa en el campo SERIALNUMBER. En el caso de envío de documentos, el RUC Emisor que se envía en el documento debe coincidir con el RUC informado en el certificado de firma. Página 10 / 10