Merci Fornitori¶

Endpoint disponibili¶

Metodo	Path	Descrizione
GET	`/v1/merce-fornitore`	Lettura merci fornitori (filtri: `gruppo`, `sottogruppo`, `codice`, `codice_fornitore`, paginazione)
GET	`/v1/merce-fornitore/up`	Lettura merci fornitori aggiornate a partire da un `sync` id

Solo lettura

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

Schema output — GET¶

`MerceFornitoreOutput`¶

Campo	Tipo	Campo DB / Join	Note
`gruppo`	string	join `ARPMERCI` (`rmer_gru`)	Gruppo (codice merce interno)
`sottogruppo`	string	join `ARPMERCI` (`rmer_sot`)	Sottogruppo (codice merce interno)
`codice`	integer	join `ARPMERCI` (`rmer_cod`)	Codice (codice merce interno)
`codice_host_merce`	string	join `ARPMERCI` (`trim(rmer_cma)`)	Codice della merce nel sistema host esterno (raccordo tra codice interno e codice host)
`codice_merce_fornitore`	string	`trim(a_mca_codice)`	Codice articolo utilizzato dal fornitore nei propri sistemi
`descrizione`	string	`trim(a_mca_des)`	Descrizione dell'articolo secondo il fornitore
`codice_fornitore`	string	`trim(a_mca_ana)`	Codice anagrafica fornitore interno con prefisso `F` (es. `F00123`)
`sync`	integer	`a_mca_id_sincro`	ID di sincronizzazione per aggiornamenti incrementali
`cancellato`	boolean	`a_mca_fl_canc = 'C'`	`true` se il record e' cancellato logicamente

Query string — GET `/`¶

Parametro	Tipo	Obbligatorio	Note
`limit`	integer	NO	Max risultati (default/max: 1000)
`page`	integer	NO	Pagina (paginazione offset-based)
`gruppo`	string	NO	Filtra per gruppo merce interno (match esatto su `rmer_gru`)
`sottogruppo`	string	NO	Filtra per sottogruppo merce interno (match esatto su `rmer_sot`)
`codice`	integer	NO	Filtra per codice merce interno (match esatto su `rmer_cod`)
`codice_fornitore`	string	NO	Filtra per codice anagrafica fornitore interno con prefisso `F` (es. `F00123`, match esatto su `a_mca_ana`)

Il GET / esclude le merci cancellate (join ARPMERCI con filtro rmer_stato <> 'C').

Query string — GET `/up`¶

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

Il GET /up restituisce anche i record di merci cancellate (per consentire la sincronizzazione della cancellazione): il join su ARPMERCI non applica il filtro rmer_stato.

Tabella sorgente¶

La tabella principale e' ARPMERCA (PK: a_mca_azi, a_mca_merce, a_mca_tipo_codice, a_mca_ana, a_mca_codice).

Filtro fisso: a_mca_tipo_codice = 'F' (solo codici fornitore).

Join¶

Tabella	Condizione	Tipo	Scopo
`ARPMERCI`	`rmer_azi = a_mca_azi AND rmer_cm = a_mca_merce`	INNER	Dati merce (gruppo, sottogruppo, codice, codice host)

Note implementative¶

Entrambi gli endpoint restituiscono anche i record cancellati logicamente; il campo cancellato indica lo stato.
Il GET / applica il filtro rmer_stato <> 'C' sul join con ARPMERCI, escludendo le merci cancellate. Il GET /up non applica questo filtro, restituendo anche le associazioni relative a merci cancellate.
Limite max per risposta GET: 1000 record.
Il codice_fornitore in output ha sempre il prefisso F (es. F00123); lo stesso formato e' richiesto nel parametro di filtro.