getByReference

Disponível na versão: 1.0+

Devolve todos os produtos baseados numa pesquisa por referência.

Pedido

https://api.moloni.pt/v1/products/getByReference/?access_token=[current_access_token]

Parâmetros
company_id int

Obrigatório

reference string

Obrigatório

exact int
qty int
offset int
Nota
- O parâmetro qty tem como default 50 e o offset 0, sendo que o máximo qty é 50;
- Campos de preenchimento facultativo, significa que podem ser uma string vazia ou zero, dependendo do respectivo tipo.
Resposta
{
	product_id: int,
	category_id: int,
	type: int,
	name: string,
	summary: string,
	reference: string,
	ean: string,
	price: float,
	unit_id: int,
	has_stock: int,
	stock: int,
	image: string,
	exemption_reason: string,
	category:
	{
		category_id: int,
		parent_id: int,
		name: string,
		summary: string,
		image: string
	},
	measurement_unit
	{
		unit_id: int,
		name: string,
		short_name: string
	},
	suppliers:
	[
		{	
			product_id: int,
			supplier_id: int,
			cost_price: float
		}, (...)
	],
	taxes:
	[
		{	
			product_id: int,
			tax_id: int,
			value: float,
			order: int,
			cumulative: int,
			tax:
			{	
				tax_id: int,
				type: int,
				saft_type: int,
				vat_type: string,
				stamp_tax: string,
				name: string,
				value: float,
				fiscal_zone: string,
				active_by_default: int,
				exemption_reason: string
			}
		}, (...)
	],
	properties:
	[
		{
			property_id: int,
			value: string,
			property: {,
				property_id: int,
				title: string
			}
		},
		(...)
	],
	price_classes:
	[
		{
			product_price_class_id: int,
			price_class_id: int,
			value: float,
			{
				price_class_id: int,
				title: string,
				lastmodifiedby: int,
				lastmodified: int,										
			}
		},
		(...)
	],
	warehouses:
	[
		{
			product_id: int,
			warehouse_id: int,
			stock: float,
		},
		(...)
	]
}
Lista de erros possíveis
Sempre que existir um erro no preenchimento dos campos, será devolvido via JSON o objeto com os erros indexado pela ordem dos campos.
As mensagens de erro, são devolvidas sob a forma de códigos, e para perceber quais os erros disponíveis e como interpretar as mensagens recebidas, consulte esta ligação.

© 2024 Moloni

Software de faturação online

Certificado pela Autoridade Tributária N.º 2860