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
}

getDepositi

Fornisce l’elenco dei depositi, la funzione necessita come parametro della chiave e restituisce tutti i depositi creati sull'account.
Esempio Risposta
[
{
"ID": 1, ID del deposito
"descrizione": "Magazzino Centrale" descrizione
},
{
"ID": 2, ID del deposito
"descrizione": "Filiale" descrizione
}
]

RenameCampiOpzionali

Con questa funzione è possibile rinominare i campi opzionali dell'account
Parametri
chiave [String] – Chiave messa a disposizione su bman in utilità – impostazioni – web service
campiUtilizzati [Boolean()] – Array di Boolean contenente alla posizione i-esima True se il campo i deve essere attivo.
nomiCampi [String()] – Array di String contenente alla posizione i-esima il nome del campo i-esimo.
tipoArticoli [Integer] – 10 per i nomi dei campi utilizzati per i servizi, 0 per i nomi dei campi degli articoli.

InsertAnagrafica

Crea l’anagrafica dell’articolo e restituisce l’ID dell’anagrafica creata, valori negativi in caso di errore (vedi tabella errori)
Parametri
chiave [String] – Chiave messa a disposizione su bman in utilità – impostazioni – web service
deposito [String] – Descrizione del deposito a cui si sta facendo riferimento. Da compilare se non si conosce l'ID del deposito.
IDDeposito [Integer] – ID del deposito a cui si sta facendo riferimento. Se non presente, questa anagrafica verrà scartata.
codice [String] – Codice dell’articolo, in genere il barcode
tipoArt [Integer] – 0 se articolo semplice, 1 se articolo seriale, 4 se articolo taglia/colore, 10 se servizio, 11 se contratto
codiciAggiuntivi [String()] – Array contenente gli eventuali codici aggiuntivi per questo articolo (i codici delle varianti Taglia / colore vanno in codiciTC

Campi opzionali da 1 a 25 contenenti le descrizioni dell’articolo. I campi da 1 a 12 accettano fino a 80 caratteri, i campi da 13 a 25 ne accettano fino a 500.
opzionale1 [String], opzionale2 [String], opzionale3 [String], opzionale4 [String], opzionale5 [String], opzionale6 [String], opzionale7 [String], opzionale8 [String], opzionale9 [String], opzionale10 [String], opzionale11 [String], opzionale12 [String], opzionale13 [String], opzionale14 [String], opzionale15 [String], opzionale16 [String], opzionale17 [String], opzionale18 [String], opzionale19 [String], opzionale20 [String], opzionale21 [String], opzionale22 [String], opzionale23 [String], opzionale24 [String], opzionale25 [String]

Descrizioni delle categorie, dal primo livello al decimo. Se non presenti sul sistema verranno create (vedi esempio)
strCategoria1 [String], strCategoria2 [String], strCategoria3 [String], strCategoria4 [String], strCategoria5 [String], strCategoria6 [String], strCategoria7 [String], strCategoria8 [String] strCategoria9 [String], strCategoria10 [String]

attributo [String] – Valore testuale per descrivere una proprietà dell’articolo; se non presente sul sistema verrà inserito
altezza [Double]
larghezza [Double]
profondita [Double]
peso [Double]
durata [Integer] – Valore in mesi della durata del contratto (questo valore è ignorato se tipoArt è diverso da 11)
rinnovo [Boolean] – True se il contratto prevede il rinnovo tacito (questo valore è ignorato se tipoArt è diverso da 11)
prza [Double] – Prezzo di acquisto netto IVA
przb [Double] - Prezzo Franchising netto IVA
przc [Double] – Prezzo di Vendita netto IVA
iva [String] – codice dell’iva predefinita dell’articolo; si deve far riferimento ai codici riportati su Utilità – Impostazioni – Iva. Se vuoto, verrà applicata l’iva di default dell’account. Se valorizzato con un valore errato, l’anagrafica sarà scartata.
punti [Double] – Lasciare 0 (zero)
categoriaSconto [String] – Inserire la descrizione di una categoria di sconto, si fa riferimento a quelle inserite su Utilità - Impostazioni - Sconti/Listini. Se la categoria inserita non è presente sul sistema, questa anagrafica verrà scartata.
categoriaProvv [String] – Lasciare vuoto
qt [Double] – quantità in giacenza di questo articolo sul deposito indicato nel parametro deposito (ignorato in caso di tipoArt = 4, tipoArt = 10 o tipoArt = 11)
sottoscorta [Double] – valore minimo della scorta di magazzino per questo articolo (ignorato in caso di tipoArt = 10 o tipoArt = 11)
riordino [Double] – valore di riordino minimo per questo articolo in caso di ordini automatici articolo (ignorato in caso di tipoArt = 10 o tipoArt = 11)


In caso di articolo taglia / colore (tipoArt = 4), devono essere valorizzati obbligatoriamente i parametri arrTaglie, arrColori, codiciTC. Se non è valorizzato il parametro qtTC si presumono tutti i valori al suo interno pari a 0 (zero). Se non valorizzati sottoscortaTC e riordinoTC si presumono tutti i valori uguali rispettivamente a sottoscorta e riordino.

arrTaglie [String] – Stringa in formato JSON di array di stringhe contenente i valori delle taglie; non può contenere valori vuoti. Non può contenere valori duplicati.
arrColori [String] - Stringa in formato JSON di array di stringhe contenente i valori dei colori; può contenere al massimo un valore vuoto. Non può contenere valori duplicati.
codiciTC [String] – Stringa in formato JSON di string()() contenente i codici di ogni variante
qtTc [String] – Stringa in formato JSON di string()() contenente le quantità in giacenza su questo deposito per ogni variante
sottoscortaTC [String] – Stringa in formato JSON di string()() contenente i valori minimi della scorta di magazzino per ogni variante su questo deposito
riordinoTC [String] – Stringa in formato JSON di string()() contenente i valori di riordino minimo per ogni variante su questo deposito
venditaTouch [Boolean] – true se questo articolo deve comparire nella schermata di vendita touch
raggruppamentoTouch [String] – descrizione del raggruppamento sulla schermata di vendita touch; se non presente sul sistema verrà creato.
contoAcquisto [String] – descrizione del conto di acquisto di default di questo articolo; se non presente sul sistema verrà creato
contoVendita [String] – descrizione del conto di vendita di default di questo articolo; se non presente sul sistema verrà creato
ecommerce [Boolean] – true se questo articolo deve essere pubblicato sull’ecommerce
descrizioneHtml [String]
bmanShop [Boolean] – true se questo articolo deve essere pubblicato su bshop
bmanShopInEvidenza [Boolean] – true se questo articolo deve essere messo in evidenza su bshop
bmanShopDataInserimento [DateTime] – data di inserimento dell’articolo su bshop
seriali [String()] – Array contenente gli eventuali seriali per questo articolo
Esempi Categorie
Sul sistema è presente questo albero:
1) LIBRI
2) GIALLO
Se provi ad inserire
Categoria1: “FILM”
Categoria2: “GIALLO”
Viene creato un nuovo albero quindi la categoria “GIALLO” verrà creata nuovamente sotto la categoria 1 “FILM”
Sul sistema è presente questo albero:
1) LIBRI
2) GIALLO
Se provi ad inserire
Categoria1: “LIBRI”
Categoria2: “GIALLO”
Categoria3: “PIU’ DI 1000 PAGINE”
Verranno identificate le prime due categorie e sarà creata solo la categoria “PIU’ di 1000 PAGINE” come livello 3 sotto la categoria 2 “GIALLO” a sua volta figlia della categoria 1 “LIBRI”
Esempio costruzione taglie e colori
Codice
"001"

arrTaglie:
[ "taglia0", "taglia1", "taglia2" ]

arrColori:
[ "colore0", "colore1" ]

codiciTC:
[
   [
      "001.colore0/taglia0",
      "001.colore0/taglia1",
      "001.colore0/taglia2"
   ],
   [
      "001.colore1/taglia0",
      "001.colore1/taglia1",
      "001.colore1/taglia2"
   ]
]
qtTC:
[
   [
      "10",
      "15",
      "20"
   ],
   [
      "25",
      "30",
      "35"
   ]
]
La variante colore0/taglia0 avrà quatità 10;
La variante colore0/taglia1 avrà quatità 15
La variante colore0/taglia2 avrà quatità 20
Ecc.

Gli altri array come sottoscortaTC e riordinoTC dovranno essere costruiti seguendo lo stesso schema.

InsertContatto

Crea il contatto e ne restituisce l’ID, restituirà valori negativi in caso di errore (vedi tabella errori)
Parametri
chiave [String] – Chiave messa a disposizione su bman in utilità – impostazioni – web service
deposito [String] – Descrizione del deposito a cui si sta facendo riferimento. Da compilare se non si conosce l'ID del deposito.
IDDeposito [Integer] – ID del deposito a cui si sta facendo riferimento. Se non presente, questo contatto verrà scartato.
tipoContatto [Integer] – Inserire 0 per indicare i clienti, 1 per i fornitori e 2 per contatti generici. In caso di valori mancanti o errati, i contatti verranno considerati generici.
ragioneSociale [String] (1)
nome [String] (1)
cognome [String] (1)
(1) Almeno uno deve essere valorizzato
prefissoPartitaIva [String] – Se vuoto viene calcolato in base al valore di nazione
partitaIva [String] – Se già presente nel sistema il contatto è scartato (2)
codiceFiscale [String] – Se già presente nel sistema il contatto è scartato (2)
(2) Se ignoraErroreDuplicato = True il contatto viene inserito anche se già presente sul sistema
dataNascita [String] – gg/mm/aaaa
sesso [String] – “m” o “f”
indirizzo [String]
civico [String]
cap [String]
comune [String] – comune italiano o città estera
provincia [String] – Sigla della provincia italiana
nazione [String]
pec [String]
email1 [String]
email2 [String]
prefisso1 [String] – prefisso telefonico relativo al telefono1; deve essere nel formato 00xx; se non presente verrà inserito “0039”
telefono1 [String]
prefisso2 [String] – prefisso telefonico relativo al telefono2; deve essere nel formato 00xx; se non presente verrà inserito “0039”
telefono2 [String]
prefissoCell [String] – prefisso telefonico relativo al cellulare; deve essere nel formato 00xx; se non presente verrà inserito “0039”
cellulare [String]
url [String]
note [String]
banca [String]
iban [String]
bicswift [String]
listinoSconto [String] – descrizione del listino sconto predefinito; se non è presente nel sistema, non verrà applicato nessun listino predefinito
gruppoScadenza [String] – descrizione del gruppo di scadenze predefinito (vedi utilità – impostazioni – Scadenze se non presente sul sistema, non verrà inserito
ivaPredefinita [String] – codice iva relativo all’iva predefinita che questo contatto dovrà utilizzare; si fa riferimento alla tabella su utilità – impostazioni – iva; se non è presente sul sistema, non verrà inserita nessuna iva predefinita
ritenutaPredefinita [String] – descrizione della ritenuta predefinita che dovrà essere applicata al contatto; si fa riferimento alla tabella su utilità – impostazioni – ritenute; se non è presente sul sistema, non verrà inserita nessuna ritenuta predefinita
contoPredefinito [String] – descrizione del conto predefinito che dovrà essere applicato al contatto; si fa riferimento alla tabella su utilità – impostazioni – Conti d’acquisto e di vendita; se non è presente sul sistema, non verrà inserito nessun conto predefinito
pubblicaAmministrazione [Boolean] – true se questo contatto è una Pubblica Amministrazione
indicePA [String] – codice univoco di 6 caratteri alfanumerici applicato all’ufficio PA
fatturazioneElettrPrivati [Boolean] – true se questo contatto prevede la fatturazione elettronica; sempre false se pubblicaAmministrazione = true
codiceFatturazioneElettrPrivati [String] - Il campo deve contenere il codice di 7 caratteri attribuito dal Sistema di Interscambio; oppure deve contenere sette zeri (“0000000”) e deve essere valorizzato il campo pec.; ignorato se pubblicaAmministrazione = true o fatturazioneElettrPrivati = false
splitPayment [Boolean] – true se questo contatto prevede lo split-payment; sempre false se pubblicaAmministrazione = true
userArea [Boolean] – inserire true se si permette a questo contatto di accedere alla user area
profiloUserArea [String] – descrizione del profilo da applicare a questo contatto; si fa riferimento alla tabella su utilità – impostazioni – area Utenti WEB; se non è presente sul sistema, verrà applicato al contatto il profilo di default
card [String]
dataRegistrazioneCard [String]
consenso1 [Boolean]
consenso2 [Boolean]
gruppoDiContatti [String] – se vuoto o non presente sul sistema, verrà applicato il gruppo di default
ignoraErroreDuplicato [Boolean] – se True, saranno inseriti i contatti anche se presenti sul sistema (il controllo è effettuato sul campo partitaIva e codiceFiscale)

InsertListinoSconto

Crea il listino e ne restituisce l’ID, restituirà -1 in caso di errore
Parametri
chiave [String] – Chiave messa a disposizione su bman in utilità – impostazioni – web service
descrizione [String] – Descrizione del listino che verrà creato.
franchising [Boolean] – True se questo listino verrà utilizzato per affiliati franchising.

InsertUpdateIva

Crea la nuova IVA e ne restituisce l’ID, restituirà -1 in caso di errore. In caso esista già una IVA con il codice passato, ne aggiornerà i dati.
Parametri
chiave [String] – Chiave messa a disposizione su bman in utilità – impostazioni – web service
codice [String] – Codice identificatvo di questa IVA.
aliquota [Double] – Valore percentuale dell'imposta.
descrBreve [String] – Descrizione breve che comparirà negli elenchi a tentina su Bman.
descrLunga [String] – Descrizione lunga che comparirà nei documenti su Bman.
percDetraibile [Double] – Percentuale detraibile di questa IVA.
reparto [Integer] – Impostazione da utilizzare per associare questa IVA al reparto sui registratori di cassa.
predefinita [Boolean] – True se questa deve essere l'IVA predefinita dell'account.

InsertFotoAnagrafica

Inserisce la foto relativa all'anagrafica passata, se tutto ok restituisce 0, restituirà valori negativi in caso di errore (vedi tabella errori)
Parametri
chiave [String] – Chiave messa a disposizione su bman in utilità – impostazioni – web service
IDAnagrafica [Integer] – ID dell'anagrafica alla quale associare l'immagine.
base64String [String] – Rappresentazione in base64 dell'immagine.
predefinita [Boolean] – True se questa deve essere l'immagine predefinita dell'anagrafica.

getDettagliCorriere

Fornisce i dettagli del corriere avente l'ID passato, la funzione necessita come parametro della chiave e dell'ID del corriere.
Esempio Risposta
{
"ID": 1, ID del corriere
"nome": "BRT" descrizione
"tempoTransito": "2 gg lavorativi" testo inserito nel campo Tempo di Transito
}

getSpesaCorriere

Con questa funzione è possibile ottenere la spesa del corriere data la nazione del cliente, il peso e il costo totale dell'ordine
Parametri
chiave [String] – Chiave messa a disposizione su bman in utilità – impostazioni – web service
IDCorriere [Integer] – ID del corriere scelto
strNazione [String] – Nazione del cliente
totNettoOrdine [Double] – Costo totale netto IVA dell'ordine.
totPesoOrdine [Double] – Peso totale degli oggetti nell'ordine.
L'invocazione della funzione getSpesaCorriere produrrà una stringa con 3 valori separati da "|"
Esempio Risposta
"prezzoNettoFascia": 8.197 Valore netto IVA
"prezzoIvatoFascia": 10 Valore Ivato
"aliquota": 22 aliquota

Tabella Errori
1 ERRORE IMPORTAZIONE GENERICO
2 ERRORE IMPORTAZIONE DUPLICATO – Il codice dell’articolo è già presente sul sistema
3 ERRORE IMPORTAZIONE IVA ERRATA – Codice IVA non presente sul sistema
4 ERRORE IMPORTAZIONE DUPLICATO PIVA – esiste già un contatto con questa partita IVA
5 ERRORE IMPORTAZIONE CONTO ERRATO – Conto di acquisto o di vendita non trovato
6 ERRORE IMPORTAZIONE NESSUN NOME – in questo contatto nome, cognome e ragione sociale non sono stati valorizzati
7 ERRORE IMPORTAZIONE PIVA MANCANTE – Valorizzata la ragione sociale ma non la Partita Iva
8 ERRORE IMPORTAZIONE PIVA ERRATA – La partita IVA deve essere di 11 cifre
9 ERRORE IMPORTAZIONE CF ERRATO – Il formato del codice fiscale non è corretto
10 ERRORE IMPORTAZIONE INDICE PA ERRATO – L’indice PA deve essere di 6 caratteri
11 ERRORE IMPORTAZIONE FOTO SPAZIO TERMINATO
12 ERRORE IMPORTAZIONE FOTO GENERICO
13 ERRORE IMPORTAZIONE FOTO FORMATO NON CORRETTO
14 ERRORE IMPORTAZIONE CATSCONTO ERRATA – Categoria di sconto non presente sul sistema
15 ERRORE IMPORTAZIONE CODICE NON GESTIBILE – il codice inserito corrisponde ad un articolo di tipo diverso
16 ERRORE IMPORTAZIONE CODICE AGGIUNTIVO GIA PRESENTE
17 ERRORE IMPORTAZIONE PREFISSO TELEFONICO NON RICONOSCIUTO
18 ERRORE IMPORTAZIONE TAGLIA NON RICONOSCIUTA – valore vuoto o duplicato nel parametro
19 ERRORE IMPORTAZIONE GRUPPO TAGLIE ERRATO
20 ERRORE IMPORTAZIONE CODICE TC GIA PRESENTE
21 ERRORE IMPORTAZIONE COD FATT ELETTRONICA PRIVATI – formato codice errato o pec non valorizzata in caso di codice “0000000”
22 ERRORE IMPORTAZIONE PROVINCIA NON RICONOSCIUTA – Non utilizzato
23 ERRORE IMPORTAZIONE DEPOSITO NON TROVATO
24 ERRORE IMPORTAZIONE TIPO ARTICOLO ERRATO
25 ERRORE IMPORTAZIONE COLORE ERRATO