Aller au contenu

Réception entre instances

Les trois endpoints suivants reçoivent le même format de corps. Ils sont appelés par une instance Maarch Courrier distante.

Corps commun

{
  "base64": "UEsDBBQAAAA...",
  "extension": "zip",
  "size": 123456,
  "type": "ArchiveTransfer"
}
Nom Type Obligatoire Description
base64 string Oui Contenu du fichier SEDA encodé en base64.
extension string Oui Extension du fichier transmis, en général zip.
size integer Oui Taille attendue du fichier.
type string Oui Type SEDA du message transmis.

Recevoir un pli numérique

POST /rest/saveNumericPackage

Type attendu

ArchiveTransfer

Traitement

  • Crée le fichier temporaire à partir du base64.
  • Extrait et valide le paquet SEDA.
  • Envoie un accusé technique.
  • Crée ou sélectionne le contact émetteur.
  • Crée le courrier principal, sauf dans le cas d'un retour déjà lié à un courrier existant.
  • Enregistre les notes et les pièces jointes.
  • Envoie une réponse de traitement.

Réponse 200

{
  "resId": 42,
  "basketRedirection": "index.php#..."
}

Recevoir un accusé ou une réponse

POST /rest/saveMessageExchangeReturn

Types attendus

  • Acknowledgement
  • ArchiveTransferReply

Traitement

  • Pour Acknowledgement, retrouve le message par MessageReceivedIdentifier.value et met à jour la date de réception.
  • Pour ArchiveTransferReply, retrouve le message par MessageRequestIdentifier.value.
  • Sauvegarde le message associé à l'échange initial.

Réponse 200

{
  "messageId": "MC_20260702_000001"
}

Recevoir une notification de suivi

POST /rest/saveMessageExchangeReview

Type attendu

ArchiveModificationNotification

Traitement

  • Retrouve le message par UnitIdentifier.value.
  • Met à jour la date d'opération si elle n'est pas déjà renseignée.
  • Sauvegarde la notification comme message associé à l'échange.

Réponse 200

{
  "messageId": "MC_20260702_000002"
}