Moloni API / Endpoints / Entities / Suppliers / getBySearch

getBySearch

Disponível na versão: 1.0+

Devolve fornecedores com base nos resultados de uma pesquisa no campos do cliente.
Os campos pesquisados são: Número, Contribuinte e Nome.

Pedido

https://api.moloni.pt/v1/suppliers/getBySearch/?access_token=[current_access_token]

Parâmetros

company_id int

Obrigatório

search string

Obrigatório

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

[
	{
		supplier_id: int
		number: string
		name: string,
		vat: string
	},
	(...)
]

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.

Software de faturação online

Certificado pela Autoridade Tributária N.º 2860