---
updatedAt: 2025-06-04T20:05:56.000Z
agentTools:
  projectIndex: https://developers.plugg.to/llms.txt
---

# Update Order Tracking Status

## Example Request

```json 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".

```json 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",
            "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:

```json Example Return
{
    "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                                 |

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "api-pluggto",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.plugg.to"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/orders/plugg_id": {
      "put": {
        "summary": "Status Update",
        "description": "",
        "operationId": "status-update",
        "parameters": [
          {
            "name": "plugg_id",
            "in": "path",
            "description": "Order id",
            "schema": {
              "type": "string",
              "default": "plugg_id"
            },
            "required": true
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "Bearer Token",
            "schema": {
              "type": "string",
              "default": "Bearer {ACCESS_TOKEN}"
            }
          },
          {
            "name": "Content-Type",
            "in": "header",
            "schema": {
              "type": "string",
              "default": "application/json"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    },
    "/orders/plugg_Id": {
      "put": {
        "summary": "Update Order Tracking Status",
        "description": "",
        "operationId": "update-order-tracking-status",
        "parameters": [
          {
            "name": "plugg_id",
            "in": "path",
            "description": "Order id",
            "schema": {
              "type": "string",
              "default": "plugg_id"
            },
            "required": true
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "Bearer Token",
            "schema": {
              "type": "string",
              "default": "Bearer {ACCESS_TOKEN}"
            }
          },
          {
            "name": "Content-Type",
            "in": "header",
            "schema": {
              "type": "string",
              "default": "application/json"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```