Por imposição da AT, no pedido de inserção de uma Nota de Crédito de momento já é obrigatório indicar pelo menos um documento de origem (caso a Nota de Crédito não seja um desconto por Rappel).

Com esta alteração, essa imposição vai-se manter e vai ser mais restrita, passando a ser obrigatório indicar em cada artigo da Nota de Crédito qual é o artigo correspondente do documento associado.

Pegando num exemplo de uma Fatura/Recibo com os seguintes artigos:

Camisola X; Preço 10€; Quantidade 2;
Camisola XS; Preço 20€; Quantidade 1;

Se o cliente quiser devolver uma das Camisola X, deverá ser emitida uma Nota de Crédito com o seguinte:

A Nota de Crédito deverá estar associada à Fatura com um valor conciliado de 10€
A Nota de Crédito deverá ter um artigo (Camisola X com quantidade 1)
Na Nota de Crédito o artigo Camisola X deverá ter a indicação do artigo original da Fatura

Para que isto fosse possível, foi necessário proceder às seguintes alterações na API:

Em cada pedido do género documents/getOne que traga artigos de um documento, passou a ser retornado também um novo parâmetro document_product_id, que corresponde ao ID de uma linha de um documento
O parâmetro is_related de cada Document Product foi alterado para related_id e deverá ter o document_product_id mencionado anteriormente

Estas duas alterações já se encontram em produção uma vez que não se tratam de breaking changes, mas sim de alterações que permitem dar um tempo de adaptação para os clientes.

No final do tempo de adaptação serão implementadas as seguintes validações que irão causar breaking changes a todos os clientes que emitam Notas de Crédito pela API

O parâmetro related_id passará a ser obrigatório
O parâmetro related_id deverá ter obrigatoriamente um document_product_id de uma linha dos documentos associados
O price de um artigo na Nota de Crédito não poderá ser maior que o price do respectivo documento associado
O qty deverá ser um valor igual ou inferior à quantidade disponível do artigo no documento associado. A quantidade disponível tem também em atenção se o artigo já foi usado noutros documentos ou não, por exemplo, Por exemplo, uma FT com uma unidade de um artigo não pode dar origem a duas NC com o mesmo artigo
O total da Nota de Crédito não deverá ser superior ao valor da relação

Adicionámos também um novo endpoint que será útil para obter uma listagem de artigos ainda disponíveis para conciliação de um documento.

https://api.moloni.pt/v1/documents/getUnrelatedProducts/?access_token=[current_access_token]

O endpoint requer pelo menos que estejam presentes um company_id e um document_id Nota: O endpoint só irá funcionar quando o parâmetro related_id estiver a ser preenchido de forma correcta

Atenção com as breaking changes que serão implementadas, estas vão afectar todos os clientes Moloni que estejam a usar a API para emitir Notas de Crédito

Atualizações gratuitas no Moloni

O Moloni tem implementado na sua estrutura enquanto empresa um serviço de melhoria contínua e lean production que tem como principal objetivo a sistematização das alterações introduzidas no programa, quer como resposta aos normativos legais, quer como resposta às necessidades de mercado recolhidas diretamente das mensagens diretas e de feedback de clientes.

Uma das principais ferramentas deste sistema é o Changelog, um motor de consulta com informações sobre todas as alterações feitas na plataforma e enquadra os recursos disponibilizados aos utilizadores.