Importar varios mandatos existentes de una sola vez

Es posible importar varios mandatos en varias tiendas de una sola vez, a condición de tener:

  • El mismo deudor
  • El mismo Iban

A diferencia de la importación de un solo mandato, los datos que difiere son:

  • un nuevo punto de acceso: POST https://secure.lyra.com/sdd/multimandates
  • un parámetro suplementario sitios: [ n° de tiendas]

La respuesta tendrá:

  • un mandato por tienda
  • una tabla JSON por tienda

Para importar varios mandatos:

  1. Especificar la primera línea de la acción deseada: https://secure.lyra.com/sdd/multimandates'
  2. Construir su encabezado HTTP (ver capítulo Identificarse durante los intercambios).
  3. Añadir los campos iban, last_name, first_name, email, payment_type, locale y sites requeridos para la importación de los mandatos.
    Tabla 1. Campos obligatorios
    Campo Formato Descripción Obligatorio Ejemplo
    iban string IBAN para International Bank Account Number: Identificador de la cuenta bancaria del deudor
    "iban":"FR7630002005701234567890158"
    last_name string Apellido del deudor
    "last_name":"Durand"
    first_name string Nombre del deudor
    "first_name":"Michel"
    email string E-mail del deudor
    "email":"nombre.apellido@ejemplo.com
    payment_type string
    • RECURR
    • ONEOFF

    Tipo de mandato:
    • Recurrente
      El mandato firmado es válido para una serie de débitos.
    • Puntual
      El mandato firmado es válida para un solo débito.

    "payment_type":"RECURR"

    o

    "payment_type":"ONEOFF"

    locale string
    • FR para el francés
    • DE para el alemán
    • EN para el inglés
    • ES para el español
    • IT para el italiano
    • NL para el neerlandés
    • PL para el polaco
    • PT para el portugués
    • SV para el sueco
    Idioma de generación del mandato

    "locale":"FR"

    sites n8 Identificador de la(s) tienda(s)
    "sites":["11111111", "22222222"]
  4. Añadir el objeto address para transmitir los datos de la dirección del deudor. Algunos bancos verifican la presencia de estas informaciones para aceptar una solicitud de débito. La dirección es obligatoria si el cliente tiene una cuenta bancaria en los siguientes departamentos, territorios o países: Suiza, Mónaco, San Marino, Mayotte, San Pedro y Miquelón, Guernsey, Jersey, Isla de Man.
    Atributo del objeto address Formato Descripción Ejemplo
    city string Ciudad Labège
    country string Código del país según ISO 3166 alpha-2 FR
    district string Barrio Labège-Innopole
    state string Estado / región Occitania
    street string Dirección postal Rue de l’innovation
    street_number string Número de vía 109
    street2 string Segunda línea de dirección Edificio 1
    zip string Código Postal 31670
  5. Si procede, añadir los campos opcionales bic, title,, callback_url, send_mails y fetch_address.
    Nombre del campo Formato Descripción Ejemplo
    bic string BIC para Bank Identifier Code: Identificador internacional del banco del deudor "bic":"CRLYFRPP"
    title string Estado civil del deudor "designación":"Sr."
    callback_url string URL https://.../
    send_mails boolean

    Valor por defecto: False

    Si se valoriza este campo en True, el PDF Lyra Collect enviará las direcciones electrónicas de registro del mandado el comprador y al vendedor al término de una operación de creación o de actualización de un mandato.

     
    fetch_address boolean

    Se utiliza para indicar si el objeto address se envía a cambio de la respuesta del WS.

    Valor por defecto: false.

     

Ejemplo de solicitud cURL:
$ curl 'https://..../multimandates' -H
'Authorization: Basic MTIzNDU2Nzg6MTIzNDU2Nzg5MDEyMzQ1Ng==' -H'
Content-Type:application/json' -H 
'Accept: application/json' 
--data
'{"iban":"FR7630002005701234567890158","title":"M.","last_name":"Durand","first_name":"Michel",
"email":"mdurand@ymail.com","payment_type":"RECURR","locale":"FR","address":{"street_number":"109",
"street":"rue de l'Innovation","street2":"Bat 1","district":"Labège-Innopole","zip":"31670",
"city":"Labège","country":"FR","state":"Occitania"},"fetch_address":false,
"sites":["11111111","22222222","33333333"]}' -i

Respuesta:

HTTP/1.1 200 OK
Date: Wed, 27 Aug 2014 10:41:42 GMT
Content-Type:application/json
Connection: close
Transfer-Encoding:chunked

[
{
	"bic":"CRLYFRPP",
	"iban":"FR7630002005701234567890158",
	"title":"M.",
	"email":"mdurand@ymail.com",
	"locale":"FR",
	"identifier":"FR08ZZZ482829-20140827vzP6s8",
	"rum":"FR08ZZZ482829-20140827vzP6s8",
	"id":"11111111-FR08ZZZ482829-20140827vzP6s8",
	"site":"11111111",
	"first_name":"Michel",
	"last_name":"Durand",
	"payment_type":"RECURR",
	"callback_url":null,
	"created_at":1409136103000,
	"updated_at":null,
	"fetch_adress":"false"
},
{
	"bic":"CRLYFRPP",
	"iban":"FR7630002005701234567890158",
	"title":"M.",
	"email":"mdurand@ymail.com",
	"locale":"FR",
	"identifier":"FR78ZZZ472548-20140827TotVyn",
	"rum":"FR78ZZZ472548-20140827TotVyn",
	"id":"22222222-FR78ZZZ472548-20140827TotVyn",
	"site":"22222222",
	"first_name":"Michel",
	"last_name":"Durand",
	"payment_type":"RECURR",
	"callback_url":null,
	"created_at":1409136105000,
	"updated_at":null,
	"fetch_adress":"false"
},
{
	"bic":"CRLYFRPP",
	"iban":"FR7630002005701234567890158",
	"title":"M.",
	"email":"mdurand@ymail.com",
	"locale":"FR",
	"identifier":"FR78ZZZ472548-20140827iliSfW",
	"rum":"FR78ZZZ472548-20140827iliSfW",
	"id":"33333333-FR78ZZZ472548-20140827iliSfW",
	"site":"33333333",
	"first_name":"Michel",
	"last_name":"Durand",
	"payment_type":"RECURR",
	"callback_url":null,
	"created_at":1409136108000,
	"updated_at":null,
	"fetch_adress":"false"
}
]

Nota

Si por el contrario se produce un fallo al importar un mandato, entonces todos los mandatos estarán en fallo.