connettore e-commerce

Bman permette di integrarsi con ecommerce di terze parti, principalmente sono presenti nel software due integrazioni specifiche per bindcommerce e prestashop (tramite il connettore di prestalia) ed una dedicata agli sviluppatori.
E’ possibile settare le impostazioni di sincronizzazione degli articoli raggiungendo la pagina “utilità -> impostazioni -> impostazioni ecommerce” (avendo premura di aver attivo il relativo modulo da “utilità -> impostazioni -> impostazioni account”).
Questa sezione è dedicata agli sviluppatori che intendono interfacciarsi autonomamente con bman, ulteriori informazioni riguardanti le integrazioni prestalia/bindcommerce sono dispoinibili qui.

Invio articoli

Bman invia un file XML all’indirizzo specificato in “Connettore invio articoli” tramite una POST HTTP alla quale bman aspetta come risposta “OK”, tutte le altre possibili risposte saranno considerate errori.
Il file XML è strutturato come segue.

Esempio file XML
<?xml version=”1.0″ encoding=”utf-8″ standalone=”yes”?>

<bmanProducts AppVersion=”3″ Mode=”full” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”>

<Products>

<Product>

<InternalID>4</InternalID>bman ID
<Code>00001</Code>Codice a barre, stesso valore presente in “barcode”
<Barcode>00001</Barcode>Codice a barre, stesso valore presente in “code”
<Description>Descrizione Breve</Description>Contenuto del “Campo Descrizione” selezionato nelle impostazioni
<DescriptionHtml>Descrizione HTML</DescriptionHtml>Contenuto del campo “Descrizione HTML” dell’articolo
<Category>Categoria</Category>Contenuto del “Campo Categoria” selezionato nelle impostazioni
<Subcategory>Sottocategoria</Subcategory>Contenuto del “Campo Sottocategoria” selezionato nelle impostazioni
<Subcategory2>Sottocategoria 2</Subcategory2>Contenuto del “Campo SottoCat2” selezionato nelle impostazioni

<Subcategory9>Sottocategoria 9</Subcategory9>Contenuto del “Campo SottoCat9” selezionato nelle impostazioni
<Vat Perc=”22″ Class=”Imponibile” Description=”Aliquota 22%”>22</Vat>Aliquota IVA di default dell’articolo
<Um>pz</Um>Unità di misura, sempre “pz”
<NetPrice1>100</NetPrice1>Prezzo netto iva come indicato alla scelta “Prezzo 1” nelle impostazioni
<NetPrice2>95</NetPrice2>Prezzo netto iva come indicato alla scelta “Prezzo 2” nelle impostazioni
<GrossPrice1>122</GrossPrice1>Prezzo compreso iva come indicato alla scelta “Prezzo 1” nelle impostazioni
<GrossPrice2>115.9</GrossPrice2>Prezzo compreso iva come indicato alla scelta “Prezzo 2” nelle impostazioni
<OverridePrice1></OverridePrice1>Non usato
<Override1></Override1>Non usato
<ProducerName>Produttore</ProducerName>Contenuto del “Campo Produttore” selezionato nelle impostazioni
<WeightUm>kg</WeightUm>Unità di misura del peso come impostato nelle impostazioni nel pannello “varie”
<GrossWeight>1</GrossWeight>Contenuto del campo “Peso” dell’articolo
<WarehouseLocation>Magazzino Centrale</WarehouseLocation>Nome del deposito collegato all’e-commerce
<AvailableQty>100</AvailableQty>Disponibilità dell’articolo (giacenza effettiva – articoli impegnati)
<Attribute>Per ogni campo selezionato tra “Altri Campi” nelle impostazioni, verrà inserito un elemento </Attribute>

<Name>Dettagli</Name>
<Value>dettagli del prodotto</Value>

</Attribute>
<Attribute>

<Name>Altri Dettagli</Name>
<Value>dettagli aggiuntivi del prodotto</Value>

</Attribute>
<Images>Per ogni immagine del prodotto verrà inserito un elemento <Img>. La prima immagine sarà l’immagine principale

<Img>

<source>http://dominio.bman.it/nome-immagine.jpg</source>
<lastupd>2017-03-20T15:38:29Z</lastupd>

</Img>
<Img>

<source>http://dominio.bman.it/nome-immagine2.jpg</source>
<lastupd>2017-03-20T15:39:45Z</lastupd>

</Img>

</Images>
<Variants>In caso di articolo con varianti taglia colore, per ogni variante sarà inserito un elemento <Variant>.

<Variant>

<Size>Taglia1</Size>
<Color>Colore1</Color>
<Barcode>00001T1C1</Barcode>
<AvailableQty>9</AvailableQty>

</Variant>
<Variant>

<Size>Taglia2</Size>
<Color>Colore1</Color>
<Barcode>00001T2C1</Barcode>
<AvailableQty>10</AvailableQty>

</Variant>

</Variants>

</Product>

</Products>

</bmanProducts>


Download ordini

Bman invia una richiesta HTTP GET all’indirizzo specificato in “Connettore download ordini” alla quale deve essere restituito un file XML strutturato come segue.

Esempio file XML

<?xml version=”1.0″ encoding=”Windows-1252″?>

<BmanDocuments AppVersion=”2″>

<Documents>

<Document>Ogni elemento “Document” è un ordine

<DocumentType>C</DocumentType>
<Date>2017-11-27</Date>Data dell’ordine
<Number>6</Number>Numero dell’ordine
<Numbering>/GEMWPKWQP</Numbering>Riferimento dell’ecommerce che verrà inserito nell’etichetta dell’ordine su Bman
<CustomerName>Mario Rossi</CustomerName>Dati del cliente per la fatturazione
<CustomerAddress>via larga </CustomerAddress>
<CustomerPostcode>56021</CustomerPostcode>
<CustomerCity>Cascina</CustomerCity>
<CustomerProvince>PI</CustomerProvince>
<CustomerCountry>Italy</CustomerCountry>
<CustomerFiscalCode>RSSMRA70A01H501S</CustomerFiscalCode>
<CustomerVatCode></CustomerVatCode>
<CustomerReference>Mario Rossi</CustomerReference>
<CustomerTel></CustomerTel>
<CustomerCellPhone></CustomerCellPhone>
<CustomerEmail>mario.rossi@email.it</CustomerEmail>
<DeliveryName>Mario Rossi</DeliveryName>Dati del cliente per la spedizione
<DeliveryAddress>via stretta</DeliveryAddress>
<DeliveryPostcode>56025</DeliveryPostcode>
<DeliveryCity>Pontedera</DeliveryCity>
<DeliveryProvince>PI</DeliveryProvince>
<DeliveryCountry>Italy</DeliveryCountry>
<Carrier>0</Carrier>
<TransportReason>Vendita su ecommerce</TransportReason>
<TransportedWeight>9.000000</TransportedWeight>
<TrackingNumber></TrackingNumber>
<CostDescription>Spese di trasporto</CostDescription>Descrizione delle spese accessorie (utilizzato per le spese di trasporto)
<CostVatCode>22</CostVatCode>Codice IVA delle spese accessorie
<CostAmount>0.000000</CostAmount>Ammontare delle spese accessorie (compreso IVA se “PricesIncludeVat” = True, netto se “PricesIncludeVat” = False)
<PricesIncludeVat>true</PricesIncludeVat>Specifica se i prezzi di questo ordine comprendono l’IVA (True) oppure sono netti (False)
<PaymentName>Assegno</PaymentName>Modalità di pagamento di questo ordine

<Rows>Righe dell’ordine, ogni “row” corrisponde ad un prodotto acquistato

<Row>

<Code>00001</Code>Codice dell’articolo, in caso di articolo con varianti è il codice base
<Description>Descrizione prodotto</Description>Descrizione dell’articolo
<Qty>1</Qty>
<Size>Taglia1</Size>
<Color>Colore1</Color>
<Price>115.900000</Price>Prezzo compreso IVA se “PricesIncludeVat” = True, netto se “PricesIncludeVat” = False
<VatCode>22</VatCode>Codice IVA, deve corrispondere ai codici inseriti nella tabella IVA su Bman
<EcoFee>0.000000</EcoFee>
<Stock>true</Stock>

</Row>
<Row>

<Code>002</Code>
<Description>descrizione prodotto numero 2</Description>
<Qty>1</Qty>
<Price>142.500000</Price>
<VatCode>22</VatCode>
<EcoFee>0.000000</EcoFee>
<Stock>true</Stock>

</Row>

</Rows>

</Document>

</Documents>

</BmanDocuments>

©2017 Cascinanet S.r.l.

Log in with your credentials

Forgot your details?