ShopSite

Specifica API per gli ordini

Interfaccia

Dal punto di vista della CGI, l'esecuzione avviene come per qualunque altra CGI richiamata con il metodo POST. Il suo input è costituito da una serie di coppie di nomi e valori (nome=valore) delimitata da '&' e utilizza la codifica URL.

L'applicazione CGI deve individuare le coppie, determinare il nome e il valore di ognuna e decodificare sia il nome che il valore. A questo punto la CGI può comportarsi come qualunque altra CGI, ad esempio inviando al server tutti i tipi di output standard.

Attualmente, l'input è suddiviso in cinque parti.

La prima parte è l'input originale di thankyou.cgi. Di seguito vengono riportati i nomi e le descrizioni dei valori.

prevlocation
La posizione in cui l'ordine è entrato nel sistema del carrello della spesa delle CGI. Indica anche la stringa QUERY associata.
sbid
ID del carrello della spesa. È l'identificativo univoco del carrello della spesa che esegue le chiamate CGI.
storeid
Identificativo del negozio virtuale in cui vengono effettuati gli acquisti. Corrisponde all'ID contenuto nel file auth. Ogni host utilizza ID univoci per i negozi.

Le undici voci che seguono sono quelle che vengono impostate dal cliente nel modulo del carrello della spesa.

TipoPagamento
Indica il metodo di pagamento che viene scelto dal cliente nel modulo del carrello della spesa. Questo numero corrisponde all'ordine di visualizzazione dei tipi di pagamento nella videata ShopSite -> Configurazione Commercio -> Opzioni di pagamento. Ad esempio, lo 0 corrisponde a Discover e il 4 ad American Express.
  • pagamento1
  • pagamento2
  • pagamento3
  • pagamento4
Queste voci cambiano in base al tipo di pagamento. Per la carta Visa, pagamento1 indica il numero della carta, pagamento2 il nome sulla carta, pagamento3 la società e pagamento4 la data di scadenza. Per il pagamento contrassegno, queste voci sono sempre impostate su '--'.
function
Indica il percorso da seguire all'interno di thankyou.cgi. In genere viene utilizzato il valore OK.

Il blocco di coppie seguente rappresenta il file delle impostazioni del negozio virtuale. Tutti i nomi sono preceduti da 'S-'. Molti di questi nomi sono inclusi nella videata Servizio di hosting.

S-bo_dir
URL CGI ShopSite
S-bo_reg_url
URL CGI ShopSite
S-bo_secure_url
URL sicuro CGI ShopSite
S-bo_use_security
Usa sicurezza per ShopSite?
S-ccprocessor
Tipo sistema carta di credito
S-customcgi
Posizione CGI personalizzata
S-datadir
Directory dati
S-from_addr
Indirizzo "Da" nelle ricevute email
S-outputdir
Directory di output
S-outputurl
URL negozio virtuale
S-perl_loc
Posizione dell'eseguibile PERL
S-sb_dir
Directory carrello della spesa
S-sb_prompt_comments
Richiedi commenti?
S-sb_prompt_orderinst
Richiedi istruzioni di ordinazione?
S-sb_reg_url
URL CGI carrello della spesa
S-sb_secure_url
URL sicuro carrello della spesa
S-sb_use_security
Usa sicurezza per carrello della spesa?
S-sendmail_loc
Posizione dell'eseguibile sendmail

Il blocco di coppie seguente proviene da una tabella interna di thankyou.cgi. Tutti i nomi sono preceduti da 'F-'.

Voci del modulo Cassa:

Voci relative a TipoPagamento:

Informazioni varie:

Il blocco di coppie seguente proviene dal record associato all'ordine nel database degli ordini. Ogni nome è preceduto da 'O-' e corrisponde al nome del campo del database.

O-Data
Data dell'ordine
O-NumeroOrdine
Numero dell'ordine

Voci dei vari moduli:

Voci relative alle informazioni di spedizione. Se queste ultime corrispondono alle informazioni di fatturazione, per questi campi viene utilizzato il valore '--'.

Voci relative a TipoPagamento:

Altre voci di modulo:

Infine, alcune voci che non appaiono sul modulo:

O-NumeroArticoli
Numero di articoli dell'ordine
O-NomeRiferimento
Nome dell'associato (se il cliente è arrivato al negozio virtuale grazie a un associato)
O-DatiOrdine
Informazioni con codifica binaria: byte casuali (BSDI, Linux) o nulla (Solaris)
O-Visualizzato
Indica se il commerciante ha visualizzato l'ordine da ShopSite (sì o no)

Infine, le informazioni contenute nel database del carrello della spesa per ogni prodotto ordinato. Ogni nome inizia con una 'B' seguita da due o più cifre che variano in base al prodotto. I prodotti vengono numerati a partire da '01'. Il primo prodotto del carrello della spesa, pertanto, avrà il prefisso 'B01-'.

Per comprendere meglio i nomi e le funzioni, è possibile aprire il modulo Prodotti -> Aggiungi un prodotto del back office.

Pagina Principale della Guida | Cerca | Feedback
Per inviare commenti o richiedere informazioni aggiuntive, utilizzare un messaggio email di feedback.