# Spojování zásilek

Předpokladem pro úspěšné spojení zásilek je úvést při zakládání zásilky příznak additionallyAdded a externí číslo ESPN viz Zásilka 1.

<Accordion title="Zásilka 1" defaultOpen>
  ```
    {
    "returnChannel": {
        "type": "Email",
        "address": "jakub@test.cz"
    },
    "labelSettings": {
        "format": "Pdf",
        "dpi": 300,
        "completeLabelSettings": {
            "isCompleteLabelRequested": false
        }
    },
    "shipments": [
        {
            "referenceId": "123456",
            "productType": "BUSS",
            "note": "poznamka",
            "depot": "07",
            "shipmentSet": {
                "numberOfShipments": 1,
                "additionallyAdded": true
            },
            "sender": {
                "name": "Mirek test",
                "street": "Testovaci 222",
                "city": "Trutnov",
                "zipCode": "11000",
                "country": "CZ",
                "phone": "123456789",
                "email": "kuba@test.cz"
            },
            "recipient": {
                "name": "Test recipient",
                "street": "HLinska 2",
                "city": "České Budějovice",
                "zipCode": "37001",
                "country": "CZ",
                "phone": "1236547895",
                "email": "krab@test.cz"
            },
            "externalNumbers": [
                {
                    "externalNumber": "123",
                    "Code": "ESPN"
                }
            ]
        }
    ]
}
  ```
</Accordion>

Štítek takovéto zásilky bude mít následující podobu číslování.

![image.png](https://api.apidog.com/api/v1/projects/796227/resources/361381/image-preview)

Později jakmile se nashromáždí více zásilek připravených ke spojení bude vypadat body požadavku POST shipment/batch/connectSet pro spojování zásilek takto:


<Accordion title="request body" defaultOpen>
  ```
    {
    "externalSetNumber": "123",
    "shipmentNumbers": [
     "80050531022",
     "80050531023"
        
    ]
}
  ```
</Accordion>

Pokud budou zásilky splňovat všechny předpoklady pro úspěšné spojení, response body bude mít následující podobu.

<Accordion title="response body" defaultOpen>
  
  ```
    {
    "masterShipmentNumber": "80050531022",
    "shipmentNumbers": [
        "80050531022",
        "80050531023"
    ]
}
  ```
</Accordion>

v masterShipmentNumber je uvedena nosná zásilka a celý seznam zásilek je potom uveden v shipmentNumbers.