Integración y recomendaciones

Transcripción

1 FACeB2B Punt de entrada de facturas electrónicas entre empresas Integración y recmendacines Versión 1.0 Fecha de revisión 26/09/2017 Realizad pr Equip DTI

2 ÍNDICE 1.1. Qué es FACeB2B? Web Services FACeB2B Cmunicación e integración cn ls Web Services FACeB2B Prtcls SSL y TLS Server Name Indicatin (SNI) Cnfianza en Certificads FNMT Clase 2 CA Enví de peticines Integración en Java Us de certificads en FACeB2B Clasificación de certificads pr Afirma Us de Certificads en FACeB2B

3 1.1. Qué es FACeB2B? Dad el éxit de la implantación de la factura electrónica en el Sectr Públic en el añ 2015, se creó un grup de trabaj entre miembrs del Sectr Privad y del Sectr Públic para tratar la implantación de la factura electrónica en las relacines entre empresas. Este grup de trabaj estudia las medidas de éxit del mdel de facturación electrónica del Sectr Públic, para tratar de trasladar e impulsar aquellas que sean necesarias y viables al Sectr Privad en las relacines de facturación entre empresas. Primer, para fmentar la facturación electrónica glbalmente y que llegue a tds ls sectres industriales sin imprtar el tamañ de la rganización, sectr grad de infrmatización. Y segund para generar nuevs mdels que permitan slventar ls prblemas que la facturación electrónica actualmente pueda prducir a empresas de determinads sectres, tamañ grad de infrmatización. Pr td ell se han cread un cnjunt de Web Services que permitirán a las entidades integrar en sus sistemas la remisión de facturas y su gestión, así cm la gestión de sus usuaris y unidades cntables. 3

4 1.2. Web Services FACeB2B A cntinuación se detallan ls diferentes Web Services que englban tda la actividad prevista para FACe B2B: GESTIÓN DE FACTURAS (facturasspp): Este Web Service englba tds ls métds necesaris para el prveedr para remitir y cnsultar facturas: Enviar factura. Se divide en tres grups: infrmación del prveedr, ficher de la factura y fichers anexs. Anular factura. Cnsultar estads. Cnsultar factura. Cnsultar listad de facturas. Cnsultar Unidades pr Empresas. Cnsultar Empresas. Cnsultar NIFs. Cnsultar NIFs pr Empresa. NOTIFICACIONES DE FACTURA para ls prveedres (ntificasspp): Este Web Service englba tds ls métds necesaris para la gestión de ntificacines para ls prveedres: Obtener Tips Ntificación activs en FACe B2B. Creación Tips de Ntificación. Obtener Tips Ntificación activs cnfigurads en Sistema Prveedr. 4

5 GESTIÓN DE FACTURAS para las empresas (facturasrcf) Este Web Service englba tds ls métds necesaris para el gestr para evlucinar sus facturas: Slicitar nuevas facturas. Slicitar nuevas anulacines. Descargar factura. Cnfirmar descarga de factura. Cambiar estad de facturas. Cnsultar estads. Cnsultar unidades. Gestinar slicitud de anulación de facturas. Cnsultar factura. Cnsultar listad de facturas. Cambiar estad listad de facturas. Gestinar slicitud anulación listad facturas. Cambi códig RCF. Cnsultar códig RCF (estas ds ultims se usarán si la empresas llevan un registr cntable). GESTIÓN DE DIRECTORIO para las empresas (directrisrcf) Este Web Service englba tds ls métds necesaris para la gestión del directri de ls gestres de facturas: Cnsultar Unidad. Gestión Númer de Identidad. Gestión de Relación. Gestión de Rl. 5

6 1.3. Cmunicación e integración cn ls Web Services FACeB2B Prtcls SSL y TLS El únic prtcl admitid es TLS>=1.0 NOTA: para aquells integradres en Java 6, pr defect usa SSLv3 y el handshake falla. Especificar en el arranque la pción -Dhttps.prtcls="TLSv1" Server Name Indicatin (SNI) El únic acces permitid es pr nmbre, n es psible el acces únicamente pr IP. SNI es una extensión del prtcl TLS.1. Se requiere sprte de la extensión SNI en el navegadr cliente. Ls usuaris cuy navegadr n sprten SNI pdrán recibir advertencias de seguridad pr n cincidencia de nmbre de certificad cn el de servici. La mayr parte de ls sistemas perativs, navegadres y clientes actuales, sprtan SNI, en cas de duda, se puede cmprbar la cmpatibilidad de su cliente navegadr en wikipedia artícul sbre SNI ( A partir de nviembre de 2012, ls únics grandes bases de usuaris cuys navegadres n sprtan SNI sn de Andrid 2.x (navegadr predeterminad), Internet Explrer en Windws XP y versines de Java antes de 1.7 en cualquier sistema perativ Cnfianza en Certificads FNMT Clase 2 CA Ls certificads empleads pr el servici sn "FNMT Clase 2 CA". Para evitar prblemas 7 cn ls certificads, se requiere que el navegadr cliente cnfíe en ls certificads emitids pr dicha CA. Pr defect, alguns navegadres, n cnfían en este certificad, pr l que ha de añadirse manualmente. Si el cliente es Java, este certificad hay que añadirl al crrespndiente truststre. Puede btenerse este certificad en ( 49b3-bd8e-0ff6ca02cb66). Además de este certificad, y en previsión de su sustitución, se recmienda añadir el certificad "AC Raíz FNMT-RCM (SHA2)", descargable en ( RCM_SHA256.cer/b1447e b7-92cc-8690edd7562d) ya que ls certificads más recientes se vienen emitiend desde esta CA. 6

7 En ambs cass, ya sea en navegadr en cliente, la cnfianza requerida para ests certificads es cm CA ("raíz de cnfianza" "autridad", en algún navegadr, cm Firefx, se requiere además, indicar que el certificad puede emplearse para "identificar sitis web"). En cas de n instalar dichs certificads, el acces al servici pdrá ser limitad cn advertencias de seguridad Enví de peticines Las peticines que n cumplan ests requisits pdrán ser rechazadas Cabeceras HTTP Pr mtivs de seguridad se requiere en la cabecera de las peticines esté presente la definición Cntent-Length cn el valr crrect en bytes. Se recmienda también la definición del charset sea en UTF-8. Ejempl:"Cntent- Type: text/xml;charset=utf-8" Tamañs de las peticines Se admiten slicites POST cn un tamañ máxim de 8M Integración en Java Para aquells integradres que decidan usar Java se recmienda usar la versión >= 1.7. Esta versión sprta TLS y SNI pr defect. 7

8 Librerías recmendadas Esta es la relación de librerías Java recmendadas para la integración cn las distintas cdificacines wsdl. Entrn de Staging Test (FALTA TABLA) Cdificación Librerías Java URL recmendadas RPC/Encded Axis 1.4 WS Prveedres RPC/Encded Axis 1.4 WS Organisms RPC/Encded Axis 1.4 WS Gestin Unidades RPC/Literal Axis 2 sbre WS Prveedres RPC/Literal Axis 2 sbre WS Organisms RPC/Literal Axis 2 sbre WS Gestin Unidades Entrn de Prducción (FALTA TABLA) Cdificación Librerías Java URL recmendadas RPC/Encded Axis 1.4 WS Prveedres RPC/Encded Axis 1.4 WS Organisms RPC/Encded Axis 1.4 WS Gestin Unidades RPC/Literal Axis 2 sbre WS Prveedres RPC/Literal Axis 2 sbre WS Organisms RPC/Literal Axis 2 sbre WS Gestin Unidades NOTA: para aquells integradres en Java 6, pr defect usa SSLv3 y el handshake falla. Hay que especificar en el arranque la pción -Dhttps.prtcls="TLSv1" 8

9 1.4. Us de certificads en FACeB2B Clasificación de certificads pr Afirma La a través del camp "clasificación" de la respuesta de la herramienta Valide ( prprcina una clasificación básica del tip de certificad que se trata. Ls tips sn ls que se incluyen a cntinuación: Clasificación = 0 Persna física según la ley 59/2003. Clasificación = 1 Persna jurídica según la ley 59/2003. Clasificación = 2 Cmpnente/SSL/n recncid/sell de empresa. Clasificación = 3 Sede según la ley 11/2007. Clasificación = 4 Sell según la ley 11/2007. Clasificación = 5 Emplead Públic según la ley 11/2007. Clasificación = 6 Entidad sin persnalidad jurídica según la ley 59/2003. Clasificación = 7 Emplead Públic cn Seudónim. Clasificación = 8 Cualificad de sell (UE 910/2014). Clasificación = 9 Cualificad de autenticación de siti web (UE 910/2014). Clasificación = 10 Cualificad de sell de tiemp. Clasificación = 11 Persna física representante ante las AAPP de persna jurídica. Clasificación = 12 Persna física representante ante las AAPP de entidad sin persna jurídica. Las clasificacines devueltas cinciden cn las clasificacines de ls certificads indicads pr el MINETUR. Pueden cnsultar tds ls certificads incluids y su clasificación en el ANEXO PSC s de la Declaración de Practicas de validación 9

10 Certificads publicads en la web del MINETUR cm recncids: Certificads de Persna Física (tip 0 Certificads de Persna Jurídica Legal Persn (tip 1 Certificads de Emplead Públic (tip 5 Certificads de Sell Electrónic (tip 4 Certificads de Entidad Sin Persnalidad Jurídica (tip 6 Certificads publicads en la web del MINETUR cm n recncids / Certificads de cmpnente / Certificads de aplicación / Certificads SSL / Certificads de TSA (tip 2 3 Certificads publicads en la web de MINETUR cm de Sede Electrónica (tip Otrs. Certificads de Emplead Nivel Alt, prpósit de Autenticación (tip 5 Certificads de Emplead Nivel Alt, prpósit de Cifrad (tip 5 Certificads recncids de PSC s extranjers según Directiva de Firma Electrónica (tip Us de Certificads en FACeB2B En FACeB2B se pueden usar certificads para varis prpósits que enumerams a cntinuación: Firma de cmunicación pr Web Services tip SOAP Este us cmprende la firma de xml en cualquiera de ls frmats XMLDsig XAdES en cualquiera de sus variantes. Ls certificads admitids para ese us sn: Clasificación = 0 Persna física según la ley 59/2003. Clasificación = 1 Persna jurídica según la ley 59/2003. Clasificación = 2 Cmpnente/SSL/n recncid/sell de empresa. Clasificación = 3 Sede. 10

11 Clasificación = 4 Sell según la ley 11/2007. Clasificación = 5 Emplead Públic según la ley 11/2007. Clasificación = 6 Certificads de Entidad Sin Persnalidad Jurídica. Clasificación = 7 Emplead Públic cn Seudónim. Clasificación = 8 Cualificad de sell (UE 910/2014). Clasificación = 9 Cualificad de autenticación de siti web (UE 910/2014). Clasificación = 11 Persna física representante ante las AAPP de persna jurídica. Clasificación = 12 Persna física representante ante las AAPP de entidad sin persna jurídica. Firma de la factura electrónica Este us cmprende la firma de la factura en xml en cualquiera de ls frmats XMLDsig XAdES en cualquiera de sus variantes. Ls certificads admitids para ese us sn: Clasificación = 0 Persna física según la ley 59/2003. Clasificación = 1 Persna jurídica según la ley 59/2003. Clasificación = 4 Sell según la ley 11/2007. Clasificación = 5 Emplead Públic según la ley 11/2007. Clasificación = 6 Certificads de Entidad Sin Persnalidad Jurídica. Clasificación = 8 Cualificad de sell (UE 910/2014). Clasificación = 11 Persna física representante ante las AAPP de persna jurídica. Clasificación = 12 Persna física representante ante las AAPP de entidad sin persna jurídica. Se han encntrad alguns cass de certificads válids emitids cm seudónims. Para la firma de facturas FACeB2B requiere que el certificad aprte NIF y nmbre razón scial. En este cas un representante n será válid en tant que n aprte dicha infrmación. Para certificads de clase 0 y 5 se requiere que el certificad tenga ls atributs "Nmbre-Respnsable","PrimerApellidRespnsable" y "NIFRespnsable" Para certificads de clase 1 se requieren ls atributs "NIF-CIF" y "RazónScial". Para certificads de clase 4 se requieren ls atributs "NIFEntidadSuscriptra" y "entidadsuscriptra". Para certificads de clase 6 es necesari que la entidad emisra remitan ls camps "NIF-CIF" y "RazónScial" "NmbreRespnsable" y "PrimerApellidRespnsable". 11