Cliente (Fornitori e Clienti)

L'endpoint di importazione "Cliente" può essere utilizzato per creare sia fornitori che clienti all'interno del sistema di tracciabilità V5, che potranno poi essere utilizzati rispettivamente per ricevere ordini di acquisto e spedire ordini di vendita.

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 collegare l'endpoint del client a ciò che vediamo nel Centro di controllo V5, questo si applicherà sia alla finestra " Fornitori " che a quella " Clienti ". 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 è:

Codice – Il codice univoco per il fornitore o il 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 richiesta – 0 o 1 per indicare se è richiesta o meno una firma al momento della ricezione/spedizione dal cliente.

Sono presenti anche alcuni campi aggiuntivi specifici per i fornitori :

Sito web – Il sito web del fornitore.

Currency_Name – per impostare la valuta utilizzata dal fornitore.

E per i clienti :

LabelSet_Description – 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 del file di definizione dell'intestazione/colonna: "client.csvh"

I file di intestazione completati devono essere posizionati in: “<installdir>\SG Control Center\gateway\import\column_defs”

Nome del file CSV da importare: "client-datetime.csv"

I file CSV da importare devono essere posizionati nella seguente cartella: “<installdir>\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 sulla struttura di questi file, consultare la pagina principale sull'integrazione . È possibile scaricare un file di intestazione di esempio 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: