# Update the shipping label

It allows to update the shipping label of an existing transportation in the platform

Endpoint: PUT /shipping_labels
Version: 1.4.2
Security: bearerAuth

## Request fields (application/json):

  - `shopCode` (string)
    Shop code which belongs the shipment. In case this field is not informed, it will be obtained from security context. In case it is informed, it will be validated against the security context. This field is mandatory in case the token is associated with two or more merchants
    Example: "marchelacolombine"

  - `shipmentId` (string, required)
    ID of the shipment. The ID must exist in the platform. Platform will use this value to search the shipment whose status will be updated.
    Example: "64231-R1"

  - `shipmentIdType` (string, required)
    Type of ID that is being reported   RETURN_NAME - Name of the return. The last active shipment/transport will be searched. This value is generated by iF at the moment the return request is created. It has the format R#-{ORDER_NAME} (R1-64231)  CLIENT_REFERENCE - Shipping reference assigned for the shipment/transport. This value is generated by iF at the moment the transport is created. It has the format P#R#{MERCHANT-SHORT-CODE}{ORDER_NAME} (P1R1maco64231) * MERCHANT_RETURN_NAME - Name of the return in the ecommerce platform. The last active shipment/transport will be searched. This value is generated by the merchant system when the return is registered. The format is defined by the merchant (e.g. in Shopify the return name is 64231-R1)
    Enum: "RETURN_NAME", "CLIENT_REFERENCE", "MERCHANT_RETURN_NAME"

  - `shippingLabels` (array, required)
    List of shipping labels

  - `shippingLabels.carrierTrackingCode` (string, required)
    Reference assigned by the carrier to the shipment
    Example: "PARC0001"

  - `shippingLabels.additionalTrackingCodes` (array)
    Example: ["S4848554544545"]

  - `shippingLabels.carrierTrackingUrl` (string, required)
    URL for shipment tracking
    Example: "https://carrier.com/tracking/S4848554544545"

  - `shippingLabels.format` (string, required)
    Format of the label or free-label code
    Enum: "PDF", "ZPL", "PNG"

  - `shippingLabels.url` (string, required)
    URL for getting the shipping label
    Example: "https://if.com/shippping_label.pdf"

## Response 200 fields (application/json):

  - `statusCode` (string)
    Example: "200"

  - `description` (string)
    Example: "Your shipping label have been updated correctly"


## Response 400 fields

## Response 401 fields

## Response 404 fields

## Response 405 fields

## Response 500 fields