Boîtes aux lettres

Les fichiers de lots partent vers les caisses par la messagerie de l’Assurance Maladie, et les accusés de réception et les retours de paiement reviennent par elle. Ophelix envoie et relève pour vous.

Par défaut, un praticien n’a rien à régler : ses fichiers partent par la boîte d’Ophelix, organisme concentrateur technique (route: "oct"). S’il a sa propre boîte aux lettres chez un opérateur de messagerie, réglez-la : ses fichiers partent alors par elle (route: "direct"), et ses retours s’y relèvent (Mailbox, mbx_…).

Droits de clé : practitioners:read pour lire la boîte, practitioners:write pour la régler, la vérifier ou la retirer.

Je veux…

Régler une boîte

{
  "address": "dr.martin@exemple-messagerie.fr",
  "username": "dr.martin",
  "password": "…",
  "smtp": { "host": "smtp.exemple-messagerie.fr", "port": 465, "security": "tls" },
  "retrieval": { "protocol": "imap", "host": "imap.exemple-messagerie.fr", "port": 993, "security": "tls" }
}

• L’envoi passe par SMTP, le relevé par IMAP ou POP3, avec le même identifiant.
• security vaut tls (chiffré dès la connexion) ou starttls. Une boîte en clair est refusée, comme un hôte qui mène à un réseau privé.
• Le secret ne se relit jamais. Pour modifier une boîte sans le changer, omettez password.
• Changer de serveur efface la vérification : appelez verify ensuite. Elle ouvre une session d’envoi et une de relevé, sans rien envoyer ni effacer, puis dit verified_at ou last_error_code.

Cycle d’un fichier

Chaque fichier part avec une demande d’avis de non-remise. Son subject l’identifie sur le réseau : gardez-le pour une recherche avec l’opérateur.

• Serveur muet ou qui demande d’attendre : le fichier reste en file et repart, quatre fois en tout, sur une demi-heure. Un envoi interrompu reprend de lui-même.
• Jamais parti (mailbox_unreachable, authentication_failed, tls_failed, message_too_large, recipient_refused…) : le fichier passe à failed, ses lots repartent dans un nouveau fichier au passage suivant, une fois la boîte reposée un quart d’heure.
• Non remis (delivery_failed) ou refusé par la caisse (service_rejected:<code>) : le fichier repart une fois, à l’identique, sous un nouveau sujet (retransmitted_at). S’il échoue encore, ses lots passent à failed avec failure_code: "undelivered" et demandent une intervention.
• Indisponibilité de la caisse : l’opérateur garde le fichier et le dit (provisional_at). L’accusé viendra plus tard.

Relevé

Les boîtes se relèvent toutes les cinq minutes. Chaque message se reconnaît, puis va à son traitement : un accusé au lot qu’il désigne, un retour de paiement aux factures qu’il règle.

• Un message ne se traite qu’une fois, et ne quitte la boîte qu’une fois traité.
• Un message inconnu, ou d’un autre mode que la boîte, reste dans la boîte et se compte dans set_aside_count. Ophelix ne le lit plus.
• Une boîte injoignable garde son erreur dans last_error_code jusqu’au relevé suivant réussi.

Événements

• transmission.sent : le fichier est parti.
• transmission.failed : il n’est pas arrivé, avec failure_code.
• Puis, pour chaque lot, batch.acknowledged ou batch.failed à l’arrivée de l’accusé.

En mode test

Rien ne part vers une caisse. Le simulateur envoie les fichiers et écrit les accusés que vous déclenchez (Cartes et scénarios de test). Une boîte réglée en mode test ne sert qu’aux lots signés avec de vraies cartes de test.

Pièges

• La boîte reçoit aussi les retours de paiement : ne la relevez pas avec un autre logiciel, qui les prendrait avant Ophelix.
• Une boîte retirée ne relève plus rien : les retours des fichiers qu’elle a envoyés y restent.
• password est le secret de la boîte, jamais celui du compte Ophelix du praticien.