api-webservices

Bman è realizzato in asp.net ed è possibile integrarsi tramite web service a disposizione in https://cloud.bman.it/bmanapi.asmx, per poter funzionare ogni service richiede la chiave messa a disposizione nel software in “utilità -> impostazioni -> web service”.

getAnagrafiche

Fornisce un insieme di articoli in base ai filtri immessi, la funzione necessita di quattro parametri: la chiave, dei filtri in formato json, il campo per il quale vogliamo ordinare i risultati ed la direzione dell’ordinamento (1 – ASC, 2 – DESC).

Ogni filtro è composto da tre stringhe: chiave, operatore e valore, per esempio

Esempio Filtri
[
{
“chiave”: “ecommerce“,
“operatore”: “=”,
“valore”: “True”
},
{
“chiave”: “opzionale5”,
“operatore”: “=”,
“valore”: “NOKIA”
}
]

L’invocazione della funzione getAnagrafiche con questi filtri produrrà l’insieme degli articoli attivati per l’ecommerce e con il campo opzionale5 contenente il valore “nokia”.

La risposta del metodo quindi fornisce un elenco dei primi 100 prodotti trovati anch’esso in formato json con le caratteristiche indicate a fianco caratteristiche

Esempio Risposta
[
{
“ID”: 1, bman ID
“codice”: “xxx”, code
“tipoCod”: 0, code type (0 – default, 1 – ean13, 2 – ean8, 3 – code128)
“venditaTouch”: true, touch interface enabling
“IDRaggruppamentoTouch”: 1, touch interface group id
“arrSconti”: [], manual discounts (IDCategoriaSconto -2 only)
“arrFoto”: [ array of images urls
“https://…..”
],
“opzionale1”: “xxx”, field1
“opzionale2”: “xxx”, field2
“opzionale3”: “xxx”, field3
“opzionale4”: “xxx”,
“opzionale5”: “NOKIA”,
“opzionale6”: “xxx”,
“opzionale7”: null,
“opzionale8”: null,
“opzionale9”: null,
“opzionale10”: null,
“opzionale11”: null,
“opzionale12”: null,
“opzionale13”: null,
“opzionale14”: null,
“opzionale15”: null,
“opzionale16”: null,
“opzionale17”: null,
“opzionale18”: null,
“opzionale19”: null,
“opzionale20”: null,
“opzionale21”: null,
“opzionale22”: null,
“opzionale23”: null,
“opzionale24”: null,
“opzionale25”: null,
“prza”: 40.9836065573771, purchase prize (vat excluded)
“przb”: 57.377, franchising prize (vat excluded)
“przc”: 100, selling prize (vat excluded)
“iva”: 22, vat
“IDIva”: 5, vat id
“qtInCreazione”: 0, deprecated
“punti”: 0, deprecated
“IDCategoriaSconto”: 1, discount category id
“IDCategoriaProvv”: -1, deprecated
“tipoArt”: 4, type(0 – simple, 1 – serial numbers, 4 – size/color, 10 – service, 11 – contract)
“del”: false, deleted (always false)
“durata”: 0, duration (type 10/11 only)
“rinnovo”: false, Tacit Renewal (type 11 only)
“foto”: “”, deprecated
“sottoscorta”: 0, under stock value (type 0, 1 only)
“IDOperazione”: 0, bman use only
“IDFornitore”: 0, deprecated
“tipoforn”: 0, deprecated
“IDAttributo”: 0, attribute id
“altezza”: 0, height
“larghezza”: 0, width
“profondita”: 0, depth
“peso”: 0, weight
“tipoServ”: 0, deprecated
“riordino”: 1, reorder value (type 0, 1 only)
“IDCollegamento”: 0, deprecated
“IDConto”: 0, deprecated
“ecommerce”: true, ecommerce enabling
“bmanShop”: false, bshop enabling
“bmanShopInEvidenza”: false, bshop in evidence enabling
“descrizioneHtml”: “…”, html descriprion
“byteFoto”: 0, deprecated
“IDGruppoTaglie”: 2, group size id (type 4 only)
“inCreazione”: false, bman use only
“inCreazioneIDUtente”: 1, bman use only
“tipoArtCreazione”: 0, bman use only
“dizionarioPersonalizzazioni”: {}, customizable values for storage
“IDCategoria1”: 1, category1 ID
“IDCategoria2”: 2, category2 ID
“IDCategoria3”: 0, category3 ID
“IDCategoria4”: 0, ..
“IDCategoria5”: 0, ..
“IDCategoria6”: 0, ..
“IDCategoria7”: 0, ..
“IDCategoria8”: 0, ..
“IDCategoria9”: 0, ..
“IDCategoria10”: 0, ..
“categoria1str”: “xxx”, category1 string description
“categoria2str”: “xxx”, category2 string description
“categoria3str”: null, category3 string description
“categoria4str”: null, ..
“categoria5str”: null, ..
“categoria6str”: null, ..
“categoria7str”: null, ..
“categoria8str”: null, ..
“categoria9str”: null, ..
“categoria10str”: null, ..
“IDContoAcquisto”: 7, purchasing count id
“IDContoVendita”: 12, selling count id
“dizionarioCodici”: { variants’s codes (type 4 only)
“0”: { color ID
“7”: “fan.38.bei”, size ID: code
“8”: “fan.40.bei”, size ID: code
“9”: “fan.42.bei”, ..
“10”: “fan.44.bei”, ..
“11”: “fan.46.bei”, ..
“12”: “fan.48.bei”, ..
“13”: “fan.50.bei”, ..
“14”: “fan.52.bei” ..
},
“1”: {
“7”: “fan.38.ner”,
“8”: “fan.40.ner”,
“9”: “fan.42.ner”,
“10”: “fan.44.ner”,
“11”: “fan.46.ner”,
“12”: “fan.48.ner”,
“13”: “fan.50.ner”,
“14”: “fan.52.ner”
}
},
“righeColori”: { colors
“0”: “beige”, ID: description
“1”: “nero” ID: description
},
“colonneTaglie”: { sizes
“7”: “38”, ID: description
“8”: “40”, ID: description
“9”: “42”, ..
“10”: “44”, ..
“11”: “46”, ..
“12”: “48”, ..
“13”: “50”, ..
“14”: “52” ..
},
“coloriBloccati”: [ bman use only
0,
1
],
“dizionarioGiacenze”: null, bman use only
“dizionarioQtCarico”: null, bman use only
“dizionarioSottoScorta”: null, bman use only
“dizionarioRiordino”: null, bman use only
}
]

getCategorie

Fornisce l’elenco delle categorie/sottocategorie, la funzione necessita di due parametri: la chiave e l’ID della categoria padre (-1 per la radice) e restituisce tutte le categorie figlie, con più invocazioni di questa funzione è possibile ricostruire l’albero completo delle categorie di Bman.

Esempio Risposta
[
{
“IDCategoria”: 1, category ID
“IDCategoriaPadre”: -1, father category ID
“livello”: 1, layer
“descrizione”: “Abbigliamento” description
},
{
“IDCategoria”: 2, category ID
“IDCategoriaPadre”: -1, father category ID
“livello”: 1, layer
“descrizione”: “Accessori” description
}
]

getCliente

Restituisce tutti i dati del cliente, la funzione necessita di due parametri: la chiave e l’ID del cliente.

Esempio Risposta
{
“IDCliente”: 531, contact ID
“IDUtenteCreazione”: -1, bman use only
“TipoCliente”: 0, client type (0 – personal, 1 – company)
“RagioneSociale”: “”, business name (tipocliente 1 only)
“Nome”: “Mario”, name (tipocliente 0 only)
“Cognome”: “Rossi”, surname (tipocliente 0 only)
“indirizzo”: “Via Roma”, address
“civico”: “10”, street number
“cap”: “00100”, postal code
“comune”: “Roma”, city
“provincia”: “RM”, province
“nazione”: “Italia”, nation
“telefono1”: “1235467890”, phone number 1
“telefono2”: “”, phone number 2
“cellulare”: “3454367890”, cell phone number
“prefissoTelefono1”: “0039”, international prefix phone number 1
“prefissoTelefono2”: “0039”, international prefix phone number 2
“prefissoCellulare”: “0039”, international prefix cell phone
“email1”: “prova@prova.it”, email 1
“email2”: “”, email 2
“pec”: “”, pec
“url”: “https://www.bman.it”, url
“dataNascita”: “1900-01-01T00:00:00”, birth date
“dataRegistrazione”: “1900-01-01T00:00:00”, fidelity card registration date
“dataInserimento”: “2017-03-31T11:49:47”, creation date
“sesso”: “M”, sex (M – male, F – female)
“codiceFiscale”: “RSSMRA70A01H501S”, fiscal code
“partitaIva”: “12345645654”, vat number
“prefissoPartitaIva”: “IT”, prefix vat number
“note”: “”, notes
“IDListinoSconto”: 1, discount list ID
“userArea”: false, user area enabling
“IDProfiloUserArea”: 1, user area profile ID
“dataAttivazioneUserArea”: “1900-01-01T00:00:00”, user area registration date
“IDGruppoScadenza”: 0, terms profile ID
“Tipo”: 0, type (0 – customer, 1 – supplier, 2 – generic)
“Banca”: “”, bank
“Iban”: “”, iban
“BicSwift”: “”, bic swift
“ContoTerzi”: false, third parties enabling
“lead”: false, lead flag
“IDConto”: 0, default count ID
“IDRitenuta”: 0, default Withholding ID
“userAreaUsername”: null, user area username
“userAreaPassword”: null, user area password
“visibilita”: 1, visibility (public – 1, private – 2)
“IDRagioneInserimento”: 1, business area ID
“sediAlternative”: [ alternative locations
{
“IDSede”: 224, location ID
“IDCliente”: 531, contact ID
“etichetta”: “Destinazione merce”, label
“contatto”: “Mario Verdi”, contact
“indirizzo”: “Via E. Toti”, address
“civico”: “543/A”, street number
“cap”: “89036”, postal code
“provincia”: “RC”, province
“comune”: “Brancaleone”, city
“nazione”: “Italia” nation
},
{
“IDSede”: 265, location ID
“IDCliente”: 531, contact ID
“etichetta”: “Sede Milano”, label
“contatto”: “Maria Bianchi”, contact
“indirizzo”: “Via Italia”, address
“civico”: “24”, street number
“cap”: “20121”, postal code
“provincia”: “MI”, province
“comune”: “Milano”, city
“nazione”: “Italia” nation
},
],
“IDIvaPredefinita”: 0, default VAT ID
“pubblicaAmministrazione”: false, public addministration flag
“indicePA”: “”, public administration code (pubblicaAmministrazione only)
“fatturazioneElettronicaPrivati”: false, electronic invoice enabling
“codicefatturazioneElettronicaPrivati”: “”, electronic invoice code (fatturazioneElettronicaPrivati only)
“getTotPunti”: 0, total fidelity card points
“getCard”: null, fidelity card number
“getScelta1”: false, privacy option flag 1
“getScelta2”: false, privacy option flag 2
“getCodiceBindCommerce”: null, bind commerce ID
“getInseritoDaBindCommerce”: true, bind commerce flag
“regimeFiscale”: null, tax system code
“REAProvincia”: null, business register province
“REANumero”: null, business register number
“REACapitaleSociale”: null, business register social amount
“REASocioUnico”: null, business register sole shareholder
“REALiquidazione”: null, business register closeout flag
“CoordBancarie”: “”, bank account details
“isEstero”: false, foreign italy flag
“isAffiliato”: false affiliate flag
}

getDisponibilitaArticolo

Fornisce la disponibilità corrente dell’articolo, la funzione necessita di 5 parametri: la chiave, l’ID bman dell’anagrafica in questione, l’ID del deposito sul quale vogliamo conoscere la disponibilità e la taglia ed il colore (se l’anagrafica è di questo tipo).


getIDClienteDaCodiceFiscale

Fornisce l’ID del cliente bman con il codice fiscale passato, la funzione necessita di 2 parametri: la chiave ed il codice fiscale, se non viene trovato nessun cliente viene restituito 0


getIvaArticolo

Fornisce l’iva corretta per il singolo articolo (l’iva potrebbe cambiare per fatturazioni a clienti esteri), la funzione necessita di 3 parametri: la chiave, l’ID bman dell’anagrafica e l’ID del cliente al quale l’articolo sarà venduto


getIvaPredefinita

Fornisce l’Iva predefinia, la funzione necessita di 2 parametri: la chiave e l’ID del cliente (opzionale, valore di default 0).
Se il cliente viene passato la funzione restituisce l’iva di default del cliente, altrimenti viene restituita l’iva di default dell’account


getOrdini

Fornisce la lista degli ordini in base ai filtri indicati, la funzione necessita di 2 parametri: la chiave e i filtri.

Ogni filtro è composto da tre stringhe: chiave, operatore e valore, per esempio

Esempio Filtri
[
{
“chiave”: “IDMittente”,
“operatore”: “=”,
“valore”: “531”
}
]

L’invocazione della funzione getOrdini con questi filtri produrrà l’insieme degli ordini del cliente con ID 531

Esempio Risposta
[
{
“IDOrdine”: 15, oreder ID
“numero”: 12, order number
“etichetta”: “19”, ??
“data”: “2016-08-09T00:00:00”, order date
“IDMittente”: 531, sender ID
“IDDestinatario”: 1, receiver ID
“tipoMittente”: 3, sender type (1 – user, 2 – group, 3 – customer)
“tipoDestinatario”: 2, receiver type (1 – user, 2 – group, 4 – supplier)
“IDCTerzi”: -1, third parties ID
“tipoTerzo”: -1, third parties type (0 – personal, 1 – company)
“IDDestinazione”: 2, destination ID
“destinazione”:Maria Bianchi Via Italia 24 20121 Milano (MI)”, destination description
“stato”: 3, state (1 – cimpilating, 3 – sent, 7 – dispatched, 8 – shipped, 11 – closed, 20 –
archived)

“consegna”: “”, shipping details
“corriere”: “”, carrier
“peso”: “”, weight
“colli”: “”, packages
“aspetto”: “”, appearance
“porto”: “”, carriage
“causale”: “”, reason
“note”: “”, notes
“noteInvisibili”: “”, hidden notes
“tipo”: 7, bman use only (always 7)
“codiceUniversale”: “I2CAX5TXGS20170331115636LFZID46GRTT27S9W”, bman use only
“oggetti”: [
{
“IDAnagrafica”: 44, Bman ID
“codice”: “test1”, code
“qt”: 1, quantity
“prezzoIvato”: 9.9, price vat included
“prezzoNetto”: 8.11475409836066, net price
“descrizione”: “test object”, description
“fotoPrincipale”: “http://”, url photo
“taglia”: null, size
“colore”: null color
},
{
“IDAnagrafica”: -1, Bman ID
“codice”: “SPESE_TRASPORTO”, code
“qt”: 1, quantity
“prezzoIvato”: 8.54, price vat included
“prezzoNetto”: 7, net price
“descrizione”: null, description
“fotoPrincipale”: “”, url photo
“taglia”: “”, size
“colore”: “” color
}
],
“pagamenti”: [
{
“ID”: 14, payment ID
“IDModalita”: 14, payment mode ID
“strModalita”: “Bonifico bancario”, payment mode description
“IDGruppoScad”: -1, terms profile ID
“netto”: 6.65143778554152, net price
“ivato”: 8.11, price vat included
“iva”: 22, vat
“IDDoc”: 0, referred document ID
“tipoDoc”: 0 referred document type
}
]
}
]

getPrezziAnagrafica

Fornisce tutti i possibili prezzi dell’anagrafica, la funzione necessita di 5 parametri: la chiave e l’ID Bman dell’anagrafica, l’ID del cliente del quale il sistema deve calcolare l’iva (opzionale, valore di default 0), l’id del listino da applicare (opzionale, valore di default 0) ed un booleano per specificare se utilizzare il listino del cliente oppure il listino passato qualora vengano passati entrambi (true per il cliente, false per il listino)

Esempio Risposta
{
“IDAnagrafica”: 58, Bman ID
“przANetto”: 10, purchasing net price
“przBNetto”: 0, franchising net price
“przCNetto”: 20, selling net price
“przAIvato”: 12.2, purchasing price vat included
“przBIvato”: 0, franchising price vat included
“przCIvato”: 24.4, selling price vat included
“przCalcolatoNetto”: 18, net price calculated by customer and list
“przCalcolatoIvato”: 21.96, price vat included calculated by customer and list
“aliquota”: 22, vat
“IDAliquota”: 5, vat ID
“arrPrezzi”: [ lists
{
“IDListino”: 1, list ID
“descListino”: “Listino 1”, list description
“pNetto”: 19, net price
“pIvato”: 23.18 price vat included
},
{
“IDListino”: 2,
“descListino”: “Listino 2”,
“pNetto”: 18,
“pIvato”: 21.96
},
{
“IDListino”: 3,
“descListino”: “Listino 3”,
“pNetto”: 16.5,
“pIvato”: 20.13
}
]
}

getPrezzoDiVenditaIvato

Fornisce il prezzo di vendita comprensivo di iva e con sconti/listini personalizzati, la funzione necessita di 5 parametri: la chiave e l’ID Bman dell’anagrafica, l’ID del cliente del quale il sistema deve calcolare l’iva (opzionale, valore di default 0), l’id del listino da applicare (opzionale, valore di default 0) ed un booleano per specificare se utilizzare il listino del cliente oppure il listino passato qualora vengano passati entrambi (true per il cliente, false per il listino)


creaOrdine

Crea un nuovo ordine in Bman, la funzione necessita di 2 parametri: la chiave e l’ordine nel seguente formato json.
La funzione restituisce l’ID dell’ordine creato (-1 in caso di errore)

Esempio Nuovo Ordine
{
“cliID”: 531, bman customer ID (if unset bman will create new one)
“cliNome”: “Mario”, customer name (type 0 only)
“cliCognome”: “Rossi”, customer surname (type 0 only)
“cliRagioneSociale”: null, customer business name (type 1 only)
“cliIndirizzo”: “Via Roma”, customer address
“cliCivico”: “10”, customer street number
“cliCap”: “00100”, customer postal code
“cliComune”: “Roma”, customer city
“cliProvincia”: “RM”, customer province
“cliNazione”: “Italia”, customer nation
“cliPIva”: “12345645654”, customer vat number
“cliCodFiscale”: “RSSMRA70A01H501S”, customer fiscal code
“cliTelefono”: “1235467890”, customer phone
“cliCellulare”: “3454367890”, customer cell phone
“cliEmail”: “prova@prova.it”, customer email
“cliPec”: null, customer pec
“cliTipo”: 0, customer type (0 – personal, 1 – company)
“spedizioneNome”: “Maria Bianchi”, shipping name
“spedizioneIndirizzo”: “Via Italia”, shipping address
“spedizioneCivico”: 24, shipping street number
“spedizioneCap”: “20121”, shipping postal code
“spedizioneComune”: “Milano”, shipping city
“spedizioneProvincia”: “MI”, shipping province
“spedizioneNazione”: “Italia”, shipping nation
“spedizioneIDSede”: 2, shipping destination ID
“statoPagamento”: 1, payment state (not payed – 1, payed 2)
“IDModalitaPagamento”: 1, payment mode ID
“oggetti”: [ purchased items
{
“IDAnagrafica”: 3, Bman ID
“codice”: “plana”, code
“qt”: 2, quantity
“prezzoIvato”: 36.07, price vat included
“prezzoNetto”: 32.7868852454545, net price
“descrizione”: “Placca in tecnopolimero”, description
“fotoPrincipale”: “https://…”, url foto
“taglia”: null, size
“colore”: null color
},
{
“IDAnagrafica”: 26,
“codice”: “BP421365”,
“qt”: 4,
“prezzoIvato”: 24.4,
“prezzoNetto”: 20,
“descrizione”: “test”,
“fotoPrincipale”: “https://sviluppo.bman.it/Dati/magnove/imgArticoli/26-21-cascinanetNoScritta(2).png”,
“taglia”: null,
“colore”: null
},
{
“IDAnagrafica”: -1,
“codice”: “SPESE_TRASPORTO”, shipping costs
“qt”: 1,
“prezzoIvato”: 10.00034,
“prezzoNetto”: 8.197,
“descrizione”: “Spese di spedizione”,
“fotoPrincipale”: “”,
“taglia”: “”,
“colore”: “”
}
],
“IDGruppoOrdine”: 1, bman use only
“IDDeposito”: 1, bman use only
“gruppiContatti”: [ if bman create new customer it will be associated to this groups
“1”
],
“note”: null notes
}

©2017 Cascinanet S.r.l.

Log in with your credentials

Forgot your details?