Entidade TRANSACOES_INTEGRACAO

CARTOES.TRANSACOES_INTEGRACAO

Descrição

Registro de uma transação realizada com um integrador eletrônico (Cielo, Santander, etc.) para processar uma captura ou cancelamento de um pagamento eletrônico.
A transação está sempre relacionada com um ou mais títulos que representam o desmembramento das parcelas desta transação.

Atributos

AtributoDomínioRegrasDescrição
IDID(18)Rqd PK Id:
Chave de identificação interna
DATA_EMISSAODATE_TIMERqd AK Data da emissão:
Data e hora em que a transação foi criada.

Valor padrão = [SYSDATE]
LOP_IDID(18)FK LOP:
Identificação do LOP. Indiretamente, identifica o integrador eletrônico.

Referência para LOPS
SITUACAOOPCAO(2)Rqd AK Situação:
Indica a situação desta transação.

Valores permitidos:
  • 0 - Criada
  • 1 - Em andamento
  • 2 - Autenticada
  • 3 - Não autenticada
  • 4 - Autorizada
  • 5 - Não autorizada
  • 6 - Capturada
  • 9 - Cancelada
  • 10 - Em autenticação
  • 12 - Em cancelamento

Valor padrão = 0
DATA_INTEGRACAODATE_TIMEData da integração:
Data em que a transação foi processada com o integrador eletrônico.
TIDTEXT(40)Transação:
Código da transação gerado pelo integrador eletrônico durante o processamento da transação.
NUMERO_DOCUMENTOTEXTNúmero do documento:
Número do documento de autorização (NSU).
CARTAOCREDIT_CARDCartão:
Número do cartão de crédito utilizado na transação. Em operações TEF, o número do cartão estará mascarado no formato 9999 99** **** 9999.
VALIDADE_CARTAOMONTH_YEARValidade do cartão:
Validade Mês / Ano do cartão
BANDEIRA_IDID(18)FK Bandeira:
Indica a bandeira do cartão.

Referência para TIPOS_CARTOES
FORMA_PAGAMENTOOPCAO(3)Rqd Forma de pagamento:
Indica como o pagamento será efetuado.

Valores permitidos:
  • C - Crédito à Vista
  • CCP - Débito em conta corrente - A Prazo
  • CCV - Débito em conta corrente - A Vista
  • D - Débito
  • L - Crédito Parcelado - Loja
  • P - Crédito Parcelado - Administradora
PARCELASINTEGERRqd Parcelas:
Número de parcelas (quando a forma de pagamento for parcelada).

Valor padrão = 1
VALORDECIMAL_VALUERqd Valor:
Valor a ser cobrado do consumidor.
NUMERO_PEDIDOTEXT(20)Rqd Número do pedido:
Número do pedido da loja. Recomenda-se que seja um número único por loja.
DESCRICAOTEXT(500)Rqd Descrição:
Descrição do pedido/produto que está sendo transacionado.
MODO_PAGAMENTO_IDID(18)FK Modo de pagamento:
Indica o mode de pagamento que originou esta transação.

Referência para MODOS_PAGAMENTOS
PAGAMENTO_DOC_IDID(18)FK Pagamento/documento:
Quando informado, indica o documento/pagamento que originou esta transação.

Referência para DOC_ENTRADAS_SAIDAS_PAGAMENTOS
PEDIDO_IDID(18)FK Pedido:
Identificação do pedido que originou a transação

Referência para PEDIDOS
ULTIMO_HISTORICO_IDID(18)FK Último histórico:
Último histórico de integração

Referência para HISTORICOS_TRANSACOES_INTEGRACAO
NUMERO_AUTORIZACAOTEXT(20)Número da autorização:
Número da autorização caso a tenha sido capturado com sucesso.
SACADO_IDID(18)FK Sacado:
Indica de quem será sacado o valor da transação. Quando não informado, assume-se que será o cliente do pedido.

Referência para PESSOAS
BANCOTEXT(3)Banco:
Código do banco para operações que exigem uma conta bancária (ex: débito em conta).

Exemplos:
  • 001
AGENCIATEXT(5)Agência:
Código numérico da agência com o número do DV (quando o banco utiliza DV na agência). Serão 4 ou 5 casas com zeros a esquerda dependendo do uso ou não do DV.
CONTA_CORRENTETEXT(13)Conta corrente (com DV):
Número da conta corrente do sacado (apenas em operações com conta corrente).
DIA_VENCIMENTOINTEGERDia para vencimento:
Dia do mês para vencimento das faturas emitidas para o contrato.
MENSAGEM_RETORNO_INTEGRACAOTEXTMensagem de retorno da integração:
Mensagem de retorno da operação de integração no formato nativo tal qual foi recebida no processo de integração (XML, JSON, etc.)
COMPROVANTE_CLIENTETEXT_LONGComprovante do cliente:
Texto contendo o comprovante do pagamento do cliente, tal qual deve ser impresso ou enviado para o cliente.
COMPROVANTE_ESTABELECIMENTOTEXT_LONGComprovante do estabelecimento:
Texto contendo o comprovante a ser impresso para controle do estabelecimento.
DOCUMENTO_IDID(18)FK Documento:
Quando informado, indica que esta transação eletrônica foi realizada como pagamento de um documento e neste caso um registro em Formas de pagamentos de pedidos/documentos é automaticamente registrado.

Referência para DOC_ENTRADAS_SAIDAS
MEIO_PAGAMENTOUPPER(20)Meio de pagamento:
Indica o meio de pagamento utilizado. Valores conhecidos:
  • DINHEIRO
  • CHEQUE
  • DEBITO
  • CREDITO
  • VOUCHER
MODO_PAGAMENTOUPPER(30)Modo de pagamento:
Modo de pagamento. Valores possíveis:
  • A VISTA
  • PARCELADO ESTABELECIMENTO
  • PARCELADO ADMINISTRADORA

Regras

Atualizar pagamento do documento

(Depois de inserir, Depois de alterar)
Caso a transação esteja vinculada a um pagamento de documento (NFCE), registra os dados da captura no mesmo.

Autorizar(codigo_seguranca)

Autoriza a transação junto ao integrador eletrônico que está informado no LOP. Caso a autorização seja obtida, o limite do cartão já fica tomado. Uma transação não deve permanecer autorizada, o processo deve assegurar que ela será capturada ou cancelada.

Transações somente autorizados são automaticamente canceladas após um determinado prazo dependendo do integrador (5 dias).

Cancelar

Cancela a transação junto ao integrador eletrônico.

Capturar(codigo_seguranca)

Captura o valor junto ao integrador eletrônico que está informado no LOP. Este método pode ser utilizado em 2 momentos distintos:

Capturar recorrente

Permite capturar uma parcela de um contrato com pagamento recorrente.
Esta rotina é chamada mensalmente processando cada título que está vencendo.