1. Home
  2. Soluzioni di integrazione
  3. Integrazioni
  4. Parametri d'integrazione opzionali

Parametri d'integrazione opzionali

1. Dati per la spedizione e la fatturazione

Alcune funzionalità o metodi di pagamento richiedono l'invio di dati per la consegna e/o la fatturazione. Di seguito sono elencati i campi rilevanti da inviare:

Formato: AN= alfanumerico / N=numerico, numero massimo di caratteri consentito
Campo / Formato Descrizione

CIVILITY

AN, 5

 Titolo per la fatturazione (Sig. Sig.ra, Dott. ecc.)

CUID

AN, 50

 Numero di tessera sanitaria / Numero tessera aziendale

ECOM_BILLTO_POSTAL_CITY

AN, 40

 Città di fatturazione

ECOM_BILLTO_POSTAL_COUNTRYCODE

AN, 2

 Codice del paese di fatturazione (BE, FR, NL, DE, ecc.)

ECOM_BILLTO_POSTAL_NAME_FIRST

AN, 35

 Nome fatturazione

ECOM_BILLTO_POSTAL_NAME_LAST

AN, 35

 Cognome fatturazione

ECOM_BILLTO_POSTAL_POSTALCODE

AN, 10

 Codice postale fatturazione

ECOM_BILLTO_POSTAL_STREET_LINE1

AN, 35

 Indirizzo di fatturazione

ECOM_BILLTO_POSTAL_STREET_NUMBER

AN, 10

 Numero civico fatturazione

ECOM_SHIPTO_DOB

yyyy-MM-dd

 Data di nascita

ECOM_SHIPTO_ONLINE_EMAIL

AN, 50

 Indirizzo email per la spedizione

ECOM_SHIPTO_POSTAL_CITY

AN, 25

 Città di spedizione

ECOM_SHIPTO_POSTAL_COUNTRYCODE

AN, 2

 Codice del paese di spedizione (ISO)

ECOM_SHIPTO_POSTAL_NAME_FIRST

AN, 35

 Nome spedizione

ECOM_SHIPTO_POSTAL_NAME_LAST

AN, 35

 Cognome spedizione

ECOM_SHIPTO_POSTAL_NAME_PREFIX

AN, 10

 Stato civile spedizione (Sig., Sig.ra, ecc.)

ECOM_SHIPTO_POSTAL_POSTALCODE

AN, 10

 Codice postale di spedizione

ECOM_SHIPTO_POSTAL_STATE

AN, 2

 Stato spedizione (codice ISO *)

ECOM_SHIPTO_POSTAL_STREET_LINE1

AN, 35

 Indirizzo di spedizione

ECOM_SHIPTO_POSTAL_STREET_NUMBER

AN, 10

 Numero civico spedizione

ORDERSHIPCOST

N

 Costo di spedizione

ORDERSHIPMETH

AN, 25

 Metodo di spedizione

ORDERSHIPTAXCODE

N

 Codice fiscale spedizione

(*I codici ISO per gli Stati Uniti sono disponibili qui. Esempio: AL (Alabama), FL (Florida))

2. Dati ordine (parametri "ITEM")

Alcune funzionalità o metodi di pagamento richiedono l'invio di dati dettagliati sull'ordine. Di seguito sono elencati i campi rilevanti da inviare:

Formato: AN = Alfanumerico / N = Numerico, numero massimo di caratteri consentito
Campo/ Formato Descrizione

ITEMATTRIBUTESxx

AN, 50

 Attributi oggetto (dimensione, colore, ecc.) (sostituisci *xx* con un numero per inserire diversi oggetti: ITEMATTRIBUTES1, ITEMATTRIBUTES2, ecc.)

ITEMCATEGORYxx

AN, 50

 Categoria oggetto (sostituisci *xx* con un numero per inserire diversi oggetti: ITEMCATEGORY1, ITEMCATEGORY2, ecc.)

ITEMCOMMENTSxx

AN, 255

 Commenti oggetto (sostituisci *xx* con un numero per inserire diversi oggetti: ITEMCOMMENTS1, ITEMCOMMENTS2, ecc.)

ITEMDESCxx

AN, 16

 Descrizione oggetto (sostituisci *xx* con un numero per inserire diversi oggetti: ITEMDESC1, ITEMDESC2, ecc.)

ITEMDISCOUNTxx

N,10

 Sconto oggetto (sostituisci *xx* con un numero per inserire diversi oggetti: ITEMDISCOUNT1, ITEMDISCOUNT2, ecc.)

ITEMIDxx

AN, 15

 Identificatore oggetto (sostituisci *xx* con un numero per inserire diversi oggetti: ITEMID1, ITEMID2, ecc.)

ITEMNAMExx

AN, 40

 Nome oggetto (sostituisci *xx* con un numero per inserire diversi oggetti: ITEMNAME1, ITEMNAME2, ecc.)

ITEMPRICExx

N, 50

 Prezzo oggetto (sostituisci *xx* con un numero per inserire diversi oggetti: ITEMPRICE1, ITEMPRICE2, ecc.)

ITEMQUANTxx

N, 50

 Quantità oggetto (sostituisci *xx* con un numero per inserire diversi oggetti: ITEMQUANT1, ITEMQUANT2, ecc.)

ITEMQUANTORIGxx

AN, 50

 Quantità massima per oggetto (sostituisci *xx* con un numero per inserire diversi oggetti: ITEMQUANTORIG1, ITEMQUANTORIG2, ecc.)

ITEMUNITOFMEASURExx

AN, 50

 Unità di misura oggetto (da utilizzarsi insieme a ITEMWEIGHT*xx*) (sostituisci *xx* con un numero per inserire diversi oggetti: ITEMUNITOFMEASURE1, ITEMUNITOFMEASURE2, ecc.)

ITEMVATxx

N, 50

 Importo IVA oggetto (sostituisci *xx* con un numero per inserire diversi oggetti: ITEMVAT1, ITEMVAT2, ecc.)

ITEMVATCODExx

N, 50

 Codice IVA oggetto (sostituisci *xx* con un numero per inserire diversi oggetti: ITEMVATCODE1, ITEMVATCODE2, ecc.)

ITEMWEIGHTxx

N, 10

 Peso dell'articolo (sostituisci *xx* con un numero per inserire diversi oggetti: ITEMWEIGHT1, ITEMWEIGHT2, ecc.)

3. Dati di viaggio

È possibile inviare ulteriori dati per le transazioni di viaggio se l'acquirente riesce a ricevere e ad elaborare i dati.

I campi nascosti relativi ai dati dei viaggi sono i seguenti:

<input type="hidden" name="DATATYPE" value="">
<input type="hidden" name="AIAIRNAME" value="">
<input type="hidden" name="AITINUM" value="">
<input type="hidden" name="AITIDATE" value="">
<input type="hidden" name="AICONJTI" value="">
<input type="hidden" name="AIPASNAME" value="">
<input type="hidden" name="AIEXTRAPASNAME1" value="">
<input type="hidden" name="AICHDET" value="">
<input type="hidden" name="AIAIRTAX" value="">
<input type="hidden" name="AIVATAMNT" value="">
<input type="hidden" name="AIVATAPPL" value="">
<input type="hidden" name="AITYPCH" value="">
<input type="hidden" name="AIEYCD" value="">
<input type="hidden" name="AIIRST" value="">
<input type="hidden" name="AIORCITY1" value="">
<input type="hidden" name="AIORCITYL1" value="">
<input type="hidden" name="AIDESTCITY1" value="">
<input type="hidden" name="AIDESTCITYL1" value="">
<input type="hidden" name="AISTOPOV1" value="">
<input type="hidden" name="AICARRIER1" value="">
<input type="hidden" name="AIBOOKIND1" value="">
<input type="hidden" name="AIFLNUM1" value="">
<input type="hidden" name="AIFLDATE1" value="">
<input type="hidden" name="AICLASS1" value="">

Formato: AN= alfanumerico / N=numerico, numero massimo di caratteri consentito
Nome / Formato Descrizione

DATATYPE

VIAGGIO

"VIAGGIO"

Obbligatorio

AIAIRNAME

AN, 20

Nome compagnia aerea

Opzionali

AITINUM

AN, 16

Numero biglietto

Air+ definisce la zona nel seguente modo: 3 cifre di prefisso della compagnia aerea (con l'aggiunta di zeri se il tipo di biglietti <> BSP + 10 caratteri per il numero di biglietto). Altri acquirenti non suddividono questa zona ma usano solo il numero di biglietto.

Obbligatorio

AITIDATE

MM/DD/YYYY or YYYYMMDD

Data emissione biglietto. Il valore predefinito è la data della transazione

Opzionali

AICONJTI

AN, 3

Biglietto coincidenza

Opzionali

AIPASNAME

AN, 49

Nome del passeggero principale. Il valore predefinito è il nome del titolare della carta di credito.

Obbligatorio solo per l'acquirente Bambora

AIEXTRAPASNAME1

AN, 49

Nome del passeggero aggiuntivo per i record dei nomi dei passeggeri con più di un passeggero. Questo campo può essere ripetuto fino a 5 volte (ad es. per 5 passeggeri aggiuntivi), cambiando la cifra alla fine del nome campo.

Obbligatorio solo per l'acquirente Bambora

AICHDET

AN, 49

Dettagli della transazione. Testo libero di descrizione o riferimento.

Opzionali

AIAIRTAX

num x100 => no decimals

Tasse aeroportuali

Opzionali

AIVATAMNT

num x100 => no decimals

Aliquota IVA

Opzionali

AIVATAPPL

D and I

 Contrassegno applicabilità IVA. Valori supportati:
  • D: normale aliquota IVA
  • I: transazione esente dall'IVA

Opzionali

AITYPCH

AN, 2

Tipo di transazione

Opzionali

AIEYCD

AN, 3

Codice area di destinazione

Opzionali

AIIRST

AN, 1

Tipo di codice area di destinazione

Opzionali

I seguenti campi possono essere ripetuti N volte, cambiando la cifra alla fine del nome campo.

Formato: AN= alfanumerico / N=numerico, numero massimo di caratteri consentito
Campo / Formato Descrizione

AIORCITY1

AN, 3 (IATA)

Aeroporto di partenza (breve)

Obbligatorio

AIORCITYL1

AN, 20

Aeroporto di partenza (lungo)

Obbligatorio

AIDESTCITY1

AN, 3 (IATA)

Aeroporto di arrivo (breve)

Obbligatorio

AIDESTCITYL1

AN, 20

Aeroporto di arrivo (lungo)

Obbligatorio

AISTOPOV1

O e X

Scalo

Valori possibili: O e X maiuscole.

  • O: il passeggero può fermarsi e trattenersi.
  • X: il passeggero non può trattenersi

Opzionali

AICARRIER1

AN 4

Codice vettore

Obbligatorio

AIBOOKIND1

AN, 2

Indicatore prenotazioni

Opzionali

AIFLNUM1

AN, 4

Numero volo

Opzionali

AIFLDATE1

MM/GG/AA o AAAAMMGG

Data volo

Obbligatorio solo per l'acquirente Bambora

AICLASS1

AN, 15

Classe aerea

Obbligatorio solo per l'acquirente Bambora