di- emissió e · 1 introducció l’objectiu principal del servei e.fact, promogut per el consorci...
TRANSCRIPT
Realitzatper:ConsorciAOC
Versió:3.1
Fecha:20/3/17
DI- Emissió e.FACT
i DI- Emissio e.FACT v3.1.docx
Controldeldocument
Informaciógeneral
Título: DIEmissioe.FACT
Creatper: ConsorciAOC
Nomdeldocumento: DI-Emissioe.FACTv3.1.docx
Históricoderevisiones
Versió Data Autor Comentaris
3.0 26/10/2016 ServeieFACT ActualitzaciónousestatseFACT.Unificacióguía WS i Integració FTP. Esmenesdiverses.
3.1 20/3/2017 ServeieFACT Esmenesdiverses.
ii DI- Emissio e.FACT v3.1.docx
Index
1 Introducció..................................................................................3
2 HUBe.FACT.................................................................................42.1 Adreçament ................................................................................................................................ 4
2.2 Format codis adreçament ........................................................................................................... 5
3 Connectivitat..............................................................................63.1 Protocols FTP ............................................................................................................................. 6
3.2 Directoris d’intercanvi ................................................................................................................. 6
3.3 Nomenclatura fitxers .................................................................................................................. 7
3.4 Control de finalització de les transferencies ............................................................................... 8
4 Formats.......................................................................................9
5 Missatgesd’estat......................................................................105.1 Servei de consulta Històric estats Factura ............................................................................... 11
5.2 Estats de tramitació .................................................................................................................. 11
5.3 Métode: wsEfHubInvoiceQueryStatus ..................................................................................... 11
5.4 WSDL ....................................................................................................................................... 11
5.4.1Petició ............................................................................................................... 12
5.4.2Resposta .......................................................................................................... 13
6 Gestiódedocumentsadjunts...................................................14
7 Rebutelectrònic.......................................................................15
8 Consultaidentificadoresdereceptorese.FACT........................168.1 Consulta de codis d’adreçament (wsHubDirectionCodesQuery) ............................................. 16
8.1.1WSDL ............................................................................................................... 16
8.1.2Petició ............................................................................................................... 16
8.1.3Resposta .......................................................................................................... 17
9 Notificaciód’errorsenhub.......................................................18
10 Procedimentd’integració.........................................................19
11 Informaciódecontacte.............................................................19
12 ANNEXI:CODISerrorhube.FACT.............................................21
3 26/10/2016 DI- Emissio e.FACT v3.1.docx
1 IntroduccióL’objectiuprincipaldelserveie.FACT,promogutperelConsorciAOC,éseldepermetrel'adopciódelafacturaelectrònicaalesAA.PPcatalanes,comreceptoresd'aquestes,comemisors.El servei e.FACT consisteix en posar a disposició de les AA.PP catalanes i dels seus proveïdors, sistemesd'emissió,recepcióeintercanvidee-facturesquerespondranalesnecessitatsdelsdiferentsparticipantsenelprocès de facturació. Una de les alternatives per realitzar l'intercanvi de factures, i els seus estats dins del'entorne.FACTesatravésdeplataformesprivadesdefacturacióelectrònicaadheridesalservei.
L'objectiu d'aquest document és descriure detalladament la interconnexió necessària per a aquellesplataformesprivadesquedesitginoferirl'intercanvie.FACTalsseususuaris,identificanttantelsformatsausarperal'intercanvidedocuments,aixícomelsdetallsperrealitzaraquestintercanvi.
Finalmenteldocumentinclouladescripciód'altresutilitatsaddicionalsquepodenresultard'interèsdecaraacompletarlaintegracióambelserveie.FACT.HUBe.FACT
4 26/10/2016 DI- Emissio e.FACT v3.1.docx
2 HUBe.FACT
El servei e.FACT permet l'intercanvi de missatges, factures i estats, entre qualsevol dels proveïdors de lesAA.PP.catalanesiaquestes,independentmentdelaplataformadefacturacióelectrònicaemissora(proveïdor)ireceptora(AA.PP.).Amblafinalitatd'aconseguiraquestobjectius'hadefinitunprotocold'interconnexióperaplataformescapalhub.
L'intercanvidedocumentselectrònics,esrealitzaràatravésd'unsistemadebústiesenquècadaplataforma,tindrà una bústia pròpia on dipositarà tots elsmissatges generats per la plataforma i recollirà elsmissatgesdestinatsaentitatsreceptores(AA.PP.)dinsdelaplataforma.
Cadascunade lesplataformesprivadesdelserveie.FACThadeser identificadesdeformaúnicaambuncodid'adreçamentassignat.
Cadaemissorde facturesdinsde l'entorne.FACT tindràun identificadorúnic –Codi d'Adreçament - amb lafinalitat de que els missatges d'estat corresponents a les factures emeses per ell, puguin ser correctamentlliuratsidelamateixaforma,cadaAA.PP.destinatàriadefactures,tindràassignatunidentificadorúnicdinsdel'entorne.FACTamblafinalitatdepoderredirigirlesfacturesconvenientment.
2.1 Adreçament
Elsidentificadorsúnicsdeplataformasóngestionatsperi.FACTicorresponenenlesdiferentsbústiesdinsdelhubd'intercanvi.Aquests identificadorsúnics estan formatsperun identificadordeplataformadinsdelhubi.FACT, i un identificador d'entitat, únic dins de cada plataforma. Aquests identificadors únics d'entitat dinsd'unadeterminadaplataforma,sóngestionatsperlespròpiesplataformes.
Quanunaentitatvolemetreunafacturadinsdel'entorni.FACT,hadeconèixertantalseuidentificadorúnic,comaldel'AA.PP.destinatàriadelafactura.Lesplataformesemissorespodenfacilitarlagestiód'aquestscodisals seususuaris. Enqualsevol cas, totselsmissatges intercanviatsenelhub i.FACThande seguir la següentnomenclaturaenelsnomsdelsfitxersintercanviats:
<id_origen>@<id_destino>@<referencia>
En el cas de les factures, les plataformes emissores han de dipositar els fitxers substituint aneu_origen perl'identificador únic de l'emissor de la factura i aneu_destinació l'identificador de l'AA.PP. receptora de lafactura.Finalmenthauràd'inclouretambéaunidentificadorúniccomareferènciaamblafinalitatdegarantirla traçabilitat i no duplicitat de fitxers. El hub s'encarregarà de lliurar el fitxer a la plataforma receptora(identificadaambelsprimersdígitsdel'identificadordel'AA.PP.receptora).
Iperalsestats,seranlesplataformesreceptoreslesencarregadesdedipositarelsfitxersd'estatgenerats..Permotius de traçabilitat i no duplicitat, s'imprescindible que la plataforma receptora inclogui també unareferènciapròpiaque identifiquielmissatgedinsde laplataforma.Denou,elhubs'encarregaràde lliurarelfitxeralaplataformadel'emissordelafactura.
La gestió de les entitats emissores és interna a les plataformes amb funcionalitat d'emissió, encara que elsidentificadorscorresponentshanderespectarelformatespecificat.
5 26/10/2016 DI- Emissio e.FACT v3.1.docx
2.2 Formatcodisadreçament
Elformatdefinitperalscodisd'adreçamente.FACTéselsegüent:-Les4primeresxifrescoincidiranambelcodidelaplataformaorigenodestinaciódelafactura.Aquestcodiserànumèricis'assignaràpere.FACTacadascunadelesplataformesadherides.-Les12següentsposicionstindranformatalfanumèric,iescorrespondranambl'entitatdinsdelaplataformacorresponent.Aquestsvalorsserangestionatsper lespròpiesplataformes.Pera lesentitatsemissores,elformatéslliurementrequeperalesentitatsreceptoreshad'informar-seelCIFdel'entitatreceptora,enformatinternacionaliambunzeroperdavant(i.g.0ESP6611111C).-Les5següentsposicionshaurandesernumèriquesicorrespondranamblasub-entitat,comperexempledepartaments.Aquestsvalorsserangestionatsperlespròpiesplataformesenfunciódelsrequerimentsdelsseususuaris.
-L'últimaxifraseràelresultatd'aplicarunalgorismealesúltimes17posicions(s'excloupertantles4primeresposicions del codi de plataforma). Haurà de calcular-se al moment d'assignació segons l'algorisme que esdescriuacontinuació.
Peralcàlculdeldígitdecontrols'utilitzaràelsenzillalgorismequeesdescriuacontinuació:
•Pas1:Esnumerenelsdígitsdedretaaesquerra(d'1a17).
•Pas2:Esmultiplicaelvalordelsdígitsenposicionsparisper3ielsqueocupenposicionsimparellsper1isesumenelsproductesresultants(elvalordelscaràcterss'estableixa0).
•Pas3:Esbuscaladesenasuperiordelresultatanterioriselirestaaquestresultat,obteninteldígitdecontrol.
Exempleperl’arrel00010ESP6611111C00001:
0 0 0 1 0 E S P 6 6 1 1 1 1 1 C 0 0 0 0 1 6 0 0 0 0 6 6 1 1 1 1 1 0 0 0 0 0 1 Valor 0 0 0 0 6 18 1 3 1 3 1 0 0 0 0 0 1 Productes
34 Suma6 DC
Resultatdelaresta:3DÍGITDECONTROLELCODI00010ESP6611111C000016
6 26/10/2016 DI- Emissio e.FACT v3.1.docx
3 Connectivitat
L'intercanvi de missatges per a les entitats emissores que interconnectin directament els seus sistemesinformàticsambelhubdelserveie.FACT,esrealitzaràmitjançantelprotocolestàndardFTP.
Tant per a l'emissió de factures i adjunts, com per a la recepció dels missatges d'estat, seran els sistemesinformàticsdelesentitatsemissores,elsqueiniciaranlessessionsd'intercanviFTP.
3.1 ProtocolsFTP
ElsservidorsFTPdelserveie.FACTpermetensessionsusanttantelprotocolestàndardFTP(definitaRFC959),comelprotocolSFTP(definitaRFC4253)queincorporal'úsdecriptografia,ambsistemadeclauspúbliques,amblafinalitatdesecurizarlestransferències.
ElservidorFTPtambépermetràl'úsdelamanerapassivaperalesconnexionsambestàndardFTP,talcomesdescriu enRFC1759.Aquestaopció s'adequadaenels casosqueels sistemesde firewall de les entitats, nopermetinl'oberturadelcanaldedadesdefinital'estàndard.
Enel casque l'entitatesdecantiper l'úsdeSFTP,hauràdeproporcionar laclaupúblicaSSHcorresponental'equipdesuporte.FACT.
3.2 Directorisd’intercanvi
Independentment del protocol d'intercanvi escollit, una vegada iniciada la sessió ftp per part de l'entitat,aquesta tindrà accés a una sèrie de directoris amb la finalitat de realitzar l'intercanvi de missatges, queconformenlabústiad'intercanvienelhub.
Concretamentcadaplataformatindràassignatselssegüentsdirectoris,comaplataformaenmodalitatemissió:
o 'in': directori en el qual la plataforma privada haurà de dipositar els missatges de facturesgeneradespelsseususuarisemissors,jaenelformatiamblasignaturacorresponent.
o ‘adjin’: directori en el qual la plataformaprivada podran dipositar els documents adjunts a lesfactures.
o'statout':directorienelqualelhubd'i.FACTdipositaràtotselsmissatgesd'estatdestinatsausuarisemissorsdinsdelaplataformaenqüestió.Laplataformahauràderecuperardeformaperiòdicatotselsfitxerscontingutseneldirectori.
Tambéestrobendisponibleselssegüentsdirectoris,solamentusatsperplataformesenmodalitatrecepció:
o ‘out’:directorienelqueelhubd'e.FACTdipositarà totes les facturesdestinadesa laplataformaenqüestió. L'entitat receptora haurà de recuperar de forma periòdica tots els fitxers continguts en eldirectori.
o ‘adjout’: directorio en lo que el hub de e.FACT depositará los documentos adjuntos. Destinats a laplataforma en qüestió. L'entitat receptora haurà de recuperar de forma periòdica tots els fitxerscontingutseneldirectori.
o ‘statin’:directorienelque laplataformareceptorahauràdedipositarelsmissatgesd'estatgeneratspelsseussistemesinformàticsidestinatsalsemissorsdelesfactures.
7 26/10/2016 DI- Emissio e.FACT v3.1.docx
3.3 Nomenclaturafitxers
Talicoms’haindicatenl’apartat2.1.,elmètoded’adreçamentdelsmissatgesesrealitzaperlanomenclatura dels fitxers. Es requereix no incloure caràcters especials en aquests camps per garantir lainteroperabilitat.Tambémantenirlesmajúsculesiminúsculesenelsintercanvissuccessius.o EnelcasdeFITXERSDEFACTURESgeneradesperentitatsemissores,esdepositaraneneldirectori 'in' ,
caldràgenerarelsfitxersamblanomenclaturasegüent::
<id_emisor>@<id_receptor>@<referencia>
On:
- <id_emisor>:corresponalidentificadorassignatperlaplataformaal’entitatemissora
- <id_receptor>: a l’identificador assignat al destinatari de la factura (assignat per la plataforma onl’entitatreceptoraconstiinscritaiquesónd’accéspúblic).
- <referencia>: identificador únic com a <referencia> a fi de garantir la traçabilitat i no duplicitat defitxers. Aquest identificador, de format lliure, estarà format per un màxim de 15 caràctersalfanumèrics.
Seràimprescindibleconservarelsidentificadorsd’adreçamentassociatsalafactura,jaqueal’horadegenerarelscorresponentsestatsdesortida,s’haurand’inclourenovamentenelnomdelfitxer.La referència, pròpia de la plataforma emissora, pot ser convenient conservar-la permotius de traçabilitat,encaraquenoserànecessariincloure-laenelnomdelsfitxersd’estatgenerats.És important ressaltar que en cap cas es podran assignar els identificadors de destí en funció d’altresparàmetresdelafacturacompodriaserelNIF/CIFdel’emissor,jaqueunmateixemissorpodríaenviarambdiversos identificadors (depenentdelcanalperqueemeti les factures).Pertant,és imprescindibleconservarelsidentificadorscapturatsenlarecepciódelesfacturesperareutilitzar-losal’horadegenerarelsnomsdelsfitxersd’estat.
o PeralarecepciódeMISSATGESD’ESTAT,destinatsaemissorsdinslaplataformaqueesrecuperarandeldirectori‘statout’,aquestsvindrandinsdefitxersambl’estructuradenomsegüent:
<Id_receptor>@<id_emisor>@<referencia_1>@<hubid>
On,al igualqueabans,esconservenels tresprimerscampsdel fitxerdipositatper laplataformaemissora, is'afegeixl'últimcamp,corresponental'identificadorúnicassignatpelhube.FACT,permotiusdetraçabilitat.
o FITXERSADJUNTSafacturesenviadas.Lanomenclaturaperalsfitxersadjunts,adipositarenemissiódinseldirectori‘adjin’corresponent,éslasegüent:
<Id_origen>@<id_receptor>@<referencia>@<id_adjunto>.<extensión>
Onelstresprimersidentificadorshandecoincidirambelsdelafacturaa laquevanannexats,seguidesd’un<id_adjunt>,ambformatnumèricdetresdígits,il’extensiócorresponentaltipusdefitxer.Ésimportantdestacarquelagestiódedocumentsadjuntspotrealitzar-sedeformaasíncrona,ésadir,espotenviar el/els adjunt/s en qualsevol moment posterior a la tramesa de la factura a què van associats; peròsempre hauran de portar el mateix codi de <referència>, igual al que portava el fitxer amb la facturacorresponent.
8 26/10/2016 DI- Emissio e.FACT v3.1.docx
3.4 Controldefinalitzaciódelestransferencies
Pertaldegarantirqueelsfitxersdipositatsperelssistemesinformàticsdelesplataformesinterconnectadesnosiguinprocessatspelhubabansques’hagincompletat,hihaunmecanismequegaranteixquenoesprocessaràcap fitxer amb antiguitat inferior a 1minut. Tot i així si es preveu que puguin produir-se transferències defitxers individuals, superiors a aquest temps, es posa a disposició de les plataformes amb interconnexió unparelldemecanismesalternatiusperassegurarelnoprocessamentdefitxersincomplerts.Unprimermecanismeconsisteixenferlacàrregadelsfitxers(‘puts’delftp),incloentcomaextensióalnomdefitxerelliteral‘.TMP’(<id_receptor>@<id_emissor>@<referència_1>.TMP).Uncopcompletadalacàrregadelfitxer,caldràreanomenar-lo,eliminantel‘.TMP’inicialdelnom.Elhubnoprocessaràcapmissatgedelsdirectorisentrantsquetinguicomaextensióenelnomdelfitxerelliteral‘.TMP’. Unmecanismealternatiu,d’úsfreqüentenl’intercanvientresistemesviaftp,ésunsistemade‘flags’queconsisteixentenirunaestructuradedirectorisduplicadasotaundirectoriflags.Quans’haderealitzarlacàrregad’unfitxer,primeresrealitzael‘put’corresponentdelfitxerenqüestiócapaldirectoridelservidordestí.Uncopfinalitzadalatransferència,esrealitzalatransferènciad’unfitxersensecontingutcapaldirectoricorresponent,aquestcopdinsdeldirectoriflagsiambelmateixnomqueelfitxeroriginaldipositataldirectoridetreball.Enaquestcaselhube.FACTactivaràelprocessamentdelfitxersempreperalsfitxersdipositatssotaeldirectoriflags,deformaques’asseguraqueelfitxerdetreballjaestàcompletamenttransmès.Siespreveuusaraquestdarrermètodeperassegurarlatransferènciadelsfitxers,caldrànotificar-hoalserveidesuportd’e.FACTenelmomentlasol·licitarlainterconnexiódeplataforma.Pelquefaalabaixadadefitxersdelsdirectorisdesortidadelhub(*out)mitjançantelsgetscorresponents.Laimplementaciódelhubgaranteixqueelsfitxersdipositatsenelsmateixossempresóncomplets.Pertant,noésnecessariestablircapsistemapergarantirlasevacompletatransmissió.Entotselscasos,ésresponsabilitatdelesplataformesquerealitzenlesbaixadesdefitxers,l’eliminaciód’aquestsuncopbaixats,pertaldenoserprocessatsdenouenunaconnexióposterior.Hihauràunprocésquedeformaperiòdicaeliminaràtotselsmissatgesdinselsdirectorisd’entrega;aquestmateixprocéseliminaràtotsaquellsmissatgesambd’unaantiguitatsuperioralaqueestableixil’e.FACT.
9 26/10/2016 DI- Emissio e.FACT v3.1.docx
4 Formats
Elformatsuportatpelserveie.FACTésXMLfacturae(3.2i3.2.1),definitainstànciesd'hoAgenciaTributàriaielMinisterid'Indústria, Turisme iComerç,ocorreràobligatoripera les factureselectròniquesenviadesa lesadministracionspúbliques(AdministracióGeneraldel'Estatiorganismespúblicsvinculatsodependentsdelamateixa).
Encaraquelaplataformae.FACTsuportalesdiferentsversionsdelformatfacturae,esrecomanal'úsdel'últimaversió publicada del format, almoment de realitzar la integració amb el servei. Es pot trobar la informaciórelativaalformat,aixícomelsseusdiferentsversionsalapáginawebwww.facturae.gob.es.
Totes les factures intercanviadesdinsde l'entorn i.FACTdeuenportar la corresponent signaturaelectrònica,d’acordalapolíticadesignaturavigentdefacturae(Facturae.es>Documentación>Políticasdefirma).
D'altrabanda,elserveii.FACTcontemplal'emissiódefacturesenformatEDIFACT,pensantenproveïdorsquejapuguinestarfentúsd'est, ivistesaevitar-los l'adaptacióafacturae.Enaquestcaselservei i.FACTrealitzaunaconversióalformatfacturae3.2, incrustantlafacturaoriginalenelnodeRelatedDocumentsdelfacturaegenerat. El tractament de les factures en aquests casos és equivalent a la resta, tret que en aquest cas calrealitzarunadoblevalidaciódesignatura:d'unabandalavalidaciódelasignaturadelfacturae, id'unaltrelavalidació de la signatura original EDIFACT incrustat. Per a aquesta última validació hi ha definit un serveiaccessibleviaweb,enlaqualespotpujarelfacturaeambelEDIFACToriginal,peralavalidaciód'est.
Pelque faal formatdelsmissatgesdenotificaciód'estatspera les factures, agenerarpels receptorsde lesmateixes, o en cas de rebot per part d'algun dels sistemes informàtics almig, s'ha definit un XML d'estatsdisponible com ‘DeliveryFeedback.xsd’, disponible dins de l'apartat de documentació tècnica del Portal deSuportdel’eFACT.
Totselsmissatgesintercanviatsenelhube.FACTsónvalidatspelmateix1,ipertant,esgaranteixquetotselsmissatgeslliuratspelhubalesplataformesosistemesinterconnectatsalmateix,tenenunformatvàlid.
1 Aexcepciódelsfitxersadjunts,quesimplements’entreguenalaplataformadestinatàriadelmateixos.
10 26/10/2016 DI- Emissio e.FACT v3.1.docx
5 Missatgesd’estatLesPlataformesemissorestindranaccésalssegüentsestatsproporcionatsperlesadministracionspúbliquesalserveieFact.Encadascundelsestatsesproporcionaelcodinumèric (StatusCode)assignatcomplementarialstatusalfanumèric(status).Elsestatstècnicsiobligatorismínimsquerebràunemisord’unafacturaseran:o FacturaEnviada(status=’SENT’):Lafacturahaestatlliuradapelserveie.FACTalaAAPPcorresponent.
-Aquestestatéscreatautomàticamentpelserveie.FACTitransmèsalProveïdorquehaemèslafactura-Enelcasqueelhube.FACTnopuguilliurarlafacturaenlaplataformareceptora,generaràelcorresponentestatderebot('REJECTED')indicantl'error.Potconsultarelspossibleserrors,icodiscorresponents,enl'annex'Codiserrorhube.FACT',alfinald'aquestdocument CodiEstatPúblic(StatusCode):1000o Factura registrada (status=’REGISTERED’): La factura Electrònica ha estat rebuda en el punt generald'entradadefacturesi.FACTihaestatregistradaadministrativament,proporcionantunnombrederegistrealproveïdor.- En el node RegisterNumber s'informarà tant el nombre de registre com la data i hora de registre (eg'I/000019-20132013-02-13T11:16:48.000+01:00').Noconfondreladataderegistre,ambladatadenotificaciódel'estatStatusDate.- Sempre s'ha de rebre l'estat 'REGISTERED' posterior al SENT, independentment que les factures siguinconformadesorebutjadespelsreceptors.
CodiEstatPúblic(StatusCode):1200oFacturaRegistradaenRCF(status=ANNOTATED):Lafacturaelectrònicahaestatrebudairegistradaenelregistrecomptabledefacturesdel'oficinacomptabledestinatària.LaAAPPpodràinformarelCodiRCFassignatcomaNombredeRegistreComptable(RcfRegNumber) CodiEstatPúblic(StatusCode):1300oComptabilitzadal'obligacióreconeguda(status=‘RECOGNISED’):L'obligaciódepagamentderivadadelafacturahaestatreconeguda.. CodiEstatPúblic(StatusCode):2400oFacturapagada(status=’PAID’):L'obligaciódepagamentderivadadelafacturahaestatpagada. CodiEstatPúblic(StatusCode):2500o Facturarebutjada(status=’REJECTED’):lafacturahaestatrebutjada.Elmotiuderebuigpotserpercauses
tècniques,que impedeixenel lliuramentde la facturaa l'usuari (generatsautomàticamentpels sistemesinformàtics), opot ser l'usuari qui rebutgi la facturapermotius comercials. Les aplicacionsdegestiódefacturació electrònica a la disposició dels usuaris, han de permetre la generació d'aquest estat,possibilitantal'usuaril'entradadelmotiuderebot.Semprequeesprodueixiunrebuig,jasiguipermotiustècnicsoper l'usuari,s'hauràdegeneraraquestestat.Lapublicaciód'aquestestatésobligatòriasemprequeesdetectiunaincidènciaamblafacturaqueimpedeixilasevatramitació
CodiEstatPúblic(StatusCode):2600
11 26/10/2016 DI- Emissio e.FACT v3.1.docx
5.1 ServeideconsultaHistòricestatsFactura
e.FACTposaa ladisposiciódelsproveïdors lapossibilitatde realitzar la consultad'estatsd'unadeterminadafactura.S'hand'especificarlesdadesidentificativesd'unafactura,is'obtécomarespostaunmissatgeXMLquecontétotselsestatsidetallsdelsmateixos,pelsqualshapassatlafacturaenqüestió.
El codi d'estat es correspon amb un identificador que permet diferenciar les comunicacions d'estats entrediferents plataformes independentment de les denominacions que poguessin tenir internament cadascund'ells.
5.2 Estatsdetramitació
NomeFACT Status StatusCode Descripció
Registrada REGISTERED 1200 Lafacturahaestatregistradaenelregistreadminstratiu.
RegistradaenRCF ANNOTATED 1300 La factura ha estat registradacomptablement.
Comptabilitzadal’obligacióreconeguda
RECOGNISED 2400 L’obligació de pagament derivada de lafacturahaestatreconeguda
Pagada PAID 2500 Facturapagada
Rebutjada REJECTED 2600 Facturarebutjada
Anul·lada CANCELED 3100 Facturaanul·lada
5.3 Métode:wsEfHubInvoiceQueryStatus
Aquestmètodepermetlaconsultad'estatsd'unadeterminadafacturaregistradaene.FACT.
Apesarqueelsestatsdelesfacturessónrealimentadoscapalsemissorsdelesmateixes,depenentdelmitjàd'emissiód'aquests,potserquenodisposind'unhistòricd'enviamentambelscorresponentsestats.Enaquestcas,podranrealitzarlaconsultadel'històricd'estatsd'unadeterminadafactura,atravésd'aquestservei.
5.4 WSDL
Endpoint:https://efact.eacat.cat/HubConector/services/HubConnectorWS
WSDL:https://efact.eacat.cat/HubConector/services/HubConnectorWS?wsdl
12 26/10/2016 DI- Emissio e.FACT v3.1.docx
5.4.1 Petició
5.4.1.1 PARÁMETRES
Nom Descripció
HUBusersenderid Codiadreçamentcompletdel'emissordelesfactures
HubInfoAdd Siesrepaquestelementambelvalor“TRUE”,s'afegiràalarespostalainformaciódetrazabilidadsobrel'intercanviquecontenialafacturabuscada(node“HubFeedback”).
INVOICEnumber Nomdelafacturaabuscar
INVOICEdate Anyfiscaldefacturaabuscar(FormatYYYY).
INVOICEsupplier NIFdelvenedor
INVOICEbuyer NIFdelcomprador.
INVOICEtotal Importtotaldelafactura
Lapeticiónestádefinidaenelpropiowsdl.Acontuaciónapareceunejemplodepetición:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"xmlns:hub="http://hubConnectorWS.seresnet.com"><soapenv:Header/><soapenv:Body><hub:wsEfHubInvoiceQueryStatus><hub:HUBusersenderid></hub:HUBusersenderid><hub:HubInfoAdd>TRUE</hub:HubInfoAdd><hub:INVOICEnumber>20002</hub:INVOICEnumber><hub:INVOICEdate>2016</hub:INVOICEdate><hub:INVOICEsupplier>ESB73101420</hub:INVOICEsupplier><hub:INVOICEbuyer>ESQ1111111A</hub:INVOICEbuyer><hub:INVOICEtotal>231,00</hub:INVOICEtotal></hub:wsEfHubInvoiceQueryStatus></soapenv:Body></soapenv:Envelope>
- Un exemple d'ús d'aquest servei la hi consulta cega d'estats des de la bústia de lliurament (veureManual d'Usuària Bústia de Lliurament). Però també es posa a la disposició d'altres plataformesemissores,amblafinalitatdepermetreconsultespuntualsalsseususuaris.
- A causa que la consulta podrà retornar més d'una factura que compleixi la condició, al no podergarantir-sequel'emissordelafacturahagienviatlamateixafacturaunasolavegada,eldocumentXmlretornat podrà contenir més d'un node “StatusFeedback”, un per cada factura que compleixi lacondició.
- Alseutorncadafacturapodràcontenirunodiversosnodes“Feedback”,enfunciódelnombred'estatsrebutsenelHubperaunafactura,pertant,esretornaditahistòricad'estats.Elsnodes“Feedback”haurand'aparèixerordenatsdescontentament(estatmésmodernprimer).
- ElmissatgeXMLretornatpodràcontenir informaciódetraçabilitatsobreel fitxerenelqualviatjo lafacturasol·licitadaenelnode“HubFeedback”.Lageneraciód'aquestnodesolamentesduràatermesiaixísesol·licitaeneldocumentXMLquerebicomapeticióelHub.
13 26/10/2016 DI- Emissio e.FACT v3.1.docx
5.4.2 Resposta
Larespostaestàdefinidaenl’esquema:DeliveryFeedback.xsdRepresentaciógràficadelaresposta:
Enelpunt5.2EstatsdeTramitacióapareixelresumdelsestatsjuntamentambelseunom,codiidescripció.Elnomescorresponambelnomdel'estat.
14 26/10/2016 DI- Emissio e.FACT v3.1.docx
6 Gestiódedocumentsadjunts
Tal icoms'ha indicata l'apartatdeconnectivitat,existeix lapossibilitatqueelsemissorsdefacturacióenviïndocuments adjunts a aquestes factures. L'enviamentd'aquestsdocumentshade fer-serde forma síncrona iposterioralarecepciódelafacturaqueportaassociadaelsadjuntsperpartdelreceptordelamateixa.Aquestenviamentesrealitzaràdipositanteldocumenteneldirectori‘adjin’corresponentsalaplataformaemissora,respectantlanomenclaturaindicadaadalt.
Elhubs'encarregaràderecolliraquestsfitxersdelsdirectorisdelesplataformesemissoresielsdipositaràenlaplataformadel'entitatreceptora.
Abansdedipositarlafacturaenlacarpetadeldestinatari,elhubcomprovaràquelafacturaassociadaestiguijaregistradaienelhub.Enelcasquenoeslocalitzilafacturaalaqualeldocumentvaassociat,esrealitzentresreintentsambdeuminutsdemargeentreells.Desprésdeltercerintent,siencaranoeslocalitzalafactura,esdescartaelfitxeriesgeneraunestatd'errorindicantelmotiudelrebuig.Aquestfitxerd'erroresdipositaràeneldirectori‘statout’delaplataformaqueharealitzatl'enviamentdelmateix,perquèaquestahotractiiinformial'emissordeldocumentadjunt.
Únicament es permet adjuntar fitxers en formatpdf, doc, docx, xls, xlsx, odt, ods, txt, csv, jpg o jpeg i esrecomanaquesiguind’unmàximde1,8MB.
15 26/10/2016 DI- Emissio e.FACT v3.1.docx
7 Rebutelectrònic
Amaneradeconfirmacióderegistredelesfacturesalesadministracionspúbliquesreceptores,almomentenquèesreplainformacióderegistrealhube.FACT,esprocedeixagenerarundocumentpdfsignatquecridemrebut electrònic. Est conté, a més de la informació de registre, còpia impresa de la factura. Aquest rebutelectrònic es lliura tant a la plataforma emissora, com la plataforma receptoramitjançant la generació d'unarxiud'estataddicional('REGISTERED'),ambeldocumentdescritenelnodeElectronicAcknowledgment.Tantper a les plataformes emissores com per a les receptores, aquest arxiu d'estat es dipositarà en el directori'statout'corresponent.Lesplataformeshandefacilitaralsseususuarisl'accésaaquestsdocuments.
Enelcasquel'administracióreceptoranohagidelegatelregistredefacturesalservei i.FACTielhubdetectifacturesquenohanestat registradesdinsdel terminide24horesposterioral lliuramentde la facturaen laplataformareceptora,elhubprocediràalarealitzaciódelregistredeformaautomàticaenelRegistreUnificatdelConsorciAOC.Aquestregistreproduiràlacorresponentnotificaciód'estattantenlaplataformaemissoracomlaplataformareceptora,iinclouràelrebutelectrònicdescritenelparàgrafanterior.
16 26/10/2016 DI- Emissio e.FACT v3.1.docx
8 Consultaidentificadoresdereceptorese.FACT
e.FACTproporcionaunserveiwebdeconsultadecodisd'adreçamentamblafinalitatdeproporcionaralsseususuaris,elsidentificadorsperlesAA.PP.receptoresnecessàriesperalcorrecteenrutamentdelesfactures.
Lesplataformespodransol·licitar,béel llistatcompletdecodis,amblessevescorresponentsdadesd'entitatreceptoraassociadaielseuCIF,obérealitzarlaconsultaperundeterminatCIFocodid'adreçament.
FernotarqueperaundeterminatCIFpodenaparèixerdiversoscodisd'adreçamentactius.Aquestseriaelcas,perexemple,d'unaAA.PP.quedesitgiredirigirlasevafacturacióadiferentsdepartaments.
8.1 Consultadecodisd’adreçament(wsHubDirectionCodesQuery)
8.1.1 WSDL
Endpoint:https://efact.eacat.cat/HubConector/services/HubConnectorWS
WSDL:https://efact.eacat.cat/HubConector/services/HubConnectorWS?wsdl
8.1.2 Petició
Lapeticióestàdefinidaen‘esquema:HubPartnerListQuery.xsdRepresentaciógràficadelapetició:
Exempledepetició:<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"xmlns:hub="http://hubConnectorWS.seresnet.com"><soapenv:Header/><soapenv:Body><hub:wsHubDirectionCodesQuery><hub:xml>ESQ1111111A</hub:xml></hub:wsHubDirectionCodesQuery></soapenv:Body></soapenv:Envelope>
17 26/10/2016 DI- Emissio e.FACT v3.1.docx
8.1.3 Resposta
Larespostaestàdefinidaenl'esquema:HubPartner.xsdRepresentaciógràficadelaresposta:
18 26/10/2016 DI- Emissio e.FACT v3.1.docx
9 Notificaciód’errorsenhub
S'haestablertunmecanismedenotificaciód'errorsproduïtsdinsdelhubdelserveii.FACT,perlaqualcosaesnotifiquen de forma automàtica, les possibles incidències detectades dins del hub, i no informades en elsmissatgesd'estatespecificatsanteriorment.
Cadascundelesplataformesinterconnectadesalhub,tindràassociadaunaadreçadecorreuelectrònic(SMTP),ons'enviaranelsmissatgesdenotificacióproduïtspelhub.Seràresponsabilitatúnicadelreceptordelcorreudenotificaciód'error,elrevisarisiescau,corregirlaincidènciadelaquals'informa.
Inicialments'estableixunanotificaciódiàriaatoteslesplataformesenlaqualesdetectinfitxerspendentsderecuperació per part d'aquestes, amb antiguitat superior a les tres hores. D'aquesta forma les plataformespodendetectarpossiblesanomaliesenelprocésd'integracióambelhube.FACT
19 26/10/2016 DI- Emissio e.FACT v3.1.docx
10 Procedimentd’integració
Persol·licitar la integracióenel serveie-FACT,si-us-plau,consultien l’espaideSuportaEmpresesdelserveieFACTenelportaldesoportdelConsorciAOC:
https://web.aoc.cat/suport/efact-empreses/
Un cop la seva sol·licitudhagi estat rebuda i validadaperpartdel ConsorciAOC, la persona indicada comainterlocutoraenelprocedimentd’alta,rebràpercorreuelectròniciassociataunnúmerodetiquet,lesdadesd’altaenelserveieFACTdel’entorndePRODUCCIÓiPREPRODUCCIÓpertaldeduratermelaintegració:
o USUARI:hub_XXXXo CONTRASENYA(FTP):---------o Codideplataforma:XXXXo Codid'adreçament:XXXXXXXXXXXXXXXXXXXXXX
Dinsdel’Efacts’assiganràalaentitatunidentificadorúnicdeplataformareceptora(codideplataforma).Talicom s’ha indicat en l’apartat corresponent, aquest codi identifica una carpeta dins del HUB i, per tant, téassociatselsdirectorisd’intercanvisFTPcorresponents.
La plataforma en integració haurà de generar i dipositar al directori corresponent, ‘in’, factures que com amínimcontemplinlessegüentscasuístiques:
o Facturesambcodidereceptornovàlid.o Facturesambcertificatnovàlid.o Facturesambsignaturanovàlida.o Facturescorrectes.Comamínimunad’ellescalqueesrebutgiambunmissatgederebuigperpartde
l’usuarireceptor.
Addicionalment,recuperarelsestatsdelesfacturesenviadesdesdeldirectori'out' iprobartambélacàrregad’arxiusadjuntsexternsalafacturaatravésdeldirectorid’adjunts‘adjin’.
Per a la generació dels estats de retorn de les factures de proves i la comprovació de la recepció de lesmateixes,esposaràadisposiciódel’integradorl’aplicacióderecepciódefacturesdel’entorndepreproducció(portaldelreceptor)ambdadesgenèriques(ESQ1111110P-ESQ1111119P)ambl’objectiudepodersimularelcomportamentd’unreceptor/administraciópública.
URLsactualsdel’entorndeproves:
• Bústiesdelliurament:https://aocpre.e-factura.net/bustia/?emisorId=0• Webservices:https://aocpre.e-factura.net/HubConector/services/HubConnectorWS• Portaldelreceptor:https://aocpre.e-factura.net/jsp/test.jsp
Noestàprevistalarealitzaciódeprovesd’acceptacióal’entorndePROuncopvalidadalaintegracióenPRE.
A l’apartat de documentació de integració al servei eFACT hi ha XML d’exemple d’estats i altres fitxers dedescripciódelsserveiswebdelserveieFACT(XSD,WSDL,etc..).
20 26/10/2016 DI- Emissio e.FACT v3.1.docx
11 Informaciódecontacte
PerconèixerelsCanalsdeSuportiContacte,si-us-plau,consultil’espaideSuportaEmpresesdelserveieFACTenelPortaldeSuportdelConsorciAOC:
https://web.aoc.cat/suport/efact-empreses/
21 26/10/2016 DI- Emissio e.FACT v3.1.docx
12 ANNEXI:CODISerrorhube.FACT
Veureeldocumentamb títol “codisde rebuigefact”en l’espaide suportaempresesdel serveieFACTenelPortaldeSuportdelConsorciAOC:
https://web.aoc.cat/suport/efact-empreses/