DOCUMENTAÇÃO CORPORATIVA
CadastrarAtualizarDestinoFinanceiro
Objetivo
Cadastrar destinos financeiros Pix, que serão vinculados a transpordores e motorista.
Observação:
Uma vez que motorista ou transportador possui destino financeiro associado a chave Pix, o mesmo poderá receber pagamentos nesta modalidade pelos métodos de RealizarPagamentoAvulsoCartão e CadastrarAtualizarOperacaoTransporte.
Request
1.1 Request
Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
1 | Instrução | int | Sim | Instrução do que se fazer com os dados. | 1= Inserir ou Atualizar |
2= Inserir se não existe | |||||
2 | IdDestinoFinanceiro | int | Não |
| Para casos de atualização de destino financeiro, informar esse parâmetro |
3 | IdMotorista | int | Não | Id do Motorista na TARGET | Informar nos casos de cadastro de um IdDestinoFinanceiro para um motorista |
4 | IdTransportadorFrete | int | Não | Id do Transportador Frete | Informar nos casos de cadastro de um IdDestinoFinanceiro para um transportador |
5 | TipoDestinoFinanceiro | int | Sim |
| Fixo 1 |
6 | Ativo | Bool (true|false) | SIM | Flag para indicar se a chave ficará ativa para uso ou não | N/A |
8 | TipoChavePIX | string | sim | Tag que direciona a forma de identificação que será realizado o pagamento PIX, conforme tipos disponíveis na observação. | 1- CPF/CNPJ |
9 | ChavePix | string | Sim | Informar a chave Pix conforme a seleção do tipo no parâmetro “TipoChavePix" | N/A |
10 | CodigoBanco | string | Não | CPF ou CNPJ do titular da conta que possui a chave PIX | Somente para "TipoChavePix=5" |
11 | NumeroConta | string | Não | Código do banco do titular da conta que possui a chave PIX somente para "TipoChavePix Manual =5” | Somente para "TipoChavePix=5" |
12 | DigitoConta | string | Não | Número da conta do titular da conta que possui a chave PIX, somente para "TipoChavePix Manual =5” | Somente para "TipoChavePix=5" |
13 | NumeroAgencia | string | Não | Digito da conta do titular da conta que possui a chave PIX, somente para "TipoChavePix Manual =5” | Somente para "TipoChavePix=5" |
14 | TipoContaDestinoFinanceiro | string | Não | Número da agência do titular da conta que possui a chave PIX, somente para "TipoChavePix Manual =5” | 1 - conta corrente |
15 | NomeBeneficiarioContaDestino | string | Sim | Nome do Motorista | N/A |
16 | CPFCNPJBeneficiarioContaDestino | string | Sim | CPF OU CNPJ do beneficiário | N/A |
1.2 Método
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br">
<soapenv:Header/>
<soapenv:Body>
<tms:CadastrarAtualizarDestinoFinanceiro>
<!--Optional:-->
<tms:auth>
<!--Optional:-->
<tms:Usuario>?</tms:Usuario>
<!--Optional:-->
<tms:Senha>?</tms:Senha>
<!--Optional:-->
<tms:Token>?</tms:Token>
</tms:auth>
<!--Optional:-->
<tms:destinoFinanceiroRequest>
<!--Optional:-->
<tms:Instrucao>?</tms:Instrucao>
<!--Optional:-->
<tms:IdDestinoFinanceiro>?</tms:IdDestinoFinanceiro>
<!--Optional:-->
<tms:IdMotorista>?</tms:IdMotorista>
<!--Optional:-->
<tms:IdTransportadorFrete>?</tms:IdTransportadorFrete>
<!--Optional:-->
<tms:TipoDestinoFinanceiro>?</tms:TipoDestinoFinanceiro>
<!--Optional:-->
<tms:Ativo>?</tms:Ativo>
<!--Optional:-->
<tms:DadosPIX>
<!--Optional:-->
<tms:TipoChavePIX>?</tms:TipoChavePIX>
<!--Optional:-->
<tms:ChavePix>?</tms:ChavePix>
<!--Optional:-->
<tms:CodigoBanco>?</tms:CodigoBanco>
<!--Optional:-->
<tms:NumeroConta>?</tms:NumeroConta>
<!--Optional:-->
<tms:DigitoConta>?</tms:DigitoConta>
<!--Optional:-->
<tms:NumeroAgencia>?</tms:NumeroAgencia>
<!--Optional:-->
<tms:TipoContaDestinoFinanceiro>?</tms:TipoContaDestinoFinanceiro>
<!--Optional:-->
<tms:NomeBeneficiarioContaDestino>?</tms:NomeBeneficiarioContaDestino>
</tms:DadosPIX>
<!--Optional:-->
<tms:CPFCNPJBeneficiarioContaDestino>?</tms:CPFCNPJBeneficiarioContaDestino>
</tms:destinoFinanceiroRequest>
</tms:CadastrarAtualizarDestinoFinanceiro>
</soapenv:Body>
</soapenv:Envelope>