Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

02. SITUAÇÃO/REQUISITO

Criação de API REST com método métodos POST(criação) , DELETE(exclusão) e GET(consulta) de pagamentos pendentes a fim de substituir a integração EAI. A integração a ser substituída éAs integrações a serem substituídas foram: adapters\xml\fi5\axrfi010.p e adapters\xml\fi5\axrfi009.p.

03. SOLUÇÃO


Totvs custom tabs box
tabsPOST,DELETE,GET
idsPOST,DELETE,GET
Totvs custom tabs box items
defaultyes
referenciaPOST

POST - Geração de pagamentos pendentes. Deve ser enviada requisição POST na ROTA https://{servidor}/api/fin/v1/tradingProcess passando o JSON com as informações do pagamento pendente.

Se o registro for criado com sucesso, irá retornar status 200, caso ocorrer erros, será retornado o JSON com as mensagens de erro..

Image Added

Totvs custom tabs box items
defaultno
referenciaDELETE

DELETE - Exclusão de pagamento pendente. Deve ser enviada requisição DELETE na ROTA https://{servidor}/api/fin/v1/tradingProcess/{SequenciaPagamento}  passando na URL o número da sequência de pagamento.

Se o registro for excluído com sucesso, irá retornar status 200, caso ocorrer erros, será retornado o JSON com as mensagens de erro.

Image Added

Totvs custom tabs box items
defaultno
referenciaGET

GET- Consulta de pagamento pendente. Deve ser enviada requisição GET na ROTA https://{servidor}/api/fin/v1/tradingProcess/referenceCustomer/{Referência;CodigoCliente}  passando na URL a referência e o código do cliente, separados por ponto e vírgula (;).

Image AddedImage Removed


04. DEMAIS INFORMAÇÕES

JSON Pagamentos Pendente (POST):

{
    "CashierNumber": 1,
    "CustomerCode": 1,
    "PaymentDate": "2024-1112-0709",
    "PaymentDescription": "descrição",
    "Reference": "ref5",
    "PaymentValue": 10,
    "ProcessType": "Pagamento"
}

JSON Retorno de Erros:

{
    "detailedMessage": "Deve ser informado algum valor para Cliente.",
    "code": "20731",
    "message": "Cliente inválido !",
    "type": "error"
}


05. ASSUNTOS RELACIONADOS

    Não se aplicaDocumentação em formato JSON para consulta em ferramentas como Swagger ou similares disponível em finapi/apipublicfin.json.


Templatedocumentos