Moloni API / Endpoints / Entities / Salesmen / update

update

Disponível na versão: 1.0+

Actualiza um vendedor.

Se o vendedor já estiver referenciado em documentos, não é possível alterar o número de contribuinte e o número de vendedor. 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/salesmen/update/?access_token=[current_access_token]

Parâmetros

company_id int

Obrigatório

salesman_id int

Obrigatório

vat string

Obrigatório

number string

Obrigatório

name string

Obrigatório

base_commission float

Obrigatório

language_id int

Obrigatório

qty_copies_document int

Obrigatório

notes string

address string

Obrigatório

zip_code string

city string

Obrigatório

country_id int

Obrigatório

email string

website string

phone string

fax 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,
	salesman_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.

Software de faturação online

Certificado pela Autoridade Tributária N.º 2860