DI- Emissió e · 1 Introducció L’objectiu principal del servei e.FACT, promogut per el Consorci...

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


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.


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


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.


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.


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.


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.


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


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


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.


5.4.2 Resposta

Larespostaestàdefinidaenl’esquema:DeliveryFeedback.xsdRepresentaciógràficadelaresposta:

Enelpunt5.2EstatsdeTramitacióapareixelresumdelsestatsjuntamentambelseunom,codiidescripció.Elnomescorresponambelnomdel'estat.


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.


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.


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>


8.1.3 Resposta

Larespostaestàdefinidaenl'esquema:HubPartner.xsdRepresentaciógràficadelaresposta:


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


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..).


11 Informaciódecontacte

PerconèixerelsCanalsdeSuportiContacte,si-us-plau,consultil’espaideSuportaEmpresesdelserveieFACTenelPortaldeSuportdelConsorciAOC:



12 ANNEXI:CODISerrorhube.FACT

Veureeldocumentamb títol “codisde rebuigefact”en l’espaide suportaempresesdel serveieFACTenelPortaldeSuportdelConsorciAOC:


DI- Emissió e · 1 Introducció L’objectiu principal del servei e.FACT, promogut per el Consorci...

Documents

Transcript of DI- Emissió e · 1 Introducció L’objectiu principal del servei e.FACT, promogut per el Consorci...