update

Disponível na versão: 1.0+

Actualiza um fornecedor.

Se o fornecedor já estiver referenciado em documentos, não é possível alterar o número de contribuinte e o número de fornecedor. Qualquer alteração destes dois campos será ignorada – nenhum erro será lançado.

Se o país for Portugal (country_id 1) e o código postal estiver preenchido, deve ser válido, isto é, 4 dígitos, traço, 3 dígitos.

Também para Portugal, o contribuinte deve ser válido.

Todos os campos *_id devem ser válidos e podem ser obtidos nos respectivos endpoints da API.

Pedido

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

Parâmetros
company_id int

Obrigatório

supplier_id int

Obrigatório

vat int

Obrigatório

number string

Obrigatório

name string

Obrigatório

language_id int

Obrigatório

address string

Obrigatório

zip_code string
city string

Obrigatório

country_id int

Obrigatório

email string
website string
phone string
fax string
contact_name string
contact_email string
contact_phone string
notes string
maturity_date_id int

Obrigatório

discount float
credit_limit float
qty_copies_document int

Obrigatório

payment_method_id int

Obrigatório

delivery_method_id int
field_notes string
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
{
	valid: 1,
	supplier_id: int
}
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