Cliente (Fornitori e Clienti)

L'endpoint di importazione "Client" può essere utilizzato per creare sia fornitori che clienti all'interno del sistema di tracciabilità V5, che possono quindi essere utilizzati per ricevere Ordini d'acquisto e spedire Ordini di vendita rispettivamente.

Guide di integrazione correlate:

Ordini d'acquisto

Ordini di vendita

Indirizzo 

Questa guida si concentrerà su come utilizzare questo endpoint 'Client', sia tramite importazione CSV che tramite JSON tramite l'API V5.

1. Layout del centro di controllo
2. Collegamenti API
3. Guida sul campo del cliente
   1. Chiavi primarie
   2. Campi obbligatori
   3. Campi aggiuntivi
4. Esempio di set di dati
5. Metodologia
   1. 1. JSON – Importa
      2. CSV – Importa

Per quanto riguarda il modo in cui possiamo correlare l'endpoint client a ciò che vediamo nel Centro di controllo V5, questo sarà correlato sia a 'Fornitori ' e 'Clienti' finestre. Quindi per i Fornitori:

E per i Clienti:

Per saperne di più sulle definizioni di questa classe di database 'Client' e correlata, consultare il seguente collegamento:

. 

Per l'importazione tramite l'endpoint 'Client', la chiave primaria è:

Code - Codice univoco del fornitore o del cliente.

Altri campi necessari per creare una voce valida in V5:

Tipo – il tipo di cliente, che dovrebbe essere 0 per i Fornitori e 1 per i Clienti.

Altre opzioni che possiamo aggiungere dalla classe del database 'Client' sono:

Nome - Il nome del fornitore/cliente.

Firma obbligatoria - 0 o 1 per indicare se è richiesta o meno una firma quando si riceve dal/si spedisce al cliente.

Ci sono anche alcuni campi aggiuntivi che sono specifici per Fornitori :

Sito web – Il sito web del fornitore.

Nome_valuta – per impostare la valuta utilizzata dal fornitore.

E per Clienti:

Descrizione_del_set_di_etichette – consente di assegnare un set di etichette da utilizzare con i prodotti di quel cliente.

In questo articolo analizzeremo l'importazione di 1 fornitore e 1 cliente, così da poter vedere come funzioneranno nella pratica le nostre metodologie di importazione.

'Client' importa Endpoint/URI –

http://host:port/V5-API/api/integrate/import/client

Descrizione dell'endpoint

Campioni:

Utilizzando l'endpoint 'Client', possiamo strutturare un file di importazione per aggiungere un fornitore e un cliente come di seguito:

Questo file JSON di esempio può essere scaricato Qui..

Una volta pubblicato questo sul sistema, possiamo vedere che il nuovo fornitore è stato aggiunto:

Insieme al nuovo cliente:

Per le importazioni CSV dobbiamo prima creare un file di intestazione per le nostre importazioni.

Nome file definizione intestazione/colonna: “client.csvh”

I file di intestazione completati devono essere inseriti in: “ \SG Control Center\gateway\import\def_colonna”

Importa nome file CSV: “client-datetime.csv”

I CSV per l'importazione devono essere inseriti in: “ \SG Control Center\gateway\import”

Campioni:

File di intestazione:

Un file di intestazione di esempio può essere visto di seguito. Come sopra, aggiungeremo un cliente e un fornitore con gli stessi parametri:

Per ulteriori informazioni su come strutturiamo questi file, consultare il file pagina principale di integrazione. Questo file di intestazione di esempio può essere scaricato Qui..

File di importazione CSV:

Possiamo quindi usare l'ordine definito dei punti dati nell'intestazione per strutturare il nostro file di importazione. Nota che questa prima riga può essere ignorata da Control Center e quindi può essere mantenuta nel file quando si invia per l'importazione. Un esempio di importazione basato sui nostri requisiti di cui sopra sarebbe simile a questo:

Questo file di importazione di esempio può essere scaricato Qui..

Possiamo quindi trascinare questo file nella nostra cartella di importazione come definito sopra e, una volta completata l'importazione, possiamo vedere ancora una volta che il nostro fornitore:

E il cliente è stato creato: