API Fornitori¶

Endpoint disponibili¶

Metodo	Path	Descrizione
GET	`/v1/fornitore`	Lettura lista fornitori (filtri: `codice_interno`, `rag_soc`, paginazione)
GET	`/v1/fornitore/up`	Lettura fornitori aggiornati a partire da un `sync` id

Solo lettura

L'endpoint fornitori e' disponibile solo in lettura (GET). Non e' previsto un metodo POST per inserimento/aggiornamento.

Campo	Tipo	Campo DB	Note
`codice_interno`	string	`a_for_codana`	Codice interno anagrafica fornitore
`rag_soc`	string	`a_for_nome`	Ragione sociale
`indirizzo`	string	`a_for_indi`	Indirizzo
`localita`	string	`a_for_loca`	Localita'
`provincia`	string	`a_for_prov`	Provincia (2 char)
`cap`	string	`a_for_cap`	CAP
`email`	string	`a_for_email`	Email
`tel`	string	`a_for_tel`	Telefono
`nazione`	string	`a_for_nazione`	Codice nazione (3 char)
`fax`	string	`a_for_fax`	Fax
`cofi`	string	`a_for_cofi`	Codice fiscale
`piva`	string	`a_for_piva`	Partita IVA
`cod_rif`	string	`a_for_cod_rif`	Codice riferimento interno (non e' il codice host)
`latitudine`	number	`a_for_latitudine`	Latitudine
`longitudine`	number	`a_for_longitudine`	Longitudine
`tipo_trasporto`	string	`a_for_tipo_trasporto`	Tipo trasporto (1 char)
`iban`	string	`a_for_iban`	IBAN
`fascia_trf`	string	`a_for_fascia_trf`	Fascia tariffaria (2 char)
`tip_pag`	string	`a_for_pag_tip`	Tipo pagamento (1 char)
`cod_pag`	string	`a_for_pag_cod`	Codice pagamento (2 char)
`codice_host_pagamento`	string	join `ARPTABELLE`	Codice host del pagamento (provenienza 'A', tipo 'CP')
`sync`	integer	`a_for_id_sincro`	ID di sincronizzazione
`cancellato`	boolean	`a_for_val`	`true` se `a_for_val = 'C'`

Parametro	Tipo	Obbligatorio	Note
`limit`	integer	NO	Max risultati (default/max: 500)
`page`	integer	NO	Pagina (paginazione offset-based)
`codice_interno`	string	NO	Filtro per codice interno (match esatto)
`rag_soc`	string	NO	Filtro per ragione sociale (ILIKE %...%)

Il GET / esclude i fornitori cancellati (a_for_val <> 'C').

Parametro	Tipo	Obbligatorio	Note
`sync`	integer	SI	ID sincronizzazione di partenza

Il GET /up restituisce anche i fornitori cancellati (per consentire la sincronizzazione della cancellazione).

La tabella principale e' TBFORNITORI (PK: a_for_azi, a_for_codana).

Tabella	Condizione	Tipo	Scopo
`ARPTABELLE`	`a_for_azi = a_tab_azienda AND a_tab_provenienza = 'A' AND a_tab_tipo = 'CP' AND a_for_pag_cod = a_tab_cod`	LEFT	Codice host pagamento

La tabella TBFORNITORI non ha un campo codice_host per il raccordo con sistemi esterni
Il campo cod_rif (a_for_cod_rif) e' un riferimento interno, non un codice host
Limite max per risposta: 500 record