update

Disponível na versão: 1.0+

Edita uma taxa ou imposto.

O campo type aceita um de 3 valores e têm o seguinte significado:

  • 1: A taxa é uma percentagem (Ex.: IVA);
  • 2: A taxa é um valor monetário fixo, independentemente do artigo ou serviço a que é aplicado (Ex: Selo fiscal);
  • 3: A taxa é um valor monetário e depende do artigo ou serviço a que é aplicado (Ex.: Eco taxa).

O campo saft_type aceita um de 3 valores e têm o seguinte significado:

  • 1: A taxa é um valor adicionado (IVA);
  • 2: A taxa é um imposto direto (Imposto de Selo);
  • 3: A taxa não é nenhum dos dois casos anteriores.

O campo vat_type é obrigatório caso tenha escolhido a opção 1 no campo saft_type.
Da mesma forma, o campo stamp_type é obrigatório, caso tenham escolhido a opção 2 no campo saft_type.
Ambos são opcionais, caso tenha escolhido a opção 3 no campo saft_type.

O campo vat_type aceita um dos seguintes valores:

  • RED: IVA reduzido;
  • INT: IVA intermédio;
  • NOR: IVA normal;
  • ISE: Isento de IVA;
  • OUT: Outro tipo de IVA.

O valor limite do campo é definido de acordo com o tipo de imposto: se é um imposto em percentagem, o valor pode chegar a 100, caso contrário não tem limite (Na verdade, ele vai ser truncado para 9.999.999.999 se inserir um valor superior). O limite inferior é sempre 0 (inclusive).

O campo fiscal_zone aceita maiúsculas ISO 3166-1 do código de um país, ou um código de zona fiscal de um determinado país, em países que têm mais do que a zona principal. Você pode obter esses códigos dos países na classe Fiscal Zones da API.

Se o valor do imposto for 0, o campo exemption_reason deve ser preenchido.
Se o país for Portugal (Códigos fiscais da zona de "PT", "PT-AC" ou "PT-MA") apenas os valores de "M01" para "M16" são aceitáveis. Você pode obter esses códigos e o que eles significam na classe da API Tax Exemptions.

Pedido

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

Parâmetros
company_id int

Obrigatório

tax_id, int

Obrigatório

value int

Obrigatório

type int

Obrigatório

saft_type int

Obrigatório

vat_type string

Obrigatório

stamp_tax string

Obrigatório

exemption_reason string

Obrigatório

fiscal_zone string

Obrigatório

active_by_default int

Obrigatório

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