Moloni API / Endpoints / Entities / Customers / insert

insert

Disponível na versão: 1.0+

Insere um novo cliente.

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/insert/?access_token=[current_access_token]

Parâmetros

company_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

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.

Software de faturação online

Certificado pela Autoridade Tributária N.º 2860