Posted on

Erro ao submeter pedido à API do Gestix ERP

Questão

Estamos a ter dificuldades com os movimentos de transferencia através da API com a seguinte mensagem de erro: “Erro Gestix: 400 Gestix: document data not valid | entity not found in API (.items). No items data received. 2023-12-28 16:38:23 (login: Test company: iServices, lda.)”

Segundo conseguimos apurar, são caracteres incomuns como os que coloco abaixo na foto que estão na origem do erro. Conseguem ajudar?

Resposta

Recapitulando o processo de envio de dados para o Gestix através da API, a vossa aplicação deve

1º formar o JSON que encapsula esses dados
2º submeter o JSON à API
3º escutar o retorno da API

O retorno que obtém no passo 3º indica que o JSON formado pela vossa fonte de dados no passo 1º não é válido. Para ser mais fácil aos vossos engenheiros encontrarem o problema na fonte dos dados podem “pegar” nesse JSON gerado no 1º passo e submete-lo manualmente num validador on-line. Assim, o validador vai indicar quando o JSON estiver isento de erros.

Exemplo de um validador JSON online pode ser encontrado no seguinte link: https://jsonlint.com/

Posted on

Gestix API Documentation

A new Gestix API version has been released.

Gestix API Reference Guide is available from your Gestix Admin | Webshop menu for browsing and for download in PDF format. The API specification in OAS 3.0-style in JSON format is also available for download at this location.

About the vat_included field in the invoice structure:

vat_included

EN

The vat_included field encodes the type of VAT calculation involved in the invoice line, which can assume one of the values 0, 1 and 2, which will be interpreted as follows:
“0” – the price value has been entered without VAT in a Document Set configured as Prices without VAT – this mode is when prices are negotiated without VAT – the invoice will print unit prices without VAT.
“1” – the price value has been entered including VAT in a set of documents configured as Prices without VAT – the software will subtract the VAT from the unit price before recording.
“2” – the price value has been entered with VAT in a Document Set configured as Prices with VAT – this mode is when prices are negotiated with VAT – the invoice will show the unit prices with VAT.

PT

O campo vat_included codifica o tipo de cálculo do IVA envolvido na linha da fatura, podendo assumir um dos valores 0, 1 e 2, que será interpretado da seguinte forma:
“0” – o valor do preço foi inserido sem IVA em um Conjunto de Documentos configurado como Preços sem IVA – este modo é quando os preços são negociados sem impostos – a fatura imprimirá preços unitários sem IVA.
“1” – o valor do preço foi inserido incluindo o IVA em um conjunto de documentos configurado como Preços sem IVA – o software subtrairá o IVA do preço unitário antes da gravação.
“2” – o valor do preço foi inserido com IVA em um Conjunto de Documentos configurado como Preços com IVA incluído – este modo é quando os preços são negociados com IVA – a fatura mostrará os preços unitários com IVA.