Fórum
Ver pergunta

Erro “The Cash Flow Item is required.”   

76 visualizações
0
0

Tenho abaixo os pedidos que já experimentei para emitir recibo e nenhum deles está a funcionar dá sempre o erro que está no título, o primeiro dos pedidos é como sempre mandei e sempre funcionou, ou outros são tentativas falhadas que fiz. Como posso fazer para que funcione? O que me falta?

POST  https://my.jasminsoftware.com/api/232544/232544-0001/accountsReceivable/processOpenItems/DEFAULT
Request
[ {
“discount” : 0.0,
“settled” : 1.0,
“sourceDoc” : “FA.2020.26”
} ]

POST (400) https://my.jasminsoftware.com/api/232544/232544-0001/accountsReceivable/processOpenItems/DEFAULT?cashFlowItem=10
Request
[ {
“discount” : 0.0,
“settled” : 1.0,
“sourceDoc” : “FA.2020.26”
} ]
Response
[
{
“memberNames”: null,
“message”: “The Cash Flow Item is required.”
}
]

POST (400) https://my.jasminsoftware.com/api/232544/232544-0001/accountsReceivable/processOpenItems/DEFAULT
Request
[ {
“cashFlowItem”: 10,
“discount” : 0.0,
“settled” : 1.0,
“sourceDoc” : “FA.2020.26”
} ]
Response
[
{
“memberNames”: null,
“message”: “The Cash Flow Item is required.”
}
]

Faça login para poder traduzir
API Endpoints
Jasmin
Marcado como spam
Criado há 6 anos e 1 semana petuniversal
p
petuniversal Iniciante
1 respostas
1
Resposta privada

Necessita de definir o valor predefinido "Fluxo de Caixa" no tipo de recibo que pretende usar.
Poderá fazê-lo:
- Através da interface em Contas Correntes > Configuração > Tipos de Recibo > [Tipo pretendido] > Preencher valor em 'Fluxo de Caixa'.
- Através da API utilizando o endpoint PUT api/{accountKey}/{subscriptionKey}/financialCore/receiptTypes/{companyKey}/{typeKey}/defaultCashFlowItem e enviando como body o valor pretendido.

Com este valor preenchido, já conseguirá emitir o recibo normalmente sem adicionar qualquer outro campo ao pedido.

De realçar que, desde a última release, pode também utilizar um novo endpoint para a criação dos recibos:

POST api/{accountKey}/{subscriptionKey}/accountsReceivable/processOpenItems/generateReceipt

Este endpoint deverá receber como body um objecto com os seguintes campos:

{
	"company": "", **
	"documentType": "",
	"documentDate": "",
	"postingDate": "",
	"financialAccount": "",
	"cashFlowItem": "",
	"note": "",
	"party": "", **
	"currency": "",
	"exchangeRate": 1,
	"paymentMethod": "",
	"checkNumber": "",
	"openAccountPostingLines": **
	[{
		"sourceDoc": "FA.2020.1",
		"settled": 10,
		"discount": 0
	}]
}

** campos obrigatórios.

Todos os campos não assinalados como obrigatórios, poderão não ser passados, sendo utilizados os valores definidos por omissão no sistema (caso existam).

Faça login para poder traduzir
Marcado como spam
Criado há 6 anos e 1 semana nuno
n
nuno Iniciante
    Comentários
    Qual dos pedidos é que me aconselham utilizar? Este que está nesta resposta ou o que tenho utilizado para gerar recibos? A mesma alteração aconteceu aos pagamentos?
    6 anos e 1 semana
    petuniversal
      Este novo endpoint foi disponibilizado para permitir uma maior flexibilidade na criação de recibos, não ficando limitado aos valores definidos por omissão no sistema. Permite assim, para a emissão de um determinado recibo, passar valores de atributos tais como método de pagamento ou conta financeira, não havendo necessidade de os estar a definir ou ter que modificar previamente noutro sítio. No endpoint anterior, todos os valores necessários à criação do recibo têm que estar definidos por omissão nos respetivos locais: caso do "Fluxo de Caixa" no tipo de recibo no cenário que referiu p.e.. O resultado final de ambos os endpoints será sempre o mesmo, um Recibo, cabendo ao integrador decidir qual o endpoint que melhor se adapta às suas necessidades. Para os pagamentos não foi ainda disponibilizado um novo endpoint que permita esta flexibilidade, existindo somente aquele que necessita de todos os valores definidos por omissão: POST api/{accountKey}/{subscriptionKey}/accountsPayable/processOpenItems/{companyKey}.
      6 anos e 1 semana
      nuno
        Obrigado pela resposta, testei o "novo" pedido e formato e funcionaram! Deixo só registado que há vários campos do recibo que têm o nome e / ou o tipo de dados diferente do que está na documentação -> https://jasminsoftware.github.io/accountsreceivable.receipts.html#ReceiptResource Esta estrutura existe também ou vai existir também para o pagamento?
        6 anos e 1 semana
        petuniversal
          Para o novo endpoint, a documentação que deverá consultar encontra-se em https://jasminsoftware.github.io/accountsreceivable.processopenitems.html#ApiOpenAccountPosting. De referir que, apesar de na documentação surgirem com a indicação de obrigatórios uma vez que são necessários para a emissão de um recibo, tal como indiquei poderá não enviar no pedido a maior parte dos campos, sendo que nesse caso serão utilizados os valores definidos por omissão no sistema. Para a emissão de pagamentos, não existe ainda um endpoint com esta estrutura, contudo deverá ser disponibilizado numa das próximas releases.
          6 anos e 1 semana
          nuno