API Ordine

Automatizza i tuoi ordini con Mouser

Panoramica

Ti serve assistenza?

Non riesci a trovare ciò che state cercando? Contattaci subito e ti offriremo assistenza in merito.

Contatta Mouser ora

Descrizione

L'API Ordine ti permette di eseguire degli ordini con Mouser rimanendo nella tua applicazione. Poiché devi utilizzare dei codici articolo di Mouser, ti suggeriamo di creare il tuo elenco per l'ordine con l'API Ricerca Mouser. Di seguito trovi le spiegazioni e la documentazione riguardanti l'API Ordine.

Genera una chiave API

All'interno del tuo account My Mouser trovi una nuova sezione chiamata API nella quale registrarti e visualizzare la tua chiave API.

Genera chiave

Utilizzo delle API Ordine

L'API Ordine ti dà la possibilità di visualizzare i dettagli dell'ordine per un ordine, ottenere un elenco dei paesi, degli stati (delle regioni) e delle valute supportati e, ancora più importante, di inviare un ordine.

Come nell'API Carrello, le regole di assegnazione prezzi e di ordine sono determinate in base all'indirizzo di fatturazione associato al tuo account e all'indirizzo di spedizione predefinito o all'indirizzo di spedizione inviato con la richiesta API.

Di seguito trovi i passaggi suggeriti da seguire quando usi una delle API di Mouser:

  1. Crea un account My Mouser se non l'hai già fatto.

  2. Crea una chiave API, se non ne hai già una. Puoi farlo visitando la pagina di gestione delle API nel tuo account My Mouser.

  3. Scopri i dettagli sull'utilizzo delle API di Mouser e ottieni un codice di esempio visitando la nostra guida Le API passo dopo passo.

    Leggi la guida

  4. Visita la pagina API Explorer che contiene elenchi di tutte le API disponibili, degli endpoint di ogni API e fornisce un'area di prova facilmente utilizzabile per effettuare le richieste API.

    Visita API Explorer

  5. Crea una richiesta

  6. Invia un ordine

Endpoint

L'API Ordine fornisce gli endpoint elencati di seguito.

L'endpoint /options/query restituisce il tuo indirizzo di fatturazione e spedizione, il codice della valuta, un elenco di metodi di spedizione e le eventuali rate, metodi di pagamento, account di nolo, certificati fiscali, codici IVA e carte di credito salvate per il tuo account.

Un indirizzo di fatturazione e spedizione è necessario per usare l'endpoint options/query.

L'API Ordine supporta le carte di credito solo se hai una carta di credito salvata nel tuo account. Per gestire le carte salvate, vai qui.

Restituisce tutte le valute disponibili in base al tuo indirizzo di fatturazione/spedizione. Un indirizzo di fatturazione e spedizione è necessario per usare l'endpoint /currencies.

È possibile inserire un codice del paese di spedizione per ignorare l'indirizzo di spedizione predefinito nel tuo account

Per inviare un ordine, dovrai inviare un codice valuta per l'ordine. Come mostrato nell'immagine sotto, se vuoi scegliere la valuta Dollari USA per il tuo ordine, ti invierò il valore del codice ISO a 3 cifre per i dollari USA.

Restituisce tutti i paesi disponibili e tutte le regioni/provincie del paese. Consente all'utente di filtrare i paesi per codice paese. I valori restituiti da questo endpoint si possono utilizzare quando invii un ordine e vuoi ignorare l'indirizzo di spedizione predefinito nel tuo account.

Ad esempio, per spedire in Arizona, scegliere “AZ” come codice ISO dello stato e “US” come codice ISO del paese per presentare un ordine.

Usa questo endpoint per inviare un nuovo ordine. Come precedentemente indicato, tutti gli ordini creati qui saranno effettuati per conto del tuo account e sarà necessario creare un carrello prima di inviare un ordine.

Qualora fossero presenti degli errori nell'indirizzo di fatturazione/indirizzo di spedizione/metodo di spedizione/pagamento/Paese o valuta/rilasciati programmati, non riuscirai a inviare l'ordine. Se non sei certo della presenza di un errore, vai alla sezione sulla tolleranza agli errori.

Se un articolo nel carrello fosse errato, dovrai correggere l'errore o rimuovere l'articolo dal carrello prima di inviare un ordine.

Se l'ordine viene effettuato correttamente, verrà restituito un numero di ordine.

Invia un nuovo ordine da un ordine vecchio e se la proprietà "SubmitOrder" è impostata su "true". Se la proprietà "SubmitOrder" è impostata su false, allora verrà restituito un riepilogo dell'ordine.

Usa questo endpoint per visualizzare i dettagli per un ordine che hai creato. Per utilizzare la query, devi fornire il numero d'ordine, che viene restituito nel corpo della risposta per l'endpoint utilizzato per creare un ordine, /api/v{versione}/ordine.