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.htmlui/index.html?configUrl=/v3/api-docs/swagger-config

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

Se v3:

 

Se v2 (deprecate):

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

Inizialmente la situazione saràsarà mista per questioni di migrazione.

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