Myynnit

Näiden kutsujen käyttöä kuvataan ohjeessa Myynnin seuranta.

Omat myynnit

GET/1.1/users/{sellerId}/salesVaatii tokenin

Listaa omat ilmoitukset.

Parametri	Tyyppi	Kuvaus
status	string	open, closed, waiting tai draft. Useamman voi yhdistää pilkulla tai viivalla, esim. open-closed tai waiting,draft. Ilman parametria avoimet ja suljetut.
sold	int	1 vain myydyt, 0 vain myymättömät¹
republished	int	1 vain uusitut¹
sort	string	closing-time oletuksena, list-time, bidders tai price²
limit	int	50 oletuksena tai 500, muut arvot tulkitaan 50:ksi
page	int	Sivunumero, alkaen 1

¹ Toimii vain tiloilla open, closed ja open-closed tai ilman tilaa. ² Lajittelu on laskeva. Tiloilla waiting ja draft closing-time on nouseva.

curl -H 'X-HuutoApiToken: <TOKEN>' \
  'https://api.huuto.net/1.1/users/966898/sales?status=closed&sold=1'

Vastauksessa on items, totalCount, updated ja sivutuslinkit links.self, links.first, links.previous, links.next ja links.last. previous ja next ovat null listan päissä.

Tila	Syy
401	Osoitteen käyttäjä-id ei ole sinun
403	Token puuttuu

Ilmoituksen ostot

GET/1.1/items/{itemId}/purchases

Kuka osti, millä hinnalla ja montako. Listassa on enintään yksi osto. Se on tyhjä, kunnes ilmoitus on suljettu, ja tyhjä myös, jos ilmoitus ei myynyt.

{
  "title": "Huuto.net item purchases",
  "purchases": [
    {
      "buyer": "ostaja123",
      "price": 24.9,
      "quantity": 1,
      "links": { "buyer": "https://api.huuto.net/1.1/users/1234567" }
    }
  ],
  "links": {
    "self": "https://api.huuto.net/1.1/items/123456789/purchases",
    "item": "https://api.huuto.net/1.1/items/123456789"
  },
  "updated": "2026-10-26T15:10:00+0200"
}

Linkin links.buyer lopussa on ostajan käyttäjä-id. Ostajan yhteystiedot saa kutsulla Hae käyttäjä. Tuntematon ilmoitus palauttaa 404.

Osoitekortti

GET/1.1/purchases/{sellerId}/items/{itemId}/htur-labelVaatii tokenin

Huutoturva-kaupan Posti-osoitekortti PDF-tiedostona. sellerId on oma käyttäjä-id.

{
  "itemId": 123456789,
  "parcelNumber": "JJFI12345678901234567",
  "pdf": "JVBERi0xLjQKJ..."
}

pdf on base64-koodattu, ja parcelNumber voi olla null. Kortin lähettäjänä näkyy <myyjän nimi> c/o ePrice Oy, yritystilillä <yrityksen nimi> c/o ePrice Oy.

Virheen runko on {"success": false, "error": "…"}, ja osassa on myös message.

Tila	error	Syy
400	item_id_missing	Ilmoituksen id puuttuu
401	unauthorized	Osoitteen käyttäjä-id ei ole sinun
403	invalid_token	Token puuttuu tai on virheellinen
404	item_not_found	Ilmoitusta ei ole tai se ei ole sinun
409	label_not_ready	Paketti ei odota lähetystä, eli kauppa on maksamatta, jo toimitettu tai noudettavissa, peruttu tai suljettu. Myös kun toimitus ei ole Posti-lähetys.
502	label_generation_failed	Taustapalvelu ei vastannut, tai kauppa ei ole Huutoturva-kauppa

Hintaehdotukset ja kysymykset

Myyjänä voit käsitellä ilmoitustesi hintaehdotukset ja kysymykset rajapinnassa:

Tehtävä	Kutsu
Lue ehdotukset	GET /items/{id}/offers
Hyväksy tai hylkää ehdotus	PUT /items/{id}/offers/{offerId}
Lue kysymykset	GET /items/{id}/questions
Vastaa kysymykseen	PUT /items/{id}/questions/{questionId}