agència de residus de catalunyasdr.arc.cat/gps/arc_ws_fangs_tecnic.pdf · 2020-03-02 · 2.1. sdr...

Especificació tècnica del servei webper informar les dades detraçabilitat GPS dels trasllats iaplicació de fangs i altres residusagroindustrials que es destinin avalorització agrària (via de gestióR10) segons el decret 153/2019, de3 de juliol, de gestió de lafertilització del sòl

Agència de Residus de Catalunya

Índex

1. Introducció ............................................................................................. 3

2. Tecnologia .............................................................................................. 4

2.1. SDR i entorns de treball ................................................................. 4

2.2. Arquitectura JSON ......................................................................... 4

2.3. Seguretat ...................................................................................... 5

3. Orígens, destins i serveis web disponibles ............................................ 6

3.1. Servei Registrar origen ................................................................... 7

3.2. Servei Actualitzar origen ................................................................ 9

3.3. Servei Eliminar origen ................................................................. 10

3.4. Servei Obtenir origen ................................................................... 11

3.5. Servei Registrar destí ................................................................... 13

3.6. Servei Eliminar destí .................................................................... 15

Annex I: Taules Mestres ........................................................................... 17

Taula 1: Orígens i destins .................................................................... 17

Taula 2: Tipus d'elements transportats ............................................... 17

Taula 3: Codificació d'errors / incidències ............................................ 18

Annex II: Exemples JSON de peticions i respostes ................................... 19

Annex III: Exemples pràctics (codi_gener i codi_origen) .......................... 22

Exemple 1: Gestió de fangs de depuradora mitjançant un gestor

de residus d'aplicació agrícola (R10) ................................................... 22

Exemple 2: Gestió de residus orgànics per aplicació agrària

realitzada pel propi productor mitjançant FD ...................................... 24

Annex IV: Informació de contacte per qüestions tècniques ..................... 26

Document creat per: OESIA pàgina 2 de 26Versió 1.4 - Data: 16 - abril - 2020

1. Introducció

El Decret 153/2019, de 3 de juliol, de gestió de la fertilització del sòl i de lesdejeccions ramaderes i d'aprovació del programa d'actuació a les zonesvulnerables en relació amb la contaminació per nitrats que procedeixen defonts agràries, dictamina que els vehicles encarregats del transport i aplicacióde fangs i altres residus agroindustrials que es destinin a valorització agrària(via de gestió R10) tindran l’obligatorietat de realitzar la traçabilitat en GPS, apartir del 05/01/2020 en els supòsits que s'estableixen a l'article 14.4 del citatDecret.

http://residus.gencat.cat/web/.content/home/consultes_i_tramits/normativa/normativa_catalana_en_materia_de_residus/decret_153_2019.pdf

Des del Departament de Ramaderia i Pesca de la Generalitat de Catalunya(DARP) es va dur a terme un projecte per tal que les empreses ramaderespoguessin realitzar la comunicació de les dades GPS (mitjançant empresesexternes especialitzades).

http://agricultura.gencat.cat/ca/ambits/ramaderia/dar_dejeccions_ramaderes_fertilitzants_nitrogenats/pla-us-gps-fertilitzacio/

Els softwares desenvolupats a tal efecte han d’estar instal·lats en un hardwareque estigui fixat a la cisterna, remolc o cabina del tractor de manera física.Aquest lligam físic amb sensors o dispositius allotjats a la maquinaria fa que noes pugui manipular la informació i per tant faci el sistema confiable.

En el mateix sentit, l'Agència de Residus de Catalunya (ARC) ha desenvolupatd'un sistema similar per tal que els operadors involucrats puguin comunicar lainformació de traçabilitat dels trasllats i aplicació de fangs i altres residusagroindustrials que es destinin a valorització agrària (via R10). En el presentdocument es detalla la seva especificació tècnica.






2. Tecnologia

2.1. SDR i entorns de treball

L'Agència de Residus de Catalunya disposa d'una plataforma web anomenadaSistema Documental de Residus (SDR) i en ella s'inclouen els serveis web quepermetran l'enviament de la informació de posicionament dels trasllats deresidus de fangs i altres residus agroindustrials afectats que es destinin avalorització agrària (via R10). Es disposen de tres entorns de treball (TEST,PreProducció i Producció) per tal que les empreses interessades a provar elservei puguin fer-ho en un entorn de proves abans de posar-se enfuncionament amb dades reals.

Entorn de Producció:http://sdr.arc.cat/

Entorn de Pre-Producció:http://sdr.prep.arc.cat/

Entorn de TEST:http://sdr.test.arc.cat/

2.2. Arquitectura JSON

Per al disseny dels serveis web, s'ha utilitzat una arquitectura REST ambserveis que consumeixen i retornen informació en format JSON, mitjançantcrides POST. Les estructures de dades JSON d'enviament i recepció d'informaciópermeten molta flexibilitat pel que fa a la informació enviada, ja que es permetno enviar un camp si aquest no és obligatori. A més, el volum d'informacióenviada/rebuda en les peticions és menor i el parseig de les dades és mésràpid que en estructures XML.


En l'Annex II del present document hi ha una sèrie d'exemples de crides irespostes en format JSON per veure'n els seus formats.

2.3. Seguretat

Tota crida als serveis web tindrà com a camps inicials un codi d'usuari i unacontrasenya. Per a obtenir aquestes credencials d'accés, les empreses interessades haurande comunicar-ho a l'ARC, que a la seva vegada realitzarà les comprovacionsprèvies que consideri oportunes per a validar que els equips dels què disposensón totalment homologables.

{ "usuari": "myLoginUser", "password": "xGm4z8a2", "id_desti_transp": 7654645}

El sistema de validacions usuari-contrasenya existeix separadament en els tresentorns de l'SDR i, per tant, les credencials d'accés seran diferents en cadacas.


3. Orígens, destins i serveis web disponibles

L'estructura dels serveis web s'ha dissenyat tenint en compte que tot pivotaentorn a dues entitats fonamentals: orígens i destins.

Un origen és el punt des d'on s'inicia el trasllat, mentre que el destí és el puntde finalització del mateix. Un origen pot tenir més d'un destí, i un destí sempreha d'estar associat a un origen. De moment no hi ha punts intermedis ainformar, només origen i destí.

Segons el tipus d'origen/destí escollit variarà el format del codi d'origen/destí.Per a veure els tipus de destins disponibles es pot consultar l'Annex I delpresent document, així com els diferents codis acceptats en cada cas.

Els serveis web disponibles per informar orígens i destins són:

registrar origenPermet informar d'un nou trasllat, especificant les dades d'origen delmateix (coordenades, matrícula del vehicle/remolc/cisterna, data ihora....).

actualitzar origenPermet actualitzar la informació d'origen informada prèviament.

eliminar origenPermet eliminar un origen informat prèviament, sempre que aquest notingui ja associat cap destí. En cas que fos així, s'haurien d'eliminarprimer els destins.

obtenir origenPermet obtenir tota la informació d'orígens i destins donats uns criterisde cerca (matrícula, dia i origen).

registrar destíPermet informar d'un nou destí associat a un origen prèviamentcomunicat.

eliminar destíPermet eliminar un destí informat prèviament.

En els següents apartats del document es detalla al màxim cadascun d'aquestsserveis web.


3.1. Servei Registrar origen

Permet informar d'un nou trasllat, especificant les dades d'origen del mateix.

URL del servei a PreProducció:http://sdr.prep.arc.cat/gps/rest/registrarOrigen.action

URL del servei a Producció:http://sdr.arc.cat/gps/rest/registrarOrigen.action

Esquema de camps de la petició:

Esquema de camps de la resposta:

Restriccions i validacions:

• El camp codi_transportista serà obligatori excepte en el cas que l'origensigui un apilament.

• El camp codi_gener (codi identificador/punt generador) serà un codi de


camp tipus descripció obligatoriresultat Text (2) OK en cas correcte; KO en cas incorrecte Sid Text (16) Identificador únic d'origen de transport N

incidencies Array Text (2) Llista amb codis d'error detectats N

camp tipus descripció obligatoriusuari Text (50) Usuari SDR S

password Text (16) Password SDR S

codi_transportista Text (15) Codi de transportista autoritzat. Exemple: T-099 N

codi_gener Text (15) Codi identificador / punt generador (codi productor o codi gestor) S

matricula Text (12) Matrícula del remolc, cisterna o vehicle que realitza el transport S

coord_x Decimal (10,2) Coordnada X segons sistema de referència ETRS89 31N S

coord_y Decimal (10,2) Coordnada Y segons sistema de referència ETRS89 31N S

error_precisio Decimal (10,2) Error de mesura de precisió expressat en metres S

data_hora Text (19) Data I hora d'inici del trasllat en format DD/MM/AAAA HH:mm:SS S

tipus_origen Text (2) Codi origen (veure Annex I – taula 1) S

codi_origen Text (20) Codi de l'origen (diferent segons tipus) S

tipus_element Text (2) Codi del tipus d'element transportat (veure Annex I – taula 2) S

nitrogen Decimal (3, 2) Concentració de Nitrogen expressat en kg N / m3 S

fosfor Decimal (3, 2) Concentració de Fòsfor expressat en kg P2O5 / m3 S

volum Decimal (6, 2) Volum en m3 de l'element transportat N

pes Decimal (6, 2) Pes de l'element transportat expressat en t N

incidencia Text (1) Incidència que impedeix enviar la informació en temps real (S o N) N

desc_incidencia Text (100) Descripció de la incidència soferta N

productor o un codi del gestor d'aplicació agrària. Exemples serien P-00000.1 com a codi de productor, o bé E-000.00 com a codi de gestor.En l'annex III del present document hi ha exemples per clarificar quans'ha de posar un codi o un altre en aquest camp.

▪ En el cas d’aplicació a la parcel·la a partir d’un apilament, elcodi_gener serà el codi de gestor autoritzat per a l’aplicacióagrícola.

▪ Per al cas específic de les fitxes de destinació (FD) i quan es disposid’apilaments, el codi_gener serà el codi de productor.

• No es permetrà el registre d’orígens amb més de 24 hores de diferènciarespecte a l’hora de la càrrega.

• Si s’envia un duplicat i les dades coincideixen exactament (mateixtransportista, mateix origen -tipus d’origen i valor d’origen-, i la data il’hora dels transports), es retornarà “OK”, el codi d’identificació del’origen del transport, amb una incidència informativa.

• Les crides per registrar un origen amb el mateix transportista, mateixamatrícula, mateix origen (tipus d’origen i valor d’origen) i on la data il’hora dels transports tenen una diferència inferior a 10 minuts estractaran com un duplicat de l’origen i no es registrarà la novainformació. En aquest cas, es retornarà “KO”.

• L'obligatorietat dels camps nitrogen, fòsfor, volum i pes pot variar enfunció del valor de tipus_element introduït. Pot consultar-se aquestainformació a l'Annex I – taula 2.

• El tipus de dades Decimal(3, 2) significa que tenim un número decimalque accepta fins a 3 dígits en la part entera i com a màxim 2 dígitsdecimals. Per exemple 123.12 seria un número vàlid, però 1234.9 i 0.123serien números no vàlids. No s'accepten separadors de milers i elseparador decimal sempre serà un punt.

• Els camps incidencia i desc_incidencia s’hauran d’informar quan no espugui enviar la informació dintre els terminis establerts com a vàlids. Sies marca com a “S” s’obligarà a que s’informi una descripció. En cas deno aparèixer el camp s’assumirà un valor “N”. No es permetràl’enviament d’informació marcat com a incidència en cas que aquesta noestigui justificada (l’Agència valorarà en cada cas els motius).

El camp resultat de la resposta pot tenir els valors “OK” o “KO” segons si lapetició ha pogut ser processada correctament o no. De vegades però, havent-se obtingut un resultat satisfactori, poden haver-hi incidències informativesque, tot i no fer que la petició sigui retornada com a errònia, sí que ésimportant que siguin comunicades a títol informatiu per tal que puguin sersubsanades en posteriors crides. A l'Annex II hi ha diversos exemplesd'enviament i resposta JSON per a aquest i els altres serveis disponibles.


3.2. Servei Actualitzar origen

Permet actualitzar la informació d'un trasllat prèviament informat.

URL del servei a PreProducció:http://sdr.prep.arc.cat/gps/rest/actualitzarOrigen.action

URL del servei a Producció:http://sdr.arc.cat/gps/rest/actualitzarOrigen.action




• Es validarà que l'origen que es vol actualitzar hagi estat generat pelmateix usuari.

• Transcorregudes 24 hores des de la recepció d'un origen a la base dedades de l'Agència de Residus, no es permetrà la seva actualització.

• Hi ha camps no obligatoris en la petició. Si aquests camps no són rebuts,no actualitzaran el seu valor a les dades d'origen.

• L'obligatorietat dels camps volum i pes pot variar en funció del valor detipus_element introduït. Pot consultar-se aquesta informació a l'Annex I –taula 2.

• En cas que informem una matrícula amb més de 12 caràcters, el mètode


camp tipus descripció obligatoriresultat Text (2) OK en cas correcte; KO en cas incorrecte Sincidencies Array Text (2) Llista amb codis d'error detectats N



id_origen_transp Enter Identificador únic d'origen de transport S

matricula Text (12) Matrícula del remolc, cisterna o vehicle que realitza el transport N

tipus_element Text (2) Codi del tipus d'element transportat (veure Annex I – taula 2) N

nitrogen Decimal (3, 2) Concentració de Nitrogen expressat en kg N / m3 N

fosfor Decimal (3, 2) Concentració de Fòsfor expressat en kg P2O5 / m3 N

volum Decimal (6, 2) Volum en m3 de l'element transportat N

pes Decimal (6, 2) Pes de l'element transportat expressat en t N



es quedarà amb els 12 primers i retornarà una incidència informativa,però realitzarà el canvi igualment (resposta OK).

• El tipus de dades Decimal(3, 2) significa que tenim un número decimalque accepta fins a 3 dígits en la part entera i com a màxim 4 dígitsdecimals. Per exemple 123.12 seria un número vàlid, però 1234.9 i 0.123serien números no vàlids. No s'accepten separadors de milers i elseparador decimal serà un punt.



3.3. Servei Eliminar origen

Permet eliminar la informació d'un trasllat prèviament informat.

URL del servei a PreProducció:http://sdr.prep.arc.cat/gps/rest/eliminarOrigen.action

URL del servei a Producció:http://sdr.arc.cat/gps/rest/eliminarOrigen.action










• Transcorregudes 24 hores des de la recepció d'un origen a la base dedades de l'Agència de Residus, no es permetrà la seva eliminació.

• En el cas que hi hagi destins associats a l'origen que es vol eliminar, esretornarà un error. Han d'eliminar-se els possibles destins relacionatsabans de poder eliminar un origen.

• Es validarà que l'origen que es vol eliminar fos creat pel mateix usuari.


A l'Annex II hi ha exemples d'enviament i resposta JSON per a aquest servei.

3.4. Servei Obtenir origen

Permet obtenir tota la informació d'un trasllat prèviament informat, amb eldetall de tots els possibles destins que tingui associats. El servei Obtenir origenté una estructura de cercador. És a dir, permet cercar aquells origens quecompleixin les condicions informades a la petició (matrícula, data i tipus/codiorigen). El resultat serà un llistat, en forma d'array d'orígens, que a la sevavegada podran tenir zero, un o més destins.

URL del servei a PreProducció:http://sdr.prep.arc.cat/gps/rest/obtenirOrigen.action

URL del servei a Producció:http://sdr.arc.cat/gps/rest/obtenirOrigen.action





Objecte Origen



origens Array Objectes Contindrà un llistat amb 0, 1 o més elements de tipus <origen> S




data Text (10) Data (dia) del transport en format DD/MM/AAAA S



camp tipus descripció obligatoriid_origen_transp Enter Identificador únic d'origen de transport S

codi_transportista Text (15) Codi de transportista autoritzat. Exemple: T-099 S

codi_gener Text (15) Codi identificador / punt generador (codi productor o codi gestor) S








tipus_element Text (2) Codi del tipus d'element transportat (veure Annex I – taula 2) S

nitrogen Decimal (3, 4) Concentració de Nitrogen expressat en kg N / m3 S

fosfor Decimal (3, 4) Concentració de Fòsfor expressat en kg P2O5 / m3 S

volum Decimal (6, 2) Volum en m3 de l'element transportat S

pes Decimal (6, 2) Pes de l'element transportat expressat en t S

destins Array Objectes Contindrà un llistat amb 0, 1 o més elements de tipus <desti> S

Objecte Destí


• En cas de no obtenir elements resultants de la cerca, es retornarà unerror (KO).


3.5. Servei Registrar destí

Permet informar les dades d'un destí associat a un origen prèviament introduït.

URL del servei a PreProducció:http://sdr.prep.arc.cat/gps/rest/registrarDesti.action

URL del servei a Producció:http://sdr.arc.cat/gps/rest/registrarDesti.action



camp tipus descripció obligatoriid_desti_transp Enter Identificador únic del destí de transport S





tipus_desti Text (2) Codi destí (veure Annex I – taula 1) S

codi_desti Text (20) Codi del destí (diferent segons tipus) S








tipus_desti Text (2) Codi destí (veure Annex I – taula 1) S

codi_desti Text (20) Codi del destí (diferent segons tipus) S





• Únicament es permet registrar més d’un destí en un transport, quan elsdestins són a camp i en recintes SIGPAC diferents. En qualsevol altre cas,només es permet registrar un destí per transport.

• No es permetrà el registre de destins amb més de 24 hores de diferènciarespecte a l’hora de descàrrega aportada.

• Si la data i l’hora d’aplicació del destí aportada sobrepassa en més de 24hores la data i l’hora d’origen del transport associat, no s’acceptarà elregistre.

• Es validarà que l'origen al qual es vol afegir un destí hagi estat creat pelmateix usuari.

• Si es rep el registre d’un destí amb valors coincidents amb un destí jaregistrat (mateix id_origen_transport, data_hora, tipus_desti ivalor_desti), es retornarà “OK”, un identificador de destí i una incidènciainformativa.

• Si es rep el registre d’un destí amb valors coincidents amb mateixid_origen_transport, tipus_destí, valor_destí i diferent data_hora esconsidera destí duplicat i no es registra la informació. En aquest cas esretorna “KO” i un codi incidència “X26”. Només en els casos de destins acamp múltiples (diferents recintes sigpac pel mateix transport, es permetmés d’un destí per origen).

• El tipus de dades Decimal(10, 2) significa que tenim un número decimalque accepta fins a 10 dígits en la part entera i com a màxim 2 dígitsdecimals. Per exemple 1122334455.89 seria un número vàlid, però112233445566.9 i 0.123 serien números no vàlids. No s'acceptenseparadors de milers i el separador decimal sempre serà un punt.



camp tipus descripció obligatoriresultat Text (2) OK en cas correcte; KO en cas incorrecte Sid Text (16) Identificador únic de destí de transport N

incidencies Array Text (2) Llista amb codis d'error detectats N


3.6. Servei Eliminar destí

Permet eliminar les dades d'un destí prèviament introduït.

URL del servei a PreProducció:http://sdr.prep.arc.cat/gps/rest/eliminarDesti.action

URL del servei a Producció:http://sdr.arc.cat/gps/rest/eliminarDesti.action




• Transcorregudes més de 24 hores del registre del destí no se’n permetràl’eliminació.

• Es validarà que el destí que es vol eliminar hagi sigut creat pel mateixusuari.

• Els camps incidencia i desc_incidencia s’hauran d’informar quan no es





id_desti_transp Enter Identificador únic del destí de transport S



pugui enviar la informació dintre els terminis establerts com a vàlids. Sies marca com a “S” s’obligarà a que s’informi una descripció. En cas deno aparèixer el camp s’assumirà un valor “N”. No es permetràl’enviament d’informació marcat com a incidència en cas que aquesta noestigui justificada (l’Agència valorarà en cada cas els motius).



Annex I: Taules mestres

Taula 1: Orígens i destins

* El codi SIGPAC té com a format: 08057:0:0:43:22:8 (província + municipi +agregat + zona + polígon + parcel·la + recinte)

Els camps origen i destí de la taula indiquen amb valors S (sí) o N (no) si aquestelement serà vàlid com a origen/destí o no. Per exemple, un apilament pot serorigen o destí, però un productor no podrà ser mai destí.

Taula 2: Tipus d'elements transportats

Els camps nitrogen, fòsfor, volum i pes indiquen amb valors S (sí) o N (no) si ésobligatori o no informar aquesta dada per al tipus d'element transportatseleccionat.


codi descripció nitrogen fòsfor volum pesE1 Purí S S S N

E2 Fem S S N S

E3 Gallinassa S S N S

E4 Sub. Prod. líquid S S S N

E5 Sub. Prod. sòlid S S N S

E6 Digestat S S S N

E7 Fangs de depuradora S S N S

E8 Altres residus orgànics S S N S

codi descripció tipus codi origen destí03 Gestor Codi gestor de l'ARC (E-XXX.XX) S S04 Camp Codi SIGPAC * N S06 Productor Codi productor de l'ARC (P-XXXXX.X) S N07 Apilament NIF de l'agricultor de l'apilament S S

Taula 3: Codificació d'errors / incidències


codi descripcióX06 Matrícula no informada

X07 Coordenades no informades o invàlides

X08 Tipus d'origen no informat o invàlid

X09 Codi d'origen no informat o invàlid

X14 Nitrogen no informat o valor no permès

X15 Fòsfor no informat o valor no permès

X16 Pes no informat o valor no permès

X17 Volum no informat o valor no permès

X18 Data i hora no informada o format invàlid

X19 Data de registre de l'origen de transport superior al permès

X20 Data de registre del destí de transport superior al permès

X21 Data de destí inferior a la d'origen

X22 Data límit d'actualització expirada

X23 Data límit d'eliminació expirada

X24 Origen duplicat, ja registrat. No s'ha actualitzat cap dada en l'origen ja registrat

X26 Transport amb destí ja registrat. No s'accepten més destins

X27 Codi d'origen de transport invàlid o inexistent

X28 Codi de destí invàlid o inexistent

X31 Error no controlat. Proveu més endavant

X32 Tipus Element no informat o invàlid

X33 No es pot eliminar origen amb destins associats

X34 Tipus de destí no informat o invàlid

X38 Codi generador no informat o invàlid

X51 Confirmació origen ja registrat. No s'ha actualitzat cap dada en l'origen ja registrat

X52 Confirmació destí ja registrat. No s'ha actualitzat cap dada

X55 Matrícula invàlida

X56 Error de precisió de la coordenada no informat o invàlid

X60 Codi transportista no informat o invàlid

X61 Codi destí no informat o invàlid

X62 Al canviar l'element transportat, el nitrogen és obligatori

X63 Al canviar l'element transportat, el fòsfor és obligatori

X64 Al canviar l'element transportat, el pes és obligatori

X65 Al canviar l'element transportat, el volum és obligatori

X66 Diferencia major a 24h entre data_hora de l'origen i la del destí

X67 Usuari no coincident amb dades enviades prèviament

X68 Data de cerca invàlida

X69 Origen amb destí ja associat

X70 Accés il·legal (permisos SDR)

X71 Error de login

X72 Error tipus de dades incorrecte

X73 La matricula informada no pertany al transportista especificat

X74 Camp incidència amb valor no permès (valors possibles: S / N)

X75 Camp descripció de la incidència no informat

Annex II: Exemples JSON de peticions i respostes

A continuació es llisten una sèrie d'exemples JSON de peticions (en negre) irespostes (en blau). Les dades utilitzades són totalment inventades i potserinconnexes entre sí; l'objectiu dels exemples és veure'n els formats, camps itipus de dades utilitzats.

registrar origen:{ "usuari": "user1234", "password": "xGm4z8a2", "codi_transportista": "T-3588", "codi_gener": "E-000.96", "matricula": "B-0875-UD", "coord_x": 356338.80, "coord_y": 4614816.51, "error_precisio": 1.2, "data_hora": "03/11/2019 08:55:23", "tipus_origen": "06", "codi_origen": "P-00000.4", "tipus_element": "E7", "nitrogen": 4.67, "fosfor": 183.34, "volum": 18, "pes": 1.45, "incidencia": “S”, "desc_incidencia": “Avaria en el camió en un túnel”}

{ "resultat": "OK", "id": 123455, "incidencies": [ “X24” ]}

actualitzar origen:{ "usuari": "user1234", "password": "xGm4z8a2", “id_origen_transp": 123455, "matricula": "B-0875-UD", "tipus_element": "E7", "nitrogen": 4.67, "fosfor": 83.78323, "volum": 18.2, "pes": 1.28}

{ "resultat": "KO", "incidencies": [ “X15” , “X22” ]}


eliminar origen:{ "usuari": "user1234", "password": "xGm4z8a2", "id_origen_transp": 123455}

{ "resultat": "OK"}

obtenir origen:{ "usuari": "user1234", "password": "xGm4z8a2", "matricula": "T-4319-BGR", "data": "03/10/2019", "tipus_origen": "06", "codi_origen": "P-00000.1"}

{ "resultat": "OK", “origens”: [ { "id_origen_transp": 123455, "codi_transportista": "T-3588", "codi_gener": "1234567", "matricula": "B-0875-UD", "coord_x": 423299, "coord_y": 4591581, "error_precisio": 1.2, "data_hora": "12/10/2019 15:44:20", "tipus_origen": "06", "codi_origen": "P-00000.1", "tipus_element": "E7", "nitrogen": 4.67, "fosfor": 83.35, "volum": 25.3, "pes": 3.1, "destins": [ { "id_origen_transp": 123455, "id_desti_transp": 7654645, "coord_x": 423567, "coord_y": 4515645, "error_precisio": 1.2, "data_hora": "03/10/2019 17:03:45", "tipus_desti": "07", "codi_desti": "P-00000.1" }, { "id_origen_transp": 123455, "id_desti_transp": 7654647, "coord_x": 423448, "coord_y": 4527209,


"error_precisio": 1.2, "data_hora": "03/10/2019 17:05:23", "tipus_desti": "07", "codi_desti": "P-00000.2" } ] } ]}

registrar destí:{ "usuari": "user1234", "password": "xGm4z8a2", "id_origen_transp": 123455, "coord_x": 356338.80, "coord_y": 4614816.51, "error_precisio": 1.2, "data_hora": "25/11/2019 17:08:02", "tipus_desti": "07", "codi_desti": "P-00000.1"}

{ "resultat": "OK", “id”: 9763, "incidencies": [ “X56” ]}

eliminar destí:{ "usuari": "user1234", "password": "xGm4z8a2", "id_desti_transp": 7654645, "incidencia": "N"}

{ "resultat": "KO", "incidencies": [ “X09” ]}


Annex III: Exemples pràctics (codi_gener i codi_origen)

Exemple 1: Gestió de fangs de depuradora mitjançant un gestor de residusd'aplicació agrícola (R10)

Com es pot veure a la figura anterior, en un trasllat des de planta/depuradoraEDAR, podem tenir dos destins: camp o apilament. El destí a camp es tractariaquan el propi vehicle encarregat del transport també realitza l'escampat alcamp.

En el nostre exemple en el camp codi_gener (codi identificador/punt generador)sempre hi figurarà el codi de productor de la planta i en el camp codi_origenapareixerà el codi de gestor autoritzat per a l'aplicació agrícola. Hauremseleccionat tipus_origen=’03’ (Gestor).

Pel que fa al destí associat al transport, tindrem diferents opcions per ainformar en el camp codi_desti:

• en cas de destí camp (tipus_desti=’04’) posarem el codi SIGPAC delrecinte en el que es realitza l'aplicació. Pot haver-hi més d'un destíassociat a l'origen si s'aplica a recintes SIGPAC diferents.

• en cas d'apilament (tipus_desti=’07’) posarem el NIF de l'agricultor del'apilament.


A posteriori, en el cas que es realitzi l’aplicació a partir d’un apilament cap acamp, s'haurà d'informar d'un nou trasllat (un origen i un –o més– destins) enun cas com el reflexat a la figura següent:

• en el camp codi_gener (codi identificador/punt generador) constarà el NIFde l'agricultor de l'apilament. Haurem seleccionat tipus_origen=’07’(Apilament).

• en el camp codi_origen haurà de figurar el codi del gestor de residusd’aplicació agrària encarregat de la gestió.


Exemple 2: Gestió de residus orgànics per aplicació agrària realitzada pelpropi productor mitjançant FD

En aquest cas el productor conjuntament amb l'agricultor són els responsablesde la gestió de residus i hauran tramitat prèviament la documentació Fitxa dedestinació (FD).

En el nostre exemple en el camp codi_gener (codi identificador/punt generador)sempre hi figurarà el codi de productor de la planta; i en el camp codi_origenapareixerà també el mateix codi de productor. Haurem seleccionattipus_origen=’06’ (Productor). Com es pot veure a la figura anterior hi hauràdos possibles tipologies de destí: camp o apilament. El destí a camp estractaria quan el propi vehicle encarregat del transport també realitzal’aplicació al camp.

Pel que fa al destí associat al transport, tindrem les següents opcions perinformar en el camp codi_desti:

• en cas de destí camp (tipus_desti=’04’) posarem el codi SIGPAC delrecinte en el qual es es realitza l’aplicació. Poden haver més d'un destí enaquest cas associat al mateix origen si s'aplica a recintes diferents.

• en cas d'apilament (tipus_desti=’07’) posarem el NIF de l'agricultor del'apilament.


A posteriori, en el cas que es realitzi l’aplicació a partir d’un apilament cap acamp, s'haurà d'informar d'un nou trasllat (un origen i un –o més– destins) enun cas com el reflexat a la figura següent:

• en el camp codi_gener (codi identificador/punt generador) constarà el NIFde l'agricultor de l'apilament. Haurem seleccionat tipus_origen=’07’(Apilament).

• en el camp codi_origen haurà de figurar el codi del productor.


Annex IV: Informació de contacte per qüestions tècniques

En el cas de que us trobeu amb problemes de tipus tècnic/informàtic operantamb els serveis web de l'SDR que es defineixen en aquest document, podeuposar-vos en contacte amb l'Oficina Tècnica de l'SDR, utilitzant qualsevol delsdos possibles canals de comunicació següents:

• Telèfon: 93 214 20 00• Correu electrònic: [email protected]


agència de residus de catalunyasdr.arc.cat/gps/arc_ws_fangs_tecnic.pdf · 2020-03-02 · 2.1. sdr...

Documents