Allegro

App · 20 actions

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.

Actions

ActionWhat it does
Add tracking numberAdd a parcel tracking number to an order, for all of its items or only some.
Answer ratingPublish your answer under a buyer's rating.
Change offer statusEnd offers, or activate them now or at a set time, up to 1,000 at once.
Delete messageDelete a message you sent in Message Center.
Get accountGet the Allegro account the connection signs in as: login, name, email, company, base marketplace, and whether it is a Sandbox account.
Get offerGet all of one offer's details: title, category, price, stock, publication status, images and parameters.
Get offer status changeSee how an earlier 'Change offer status' went: whether it has finished, and which offers changed or failed and why.
Get orderGet one order's details: buyer, items, payment, delivery address or pickup point, invoice details and seller status.
List billing entriesList the fees and credits on your Allegro account (commissions, listing fees, refunds), newest first, with the balance after each.
List categoriesList Allegro's main categories, or the subcategories of one, with whether each is the lowest level (where offers are listed).
List message threadsList your Message Center conversations, most recent message first.
List messagesList the messages in a Message Center thread, newest first.
List offersList your offers, newest first unless sorted, with price, stock, sales and publication status.
List ordersList orders from the last 12 months, newest purchase first unless sorted, with buyer, items, payment, delivery and seller status.
List ratingsList the ratings buyers gave your sales, most recently changed first.
List tracking numbersList the tracking numbers on an order, including ones added on allegro.pl or by the carrier.
Message a buyerStart a Message Center conversation with the buyer of an order.
Reply in threadSend a message in an existing Message Center thread.
Set order seller statusSet the seller status buyers see on an order, such as Processing or Sent.
Update offerChange an offer's title, price, stock or external id.

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 IDorder_idtextRequired
The order's id, from 'List orders', a trigger or an earlier step.
Carriercarrier_idtextRequired
Who delivers the parcel. Choose Other for a carrier not listed.
Tracking numberwaybilltextRequired
The parcel's tracking number, up to 64 characters.
Carrier namecarrier_nametext
The carrier's name, up to 30 characters. Needed only when the carrier is Other.
Line item IDsline_item_idslist
The order's line items in this parcel. Leave empty for every item.

Outputs

order_idtext
The order
shipmentobject
The tracking number added
Example output
{
  "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 IDrating_idtextRequired
The rating's id, from 'List ratings' or the New rating trigger.
AnswermessagetextRequired
Your answer, up to 500 characters.

Outputs

answerobject
The answer as published
rating_idtext
The rating answered
Example output
{
  "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

Offersoffer_idslistRequired
The offers to change.
ChangechangetextRequired
End the offers, or activate them.One of: END (End (stop selling)), ACTIVATE (Activate (start selling)).
Activate atscheduled_fordate and time
When to activate them. Leave empty for now.Only when Change is Activate (start selling).

Outputs

command_idtext
The id to check with 'Get offer status change'
reportobject
Allegro's summary so far
Example output
{
  "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 IDmessage_idtextRequired
The message's id, from 'Reply in thread' or 'List messages'.

Outputs

deletedtrue/false
Always true once deleted
message_idtext
The message deleted
Example output
{
  "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

environmenttext
production or sandbox
userobject
The connected Allegro account
Example output
{
  "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

Offeroffer_idtextRequired
The offer. Pick one, or give its id from an earlier step.

Outputs

offerobject
The offer
Example output
{
  "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 IDcommand_idtextRequired
The command_id from 'Change offer status'.

Outputs

command_idtext
The command read
failednumber
Offers that could not be changed
finishedtrue/false
Whether Allegro has finished
reportobject
Allegro's summary
succeedednumber
Offers changed
taskslist
One result per offer
Example output
{
  "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 IDorder_idtextRequired
The order's id, from 'List orders', a trigger or an earlier step.

Outputs

orderobject
The order
Example output
{
  "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

Fromoccurred_fromdate and time
Only entries at or after this time.
Untiloccurred_todate and time
Only entries at or before this time.
Typestype_idslist
Only entries of these types. Leave empty for all.
Offeroffer_idtext
Only entries for this offer.
Order IDorder_idtext
Only entries for this order.
How manylimitnumber
How many to return, 1 to 100. Allegro's default is 100.From 1 to 100.
Skipoffsetnumber
How many to skip first, to read the next page.At least 0.

Outputs

countnumber
How many were returned
entrieslist
The entries
Example output
{
  "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 categoryparent_idtext
List this category's subcategories. Leave empty for the main categories.

Outputs

categorieslist
The categories
countnumber
How many were returned
Example output
{
  "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 manylimitnumber
How many to return, 1 to 20. Allegro's default is 20.From 1 to 20.
Skipoffsetnumber
How many to skip first, to read the next page.At least 0.

Outputs

countnumber
How many were returned
threadslist
The threads
Example output
{
  "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

Threadthread_idtextRequired
The Message Center thread. Pick one, or give its id from an earlier step.
Sent afterafterdate and time
Only messages sent after this time.
Sent beforebeforedate and time
Only messages sent before this time. Can't be used with Skip.
How manylimitnumber
How many to return, 1 to 20. Allegro's default is 20.From 1 to 20.
Skipoffsetnumber
How many to skip first, to read the next page.At least 0.

Outputs

countnumber
How many were returned
messageslist
The messages
thread_idtext
The thread
Example output
{
  "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 containsnametext
Only offers whose title contains this text.
Statusesstatuseslist
Only offers with any of these statuses. Leave empty for all.One or more of: ACTIVE, ACTIVATING, INACTIVE (Inactive (draft)), ENDED.
Formatsselling_formatslist
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 IDsexternal_idslist
Only offers with these ids from your own system (signature), up to 100.
Categorycategory_idtext
Only offers in this category. Pick a main category or give a category id.
Ordersorttext
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 manylimitnumber
How many to return, 1 to 1000. Allegro's default is 20.From 1 to 1000.
Skipoffsetnumber
How many to skip first, to read the next page.At least 0.

Outputs

countnumber
How many were returned
offerslist
The offers
total_countnumber
How many match in all
Example output
{
  "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 statusstatustext
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 statusfulfillment_statustext
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 frombought_fromdate and time
Only orders bought at or after this time.
Bought untilbought_todate and time
Only orders bought at or before this time.
Updated fromupdated_fromdate and time
Only orders changed at or after this time.
Updated untilupdated_todate and time
Only orders changed at or before this time.
Buyer loginbuyer_logintext
Only orders from the buyer with this Allegro login.
Ordersorttext
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 manylimitnumber
How many to return, 1 to 100. Allegro's default is 100.From 1 to 100.
Skipoffsetnumber
How many to skip first, to read the next page.At least 0.

Outputs

countnumber
How many were returned
orderslist
The orders
total_countnumber
How many match in all
Example output
{
  "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

Recommendedrecommendedtext
Only positive or only negative ratings. Leave empty for both.One of: true (Recommended (positive)), false (Not recommended (negative)).
Changed fromchanged_fromdate and time
Only ratings given or edited at or after this time.
Changed untilchanged_todate and time
Only ratings given or edited at or before this time.
How manylimitnumber
How many to return, 1 to 100. Allegro's default is 20.From 1 to 100.
Skipoffsetnumber
How many to skip first, to read the next page.At least 0.

Outputs

countnumber
How many were returned
ratingslist
The ratings
Example output
{
  "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 IDorder_idtextRequired
The order's id, from 'List orders', a trigger or an earlier step.

Outputs

countnumber
How many were returned
order_idtext
The order
shipmentslist
The tracking numbers
Example output
{
  "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 loginbuyer_logintextRequired
The buyer's Allegro login, from the order.
Order IDorder_idtextRequired
The order's id, from 'List orders', a trigger or an earlier step.
MessagetexttextRequired
What to send, up to 2,000 characters.

Outputs

messageobject
The message sent
Example output
{
  "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

Threadthread_idtextRequired
The Message Center thread. Pick one, or give its id from an earlier step.
MessagetexttextRequired
What to send, up to 2,000 characters.

Outputs

messageobject
The message sent
Example output
{
  "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 IDorder_idtextRequired
The order's id, from 'List orders', a trigger or an earlier step.
Seller statusstatustextRequired
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 revisionrevisiontext
The order's revision from 'Get order'. When given, the change is refused if the order changed since.

Outputs

order_idtext
The order changed
statustext
The seller status set
updatedtrue/false
Always true once set
Example output
{
  "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

Offeroffer_idtextRequired
The offer. Pick one, or give its id from an earlier step.
Titlenametext
A new title, up to 75 characters.
Pricepricenumber
A new buy-now price, such as 49.99.At least 0.01.
Currencycurrencytext
The price's currency, such as PLN. Leave empty to keep the offer's currency.
Stockstocknumber
How many are available to buy.At least 0.
External IDexternal_idtext
The offer's id in your own system (signature), up to 100 characters.

Outputs

changedlist
The parts of the offer sent
offerobject
The offer as edited (empty while processing)
offer_idtext
The offer changed
operation_idtext
Allegro's id for an edit still processing, else empty
statustext
done, or processing when Allegro finishes the edit in the background
Example output
{
  "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"
}

On this page