Torna al sito di Bman

API Web Service

Importante

Bman è realizzato in asp.net ed è possibile integrarsi tramite web service a disposizione in

https://api.bman.it/bmanapi.asmx

per poter funzionare ogni service richiede la chiave messa a disposizione nel software in “utilità -> impostazioni -> web service”.
Funzione disponibile solo nella versione Enterprise

getAnagrafiche

Fornisce un insieme di articoli in base ai filtri immessi, la funzione necessita dei parametri:

Parametri
chiave [String] – Stringa alfanumerica che identifica l’account, ottenibile da utilità - impostazioni - integrazione
filtri [Json] – Campi per i quali è possibile filtrare
ordinamentoCampo [String] – nome del capo per il quale vogliamo che siano ordinati i risultati
ordinamentoDirezione [Integer] – dal più piccolo al più grande o viceversa.
Valori ammessi: 1 – ASC, 2 - DESC
numero di pagina [Integer] – Numero di pagina di 100 elementi

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 50 prodotti trovati anch’esso in formato json con le caratteristiche indicate a fianco

Vengono restituiti al massimo 50 articoli per pagina ordinati per il campo specificato in ordinamentoCampo. Se non viene specificato nessun campo per il quale ordinare, i risultati saranno ordineati in base all'IDAnagrafica. Chiedendo la pagina 1, saranno restituiti primi 50 articoli (dal 1 al 50-esimo), per avere dal 51-esimo articolo al 100-esimo, sarà necessario richiedere pagina = 2 e così via.

Se non inserito nessun filtro con chiave tipoArt, verranno restituiti tutti gli articoli corrispondenti agli altri eventuali filtri immessi. Per i valori di tipoArt, vedere la tabella valori Tipi Articoli

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, 5 – variants, 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 (type 4 only)
“0”: “beige”, ID: description
“1”: “nero” ID: description
},
“colonneTaglie”: { sizes (type 4 only)
“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
“saldo”: { on sale section
“IDAnagrafica”: 1, bman id
“IDAnagraficaVariante”: 0, used in lista_varianti only
“IDSaldo”: 0, sale id
“inizio”: 1900-01-01T00:00:00, date start
“fine”: 1900-01-01T00:00:00, date end
“arrSaldoListini”: [] sale prices
},
“TipoCodFE”: null, code type (electronic invoce use)
“fuoriProduzione”: false, out of production
“dict_varianti”: [ bman use only (type 5 only)
“1”: [15, 16],
“3”: [23, 8]
],
“lista_varianti”: [ vatiants list (type 5 only)
{
“IDAnagraficaVariante”: 150, variant id
“codice”: “B43515U9.Bia.S.10x” variant code
“tipoCod”: 3, specific variant code type (0 – default, 1 – ean13, 2 – ean8, 3 – code128)
“tipoCodiceFE”: null, code type (electronic invoce use)
“przA”: null, variant purchase prize (vat excluded)
“przB”: null, variant franchising prize (vat excluded)
“przC”: null, variant selling prize (vat excluded)
“altezza”: null, variant height
“larghezza”: null, variant width
“profondita”: null, variant depth
“peso”: null, variant weight
“IDAttributo”: null, variant attribute id
“sottoscorta”: 2, varint under stock value
“riordino”: 3, variant reorder value
“lista_valori_varianti”: [ vatiants list
{
“IDVariante”: 1, variant type id
“IDVarianteValore”: 1, variant value id
“strVariante”: “Colore”, variant type string
“strVarianteValore”: “Bianco” variant value string
},
{
...all the variant values...
}
],
“arrSconti”: [], variant manual discounts (IDCategoriaSconto -2 only)
“saldo”: { on sale section
“IDAnagrafica”: 1, bman id
“IDAnagraficaVariante”: 0, variant id
“IDSaldo”: 0, sale id
“inizio”: 1900-01-01T00:00:00, date start
“fine”: 1900-01-01T00:00:00, date end
“arrSaldoListini”: [] sale prices
},
“dizionarioPersonalizzazioni”: {}, customizable values for storage
“arrFoto”: [ array of images urls
“https://…..”
]
},
{
...all the variants...
}
}
]

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 dei parametri:

Parametri
chiave [String] – Stringa alfanumerica che identifica l’account, ottenibile da utilità - impostazioni - integrazione
filtri [Json] – Campi per i quali è possibile filtrare
Valori ammessi: ID, IDMittente, tipoMittente, dal, al, stato, numero, codice
campoDescrizione [String] – Campo da utilizzare per popolare la descrizione degli articoli. Accetta i valori nel formato opzionaleN dove N è un numero compreso tra 1 e 25.
Se si passa il valore vuoto, verrà restituita la descrizione dell'articolo nel formato previsto per la visualizzazione sulle schermate di vendita al banco.
soloIntestazione [Boolean] – se true verranno inseriti nei risultati anche i dettagli delle righe degli ordini

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

Parametri all'interno dei filtri
ID - ID dell'ordine

IDMittente - ID del mittente dell'ordine; in base al tipoMittente acquisterà un diverso significato

tipoMittente - Accetta i valori:
  • 1: Utente
  • 2: Gruppo di Utenti
  • 3: Contatto in rubrica (cliente / fornitore)
dal - Data a partire dalla quale viene effettuata l'estrazione degli ordini. Come orario è sempre utilizzato 00:00:00. Accettata nel formato GG/MM/AAAA

al - Data fino alla quale viene effettuata l'estrazione degli ordini. Come orario è sempre utilizzato 23:59:59. Accettata nel formato GG/MM/AAAA

stato - Si riferisce allo stato dell'ordine e accetta i valori:
  • 1: in compilazione
  • 3: inviato / ricevuto
  • 7: evaso
  • 8: spedito
  • 11: chiuso
  • 20: archiviato
numero - Numero dell'ordine

codice - Codice riportato in formato barcode sulla stampa in pdf degli ordini

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)
“cliFatturazioneElettronica”: 3, customer electronical invoice type (1 - none, 2 - public administration, 3 - private)
“cliCodiceFatturazioneEletronica”: “0000000”, electronical invoice code
“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 (-1 for default customer office)
“statoPagamento”: 1, payment state (1 not payed, 2 payed)
“IDModalitaPagamento”: 1, payment mode ID
“oggetti”: [ purchased items
{
“IDAnagrafica”: 3, Bman ID
“codice”: “plana”, code ("SPESE_TRASPORTO" to set transport cost, "INTERNAL_CODE" to set custom cost)
“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://...
“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
“noteInterne”: null hided notes
“riferimento”: eBay order xxxxxxx reference to order
“comprezzi”: 1 1 vat included - 2 vat excluded
“IDCorriere”: 0 courier id
}

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] – Stringa alfanumerica che identifica l’account, ottenibile da utilità - impostazioni - integrazione
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
Parametri
chiave [String] – Stringa alfanumerica che identifica l’account, ottenibile da utilità - impostazioni - integrazione
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
Parametri
chiave [String] – Stringa alfanumerica che identifica l’account, ottenibile da utilità - impostazioni - integrazione
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)

UpdateContatto

Aggiorna i dati del contatto. Restituisce 0 in caso positivo, restituirà valori negativi in caso di errore vedi tabella
Parametri
chiave [String] – Chiave messa a disposizione su bman in utilità – impostazioni – web service
IDContatto [Integer] – ID del contatto da modificare
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, il contatto sarà aggiornato anche se la nuova partitaIva o il nuovo codice fiscale è già presente sul sistema in un altro contatto
punti [Integer] – inserire i punti del contatto, se diversi da quelli attuali verranno incrementati o decurtati

InsertListinoSconto

Crea il listino e ne restituisce l’ID, restituirà -1 in caso di errore
Parametri
chiave [String] – Stringa alfanumerica che identifica l’account, ottenibile da utilità - impostazioni - integrazione
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] – Stringa alfanumerica che identifica l’account, ottenibile da utilità - impostazioni - integrazione
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
Parametri
chiave [String] – Stringa alfanumerica che identifica l’account, ottenibile da utilità - impostazioni - integrazione
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] – Stringa alfanumerica che identifica l’account, ottenibile da utilità - impostazioni - integrazione
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

getNomeCampoOpzionale

Fornisce il nome associato ai 25 campi opzionali, la funzione necessita di tre parametri: la chiave, l’indice del campo del quale si vuole conoscere il nome (0 per ottenere il nome di tutti i 25 campi) e il tipo di articoli (10 per servizio/contratto, qualunque altro valore per gli articoli con magazzino)
Esempio Risposta
{
“1”: "Produttore", field 1 name
“2”: "Descrizione", field 2 name
“3”: "Dettagli", field 3 name
“4”: "opzionale4", field 4 name
“5”: "opzionale5", field 5 name
“6”: "opzionale6", field 6 name
“7”: "opzionale7", field 7 name
“8”: "opzionale8", field 8 name
“9”: "opzionale9", field 9 name
“10”: "opzionale10", field 10 name
“11”: "opzionale11", field 11 name
“12”: "opzionale12", field 12 name
“13”: "opzionale13", field 13 name
“14”: "opzionale14", field 14 name
“15”: "opzionale15", field 15 name
“16”: "opzionale16", field 16 name
“17”: "opzionale17", field 17 name
“18”: "opzionale18", field 18 name
“19”: "opzionale19", field 19 name
“20”: "opzionale20", field 20 name
“21”: "opzionale21", field 21 name
“22”: "opzionale22", field 22 name
“23”: "opzionale23", field 23 name
“24”: "opzionale24", field 24 name
“25”: "opzionale25" field 25 name
}

getDocumenti

Fornisce un insieme di oggetti di tipo Documento in base ai filtri immessi, la funzione necessita dei parametri:

Parametri
chiave [String] – Stringa alfanumerica che identifica l’account, ottenibile da utilità - impostazioni - integrazione
filtri [Json] – Campi per i quali è possibile filtrare
Valori ammessi: Data, IDContatto, IDRagioneSociale, tipoDocumento, numero, IDUtente, IDDeposito
numero di pagina [Integer] – Numero di pagina di 50 elementi
ordinamentoCampo [String] – nome del capo per il quale vogliamo che siano ordinati i risultati
Valori ammessi: Data, IDContatto, IDRagioneSociale, tipoDocumento, numero, IDUtente, IDDeposito
ordinamentoDirezione [Integer] – dal più piccolo al più grande o viceversa.
Valori ammessi: 1 – ASC, 2 - DESC
dettagliato [Boolean] –se true verranno inseriti nei risultati anche i dettagli delle righe dei documenti

Vengono restituiti al massimo 50 documenti per pagina ordinati per il campo specificato in ordinamentoCampo. Se non viene specificato nessun campo per il quale ordinare, i risultati saranno ordineati in base al numero e data. Chiedendo la pagina 1, saranno restituiti i primi 50 documenti (dal 1 al 50-esimo), per avere dal 51-esimo documento al 100-esimo, sarà necessario richiedere pagina = 2 e così via.

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

Esempio Filtri
[
{
“chiave”: “data“,
“operatore”: “>=”,
“valore”: “2020-01-01T00:00:00”
},
{
“chiave”: “data“,
“operatore”: “<=”,
“valore”: “2020-01-31T23:59:59”
},
{
“chiave”: “IDContatto”,
“operatore”: “=”,
“valore”: “10”
}
]

L’invocazione della funzione getDocumento con questi filtri produrrà l’insieme dei documenti registrati (emessi e ricevuti) tra il 1 gennaio 2020 e il 31 gennaio 2020 compresi, per il contatto con ID 10. Per reperire l’IDContatto si può utilizzare la funzione getIDClienteDaCodiceFiscale già disponibile tra le Api. La risposta del metodo quindi fornisce un elenco di max 50 documenti trovati anch’esso in formato json con le caratteristiche indicate.

Esempio Risposta
[
{
“IDDocumento”: 10, Document ID
“Numero”: “9-2020”, Document number
“Data”: “2020-01-20T11:00:00”, Document date
“TipoDocumento”: 3, Document type Values table
“IDContatto”: 582, Contact id *(2)
“IDRagioneSociale”: 1, Company name *(1)
“PartitaIvaContatto”: “01234567890”, VAT number of the customer or supplier *(2)
“PartitaIvaRagioneSociale”: “09876543210”, VAT number of the company *(1)
“CodFiscaleContatto”: “01234567890”, tax code of the customer or supplier *(2)
“CodFiscaleRagioneSociale”: “09876543210”, tax code of the company *(1)
“TotaleNetto”: 8.2, total VAT excluded
“TotaleIvato”: 10, total VAT included
“urlXML”: “https://dominio.bman.it/file.xml ”, url of XML file
“urlPDF”: “https://dominio.bman.it/file.pdf ”, url of PDF file
“StatoInvioSDI”: 0, sending status to "SDI" Values table
“DataUltimoInvioSDI”: “0001-01-01T00:00:00”, date of the last sending to "SDI"
“righe”: [ rows
{
“Codice”: “0001”,product code
“Descrizione”: “descrizione articolo”, product description
“PrezzoNettoUnitario”: 8.2, price VAT excluded
“PrezzoIvatoUnitario”: 10, price VAT included
“Aliquota”: 22, tax rate
“Qt”: 1, quantity
“ScontoPerc”: 0, discount percentage
“PrezzoTotaleNetto”: 8.2, total VAT excluded
“PrezzoTotaleIvato”: 10, total VAT included
“Reso”: False, returned goods
“Taglia”: “M”, size
“Colore”: “nero”, color
“Seriale”: null serial number
}
]
}
]

*(1) Per Ragione Sociale si intende l’azienda che è registrata su Bman in Utilità - Impostazioni – Ragioni Sociali. In caso di documenti attivi (di vendita) è quella che emette il documento, nel caso di documenti passivi (di acquisto) è quella che riceve il documento.

*(2) Per Contatto si intende il contatto in rubrica. In caso di documenti attivi (di vendita) è il cliente, nel caso di documenti passivi (di acquisto) è il fornitore.

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
26 ERRORE IMPORTAZIONE SERIALE GIA' PRESENTE
27 ERRORE IMPORTAZIONE FOTO FILE TROPPO GRANDE
28 ERRORE IMPORTAZIONE FOTO HTTPS NON IMPOSTATO
29 ERRORE IMPORTAZIONE IDCONTATTO NON TROVATO
Tabella Tipi di Documento
1 Nota di credito
2 Fattura passiva (di acquisto)
3 Fattura di vendita
4 DDT
5 Scontrino
8 Acquisto non contabilizzato
9 Consumabili
10 Reso da clienti
12 DDT passivo
16 Reso verso fornitori non contabilizzato
22 Ricevuta fiscale
23 Vendita non contabilizzata
24 Reso da clienti non contabilizzato
Tabella Valori Stato invio SDI
0 Inviata (inviata ma non ancora letta la notifica di trasmissione)
1 trasmessa (inviata e ricevuta la notifica di trasmissione)
2 consegnata (inviata, ricevuta la notifica di trasmissione e ricevuta notifica RicevutaConsegna)
3 scartata (inviata, ricevuta la notifica di trasmissione e ricevuta notifica NotificaScarto)
4 nonConsegnata (ricevuta notifica NotificaMancataConsegna)
5 decorrenzaTermini (ricevuta notifica NotificaDecorrenzaTermini)
6 attestTrasmFattura (ricevuta notifica di attestazione trasmissione fattura)
7 EsitoOKPA (fatturaPA accettata)
8 EsitoKOPA (fatturaPA rifiutata)
Tabella Valori tipoArt (Tipo di articolo)
0 Semplice
1 Seriale
2 Bundle
4 Taglia / Colore
5 Varianti
10 Servizio
11 Contratto