Alterações na WebAPI com o lançamento da SR11

Última alteração a 19/12/2024

O lançamento da SR11 tem melhorias de performance ao nivel de API e essencialmente dos métodos ODATA, mas esta melhorias obrigaram-nos a ter pequenas quebras.

Todos os clientes que tenham integração entre o Valuekeep e sistemas externos ou relatorios especifos após a publicação essas mesmas integrações podem deixar de funcionar senão fizerem as alterações abaixo.

Métodos Get:
1. Antes da SR11: o URL era https://dv-cloud.valuekeep.com/api/801865/801865-0001/assetmanagement/monitorings.
2. Depois da SR11: houve uma alteração no URL para https://dv-cloud.valuekeep.com/api/801865/801865-0001/assetmanagement/monitorings/odata.

Ao criar um registo dependente da empresa, se houver apenas uma empresa, ela não será selecionada automaticamente. Agora é necessário passá-la como resource ou usar o Hearder X-Company;

As strings "1" e "0" não são mais convertidas em booleans.
1. Exemplo: Criar uma entidade e passar um campo boolean como 0 ou 1, conforme o exemplo abaixo:

POST https://st-my-preview.jasminsoftware.com/api/801793/801793-
0001/financialcore/paymentterms
{
"test": "t0",
"cenario": "Criação de condição de pronto pagamento",
"paymentTermKey": "0dias",
"description": "Pronto pagamento",
"daysFromReferenceDate": "0",
"useInAccountsReceivable": "1",
"useInAccountsPayable": "1",
"validFrom": "2016-01-01T00:00:00",
"validTo": "2099-12-31T00:00:00"
}

Devolve um erro e a mensagem:

{"validations":[{"propertyName":"useInAccountsPayable","errorMessage":"Could not
convert string to boolean: 1. Path 'useInAccountsPayable', line 8, position 28."},{"propertyName":"useInAccountsReceivable","errorMessage":"Could not convert string toboolean: 1. Path 'useInAccountsReceivable', line 7, position 31."}]}

Propriedades do tipo Money com valores vazios não são mais aceitas;
1. Exemplo:

POST https://st-my-preview.jasminsoftware.com/api/801793/801793-
0001/financialcore/financialAccounts{"description": "Caixa para moedas estrangeiras","financialAccountType":"1","validFrom": "2016-01-01T00:00:00","validTo": "2099-12-31T00:00:00","financialAccountKey": "CXCURRENCY","company": "SOQUENTE","allowForeignCurrency":"true","hasOpeningBalance":"","openingDate":"","openingAmount": {"amount":""}}}}

Devolve um erro (400) e a mensagem:

{"validations":[{"propertyName":"openingAmount.amount","errorMessage":"Error
converting value {null} to type 'System.Decimal'. Path 'openingAmount.amount', line22, position _15."}]}

Importante: com a nova versão do OData, alguns comandos sofreram ligeiras alterações:

Ex: comando "Expand".

Antes: /odata?$select=DocumentLines/SalesItem&$expand=DocumentLines

Atual: /odata?$select=NaturalKey&$expand=DocumentLines($select=SalesItem)

Adicionar aos favoritos ou partilhar este artigo

Esta página foi útil?

Obrigado pelo seu voto.