DI- Recepció e · 1 Introducció L’objectiu principal del servei e.FACT, promogut per el Consorci AOC, és el de permetre l'adopció de la factura electrònica a les AA.PP catalanes,

Realitzatper:ConsorciAOC

Versió:3.1

Fecha:20/3/17

DI- Recepció e.FACT

Guía de integración para plataformas privadas al servicio e.FACT

18/07/2013 DI- Recepcio e.FACT v3.1.docx

Pág 1/22

Controldeldocument

Informaciógeneral

Título: DI-Recepcióe.FACT

Creatper: ConsorciAOC

Nomdeldocumento: DI-Recepcioe.FACTv3.1.docx

Históricoderevisiones

Versió Data Autor Comentaris

3.0 20/12/2016 ServeieFACT ActualitzaciónousestatseFACT.Unificacióguía WS i Integració FTP. Esmenesdiverses.

3.1 20/3/2017 ServeieFACT Esmenesdiverses.

Guía de integración para plataformas privadas al servicio e.FACT

18/07/2013 DI- Recepcio e.FACT v3.1.docx

Pág 2/22

Índice 1 Introducció ................................................................................................................................... 3

1.1 Objectiu ...................................................................................................................................... 3

2 HUB e.FACT .............................................................................................................................. 4

2.1 Adreçament ................................................................................................................................. 4

2.2 Formatcodisd’adreçament ........................................................................................................... 5

3 Connectivitat ................................................................................................................................ 6

3.1 ProtocolsFTP ................................................................................................................................ 6

3.2 Directorisd’intercanvi ................................................................................................................... 6

3.3 Nomenclaturadelsfitxes ............................................................................................................... 7

3.4 Control finalització transferències .............................................................................................. 8

4 Formats ....................................................................................................................................... 9

5 Missatges d’estat ...................................................................................................................... 10

5.1 Servei de consulta Històric estats Factura ............................................................................... 11

5.2 Estats de tramitació .................................................................................................................. 12

5.3 Mètode: wsEfHubInvoiceQueryStatus ..................................................................................... 12

5.4 WSDL ....................................................................................................................................... 12

5.4.1Petició ............................................................................................................... 13

5.4.2Resposta .......................................................................................................... 14

6 Gestió de documents adjunts ................................................................................................... 15

7 Rebut electrònic ....................................................................................................................... 16

8 Consulta d’identificadors de receptors e.FACT ........................................................................ 17

8.1 Consulta de codis d’adreçament (wsHubDirectionCodesQuery) ............................................. 17

8.1.1WSDL ............................................................................................................... 17

8.1.2Petició ............................................................................................................... 17

8.1.3Resposta .......................................................................................................... 18

9 Notificació d’errors al hub ......................................................................................................... 19

10 Procediment d’integració .......................................................................................................... 20

11 Informació de contacte ............................................................................................................. 21

3 26/10/2016 DI- Recepcio e.FACT v3.1.docx

1 Introducció

L’objectiuprincipaldelserveie.FACT,promogutperelConsorciAOC,éseldepermetrel'adopciódelafacturaelectrònicaalesAA.PPcatalanes,comreceptores,ialsproveïdorsd’aquestes,comaemissors.El servei e.FACT consisteix en posar a disposició de les AA.PP catalanes i dels seus proveïdors, sistemesd'emissió,recepcióiintercanvidee-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.

1.1 Objectiu

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,comaralaconsultapuntuald'estatsolapossibilitatderegistreofertpelCAOC,quehandecontemplartoteslesplataformesprivadesenmodalitatderecepció.


2 HUB e.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.

A més de la funcionalitat habitual contemplada per les plataformes de facturació electrònica, caldrà queaquestes contemplin la correcta gestió de la informació d'estats que es requereix generin les entitatsreceptoresipuguinserconsultatsperlesentitatsemissorescorresponents.

CadascunadelesAA.PP.destinatàriadefactures,tindràassignatunidentificadorúnicdinsl'entorne.FACTpertaldepoderredirigirlesfacturesconvenientment.

2.1 Adreçament

Elsidentificadorsúnicsdeplataformasóngestionatspere.FACTicorresponenenlesdiferentsbústiesdinsdelhubd'intercanvi.Aquests identificadorsúnics estan formatsperun identificadordeplataformadinsdel hube.FACT, i un identificador d'entitat, únic dins de cada plataforma. Aquests identificadors únics d'entitat dinsd'unadeterminadaplataforma,sóngestionatsperlespròpiesplataformes.

Quanunaentitatvolemetreunafacturadinsdel'entorne.FACT,hadeconèixertantalseuidentificadorúnic,comaldel'AA.PP.destinatàriadelafactura.Lesplataformesemissorespodenfacilitarlagestiód'aquestscodisals seususuaris.Enqualsevolcas, totselsmissatges intercanviatsenelhube.FACThandeseguir la següentnomenclaturaenelsnomsdelsfitxersintercanviats:

<id_origen>@<id_destino>@<referencia>

En el cas de les factures, les plataformes emissores han de dipositar els fitxers substituint id_origen perl'identificador únic de l'emissor de la factura i id_destino l'identificador de l'AA.PP. receptora de la factura.Finalment haurà d'incloure també a un identificador únic com a referència amb la finalitat de garantir latraç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.Enaquest cas caldrà substituir id_origen per l'identificador de la AA.PP. que genera l'estat, i id_destinol'identificador de l'emissor de la factura per a la que s'està generant l'estat. Permotius de traçabilitat i noduplicitat,ésimprescindiblequelaplataformareceptoraincloguitambéunareferènciapròpiaqueidentifiquielmissatgedinsdelaplataforma.Denou,elhubs'encarregaràdelliurarelfitxeralaplataformadel'emissordelafactura.


Totes les plataformes privades que actuïn com a receptores, estan obligades a informar a e.FACT de lesentitatsreceptoresgestionadesperelles,aixícomdelsseusidentificadorscorresponents,pertaldepoderferpúblicsaquestsidentificadorsatotselspossiblesemissorsdefacturació.

En elmoment de sol·licitar l'alta en el servei per part d'un ens receptor, aquest ha d'indicar la plataformareceptora que farà servir. El servei e.FACT assignarà el corresponent identificador, que ha de coincidir ambl'assignatperlaplataformareceptora.

La gestió de les entitats emissores és interna a les plataformes amb funcionalitat d'emissió, encara que elsidentificadorscorresponentshanderespectarelformatespecificat.

2.2 Formatcodisd’adreç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(e.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 receptores que interconnectin directament els seus sistemesinformàticsambelhubdelserveie.FACT,esrealitzaràmitjançantelprotocolestàndardFTP.

Tantpera la recepcióde factures i adjunts, compera la recepciódelsmissatgesd'estat, seranels sistemesinformàticsdelesentitatsreceptores,elsqueiniciaranlessessionsd'intercanviFTP.

3.1 ProtocolsFTP

ElsservidorsFTPdelserveie.FACTpermetensessionsusanttantelprotocolestàndardFTP(definitaRFC959),comelprotocolSFTP(definitaRFC4253)queincorporal'úsdecriptografia,ambsistemadeclauspúbliques,amblafinalitatdesecuritzarlestransferències.

ElservidorFTPtambépermetràl'úsdelamanerapassivaperalesconnexionsambestàndardFTP,talcomesdescriuenRFC1759.Aquestaopciós'adequaalscasosqueelssistemesdefirewalldelesentitats,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.

Concretament cada plataforma tindrà assignats els següents directoris, com a plataforma en modalitatrecepció:

• ‘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.

• ‘adjout’: directori en el que el hub d’e.FACT depositarà els documents adjunts destinats a laplataforma en qüestió. L'entitat receptora haurà de recuperar de forma periòdica tots els fitxerscontingutseneldirectori.

• ‘statin’:directorienelquelaplataformareceptorahauràdedipositarelsmissatgesd'estatgeneratspelsseussistemesinformàticsidestinatsalsemissorsdelesfactures.

Tambéestrobendisponibleselssegüentsdirectoris,únicamentusatsperplataformesenmodalitatemissió:• 'in':directorienelque laplataformaprivadahauràdedipositarelsmissatgesdefacturesgenerades

pelsseususuarisemissors,jaenelformatiamblasignaturacorresponent.• ‘adjin’:directorienelquelaplataformaprivadapodrandipositarelsdocumentsadjuntsalesfactures.• 'statout': directori enel queelhubd'e.FACTdipositarà tots elsmissatgesd'estatdestinatsausuaris

emissorsdinsdelaplataformaenqüestió.Laplataformahauràderecuperardeformaperiòdicatotselsfitxerscontingutseneldirectori.


3.3 Nomenclaturadelsfitxes

Talicoms’haindicatenl’apartat2.1.,elmètoded’encaminamentdelsmissatgesesrealitzaperlanomenclatura dels fitxers. Es requereix no incloure caràcters especials en aquests camps per garantir lainteroperabilitat.Tambémantenirlesmajúsculesiminúsculesenelsintercanvissuccessius.

o EnelcasdeFITXERSDEFACTURASREBUDES,generadesperentitatsemissores,esdipositaranpelhubaldirectori'out',amblanomenclatura:

<id_emisor>@<id_receptor>@<referencia>@<hubid>

On:- <id_emisor>:corresponalidentificadorassignatperlaplataformaal’entitatemissora- <id_receptor>: a l’identificador assignat al destinatari de la factura (assignat per la plataforma on

l’entitatreceptoraconstiinscritaiquesónd’accéspúblic).- <referencia>: identificador únic com a <referencia> a fi de garantir la traçabilitat i no duplicitat de

fitxers. Aquest identificador, de format lliure, estarà format per un màxim de 15 caràctersalfanumèrics.

- < hubid >: Identificador únic assignat pel HUB. per tal de garantir la traçabilitat i no duplicitat defitxers.Estaràformatperunmàximde15caràctersalfanumèrics

Seràimprescindibleconservarelsidentificadorsd’encaminamentassociatsalafactura,jaqueal’horadegenerarelscorresponentsestatsdesortida,s’haurand’inclourenovamentenelnomdelfitxer.TambécalmantenirexactamentLa referència, pròpia de la plataforma emissora, pot ser convenient conservar-la permotius de traçabilitat,encaraquenoserànecessariincloure-laenelnomdelsfitxersd’estatgenerats.

o Enel casdeFITXERSD'ESTATS destinats a emissorsdins la plataformaquees recuperarandel directori‘statout’,aquestsvindrandinsdefitxersambl’estructuradenomsegüent:

<id_receptor>@<id_emisor>@<referencia_1>

On,al igualqueabans,esconservenels tresprimerscampsdel fitxerdipositatper laplataformaemissora, is'afegeixl'últimcamp,corresponental'identificadorúnicassignatpelhube.FACT,permotiusdetraçabilitat.És important ressaltar que en cap cas es podran assignar els identificadors de destí en funció d’altresparàmetresdelafacturacompodriaserelNIF/CIFdel’emissor,jaqueunmateixemissorpodriaenviarambdiversos identificadors (depenentdelcanalperqueemeti les factures).Pertant,és imprescindibleconservarelsidentificadorscapturatsenlarecepciódelesfacturesperareutilitzar-losal’horadegenerarelsnomsdelsfitxersd’estat.

o FITXERSADJUNTSafacturesenviades.Lanomenclaturaperalsfitxersadjunts,adipositarenemissiódinseldirectori‘adjin’corresponent,éslasegüent:

<id_origen>@<id_receptor>@<referencia>@<id_adjunto>@<hubid>@<hubid_f>

Onesconservenelsquatreprimerscampsdelfitxerdipositatperlaplataformaemissora,is'afegeixenelsdosúltims camps, corresponents a l'identificador únic assignat pel hub e.FACT, així com l'identificador assignatprèviamentpelhube.FACT,a la facturaa laqual vaassociateldocumentadjunt.Aquestsdosúltimscampss'afegeixenpermotiusdetraçabilitat.É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 Control finalització transferències 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,ésresponsabilitatdelesplataformesque realitzen lesbaixadesde fitxers, l’eliminaciód’aquestsun copbaixats, per tal deno serprocessats denouenuna connexióposterior.Hi hauràunprocésquede formaperiòdica eliminarà tots elsmissatges dins els directoris d’entrega; aquest mateix procés eliminarà tots aquells missatges amb d’unaantiguitatsuperioralaqueestableixil’e.FACT.


4 Formats

Elformatsuportatpelserveie.FACTésXMLfacturae(3.2i3.2.1),definitainstànciesdel’AgenciaTributàriaielMinisterid'Indústria,TurismeiComerç,establertcomobligatoriperalesfactureselectròniquesenviadesalesadministracionspúbliques(AdministracióGeneraldel'Estatiorganismespúblicsvinculatsodependentsdelamateixa).

Encaraquelaplataformae.FACTsuportalesdiferentsversionsdelformatfacturae,esrecomanal'úsdel'últimaversiópublicadadelformat,almomentderealitzarlaintegracióambelservei.Espottrobartotalainformaciórelativaalformat,aixícomlessevesdiferentsversionsalapàginawebwww.facturae.es.

Toteslesfacturesintercanviadesdinsdel'entorne.FACThandeportarlacorresponentsignaturaelectrònica,dinsdelesacceptadesenfacturae(Facturae.es>Documentación>Políticasdefirma).

D'altrabanda,elserveie.FACTcontemplal'emissiódefacturesenformatEDIFACT,pensantenproveïdorsqueja puguin estar fent ús d'aquest, i de cara a evitar-los l'adaptació a facturae. En aquest cas el servei e.FACTrealitzaunaconversióal format facturae3.2, incrustant la facturaoriginalenelnodeRelatedDocumentsdelfacturaegenerat.Eltractamentdelesfacturesenaquestscasosésequivalentalaresta,tretqueenaquestcascalrealitzarunadoblevalidaciódesignatura:d'unabandalavalidaciódelasignaturadelfacturae,id'unaltrela validació de la signatura original EDIFACT incrustat. Per a aquesta última validació hi ha definit un serveiaccessibleviaweb,enlaqualespotpujarelfacturaeambelEDIFACToriginal,peralavalidaciód'aquest.

Pelque faal formatdelsmissatgesdenotificaciód'estatspera les factures, agenerarpels receptorsde lesmateixes,oencasderebuig,perpartd'algundelssistemesinformàticsentremig,s'hadefinitunXMLd'estatsdisponible com ‘DeliveryFeedback.xsd’, disponibledinsde l'apartatdedocumentació tècnicaawww.aoc.cat,Serveis>e.FACT>Sisouunaadministración>Comutilitzar-ho.

Totselsmissatgesintercanviatsenelhube.FACTsónvalidatspelmateix1,ipertant,esgaranteixquetotselsmissatgeslliuratspelhubalesplataformesosistemesinterconnectatsalmateix,tenenunformatvàlid.

1 Aexcepciódelsfitxersadjunts,quesimplementeslliurenalaplataformadestinatàriadelmateixos.


5 Missatges d’estat

Lesplataformesdefacturació,oprogramesdegestiócomptable,quecontemplinlafuncionalitatperaentitatsreceptores,haurandepermetrealsusuarisreceptorsdefactures,generarelsmissatgesd'estatcorresponents.AcadascundelsestatsesproporcionaràOBLIGATÒRIAMENTelcodinumèricPúblic(<StatusCode>) i l'estatusalfabètic(<Status>).LapublicaciódelsestatsDELIVERED,ANNOTATEDiRECEIVEDpermetincloureelCodiRCFassignatcomNumerodeRegistreComptable(<RcfRegNumber>).Elsestatsquepodensertransmesos,idealmentdeformaseqüencialisuccessiva,percadascunadelesfacturesdipositadesalesAAPPadheridesaeFACTsónelssegüents:

• FACTURA LLIURADA: la factura ha arribat als sistemes informàtics de l'administració receptora, hapassatlesvalidacionsautomàtiquesnecessàriesiestàadisposiciódel/susuari/sreceptor/s.

- CodiEstat(<Status>):’DELIVERED’- CodiEstatPúblic(<StatusCode>):1250

• FACTURA REGISTRADA AL RCF La factura electrònica ha estat rebuda i registrada en el registre

comptabledefacturesdel'oficinacomptabledestinatària.

- CodiEstat(<Status>):‘ANNOTATED’- CodiEstatPúblic(<StatusCode>):1400

• FACTURAREBUDAADESTÍ:Lafacturaelectrònicahaestatrebudaperlaunitatgestoradelamateixa.

Lapublicaciód’aquestestatnoésobligatòria.

- CodiEstat(<Status>):‘RECEIVED’- CodiEstatPúblic(<StatusCode>):2100

• FACTURACOMPTABILITZADA: El servei o subministrament associat a la factura ha estat validat. La

publicaciód’aquestestatnoesobligatoria.

- CodiEstat(<Status>):‘ACCEPTED’- CodiEstatPúblic(<StatusCode>):2300

• COMPTABILITZADA L'OBLIGACIÓ RECONEGUDA: L'obligació de pagament derivada de la factura ha

estatreconeguda.

- CodiEstat(<Status>):‘RECOGNISED’- CodiEstatPúblic(<StatusCode>):2400

• FACTURAPAGADA:L'obligaciódepagamentderivadadelafacturahaestatrealitzat.

- CodiEstat(<Status>):‘PAID’- CodiEstatPúblic(<StatusCode>):2500


o FACTURAREBUTJADA: lafacturahaestatrebutjada.Elmotiuderebuigpodensercausestècniques,queimpedeixenel lliuramentde la facturaa l'usuari (generatsautomàticamentpels sistemes informàtics),opot ser l'usuari qui rebutgi la factura per motius comercials. Les aplicacions de gestió de facturacióelectrònicaadisposiciódelsusuaris,handepermetre lageneraciód'aquestestat,possibilitanta l'usuaril'entradadelmotiuderebuig.Semprequeesprodueixiunrebuig,jasiguipermotiustècnicsoperl'usuari,s'haurà de generar aquest estat. La publicació d'aquest estat és obligatòria sempre que es detecti unaincidènciaamblafacturaqueimpedeixilasevatramitació.

- CodiEstat(<Status>):‘REJECTED’- CodiEstatPúblic(<StatusCode>):2600- MotiudeRebuig:(<Reason>):<Code>+<Description>

Sienel fluxde tramitaciód’una facturanoduua termeel canvid’estatd’una factura (p.ex.deACCEPTEDaRECOGNISED),s'hauràdegenerarunmissatged'estatderebuig(“REJECTED”)indicantelsmotiustècnicsodenegoci que hagin impedit el correcte lliurament (per exemple: "La factura no pot ser lliurada, el codid'encaminamentésincorrecte").Addicional als Estats per les Plataformes, el servei eFact proporciona als emissors de factures dels següentsestatsprevisallliuramentalaPlataformacorresponent:o FacturaLliurada(status=’SENT’):Lafacturahaestatlliuradapelserveie.FACTal'AAPPcorresponent.

o Factura registrada (status=’REGISTERED’): La factura electrònica ha estat rebuda en el punt general

d'entrada de factures e.FACT i ha estat registrada administrativament, proporcionant un número deregistrealproveïdor..

5.1 Servei de consulta Històric estats Factura

e.FACTdisposade lapossibilitatdefer laconsultad'estatsd'unadeterminadafactura.S'hand'especificar lesdadesidentificativesd'unafactura,is'obtécomarespostaunmissatgeXMLquecontétotselsestatsidetallsdelsmateixos,pelsqualshapassatlafacturaenqüestió.

El codi d'estat es correspon amb un identificador que permet diferenciar les comunicacions d'estats entrediferentsplataformesindependentmentdelesdenominacionsquepoguessintenirinternamentcadaund'ells.


5.2 Estats de tramitació

Nom eFACT EstatTècnic

Tramesa-[ae.FACT] SENT 1000

Registrada REGISTERED 1200

Lliurada DELIVERED 1250

RegistradaaRCF ANNOTATED 1400

Rebudaadestí RECEIVED 2100

Conformada ACCEPTED 2300

Comptabilitzadal’obligacióreconeguda RECOGNISED 2400

Pagada PAID 2500

Rebutjada REJECTED 2600

Anul·lada CANCELED 3100

5.3 Mètode: wsEfHubInvoiceQueryStatus

Aquestmètodepermetlaconsultad'estatsd'unadeterminadafacturaregistradaae.FACT.

Tot i que els estats de les factures són realimentats cap als emissors de les mateixes, depenent del mitjà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

Nombre Descripción

HUBusersenderid Codiadreçamentcompletdel'emissordelesfactures

HubInfoAdd Siesrepaquestelementambelvalor"TRUE",s'afegiràalarespostalainformaciódetraçabilitatsobrel'intercanviquecontenialafacturabuscada(node“HubFeedback”).

INVOICEnumber Númerodelafacturaabuscar

INVOICEdate Anyfiscaldefacturaabuscar(FormatYYYY).

INVOICEsupplier NIFdelvenedor

INVOICEbuyer NIFdelcomprador.

INVOICEtotal Importtotaldelafactura

Lapeticióestàdefinidaenelpropiwsdl.Acontinuacióapareixunexempledepetició:

<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 es la consulta cega d'estats des de la bústia de lliurament (veureManual d'Usuari Bústia de Lliurament). Però també es posa a disposició d'altres plataformesemissores,pertaldepermetreconsultespuntualsalsseususuaris.

- A causa que la consulta podrà tornar més d'una factura que compleixi la condició, en no podergarantirquel'emissorde lafacturahagienviat lamateixafacturaunasolavegada,eldocumentXmltornatpodràcontenirmésd'unnode"StatusFeedback",unpercadafacturaquecompleixilacondició.

- Alseutorncadafacturapodràcontenirunodiversosnodes"Feedback",enfunciódelnombred'estatsrebutsalHubperauna factura,per tant,es retornadithistòricd'estats. Elsnodes "Feedback"hand'aparèixerordenatsdescendentemente(estatmésmodernprimer).

- ElmissatgeXMLretornatpodràcontenir informacióde traçabilitatsobreel fitxerenelqueviatjo lafacturasol·licitadaenelnode"HubFeedback".Lageneraciód'aquestnodenomésesduràatermesiaixísesol·licitaeneldocumentXMLquerebicomapeticióalHub.


5.4.2 Resposta

Larespostaesdefineixal’esquema:DeliveryFeedback.xsdRepresentaciógràficadelaresposta

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


6 Gestió de documents adjunts

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 Rebut electrònic

Amodedeconfirmacióderegistrede les facturesa lesadministracionspúbliquesreceptores,almomentenquè es rep la informació de registre al hub e.FACT, es procedeix a generar un document pdf signat queanomenem rebut electrònic. Aquest conté, amés de la informació de registre, còpia impresa de la factura.Aquest rebut electrònic es lliura tant a la plataforma emissora, com la plataforma receptora mitjançant lageneració d'un arxiu d'estat addicional ('REGISTERED'), amb el document descrit en el nodeElectronicAcknowledgment.Tantperalesplataformesemissorescomperalesreceptores,aquestarxiud'estatesdipositaràeneldirectori 'statout' corresponent. Lesplataformeshande facilitarals seususuaris l'accésaaquestsdocuments.

Enelcasquel'administracióreceptoranohagidelegatelregistredefacturesalserveie.FACTielhubdetectifacturesquenohanestat registradesdinsdel terminide24horesposterioral lliuramentde la facturaen laplataformareceptora,elhubprocediràalarealitzaciódelregistredeformaautomàticaenelRegistreUnificatdelConsorciAOC.Aquestregistreproduiràlacorresponentnotificaciód'estattantenlaplataformaemissoracomlaplataformareceptora,iinclouràelrebutelectrònicdescritenelparàgrafanterior.


8 Consulta d’identificadors de receptors e.FACT

e.FACTproporcionaunserveiwebdeconsultadecodisd'encaminamentamb la finalitatdeproporcionaralsseus usuaris, els identificadors per les AA.PP. receptores necessàries per al correcte encaminament de lesfactures.

Lesplataformespodransol·licitar,béel llistatcompletdecodis,amblessevescorresponentsdadesd'entitatreceptoraassociadaielseuCIF,obérealitzarlaconsultaperundeterminatCIFocodid'encaminament.

FernotarqueperaundeterminatCIFpodenaparèixerdiversoscodisd'encaminamentactius.Aquestseriaelcas,perexemple,d'unaAA.PP.quedesitgiredirigirlasevafacturacióadiferentsdepartaments.

8.1 Consulta de codis d’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àficadelaresposta:

Ejemplo de petición:

<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’errors al hub

S'haestablertunmecanismedenotificaciód'errorsproduïtsdinsdelhubdelserveie.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 Procediment d’integració

Persol·licitar la integracióenelserveie-FACT,si-us-plau,consultien l’espaideSuportdelserveieFACTenelportaldesuportdelConsorciAOC:

https://web.aoc.cat/suport/e-fact/

Un cop la seva sol·licitudhagi estat rebuda i validadaperpart del ConsorciAOC, lapersona 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:

• Facturesambcodidereceptornovàlid.• Facturesambcertificatnovàlid.• Facturesambsignaturanovàlida.• 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ó de contacte

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

https://web.aoc.cat/suport/e-fact/