Kurkite sėkmingą verslą su Wantly API

Wantly API

Naudokite Wantly API, kad susietumėte savo išorines sistemas, el. parduotuves ar ERP (pvz., Odoo, Directo) su mūsų platforma. Tai leidžia automatizuoti produktų importą, kontaktų valdymą ir komercinių pasiūlymų kūrimą.

  • Dokumentacija: Visos užklausos naudoja standartinį JSON formatą.

  • Greita pradžia: Patogiausia API testuoti naudojant „Postman“ programą.

Atsisiųsti .json postman kolekciją

 

 

Pasiūlymo parametrai:

{

	"proposal":{
		"id":4840,
		"nr":4840,
		"url":"ff59h1u63uzc",
		"name":"Pasi\u016blymas 4840",
		"author":"1",
		"created":"2023-11-09",
		"deadline":"2023-12-09",
		"selling":null,
		"arriving":"2023-11-16",
		"done":"2023-11-09",
		"client":"Klientas",
		"code":"123456",
		"person":"asmuo",
		"currency":"EUR",
		"status":"0",
		"soldby":null,
		"discount":"0",
		"tax":"21",
		"video":null,
		"comment":"dgasgf",
		"owner":1,
		"type":0,
		"deleted":0,
		"margin":"4.09",
		"marginper":"45.00",
		"turnover":"9.09",
		"header":32074,
		"confirmable":0,
		"accepted":0,
		"usercomment":"",
		"language":"lt",
		"created_at":"2023-11-09 13:20:34",
		"updated_at":"2023-11-09 13:24:33"
	},
	"entries":[
		{
			"product":"produktas su pvm",
			"ammount":"1",
			"sku":"cwsjuv",
			"parent":"0",
			"supplier":"Tiek\u0117jas",
			"unit":"vnt",
			"pvm":"21",
			"price":"9.0909",
			"prime":"5.00",
			"marper":"0",
			"deli":"0",
			"discount":"0",
			"comment":"<p>test<\/p>",
			"grams":"0",
			"image":"32131",
			"addup":"0",
			"link":"8454",
			"accepted":"0",
			"pricetype":"0",
			"required":"0",
			"periodical":"0",
			"withpvm":"1",
			"edit_amount":"0",
			"order":0
		},
		{
			"product":"<p>Para\u0161au apra\u0161ym\u0105 ir tekst\u0105<\/p>",
			"ammount":"#ffffff",
			"ammount2":"0",
			"parent":"0",
			"supplier":"https:\/\/base.wantly.eu\/public\/images\/wantly_logo_md.png",
			"unit":"31898",
			"pvm":"0",
			"price":"0",
			"prime":"1",
			"deli":"0",
			"discount":"2",
			"comment":"1",
			"notes":"null",
			"attribute":"text_sep",
			"link":"0",
			"accepted":"0",
			"pricetype":"0",
			"amounttype":"0",
			"periodical":"0",
			"order":1
		}
	]
}

Pasiūlymo atiduodama informacija:

  • id: Unikalus pasiūlymo identifikatorius
  • nr: Pasiūlymo numeris
  • url: Unikalus URL
  • name: Pasiūlymo pavadinimas
  • author: Pasiūlymo autorius
  • created: Sukūrimo data
  • deadline: Pasiūlymo galiojimo data
  • selling: Pardavimo data
  • arriving: Pristatymo data
  • done: Įvykdymo data data
  • client: Kliento pavadinimas
  • code: Kliento kodas
  • person: Kontaktinis asmuo
  • currency: Valiuta
  • status: Pasiūlymo statusas
  • soldby: Pardavimo data
  • discount: Nuolaidos procentas
  • tax: PVM tarifas
  • video: Vaizdo įrašo informacija
  • comment: Komentarai ar pastabos
  • owner: Pasiūlymo savininkas
  • type: Pasiūlymo tipas (0 – paprastas, 1 – bendriniai, 4 – šablonai)
  • deleted: Ištrintas 
  • margin: Marža
  • marginper: Maržos procentas
  • turnover: Apyvarta
  • header: Antraštės paveikslėlis
  • confirmable: Patvirtinimo galimybė
  • accepted: Patvirtinimo būsena
  • usercomment: Vartotojo komentarai
  • language: Pasiūlymo kalba 
  • created_at: Sukūrimo data ir laikas
  • updated_at: Atnaujinimo data ir laikas

    Pasiūlymo įrašų parametrai (kai “attribute” nėra nustatytas arba 0):
  • product: Produkto pavadinimas
  • ammount: Kiekis
  • sku: Prekės kodas
  • parent: Pagrindinio produkto identifikatorius (jei įskaičiuotas produktas, kitu atveju 0)
  • supplier: Tiekėjo pavadinimas
  • unit: Matavimo vienetas 
  • pvm: PVM tarifas
  • price: Produkto kaina 
  • prime: Prekės savikaina 
  • marper: Maržos procentas
  • deli: Papildomos išlaidos
  • discount: Nuolaidos procentas
  • comment: Komentarai ar pastabos
  • grams: Svoris gramais
  • image: Nuotraukos identifikatorius
  • link: Nuoroda arba referencija
  • accepted: Patvirtinimo būsena
  • pricetype: Kainos tipas
  • required: Privalomas
  • periodical: Periodinė prekė
  • withpvm: Kaina su PVM (tik atvaizdavimui)
  • edit_amount: Redaguojamas kiekis
  • order: Seka

    Jei produkto “attribute” yra “text_sep” arba “group_sep”, įrašai yra ne produktai ir skirti tik atvaizdavimui.

Produkto parametrai:

  • id: Unikalus produkto identifikatorius
  • name: Produkto pavadinimas
  • sku: Prekės kodas
  • price: Kainos informacija (array)
  • pvm: PVM tarifas
  • supplier: Vidutinė kaina
  • units: Matavimo vienetas
  • description: Trumpas produkto aprašymas
  • descriptionl: Išsamus produkto aprašymas
  • category: Kategorijos identifikatorius
  • image_gallery: Nuotraukų galerija 
  • status: Produkto būsena
  • url: Tiekėjų nuorodos (array)
  • user: Kūrėjas
  • grams: Svoris gramais
  • withpvm: Įtraukti PVM į kainą
  • deleted: Trynimo būsena
  • amounttype: Kiekio tipas 
  • periodical: Periodinė prekė
  • created_at: Sukūrimo data ir laikas
  • updated_at: Atnaujinimo data ir laikas

Produkto atiduodama informacija:

{

	"product":{

		"id":8363,

		"name":"Product name",

		"sku":"1234",

		"price":"{\"Tiekejas\":{\"100\":[\"4.25\",\"6.07\",0],\"500\":[\"4\",\"5.33\",0],\"1000\":[\"3.75\",\"4.68\",0]},\"Tiek\\u0117jas2\":{\"1\":[\"10\",\"20\",0]}}",

		"pvm":0,

		"supplier":"9.02",

		"units":"vnt",

		"description":"

		Description<\/p>",

		"descriptionl":"

		Long description<\/p>",

		"category":"98",

		"image_gallery":"31129",

		"status":"0",

		"url":"[\"\"]",

		"user":1,

		"grams":null,

		"withpvm":0,

		"deleted":0,

		"amounttype":0,

		"periodical":0,

		"created_at":"2022-04-25 11:04:38",

		"updated_at":"2023-11-09 14:24:41"

	}

}

Kainos Array:

 

{

	"Tiekejas":{ // tiekėjas
		"100":[ //kiekis
			"4.25", // pirkimo kaina
			"6.07", // pardavimo kaina
			0 // papildomos sąnaudos
		],
		"500":[ //kiekis
			"4", // pirkimo kaina
			"5.33", // pardavimo kaina
			0 // papildomos sąnaudos
		],
		"1000":[ //kiekis
			"3.75", // pirkimo kaina
			"4.68", // pardavimo kaina
			0
		]
	},
		"Tiek\u0117jas2":{ // tiekėjas
			"1":[ //kiekis
			"10", // pirkimo kaina
			"20", // pardavimo kaina
			0 // papildomos sąnaudos
		]
	}
}

 

Wantly API trigeriai

Trigeriai yra naudojami informacijai gauti, po atlikto veiksmo Wantly sistemoje.
Galima nustatyti 6 skirtingus trigerius sistemoje:

  • Po pasiūlymo sukūrimo;
  • Po pasiūlymo redagavimo;
  • Po pasiūlymo ištrynimo;
  • Po produkto sukūrimo;
  • Po produkto redagavimo;
  • Po produkto ištrynimo.

Wantly sistemos nustatymuose galite įrašyti nuorodas kiekvienam trigeriui, į jas bus siunčiama informacija POST metodu. Galite nustatyti Basic Auth kiekvienai nuorodai.

API trigeriai nėra paleidžiami naudojant kitas API užklausas.