openapi: 3.0.1
info:
  contact: {}
  license:
    name: Apache 2.0 License
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  title: 'La Poste SlsInternalService : Services destinés aux applications internes SlsServiceWS : documentation API'
servers:
- url: http://api-etiquetage.colis.intra.laposte.fr/sls-ws/SlsServiceRest
tags:
- name: 'SlsServiceWS : documentation'
paths:
  /checkGenerateLabel:
    post:
      tags:
      - 'SlsServiceWS : documentation'
      summary: checkGenerateLabel
      description: <lang><en>Data control without label generation</en><fr>Contrôle des données sans génération d'étiquette</fr></lang>
      operationId: checkGenerateLabel_1
      parameters:
      - name: apiKey
        in: header
        description: <lang><en>apiKey </en><fr>L'apiKey </fr></lang>
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CheckGenerateLabelRequest'
      responses:
        '200':
          description: Traitement OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenerateLabelV2Response'
        '400':
          description: <lang><en>Functional error</en><fr>Erreur fonctionnel</fr></lang>
        '403':
          description: <lang><en>Token KO or Unauthorized access. (sid non-existent or customer account inactive or customer terminated)</en><fr>Token KO ou Acc&egrave;s non autoris&eacute;. (sid inexistant ou compte client inactif ou client r&eacute;sili&eacute;)</fr></lang>
        '500':
          description: <lang><en>Technical error or server error</en><fr>Erreur Technique ou erreur serveur</fr></lang>
        '422':
          description: <lang><en>The JSON input to the service is badly formatted</en><fr>Le JSON en entrée du service est mal formatté</fr></lang>
  /generateLabel:
    post:
      tags:
      - 'SlsServiceWS : documentation'
      summary: generateLabel
      description: '<lang><en>This method is provided to create shipments in relation to the following solutions, regardless of the product or associated destination:<br/><br/>Offre France: Colissimo Domicile, Point Retrait, Retour,<br/>Offre Internationale: Colissimo Expert, Domicile, Point Retrait, Retour,<br/>Offre Outre-Mer: Colissimo Domicile and Colissimo Eco.<br/><br/><br/>The products currently concerned are listed in the paragraph <b>III. 1 Products available.</b> La Poste - Colissimo may modify this list.<br/><br/>Important: it is preferable not to send an optional field when it is blank.</en><fr>Cette méthode est proposée pour créer les expéditions relevant des offres suivantes, quels que soient le produit ou la destination associés :<ul><li>Offre France : Colissimo Domicile, Point Retrait, Retour,</li><li>Offre Internationale : Colissimo Expert, Domicile, Point Retrait, Retour,</li><li>Offre Outre-Mer : Colissimo Domicile et Colissimo Eco.</li></ul><b>Remarque</b> : il est recommandé de ne pas envoyer un champ facultatif plutôt que de l’envoyer vide. <br/><br/><hr /> Fonction principale d''affranchissement : <br/> Gén&egrave;re une annonce informatique du colis et ses documents associés(étiquette et déclarations douani&egrave;res)<br/><b>Réponse:</b> <br/>Ce service retourne une Map contenant un objet json et 0 à 3 tableaux d''octets. <br />La Map retournée est un objet MultipartBody. <br/>L''objet json est sauvegardé avec la clé "jsonInfos" et est de type "application-json". <br/>Les trois tableaux d''octets sont chacun sauvegardé avec les clés : <i>proforma, label et cn23</i>, et sont de type "application/octet-stream".<br /><hr /><b>Exemple de client en cxf :</b> <br/><br/><i>WebClient client = WebClient.create(URL);<br/>client.type("application/json").accept("multipart/mixed");<br/>MultipartBody bodyResponse = client.post(ObjetJsonRequete, MultipartBody.class);<br /><br/>A ce niveau, chaque objet sauvegardé dans la Map MultipartBody est récupéré grace &agrave sa clé.<br/>Pour le tableau d''octets "label", on utilise le code ci-dessous: <br/><br/>DataHandler dataHandler = bodyResponse.getAttachment("label").getDataHandler();<br/>InputStream is = dataHandler.getInputStream(); </i><hr/>L''objet jsonInfos a le format ci-dessous: <br/>{<br/>&nbsp;&nbsp;"messages":Array[Message],<br/>&nbsp;&nbsp;"parcelNumber":String,<br/>&nbsp;&nbsp;"parcelNumberPartner":String<br/>}<br/><br/>Message<br/>{<br/>&nbsp;&nbsp;"id":String,<br/>&nbsp;&nbsp;"type":String,<br/>&nbsp;&nbsp;"messageContent":String<br/>}</fr></lang>'
      operationId: generateLabel_1
      parameters:
      - name: apiKey
        in: header
        description: <lang><en>apiKey </en><fr>L'apiKey </fr></lang>
        schema:
          type: string
      requestBody:
        description: numéro de contrat
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GenerateLabelRequestV31'
      responses:
        '200':
          description: Traitement OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenerateLabelV2Response'
        '400':
          description: <lang><en>Functional error</en><fr>Erreur fonctionnel</fr></lang>
        '403':
          description: <lang><en>Token KO or Unauthorized access. (sid non-existent or customer account inactive or customer terminated)</en><fr>Token KO ou Acc&egrave;s non autoris&eacute;. (sid inexistant ou compte client inactif ou client r&eacute;sili&eacute;)</fr></lang>
        '500':
          description: <lang><en>Technical error or server error</en><fr>Erreur Technique ou erreur serveur</fr></lang>
        '422':
          description: <lang><en>The JSON input to the service is badly formatted</en><fr>Le JSON en entrée du service est mal formatté</fr></lang>
  /generateCN23:
    post:
      tags:
      - 'SlsServiceWS : documentation'
      summary: generateCN23
      description: <lang><fr>Méthode permettant de générer le document douanier CN23</fr><en>Method for generating the CN23 customs document</en></lang>
      operationId: generateCN23_1
      parameters:
      - name: apiKey
        in: header
        description: <lang><en>apiKey </en><fr>L'apiKey </fr></lang>
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GenerateCN23Request'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
  /getListMailBoxPickingDates:
    post:
      tags:
      - 'SlsServiceWS : documentation'
      summary: getListMailBoxPickingDates
      description: <lang><en>The method <b>getListMailBoxPickingDates()</b> indicates whether an address is eligible for shipment from a mailbox and, if so, what the date and time are of the  <br/>parcel pick-up from this address. <br/><br/>This method will be used to validate the eligibility of the geographic address for a pick-up from a mailbox the next day, which then makes it possible to enter the pick-up date in the tag mailBoxPickingDate in the block Service when the subsequent shipping announcement is issued using the method GenerateLabel.</en><fr>La méthode <b>getListMailBoxPickingDates()</b> permet de savoir si une adresse est éligible à un dépôt de colis retour en boîte aux lettres et de connaître la date et heure du prochain emport de colis à cette adresse. <br/><br/> Cette méthode sera utilisée pour valider l’éligibilité de l’adresse géographique pour un emport en boîte aux lettres le lendemain, ce qui permettra ensuite de renseigner cette date d’emport dans la balise mailBoxPickingDate du Bloc Service lors de l’annonce ultérieure de l’expédition au moyen de la méthode GenerateLabel.</fr></lang>
      operationId: getListMailBoxPickingDates_2
      parameters:
      - name: apiKey
        in: header
        description: <lang><en>apiKey </en><fr>L'apiKey </fr></lang>
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetListMailBoxPickingDatesRetourRequest'
      responses:
        '200':
          description: Traitement OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetListMailBoxPickingDatesResponse'
  /getLabel:
    post:
      tags:
      - 'SlsServiceWS : documentation'
      summary: getLabel
      operationId: getLabel_1
      parameters:
      - name: login
        in: header
        description: <i>AN</i> <br/>  <lang><en>Deprecated. Use apikey instead as explained in "Acess to the Web Service SLS/API Authentication".</en><fr>Obsolète. Utiliser l'apikey à la place comme expliqué dans "Accès au Web Service SLS/Authentification API".</fr></lang>
        schema:
          type: string
      - name: password
        in: header
        description: <i>AN</i> <br/>  <lang><en>Deprecated. Use apikey instead as explained in "Acess to the Web Service SLS/API Authentication".</en><fr>Obsolète. Utiliser l'apikey à la place comme expliqué dans "Accès au Web Service SLS/Authentification API".</fr></lang>
        schema:
          type: string
      - name: apiKey
        in: header
        description: <lang><en>apiKey </en><fr>L'apiKey </fr></lang>
        schema:
          type: string
      - name: accountNumber
        in: header
        description: <i>N6</i> <br/> <lang><en>accountNumber</en><fr>accountNumber</fr></lang>
        schema:
          type: string
      requestBody:
        description: getLabelRequest
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetLabelRequest'
        required: true
      responses:
        '200':
          description: Traitement OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
  /generateBordereauByParcelsNumbers:
    post:
      tags:
      - 'SlsServiceWS : documentation'
      summary: generateBordereauByParcelsNumbers
      description: '<lang><fr>Remarque : les colis dans le document doivent tous avoir été généré par le même compte. Si nécessaire, il est possible de faire autant d''appels au service que de compte.</fr><en>Note: the packages in the document must all have been generated by the same account. If necessary, it is possible to make multiple calls as there are accounts.</en></lang>'
      operationId: generateBordereauByParcelsNumbers_1
      parameters:
      - name: apiKey
        in: header
        description: <lang><en>apiKey </en><fr>L'apiKey </fr></lang>
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GenerateBordereauByParcelsNumbersRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
  /generateToken:
    post:
      tags:
      - 'SlsServiceWS : documentation'
      summary: generateToken
      description: <lang><en>This method generates a token and associated documents if the customer wishes to secure the printing of these return labels. <br/><br/> The token and documents will enable customers to re-print a label at a post office or pick points.</en><fr></fr></lang>
      operationId: generateToken_1
      parameters:
      - name: apiKey
        in: header
        description: <lang><en>apiKey </en><fr>L'apiKey </fr></lang>
        schema:
          type: string
      requestBody:
        description: numéro de contrat
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GenerateLabelRequest'
      responses:
        '200':
          description: Traitement OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        '400':
          description: <lang><en>Functional error</en><fr>Erreur fonctionnel</fr></lang>
        '403':
          description: <lang><en>Token KO or Unauthorized access. (sid non-existent or customer account inactive or customer terminated)</en><fr>Token KO ou Acc&egrave;s non autoris&eacute;. (sid inexistant ou compte client inactif ou client r&eacute;sili&eacute;)</fr></lang>
        '500':
          description: <lang><en>Technical error or server error</en><fr>Erreur Technique ou erreur serveur</fr></lang>
        '422':
          description: <lang><en>The JSON input to the service is badly formatted</en><fr>Le JSON en entrée du service est mal formatté</fr></lang>
  /getProductInter:
    post:
      tags:
      - 'SlsServiceWS : documentation'
      summary: getProductInter
      description: '<lang><en>This function, exclusively dedicated to international shipments, provides the return options compatible with the requested destination (e.g. <b>"paid return", "do not return"</b>). <br/><br/> The return option entered is transmitted to our international partners to indicate what action is required if the parcel cannot be delivered to the addressee </en><fr>Cette fonction, dédiée exclusivement aux envois internationaux, fournit les options de retour compatibles avec la destination demandée (par exemple : <b>« retour payant », « ne pas retourner »</b>).<br/><br/>L’option de retour saisie est transmise à nos partenaires internationaux afin de leur indiquer l’action à réaliser dans le cas où le colis ne pourrait être remis à son destinataire</fr></lang>'
      operationId: getProductInter_1
      parameters:
      - name: apiKey
        in: header
        description: <lang><en>apiKey </en><fr>L'apiKey </fr></lang>
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetProductInterRequest'
      responses:
        '200':
          description: Traitement OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetProductInterResponse'
        '400':
          description: <lang><en>Functional error</en><fr>Erreur fonctionnel</fr></lang>
        '403':
          description: <lang><en>Token KO or Unauthorized access. (sid non-existent or customer account inactive or customer terminated)</en><fr>Token KO ou Acc&egrave;s non autoris&eacute;. (sid inexistant ou compte client inactif ou client r&eacute;sili&eacute;)</fr></lang>
        '500':
          description: <lang><en>Technical error or server error</en><fr>Erreur Technique ou erreur serveur</fr></lang>
        '422':
          description: <lang><en>The JSON input to the service is badly formatted</en><fr>Le JSON en entrée du service est mal formatté</fr></lang>
  /planPickup:
    post:
      tags:
      - 'SlsServiceWS : documentation'
      summary: planPickup
      description: <lang><en>The method <b>planPickup ()</b> allows you to make a request for picking up a return parcel deposited by the sender in their mailbox. The parcel needs to have been previously announced with La Poste. This method will be used to confirm firmly the pick-up on the chosen date, after first announcing the shipment by means of the method GenerateLabel. This method is compatible with product code CORE (8R Colissimo Retour France) and CORF (CQ Colissimo Retour International)</en><fr>La méthode <b>planPickup()</b> permet de faire une demande d’emport d’un colis retour déposé par l’expéditeur dans sa boîte aux lettres.<br/> Le colis doit avoir été préalablement annoncé auprès de La Poste. <br/> Cette méthode sera utilisée pour confirmer de manière ferme l’emport à la date voulue, après avoir annoncé en premier lieu l’expédition au moyen de la méthode GenerateLabel. <br/> Cette méthode est compatible avec le code produit CORE (8R Colissimo Retour France) et CORF (CQ Colissimo Retour International)</fr></lang>
      operationId: planPickup_2
      parameters:
      - name: apiKey
        in: header
        description: <lang><en>apiKey </en><fr>L'apiKey </fr></lang>
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PlanPickupRequest'
      responses:
        '200':
          description: Traitement OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlanPickupResponse'
components:
  schemas:
    Routing:
      type: object
      properties:
        destinationCountry:
          type: string
        serviceText:
          type: string
        depotDest:
          type: string
        serviceMark:
          type: string
        sortOrigin:
          type: string
        groupingPriorityLabel:
          type: string
        sortDest:
          type: string
        barcodeId:
          type: string
        routingVersion:
          type: string
        destinationCountryText:
          type: string
        partnerType:
          type: string
        barcodePostcode:
          type: string
        buAlphaStr:
          type: string
        buCode:
          type: string
        getcSort:
          type: string
        destinationDepot:
          type: string
        destinationDepotCountry:
          type: string
        destinationDepotStr:
          type: string
        getdSort:
          type: string
        groupingPriority:
          type: string
        networkCode:
          type: string
        getoSort:
          type: string
        partnerCode:
          type: string
        getsSort:
          type: string
        version:
          type: string
        getdCountry:
          type: string
        getdDepotCountry:
          type: string
        getdDepot:
          type: string
        getdDepotStr:
          type: string
    CodeVAS:
      type: object
      properties:
        mention:
          type: string
        deliveryMode:
          type: string
        reserve:
          type: string
        signature:
          type: string
    PlanPickupResponse:
      type: object
      properties:
        messages:
          type: array
          items:
            $ref: '#/components/schemas/Message'
    SwissLabel:
      type: object
      properties:
        injectionSite:
          type: string
        signatureOption:
          type: boolean
        codeSwissPost:
          type: string
        swissParcelNumber:
          type: string
    Response:
      type: object
      properties:
        mediaType:
          $ref: '#/components/schemas/MediaType'
        status:
          type: integer
          format: int32
        cookies:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/NewCookie'
        length:
          type: integer
          format: int32
        location:
          type: string
          format: uri
        language:
          type: object
          properties:
            language:
              type: string
            displayName:
              type: string
            country:
              type: string
            variant:
              type: string
            script:
              type: string
            unicodeLocaleAttributes:
              uniqueItems: true
              type: array
              items:
                type: string
            unicodeLocaleKeys:
              uniqueItems: true
              type: array
              items:
                type: string
            displayLanguage:
              type: string
            displayScript:
              type: string
            displayCountry:
              type: string
            displayVariant:
              type: string
            extensionKeys:
              uniqueItems: true
              type: array
              items:
                type: string
            iso3Language:
              type: string
            iso3Country:
              type: string
        date:
          type: string
          format: date-time
        lastModified:
          type: string
          format: date-time
        closed:
          type: boolean
        metadata:
          type: object
          properties:
            empty:
              type: boolean
          additionalProperties:
            type: array
            items:
              type: object
        allowedMethods:
          uniqueItems: true
          type: array
          items:
            type: string
        statusInfo:
          $ref: '#/components/schemas/StatusType'
        links:
          uniqueItems: true
          type: array
          items:
            $ref: '#/components/schemas/Link'
        entityTag:
          $ref: '#/components/schemas/EntityTag'
        stringHeaders:
          type: object
          properties:
            empty:
              type: boolean
          additionalProperties:
            type: array
            items:
              type: string
        headers:
          type: object
          properties:
            empty:
              type: boolean
          additionalProperties:
            type: array
            items:
              type: object
        entity:
          type: object
    Addressee:
      required:
      - address
      type: object
      properties:
        addresseeParcelRef:
          type: string
          description: <i>AN1...15</i> <br/>  <lang><en>Recipient order reference.<br/><b>It allows the destination reference to be displayed only on the label. This data is not reflected in the Colissimo IT System and will not be visible in OSC. Its size must not exceed 15. </b></en><fr>Référence de commande du destinataire <br/> Elle permet d'afficher la référence destinataire seulement sur l'étiquette. Cette donnée n'est pas remontée dans le SI Colissimo et ne sera pas visible dans OSC. Sa taille ne doit pas excéder 15.</fr></lang>
        codeBarForReference:
          type: boolean
          description: '<i>B</i> <br/>  <lang><en>Default: false<br/>Used for Colissimo Retour only (tag productCode is <b>CORE</b>).<br/>Allows to indicate (or not) the reference of the order of the recipient in the form of a bar code on the label of the package.<br/>Enter "true" (or "1") to show the value of the tag addresseeParcelRef as a barcode on the parcel label.</en><fr>Par défaut, renseigner "false " (ou "0").</fr></lang>'
        serviceInfo:
          type: string
          description: '<i>AN</i> <br/>  <lang><en>Used for Colissimo Retour only (tag productCode is <b>CORE</b>).<br/>Name of the department in the company.<br/>Example: "Returns department".</en><fr></fr></lang>'
        promotionCode:
          type: string
          description: <i>AN</i> <br/>  <lang><en>Not used (La Poste internal use only)</en><fr>Non utilisé (usage interne à la poste uniquement)</fr></lang>
        address:
          $ref: '#/components/schemas/Address'
      description: <i>SUB</i> <br/>  <lang><en></en><fr></fr></lang>
    CommandMap:
      type: object
      properties:
        mimeTypes:
          type: array
          items:
            type: string
    ParcelRequestV31:
      required:
      - weight
      type: object
      properties:
        parcelNumber:
          type: string
          description: <i>AN13</i> <br/>  <lang><en>Not used (La Poste internal use only)</en><fr>Non utilisé (utilisation interne à La Poste uniquement)</fr></lang>
        insuranceAmount:
          type: integer
          description: <i>N</i> <br/>  <lang><en>Not used (La Poste internal use only)</en><fr>Non utilisé (utilisation interne à La Poste uniquement)</fr></lang>
          format: int32
        insuranceValue:
          type: integer
          description: '<i>N</i> <br/>  <lang><en>Insured value <br/><br/>  By default, enter "0".<br/><br/>If the insurance option is chosen, enter the amount of the desired insurance level by selecting among one of the 6 levels below . <br/> The amount must be written in cents. Example: 500000 for 5,000 EUR.<br/><br/> If the value entered does not match one of the 6 levels of insurance available, the value will be changed the level in which the entered amount is located. Example: 16200 for 162 EUR will become 30000 for 300 EUR. <br/><br/> 6 optional insurance levels: <br/> <ul> <li>150 EUR ; </li> <li>300 EUR ; </li> <li>500 EUR ; </li> <li>1000 EUR ; </li> <li>2000 EUR ; </li> <li>5000 EUR ;</li></ul><br/>Maximum= 5000€.</en><fr>Valeur assurée. <br/><br/> Par défaut, renseigner "0". <br/> Si l’option d’assurance est choisie, renseigner le montant du niveau d’assurance souhaité parmi les 6 niveaux proposés. Le montant doit être exprimé en centimes. Exemple : 500000 pour 5000 EUR. <br/><br/> Si la valeur renseignée ne correspond pas à l’un des 6 niveaux d’assurance, la valeur affichée sera celle du niveau dans lequel le montant renseigné se situe. Exemple : 16200 soit 162 EUR, deviendra 30000 EUR soit 300 EUR. <br/><br/>6 niveaux d’assurance optionnelle : <br/> <ul> <li>150 EUR ; </li> <li>300 EUR ; </li> <li>500 EUR ; </li> <li>1000 EUR ; </li> <li>2000 EUR ; </li> <li>5000 EUR ;</li></ul><br/>Maximum= 5000€.</fr></lang>'
          format: int32
        recommendationLevel:
          type: string
          description: <lang><en>Level</en><fr>Niveau</fr></lang>
        weight:
          type: number
          description: '<i>N</i> <br/>  <lang><en>Weight of parcel in kg. <br/> Example: "5.50". <br/><br/> <b>parameter "weight":</b> <ul> <li>Parcel weight in kg,</li> <li>Minimum: 0.01kg,</li> <li>Maximum: 30.00 kg or the maximum weight authorised by the pick-up location</li> <li>Only 2 decimals different from 0 are accepted.</li> </ul> <br/> <b>The status of the customer account:</b> a terminated customer account will not allow labels to be generated. </en><fr>Poids du colis en kg. <br/> Exemple : "5.50". </fr></lang>'
          format: float
        nonMachinable:
          type: boolean
          description: '<i>B</i> <br/>  <lang><en>Default: false<br/>Parcel format.<br/>If productCode is <b>HD</b>, enter "false" (or "0") by default.<br/>Enter "true" (or "1") to indicate that parcel format is non-standard (non-machinable).</en><fr>Format du colis. <br/> Si la balise productCode a les codes <b>HD</b> renseigner "false" (ou "0") par défaut. <br/> Passer à "true" (ou "1") pour indiquer que le format du colis est non standard (non mécanisable). </fr></lang>'
        returnReceipt:
          type: boolean
          description: '<i>B</i> <br/>  <lang><en>Default: false<br/>Advice of receipt</en><fr>Avis de réception. <br/><br/> Par défaut, renseigner "false " (ou "0"). </fr></lang>'
        instructions:
          type: string
          description: '<i>AN1...35</i> <br/>  <lang><en>Additional information:<br/><ul><li>For the delivery labels,</li><li>For Colissimo Return labels (return pattern).</li></ul>Example for a delivery: "to the left of interior gate".</en><fr>Permet d’afficher sur l’étiquette : <br/> <ul> <li>Des indications complémentaires pour la livraison,</li> <li>Le motif du retour.</li> </ul>  <br/>  Exemple pour une livraison : « à gauche au portail intérieur ». </fr></lang>'
        pickupLocationId:
          type: string
          description: '<i>N6</i> <br/>  <lang><en>Pick-up location identifier for Colissimo out of home delivery.<br/>This tag:<br/><ul><li>Must be entered if the tag productCode is <b>HD</b></li><li>Must be blank if the tag productCode is <b>DOM or DOS.</b></li></ul>If the network code is "X00", the block <fields> must be set.</en><fr>Identifiant du point de retrait pour une livraison Colissimo hors domicile. <br/><br/> Cette balise : <br/> <ul> <li>Doit être renseignée si productCode vaut <b>HD</b></li> <li>Doit être vide si productCode vaut <b>DOM</b> ou <b>DOS.</b></li> </ul> <br/> Si le code réseau est "X00", il sera obligatoire de renseigner le bloc fields.  </fr></lang>'
        ftd:
          type: boolean
          description: '<i>B</i> <br/>  <lang><en>Default: false<br/>For overseas shipments <br/>Mandatory, to be filled in by "true" (or "1"), for shipments to Overseas France only.</en><fr>Pour les envois vers l''outre-mer <br/><br/> Par défaut, renseigner "false " (ou "0"). <br/><br/>Obligatoire, à renseigner par "true " (ou "1"), pour les envois vers l’Outre-Mer uniquement.   </fr></lang>'
        ddp:
          type: boolean
          description: '<i>B</i> <br/>  <lang><en>Default: false <br/>- For international shipments <br/>Indicate "1" if the package is ddp</en><fr>Pour les envois vers l’international <br/><br/> Indiquer « 1 » si le colis est ddp, <br/><br/> Par défaut, renseigner « 0 » (zéro) </fr></lang>'
        disabledDeliveryBlockingCode:
          type: string
          description: '<lang><en>Prerequisite: you must have activated the "Code Bloquant" service on the Colissimo Box.<br/><br/>Indicates whether delivery should be made without a blocking code (if no value is entered, eligible parcels will be delivered with a blocking code).<br/><br/>1 = true: Deactivates the blocking code<br/>0 = False: Does not deactivate the blocking code<br/>Empty = False: Does not deactivate the blocking code</en><fr>Prérequis : avoir activé le service "Code Bloquant" sur la Colissimo Box<br/><br/>Indique si la livraison doit se faire sans code bloquant. (Si aucune valeur n''est renseignée, les colis éligibles seront livrés avec code bloquant)<br/><br/>1 = true : Désactive le code bloquant<br/>0 = False : Ne désactive pas le code bloquant<br/>Vide = False : Ne désactive pas le code bloquant</fr></lang>'
        hazmatFlag:
          type: boolean
          description: <lang><en>Indicates whether the package contains a hazardous material</en><fr>Indique si le colis contient une matière dangereuse</fr></lang>
        hazmatCategory:
          type: string
          description: <lang><en>Code (as defined in the contract) of the hazardous material category</en><fr>Code (comme définit dans le contrat) de la catégorie de matière dangereuse</fr></lang>
        hazmatPrintLogo:
          type: boolean
          description: <lang><en>Indicates whether the hazardous materials logo should be printed after the label. The logo will be printed in a 10x10 format only.</en><fr>Indique si le logo de matières dangereuses doit être imprimé après l’étiquette. Le logo sera imprimé dans un format 10x10 uniquement.</fr></lang>
        postCommand:
          type: boolean
        cod:
          type: boolean
          description: '<i>B</i> <br/>  <lang><en>Default: false<br/>Indicates whether delivery should be made on a reimbursable basis.</en><fr>Indique si la livraison doit se faire contre remboursement. <br/> <br/> Par défaut, renseigner "0" (zéro). <br/><br/>  Passer à "true" (ou "1") si la livraison doit se faire contre remboursement.  </fr></lang>'
        codcurrency:
          type: string
          description: <lang><en>COD currency</en><fr>COD devise</fr></lang>
        codamount:
          type: integer
          description: '<i>N</i> <br/>  <lang><en>Default: false (or 0)<br/>Mandatory if the value of the tag COD is "true" (or "1").<br/>Amount expected for cash on delivery.</en><fr>Montant attendu pour une livraison contre remboursement.  <br/><br/> Par défaut, renseigner "false" (ou "0"). <br/><br/> Obligatoire si la valeur de la balise COD est "true" (ou "1"). </fr></lang>'
          format: int32
      description: <i>SUB</i> <br/>  <lang><en></en><fr></fr></lang>
    Fields:
      type: object
      properties:
        field:
          type: array
          description: "<lang><en>Package size in centimeters: length, width and height<br/>\r\nLength <= 274 cm<br/>\r\nLength + circumference (2 x height + 2 x width) <= 330 cm<br/>\r\n               \r\n               <field>\r\n                   <key>LENGTH</key>\r\n                   <value>30</value>\r\n               </field>\r\n               <field>\r\n                   <key>WIDTH</key>\r\n                   <value>20</value>\r\n               </field>\r\n               <field>\r\n                   <key>HEIGHT</key>\r\n                   <value>10</value>\r\n               </field>\r\n               \r\n<b>Customer Barcode</b><br/>\r\nAdding a custom barcode in GEOLABEL standard labels cf. chapter \"Available Shipment options/Customer Barcode\" (maximum 17 alpha-numeric and 25 numeric characters)<br/>\r\n               \r\n               <field>\r\n                      <key>PRINT_CUSTOMER_BARCODE</key>\r\n                      <value>1</value>\r\n               </field>\r\n               <field>\r\n                       <key>CUSTOMER_BARCODE</key>\r\n                       <value>REF12345678</value>\r\n               </field>\r\n\r\nIF PRINT_CUSTOMER_BARCODE = 1, print the barcode with the value of the field CUSTOMER_BARCODE (see example of labels II.5.1.7)<br/>\r\nIF PRINT_CUSTOMER_BARCODE = 2, print the barcode with the value of the parcel number (see example of labels II.5.1.8)<br/>\r\n<br/>\r\n<br/>\r\n<b>Label with visible client tag</b><br/>\r\nOn standard GEOLABEL labels in 10x15 and PDF format, it is possible to add a customized 15 characters text below the label.<br/>\r\nThe PRINT_CUSTOMER_LABEL field allows the text to be displayed or not, and the CUSTOMER_LABEL field specifies the text.<br/>\r\n    \n             <field>\r\n                 <key>PRINT_CUSTOMER_LABEL</key>\r\n                 <value>1</value>\r\n             </field>\r\n    \n    \n             <field>\r\n                 <key>CUSTOMER_LABEL</key>\r\n                 <value>ABCDEFG</value>\r\n             </field>\r\n    \n<br/>\r\nNote: it is not possible to display a personalized barcode and a personalized text at the same time.<br/>\r\n<br/>\r\nNote 2: the personalized text will not appear on the label when reprinted by getlabel (or on a La Poste vending machine).<br/>\r\n<br/>\r\n<b>CN23 format</b><br/>\r\nAddition of a specific CN23 format :<br/>\r\n    \n             <field>\r\n                 <key>OUTPUT_PRINT_TYPE_CN23</key>\r\n                 <value>ZPL_10x12_203dpi</value>\r\n             </field>\r\n    \nFormat/value allowed :<br/>\r\nZPL_10x12_203dpi<br/>\r\nZPL_10x12_300dpi<br/>\r\nDPL_10x12_203dpi<br/>\r\nDPL_10x12_300dpi<br/>\r\nPDF_10x12_300dpi<br/>\r\nPDF_A4_300dpi<br/>\r\n<b>“Unique Label” (UL) including label and CN23 on the same page </b> <br/>\r\naccepted formats are : <br/>\r\nZPL_10x15_203dpi_UL<br/>\r\nZPL_10x15_300dpi_UL<br/>\r\nDPL_10x15_203dpi_UL<br/>\r\nDPL_10x15_300dpi_UL<br/>\r\nPDF_10x15_300dpi_UL<br/>\r\nPDF_A4_300dpi_UL<br/>\r\n    \n             <field>\r\n                 <key>OUTPUT_PRINT_TYPE_CN23</key>\r\n                 <value>PDF_10x15_300dpi_UL</value>\r\n             </field>\r\n    \nThe parcel (output_print_type_CN23) format and parcel format (outputprinting type) has to be the same in order to use the unique label feature :<br/>\r\nIf the parcel is not eligible for CN23, then the label format will be printed<br/>\r\n(OutputFormat block: outputprinting type field).<br/>\r\nIf more than 3 items are entered in the CN23 section, they will not be displayed in the item list, but included in the total value and weight.<br/>\r\nThis option overrides the customization features :<br/>\r\n- Add a customer label (PRINT_CUSTOMER_LABEL)<br/>\r\n- Adding a customer reference CAB (PRINT_CUSTOMER_BARCODE)<br/><br/>\r\n<b>Group your Parcel</b><br/>\r\n<br/>\r\n- The additional input parameters of the WS SLS for tracked parcels are as follows:<br/>\r\n•\tTracking parcel flag<br/>\r\n•\tTotal number of packages<br/>\r\n•\tIteration (order number of the package)<br/>\r\n<br/>\r\n<br/>\r\n               <field>\r\n                  <key>TYPE_MULTI_PARCEL</key>\r\n                  <value>FOLLOWER</value>\r\n               </field>\r\n               <field>\r\n                  <key>PARCEL_ITERATION_NUMBER</key>\r\n                  <value>2</value>\r\n               </field>\r\n               <field>\r\n                  <key>TOTAL_NUMBER_PARCEL</key>\r\n                  <value>5</value>\r\n               </field>\r\n<br/>\r\n- The additional input parameters of the WS SLS for the master parcel are <br/>\r\n•\tMaster parcel flag<br/>\r\n•\tIteration (order number of the package)<br/>\r\n•\tTotal number of packages<br/>\r\nLimitation of 5 parcels in total<br/>\r\n•\tList of follow-up packages<br/>\r\n     \r\n     \r\n              <field>\n                   <key>TYPE_MULTI_PARCEL</key>\r\n                   <value>MASTER</value>\r\n             </field>\r\n             <field>\r\n                  <key>PARCEL_ITERATION_NUMBER</key>\r\n                   <value>2</value>\r\n             </field>\r\n             <field>\r\n                  <key>TOTAL_NUMBER_PARCEL</key>\r\n                   <value>5</value>\r\n             </field>\r\n             <field>\r\n                  <key>LIST_FOLLOWER_PARCEL</key>\r\n\t\t\t\t     <value>8Q53764663714/8Q53764663721/8Q53764663738/8Q53764663748/8Q53764663758</value>\r\n             </field>\r\n<br/>\r\n<b>BuyNowPayLater</b><br/>\r\nThis input is used to notify transaction id attached to a parcel as part of the Colissimo<br/>\r\npay offer for deferred and fractioned payment.<br/>\r\nThis id parameter is truncated at 50 characters<br/>\r\n    \n             <field>\r\n                 <key>BNPL</key>\r\n                 <value>ID de transaction</value>\r\n             </field>\r\n    \n<b>CUSER_INFO_TEXT</b><br/>\r\nResearch label for OSC. The label can be unique or shared between multiple parcels in order to search for a list of parcels with the same reference, for example.<br/>\r\n    \n             <field>\r\n                 <key>CUSER_INFO_TEXT</key>\r\n                 <value>xxxxxxxxxxxxxxxxxx</value>\r\n             </field>\r\n    \n<b>CUSER_INFO_TEXT_4</b><br/>\r\nPartner reference (if given by your Colissimo contacts). Specific to the use of the service by our partners.<br/>\r\n    \n             <field>\r\n                 <key>CUSER_INFO_TEXT_4</key>\r\n                 <value>xxxxxxxxxxxxxxxxxx</value>\r\n             </field>\r\n    \n<br/>\r\n<b>EORI (Economics Operators Registration and Identification)</b><br/>\r\n<br/>EORI numbers of the sender and/or recipient, which will appear on the customs declaration.\r\n  * Use the 'EORI_ADDRESSEE' field for the recipient's EORI.\r\n    <br/>\n  * Use the 'EORI' field for the sender's EORI (mandatory for shipments to the US).\r\n    \n             <field>\n                <key>EORI</key>\n                <value>1234567</value>\n             </field>\n             <field>\n                <key>EORI_ADRESSEE</key>\n                <value>1234567</value>\n             </field>\n</en><fr>Taille du colis en centimètres: longueur, largeur et hauteur<br/>\r\nLongueur <= 274 cm<br/>\r\nLongueur + curconférence (2 x hauteur + 2 x largeur) <= 330 cm<br/>\r\n               \r\n               <field>\r\n                   <key>LENGTH</key>\r\n                   <value>30</value>\r\n               </field>\r\n               <field>\r\n                   <key>WIDTH</key>\r\n                   <value>20</value>\r\n               </field>\r\n               <field>\r\n                   <key>HEIGHT</key>\r\n                   <value>10</value>\r\n               </field>\r\n               \r\n<b>Code barre personnalisé</b><br/>\r\nAjouter un code barre personnalisé sur les étiquettes standards GEOLABEL conf. chapitre \"Option d'envoi/Code barres client\" (maximum 17 caractères alpha numériques et 25 numériques)<br/>\r\n               \r\n               <field>\r\n                      <key>PRINT_CUSTOMER_BARCODE</key>\r\n                      <value>1</value>\r\n               </field>\r\n               <field>\r\n                       <key>CUSTOMER_BARCODE</key>\r\n                       <value>REF12345678</value>\r\n               </field>\r\n\r\nIF PRINT_CUSTOMER_BARCODE = 1, affiche le code barre avec la valeur du champ CUSTOMER_BARCODE (voir les exemples d'etiquettes)<br/>\r\nIF PRINT_CUSTOMER_BARCODE = 2, affiche le code barre avec la valeur du numéro de colis (voir les exemples d'etiquettes)<br/>\r\n<br/>\r\n<br/>\r\n<b>Etiquette avec référence client</b><br/>\r\nSur les étiquettes standard GEOLABEL au format 10x15 et PDF , il est possible d'ajouter un texte personnalisé de 15 caractères maximum sous les étiquettes.<br/>\r\nLe champ PRINT_CUSTOMER_LABEL permet d'afficher ou non le texte, et le champ CUSTOMER_LABEL précise le texte.<br/>\r\n    \n             <field>\r\n                 <key>PRINT_CUSTOMER_LABEL</key>\r\n                 <value>1</value>\r\n             </field>\r\n    \n    \n             <field>\r\n                 <key>CUSTOMER_LABEL</key>\r\n                 <value>ABCDEFG</value>\r\n             </field>\r\n    \n<br/>\r\nRemarque : il n'est pas possible d'afficher en même temps un code à barre personnalisé et un texte personnalisé<br/>\r\n<br/>\r\nRemarque 2 : le texte personnalisé n'apparaîtra pas sur l'étiquette en cas de réimpression par getlabel (ou sur un automate La Poste).<br/>\r\n<br/>\r\n<b>CN23 format</b><br/>\r\nFormats spécifiques pour la CN23 :<br/>\r\n    \n             <field>\r\n                 <key>OUTPUT_PRINT_TYPE_CN23</key>\r\n                 <value>ZPL_10x12_203dpi</value>\r\n             </field>\r\n    \nFormats possibles :<br/>\r\nZPL_10x12_203dpi<br/>\r\nZPL_10x12_300dpi<br/>\r\nDPL_10x12_203dpi<br/>\r\nDPL_10x12_300dpi<br/>\r\nPDF_10x12_300dpi<br/>\r\nPDF_A4_300dpi<br/>\r\n<b>une étiquette unique (UL) incluant la CN23 sur la même page</b> <br/>\r\nles formats acceptés sont : <br/>\r\nZPL_10x15_203dpi_UL<br/>\r\nZPL_10x15_300dpi_UL<br/>\r\nDPL_10x15_203dpi_UL<br/>\r\nDPL_10x15_300dpi_UL<br/>\r\nPDF_10x15_300dpi_UL<br/>\r\nPDF_A4_300dpi_UL<br/>\r\n    \n             <field>\r\n                 <key>OUTPUT_PRINT_TYPE_CN23</key>\r\n                 <value>PDF_10x15_300dpi_UL</value>\r\n             </field>\r\n    \nLe format de la CN23 (output_print_type_CN23) et format de l'étiquette (outputprinting type) doit être le même pour bénéficier de la fonctionnalité d'étiquette unifiée: <br/><br/>\r\nSi le colis n'est pas éligile à la CN23, le format affiché sera<br/>\r\n(OutputFormat block: outputprinting type field).<br/>\r\nSi il y a plus de 3 articles, la CN23 affichera que les 3 premiers mais les totaux seront pour l'ensemble des articles<br/>\r\nCette option écrase les personalisations suivantes : <br/>\r\n- Ajout d'une étiquette personalisée (PRINT_CUSTOMER_LABEL)<br/>\r\n- Ajout d'une référence CAB personalisée (PRINT_CUSTOMER_BARCODE)<br/><br/>\r\n<b>Groupage de colis</b><br/>\r\n<br/>\r\n- Les paramètres additionnels du service sls pour tracer les colis sont les suivants : <br/>\r\n•\tEtiquette de traçage du colis<br/>\r\n•\tNombre total de packages<br/>\r\n•\tIteration (numéro du package)<br/>\r\n<br/>\r\n<br/>\r\n               <field>\r\n                  <key>TYPE_MULTI_PARCEL</key>\r\n                  <value>FOLLOWER</value>\r\n               </field>\r\n               <field>\r\n                  <key>PARCEL_ITERATION_NUMBER</key>\r\n                  <value>2</value>\r\n               </field>\r\n               <field>\r\n                  <key>TOTAL_NUMBER_PARCEL</key>\r\n                  <value>5</value>\r\n               </field>\r\n<br/>\r\n- Les paramètres additionnels du service sls pour les colis master sont les suivants : <br/>\r\n•\tEtiquette du colis master<br/>\r\n•\tNombre total de packages<br/>\r\n•\tIteration (numéro du package)<br/>\r\n•    Limitation à 5 colis<br/>\r\n•\tListe des packages suivis<br/>\r\n     \r\n     \r\n              <field>\n                   <key>TYPE_MULTI_PARCEL</key>\r\n                   <value>MASTER</value>\r\n             </field>\r\n             <field>\r\n                  <key>PARCEL_ITERATION_NUMBER</key>\r\n                   <value>2</value>\r\n             </field>\r\n             <field>\r\n                  <key>TOTAL_NUMBER_PARCEL</key>\r\n                   <value>5</value>\r\n             </field>\r\n             <field>\r\n                  <key>LIST_FOLLOWER_PARCEL</key>\r\n\t\t\t\t     <value>8Q53764663714/8Q53764663721/8Q53764663738/8Q53764663748/8Q53764663758</value>\r\n             </field>\r\n<br/>\r\n<b>BuyNowPayLater</b><br/>\r\nCette saisie permet de notifier l'identifiant de la transaction attachée à un colis Colissimo<br/>\r\noffre payante en paiement différé et fractionné.<br/>\r\nCe paramètre id est tronqué à 50 caractères<br/>\r\n    \n             <field>\r\n                 <key>BNPL</key>\r\n                 <value>ID de transaction</value>\r\n             </field>\r\n    \n<b>CUSER_INFO_TEXT</b><br/>\r\nRéférence de recherche pour OSC. La référence peut être unique ou partagée sur plusieurs colis, afin de permettre de rechercher une liste de colis ayant la même référence par exemple.<br/>\r\n    \n             <field>\r\n                 <key>CUSER_INFO_TEXT</key>\r\n                 <value>xxxxxxxxxxxxxxxxxx</value>\r\n             </field>\r\n    \n<b>CUSER_INFO_TEXT_4</b><br/>\r\nRéférence partenaire (si communiquée par vos interlocuteurs Colissimo). Spécifique à l'utilisation du service par nos partenaires.<br/>\r\n    \n             <field>\r\n                 <key>CUSER_INFO_TEXT_4</key>\r\n                 <value>xxxxxxxxxxxxxxxxxx</value>\r\n             </field>\r\n    \n<br/>\r\n<b>EORI (Economics Operators Registration and Identification)</b><br/>\r\n<br/>Numéros EORI de l'expéditeur et/ou du destinataire qui seront visibles notamment sur la déclaration douanière.\r\n  * Utiliser le champs 'EORI_ADDRESSEE' pour l'EORI du destinataire\r\n    <br/>\n  * Utiliser le champs 'EORI' pour l'EORI de l'expéditeur (obligatoire pour les envois vers les US).\r\n    \n             <field>\n                <key>EORI</key>\n                <value>1234567</value>\n             </field>\n             <field>\n                <key>EORI_ADRESSEE</key>\n                <value>1234567</value>\n             </field>\n</fr></lang>"
          items:
            $ref: '#/components/schemas/Field'
        customField:
          type: array
          items:
            $ref: '#/components/schemas/Field'
      description: <i>SUB</i> <br/>  <lang><en></en><fr>Ce bloc peut être utilisé pour renseigner l’identifiant <br/><br/> -Gestion des utilisateurs </b> <br/> -Colissimo Pass ID <br/> - GST <br/> - EORI </fr></lang>
    Address:
      required:
      - countryCode
      - zipCode
      type: object
      properties:
        companyName:
          type: string
          description: <i>AN35</i> <br/>  <lang><en>companyName <br/><br/>For return postage (product code CORE 8R, CORI 7R or 5R), the company name is mandatory for the recipient.</en><fr>Raison sociale. <br/><br/>Pour un affranchissement retour (code produit CORE 8R, CORI 7R ou 5R), la raison sociale est obligatoire pour le destinataire</fr></lang>
        lastName:
          type: string
          description: <i>A1...35</i> <br/>  <lang><en>Last name.<br/>Mandatory to send a parcel unless zipcode is a cedex Code</en><fr>Nom.<br/><br/>Obligatoire pour envoyer un colis sauf si le code postal est un code cedex</fr></lang>
        firstName:
          type: string
          description: <i>A1...29</i> <br/>  <lang><en>First name.<br/>Mandatory for out-of-home delivery (product code HD)</en><fr>Prénom.<br/><br/>Obligatoire pour un envoi hors domicile (code produit HD)</fr></lang>
        line0:
          type: string
          description: '<i>AN1...35</i> <br/>  <lang><en>Floor, hallway, stairs, apartment.<br/><br/><b>Important: this line does not appear on labels being sent to Switzerland.</b></en><fr>Etage, couloir, escalier, appart.</fr></lang>'
        line1:
          type: string
          description: '<i>AN1...35</i> <br/>  <lang><en>Entrance, bulding, residence.<br/><br/><b>Important: this line does not appear on labels being sent to Switzerland.</b></en><fr>Entrée, bâtiment, immeuble, résidence.</fr></lang>'
        line2:
          type: string
          description: '<i>AN1...35</i> <br/>  <lang><en>Number and route label.<br/><br/>Example: « 5 rue du Bellay »<br/><br/>must contain at least one character</en> <fr>Numéro et libellé de voie.<br/><br/> Exemple : « 5 rue du Bellay »<br/><br/>doit comporter impérativement au moins un caractère</fr></lang>'
        line3:
          type: string
          description: '<i>AN1...35</i> <br/>  <lang><en>Place said or other mention.<br/><br/><b>Important: this line does not appear on labels being sent to Switzerland.</b></en><fr>Lieu dit ou autre mention.</fr></lang>'
        countryCode:
          type: string
          description: '<i>A2</i> <br/>  <lang><en>ISO country code on 2 letters.<br/>Example: « FR » for France</en><fr>Code ISO du pays sur 2 lettres.<br/><br/>Ex : « FR » pour la France </fr></lang>'
        city:
          type: string
          description: <i>AN1...35</i> <br/>  <lang><en>Town.<br/><br/>Can be left blank (or else filled in by a chain of some sort, possibly not adequate) if the tag zipCode is filled with a Cedex code. *</en><fr>Ville.<br/><br/> Peut être laissée vide (ou aussi bien renseignée par une chaîne quelconque, éventuellement non appropriée) si la balise zipCode est renseignée par un code Cedex. * </fr></lang>
        zipCode:
          type: string
          description: <i>AN5</i> <br/>  <lang><en>Postal code.<br/>If the postcode matches a Cedex code then:<br/><ul><li>the tag line2 can be left blank,</li><li>the tag city can be left blank.</li></ul></en><fr>Code postal.<br/><br/> Si le code postal correspond à un code Cedex alors :<br/> <ul> <li>la balise line2 peut être laissée vide,</li> <li>la balise city peut être laissée vide.</li></ul><br/></fr></lang>
        phoneNumber:
          type: string
          description: <i>AN10...12</i> <br/> <lang><en>Phone Number.</en><br/><fr>Numéro de téléphone.</fr></lang>
        mobileNumber:
          type: string
          description: '<i>AN</i> <br/> <lang><en>The cell phone number is strongly recommended to improve the chances of delivery to the recipient (it is used to send tracking notifications by SMS).<br/>Checks performed :<ul><li>15 characters maximum</li><li>For Belgium parcel, the format must be exactly : +324NNNNNNNN</li></ul>It must be filled in for the following packages :<ul><li>Domestic out-of-home parcels (productCode=HD)</li><li>Parcels with DDP option</li><li>Parcels to the US</li></ul><br/><br/>For any international shipment, it is necessary to use the telephone prefix specific to the country in which your recipient is located.<br/><br/>The digits of the number must not follow an incremental sequence (e.g., 123456789), otherwise the WebService will return an error.</en><br/><fr>Le numéro de portable est fortement recommandé pour améliorer les chances de livraison au destinataire (il est notamment utilisé pour l''envoi des notifications de suivi par SMS).<br/>Contrôles effectués :<ul><li>15 caractères maximum</li><li>Pour les envois vers la Belgique, le format doit être exactement : +324NNNNNNNN</li></ul>Il doit être renseigné obligatoirement pour les colis suivants :<ul><li>Colis hors domicile (productCode=HD) nationaux</li><li>Colis avec l''option DDP</li><li>Colis vers les US</li></ul><br/><br/>Pour tout envoi à l''international, il est nécessaire d’utiliser le préfixe téléphonique spécifique au pays dans lequel se trouve votre destinataire.<br/><br/>les chiffres du numéro ne doivent pas se suivre de manière incrémentale (ex. : 123456789), sinon le WebService retournera une erreur.</fr></lang>'
        doorCode1:
          type: string
          description: <i>AN1...8</i> <br/>  <lang><en>Door code 1.<br/>Doesn’t appear on the CN23 document.</en><fr>Code porte 1.<br/><br/>N’apparaît pas sur la CN23.</fr></lang>
        doorCode2:
          type: string
          description: <i>AN1...8</i> <br/>  <lang><en>Door code 2.<br/>Doesn’t appear on the CN23 document.</en><fr>Code porte 2.<br/><br/>N’apparaît pas sur la CN23.</fr></lang>
        intercom:
          type: string
          description: <i>AN1...30</i> <br/>  <lang><en>Interphone.<br/><br/>Doesn’t appear on the CN23 document.</en><fr>Interphone.<br/><br/>N’apparaît pas sur la CN23.</fr></lang>
        email:
          type: string
          description: '<i>AN5...80</i> <br/>  <lang><en>Mandatory if the tag productCode is <b>HD</b>.<br/><br/>Email Address.<br/>Used for follow-up notifications to the sender.<br/>Expected form: Text@Text.Text.</en><fr>Obligatoire pour les envois hors domiciles <br/><br/> Adresse courriel.<br/><br/>Utilisé pour les notifications de suivi à l’expéditeur.<br/><br/>Forme attendue : Texte@Texte.Texte  </fr></lang>'
        language:
          type: string
          description: '<i>A2</i> <br/>  <lang><en>By default, the local language of the sending country.<br/>Language of the notification e-mail to the sender.<br/>Used for tracking notifications by email or SMS.<br/>The information is transmitted to local partners who can exploit it or not.</en><fr>Langue du mail de notification à l’expéditeur.<br/><br/> Utilisée pour les retours de colis avec le code produit <b>CORI</b> (7R) si la balise returnType est renseignée. <br/><br/> Utilisée pour les notifications de suivi par email ou SMS.<br/>Par défaut : FR <br/><br/> Langues disponibles : ES, IT, NL, EN, DE. </fr></lang>'
        stateOrProvinceCode:
          type: string
          description: <i>AN2</i> <br/>  <lang><en>State or province code. Required for the United States.</en><fr>Code de l'état ou de la province. Obligatoire pour les Etats Unis.</fr></lang>
      description: <i>SUB</i> <br/>  <lang><en></en><fr></fr></lang>
    ParcelRequestV2:
      required:
      - weight
      type: object
      properties:
        parcelNumber:
          type: string
          description: <i>AN13</i> <br/>  <lang><en>Not used (La Poste internal use only)</en><fr>Non utilisé (utilisation interne à La Poste uniquement)</fr></lang>
        insuranceAmount:
          type: integer
          description: <i>N</i> <br/>  <lang><en>Not used (La Poste internal use only)</en><fr>Non utilisé (utilisation interne à La Poste uniquement)</fr></lang>
          format: int32
        insuranceValue:
          type: integer
          description: '<i>N</i> <br/>  <lang><en>Insured value <br/><br/>  By default, enter "0".<br/><br/>If the insurance option is chosen, enter the amount of the desired insurance level by selecting among one of the 6 levels below . <br/> The amount must be written in cents. Example: 500000 for 5,000 EUR.<br/><br/> If the value entered does not match one of the 6 levels of insurance available, the value will be changed the level in which the entered amount is located. Example: 16200 for 162 EUR will become 30000 for 300 EUR. <br/><br/> 6 optional insurance levels: <br/> <ul> <li>150 EUR ; </li> <li>300 EUR ; </li> <li>500 EUR ; </li> <li>1000 EUR ; </li> <li>2000 EUR ; </li> <li>5000 EUR ;</li></ul><br/>Maximum= 5000€.</en><fr>Valeur assurée. <br/><br/> Par défaut, renseigner "0". <br/> Si l’option d’assurance est choisie, renseigner le montant du niveau d’assurance souhaité parmi les 6 niveaux proposés. Le montant doit être exprimé en centimes. Exemple : 500000 pour 5000 EUR. <br/><br/> Si la valeur renseignée ne correspond pas à l’un des 6 niveaux d’assurance, la valeur affichée sera celle du niveau dans lequel le montant renseigné se situe. Exemple : 16200 soit 162 EUR, deviendra 30000 EUR soit 300 EUR. <br/><br/>6 niveaux d’assurance optionnelle : <br/> <ul> <li>150 EUR ; </li> <li>300 EUR ; </li> <li>500 EUR ; </li> <li>1000 EUR ; </li> <li>2000 EUR ; </li> <li>5000 EUR ;</li></ul><br/>Maximum= 5000€.</fr></lang>'
          format: int32
        recommendationLevel:
          type: string
          description: <lang><en>Level</en><fr>Niveau</fr></lang>
        weight:
          type: number
          description: '<i>N</i> <br/>  <lang><en>Weight of parcel in kg. <br/> Example: "5.50". <br/><br/> <b>parameter "weight":</b> <ul> <li>Parcel weight in kg,</li> <li>Minimum: 0.01kg,</li> <li>Maximum: 30.00 kg or the maximum weight authorised by the pick-up location</li> <li>Only 2 decimals different from 0 are accepted.</li> </ul> <br/> <b>The status of the customer account:</b> a terminated customer account will not allow labels to be generated. </en><fr>Poids du colis en kg. <br/> Exemple : "5.50". </fr></lang>'
          format: float
        nonMachinable:
          type: boolean
          description: '<i>B</i> <br/>  <lang><en>Default: false<br/>Parcel format.<br/>If productCode is <b>HD</b>, enter "false" (or "0") by default.<br/>Enter "true" (or "1") to indicate that parcel format is non-standard (non-machinable).</en><fr>Format du colis. <br/> Si la balise productCode a les codes <b>HD</b> renseigner "false" (ou "0") par défaut. <br/> Passer à "true" (ou "1") pour indiquer que le format du colis est non standard (non mécanisable). </fr></lang>'
        returnReceipt:
          type: boolean
          description: '<i>B</i> <br/>  <lang><en>Default: false<br/>Advice of receipt</en><fr>Avis de réception. <br/><br/> Par défaut, renseigner "false " (ou "0"). </fr></lang>'
        instructions:
          type: string
          description: '<i>AN1...35</i> <br/>  <lang><en>Additional information:<br/><ul><li>For the delivery labels,</li><li>For Colissimo Return labels (return pattern).</li></ul>Example for a delivery: "to the left of interior gate".</en><fr>Permet d’afficher sur l’étiquette : <br/> <ul> <li>Des indications complémentaires pour la livraison,</li> <li>Le motif du retour.</li> </ul>  <br/>  Exemple pour une livraison : « à gauche au portail intérieur ». </fr></lang>'
        pickupLocationId:
          type: string
          description: '<i>N6</i> <br/>  <lang><en>Pick-up location identifier for Colissimo out of home delivery.<br/>This tag:<br/><ul><li>Must be entered if the tag productCode is <b>HD</b></li><li>Must be blank if the tag productCode is <b>DOM or DOS.</b></li></ul>If the network code is "X00", the block <fields> must be set.</en><fr>Identifiant du point de retrait pour une livraison Colissimo hors domicile. <br/><br/> Cette balise : <br/> <ul> <li>Doit être renseignée si productCode vaut <b>HD</b></li> <li>Doit être vide si productCode vaut <b>DOM</b> ou <b>DOS.</b></li> </ul> <br/> Si le code réseau est "X00", il sera obligatoire de renseigner le bloc fields.  </fr></lang>'
        ftd:
          type: boolean
          description: '<i>B</i> <br/>  <lang><en>Default: false<br/>For overseas shipments <br/>Mandatory, to be filled in by "true" (or "1"), for shipments to Overseas France only.</en><fr>Pour les envois vers l''outre-mer <br/><br/> Par défaut, renseigner "false " (ou "0"). <br/><br/>Obligatoire, à renseigner par "true " (ou "1"), pour les envois vers l’Outre-Mer uniquement.   </fr></lang>'
        ddp:
          type: boolean
          description: '<i>B</i> <br/>  <lang><en>Default: false <br/>- For international shipments <br/>Indicate "1" if the package is ddp</en><fr>Pour les envois vers l’international <br/><br/> Indiquer « 1 » si le colis est ddp, <br/><br/> Par défaut, renseigner « 0 » (zéro) </fr></lang>'
        disabledDeliveryBlockingCode:
          type: string
          description: '<lang><en>Prerequisite: you must have activated the "Code Bloquant" service on the Colissimo Box.<br/><br/>Indicates whether delivery should be made without a blocking code (if no value is entered, eligible parcels will be delivered with a blocking code).<br/><br/>1 = true: Deactivates the blocking code<br/>0 = False: Does not deactivate the blocking code<br/>Empty = False: Does not deactivate the blocking code</en><fr>Prérequis : avoir activé le service "Code Bloquant" sur la Colissimo Box<br/><br/>Indique si la livraison doit se faire sans code bloquant. (Si aucune valeur n''est renseignée, les colis éligibles seront livrés avec code bloquant)<br/><br/>1 = true : Désactive le code bloquant<br/>0 = False : Ne désactive pas le code bloquant<br/>Vide = False : Ne désactive pas le code bloquant</fr></lang>'
        cod:
          type: boolean
          description: '<i>B</i> <br/>  <lang><en>Default: false<br/>Indicates whether delivery should be made on a reimbursable basis.</en><fr>Indique si la livraison doit se faire contre remboursement. <br/> <br/> Par défaut, renseigner "0" (zéro). <br/><br/>  Passer à "true" (ou "1") si la livraison doit se faire contre remboursement.  </fr></lang>'
        codcurrency:
          type: string
          description: <lang><en>COD currency</en><fr>COD devise</fr></lang>
        codamount:
          type: integer
          description: '<i>N</i> <br/>  <lang><en>Default: false (or 0)<br/>Mandatory if the value of the tag COD is "true" (or "1").<br/>Amount expected for cash on delivery.</en><fr>Montant attendu pour une livraison contre remboursement.  <br/><br/> Par défaut, renseigner "false" (ou "0"). <br/><br/> Obligatoire si la valeur de la balise COD est "true" (ou "1"). </fr></lang>'
          format: int32
      description: <i>SUB</i> <br/>  <lang><en></en><fr></fr></lang>
    Site:
      type: object
      properties:
        code:
          type: string
        name:
          type: string
        address:
          $ref: '#/components/schemas/AddressPCH'
        rdepot:
          type: string
    DataHandler:
      type: object
      properties:
        dataSource:
          $ref: '#/components/schemas/DataSource'
        name:
          type: string
        inputStream:
          type: object
        content:
          type: object
        commandMap:
          $ref: '#/components/schemas/CommandMap'
        transferDataFlavors:
          type: array
          items:
            $ref: '#/components/schemas/ActivationDataFlavor'
        preferredCommands:
          type: array
          items:
            $ref: '#/components/schemas/CommandInfo'
        allCommands:
          type: array
          items:
            $ref: '#/components/schemas/CommandInfo'
        contentType:
          type: string
        outputStream:
          type: object
    LabelV2Response:
      type: object
      properties:
        label:
          $ref: '#/components/schemas/DataHandler'
        cn23:
          $ref: '#/components/schemas/DataHandler'
        parcelNumber:
          type: string
        parcelNumberPartner:
          type: string
        pdfUrl:
          type: string
        fields:
          $ref: '#/components/schemas/Fields'
    CustomsDeclarations:
      type: object
      properties:
        includeCustomsDeclarations:
          type: boolean
          description: '<i>B</i> <br/>  <lang><en>Default: false<br/>Allows to include, in the response of the web service, the generation of a CN23 document in PDF format, relating to the articles declared in the web service request.<br/><br/>The CN23 document:<br/><ul><li>Is included by default in the web service response (the tag is "true" -or "1"),</li><li>Is not generated if the value of the tag is "false" (or "0")</li></ul>  <br/> "includeCustomsDeclarations = 1" tag is mandatory for shipments eligible for dematerialization of customs documents (DDP option or DOM TOM shipment).</en><fr>Permet d’inclure, dans la réponse du web service, la génération d’un document CN23 au format PDF portant sur les articles déclarés dans la requête web service. <br/><br/> Par défaut vaut "true" (ou "1") pour inclure le document CN23 dans la réponse du web service.  <br/><br/> Indiquez "false" (ou "0") pour ne pas inclure le document CN23 dans la réponse du web service. <br/><br/> La balise « includeCustomsDeclarations = 1 » est obligatoire pour les envois éligibles à la dématérialisation des documents douaniers (option DDP ou envoi Outre-Mer). </fr></lang>'
        numberOfCopies:
          type: integer
          description: '<i>N</i> <br/>  <lang><en>Number of CN23 to print<br/>If the tag is not filled in, 4 copies of CN23 will be printed.<br/>The number goes from 1 included to 4 copies max. <br/> Note: international returns do not take into account the value entered here, due to their specific format.</en><fr>Nombre de CN23 à imprimer Si la balise n’est pas renseignée 4 exemplaires de CN23 seront imprimés. Le nombre va de 1 compris à 4 exemplaires max. <br/> Remarque : les produits retours internationaux ne tiennent pas compte de par leur format spécifique de la valeur renseignée ici.</fr></lang>'
          format: int32
        contents:
          $ref: '#/components/schemas/Contents'
        importersReference:
          type: string
          description: <i>AN1…35</i> <br/>  <lang><en>Importer's reference, TVA number<br/>Appears on the CN23 document for shipments.<br/>Not used for returns.</en><fr>Référence de l’importateur, Numéro de TVA.<br/><br/> Apparaît sur le fichier CN23 pour les envois.<br/>N’est pas utilisé pour les retours. </fr></lang>
        importersContact:
          type: string
          description: <i>AN35</i> <br/>  <lang><en>Importer's contact (tel./e-mail).<br/>Doesn’t appear on CN23 document.</en><fr>Contact (tél./e-mail) de l’importateur. <br/> N’apparaît pas sur le fichier CN23.</fr></lang>
        officeOrigin:
          type: string
          description: <i>AN35</i> <br/>  <lang><en>Office origin.<br/>Doesn’t appear on CN23 document.</en><fr>Bureau d’origine. <br/> N’apparaît pas sur le fichier CN23.</fr></lang>
        comments:
          type: string
          description: <i>AN35</i> <br/>  <lang><en>Observations<br/>Appears on CN23 document.</en><fr>Observations<br/>Apparaît sur le fichier CN23</fr></lang>
        description:
          type: string
          description: '<i>AN1.. ??</i> <br/>  <lang><en>Mandatory in the case of a DDP shipment<br/>Generic description of articles in English.<br/>Example: Textile items, Shoes, Music instrument, Hair dryer, etc.</en><fr>Description générique des articles en anglais. <br/> Obligatire dans le cas d’un envoi DDP <br/> Exemple : Textile items, Shoes, Music instrument, Hair dryer, etc  </fr></lang>'
        invoiceNumber:
          type: string
          description: <i>AN1...35</i> <br/>  <lang><en>Identifier of related invoice document.<br/>Appears in the « N° de la facture » field on the CN23 document.</en><fr>Identifiant du document facture lié.<br/> Apparaît dans le champ « N° de la facture » sur la CN23.</fr></lang>
        licenceNumber:
          type: string
          description: <i>AN1…35</i> <br/>  <lang><en>Identifier of the related import license document.<br/>Appears in the « N° de la/les licences » field on the CN23 document.</en><fr>Identifiant du document de licence d’importation lié. <br/> Apparaît dans le champ « N° de la/les licences » sur la CN23.</fr></lang>
        certificatNumber:
          type: string
          description: <i>AN1…35</i> <br/>  <lang><en>Identifier of the related certificate number document.<br/><br/>Appears in the « N° du/des certificats » field on the CN23 document.</en><fr>Identifiant du document de certificat lié. <br/> Apparaît dans le champ « N° du/des certificats » sur la CN23.</fr></lang>
        importerAddress:
          $ref: '#/components/schemas/Address'
      description: <i>SUB</i> <br/>  <lang><en>These parameters are mandatory only for destinations requiring a CN23 customs declaration.</en><fr>Ces paramètres ne sont obligatoires que pour les destinations nécessitant une déclaration douanière de type CN23.</fr></lang>
    GetLabelRequest:
      type: object
      properties:
        parcelNumber:
          type: string
          description: <i>AN13</i> <br/>  <lang><en>Parcel number</en><fr>Numéro de colis.</fr></lang>
        outputPrintingType:
          type: string
          description: <i>L</i> <br/> <lang><en>Label printing format.</en><fr>Format d'impression des étiquettes.</fr></lang>
    MediaType:
      type: object
      properties:
        type:
          type: string
        subtype:
          type: string
        parameters:
          type: object
          additionalProperties:
            type: string
        wildcardType:
          type: boolean
        wildcardSubtype:
          type: boolean
    Link:
      type: object
      properties:
        uriBuilder:
          $ref: '#/components/schemas/UriBuilder'
        rel:
          type: string
        rels:
          type: array
          items:
            type: string
        title:
          type: string
        params:
          type: object
          additionalProperties:
            type: string
        type:
          type: string
        uri:
          type: string
          format: uri
    ReplacementValue:
      type: object
      properties:
        field:
          type: string
        value:
          type: string
        key:
          type: string
        translatable:
          type: boolean
    CustomizationFields:
      type: object
      properties:
        reference:
          type: array
          items:
            $ref: '#/components/schemas/CustomizationTemplate'
        customizationField:
          type: array
          items:
            $ref: '#/components/schemas/CustomizationField'
      description: <i>SUB</i> <br/>  <lang><en></en><fr>Ce bloc peut être utilisé pour personnaliser la partie inféririeure de l'étiquette <br/> </fr></lang>
      xml:
        name: customizationFields
    CommandInfo:
      type: object
      properties:
        commandClass:
          type: string
        commandName:
          type: string
    PlanPickupSender:
      required:
      - zipCode
      type: object
      properties:
        companyName:
          type: string
          description: <i>AN35</i> <br/>  <lang><en>Company name</en><fr>Raison sociale.</fr></lang>
        lastName:
          type: string
          description: <i>AN35</i> <br/>  <lang><en>Last name</en><fr>Nom.</fr></lang>
        firstName:
          type: string
          description: <i>AN29</i> <br/>  <lang><en>First name</en><fr>Prénom.</fr></lang>
        line0:
          type: string
          description: <i>AN35</i> <br/>  <lang><en>Floor, corridor, stairwell, flat number</en><fr>Etage, couloir, escalier, appartement.</fr></lang>
        line1:
          type: string
          description: <i>AN35</i> <br/>  <lang><en>Entrance, building, residence. </en><fr>Entrée, b&acirc;timent, immeuble, résidence.</fr></lang>
        line2:
          type: string
          description: '<i>AN35</i> <br/>  <lang><en>Number and street name. <br/><br/>Example: "5 rue du Bellay"</en><fr>Numéro et libellé de voie. <br/><br/>Example: \"5 rue du Bellay\"</fr></lang>'
        line3:
          type: string
          description: <i>AN35</i> <br/>  <lang><en>Named place or other mention</en><fr>Lieu-dit ou autre mention.</fr></lang>
        city:
          type: string
          description: <i>AN35</i> <br/>  <lang><en>Municipality</en><fr>Commune.</fr></lang>
        zipCode:
          type: string
          description: <i>AN5</i> <br/>  <lang><en>Postcode</en><fr>Code postal.</fr></lang>
        countryCode:
          type: string
          description: <i>A2</i> <br/>  <lang><en>Only the "FR" value is authorised. <br/>Country code.</en><fr>Code pays.<br/><br/>Seule la valeur « <b>FR</b> » est autorisée.</fr></lang>
        email:
          type: string
          description: <i>AN80</i> <br/>  <lang><en>Email address. <br/>Used for sending tracking notifications to addressees.</en><fr>Adresse courriel. <br/><br/> Utilisé pour les notifications de suivi aux destinataires.</fr></lang>
        phoneNumber:
          type: string
          description: <i>AN15</i> <br/>  <lang><en>Telephone</en><fr>Téléphone.</fr></lang>
      description: <i>SUB</i> <br/>  <lang><en>Block containing sender's address</en><fr>Bloc contenant les coordonnées du déposant en retour.</fr></lang>
    GetProductInterResponse:
      type: object
      properties:
        messages:
          type: array
          items:
            $ref: '#/components/schemas/Message'
        product:
          type: array
          items:
            type: string
        partnerType:
          type: string
        returnTypeChoice:
          type: array
          items:
            type: string
    GenerateLabelRequest:
      required:
      - letter
      - outputFormat
      type: object
      properties:
        contractNumber:
          type: string
          description: <i>AN</i> <br/>  <lang><en>Deprecated. Use apikey instead as explained in "Acess to the Web Service SLS/API Authentication".</en><fr>Obsolète. Utiliser l'apikey à la place comme expliqué dans "Accès au Web Service SLS/Authentification API".</fr></lang>
        password:
          type: string
          description: <i>AN</i> <br/>  <lang><en>Deprecated. Use apikey instead as explained in "Acess to the Web Service SLS/API Authentication".</en><fr>Obsolète. Utiliser l'apikey à la place comme expliqué dans "Accès au Web Service SLS/Authentification API".</fr></lang>
        outputFormat:
          $ref: '#/components/schemas/OutputFormat'
        letter:
          $ref: '#/components/schemas/Letter'
        fields:
          $ref: '#/components/schemas/Fields'
        customizationFields:
          $ref: '#/components/schemas/CustomizationFields'
    GetListMailBoxPickingDatesResponse:
      type: object
      properties:
        messages:
          type: array
          items:
            $ref: '#/components/schemas/Message'
        mailBoxPickingDateMaxHour:
          type: string
        mailBoxPickingDates:
          type: array
          items:
            type: string
            format: date-time
        validityTime:
          type: string
    ActivationDataFlavor:
      type: object
      properties:
        mimeType:
          type: string
        humanPresentableName:
          type: string
    Article:
      required:
      - description
      - quantity
      - value
      - weight
      type: object
      properties:
        description:
          type: string
          description: <i>AN1…64</i> <br/>  <lang><en>Detailed description of the article. Appears on CN23 document.<br/>Must be in English for the US and for shipments with the DDP option.</en><fr>Description détaillée de l’article. <br/> Apparaît sur le fichier CN23. <br/>Obligatoirement en anglais pour les US et pour les envois avec l'option DDP</fr></lang>
        quantity:
          type: integer
          description: <i>N</i> <br/>  <lang><en>Number of articles of this type. Appears on CN23 document.</en><fr>Nombre d’articles de ce type. <br/> Apparaît sur le fichier CN23. </fr></lang>
          format: int32
        weight:
          type: number
          description: <i>N</i> <br/>  <lang><en>Unitary net weight of the articles in kg. Appears on CN23 document.</en><fr>Poids net unitaire des articles en kg. <br/> Apparaît sur le fichier CN23. </fr></lang>
          format: float
        value:
          type: number
          description: <i>N</i> <br/>  <lang><en>Unitary value of articles in EUROS.<br/>Appears on CN23 document.</en><fr>Valeur unitaire des articles en EURO. <br/> Apparaît sur le fichier CN23.</fr></lang>
          format: float
        hsCode:
          type: string
          description: <i>N6, N8 ou N10</i> <br/>  <lang><en>Mandatory if is 3 (commercial shipment). <br/>Mandatory for 7R and 5R return products. Then its size must be 6 or 11.<br/><br/>Tariff number corresponding to the article. It will be necessary to indicate 6, 8 or 10 digits for the international shipments requiring a customs declaration. <br/><br/>Appears on CN23 document.</en><fr>Numéro tarifaire correspondant à l’article. <br/><br/> Il faudra indiquer 6, 8 ou 10 chiffres pour les envois à l’international nécessitant une déclaration douani&egrave;re.  <br/> Un code erreur 30519 apparaîtra dans la réponse du Web Service si la balise est mal renseignée. <br/><br/> Obligatoire si category vaut 3 (envoi commercial). <br/><br/> Obligatoire pour les produits retours 7R et 5R. Il doit être de taille 6 ou 11 <br/><br/> Apparaît sur le fichier CN23. </fr></lang>
        originCountry:
          type: string
          description: <i>A2</i> <br/>  <lang><en>ISO code of the country of origin of the article. <br/><br/> Mandatory for 7R and 5R return products. It must be identical for all declared articles.<br/><br/> Mandatory if category = 3 (commercial shipment). <br/><br/>Country name appears on CN23 document. <br/><br/> If filled in, check that the country code is A2 otherwise set FR by default. <br/>If the country code is different from the format A2, the WS sls will return an error.</en><fr>Code ISO du pays d’origine de l’article. <br/><br/> Obligatoire pour les produits retours 7R et 5R. Il doit être identique pour tous les articles déclarés <br/><br/>  Obligatoire si category=3 (envoi commercial) <br/><br/> Le nom du pays apparait en entier sur le fichier CN23. <br/><br/> Si non vide, vérifier que le code pays est sur A2 sinon mettre FR par défaut.  <br/><br/> Si le code pays est différent du format A2, le WS sls retournera une erreur</fr></lang>
        originCountryLabel:
          type: string
          description: <lang><en>Label</en><fr>Libellé</fr></lang>
        currency:
          type: string
          description: <i>AN3</i> <br/>  <lang><en>Set EUR by default if empty<br/><br/>Mandatory for 7R and 5R return products.<br/><br/>The currency must be the same for all declared articles. It must belong to the list {USD, EUR, CHF, GBP, CNY, JPY, CAD, AUD}. If the currency is different from the list above, the Web Service will return an error.|</en><fr>Devise. <br/><br/>Fixé par défaut en EUR si vide<br/><br/>Obligatoire pour les produits de retour 7R et 5R.<br/><br/>La devise doit être la même pour tous les articles déclarés. Elle doit appartenir à la liste {USD, EUR, CHF, GBP, CNY, JPY, CAD, AUD}. Si la devise est différente de la liste ci-dessus, le service web renverra une erreur.</fr></lang>
        artref:
          type: string
          description: <i>AN1...35</i> <br/>  <lang><en>Mandatory for 7R and 5R return products.<br/><br/>Article reference, serial number.</en><fr>Référence de l’article, numéro de s&eacute;rie. <br/><br/> Obligatoire pour les produits retours inter (7R) hors UE et 5R (OM).</fr></lang>
        originalIdent:
          type: string
          description: '<i>A1</i> <br/>  <lang><en>Mandatory for 7R and 5R return products. <br/><br/>Key for identifying the outgoing invoice and the parcel related to the article.<br/><br/>Link up the parcel number with its sequencing: <br/><ul><li>if the article belongs to the 1st parcel, indicate A; </li><li>If the article belongs to the 3rd parcel, indicate C;</li><li>etc</li></ul></en><fr>Clé permettant d’identifier la facture aller et le colis lié à l’article. <br/><br/> Obligatoire pour les produits retours inter (7R) hors UE et 5R(OM). <br/> Appairer le numéro de colis avec son ordonnancement : <br/> <ul> <li>si l’article appartient au 1er colis, indiquer A ;</li> <li>si l’article appartient au 3ème colis, indiquer C ;</li> <li>etc …</li> </ul> </fr></lang>'
        vatAmount:
          type: number
          description: <i>N</i> <br/>  <lang><en>VAT on items</en><fr>TVA des articles</fr></lang>
          format: float
        customsFees:
          type: number
          description: <i>N</i> <br/>  <lang><en>Customs duties on items</en><fr>Droits Douane des articles</fr></lang>
          format: float
      description: <i>SUB</i> <br/>  <lang><en>The block can be repeated up to 100 times.</en><fr>Le bloc article peut être répété jusqu’à 100 fois.</fr></lang>
    GenerateLabelRequestV31:
      required:
      - letter
      - outputFormat
      type: object
      properties:
        contractNumber:
          type: string
          description: <i>AN</i> <br/>  <lang><en>Deprecated. Use apikey instead as explained in "Acess to the Web Service SLS/API Authentication".</en><fr>Obsolète. Utiliser l'apikey à la place comme expliqué dans "Accès au Web Service SLS/Authentification API".</fr></lang>
        password:
          type: string
          description: <i>AN</i> <br/>  <lang><en>Deprecated. Use apikey instead as explained in "Acess to the Web Service SLS/API Authentication".</en><fr>Obsolète. Utiliser l'apikey à la place comme expliqué dans "Accès au Web Service SLS/Authentification API".</fr></lang>
        outputFormat:
          $ref: '#/components/schemas/OutputFormat'
        letter:
          $ref: '#/components/schemas/LetterRequestV31'
        fields:
          $ref: '#/components/schemas/Fields'
        customizationFields:
          $ref: '#/components/schemas/CustomizationFields'
    Sender:
      type: object
      properties:
        senderParcelRef:
          type: string
          description: <i>AN1...17</i> <br/>  <lang><en>Sender Order Number.<br/>It displays the customer reference only on the label. This data is not reflected in the Colissimo IT System and will not be visible in OSC.</en><fr>Référence de commande de l’expéditeur. <br/> <b>Elle permet d’afficher la référence client seulement sur l’étiquette.</b><br/>  <b>Cette donnée n’est pas remontée dans le SI Colissimo et ne sera pas visible dans l'outil de Suivi Colis.</b>  </fr></lang>
        address:
          $ref: '#/components/schemas/Address'
      description: <i>SUB</i> <br/>  <lang><en></en><fr></fr></lang>
    BelgiumLabel:
      type: object
      properties:
        codeVAS:
          $ref: '#/components/schemas/CodeVAS'
        identification:
          type: string
        codeBarre:
          type: string
        returnAddress:
          $ref: '#/components/schemas/ReturnAddressBelgium'
    GetProductInterRequest:
      required:
      - productCode
      type: object
      properties:
        contractNumber:
          type: string
          description: <i>AN</i> <br/>  <lang><en>Deprecated. Use apikey instead as explained in "Acess to the Web Service SLS/API Authentication".</en><fr>Obsolète. Utiliser l'apikey à la place comme expliqué dans "Accès au Web Service SLS/Authentification API".</fr></lang>
        password:
          type: string
          description: <i>AN</i> <br/>  <lang><en>Deprecated. Use apikey instead as explained in "Acess to the Web Service SLS/API Authentication".</en><fr>Obsolète. Utiliser l'apikey à la place comme expliqué dans "Accès au Web Service SLS/Authentification API".</fr></lang>
        productCode:
          type: string
          description: <i>A</i> <br/>  <lang><en></en><fr></fr></lang>
        insurance:
          type: boolean
          description: <i>B</i> <br/>  <lang><en>Assured Value. <br/><br/> By default, enter "false" (or "0").</en><fr>Valeur Assur&eacute;e.<br/><br/> Par défaut passer à "false" (ou "0"). </fr></lang>
        nonMachinable:
          type: boolean
          description: <i>B</i> <br/>  <lang><en>Parcel format. <br/><br/> By default, enter "false" (or "0"). <br/><br/>   Enter "true" (or "1") to indicate that the parcel format is nonstandard (non-machinable). </en><fr>Format du colis. <br/><br/> Par défaut, passer à "false" (ou "0"). <br/><br/>Passer à "true" (ou "1") pour indiquer que le format du colis est non standard (non mécanisable). </fr></lang>
        returnReceipt:
          type: boolean
          description: <i>B</i> <br/>  <lang><en>Advice of receipt.<br/><br/> By default, enter "false" (or "0"). </en><fr>Avis de réception. <br/><br/> Par défaut, passer à "false" (ou "0"). </fr></lang>
        countryCode:
          type: string
          description: '<i>A2</i> <br/>  <lang><en>ISO code of the country of destination.<br/><br/>Example: "DE" for Germany.</en><fr>Code ISO du pays de destination <br/><br/> Exemple : « DE » pour Allemagne. </fr></lang>'
        zipCode:
          type: string
          description: <i>AN</i> <br/>  <lang><en>Addressee postcode.</en><fr>Code postal de destination.</fr></lang>
        city:
          type: string
          description: <i>AN35</i> <br/>  <lang><en>Not used (La Poste internal use only)</en><fr>Non utilisé (usage interne à la poste seulement)</fr></lang>
    Message:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
        messageContent:
          type: string
    MessageRest:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
        messageContent:
          type: string
        replacementValues:
          type: array
          items:
            $ref: '#/components/schemas/ReplacementValue'
    LetterRequestV31:
      required:
      - addressee
      - parcel
      - service
      type: object
      properties:
        service:
          $ref: '#/components/schemas/Service'
        parcel:
          $ref: '#/components/schemas/ParcelRequestV31'
        customsDeclarations:
          $ref: '#/components/schemas/CustomsDeclarations'
        sender:
          $ref: '#/components/schemas/Sender'
        addressee:
          $ref: '#/components/schemas/Addressee'
        codSenderAddress:
          $ref: '#/components/schemas/Address'
      description: '<i>SUB</i> <br/>  <lang><en>This block contains tags and blocks related to the shipment (options, parcel, sender, addressee, customs).<br/>List sub-bocks (described below): <br/><ul><li>Service: type of product and prices, </li><li>Parcel: insurances and options, </li><li>Sender: sender,</li><li>Addressee: addressee, </li><li>CustomsDeclarations: customs.</li></ul></en><fr>Ce bloc contient des balises et blocs liés à l’expédition (options, colis, expéditeur, destinataire, douanes).<br/><br/>Liste des sous-blocs (décrits plus bas) : <br/><ul><li>Service : type de produit et tarifs, </li><li>Parcel : assurances et options, </li><li>Sender : expéditeur ou déposant en retour </li><li>Addressee : destinataire,</li><li>CustomsDeclarations : douanes.</li></ul></fr></lang>'
    Contents:
      type: object
      properties:
        article:
          type: array
          description: <i>SUB</i> <br/>  <lang><en>The block can be repeated up to 100 times.</en><fr>Le bloc article peut être répété jusqu’à 100 fois.</fr></lang>
          items:
            $ref: '#/components/schemas/Article'
        category:
          $ref: '#/components/schemas/Category'
        original:
          type: array
          description: <i>SUB</i> <br/>  <lang><en></en><fr>Bloc contenant le (ou les) set(s) de données Original. <br/> Obligatoire pour les produits retours inter (7R) hors UE et 5R (OM). <br/> Au plus 5 sets de données Original sont agréés.<br/> Les colis sont identifiés selon l’ensemble </fr></lang>
          items:
            $ref: '#/components/schemas/Original'
        explanations:
          type: string
          description: <i>AN1…35</i> <br/>  <lang><en></en><fr>A renseigner si la catégorie « retour de marchandise » ou « Autre » est choisie (cf. 0)</fr></lang>
      description: <lang><en>This block represents the type of shipment and list of articles to declare.<br/>Mandatory if articles are eligible for the CN23 form.</en><fr>Ce bloc représente la nature de l’envoi et liste des articles à déclarer. <br/> Obligatoire si les envois sont éligibles à la CN23. </fr></lang>
    generateBordereauParcelNumberList:
      required:
      - parcelsNumbers
      type: object
      properties:
        parcelsNumbers:
          type: array
          description: <lang><en>List of parcel numbers</en><fr>Liste de numéros de colis</fr></lang>
          items:
            type: string
            description: <lang><en>List of parcel numbers</en><fr>Liste de numéros de colis</fr></lang>
      description: <lang><en>List of parcel numbers</en><fr>Liste de numéros de colis</fr></lang>
    Letter:
      required:
      - addressee
      - parcel
      - service
      type: object
      properties:
        service:
          $ref: '#/components/schemas/Service'
        parcel:
          $ref: '#/components/schemas/ParcelRequestV2'
        customsDeclarations:
          $ref: '#/components/schemas/CustomsDeclarations'
        sender:
          $ref: '#/components/schemas/Sender'
        addressee:
          $ref: '#/components/schemas/Addressee'
        codSenderAddress:
          $ref: '#/components/schemas/Address'
      description: '<i>SUB</i> <br/>  <lang><en>This block contains tags and blocks related to the shipment (options, parcel, sender, addressee, customs).<br/>List sub-bocks (described below): <br/><ul><li>Service: type of product and prices, </li><li>Parcel: insurances and options, </li><li>Sender: sender,</li><li>Addressee: addressee, </li><li>CustomsDeclarations: customs.</li></ul></en><fr>Ce bloc contient des balises et blocs liés à l’expédition (options, colis, expéditeur, destinataire, douanes).<br/><br/>Liste des sous-blocs (décrits plus bas) : <br/><ul><li>Service : type de produit et tarifs, </li><li>Parcel : assurances et options, </li><li>Sender : expéditeur ou déposant en retour </li><li>Addressee : destinataire,</li><li>CustomsDeclarations : douanes.</li></ul></fr></lang>'
    Field:
      required:
      - key
      - value
      type: object
      properties:
        key:
          type: string
          description: <i>A</i> <br/>  <lang><en>Key word to be informed</en><fr>Mot clef à renseigner</fr></lang>
        value:
          type: string
          description: <i>AN32</i> <br/>  <lang><en>The expected value is the order identifier in the SI Colissimo.</en><fr>Valeur attendue dans l'ordre identifié du SI Colissimo</fr></lang>
    PlanPickupRequest:
      required:
      - mailBoxPickingDate
      - parcelNumber
      - sender
      type: object
      properties:
        contractNumber:
          type: string
          description: <i>AN</i> <br/>  <lang><en>Deprecated. Use apikey instead as explained in "Acess to the Web Service SLS/API Authentication".</en><fr>Obsolète. Utiliser l'apikey à la place comme expliqué dans "Accès au Web Service SLS/Authentification API".</fr></lang>
        password:
          type: string
          description: <i>AN</i> <br/>  <lang><en>Deprecated. Use apikey instead as explained in "Acess to the Web Service SLS/API Authentication".</en><fr>Obsolète. Utiliser l'apikey à la place comme expliqué dans "Accès au Web Service SLS/Authentification API".</fr></lang>
        parcelNumber:
          type: string
          description: <i>AN13</i> <br/>  <lang><en>Parcel number</en><fr>Numéro de colis.</fr></lang>
        mailBoxPickingDate:
          type: string
          description: '<i>D</i> <br/>  <lang><en>Requested pick-up date. <br/><br/>Example: "2022-06-25"</en><fr>Date d’emport demandée.<br/><br/>Example: \"2022-06-25\"</fr></lang>'
          format: date-time
        sender:
          $ref: '#/components/schemas/PlanPickupSender'
    Service:
      required:
      - depositDate
      - productCode
      type: object
      properties:
        productCode:
          type: string
          description: '<i>L</i> <br/>  <lang><en>Code indicating the desired product.<br/>Example: code <b>CORE</b> for Colissimo Return.<br/>If the tag is:<br/><ul><li><b>HD</b>, the tag pickupLocationId must be entered,</li><li><b>DOM or DOS</b>, the tag pickupLocationId should not be entered.</li></ul></en><fr>Code désignant l’offre produit souhaitée. <br/><br/> Exemple : code <b>CORE</b> pour Colissimo Retour. <br/><br/>  Si la balise vaut : <ul><li><b>HD</b> la balise pickupLocationId doit être renseignée,</li> <li><b>DOM</b> ou <b>DOS</b>, la balise pickupLocationId ne doit pas être renseignée.</li></ul></fr></lang>'
        depositDate:
          type: string
          description: '<i>D</i> <br/>  <lang><en>Scheduled deposit date in the La Poste network.Example: "2022-06-25".</en><fr>Date de dépôt prévisionnelle dans le réseau La Poste. <br/><br/> Exemple : "2022-06-25"</fr></lang>'
          format: date-time
        mailBoxPicking:
          type: boolean
          description: '<i>B</i> <br/>  <lang><en>Default: false<br/>Used if the tag <productCode> is <b>CORE (8R) or CORF (CQ).</b><br/><br/>Use if the former recipient of the parcel wishes to return it by placing it in his mailbox (offer “return mailbox”).<br/>Enter "true" (or "1") so that the parcel, returned by its former recipient, can be collected by a Colissimo agent from the mailbox of the former recipient.</en><fr>Demander la collecte du colis retourné à partir d''une boîte aux lettres (retour BAL).<br/><br/> Utilisé pour autoriser le retour des colis en boîte aux lettres. <br/><br/>  Utilisé pour le code <b>CORE (8R)</b><br/> et <b>CORF (CQ).</b>  <br/><br/>  Par défaut, renseigner "false" (ou "0"). <br/><br/> Doit valoir "true" (ou "1") pour que le colis retourné par son ancien destinataire puisse être collecté par un agent de Colissimo à partir de la boîte aux lettres de l’ancien destinataire. </fr></lang>'
        mailBoxPickingDate:
          type: string
          description: '<i>D</i> <br/>  <lang><en>Used if the tag <productCode> is <b>CORE (8R) or CORF (CQ).</b><br/>Mandatory only if mailBoxPicking is "true" (or "1").<br/>Date requested for picking up from the mailbox.<br/>Example: "2022-06-25".<br/>To find out the next available date, call the getListMailBoxPickingDates method.<br/></en><fr>Date d’emport en boîte aux lettres demandée.<br/><br/> Utilisé pour le code <b>CORE (8R)</b> et <b>CORF (CQ).</b><br/><br/> Obligatoire (et pris en compte) seulement si mailBoxPicking vaut "true" (ou "1"). <br/><br/> Exemple : 2015-12-23 <br/>  Pour connaître la prochaine date possible, appeler la méthode getListMailBoxPickingDates .  </fr></lang>'
          format: date-time
        vatCode:
          type: integer
          description: <i>N</i> <br/>  <lang><en>Not used (La Poste internal use only)</en><fr>Non utilisé (utilisation interne à La Poste uniquement)</fr></lang>
          format: int32
        vatPercentage:
          type: integer
          description: <i>N</i> <br/>  <lang><en>Not used (La Poste internal use only)</en><fr>Non utilisé (utilisation interne à La Poste uniquement)</fr></lang>
          format: int32
        vatAmount:
          type: integer
          description: <i>N</i> <br/>  <lang><en>Not used (La Poste internal use only)</en><fr>Non utilisé (utilisation interne à La Poste uniquement)</fr></lang>
          format: int32
        transportationAmount:
          type: integer
          description: '<i>N</i> <br/>  <lang><en>Default: false<br/><br/>Basic shipping price (carriage costs) without any options. In euro cents.<br/><br/>Example: 4530 for 45.30€.<br/>Does not appear in the CN23 form.<br/></en><fr>Prix du transport de base (frais de port) sans les options éventuelles. <br/><br/> En centièmes d’euro <br/> Exemple : 4530 pour 45,30€. <br/> Par défaut, passer à "0". <br/>  N’apparaît pas dans le formulaire CN23. </fr></lang>'
          format: int32
        totalAmount:
          type: integer
          description: '<i>N</i> <br/>  <lang><en>Mandatory for parcels requiring a CN23 declaration.<br/>Basic shipping price increased by the price of shipment options. In euro cents.<br/>Example: 4530 for 45.30€.<br/> Appears in the CN23 form in the "Frais de port" field.</en><fr>Prix du transport de base augmenté du prix des options de l’envoi. <br/><br/>Obligatoire pour les colis nécessitant une déclaration CN23. <br/><br/> En centièmes d’euro.<br/>  Exemple : 4530 pour 45,30€. <br/> Apparaît dans le formulaire CN23 dans le champ « Frais de port ». </fr></lang>'
          format: int32
        orderNumber:
          type: string
          description: <i>AN1…30</i> <br/>  <lang><en>Customer's order number.<br/>Does not appear on the label but will be included in the Colissimo IT System.<br/>Returned in tracking information.<br/>Can be useful for searching for parcels using this field in the OSC tracking system (appears in the "réf. client." field).</en><fr>Référence de commande du client. <br/><br/> <b>N’apparait pas sur l’étiquette mais est intégré dans le SI Colissimo.</b> <br/> <b>Renvoyée dans les fichiers de suivi de colis (EDI-Retour).</b> <br/><br/> Peut être utile pour rechercher des colis selon ce champ dans l'outil de Suivi Colis (apparaît dans le champ « réf. client »). </fr></lang>
        commercialName:
          type: string
          description: '<i>AN</i> <br/>  <lang><en>Commercial name of the shipper.<br/>The tag is:<br/><ul><li>Mandatory if tag <productCode> is <b>HD</b></li><li>Not mandatory if tag <productCode> is <b>DOM, DOS</b></li></ul>This name will be displayed in e-mail notifications sent to the parcel addressees.</en><fr>Nom commercial du chargeur.<br/><br/>  Cette balise : <br/> <ul><li><b>Est obligatoire si productCode vaut HD</b></li><li>Facultative si productCode vaut <b>DOM, DOS,</b></li></ul> <br/> Ce nom sera affiché dans les notifications par e-mail faites aux destinataires des colis.  </fr></lang>'
        returnTypeChoice:
          type: integer
          description: '<i>L</i> <br/>  <lang><en>Indicates whether the parcel must be returned to the sender in case of non-delivery of the parcel.<br/>Mandatory for certain international parcels, according to the applicable tariff areas.</en><fr>Indique si le colis doit être retourné à l’expéditeur en cas de <span style=''text-decoration: underline;text-decoration-style: double;''>non distribution</span> du colis. <br/><br/> Obligatoire pour certains colis à l’international selon les zones tarifaires applicables. </fr></lang>'
          format: int32
        reseauPostal:
          type: string
          description: <i>B</i> <br/>  <lang><en>This parameter enables the possibility to choose the network responsible of the shipping (DPD or the local postal network), for international shipments.  <br/> <ul><li><b>reseauPostal = 0 => Select DPD network</b></li><li><b>reseauPostal = 1 => Select local postal network</b></li></ul></en><fr>Ce paramètre permet de choisir le réseau postal responsable de la livraison (DPD ou réseau postal local) pour tout envoi de colis à l’international parmi les pays concernés et sur les produits concernés. <br/><br/> <ul><li><b>reseauPostal = 0 => Choix DPD</b></li> <li><b>reseauPostal = 1 => Choix réseau postal local</b></li></ul> <br/><br/> Le code erreur <b>30027</b> s’affiche lorsqu’un réseau postal (DPD ou réseau postal local) est choisit pour un produit qui ne comporte par l’option sélectionnée.  </fr></lang>
      description: <i>SUB</i> <br/>  <lang><en></en><fr></fr></lang>
    PickupLocation:
      type: object
      properties:
        pointId:
          type: string
        name:
          type: string
        address:
          $ref: '#/components/schemas/AddressPickupLocation'
        groupRouting:
          type: string
        serviceLabel:
          type: string
        sortDistribution:
          type: string
        routingZipCode:
          type: string
        netWork:
          type: string
        idPartenaire:
          type: string
        routingFileVersion:
          type: string
    ZoneRouting:
      type: object
      properties:
        zoneCABRoutage:
          $ref: '#/components/schemas/ZoneCABRoutage'
        zoneInfosRoutage:
          $ref: '#/components/schemas/ZoneInfosRoutage'
    XmlV2Response:
      type: object
      properties:
        parcelNumber:
          type: string
        parcelNumberPartner:
          type: string
        contractNumber:
          type: string
        sitePCH:
          $ref: '#/components/schemas/Site'
        pickupLocation:
          $ref: '#/components/schemas/PickupLocation'
        sender:
          $ref: '#/components/schemas/Sender'
        addressee:
          $ref: '#/components/schemas/Addressee'
        routing:
          $ref: '#/components/schemas/Routing'
        zoneRouting:
          $ref: '#/components/schemas/ZoneRouting'
        belgiumLabel:
          $ref: '#/components/schemas/BelgiumLabel'
        barCodePCH:
          type: string
        numberPCH:
          type: string
        barCodeCityssimo:
          type: string
        barCodeRouting:
          type: string
        numberRouting:
          type: string
        swissLabel:
          $ref: '#/components/schemas/SwissLabel'
        hazmat:
          $ref: '#/components/schemas/DataHandler'
        elementVisual:
          type: array
          items:
            $ref: '#/components/schemas/ElementVisual'
        cabAztec:
          type: string
        fields:
          $ref: '#/components/schemas/Fields'
    NewCookie:
      type: object
      properties:
        name:
          type: string
        value:
          type: string
        version:
          type: integer
          format: int32
        path:
          type: string
        domain:
          type: string
        comment:
          type: string
        maxAge:
          type: integer
          format: int32
        expiry:
          type: string
          format: date-time
        secure:
          type: boolean
        httpOnly:
          type: boolean
        sameSite:
          type: string
          enum:
          - NONE
          - LAX
          - STRICT
    Category:
      type: object
      properties:
        value:
          type: integer
          description: <i>N1</i> <br/>  <lang><en>Mandatory for products subject to a CN23 form.<br/>Type of shipment.</en><fr>Nature de l'envoi. <br/>Obligatoire pour les produits soumis à la CN23.</fr></lang>
          format: int32
      description: <i>SUB</i> <br/>  <lang><en>Mandatory for products subject to a CN23 form. <br/><br/>Block containing the tag related to the nature of the shipment.</en><fr>Bloc contenant la balise liée à la nature de l’envoi. <br/><br/> Obligatoire pour les produits soumis à la CN23.</fr></lang>
    AddressPickupLocation:
      type: object
      properties:
        line1:
          type: string
        line2:
          type: string
        line3:
          type: string
        line4:
          type: string
        zipCode:
          type: string
        city:
          type: string
        countryCode:
          type: string
        countryLabel:
          type: string
    StatusType:
      type: object
      properties:
        reasonPhrase:
          type: string
        family:
          type: string
          enum:
          - INFORMATIONAL
          - SUCCESSFUL
          - REDIRECTION
          - CLIENT_ERROR
          - SERVER_ERROR
          - OTHER
        statusCode:
          type: integer
          format: int32
    ReturnAddressBelgium:
      type: object
      properties:
        mention:
          type: string
        line1:
          type: string
        line2:
          type: string
    CustomizationField:
      type: object
      properties:
        type:
          type: string
        x:
          type: integer
          format: int32
        y:
          type: integer
          format: int32
        taille:
          type: string
        value:
          type: string
    GenerateCN23Request:
      required:
      - letter
      type: object
      properties:
        contractNumber:
          type: string
          description: <i>AN</i> <br/>  <lang><en>Deprecated. Use apikey instead as explained in "Acess to the Web Service SLS/API Authentication".</en><fr>Obsolète. Utiliser l'apikey à la place comme expliqué dans "Accès au Web Service SLS/Authentification API".</fr></lang>
        password:
          type: string
          description: <i>AN</i> <br/>  <lang><en>Deprecated. Use apikey instead as explained in "Acess to the Web Service SLS/API Authentication".</en><fr>Obsolète. Utiliser l'apikey à la place comme expliqué dans "Accès au Web Service SLS/Authentification API".</fr></lang>
        letter:
          $ref: '#/components/schemas/Letter'
        fields:
          $ref: '#/components/schemas/Fields'
    GetListMailBoxPickingDatesRetourRequest:
      required:
      - sender
      type: object
      properties:
        contractNumber:
          type: string
          description: <i>AN</i> <br/>  <lang><en>Deprecated. Use apikey instead as explained in "Acess to the Web Service SLS/API Authentication".</en><fr>Obsolète. Utiliser l'apikey à la place comme expliqué dans "Accès au Web Service SLS/Authentification API".</fr></lang>
        password:
          type: string
          description: <i>AN</i> <br/>  <lang><en>Deprecated. Use apikey instead as explained in "Acess to the Web Service SLS/API Authentication".</en><fr>Obsolète. Utiliser l'apikey à la place comme expliqué dans "Accès au Web Service SLS/Authentification API".</fr></lang>
        sender:
          $ref: '#/components/schemas/GetListMailBoxPickingDatesSender'
    DataSource:
      type: object
      properties:
        name:
          type: string
        inputStream:
          type: object
        contentType:
          type: string
        outputStream:
          type: object
    GetListMailBoxPickingDatesSender:
      required:
      - zipCode
      type: object
      properties:
        line0:
          type: string
          description: <i>AN35</i> <br/>  <lang><en>Floor, corridor, stairwell, flat number</en><fr>Etage, couloir, escalier, appartement.</fr></lang>
        line1:
          type: string
          description: <i>AN35</i> <br/>  <lang><en>Entrance, building, residence. </en><fr>Entrée, b&acirc;timent, immeuble, résidence.</fr></lang>
        line2:
          type: string
          description: '<i>AN35</i> <br/>  <lang><en>Number and street name. <br/><br/>Example: "5 rue du Bellay"</en><fr>Numéro et libellé de voie.<br/><br/>Example: \"5 rue du Bellay\"</fr></lang>'
        line3:
          type: string
          description: <i>AN35</i> <br/>  <lang><en>Named place or other mention</en><fr>Lieu-dit ou autre mention.</fr></lang>
        city:
          type: string
          description: <i>AN35</i> <br/>  <lang><en>Municipality</en><fr>Commune.</fr></lang>
        zipCode:
          type: string
          description: <i>AN5</i> <br/>  <lang><en>Postcode</en><fr>Code postal.</fr></lang>
        countryCode:
          type: string
          description: <i>A2</i> <br/>  <lang><en>Only the "FR" value is authorised. <br/>Country code.</en><fr>Code pays.<br/>Seule la valeur « FR » est autorisée.</fr></lang>
      description: <i>SUB</i> <br/>  <lang><en>Block containing sender's address</en><fr>Bloc contenant les coordonnées du déposant en retour.</fr></lang>
    GenerateBordereauByParcelsNumbersRequest:
      type: object
      properties:
        contractNumber:
          type: string
          description: <i>N6</i> <br/>  <lang><en>Account number</en><fr>Numéro de compte</fr></lang>
        password:
          type: string
          description: <i>AN</i> <br/>  <lang><en>Password</en><fr>mot de passe</fr></lang>
        generateBordereauParcelNumberList:
          $ref: '#/components/schemas/generateBordereauParcelNumberList'
        fields:
          $ref: '#/components/schemas/Fields'
    CustomizationTemplate:
      type: object
      properties:
        customizableReferenceKey:
          type: integer
          format: int32
        customizableReferenceValue:
          type: string
    AddressPCH:
      type: object
      properties:
        line0:
          type: string
        line1:
          type: string
        line2:
          type: string
        line3:
          type: string
        zipCode:
          type: string
        city:
          type: string
        countryCode:
          type: string
    OutputFormat:
      required:
      - outputPrintingType
      - x
      - y
      type: object
      properties:
        x:
          type: integer
          description: '<i>N-9999…9999</i> <br/> <lang><en>By default, enter "false" (or "0"). <br/>Allows horizontal adjustment of printing on the label (expressed in points): <br/><ul><li>if x < 0: the label is shifter to the right</li><li>if x > 0: the label is shifted to the left</li></ul></en><fr>Par défaut, mettre à "false" (ou "0"). <br/>Permet d’ajuster le décalage horizontal de l’impression sur l’étiquette (exprimé en points): <br/><ul><li>si x < 0: l''étiquette est décalée à droite.</li><li>si x > 0: l''étiquette est décalée à gauche.</li></ul></fr></lang>'
          format: int32
        y:
          type: integer
          description: '<i>N-120…120</i> <br/> <lang><en>By default, enter "false" (or "0"). <br/>Allows vertical adjustment of printing on the label (expressed in points): <br/><ul><li>if y < 0: the label is shifter up</li><li>if y > 0: the label is shifted down</li></ul></en><fr>Par défaut, mettre à "false" (ou "0"). <br/>Permet d’ajuster le décalage vertical de l’impression sur l’étiquette (exprimé en points) : <br/><ul><li>si y < 0: l''étiquette est décalée en haut.</li><li>si y > 0: l''étiquette est décalée en bas.</li></ul></fr></lang>'
          format: int32
        outputPrintingType:
          type: string
          description: <i>L</i> <br/> <lang><en>Label printing format.</en><fr>Format d'impression des étiquettes.</fr></lang>
        dematerialized:
          type: boolean
          description: <i>B</i> <br/> <lang><en>Not used (La Poste internal use only)</en><fr>Non utilisé (utilisation interne à La Poste uniquement)</fr></lang>
        returnType:
          type: string
          description: '<i>L</i> <br/> <lang><en>Used if the tag productCode is <b>CORE (8R)</b> or <b>CORF (CQ).</b><br/><br/>Defines the label transmission mode. By default, the label is sent in the Web Service response only.<br/>Possible values:<br/><ul><li>SendPDFByMail: the label is also sent by email, as an attachment, to the address indicated in the “sender block”.</li><li>SendPDFLinkByMail: the label is also sent by email, as a hypertext link, to the address indicated in the “sender block”.</li></ul></en><fr>Définit le mode de transmission de l’étiquette.</b></b> Utilisé pour le Colissimo Retour uniquement.</b>Par défaut, l’étiquette est envoyée uniquement dans la réponse du Web Service.</b></b> Valeurs possibles : <br/><ul><li>SendPDFByMail : l’étiquette est également envoyée par e-mail en tant que pièce jointe à l’adresse renseignée dans le bloc « sender ».</li> <li>SendPDFLinkByMail : l’étiquette est également envoyée par e-mail sous forme de lien hypertexte à l’adresse renseignée dans le bloc « sender ».</li></ul> </fr></lang>'
        printCODDocument:
          type: boolean
          description: '<i>B</i> <br/> <lang><en>Allow you to print the CRBT document <br/><br/> Default: false</en><fr>Permettre d’imprimer le document CRBT <br/>Par défaut : false</fr></lang>'
      description: <i>SUB</i> <br/>  <lang><en>This block contains the sub-tags linked to the format of the data sent by the Web Service</en><fr>Ce bloc contient les balises liées au format des éditions renvoyées par le Web Service.</fr></lang>
    GenerateLabelV2Response:
      type: object
      properties:
        messages:
          type: array
          items:
            $ref: '#/components/schemas/MessageRest'
        labelXmlV2Reponse:
          $ref: '#/components/schemas/XmlV2Response'
        labelV2Response:
          $ref: '#/components/schemas/LabelV2Response'
    ZoneCABRoutage:
      type: object
      properties:
        barCodeRouting:
          type: string
        parcelNumberRouting:
          type: string
    UriBuilder:
      type: object
    ElementVisual:
      type: object
      properties:
        name:
          type: string
        shortcut:
          type: string
        position:
          type: string
    ZoneInfosRoutage:
      type: object
      properties:
        trackingNumberRouting:
          type: string
        controlKeyTrackingNumber:
          type: string
        getrDepot:
          type: string
        identificationDestination1:
          type: string
        identificationDestination2:
          type: string
        serviceMark:
          type: string
        typeServiceLivraison:
          type: string
        sortOrigin:
          type: string
        sortDest:
          type: string
        routingVersion:
          type: string
        datePrinting:
          type: string
        hourPrinting:
          type: string
        numberVersionWS:
          type: string
        msort:
          type: string
    EntityTag:
      type: object
      properties:
        value:
          type: string
        weak:
          type: boolean
    Original:
      type: object
      properties:
        originalIdent:
          type: string
          description: '<i>A1</i> <br/>  <lang><en>Mandatory for 7R and 5R return products. <br/><br/>Key for identifying the invoice and outgoing parcel related to the article.<br/>Link up the parcel number with its sequencing: <br/><ul><li>if the article belongs to the 1st parcel, indicate A;</li><li>If the article belongs to the 3rd parcel, indicate C; </li><li>etc.</li></ul></en><fr>Clé permettant d’identifier la facture et colis aller liés à l’article. <br/><br/> Obligatoire pour les produits retours inter (7R) hors UE et 5R(OM). <br/><br/> Appairer le numéro de colis avec son ordonnancement :<br/><ul> <li>si l’article appartient au 1er colis, indiquer A ;</li> <li>si l’article appartient au 3ème colis, indiquer C ;</li> <li>etc …</li> </ul> </fr></lang>'
        originalInvoiceNumber:
          type: string
          description: <i>AN1...35</i> <br/>  <lang><en>Mandatory for a return parcel.<br/><br/>Original invoice number for a return parcel.</en><fr>Numéro de la facture d’origine du colis. <br/><br/> Obligatoire pour un colis Retour.</fr></lang>
        originalInvoiceDate:
          type: string
          description: <i>AN10</i> <br/>  <lang><en>Mandatory for a return parcel. <br/><br/>Original invoice date for a return parcel. YYYY-MM-DD format is expected. The date must be before or the same as today’s date</en><fr>Date de la facture d’origine du colis. <br/><br/> Obligatoire pour un colis Retour. <br/><br/> Format attendu AAAA-MM-JJ. <br/><br/> Doit être antérieure ou égale à la date du jour.</fr></lang>
          format: date-time
        originalParcelNumber:
          type: string
          description: <i>AN1...35</i> <br/>  <lang><en>Mandatory for a return parcel.<br/><br/>Original parcel number.</en><fr>Numéro de colis d’origine.<br/><br/>Obligatoire pour un colis Retour. </fr></lang>
      description: <lang><en>Mandatory for 7R and 5R return products. <br/><br/>Block containing Original data set(s).<br/>Up to 5 Original data sets are approved. Packages are identified all together with the 5 Original sets</en> <fr>Bloc contenant le (ou les) set(s) de données Original. <br/><br/> Obligatoire pour les produits retours inter (7R) hors UE et 5R (OM). <br/><br/> Au plus 5 sets de données Original sont agréés.<br/><br/> Les colis sont identifiés selon l’ensemble </fr></lang>
    CheckGenerateLabelRequest:
      required:
      - letter
      type: object
      properties:
        contractNumber:
          type: string
          description: <i>AN</i> <br/>  <lang><en>Deprecated. Use apikey instead as explained in "Acess to the Web Service SLS/API Authentication".</en><fr>Obsolète. Utiliser l'apikey à la place comme expliqué dans "Accès au Web Service SLS/Authentification API".</fr></lang>
        password:
          type: string
          description: <i>AN</i> <br/>  <lang><en>Deprecated. Use apikey instead as explained in "Acess to the Web Service SLS/API Authentication".</en><fr>Obsolète. Utiliser l'apikey à la place comme expliqué dans "Accès au Web Service SLS/Authentification API".</fr></lang>
        letter:
          $ref: '#/components/schemas/Letter'
        outputFormat:
          $ref: '#/components/schemas/OutputFormat'
        fields:
          $ref: '#/components/schemas/Fields'
        customizationFields:
          $ref: '#/components/schemas/CustomizationFields'