Linha Datasul

Árvore de páginas

Versões comparadas

Versão antiga 5

changes.mady.by.user Rafael Fabbris

Gravado em

comparado com

Nova versão 6

changes.mady.by.user Rafael Fabbris

Gravado em

Chave

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

Documento de API

Produto:

Datasul

Ocorrência:

Documentação de API

Nome Físicoprgfin/apb/apb553za


Objetivo: Efetuar pagamento online no módulos do Contas a Pagar

Esta API foi desenvolvida para atender ao processo de Pagamento Online com o Banco Santander, no módulo de Contas a Pagar.

Ela permite o envio dos títulos ao banco de forma eletrônica e o acompanhamento do status de cada pagamento.

Configurações e Cadastros

Antes de utilizar esta API, é necessário que o ambiente esteja devidamente configurado para o processo de Pagamento Online com o Banco Santander.

...

tt_integr_item_pagto_online: Retorna os erros que ocorreram durante o processo de Pagamento Online.

Funcionamento

A sintaxe para executar a API/BO em modo persistente é:

...

A variável denominada v_hdl_aux irá receber o “handle” do programa, permitindo o acesso aos “métodos” internos da API.


Tabelas Temporárias


Tabela Temporária

Descrição

Entrada/Saída

tt_integr_item_pagto_online

Conterá as informações do Item do borderô e status do pagamento online no retorno

Entrada/Saída

...

  
  def temp-table tt_integr_item_pagto_online        
    field tta_cod_estab_bord               as character format "x(5)" label "Estabelecimento" column-label "Estab"
    field tta_cod_portador                 as character format "x(5)" label "Portador" column-label "Portador"
    field tta_num_bord_ap                  as integer format ">>>>>9" initial 0 label "Número Borderô" column-label "Borderô"
    field tta_num_seq_bord                 as integer format ">>>9" initial 0 label "Sequência" column-label "Seq"
    field tta_cod_sit_pagto_online         as character format "x(20)" label "Sit Pagto Online" column-label "Sit Pagto Online"
    field tta_des_rej                      as character format "x(200)" label "Rejeição" column-label "Rejeção"
    field tta_cod_banco                    as character format "x(8)" label "Banco" column-label "Banco"
    index tt_id                            is primary
          tta_cod_estab_bord               ascending
          tta_cod_portador                 ascending
          tta_num_bord_ap                  ascending
          tta_num_seq_bord                 ascending
    .


Interpretação do Retorno

Após a execução da API, o campo tta_cod_sit_pagto_online de cada registro indicará o resultado do processamento:

ValorSignificadoAção Requerida
PagoPagamento realizado com sucesso.Nenhuma ação adicional.
ErroOcorreu um erro na tentativa de pagamento. O campo tta_des_rej trará a descrição detalhada da rejeição.Corrigir o problema e reenviar o item para a API.
Aguardando BancoO título está aguardando o processamento no banco.Reenviar o pagamento posteriormente para atualizar o status.

Observações

  • A Temp-Table é utilizada como Input-Output, ou seja, o consumidor deve montar a estrutura de entrada e, após a execução, analisar os campos de saída.

  • Os títulos enviados ficarão visíveis na tela Monitor Pagamento Pagamentos Online, onde também poderão ser analisados e, se necessário, reprocessados manualmente.

  • Para reprocessamento de títulos com erro, o envio via API deverá ser feito novamente, com os devidos ajustes.

...