# Allegro

> Run your Allegro shop: list and edit offers, end or activate them, process orders and add tracking numbers, answer buyers and ratings, and start workflows when orders, offers, messages or ratings change.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/allegro

## Actions

### Add tracking number

Add a parcel tracking number to an order, for all of its items or only some. The buyer sees it on the order.

**Inputs**

- Order ID (`order_id`, text, required): The order's id, from 'List orders', a trigger or an earlier step.
- Carrier (`carrier_id`, text, required): Who delivers the parcel. Choose Other for a carrier not listed.
- Tracking number (`waybill`, text, required): The parcel's tracking number, up to 64 characters.
- Carrier name (`carrier_name`, text): The carrier's name, up to 30 characters. Needed only when the carrier is Other.
- Line item IDs (`line_item_ids`, list): The order's line items in this parcel. Leave empty for every item.

**Outputs**

- `order_id` (text): The order
- `shipment` (object): The tracking number added

**Example output**

```json
{
  "order_id": "29b9b8d0-8e3f-11ee-9a1c-0b5d2f6c7a10",
  "shipment": {
    "carrierId": "INPOST",
    "carrierName": null,
    "createdAt": "2026-11-06T12:00:00.000Z",
    "id": "c4b2a1d0-1111-4222-8333-944455556666",
    "lineItems": [
      {
        "id": "62ae358b-8f65-4fc4-9c77-bedf604a2e2b"
      }
    ],
    "waybill": "620123456789012345678901"
  }
}
```

### Answer rating

Publish your answer under a buyer's rating. Allegro has no way to remove an answer afterwards.

**Inputs**

- Rating ID (`rating_id`, text, required): The rating's id, from 'List ratings' or the New rating trigger.
- Answer (`message`, text, required): Your answer, up to 500 characters.

**Outputs**

- `answer` (object): The answer as published
- `rating_id` (text): The rating answered

**Example output**

```json
{
  "answer": {
    "createdAt": "2026-11-06T12:00:00.000Z",
    "message": "Thank you!"
  },
  "rating_id": "a6c6f6a0-5b3e-4d6a-9e1f-0c2b3d4e5f60"
}
```

### Change offer status

End offers, or activate them now or at a set time, up to 1,000 at once. Allegro does this in the background: check the result with 'Get offer status change'.

**Inputs**

- Offers (`offer_ids`, list, required): The offers to change.
- Change (`change`, text, required): End the offers, or activate them. One of: `END` (End (stop selling)), `ACTIVATE` (Activate (start selling)).
- Activate at (`scheduled_for`, date and time): When to activate them. Leave empty for now. Only when Change is Activate (start selling).

**Outputs**

- `command_id` (text): The id to check with 'Get offer status change'
- `report` (object): Allegro's summary so far

**Example output**

```json
{
  "command_id": "8f3c2a1e-5b7d-4c9a-9e10-2f6b8d4a7c11",
  "report": {
    "completedAt": null,
    "createdAt": "2026-11-06T10:00:00.000Z",
    "id": "8f3c2a1e-5b7d-4c9a-9e10-2f6b8d4a7c11",
    "taskCount": {
      "failed": 0,
      "success": 0,
      "total": 1
    }
  }
}
```

### Delete message

Delete a message you sent in Message Center.

**Inputs**

- Message ID (`message_id`, text, required): The message's id, from 'Reply in thread' or 'List messages'.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `message_id` (text): The message deleted

**Example output**

```json
{
  "deleted": true,
  "message_id": "a2a5a3c4-0d3e-4f5b-8c2d-1e0f9a8b7c6d"
}
```

### Get account

Get the Allegro account the connection signs in as: login, name, email, company, base marketplace, and whether it is a Sandbox account.

**Inputs**: None.

**Outputs**

- `environment` (text): production or sandbox
- `user` (object): The connected Allegro account

**Example output**

```json
{
  "environment": "production",
  "user": {
    "baseMarketplace": {
      "id": "allegro-pl"
    },
    "company": {
      "name": "Mug Shop Sp. z o.o.",
      "taxId": "7781234567"
    },
    "email": "anna@example.com",
    "features": [],
    "firstName": "Anna",
    "id": "40981111",
    "lastName": "Nowak",
    "login": "mug_shop"
  }
}
```

### Get offer

Get all of one offer's details: title, category, price, stock, publication status, images and parameters.

**Inputs**

- Offer (`offer_id`, text, required): The offer. Pick one, or give its id from an earlier step.

**Outputs**

- `offer` (object): The offer

**Example output**

```json
{
  "offer": {
    "category": {
      "id": "74203"
    },
    "external": {
      "id": "MUG-350-BLUE"
    },
    "id": "7680011223",
    "images": [
      "https://a.allegroimg.com/original/12068b/359d04074521"
    ],
    "language": "pl-PL",
    "name": "Ceramic coffee mug 350 ml blue",
    "publication": {
      "endingAt": null,
      "startingAt": null,
      "status": "ACTIVE"
    },
    "sellingMode": {
      "format": "BUY_NOW",
      "price": {
        "amount": "49.99",
        "currency": "PLN"
      }
    },
    "stock": {
      "available": 12,
      "unit": "UNIT"
    }
  }
}
```

### Get offer status change

See how an earlier 'Change offer status' went: whether it has finished, and which offers changed or failed and why.

**Inputs**

- Command ID (`command_id`, text, required): The command_id from 'Change offer status'.

**Outputs**

- `command_id` (text): The command read
- `failed` (number): Offers that could not be changed
- `finished` (true/false): Whether Allegro has finished
- `report` (object): Allegro's summary
- `succeeded` (number): Offers changed
- `tasks` (list): One result per offer

**Example output**

```json
{
  "command_id": "8f3c2a1e-5b7d-4c9a-9e10-2f6b8d4a7c11",
  "failed": 0,
  "finished": true,
  "report": {
    "completedAt": "2026-11-06T10:00:05.000Z",
    "createdAt": "2026-11-06T10:00:00.000Z",
    "id": "8f3c2a1e-5b7d-4c9a-9e10-2f6b8d4a7c11",
    "taskCount": {
      "failed": 0,
      "success": 1,
      "total": 1
    }
  },
  "succeeded": 1,
  "tasks": [
    {
      "field": "publication",
      "message": "",
      "offer": {
        "id": "7680011223"
      },
      "status": "SUCCESS"
    }
  ]
}
```

### Get order

Get one order's details: buyer, items, payment, delivery address or pickup point, invoice details and seller status.

**Inputs**

- Order ID (`order_id`, text, required): The order's id, from 'List orders', a trigger or an earlier step.

**Outputs**

- `order` (object): The order

**Example output**

```json
{
  "order": {
    "buyer": {
      "companyName": null,
      "email": "abc123+jan_kowalski@allegromail.pl",
      "firstName": "Jan",
      "guest": false,
      "id": "40981234",
      "lastName": "Kowalski",
      "login": "jan_kowalski",
      "phoneNumber": "+48 500 600 700"
    },
    "delivery": {
      "address": {
        "city": "Pozna\u0144",
        "countryCode": "PL",
        "firstName": "Jan",
        "lastName": "Kowalski",
        "phoneNumber": "+48 500 600 700",
        "street": "Grunwaldzka 182",
        "zipCode": "60-166"
      },
      "cost": {
        "amount": "8.99",
        "currency": "PLN"
      },
      "method": {
        "id": "1fa56f79-4b6a-4821-a6f2-ca9c16d5c925",
        "name": "InPost"
      },
      "pickupPoint": {
        "id": "POZ08A",
        "name": "Paczkomat POZ08A"
      }
    },
    "fulfillment": {
      "shipmentSummary": {
        "lineItemsSent": "NONE"
      },
      "status": "NEW"
    },
    "id": "29b9b8d0-8e3f-11ee-9a1c-0b5d2f6c7a10",
    "lineItems": [
      {
        "boughtAt": "2026-11-06T09:58:00.000Z",
        "id": "62ae358b-8f65-4fc4-9c77-bedf604a2e2b",
        "offer": {
          "external": {
            "id": "MUG-350-BLUE"
          },
          "id": "7680011223",
          "name": "Ceramic coffee mug 350 ml blue"
        },
        "originalPrice": {
          "amount": "49.99",
          "currency": "PLN"
        },
        "price": {
          "amount": "49.99",
          "currency": "PLN"
        },
        "quantity": 1
      }
    ],
    "marketplace": {
      "id": "allegro-pl"
    },
    "messageToSeller": "Please pack carefully",
    "payment": {
      "finishedAt": "2026-11-06T09:59:00.000Z",
      "id": "0f8fad5b-d9cb-469f-a165-70867728950e",
      "paidAmount": {
        "amount": "58.98",
        "currency": "PLN"
      },
      "type": "ONLINE"
    },
    "revision": "819b5836",
    "status": "READY_FOR_PROCESSING",
    "summary": {
      "totalToPay": {
        "amount": "58.98",
        "currency": "PLN"
      }
    },
    "updatedAt": "2026-11-06T09:59:30.000Z"
  }
}
```

### List billing entries

List the fees and credits on your Allegro account (commissions, listing fees, refunds), newest first, with the balance after each.

**Inputs**

- From (`occurred_from`, date and time): Only entries at or after this time.
- Until (`occurred_to`, date and time): Only entries at or before this time.
- Types (`type_ids`, list): Only entries of these types. Leave empty for all.
- Offer (`offer_id`, text): Only entries for this offer.
- Order ID (`order_id`, text): Only entries for this order.
- How many (`limit`, number): How many to return, 1 to 100. Allegro's default is 100. From 1 to 100.
- Skip (`offset`, number): How many to skip first, to read the next page. At least 0.

**Outputs**

- `count` (number): How many were returned
- `entries` (list): The entries

**Example output**

```json
{
  "count": 1,
  "entries": [
    {
      "asset": "DEBIT",
      "balance": {
        "amount": "120.30",
        "currency": "PLN"
      },
      "id": "e7ae7f1e-7a9b-4c3d-8e2f-1a0b9c8d7e6f",
      "marketplaceId": "allegro-pl",
      "occurredAt": "2026-11-06T09:59:00.000Z",
      "offer": {
        "id": "7680011223",
        "name": "Ceramic coffee mug 350 ml blue"
      },
      "order": {
        "id": "29b9b8d0-8e3f-11ee-9a1c-0b5d2f6c7a10"
      },
      "type": {
        "id": "SUC",
        "name": "Sales commission"
      },
      "value": {
        "amount": "-5.50",
        "currency": "PLN"
      }
    }
  ]
}
```

### List categories

List Allegro's main categories, or the subcategories of one, with whether each is the lowest level (where offers are listed).

**Inputs**

- Parent category (`parent_id`, text): List this category's subcategories. Leave empty for the main categories.

**Outputs**

- `categories` (list): The categories
- `count` (number): How many were returned

**Example output**

```json
{
  "categories": [
    {
      "id": "5",
      "leaf": false,
      "name": "Dom i Ogr\u00f3d",
      "parent": null
    }
  ],
  "count": 1
}
```

### List message threads

List your Message Center conversations, most recent message first.

**Inputs**

- How many (`limit`, number): How many to return, 1 to 20. Allegro's default is 20. From 1 to 20.
- Skip (`offset`, number): How many to skip first, to read the next page. At least 0.

**Outputs**

- `count` (number): How many were returned
- `threads` (list): The threads

**Example output**

```json
{
  "count": 1,
  "threads": [
    {
      "id": "Fl1EnOeWJg3EFbz9V1Uo0TvnJnSNuPd5kIBCYAtCoGk",
      "interlocutor": {
        "avatarUrl": "https://a.allegroimg.com/avatar",
        "login": "jan_kowalski"
      },
      "lastMessageDateTime": "2026-11-06T11:00:00.000Z",
      "read": false
    }
  ]
}
```

### List messages

List the messages in a Message Center thread, newest first.

**Inputs**

- Thread (`thread_id`, text, required): The Message Center thread. Pick one, or give its id from an earlier step.
- Sent after (`after`, date and time): Only messages sent after this time.
- Sent before (`before`, date and time): Only messages sent before this time. Can't be used with Skip.
- How many (`limit`, number): How many to return, 1 to 20. Allegro's default is 20. From 1 to 20.
- Skip (`offset`, number): How many to skip first, to read the next page. At least 0.

**Outputs**

- `count` (number): How many were returned
- `messages` (list): The messages
- `thread_id` (text): The thread

**Example output**

```json
{
  "count": 1,
  "messages": [
    {
      "author": {
        "isInterlocutor": true,
        "login": "jan_kowalski"
      },
      "createdAt": "2026-11-06T11:00:00.000Z",
      "hasAdditionalAttachments": false,
      "id": "a2a5a3c4-0d3e-4f5b-8c2d-1e0f9a8b7c6d",
      "relatesTo": {
        "offer": {
          "id": "7680011223"
        },
        "order": {
          "id": "29b9b8d0-8e3f-11ee-9a1c-0b5d2f6c7a10"
        }
      },
      "status": "DELIVERED",
      "subject": null,
      "text": "Hello, when will my order ship?",
      "thread": {
        "id": "Fl1EnOeWJg3EFbz9V1Uo0TvnJnSNuPd5kIBCYAtCoGk"
      },
      "type": "MESSAGE_CENTER"
    }
  ],
  "thread_id": "Fl1EnOeWJg3EFbz9V1Uo0TvnJnSNuPd5kIBCYAtCoGk"
}
```

### List offers

List your offers, newest first unless sorted, with price, stock, sales and publication status. Filter by title, status, format, category or your own external id.

**Inputs**

- Title contains (`name`, text): Only offers whose title contains this text.
- Statuses (`statuses`, list): Only offers with any of these statuses. Leave empty for all. One or more of: `ACTIVE`, `ACTIVATING`, `INACTIVE` (Inactive (draft)), `ENDED`.
- Formats (`selling_formats`, list): Only offers sold in any of these formats. Leave empty for all. One or more of: `BUY_NOW` (Buy now), `AUCTION`, `ADVERTISEMENT` (Classified ad).
- External IDs (`external_ids`, list): Only offers with these ids from your own system (signature), up to 100.
- Category (`category_id`, text): Only offers in this category. Pick a main category or give a category id.
- Order (`sort`, text): How to sort. Allegro's default is newest offer first. One of: `-sellingMode.price.amount` (Highest price first), `sellingMode.price.amount` (Lowest price first), `-stock.sold` (Most sold first), `stock.sold` (Least sold first), `-stock.available` (Most in stock first), `stock.available` (Least in stock first).
- How many (`limit`, number): How many to return, 1 to 1000. Allegro's default is 20. From 1 to 1000.
- Skip (`offset`, number): How many to skip first, to read the next page. At least 0.

**Outputs**

- `count` (number): How many were returned
- `offers` (list): The offers
- `total_count` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "offers": [
    {
      "category": {
        "id": "74203"
      },
      "external": {
        "id": "MUG-350-BLUE"
      },
      "id": "7680011223",
      "name": "Ceramic coffee mug 350 ml blue",
      "primaryImage": {
        "url": "https://a.allegroimg.com/original/12068b/359d04074521"
      },
      "publication": {
        "endedAt": null,
        "endingAt": null,
        "startedAt": "2026-10-01T08:00:00.000Z",
        "status": "ACTIVE"
      },
      "sellingMode": {
        "format": "BUY_NOW",
        "price": {
          "amount": "49.99",
          "currency": "PLN"
        }
      },
      "stats": {
        "visitsCount": 210,
        "watchersCount": 4
      },
      "stock": {
        "available": 12,
        "sold": 3
      }
    }
  ],
  "total_count": 1
}
```

### List orders

List orders from the last 12 months, newest purchase first unless sorted, with buyer, items, payment, delivery and seller status.

**Inputs**

- Order status (`status`, text): Only orders in this state. Leave empty for all. One of: `READY_FOR_PROCESSING` (Paid, ready to process), `BOUGHT` (Bought, checkout not filled in), `FILLED_IN` (Checkout filled in, not paid), `CANCELLED`.
- Seller status (`fulfillment_status`, text): Only orders with this seller status. Leave empty for all. One of: `NEW`, `PROCESSING`, `READY_FOR_SHIPMENT` (Ready for shipment), `READY_FOR_PICKUP` (Ready for pickup), `SENT`, `PICKED_UP` (Picked up), `CANCELLED`, `SUSPENDED`, `RETURNED`.
- Bought from (`bought_from`, date and time): Only orders bought at or after this time.
- Bought until (`bought_to`, date and time): Only orders bought at or before this time.
- Updated from (`updated_from`, date and time): Only orders changed at or after this time.
- Updated until (`updated_to`, date and time): Only orders changed at or before this time.
- Buyer login (`buyer_login`, text): Only orders from the buyer with this Allegro login.
- Order (`sort`, text): How to sort. Allegro's default is newest purchase first. One of: `-lineItems.boughtAt` (Newest purchase first), `lineItems.boughtAt` (Oldest purchase first), `-updatedAt` (Most recently updated first), `updatedAt` (Least recently updated first).
- How many (`limit`, number): How many to return, 1 to 100. Allegro's default is 100. From 1 to 100.
- Skip (`offset`, number): How many to skip first, to read the next page. At least 0.

**Outputs**

- `count` (number): How many were returned
- `orders` (list): The orders
- `total_count` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "orders": [
    {
      "buyer": {
        "companyName": null,
        "email": "abc123+jan_kowalski@allegromail.pl",
        "firstName": "Jan",
        "guest": false,
        "id": "40981234",
        "lastName": "Kowalski",
        "login": "jan_kowalski",
        "phoneNumber": "+48 500 600 700"
      },
      "delivery": {
        "address": {
          "city": "Pozna\u0144",
          "countryCode": "PL",
          "firstName": "Jan",
          "lastName": "Kowalski",
          "phoneNumber": "+48 500 600 700",
          "street": "Grunwaldzka 182",
          "zipCode": "60-166"
        },
        "cost": {
          "amount": "8.99",
          "currency": "PLN"
        },
        "method": {
          "id": "1fa56f79-4b6a-4821-a6f2-ca9c16d5c925",
          "name": "InPost"
        },
        "pickupPoint": {
          "id": "POZ08A",
          "name": "Paczkomat POZ08A"
        }
      },
      "fulfillment": {
        "shipmentSummary": {
          "lineItemsSent": "NONE"
        },
        "status": "NEW"
      },
      "id": "29b9b8d0-8e3f-11ee-9a1c-0b5d2f6c7a10",
      "lineItems": [
        {
          "boughtAt": "2026-11-06T09:58:00.000Z",
          "id": "62ae358b-8f65-4fc4-9c77-bedf604a2e2b",
          "offer": {
            "external": {
              "id": "MUG-350-BLUE"
            },
            "id": "7680011223",
            "name": "Ceramic coffee mug 350 ml blue"
          },
          "originalPrice": {
            "amount": "49.99",
            "currency": "PLN"
          },
          "price": {
            "amount": "49.99",
            "currency": "PLN"
          },
          "quantity": 1
        }
      ],
      "marketplace": {
        "id": "allegro-pl"
      },
      "messageToSeller": "Please pack carefully",
      "payment": {
        "finishedAt": "2026-11-06T09:59:00.000Z",
        "id": "0f8fad5b-d9cb-469f-a165-70867728950e",
        "paidAmount": {
          "amount": "58.98",
          "currency": "PLN"
        },
        "type": "ONLINE"
      },
      "revision": "819b5836",
      "status": "READY_FOR_PROCESSING",
      "summary": {
        "totalToPay": {
          "amount": "58.98",
          "currency": "PLN"
        }
      },
      "updatedAt": "2026-11-06T09:59:30.000Z"
    }
  ],
  "total_count": 1
}
```

### List ratings

List the ratings buyers gave your sales, most recently changed first.

**Inputs**

- Recommended (`recommended`, text): Only positive or only negative ratings. Leave empty for both. One of: `true` (Recommended (positive)), `false` (Not recommended (negative)).
- Changed from (`changed_from`, date and time): Only ratings given or edited at or after this time.
- Changed until (`changed_to`, date and time): Only ratings given or edited at or before this time.
- How many (`limit`, number): How many to return, 1 to 100. Allegro's default is 20. From 1 to 100.
- Skip (`offset`, number): How many to skip first, to read the next page. At least 0.

**Outputs**

- `count` (number): How many were returned
- `ratings` (list): The ratings

**Example output**

```json
{
  "count": 1,
  "ratings": [
    {
      "answer": null,
      "buyer": {
        "id": "40981234",
        "login": "jan_kowalski"
      },
      "comment": {
        "language": "en-US",
        "text": "Fast delivery, great mug!"
      },
      "createdAt": "2026-11-05T18:00:00.000Z",
      "id": "a6c6f6a0-5b3e-4d6a-9e1f-0c2b3d4e5f60",
      "lastChangedAt": "2026-11-05T18:00:00.000Z",
      "order": {
        "id": "29b9b8d0-8e3f-11ee-9a1c-0b5d2f6c7a10"
      },
      "recommended": true
    }
  ]
}
```

### List tracking numbers

List the tracking numbers on an order, including ones added on allegro.pl or by the carrier.

**Inputs**

- Order ID (`order_id`, text, required): The order's id, from 'List orders', a trigger or an earlier step.

**Outputs**

- `count` (number): How many were returned
- `order_id` (text): The order
- `shipments` (list): The tracking numbers

**Example output**

```json
{
  "count": 1,
  "order_id": "29b9b8d0-8e3f-11ee-9a1c-0b5d2f6c7a10",
  "shipments": [
    {
      "carrierId": "INPOST",
      "carrierName": null,
      "createdAt": "2026-11-06T12:00:00.000Z",
      "id": "c4b2a1d0-1111-4222-8333-944455556666",
      "lineItems": [
        {
          "id": "62ae358b-8f65-4fc4-9c77-bedf604a2e2b"
        }
      ],
      "waybill": "620123456789012345678901"
    }
  ]
}
```

### Message a buyer

Start a Message Center conversation with the buyer of an order.

**Inputs**

- Buyer login (`buyer_login`, text, required): The buyer's Allegro login, from the order.
- Order ID (`order_id`, text, required): The order's id, from 'List orders', a trigger or an earlier step.
- Message (`text`, text, required): What to send, up to 2,000 characters.

**Outputs**

- `message` (object): The message sent

**Example output**

```json
{
  "message": {
    "author": {
      "isInterlocutor": false,
      "login": "mug_shop"
    },
    "createdAt": "2026-11-06T11:00:00.000Z",
    "hasAdditionalAttachments": false,
    "id": "a2a5a3c4-0d3e-4f5b-8c2d-1e0f9a8b7c6d",
    "relatesTo": {
      "offer": {
        "id": "7680011223"
      },
      "order": {
        "id": "29b9b8d0-8e3f-11ee-9a1c-0b5d2f6c7a10"
      }
    },
    "status": "DELIVERED",
    "subject": null,
    "text": "Hello, when will my order ship?",
    "thread": {
      "id": "Fl1EnOeWJg3EFbz9V1Uo0TvnJnSNuPd5kIBCYAtCoGk"
    },
    "type": "MESSAGE_CENTER"
  }
}
```

### Reply in thread

Send a message in an existing Message Center thread.

**Inputs**

- Thread (`thread_id`, text, required): The Message Center thread. Pick one, or give its id from an earlier step.
- Message (`text`, text, required): What to send, up to 2,000 characters.

**Outputs**

- `message` (object): The message sent

**Example output**

```json
{
  "message": {
    "author": {
      "isInterlocutor": false,
      "login": "mug_shop"
    },
    "createdAt": "2026-11-06T11:00:00.000Z",
    "hasAdditionalAttachments": false,
    "id": "a2a5a3c4-0d3e-4f5b-8c2d-1e0f9a8b7c6d",
    "relatesTo": {
      "offer": {
        "id": "7680011223"
      },
      "order": {
        "id": "29b9b8d0-8e3f-11ee-9a1c-0b5d2f6c7a10"
      }
    },
    "status": "DELIVERED",
    "subject": null,
    "text": "Hello, when will my order ship?",
    "thread": {
      "id": "Fl1EnOeWJg3EFbz9V1Uo0TvnJnSNuPd5kIBCYAtCoGk"
    },
    "type": "MESSAGE_CENTER"
  }
}
```

### Set order seller status

Set the seller status buyers see on an order, such as Processing or Sent.

**Inputs**

- Order ID (`order_id`, text, required): The order's id, from 'List orders', a trigger or an earlier step.
- Seller status (`status`, text, required): The new seller status. One of: `NEW`, `PROCESSING`, `READY_FOR_SHIPMENT` (Ready for shipment), `READY_FOR_PICKUP` (Ready for pickup), `SENT`, `PICKED_UP` (Picked up), `CANCELLED`, `SUSPENDED`.
- Order revision (`revision`, text): The order's revision from 'Get order'. When given, the change is refused if the order changed since.

**Outputs**

- `order_id` (text): The order changed
- `status` (text): The seller status set
- `updated` (true/false): Always true once set

**Example output**

```json
{
  "order_id": "29b9b8d0-8e3f-11ee-9a1c-0b5d2f6c7a10",
  "status": "PROCESSING",
  "updated": true
}
```

### Update offer

Change an offer's title, price, stock or external id. Only the fields you fill in change. Setting the stock of a live offer to 0 ends it.

**Inputs**

- Offer (`offer_id`, text, required): The offer. Pick one, or give its id from an earlier step.
- Title (`name`, text): A new title, up to 75 characters.
- Price (`price`, number): A new buy-now price, such as 49.99. At least 0.01.
- Currency (`currency`, text): The price's currency, such as PLN. Leave empty to keep the offer's currency.
- Stock (`stock`, number): How many are available to buy. At least 0.
- External ID (`external_id`, text): The offer's id in your own system (signature), up to 100 characters.

**Outputs**

- `changed` (list): The parts of the offer sent
- `offer` (object): The offer as edited (empty while processing)
- `offer_id` (text): The offer changed
- `operation_id` (text): Allegro's id for an edit still processing, else empty
- `status` (text): done, or processing when Allegro finishes the edit in the background

**Example output**

```json
{
  "changed": [
    "sellingMode",
    "stock"
  ],
  "offer": {
    "category": {
      "id": "74203"
    },
    "external": {
      "id": "MUG-350-BLUE"
    },
    "id": "7680011223",
    "images": [
      "https://a.allegroimg.com/original/12068b/359d04074521"
    ],
    "language": "pl-PL",
    "name": "Ceramic coffee mug 350 ml blue",
    "publication": {
      "endingAt": null,
      "startingAt": null,
      "status": "ACTIVE"
    },
    "sellingMode": {
      "format": "BUY_NOW",
      "price": {
        "amount": "49.99",
        "currency": "PLN"
      }
    },
    "stock": {
      "available": 12,
      "unit": "UNIT"
    }
  },
  "offer_id": "7680011223",
  "operation_id": "",
  "status": "done"
}
```
