SWS_RecupererFichiersVirementsChiffres
  • 12 Feb 2023
  • 3 Minutes à lire
  • Sombre
    Lumière
  • PDF

SWS_RecupererFichiersVirementsChiffres

  • Sombre
    Lumière
  • PDF

Résumé de l’article

Fonction API

SWS_RecupererFichiersVirementsChiffres

Description

Permet de générer les fichiers de virements pour les salariés identifiés en paramètre de la requête et de renvoyer ces fichiers chiffrés.
Plusieurs fichiers sont générés via l'appel à cette fonction :

  • Le fichier de virement pour les salariés concernés.
  • Les fichiers qui correpondent aux états de paiement qui accompagnent les fichiers de virement lors de la génération.
    Il est possible que des virements aient déjà été réalisés sur la période. Dans ce cas la méthode ne va utiliser que les matricules pour lesquel il est possible de générer des virements. Ces matricules seront contenus dans la propriété MatriculesInclus. Tous les matricules non inclus dans les fichiers de virements seront contenus dans la propriété MatriculeExclus.
    Cette fonction produit des résultats uniquement lorsque la génération des fichiers est bloquée dans la section « Configuration API » de la « Gestion Interne ».

Groupe de fonctions API

Code API : N11 / PAI002

Paramètres de la requête

ParamètreTypeDescription
Tokenstring

Token d'authentification renvoyé en réponse à l'authentification via SWS_SiteLogin

NumeroDossierstring

Numéro du dossier concerné par la requête

MatriculeSalariesstring[]Liste des matricules des salariés à inclure dans les fichiers de virements. Cette liste peut être vide. La fonction utilisera alors tous les salariés ayant un bulletin sur la période.
PeriodedateTimePériode de génération des fichiers de virements. Ce paramètre est obligatoire.
DateValeurdateTimeDate de valeur du virement
LibelleVirementstringLibellé du virement. Ce paramètre peut être vide. Dans ce cas la fonction utilise le libellé de la précédente génération des fichiers de virements.
Complément sur LibelleVirement
La longueur du libellé pour les virements est de :
  • 31 caractères pour la norme ETEBAC
  • 140 caractères pour la norme SEPA
Vous disposez de variables pour créer votre libellé :
  • %PERIODE : la période du bulletin correspondant au virement (ex: 01-2013)
  • %PERIODEL : la période du bulletin correspondant au virement en minuscules (ex: janvier 2013)
  • %PERIODELM : la période du bulletin correspondant au virement en majuscules (ex: JANVIER 2013)
  • %ETABLISSEMENT : la raison sociale de l'établissement sur lequel le bulletin a été fait
  • %MATRICULE : le matricule du salarié concerné par le virement
ProprietesChiffrementProprietesChiffrementÉlément structuré contenant les propriétés de chiffrement avec lesquelles les fichiers serotn chiffrés (cf. Détail ci-dessous)

ProprietesChiffrement

ParamètreTypeDescription
ClestringClé publique à utiliser pour le chiffrement. Ce paramètre accepte le format binaire encodé en base64 ou le format texte commençant par la ligne "-----BEGIN PGP PUBLIC KEY BLOCK-----"
AlgorithmeSymetriquestringAlgorithme symétrique qui sera utilisé par la fonction pour chiffrer le contenu des fichiers générés. Les valeurs possibles sont : AES128, AES192, AES256 (recommandé)

Paramètres de la réponse

ParamètreTypeDescription
SWS_RecupererFichiersVirementsChiffresResultSWS_RecupererFichiersVirementsChiffresResult

Élément structuré contenant la réponse à la requête (Détail ci-dessous)

SWS_RecupererFichiersVirementsChiffresResult

ParamètreTypeDescription
Errorstring

Vide s'il n'y a pas d'erreur, sinon contient la description de l'erreur rencontrée

Arr_FichiersVirementsChiffresCPAISWSReponseRecupererFichierVirement[]Liste d'éléments structurés contenant les fichiers générés (cf. détail ci-dessous). Alimenté si la requête a été exécutée avec succès
BilanMatriculesBilanMatriculesÉlément structuré contenant les informations des matricules pour lesquels les fichiers ont été générés (cf. détail ci-dessous). Alimenté si la requête a été exécutée avec succès

CPAISWSReponseRecupererFichierVirement

ParamètreTypeDescription
FichierstringNom du fichier
Contenubase64BinaryFichier chiffré en fonction des paramètres de la requête et encodé en base64

BilanMatricules

ParamètreTypeDescription
MatriculesInclusstring[]Liste des matricules pour lesquels les fichiers ont été générés
MatriculesExclusstring[]Liste des matricules pour lesquels les fichiers n'ont pas été généres (par exemple si le fichier de virement a déjà été généré pour ces salariés)

Requête

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <SWS_RecupererFichiersVirementsChiffres xmlns="http://www.silae.fr/">
      <Token>string</Token>
      <NumeroDossier>string</NumeroDossier>
      <MatriculeSalaries>
        <string>string</string>
        <string>string</string>
      </MatriculeSalaries>
      <Periode>yyyy-mm-ddThh:mm:ss</Periode>
      <DateValeur>yyyy-mm-ddThh:mm:ss</DateValeur>
      <LibelleVirement>string</LibelleVirement>
      <ProprietesChiffrement>
        <Cle>string</Cle>
        <AlgorithmeSymetrique>string</AlgorithmeSymetrique>
      </ProprietesChiffrement>
    </SWS_RecupererFichiersVirementsChiffres>
  </soap12:Body>
</soap12:Envelope>

Réponse

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <SWS_RecupererFichiersVirementsChiffresResponse xmlns="http://www.silae.fr/">
      <SWS_RecupererFichiersVirementsChiffresResult>
        <Error>string</Error>
        <Arr_FichiersVirementsChiffres>
          <CPAISWSReponseRecupererFichierVirement>
            <Fichier>string</Fichier>
            <Contenu>base64Binary</Contenu>
          </CPAISWSReponseRecupererFichierVirement>
          <CPAISWSReponseRecupererFichierVirement>
            <Fichier>string</Fichier>
            <Contenu>base64Binary</Contenu>
          </CPAISWSReponseRecupererFichierVirement>
        </Arr_FichiersVirementsChiffres>
        <BilanMatricules>
          <MatriculesInclus>
            <string>string</string>
            <string>string</string>
          </MatriculesInclus>
          <MatriculesExclus>
            <string>string</string>
            <string>string</string>
          </MatriculesExclus>
        </BilanMatricules>
      </SWS_RecupererFichiersVirementsChiffresResult>
    </SWS_RecupererFichiersVirementsChiffresResponse>
  </soap12:Body>
</soap12:Envelope>

Cet article vous a-t-il été utile ?

What's Next
Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.