API Servizi di incasso MAV
L’integrazione delle funzionalità all’interno del tuo gestionale ti permette di gestire le operazioni di incasso mediante avviso di pagamento tramite M.AV., utilizzando le seguenti API:
● API MAV Issuing with file, tramite la quale puoi richiedere l'emissione di M.AV con bollettino che viene fornito in elettronico (pdf codificato in base64) in risposta alla chiamata
● API MAV Issuing without file, con cui puoi richiedere l'emissione di M.AV. senza bollettino ma ricevendo solo il numero identificativo di M.AV. in risposta alla chiamata
In entrambi i casi, l’avviso M.AV. può essere spedito dalla banca al pagatore in formato cartaceo o via email (personalizzabile con il tuo logo) oppure gestito in completa autonomia.
● API MAV Inquiry, per ricercare e verificare lo stato dei M.AV. trasmessi da questo canale e accedere alle informazioni di numero M.AV., ID Operazione, stato e importo dell’operazione
● API MAV Collection report che consente di ottenere gli esiti dei M.AV. emessi ad una certa data, sia in formato Json che in formato standard CBI
I rapporti collegabili a questa API sono conti correnti in Euro e in divisa estera aperti presso filiali di Intesa Sanpaolo SPA e servizi di incasso.
MAV Issuing with file
Request
companyCode
String
Unique identifier of client
USE CASE YPCSGGTZN52M10F205Q
paymentType
String
Unique identifier of payment
USE CASE ypcsggtzn52m10f205q-lineamedsrl3641
debtorCode
String
Unique identifier of debtor, max length 16
USE CASE 123456
paymentPurpose
String
USE CASE 123456
paymentduedate
String
USE CASE 2022-11
paymentAmountInCents
String
USE CASE 1012
userName
String
Optional data, max lenght 64
USE CASE abcde1234
debtorFiscalCode
String
USE CASE ABCDEF12G34H567I
debtorSurnameOrBusinessName
String
surname of debtor for retail; business name for company
USE CASE Bud Spencer
debtorName
String
The name of who has to do the MAV payment; max lenght 30
USE CASE Carlo
debtorAddress
String
USE CASE via torre degli agli
debtorZipCode
String
USE CASE 55100
debtorLocation
String
USE CASE Firenze
debtorProvince
String
USE CASE FI
debtorNation
String
USE CASE IT
debtorEmail
String
Email address to which the file will be sent if choosen by the client
USE CASE abcd123@sbrfg.com
media
String
It can be "POSTA" or "MEDIA" or null and defines the way to address the MAV to the debtor
USE CASE POSTA
Response
resultCode
String
USE CASE 0
resultDescription
String
USE CASE OK
MAV number
String
Unique identifier of the MAV
USE CASE 03069052366243783
pdfDocument
String
string codified in base64 with the file
operationID
String
USE CASE 000001987184
request
String
Response example
json
{
"resultCode": "0",
"resultDescription": "OK",
"mavNumber": "03069052366243783",
"operationId": "000001987184",
"request": {
"companyCode": "YPCSGGTZN52M10F205Q",
"paymentType": "ypcsggtzn52m10f205q-lineamedsrl3641",
"debtorCode": "123456",
"paymentPurpose": "123456",
"paymentDueDate": "2022-11-30",
"paymentAmountInCents": "1012",
"userName": "abcde1234",
"debtorSurnameOrBusinessName": "Bud Spencer",
"debtorName": "Carlo",
"debtorAddress": "via torre degli agli",
"debtorZipCode": "55100",
"debtorLocation": "FIRENZE",
"debtorProvince": "FI",
"debtorNation": "IT",
"media": "POSTA"
}
}