Contrato de Servicio

Transcripción

1 Cntrat de Servici Servici de Integración de Facturas Junta de Cmunidades de Castilla la Mancha VERSIÓN: 1.00 FECHA: Marz de 2014 CORREO ELECTRÓNICO:

2 ÍNDICE CONTRATO DE SERVICIO... 1 ÍNDICE DATOS FUNCIONALES REQUERIMIENTOS FUNCIONALES Requerimients Cubierts Restriccines de Us SERVICIO FACTURAE V Operación prcessunsignedfacturae Descripción de la funcinalidad de la peración Precndicines para su utilización Parámetrs de entrada Parámetrs de salida Pstcndicines de su utilización Operación prcesssignedfacturae Descripción de la funcinalidad de la peración Precndicines para su utilización Parámetrs de entrada Parámetrs de salida Pstcndicines de su utilización Dcumentación adjunta: Dats de invcación RESTRICCIONES DE SEGURIDAD Fecha Impresión: 08/04/2014 Página 2 de 12

3 1 DATOS FUNCIONALES 1.1 Requerimients funcinales Servici respnsable de prcesar facturas electrónicas en frmat facturae v3.2 ( cuy cmpradr destin sea Junta de Cmunidades de Castilla la Mancha. Las facturas se crearán en el sistema del prveedr y éste será el encargad de invcar a este servici para el tratamient de las mismas pr parte del sistema de gestión de factura electrónica de Junta de Cmunidades de Castilla la Mancha Requerimients Cubierts. El servici implementa ls siguientes requerimients: Firma digital de las facturas recibidas en frmat facturae v3.2 que previamente n estén firmadas. El frmat de firma es xmldsig sin extensines. O bien, validación de la firma digital de las facturas recibidas en frmat facturae v3.2 que se encuentren firmadas según xmldsig ó XADES-EPES (XADES ETSI TS v1.2.2 superir), según el prveedr que emitió la factura. El prveedr que envié facturas firmadas deberá previamente instalar la ruta de certificación cmpleta de su certificad en las instalacines de la platafrma para la validación del certificad cn el que se firman las facturas. Se validaran ls certificads expedids pr las siguientes Autridades de Certificación, admitidas y recncidas pr el MITyC y AEAT: Firma Prfesinal, e-dni, ACA, Ancert, ACCV, Izenpe, Camerfirma, Catcert. Las validacines se realizan mediante cnsultas nline pr OCSP. Si el prveedr envía cn facturas firmadas según XADES-EPES, también deberá infrmarl. Almacenamient de las facturas firmadas en un repsitri para su custdia y psterir cnsulta pr un perid de 5 añs Restriccines de Us. Us restringid a ls prveedres de Junta de Cmunidades de Castilla la Mancha y la aplicación web crrespndiente al sistema de gestión de factura electrónica de Junta de Cmunidades de Castilla la Mancha. Ls prveedres de Junta de Cmunidades de Castilla la Mancha deben estar cntratads previamente en la platafrma a través de ls parámetrs cnfigurads en el módul de administración. Aunque el frmat permite la inclusión de dcuments adjunts embebids dentr del frmat, n serán prcesads ni extraíds. N se prcesarán ltes de facturas, las facturas se enviarán 1 a 1. Fecha Impresión: 08/04/2014 Página 3 de 12

4 1.2 Servici Facturae v Operación prcessunsignedfacturae Descripción de la funcinalidad de la peración Prcesa facturas basadas en el frmat facturae v3.2 sin firmar, es decir, sin el segment de firma. Las facturas serán almacenadas en un repsitri y quedarán en estad pendiente de firma. Psterirmente un prces asíncrn prcederá a su firma según el mdel de delegación de firma pr tercers y serán custdiadas pr un perid de 5 añs Precndicines para su utilización Deben darse las siguientes precndicines: El prveedr ha sid cntratad en el sistema. El cmpradr de la factura es Junta de Cmunidades de Castilla la Mancha. Es una única factura. El prveedr que envié facturas a la platafrma sin firmar tendrá que rellenar ls camps crrespndientes a firma delegada del facturae cm sigue: <InviceIssuerType>TE</InviceIssuerType> <ThirdParty> <TaxIdentificatin> <PersnTypeCde>J</PersnTypeCde> <ResidenceTypeCde>R</ResidenceTypeCde> <TaxIdentificatinNumber>A </TaxIdentificatinNumber> </TaxIdentificatin> <LegalEntity> <CrprateName>INDRA SISTEMAS, S.A.</CrprateName> <AddressInSpain> <Address>AVENIDA DE BRUSELAS 35</Address> <PstCde>28108</PstCde> <Twn>ALCOBENDAS</Twn> <Prvince>MADRID</Prvince> <CuntryCde>ESP</CuntryCde> </AddressInSpain> </LegalEntity> </ThirdParty> Fecha Impresión: 08/04/2014 Página 4 de 12

5 Parámetrs de entrada El métd dispne de un únic parámetr de entrada, del tip Facturae32TSignRequestType que se ajusta a la siguiente definición. Cm puede apreciarse, esta estructura tiene un únic camp que es un lte de facturas en frmat facturae v3.2 Tds ls elements y tips están cntenids en esquemas embebids dentr del.wsdl según crrespnda. A parte se adjunta ls esquemas embebids pr separad. Se adjunta a este dcument el ficher:./facturae32/examples/invicestsignrequest.xml, cn un ejempl de invcación Parámetrs de salida El dcument de salida btenid cm resultad de invcar la peración es del tip InvicesPrcessingRespnseType que se ajusta a la siguiente definición: Fecha Impresión: 08/04/2014 Página 5 de 12

6 Tds ls elements y tips están cntenids en esquemas embebids dentr del.wsdl según crrespnda. A parte se adjunta ls esquemas embebids pr separad. A cntinuación se detalle el significad de ls camps que cmpnen la estructura: isbatchcrrect: Indica si el lte enviad es crrect incrrect. Ls códigs de errr 100,101, 103, 104, 105, 107, 108 y 109 (ver a cntinuación).el lte debe cntener una única factura. Para la factura se devlverá la estructura InvicePrcessingResult que cntiene ls siguientes elements: InviceNumber: Númer de la factura del emisr prcesada. PrcessingStatus: Que en este cas pdrá devlver ls siguiente valres: 100: Errr Inesperad al prcesar la factura. Fall intern del sistema debid alguna causa inesperada, se recmienda esperar a su reslución antes de vlver a invcar la peración. 101: Errr, La factura pertenece a un lte firmad y la peración slicitada es de firma. La causa se debe a que se incrpra en el facturae el segment de firma y la peración slicitada es de firmar. 103: El lte de facturas del facturae cntienen más de una factura. 104: Errr, Credenciales de cntratación inválidas. El prveedr n está cntratad, el cmpradr n es Junta de Cmunidades de Castilla la Mancha, el centr de la Junta n existe. Verificar que ls identificadres fiscales de cada figura sn crrects y el códig del centr. 105: Errr, El frmat del númer de factura es incrrect, ya ha sid utilizad en una factura anterir. Existe una factura cn igual númer de factura para un mism prveedr dentr de un mism añ (según la fecha de expedición). 107: Errr, la factura es del tip rectificativa cpia de rectificativa y n se adjunta la infrmación de la factura que se crrige bien el númer de factura que se crrige es igual que el nuev númer de la factura rectificativa. 108: El frmat de la petición n cumple el frmat especificad en este dcument. 109: La factura n cumple cualquiera de las validacines adicinales exigidas pr la Junta de Cmunidades de Castillas la Mancha 200: La factura ha sid aceptada y queda pendiente de firma. Fecha Impresión: 08/04/2014 Página 6 de 12

7 Ejempl de respuesta: <SOAP-ENV:Envelpe xmlns:soap-env=" <SOAP-ENV:Header /> <SOAP-ENV:Bdy> <jun:prcessunsignedfacturae32respnse xmlns:jun=" <jun:invicesprcessingrespnsetype> <jun:isbatchcrrect>true</jun:isbatchcrrect> <jun:inviceprcessingresults> <jun:inviceprcessingresult> <jun:invicenumber>jccmp1v31</jun:invicenumber> <jun:prcessingstatus>200</jun:prcessingstatus> </jun:inviceprcessingresult> </jun:inviceprcessingresults> </jun:invicesprcessingrespnsetype> </jun:prcessunsignedfacturae32respnse> </SOAP-ENV:Bdy> </SOAP-ENV:Envelpe> Pstcndicines de su utilización Las facturas prcesadas, en cas de ser crrectas quedarán en estad pendiente de firma. Un prces asíncrn (aprximadamente ejecutad cada 2 minuts) las firmará y pasarán a estar en estad firmadas en cas de que td vaya crrectamente errr en cas cntrari Operación prcesssignedfacturae Descripción de la funcinalidad de la peración Prcesa facturas basadas en el frmat facturae v3.2 firmadas, es decir, cn el segment de firma. La factura será almacenada en un repsitri y quedará en estad pendiente de verificación. Psterirmente un prces asíncrn prcederá a su verificación (cmprband la firma y la validez del certificad) y la factura será custdiada pr un perid de 5 añs. Fecha Impresión: 08/04/2014 Página 7 de 12

8 Precndicines para su utilización Deben darse las siguientes precndicines: El prveedr ha sid cntratad en el sistema. A la hra de cntratar un prveedr que vaya a integrar facturas firmadas, se deberá infrmar si las facturas estarán firmadas según xmldisg ó XADES- EPES, versión ETSI TS y será necesari que la Autridad Certificadra (CA), que haya emitid el certificad cn el que se ha firmad la factura este dentr de la siguiente lista, para pder validar el certificad cn el que se ha firmad la factura: Firmaprfesinal. DNI-e DNI electrónic españl. CATCERT Agencia Catalana de Certificación ACCV Autridad de Certificación de la Cmunidad Valenciana IZENPE Autridad de Certificación del gbiern vasc ANCERT Agencia Ntarial de Certificación CAMERFIRMA Autridad Certificación de las Cámaras de Cmerci ACA Autridad de Certificación de la Abgacía El cmpradr de la factura es Junta de Cmunidades de Castilla la Mancha. El lte de facturas esta firmad y se cmpne de una única factura Parámetrs de entrada El métd dispne de un únic parámetr de entrada, del tip Facturae32TVerifyRequestType que se ajusta a la siguiente definición. Cm puede apreciarse, esta estructura tiene un únic camp que es un lte de facturas en frmat facturae v3.2, si bien cm se ha indicad anterirmente sól se permite mandar ltes de una factura. La razón ya expuesta es que dich frmat incluye el segment de firma a nivel de lte, y el tratamient y gestión de las facturas es individual, pr l que es necesaria que cada factura sea firmada de frma individual. Fecha Impresión: 08/04/2014 Página 8 de 12

9 Tds ls elements y tips están cntenids en esquemas embebids dentr del.wsdl según crrespnda. A parte se adjunta ls esquemas embebids pr separad. Se adjunta a este dcument el ficher:./facturae32/examples/invicestverifyrequest.xml, cn un ejempl de invcación. La utilización de ls diferentes namespaces en la petición es muy sensible de cara a la verificación crrecta de la factura. Se recmienda especialmente, para evitar prblemas de integración, utilizar ls prefijs para ls diferentes namespaces tal y cm se presentan en el ejempl prpuest, realizand la declaración de cada namespace y su prefij en el primer element xml que l requiera. Así se prpnen la utilización de ls siguientes prefijs: fac : ds: xades: (En el cas de firma XADES-EPES) sapenv: Ests prefijs deben ser establecids antes de realizar la firma del facturae Parámetrs de salida El dcument de salida btenid cm resultad de invcar la peración es del tip InvicesPrcessingRespnseType que se ajusta a la siguiente definición: Tds ls elements y tips están cntenids en esquemas embebids dentr del.wsdl según crrespnda. A parte se adjunta ls esquemas embebids pr separad. Fecha Impresión: 08/04/2014 Página 9 de 12

10 A cntinuación se detalle el significad de ls camps que cmpnen la estructura: isbatchcrrect: Indica si el lte enviad es crrect incrrect. Ls códigs de errr 100,102, 103, 104, 105, 106, 107, 108 y 109 (ver a cntinuación). El lte debe cntener una única factura. Para la factura se devlverá la estructura InvicePrcessingResult que cntiene ls siguientes elements: InviceNumber: Númer de la factura del emisr prcesada. PrcessingStatus: Que en este cas pdrá devlver ls siguiente valres: 100: Errr Inesperad al prcesar la factura. Fall intern del sistema debid alguna causa inesperada, se recmienda esperar a su reslución antes de vlver a invcar la peración. 102: Errr, La factura pertenece a un lte sin firmar (n está presente el segment de firma en el Facturae) y la peración slicitada es de verificación de firma. 103: El lte de facturas cntienen más de una factura. 104: Errr, Credenciales de cntratación inválidas. El prveedr n está cntratad, el cmpradr n es Junta de Cmunidades de Castilla la Mancha, el centr de la Junta n existe. Verificar que ls identificadres fiscales de cada figura sn crrects y el códig del centr. 105: Errr, El frmat del númer de factura es incrrect, ya ha sid utilizad en una factura anterir. Existe una factura cn igual númer de factura para un mism prveedr dentr de un mism añ (según la fecha de expedición). 107: Errr, la factura es del tip rectificativa cpia de rectificativa y n se adjunta la infrmación de la factura que se crrige bien el númer de factura que se crrige es igual que el nuev númer de la factura rectificativa. 108: El frmat de la petición n cumple el frmat especificad en este dcument. 109: La factura n cumple cualquiera de las validacines adicinales exigidas pr la Junta de Cmunidades de Castillas la Mancha 400: La factura ha sid aceptada y queda pendiente de verificación. Fecha Impresión: 08/04/2014 Página 10 de 12

11 Ejempl de respuesta: <SOAP-ENV:Envelpe xmlns:soap-env=" <SOAP-ENV:Header /> <SOAP-ENV:Bdy> <jun:prcesssignedfacturae32respnse xmlns:jun=" <jun:invicesprcessingrespnsetype> <jun:isbatchcrrect>true</jun:isbatchcrrect> <jun:inviceprcessingresults> <jun:inviceprcessingresult> <jun:invicenumber>jccmp1v32</jun:invicenumber> <jun:prcessingstatus>400</jun:prcessingstatus> </jun:inviceprcessingresult> </jun:inviceprcessingresults> </jun:invicesprcessingrespnsetype> </jun:prcesssignedfacturae32respnse> </SOAP-ENV:Bdy> </SOAP-ENV:Envelpe> Pstcndicines de su utilización Las facturas prcesadas, en cas de ser crrectas quedarán en estad pendiente de verificación. Un prces asíncrn (aprximadamente ejecutad cada 2 minuts) las verificará y pasarán a estar en estad firmadas si td ha id crrectamente, errr en cas cntrari Dcumentación adjunta: - WSDL:./facturae32/wsdl/JuntaCMInbundInvicesSecureService.wsdl - Ejempls:. /facturae32/examplesl/ invicestsignrequest.xml. /facturae32/examplesl/ invicestverifyrequest.xml Fecha Impresión: 08/04/2014 Página 11 de 12

12 1.2.4 Dats de invcación Prtcl: Sap 1.1 Sap Binding: Tip de transprte: URL: Preprducción (integración y pruebas) URL: Prducción Certificad: Dcument/literal https 2SecureServicePrxy ices32secureserviceprxy Descargar 2 RESTRICCIONES DE SEGURIDAD La seguridad se establecerá a nivel de transprte y de mensaje, tal y cm a cntinuación se detalla: Nivel de Transprte: Https/ One way SSL, es decir, autenticación de servidr vía SSL, sin autenticación de cliente Nivel de Mensaje: Existirá autenticación a nivel de mensaje la cual se traducirá en el suministr pr parte del cliente de un tken usuari y passwrd en la cabecera del mensaje SOAP. De esta manera, sól usuaris autrizads pdrán acceder al servici. Declarativamente, el suministr del usuari y la passwrd se hará según la siguiente expresión Xpath: declare namespace sapenv=" /sapenv:envelpe/sapenv:header/authenticatin/@username declare namespace sapenv=" /sapenv:envelpe/sapenv:header/authenticatin/@passwrd Fecha Impresión: 08/04/2014 Página 12 de 12