update

Disponível na versão: 1.0+

Actualiza um cliente.

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

Parâmetros
company_id int

Obrigatório

customer_id int

Obrigatório

vat string

Obrigatório

number string (max: 20)

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
salesman_id int
price_class_id int
maturity_date_id int

Obrigatório

payment_day int
discount float
credit_limit float
copies array
document_type_id int

Obrigatório

copies int

Obrigatório

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,
	customer_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