Skip to main content

Update existing parcel

PATCH 
/api/v1/order/:orderId/parcel/:parcelId

Updates existing parcel.

Request​

Path Parameters

    orderId stringrequired

    id of order this parcel belongs to

    parcelId stringrequired

    id of parcel to update.

Body

required

Parcel data to update.

    externalCreated date-time

    optional moment in time when was parcel created in external system.

    products string[]
    tags ParcelTag (string)[]

    Possible values: [TRACKING_SUSPENDED]

    dimensions

    object

    Parcel dimensions

    weight double

    weight in kg

    height int32

    height in cm

    length int32

    length in cm

    width int32

    width in cm

    deliveryDetails

    object

    Delivery details

    estimatedDeliveryDate date

    Date of estimated delivery

    delay

    object

    Delivery delay details

    delayed boolean

    If delivery is delayed

    reason string

    The reason for the delay

    tracking

    object[]

  • Array [

    • carrier Carrier (string)

    Possible values: [BUDBEE, CZECH_POST, DHL, DIY, DPD_CZ, DPD_SK, FEDEX, GEBRUDER_WEISS, GEIS, GLS, GLS_CZ, GLS_HR, GLS_HU, GLS_RO, GLS_SI, GLS_SK, INPOST, JAPO, KURIER_123, KURYR_123, LANDMARK, MESSENGER, PACKETA, PBH, PPL, SAMEDAY, SLOVAKIA_POST, SPRING_GDS, SPS, TOP_TRANS, ULOZENKA, UNKNOWN, UPS, WEDO, PERSONAL_PICKUP]

    carrier identifier

    number string

    tracking number in carrier tracking system. parcel is not tracked by Foxdeli until tracking number is provided

    referenceId string

    optional id to reference parcel in carrier tracking system

    carrierConfigurationId string

    id of carrier configuration in Foxdeli system. if no value is provided, Foxdeli attempts to use primary carrier configuration for given carrier while tracking parcel.

  • ]

Responses​

Parcel successfully updated.

Schema

    id uuidrequired

    identifier of parcel

    orderId uuidrequired

    id of order this parcel belongs to

    externalCreated date-time

    moment in time when was parcel created in external system.

    dimensions

    object

    Parcel dimensions

    weight double

    Package weight in kg

    height int32

    Package height in cm

    length int32

    Package length in cm

    width int32

    Package width in cm

    deliveryDetails

    object

    Delivery details

    estimatedDeliveryDate date

    Date of estimated delivery

    delay

    object

    Delivery delay details

    delayed boolean

    If delivery is delayed

    reason string

    The reason for the delay

    state

    object

    State of parcel

    delivery DeliveryState (string)

    Possible values: [CREATED, ESHOP_PROCESSING, MANUFACTURING, AVAILABLE_FROM_MANUFACTURER, PICKING, READY_TO_SEND, HANDED_TO_CARRIER, IN_TRANSIT, STORED_FOR_PICKUP, DELIVERED, RETURNED, LOST, CANCELLED, EXPIRED]

    state of delivery

    important ImportantState (string)deprecated

    Possible values: [BAD_RATING, MALFUNCTION, TIME_REASONS, ACT_OF_GOD, CARRIERS_FAULT, DAMAGED, NOT_REACHED, DISPOSITION_CHANGE, RETURNING, SLIGHTLY_DELAYED, NOT_PICKED_1DAY, NOT_PICKED_2DAYS, NOT_PICKED_3DAYS]

    optional important state assigned to parcel. value is not assigned if parcel is not marked as important

    urgent UrgentState (string)deprecated

    Possible values: [REJECTED_FOR_DELIVERY, REJECTED_TAKEOVER, INCORRECT_ADDRESS, OTHER, DELIVERY_DELAYED, NOT_PICKED_4DAYS, NOT_PICKED_5DAYS, LAST_DAY_FOR_PICKUP]

    optional urgent state assigned to parcel. value is not assigned if parcel is not marked as urgent

    deliverToday boolean

    is parcel being delivered today?

    returning boolean

    is parcel returning back to sender?

    trackingState TrackingState (string)

    Possible values: [AWAITING, SUSPENDED, TRACKING, MISSING_CREDENTIALS, INVALID_CREDENTIALS, MISSING_CARRIER_CONFIGURATION, INACTIVE_CARRIER_CONFIGURATION, EXPIRED, CANCELLED, MISSING_TRACKING_NUMBER, INVALID_TRACKING_NUMBER, UNKNOWN_TRACKING_NUMBER, DONE]

    State of parcel tracking

    maxStoreDate date-time

    deliveryWindow

    object

    time window described by two moments in time; beginning and end

    from date-time

    moment in time when time window starts

    to date-time

    moment in time when time window ends

    activeTracking

    object

    Tracking of parcel in specific carrier system

    trackingId uuidrequired

    identifier of this tracking

    carrier Carrier (string)required

    Possible values: [BUDBEE, CZECH_POST, DHL, DIY, DPD_CZ, DPD_SK, FEDEX, GEBRUDER_WEISS, GEIS, GLS, GLS_CZ, GLS_HR, GLS_HU, GLS_RO, GLS_SI, GLS_SK, INPOST, JAPO, KURIER_123, KURYR_123, LANDMARK, MESSENGER, PACKETA, PBH, PPL, SAMEDAY, SLOVAKIA_POST, SPRING_GDS, SPS, TOP_TRANS, ULOZENKA, UNKNOWN, UPS, WEDO, PERSONAL_PICKUP]

    carrier identifier

    number string

    tracking number in carrier system

    url string

    url of tracking page in carrier system

    referenceId string

    optional id to reference parcel in carrier tracking system

    carrierConfigurationId uuid

    optional id of carrier configuration in Foxdeli. Carrier configuration is used for communication with carrier api. If no value is provided and carrier requires authorization, primary carrier configuration for given carrier will be used.

    courierPhone string

    optional phone number of courier that is transporting parcel

    timeline

    object[]

    required

    Parcel timeline

  • Array [

    • timelineId uuid

    Unique id of record

    type TimelineType (string)

    Possible values: [NOTE, COMMUNICATION, ISSUE_COMMUNICATION, TRACKING, ISSUE_TRACKING]

    Type of timeline record

    text string

    Text of record

    created date-time

    moment in time when timeline record has been created

    author string

    author of record

    additionalParams

    object

    Additional parameters related to timeline record

    shippingEmail

    object

    details about email communication related to timeline records of type COMMUNICATION

    recipient string
    emailId uuid
    emailConfigId uuid
    campaignId uuid
    state WorkflowState (string)

    Possible values: [ORDER_ACCEPTED, ESHOP_PROCESSING, MANUFACTURING, AVAILABLE_FROM_MANUFACTURER, PICKING, REJECTED_FOR_DELIVERY, READY_TO_SEND, HANDED_TO_CARRIER, CARRIERS_FAULT, DAMAGED, NOT_REACHED, DISPOSITION_CHANGED, ORDER_DESTINATION_CHANGED, ESTIMATED_DELIVERY_DATE, ESTIMATED_DELIVERY_DATE_DELAY, SLIGHTLY_DELAYED, INCORRECT_ADDRESS, DELIVERY_DELAYED, IN_TRANSIT, CROSS_BORDER, DELIVERY_TODAY, READY_TO_PICKUP, READY_TO_PICKUP_BOX, READY_TO_PICKUP_RETAIL, NOT_PICKED_UP_1DAY, NOT_PICKED_UP_2DAYS, NOT_PICKED_UP_3DAYS, NOT_PICKED_UP_4DAYS, NOT_PICKED_UP_5DAYS, LAST_PICKUP_DAY, REJECTED_DELIVERY, RATING, RATING_1_STAR, RATING_2_STAR, RATING_3_STAR, RATING_4_STAR, RATING_5_STAR, RETURNING, RETURNED, LOST, CANCELLED, EXPIRED, MALFUNCTION, TIME_REASONS, ACT_OF_GOD, OTHER, DELIVERED]

    event EmailEventType (string)

    Possible values: [EMAIL_SENT, EMAIL_PROCESSED, EMAIL_DROPPED, EMAIL_DELIVERED, EMAIL_DEFERRED, EMAIL_BOUNCED, EMAIL_BLOCKED, EMAIL_OPENED, EMAIL_CLICKED, EMAIL_SPAM_REPORT, EMAIL_UNSUBSCRIBED, EMAIL_GROUP_UNSUBSCRIBED, EMAIL_GROUP_RESUBSCRIBED]

    type of event for email communication

    occurred date-time

    parcelState

    object

    descriptor of parcel state that is related to created tracking timeline entry

    delivery DeliveryState (string)

    Possible values: [CREATED, ESHOP_PROCESSING, MANUFACTURING, AVAILABLE_FROM_MANUFACTURER, PICKING, READY_TO_SEND, HANDED_TO_CARRIER, IN_TRANSIT, STORED_FOR_PICKUP, DELIVERED, RETURNED, LOST, CANCELLED, EXPIRED]

    state of delivery

    important ImportantState (string)deprecated

    Possible values: [BAD_RATING, MALFUNCTION, TIME_REASONS, ACT_OF_GOD, CARRIERS_FAULT, DAMAGED, NOT_REACHED, DISPOSITION_CHANGE, RETURNING, SLIGHTLY_DELAYED, NOT_PICKED_1DAY, NOT_PICKED_2DAYS, NOT_PICKED_3DAYS]

    optional important state assigned to parcel. value is not assigned if parcel is not marked as important

    urgent UrgentState (string)deprecated

    Possible values: [REJECTED_FOR_DELIVERY, REJECTED_TAKEOVER, INCORRECT_ADDRESS, OTHER, DELIVERY_DELAYED, NOT_PICKED_4DAYS, NOT_PICKED_5DAYS, LAST_DAY_FOR_PICKUP]

    optional urgent state assigned to parcel. value is not assigned if parcel is not marked as urgent

    deliverToday boolean

    is parcel being delivered today?

    returning boolean

    is parcel returning back to sender?

    parcelStateGroup string

    optional group identifier computed from parcel state to determine if two parcel states represent same logical parcel state

    parcelTrace

    object

    deprecated

    descriptor of parcel trace that is related to created tracking timeline entry. parcel trace is a container that holds tracking state fields provided by carrier tracking system.

    created date-time

    moment in time when was this trace created in foxdeli system

    occurred date-time

    moment in time when tracking event that represents this trace happened in carrier tracking system

    carrier Carrier (string)

    Possible values: [BUDBEE, CZECH_POST, DHL, DIY, DPD_CZ, DPD_SK, FEDEX, GEBRUDER_WEISS, GEIS, GLS, GLS_CZ, GLS_HR, GLS_HU, GLS_RO, GLS_SI, GLS_SK, INPOST, JAPO, KURIER_123, KURYR_123, LANDMARK, MESSENGER, PACKETA, PBH, PPL, SAMEDAY, SLOVAKIA_POST, SPRING_GDS, SPS, TOP_TRANS, ULOZENKA, UNKNOWN, UPS, WEDO, PERSONAL_PICKUP]

    carrier identifier

    trackingNumber string

    tracking number of parcel related to tracking event

    identifier string

    identifier of parcel tracking state in carrier tracking system

    text string

    optional text containing additional details related to state of parcel

    issueTracking

    object

    details about issue tracking related to timeline records of type ISSUE_TRACKING

    type string
    externalUrl string

  • ]

    • products string[]required

    Products from order that are contained in this parcel

    tags ParcelTag (string)[]required

    Possible values: [TRACKING_SUSPENDED]

    Optional tags assigned to parcel

    carrierTrackingUrl stringdeprecated

    Full url to courier's original tracking page. DEPRECATION NOTICE: marked for removal. use activeTracking.url instead.

    created date-time

    when was parcel created

    updated date-time

    when was parcel last updated

Loading...