Objetivo

Esse método tem como objetivo realizar uma busca por transações financeiras realizadas em nossa base de dados.

Observações Importantes

Não é possível realizar rajadas para esse método, a TARGET limita 50 requisições por minuto, aconselhamos requisições por demanda, caso o limite de 50 requisições seja ultrapassado, iremos bloquear as requisições apenas para o método que ultrapassou o limite durante 5 minutos.

Request

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
BuscaTransacoesFinanceirasRequest
1	QuantidadeItensPorPagina	int	Sim	Quantidade de itens a serem trazidos em uma página.	N/A
2	NumeroPagina	int	Sim	Número da página especificada de retorno.	N/A
3	TipoTransacaoFinanceira	int	Sim	Especifique aqui em qual tabela iremos buscar o resultado. Caso seja utilziado a opção 7, TipoBuscaUnitaria e IdEntidadeTransacaoFinanceira não são obrigatórios.	1= OperacaoTransporteParcelas 2= ParcelaUnitaria 3= PagamentoAvulso 4= CombustivelAvulso 5= CompraValePedagio 6= CompraPedagioTAG 7= Todos
4	TipoBuscaUnitaria	int	Não	Especifique aqui o tipo da busca desejada e preencha o campo.	1= PorIdEntidade 2= PorIdIntegrador 3= PorDocumentoRelacionado
5	IdEntidadeTransacaoFinanceira	int	Sim	ID de Entidade da Transacao.	N/A
6	DataInicioPeriodo	DateTime(YYYY-MM-DD)	Sim	Período de início de busca das transções.	N/A
7	DataFimPeriodo	DateTime(YYYY-MM-DD)	Sim	Período final de busca das transções.	N/A
8	IdIntegrador	string	Não	ID Integrador único da compra.	N/A
9	DocumentoRelacionado	string	Não	Documento único relacionado à compra	N/A
10	Pago	bool (true \|\| false)	Sim	Está pago ou não.	Quando Pago igual a true, a busca é feita pela data de pagamento e não através da data de registro.

Response

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
BuscaTransacoesFinanceirasResponse
1	Erro	ErroResponse - string	Não	Retorna o Erro	NULO em caso de Sucesso
2	TipoTransacaoFinanceira	string	Sim	Retorna o Tipo da Transação Financeira.	N/A
3	IdEntidadeTransacaoFinanceira	int	Não	Retorna o Id de Entidade da Transação Financeira.	N/A
4	IdOperacaoTransporteRelacionada	int	Sim	Retorna o Id da Operação de CIOT, caso exista.	N/A
5	Valor	decimal	Sim	Valor da Operação	N/A
6	Situacao	string	Sim	Status da Operação no momento da busca.	N/A
7	ModoPagamento	string	Sim	Modo de pagamento para essa transação: Cartão, TAG e Depósito.	N/A
8	Comentario	string	Não	Comentário registrado na transação caso exista.	N/A
9	DataRegistro	DateTime(YYYY-MM-DD)	Não	Data em que a transação foi registrada.	N/A
10	DataPagamento	DateTime(YYYY-MM-DD)	Não	Data em que a transação foi paga.	N/A

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
ResultadoPaginadoResponse
1	Erro	ErroResponse - string	Não	Retorna o Erro	NULO em caso de sucesso
2	Itens	N/A	N/A	Itens	N/A
3	NumeroPagina	int	Sim	Número da Página	N/A
4	QuantidadeItensPorPagina	int	Sim	Quantidade de Itens por Página	N/A
5	QuantidadeTotalItens	int	Sim	Quantidade Total de Itens	N/A
6	QuantidadeTotalPaginas	int	Sim	Quantidade Total de Páginas	N/A

Método

Abaixo, segue método - 'BuscarTransacoesFinanceiras'.

BuscarTransacoesFinanceirasRequest

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br">
   <soapenv:Header/>
   <soapenv:Body>
      <tms:BuscarTransacoesFinanceiras>
         <tms:auth>
            <tms:Usuario>?</tms:Usuario>
            <tms:Senha>?</tms:Senha>
            <tms:Token>?</tms:Token>
         </tms:auth>
         <tms:buscaTransacoes>
            <tms:QuantidadeItensPorPagina>?</tms:QuantidadeItensPorPagina>
            <tms:NumeroPagina>?</tms:NumeroPagina>
            <tms:TipoBuscaUnitaria>?</tms:TipoBuscaUnitaria>
            <tms:TipoTransacaoFinanceira>?</tms:TipoTransacaoFinanceira>
            <tms:IdEntidadeTransacaoFinanceira>?</tms:IdEntidadeTransacaoFinanceira>
            <tms:DataInicioPeriodo>?</tms:DataInicioPeriodo>
            <tms:DataFimPeriodo>?</tms:DataFimPeriodo>
            <tms:IdIntegrador>?</tms:IdIntegrador>
            <tms:DocumentoRelacionado>?</tms:DocumentoRelacionado>
            <tms:Pago>?</tms:Pago>
         </tms:buscaTransacoes>
      </tms:BuscarTransacoesFinanceiras>
   </soapenv:Body>
</soapenv:Envelope>

Buscar Transações Financeiras

Abaixo, segue um exemplo do método - 'BuscarTransacoesFinanceiras'.

Exemplo - BuscarTransacoesFinanceiras

Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br"  xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
   <soapenv:Header/>
   <soapenv:Body>
      <tms:BuscarTransacoesFinanceiras>
         <tms:auth>
            <tms:Usuario>tms.exemplo</tms:Usuario>
            <tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
            <tms:Token i:nil="true" />
         </tms:auth>
         <tms:buscaTransacoes>
            <tms:QuantidadeItensPorPagina>99</tms:QuantidadeItensPorPagina>
            <tms:NumeroPagina>1</tms:NumeroPagina>
            <tms:TipoBuscaUnitaria i:nil="true" />
            <tms:TipoTransacaoFinanceira>7</tms:TipoTransacaoFinanceira>
            <tms:IdEntidadeTransacaoFinanceira i:nil="true" />
            <tms:DataInicioPeriodo>2018-09-03T00:00:00</tms:DataInicioPeriodo>
            <tms:DataFimPeriodo>2018-09-04T23:59:59</tms:DataFimPeriodo>
            <tms:IdIntegrador i:nil="true" />
            <tms:DocumentoRelacionado i:nil="true" />
            <tms:Pago>true</tms:Pago>
         </tms:buscaTransacoes>
      </tms:BuscarTransacoesFinanceiras>
   </soapenv:Body>
</soapenv:Envelope>

Response

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <BuscarTransacoesFinanceirasResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
         <BuscarTransacoesFinanceirasResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <Erro i:nil="true"/>
            <Itens>
               <BuscaTransacoesFinanceirasResponse>
                  <Erro i:nil="true"/>
                  <TipoTransacaoFinanceira>Parcela de Operação de Transporte</TipoTransacaoFinanceira>
                  <IdEntidadeTransacaoFinanceira>2759505</IdEntidadeTransacaoFinanceira>
                  <IdOperacaoTransporteRelacionada>1850433</IdOperacaoTransporteRelacionada>
                  <Valor>80.00</Valor>
                  <Situacao>Paga</Situacao>
                  <ModoPagamento>Depósito em Conta</ModoPagamento>
                  <Comentario>Teste</Comentario>
                  <DataRegistro>2023-06-01T17:12:37.457</DataRegistro>
                  <DataPagamento>2024-01-24T05:14:28.8</DataPagamento>
                  <PlacaVeiculo>AWN0143</PlacaVeiculo>
                  <OrigemUsuarioPagamento>Portal Target</OrigemUsuarioPagamento>
                  <ValorTaxa>0.02</ValorTaxa>
               </BuscaTransacoesFinanceirasResponse>
               <BuscaTransacoesFinanceirasResponse>
                  <Erro i:nil="true"/>
                  <TipoTransacaoFinanceira>Parcela de Operação de Transporte</TipoTransacaoFinanceira>
                  <IdEntidadeTransacaoFinanceira>2556910</IdEntidadeTransacaoFinanceira>
                  <IdOperacaoTransporteRelacionada>1716669</IdOperacaoTransporteRelacionada>
                  <Valor>1.00</Valor>
                  <Situacao>Paga</Situacao>
                  <ModoPagamento>Depósito em Conta</ModoPagamento>
                  <Comentario/>
                  <DataRegistro>2023-02-14T18:43:03.59</DataRegistro>
                  <DataPagamento>2024-01-04T06:12:26.127</DataPagamento>
                  <PlacaVeiculo>AWN0143</PlacaVeiculo>
                  <OrigemUsuarioPagamento>Portal Target</OrigemUsuarioPagamento>
                  <ValorTaxa>0.00</ValorTaxa>
               </BuscaTransacoesFinanceirasResponse>
               <BuscaTransacoesFinanceirasResponse>
                  <Erro i:nil="true"/>
                  <TipoTransacaoFinanceira>Parcela de Operação de Transporte</TipoTransacaoFinanceira>
                  <IdEntidadeTransacaoFinanceira>2758900</IdEntidadeTransacaoFinanceira>
                  <IdOperacaoTransporteRelacionada>1850018</IdOperacaoTransporteRelacionada>
                  <Valor>30.00</Valor>
                  <Situacao>Paga</Situacao>
                  <ModoPagamento>Depósito em Conta</ModoPagamento>
                  <Comentario>Teste</Comentario>
                  <DataRegistro>2023-06-01T14:37:31.967</DataRegistro>
                  <DataPagamento>2024-01-24T05:14:28.737</DataPagamento>
                  <PlacaVeiculo>AWN0143</PlacaVeiculo>
                  <OrigemUsuarioPagamento>Portal Target</OrigemUsuarioPagamento>
                  <ValorTaxa>0.01</ValorTaxa>
               </BuscaTransacoesFinanceirasResponse>
               <BuscaTransacoesFinanceirasResponse>
                  <Erro i:nil="true"/>
                  <TipoTransacaoFinanceira>Parcela de Operação de Transporte</TipoTransacaoFinanceira>
                  <IdEntidadeTransacaoFinanceira>2765659</IdEntidadeTransacaoFinanceira>
                  <IdOperacaoTransporteRelacionada>1854595</IdOperacaoTransporteRelacionada>
                  <Valor>200.00</Valor>
                  <Situacao>Paga</Situacao>
                  <ModoPagamento>Depósito em Conta</ModoPagamento>
                  <Comentario>Teste</Comentario>
                  <DataRegistro>2023-06-05T13:09:11.71</DataRegistro>
                  <DataPagamento>2024-01-05T05:21:23.787</DataPagamento>
                  <PlacaVeiculo>AWN0143</PlacaVeiculo>
                  <OrigemUsuarioPagamento>Portal Target</OrigemUsuarioPagamento>
                  <ValorTaxa>0.04</ValorTaxa>
               </BuscaTransacoesFinanceirasResponse>
               <BuscaTransacoesFinanceirasResponse>
                  <Erro i:nil="true"/>
                  <TipoTransacaoFinanceira>Parcela de Operação de Transporte</TipoTransacaoFinanceira>
                  <IdEntidadeTransacaoFinanceira>2639521</IdEntidadeTransacaoFinanceira>
                  <IdOperacaoTransporteRelacionada>1774735</IdOperacaoTransporteRelacionada>
                  <Valor>7.00</Valor>
                  <Situacao>Paga</Situacao>
                  <ModoPagamento>Depósito em Conta</ModoPagamento>
                  <Comentario/>
                  <DataRegistro>2023-03-30T10:50:02.487</DataRegistro>
                  <DataPagamento>2024-01-04T06:12:28.523</DataPagamento>
                  <PlacaVeiculo>AWN0143</PlacaVeiculo>
                  <OrigemUsuarioPagamento>Portal Target</OrigemUsuarioPagamento>
                  <ValorTaxa>0.00</ValorTaxa>
               </BuscaTransacoesFinanceirasResponse>
               <BuscaTransacoesFinanceirasResponse>
                  <Erro i:nil="true"/>
                  <TipoTransacaoFinanceira>Parcela de Operação de Transporte</TipoTransacaoFinanceira>
                  <IdEntidadeTransacaoFinanceira>3219233</IdEntidadeTransacaoFinanceira>
                  <IdOperacaoTransporteRelacionada>2142085</IdOperacaoTransporteRelacionada>
                  <Valor>5.50</Valor>
                  <Situacao>Paga</Situacao>
                  <ModoPagamento>Pix</ModoPagamento>
                  <Comentario/>
                  <DataRegistro>2024-01-12T21:12:05.797</DataRegistro>
                  <DataPagamento>2024-01-12T21:14:23.58</DataPagamento>
                  <PlacaVeiculo>AWN0143</PlacaVeiculo>
                  <OrigemUsuarioPagamento>Portal Target</OrigemUsuarioPagamento>
                  <ValorTaxa>0.00</ValorTaxa>
               </BuscaTransacoesFinanceirasResponse>
               <BuscaTransacoesFinanceirasResponse>
                  <Erro i:nil="true"/>
                  <TipoTransacaoFinanceira>Parcela de Operação de Transporte</TipoTransacaoFinanceira>
                  <IdEntidadeTransacaoFinanceira>3218516</IdEntidadeTransacaoFinanceira>
                  <IdOperacaoTransporteRelacionada>2141631</IdOperacaoTransporteRelacionada>
                  <Valor>6.00</Valor>
                  <Situacao>Paga</Situacao>
                  <ModoPagamento>Cartão</ModoPagamento>
                  <Comentario/>
                  <DataRegistro>2024-01-12T16:07:34.243</DataRegistro>
                  <DataPagamento>2024-01-12T20:27:41.087</DataPagamento>
                  <PlacaVeiculo>AWN0143</PlacaVeiculo>
                  <OrigemUsuarioPagamento>Portal Target</OrigemUsuarioPagamento>
                  <ValorTaxa>0.00</ValorTaxa>
               </BuscaTransacoesFinanceirasResponse>
               <BuscaTransacoesFinanceirasResponse>
                  <Erro i:nil="true"/>
                  <TipoTransacaoFinanceira>Parcela de Operação de Transporte</TipoTransacaoFinanceira>
                  <IdEntidadeTransacaoFinanceira>2761476</IdEntidadeTransacaoFinanceira>
                  <IdOperacaoTransporteRelacionada>1851680</IdOperacaoTransporteRelacionada>
                  <Valor>80.00</Valor>
                  <Situacao>Paga</Situacao>
                  <ModoPagamento>Depósito em Conta</ModoPagamento>
                  <Comentario>Teste</Comentario>
                  <DataRegistro>2023-06-02T15:08:38.243</DataRegistro>
                  <DataPagamento>2024-01-24T05:14:28.63</DataPagamento>
                  <PlacaVeiculo>AWN0143</PlacaVeiculo>
                  <OrigemUsuarioPagamento>Portal Target</OrigemUsuarioPagamento>
                  <ValorTaxa>0.02</ValorTaxa>
               </BuscaTransacoesFinanceirasResponse>
               <BuscaTransacoesFinanceirasResponse>
                  <Erro i:nil="true"/>
                  <TipoTransacaoFinanceira>Parcela de Operação de Transporte</TipoTransacaoFinanceira>
                  <IdEntidadeTransacaoFinanceira>3218432</IdEntidadeTransacaoFinanceira>
                  <IdOperacaoTransporteRelacionada>2141577</IdOperacaoTransporteRelacionada>
                  <Valor>7.00</Valor>
                  <Situacao>Paga</Situacao>
                  <ModoPagamento>Cartão</ModoPagamento>
                  <Comentario/>
                  <DataRegistro>2024-01-12T15:47:59.18</DataRegistro>
                  <DataPagamento>2024-01-26T00:03:13.2</DataPagamento>
                  <PlacaVeiculo>AWN0143</PlacaVeiculo>
                  <OrigemUsuarioPagamento>Portal Target</OrigemUsuarioPagamento>
                  <ValorTaxa>0.00</ValorTaxa>
               </BuscaTransacoesFinanceirasResponse>
               <BuscaTransacoesFinanceirasResponse>
                  <Erro i:nil="true"/>
                  <TipoTransacaoFinanceira>Parcela de Operação de Transporte</TipoTransacaoFinanceira>
                  <IdEntidadeTransacaoFinanceira>2731270</IdEntidadeTransacaoFinanceira>
                  <IdOperacaoTransporteRelacionada>1832677</IdOperacaoTransporteRelacionada>
                  <Valor>55.00</Valor>
                  <Situacao>Paga</Situacao>
                  <ModoPagamento>Depósito em Conta</ModoPagamento>
                  <Comentario>TesteDeploy</Comentario>
                  <DataRegistro>2023-05-18T14:52:34.527</DataRegistro>
                  <DataPagamento>2024-01-04T06:12:30.72</DataPagamento>
                  <PlacaVeiculo>AWN0143</PlacaVeiculo>
                  <OrigemUsuarioPagamento>Portal Target</OrigemUsuarioPagamento>
                  <ValorTaxa>0.01</ValorTaxa>
               </BuscaTransacoesFinanceirasResponse>
            </Itens>
            <NumeroPagina>1</NumeroPagina>
            <QuantidadeItensPorPagina>10</QuantidadeItensPorPagina>
            <QuantidadeTotalItens>42</QuantidadeTotalItens>
            <QuantidadeTotalPaginas>5</QuantidadeTotalPaginas>
         </BuscarTransacoesFinanceirasResult>
      </BuscarTransacoesFinanceirasResponse>
   </s:Body>
</s:Envelope>