HomeProduitsService API Livraison Massive Messages certifiés

Service API Livraison Massive Messages certifiés

GRATUIT 5 demandes/jour

De: 0,002 € + TVA

Demandes GRATUITES

Envoyez de grandes quantités de messages électroniques certifiés à vos contacts via l'API, en toute conformité avec les réglementations.

Livraison

En 24 heures

Disponible pour
  • eu

L'API Livraison Massive Messages certifiés est la solution idéale pour ceux qui doivent gérer un volume élevé de communications à valeur légale et souhaitent intégrer le service directement dans leur plateforme, logiciel de gestion ou CRM via API.

Elle ne nécessite l’activation d’aucun logiciel et permet l'envoi sécurisé de messages REM en masse, directement via API, conformément à la réglementation AGID.

Le service est souvent utilisé en complément de l’API REM Company, qui permet d'obtenir en temps réel les adresses certifiés de toutes les entreprises italiennes.

L'API Livraison Massive Messages certifiés prévoit un abonnement annuel et un coût de 0,05€ par message. Avec les solutions par abonnement, il est possible d’envoyer jusqu'à 1,2 million de messages certifiés par an, à partir de 0,002€ chacun.

L’extension standard de Livraison Massive Messages certifiés est @pecmassiva.com, mais il est également possible, sur demande, de personnaliser le domaine, en utilisant par exemple le nom de votre entreprise.

VÉRIFIER L'ADRESSE REM

Pour vérifier la disponibilité d'une adresse REM, l'endpoint suivant GET/verifica_pec/{pec} peut être utilisé en passant l'adresse REM souhaitée en paramètre.

EXEMPLE DE RÊQUETE

GET /verifica_pec/{pec}

Voici un exemple de requête de vérification de la disponibilité de l'adresse REM impresa@pecmassiva.com

GET https://pec.openapi.it/verifica_pec/impresa@pecmassiva.com

EXEMPLE DE RÉPONSE

GET/verifica_pec/{pec}

Voici un exemple de réponse indiquant que l'adresse est disponible (avalaible:true):

{
    "data": {
      "available": true
    },
    "success": true,
    "message": "",
    "error": null
  }

REGISTRATION MASSIVE MESSAGES CERTIFIÉS

EXEMPLE DE RÊQUETE

POST/pec

Une fois que la disponibilité de l'email certifié a été vérifiée, l'enregistrement peut être effectué via l'endpoint POST/pec où le corps de la demande comprendra les valeurs suivantes:

  • nom de la boîte
  • type de client (par exemple, PV pour particulier)
  • données personnelles du demandeur (nom et prénom ou dénomination, code fiscal ou numéro de TVA du demandeur, date et lieu de naissance, adresse de résidence ou siège social)

Voici un exemple de Payload utile contenant toutes les données à transmettre.

{
    "casella_pec": "yourpec@pecmassiva.com",
    "tipo_casella": "PECMASSIVA",
    "tipo_cliente": "PV",
    "sottotipo_cliente": "",
    "sottotipo_cliente_altro": "",
    "nome_richiedente": "mario",
    "cognome_richiedente": "rossi",
    "email": "mail@domain.com",
    "telefono": "0548798569",
    "codice_fiscale_richiedente": "RSSXXXXXXXX56E",
    "data_nascita_richiedente": "11/04/1982",
    "sesso_richiedente": "M",
    "nazione_nascita_richiedente": "IT",
    "provincia_nascita_richiedente": "RM",
    "denominazione_titolare": "",
    "cf_piva_titolare": "",
    "indirizzo_titolare": "via verdi 20",
    "comune_titolare": "roma",
    "cap_titolare": "00042",
    "nazione_titolare": "IT",
    "provincia_titolare": "rm",
    "callback": {
      "url": "https://your_domain.it/your_callback.php",
      "field": "data"
    }
}

Lors de la requête, il est également possible d'activer le renouvellement automatique en ajoutant le paramètre optionnel dans le corps du message (il est actuellement «false» par défaut).

EXEMPLE DE RÉPONSE

POST/pec

La réponse contiendra une série d'informations, notamment un résumé des caractéristiques du REM, l'état d'activation et l'ID. L'identifiant sera essentiel pour les prochaines étapes d'activation, pour vérifier l'état et, à l'avenir, pour procéder au renouvellement.

{
  "data": {
    "casella_pec": "yourpec@postamassiva.com",
    "tipo_casella": "PECMASSIVA",
    "tipo_cliente": "PV",
    "sottotipo_cliente": "",
    "sottotipo_cliente_altro": "",
    "nome_richiedente": "mario",
    "cognome_richiedente": "rossi",
    "email": "mail@domain.com",
    "telefono": "0548798569",
    "codice_fiscale_richiedente": "RSSXXXXXXXX56E",
    "data_nascita_richiedente": "11/04/1982",
    "sesso_richiedente": "M",
    "nazione_nascita_richiedente": "IT",
    "provincia_nascita_richiedente": "RM",
    "denominazione_titolare": "",
    "cf_piva_titolare": "",
    "indirizzo_titolare": "via verdi 20",
    "comune_titolare": "roma",
    "cap_titolare": "00042",
    "nazione_titolare": "IT",
    "provincia_titolare": "rm",
    "callback": {
      "url": "https://your_domain.it/your_callback.php",
      "field": "data",
      "method": "POST",
      "data": {}
    },
    "dominio": "postamassiva.com",
    "owner": "mail@domain.com",
    "timestamp": {
      "registrazione": 1614865504,
      "ultima_modifica": 1614868403,
    },
    "cellulare": "",
    "comune_nascita_richiedente": "",
    "cod_attivazione": "10173956",
    "uid": "MA177987",
    "conservazione": false,
    "data_scadenza": "",
    "descrizione": "yourpec@postamassiva.com",
    "sms": false,
    "spazio_conservazione": 0,
    "spazio_disco": 0,
    "spazio_storico": 0,
    "stato": "registrata",
    "storico": false,
    "id": "6040e4613a716838dc4eee0e",
    "autorinnovo": false
  },
  "success": true,
  "message": "",
  "error": null
}

ACTIVATION MASSIVE MESSAGES CERTIFIÉS

EXEMPLE DE RÊQUETE

PATCH/pec/{id}/attivazione

Pour compléter l'activation, il sera nécessaire de télécharger le formulaire requis (GET /pec/{id}/modulo_activazione ) et d'envoyer le formulaire, correctement rempli et signé, ainsi que l'identifiant du demandeur via l'endpoint PATCH/pec/{id}/attivazione.L'identifiant est celui obtenu dans la réponse précédente.

EXEMPLE DE RÉPONSE

PATCH/pec/{id}/attivazione

La réponse sera la suivante:

{
  "data": {
    "casella_pec": "yourpec@pecamassiva.com",
    "tipo_casella": "PECMASSIVA",
    "tipo_cliente": "PV",
    "sottotipo_cliente": "",
    "sottotipo_cliente_altro": "",
    "nome_richiedente": "mario",
    "cognome_richiedente": "rossi",
    "email": "mail@domain.com",
    "telefono": "0548798569",
    "codice_fiscale_richiedente": "RSSXXXXXXXX56E",
    "data_nascita_richiedente": "11/04/1982",
    "sesso_richiedente": "M",
    "nazione_nascita_richiedente": "IT",
    "provincia_nascita_richiedente": "RM",
    "denominazione_titolare": "",
    "cf_piva_titolare": "",
    "indirizzo_titolare": "via verdi 20",
    "comune_titolare": "roma",
    "cap_titolare": "00042",
    "nazione_titolare": "IT",
    "provincia_titolare": "rm",
    "callback": {
      "url": "https://your_domain.it/your_callback.php",
      "field": "data",
      "method": "POST",
      "data": {}
    },
    "dominio": "postamassiva.com",
    "owner": "mail@domain.com",
    "timestamp": {
      "registrazione": 1614865504,
      "ultima_modifica": 1614868403,
    },
    "cellulare": "",
    "comune_nascita_richiedente": "",
    "cod_attivazione": "10173956",
    "uid": "MA177987",
    "conservazione": false,
    "data_scadenza": "",
    "descrizione": "yourpec@testcert.legalmail.it",
    "sms": false,
    "spazio_conservazione": 0,
    "spazio_disco": 1024,
    "spazio_storico": 1024,
    "stato": "in_evasione",
    "storico": false,
    "documenti_attivazione": [
      "6040e4613a716838dc4eee0e_0_attivazione.pdf",
      "6040e4613a716838dc4eee0e_1_attivazione.pdf"
    ],
    "id": "6040e4613a716838dc4eee0e",
    "autorinnovo": false
  },
  "success": true,
  "message": "",
  "error": null
}

VÉRIFIER L'ÉTAT MASSIVE MESSAGES CERTIFIÉS

Il sera possible de vérifier le statut de la REM enregistré à tout moment via l'endpoint GET/pec/{id} .

EXEMPLE DE RÊQUETE

GET/pec/{id}

La requête pour vérifier le statut de l'email certifié précédent activé avec 6040e4613a716838dc4eee0e sera

GET https://pec.openapi.it/pec/6040e4613a716838dc4eee0e

EXEMPLE DE RÉPONSE

GET /pec/{id}

Voici un exemple de réponse dans laquelle la boîte est en statut enregistré:

{
  "data": {
    "casella_pec": "yourpec@pecmassiva.com",
    "tipo_casella": "PECMASSIVA",
    "tipo_cliente": "PV",
    "sottotipo_cliente": "",
    "sottotipo_cliente_altro": "",
    "nome_richiedente": "mario",
    "cognome_richiedente": "rossi",
    "email": "mail@domain.com",
    "telefono": "0548798569",
    "codice_fiscale_richiedente": "RSSXXXXXXXX56E",
    "data_nascita_richiedente": "11/04/1982",
    "sesso_richiedente": "M",
    "nazione_nascita_richiedente": "IT",
    "provincia_nascita_richiedente": "RM",
    "denominazione_titolare": "",
    "cf_piva_titolare": "",
    "indirizzo_titolare": "via verdi 20",
    "comune_titolare": "roma",
    "cap_titolare": "00042",
    "nazione_titolare": "IT",
    "provincia_titolare": "rm",
    "callback": {
      "url": "https://your_domain.it/your_callback.php",
      "field": "data",
      "method": "POST",
      "data": {}
    },
    "dominio": "postamassiva.com",
    "owner": "mail@domain.com",
    "timestamp": {
      "registrazione": 1614865504,
      "ultima_modifica": 1614868403,
      "evasione": 1614865504,
      "scadenza": 1614868403,
      "revoca": ,
    },
    "cellulare": "",
    "comune_nascita_richiedente": "",
    "cod_attivazione": "10173956",
    "uid": "MA177987",
    "conservazione": false,
    "data_scadenza": "",
    "descrizione": "yourpec@pecmassiva.com",
    "sms": false,
    "spazio_conservazione": 0,
    "spazio_disco": 1024,
    "spazio_storico": 1024,
    "stato": "registrata",
    "storico": true,
    "documenti_attivazione": [
    "6040e4613a716838dc4eee0e_0_attivazione.pdf",
    "6040e4613a716838dc4eee0e_1_attivazione.pdf"
    ],
    "data_attivazione": "04/03/2021",    
    "id": "6040e4613a716838dc4eee0e",
    "autorinnovo": false
  },
  "success": true,
  "message": "",
  "error": null
}

VEUILLEZ NOTER: Actuellement, la vérification n'est possible que pour les clients qui ont activé le service Livraison Massive Messages certifiés via API et non via www.pecmassiva.com.

Alors qu'il est nécessaire d'utiliser l'API REM (https://pec.openapi.it) pour enregistrer et activer le Massive Message certifié, la gestion du REM, telle que l'envoi de messages et la vérification des envois, est confiée à une autre API, l'API Livraison Massive Messages certifiés (https://ws.pecmassiva.com)

ENVOI DE MESSAGES REM

EXEMPLE DE RÊQUETE

POST/send

Grâce au service API Livraison Massive Messages certifiés, des messages REM peuvent être envoyés à un ou plusieurs destinataires avec l'ajout de pièces jointes.

{
  "sender": "dev-api@pecmassiva.com",
  "recipient": "dev-api@pecmassiva.com",
  "subject": "Invio di prova pec massiva",
  "body": "Salve, questa rappresenta una prova di invio, che prevede un corpo in html",
  "attachments": [
    {
      "name": "allegato1.png",
      "file": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADIAAAAyCAYAAAAeP4ixAAAAGX="
    }
  ],
  "username": "your_pec_username",
  "password": "your_pec_password"
}

Dans le cas de plusieurs destinataires, il s'agira d'un array de destinataires.

EXEMPLE DE RÉPONSE

POST/send

La réponse d'envoi est un code d'identification d'envoi qui peut être utilisé pour renvoyer des informations d'accusé de réception et de livraison par courrier électronique.

{
  "success": true,
  "sent": 1,
  "message": "",
  "message_id": "2020082610003492"
}

LA LISTE D'ACQUISITION DES MESSAGES ENVOYÉS

GET/inbox

Grâce à GET/inbox, il est possible d'obtenir la liste de tous les courriels présents dans l'inbox.

{
 "data":[
   {
    "sender": "dev-api@pecmassiva.com",
    "recipient": "dev-api@pecmassiva.com",
    "date": "Wed, 26 Aug 2020 10:00:35 +0200",
    "object": "ACCETTAZIONE: Invio di prova pec massiva 2020082610003492",
    "id": 1
   },
   {
    "sender": "\"Per conto di: dev-api@pecmassiva.com\" ",
    "recipient": "dev-api@pecmassiva.com",
    "date": "Wed, 26 Aug 2020 10:00:35 +0200",
    "object": "POSTA CERTIFICATA: Invio di prova pec massiva 2020082610003492",
    "id": 2
   },
   {
    "sender": "posta-certificata@pecmassiva.com",
    "recipient": "dev-api@pecmassiva.com",
    "date": "Wed, 26 Aug 2020 10:00:36 +0200",
    "object": "CONSEGNA: Invio di prova pec massiva 2020082610003492",
    "id": 3
  },
 ],
 "success": true,
  "message": "",
  "total": 981,
  "page": 39,
  "n_of_pages": 39
 }

VÉRIFICATION DE L'UTILISATION DU REM

EXEMPLE DE RÊQUETE

GET/quota/{mailbox}

À tout moment, il sera possible de vérifier le quota et la limite d'utilisation du REM via GET /quota/{mailbox} . Les paramètres requis pour effectuer la demande sont: le nom d'utilisateur et le mot de passe.

EXEMPLE DE RÉPONSE

GET /quota/{mailbox}

La réponse indiquera l'utilisation (usage) et la taille totale (limit) de l'Inbox. Les données sont exprimées en megabyte.

{
    "data": {
    "usage": 171012,
    "limit": 1048576
    },
    "success": true,
    "message": "",
  }

Le service API Livraison Massive Messages certifiés est utilisé par un certain nombre d'entreprises, publiques et privées, issues de secteurs totalement différents: énergie, recouvrement de crédits, services environnementaux, marketing, consortiums, institutions de paiement, bureaux d'appels d'offres et de passation de marchés, industries.

Inscription

Avez-vous besoin d'aide ?

Vous n'avez pas trouvé la réponse que vous cherchiez?

Remplissez tous les détails, nous vous contacterons dès que possible!

Questions fréquemment posées

"Livraison Massive Messages certifiés" est le service qui vous permet d'envoyer - via API - des messages REM légalement valides (avec d'éventuelles pièces jointes), de manière massive et sécurisée.

Il ne nécessite l'activation d'aucun logiciel et permet de gérer un grand nombre de communications conformément à la réglementation AGID, à un coût très compétitif et avec la possibilité de demander un abonnement annuel pour économiser sur les postes individuels.

Qu'est-ce que le service API Livraison Massive Messages certifiés?

Oui, "Livraison Massive Messages certifiés" a pour extension de départ @pecmassiva.com, mais - sur demande - il est également possible de personnaliser le domaine, par exemple en choisissant le nom de votre entreprise.

Est-il possible de personnaliser le domaine du Service API Livraison Massive Messages certifiés?

Oui, le service API Livraison Massive Messages certifiés permet de joindre des fichiers et des documents avant l'envoi.

Est-il possible d'inclure des pièces jointes dans les communications certifiées?

Oui, elle a une pleine validité légale (conformément à la réglementation AGID) et a la même valeur qu'une lettre recommandée avec accusé de réception. Cela en fait un outil efficace et sécurisé pour les communications officielles, telles que les notifications, les contrats ou les correspondances formelles d'entreprise.

Les messages envoyés via votre boîte REM (Courrier Électronique Certifié) garantissent:

  • Certitude de la livraison: une confirmation de l'envoi et de la réception du message est fournie
  • Intégrité du contenu: il est garanti que le contenu n'a pas été altéré pendant la transmission
  • Validité temporelle: la date et l'heure de l'envoi et de la réception du message sont certifiées
L'API Livraison Massive Messages certifiés a-t-elle une validité légale?

Le service API Livraison Massive Messages certifiés est destinée aux entreprises et organisations qui ont besoin de gérer un grand volume de communications légalement valides et traçables, telles que des documents officiels et des contrats. L'intégration via API est la solution idéale dans ces cas, car le processus est automatique, rapide et efficace. En éliminant l'intervention manuelle, le risque d'erreurs est minimisé.

À qui est destinée le Service API Livraison Massive Messages certifiés?

Le service est fourni sous 24 heures.

Quels sont les délais d'exécution du service?

La redevance annuelle est de 99€.

En plus de cette redevance, le service API "Livraison Massive Messages certifiés" est facturé à partir de 0,05€ par envoi individuel.

Un abonnement annuel est également disponible, qui vous permet d'envoyer jusqu'à 1,2 million de messages certifiés par an, à partir de 0,002€.

Quels sont les coûts du service API Livraison Massive Messages certifiés?