# Slouží ke spojení sad zásilek

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /shipment/batch/connectSet:
    post:
      summary: Slouží ke spojení sad zásilek
      deprecated: false
      description: >
        Tato metoda slouží ke spojování zásilek do sady.


        K tomu, aby bylo možné slučovat zásilky do sady je nutné abyste při
        zakládání zásilky, kterou budete chtít později sloučit do sady, uvedli v
        request body [POST
        shipment/batch](https://ppl-cpl-api.apidog.io/vytvo%C5%99en%C3%AD-z%C3%A1silky-13465914e0)
        do externích čísel kód **ESPN**. Takto vytvořenou zásilku bude možné
        slučovat pomocí této metody do sady s dalšími stejně založenými
        zásilkami.


        **Podmínky pro slučování**

        - lze slučovat zásilky pouze stejného productType

        - lze slučovat i zásilky, které už byli založeny v sadě

        - nelze slučovat zásilky s dobírkou

        - zásilky lze slučovat pouze do doby dokud nejsou převedeny do fyzického
        stavu (oskenování při naložení)

        - nelze slučovat zásilky produktu Smart2Box

        - lze slučovat pouze zásilky posílané v rámci Česke republiky a
        zahraniční zásilky pro produkt COPL(PPL Parcel Connect Plus)


        :::caution[]

        Výše uvedené podmínky musí splňovat všechny spojované zásilky. Pokud ne,
        neproběhne ani částečné spojení a metoda se vyhodnotí jako chybná.

        :::


        <TipInfo>Pro lepší představu procesu spojování nahlédněte do
        [příkladů](https://ppl-cpl-api.apidog.io/spojov%C3%A1n%C3%AD-z%C3%A1silek-1603047m0),
        kde je detailně popsáno spojení zásilek.</TipInfo>

            
         
      operationId: ConnectSet
      tags:
        - API Metody/ShipmentBatch
        - ShipmentBatch
      parameters:
        - name: Accept-Language
          in: header
          description: 'Language specification, default language: cs-CZ'
          required: false
          example: ''
          schema:
            type: object
            properties: {}
            x-apidog-orders: []
            x-apidog-ignore-properties: []
        - name: X-Correlation-ID
          in: header
          description: Correlation Id of request
          required: false
          example: ''
          schema:
            type: object
            properties: {}
            x-apidog-orders: []
            x-apidog-ignore-properties: []
        - name: X-LogLevel
          in: header
          description: The forced log level
          required: false
          example: ''
          schema:
            type: object
            properties: {}
            x-apidog-orders: []
            x-apidog-ignore-properties: []
      requestBody:
        content:
          application/json-patch+json:
            schema:
              $ref: >-
                #/components/schemas/Eps.Api.MyApi2.Web.Models.ShipmentBatch.ConnectHierarchyModel
            example:
              externalSetNumber: string
              shipmentNumbers:
                - string
                - string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Eps.Api.MyApi2.Web.Models.ShipmentBatch.ConnectHierarchyResultModel
          headers:
            X-Correlation-ID:
              description: Correlation Id of request otherwise id of response
              schema:
                $ref: '#/components/schemas/XCorrelationIdSchema'
          x-apidog-name: OK
        '400':
          description: BadRequest
          content:
            application/problem+json:
              schema:
                type: object
                properties: {}
                x-apidog-orders: []
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: Bad Request
        '401':
          description: Unauthorized
          content:
            application/problem+json:
              schema:
                type: object
                properties: {}
                x-apidog-orders: []
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: Unauthorized
        '403':
          description: Forbidden
          content:
            application/problem+json:
              schema:
                type: object
                properties: {}
                x-apidog-orders: []
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: Forbidden
        '409':
          description: Conflict
          content:
            application/problem+json:
              schema:
                type: object
                properties: {}
                x-apidog-orders: []
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: '409'
        '500':
          description: InternalServerError
          content:
            application/problem+json:
              schema:
                type: object
                properties: {}
                x-apidog-orders: []
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: Server Error
        '503':
          description: ServiceUnavailable
          content:
            application/problem+json:
              schema:
                type: object
                properties: {}
                x-apidog-orders: []
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: Service Unavailable
      security: []
      x-apidog-folder: API Metody/ShipmentBatch
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/796227/apis/api-20708621-run
components:
  schemas:
    Eps.Api.MyApi2.Web.Models.ShipmentBatch.ConnectHierarchyModel:
      required:
        - externalSetNumber
        - shipmentNumbers
      type: object
      properties:
        externalSetNumber:
          minLength: 1
          type: string
          description: >-
            Extení číslo pro sadu zásilek. 

            Je to stejné číslo které vkládáte v shipment/batch do hodnoty klíče
            externalNumber
        shipmentNumbers:
          type: array
          items:
            type: string
          description: Čísla zásilek která mají tvořit sadu
          minItems: 2
      additionalProperties: false
      description: Connection hierarchy model
      x-apidog-orders:
        - externalSetNumber
        - shipmentNumbers
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    Eps.Api.MyApi2.Web.Models.ShipmentBatch.ConnectHierarchyResultModel:
      type: object
      properties:
        masterShipmentNumber:
          type: string
          description: Číslo nosne zásilky
          nullable: true
        shipmentNumbers:
          type: array
          items:
            type: string
          description: Seznam všech spojených zásilek
          nullable: true
      additionalProperties: false
      description: Represents the result of a hierarchy connection operation.
      x-apidog-orders:
        - masterShipmentNumber
        - shipmentNumbers
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes:
    oauth2:
      type: apikey
      description: Get access token from authentication server.
      name: Authorization
      in: header
    Bearer:
      type: jwt
      description: >-
        JWT Authorization header using the Bearer scheme. Example:
        "Authorization: Bearer {token}"
      scheme: bearer
      bearerFormat: JWT
servers: []
security: []

```