Update Order Tracking Status

Example Request

{
    "status": "shipping_informed",
    "shipments": [
        {
            "id": "606b87e9e7cb7f1d4d5f8d33",
            "shipping_company": "Correios",
            "shipping_method": "PAC",
            "track_code": "QC123456729BR",
            "track_url": "https://correios.com.br",
            "date_shipped": "2024-07-17T18:14:00.000Z",
            "status": "shipped"
        }
    ]
}

Attention

It is important to send the id attribute to avoid duplicating delivery in the order.

Update tracking by item

Used for orders with multiple deliveries, separated by item. Currently used only in the Dafiti marketplace. Not visible on the front-end.

The fields added are "status" and "shipping_items".

{
    "status": "shipping_informed",
    "shipments": [
        {
            "id": "606b87e9e7cb7f1d4d5f8d33",
            "shipping_company": "Correios",
            "shipping_method": "PAC",
            "track_code": "QC123456729BR",
            "track_url": "https://correios.com.br",
            "date_shipped": "2024-07-17T18:14:00.000Z",
            "status": "shipped",
            "shipping_items": [ 
                {
                    "sku": "1776924",
                    "quantity": 1
                },
                {
                    "sku": "59657651",
                    "quantity": 1
                }
            ]
        },
        {
            "id":"669832655009d8e4d191b6fc",
            "shipping_company": "Correios",
            "shipping_method": "PAC",
            "track_code": "QC123456798BR",
            "track_url": "https://correios.com.br",
            "date_shipped": "2024-07-17T18:14:00.000Z",
            "status": "shipped",
            "shipping_items": [ 
                {
                    "sku": "1269821",
                    "quantity": 1
                }
            ]
        }
    ]
}

Reason for update failure

When you return the error:

{
    "error": true,
    "type": "not_updated",
    "message": "An error occurred, see details for more information.",
    "details": "Changes not found in the order"
}

It means that the order is already updated in the API Plugg.to, and it is not possible to send the same status.

Request object has the following properties:

Field	Type	Description
id	string	Id created in shipments after invoice update
shipping_company	string	Shipping company
shipping_method	string	Order shipping method
track_code	string	Package Tracking Number
track_url	string	Package Tracking URL
status (1)	string	Order update status
status (2)	string	Shipping action status
date_shipped	string	Date shipped