Endpoint di lettura

API Base Url:

dev: https://registry-read-dev.agyo.io/api

test: https://registry-read-test.agyo.io/api

prod: https://registry-read.agyo.io/api

Swagger:

https://registry-read-test.agyo.io/swagger-ui/index.html

FindItem

https://registry-read-test.agyo.io/swagger-ui.html#/API/findItemsUsingGET

Impostando

• identifier.taxId o identifier.vatNumber
• identifier.taxRegion
• packageType: BASE

È possibile cercare per CF o PIVA

Esempio ricerca per partiva iva:

https://registry-read-test.agyo.io/api/v3/items?identifier.vatNumber=44399978905&packageType=BASE&pagination.itemsPerPage=10&pagination.pageNumber=0&identifier.taxRegion=IT

Esempio ricerca per codice fiscale:

https://registry-read-test.agyo.io/api/v3/items?identifier.taxId=AAABBB12P13F205X&packageType=BASE&pagination.itemsPerPage=10&pagination.pageNumber=0&identifier.taxRegion=IT

Regole di salvataggio / cache

Una volta recuperato l’id per una determinata azienda sarà possibile salvarlo localmente solo in caso sia un UUIDv4 perchè non verrà più modificato a differenza dell’attuale codice fiscale che può subire variazioni dovuti ad eventi di rettifica.

Inizialmente la situazione sarà mista per questioni di migrazione.

In caso l’identificativo sia uguale al CF il comportamento consigliato è quello di avere una cache di alcune ore (consigliate 24/48) per evitare carico inutile verso le API di anagrafica, ma di continuare a chiederlo ogni volta che scade la cache.

Se l’identificativo risulta invece essere un UUIDv4 (o comunque lunghezza > 20 quindi oltre il formato CF italiano (16) +  i caratteri “-XXX” dell’ufficio (4)) è possibile salvarlo consapevoli del fatto che non cambierà più.