Objetivo

Esse método tem como objetivo, Cadastrar ou Atualizar os Dados de Quitação em uma determinada Operação de Transporte.

Quitação - Observações Importantes

Para fazer uso do Módulo de Quitação, o Cliente deverá estar parametrizado para tal (O Cliente deverá entrar em contato com o Time Comercial da TARGET).
Só deve-se fazer uso desse método, quando uma Operação de Transporte estiver com o Status: Declarado.
A Quitação só poderá ser realizada dentro de Operações de Transportes do Tipo Padrão.
Para uma Operação de Transporte que foi declarada sem Dados de Quitação, poderá ser informado tais dados para a Operação de Transporte desejada, fazendo uso desse método.
1. Quando a Operação de Transporte conter Quitação e o usuário quiser atualizar os dados de Quitação, o usuário não poderá atualizar os seguintes dados:
  1. ValorMercadoria - Valor da Mercadoria em Nota
  2. PesoCarregadoMercadoria - Peso da Mercadoria Carregada
  3. QuantidadeCarregada - Quantidade Carregada (Unidade)
Considerações sobre Parcela de Pagamento:
1. A Quitação sempre será deduzida na Parcela de Pagamento do Tipo: Saldo.
2. Não tem como fazer uso da Quitação se a Operação de Transporte não conter uma Parcela de Pagamento do Tipo: Saldo.
3. A Parcela de Pagamento do Tipo: Saldo, não pode ser automática, ela deverá ser cadastrada como manual - Método - 'CadastrarAtualizarOperacaoTransporte', TAG - 'ProcessarAutomaticamente'.
Observações sobre o Pagamento mínimo da Parcela de Saldo (O Bradesco permite apenas o pagamento mínimo nos cartões no valor de R$5,00.):
1. Se o valor for 0 ou negativo:
  1. A Parcela de Pagamento do Tipo: Saldo, será dada como paga (Obs: O controle financeiro ficará com o cliente).
2. Se o valor for de R$0,01 até R$4,99:
  1. A Parcela será paga no valor mínimo de R$5,00(Obs: O controle financeiro ficará com o cliente).
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
CadastroAtualizacaoDadosQuitacaoRequest
1	IdOperacaoTransporte	int	Sim	Id da Operação de Transporte.	N/A
2	DadosQuitacao	DadosQuitacaoFreteRequest	Sim	Dados de Quitação	N/A

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
DadosQuitacaoFreteRequest
1	ValorMercadoria	decimal	Sim	Valor da Mercadoria	N/A
2	PesoCarregadoMercadoria	decimal	Sim	Peso Carregado da Mercadoria	N/A
3	QuantidadeCarregada	int	Sim	Quantidade Carregada	N/A
4	TipoCalculoAvaria	int	Não	Tipo Cálculo Avaria	Por Valor = 1 Por Peso = 2 Por Unidade = 3 Nenhum = 4
5	EncerraNaANTT	bool(true \|\| false)	Sim	Encerra na ANTT	N/A
6	PorcentagemToleranciaPeso	decimal	Não	Porcentagem Tolerância Peso	N/A
7	TipoToleranciaPeso	int	Sim	Tipo Tolerância Peso	Integral = 1 Excedente = 2 Nenhum = 3
8	PorcetagemPesoAMaior	decimal	Não	Porcentagem Peso A Maior	N/A
9	DocumentosQuitacao	List<DadosQuitacaoFreteDocumentosResponse>	Sim	Documentos de Quitação	N/A
10	IdsTerminaisCarregamento	List<int>	Sim	Ids Terminais de Carregamento Retorno dos Ids no método - 'BuscarTerminaisCarregamentoAutorizados'	N/A
11	QuitaEmTodosTerminais	bool(true \|\| false)	Sim	Quita Em todos os Terminais	N/A

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
DadosQuitacaoFreteDocumentosRequest
1	NomeDocumento	string	Não	Nome Documento	N/A
2	NumeroIdentificadorDocumento	string	Sim	Número Identificador Documento	N/A
3	Obrigatorio	bool(true \|\| false)	Sim	Obrigatório	N/A
4	DocumentoGeradoDestino	bool(true \|\| false)	Não	Documento Gerado Destino	N/A

Response

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
DadosQuitacaoFreteResponse
1	Erro	ErroResponse - string	Não	Retorna o Erro.	NULO em caso de sucesso.
2	MensagemRetorno	int	Sim	Mensagem de Retorno	N/A
3	IdOperacao	int	Sim	Retorna o Id da Operação de Transporte	N/A
4	dadosQuitacao	DadosQuitacaoFreteResponse	Sim	Dados de Quitação	N/A

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
CadastroAtualizacaoDadosQuitacaoResponse
1	ValorMercadoria	decimal	Sim	Retorna o Valor da Mercadoria	N/A
2	PesoCarregadoMercadoria	decimal	Sim	Retorna o Peso Carregado da Mercadoria	N/A
3	QuantidadeCarregada	int	Sim	Retorna a Quantidade Carregada	N/A
4	TipoCalculoAvaria	int	Não	Retorna o Tipo Cálculo Avaria	N/A
5	EncerraNaANTT	bool(true \|\| false)	Sim	Retorna - Encerra na ANTT	N/A
6	PorcentagemToleranciaPeso	decimal	Não	Retorna a Porcentagem Tolerância Peso	N/A
7	TipoToleranciaPeso	int	Sim	Retorna o Tipo Tolerância Peso	N/A
8	PorcetagemPesoAMaior	decimal	Não	Retorna Porcentagem Peso A Maior	N/A
9	DocumentosQuitacao	List<DadosQuitacaoFreteDocumentosResponse>	Sim	Retorna Documentos de Quitação	N/A
10	IdsTerminaisCarregamento	List<int>	Sim	Retorna Ids Terminais de Carregamento	N/A
11	QuitaEmTodosTerminais	bool(true \|\| false)	Sim	Retorna Quita Em todos os Terminais	N/A

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
DadosQuitacaoFreteDocumentosResponse
1	NomeDocumento	string	Não	Nome Documento	N/A
2	NumeroIdentificadorDocumento	string	Sim	Número Identificador Documento	N/A
3	Obrigatorio	bool(true \|\| false)	Sim	Obrigatório	N/A

Método

Abaixo, segue o método - 'CadastrarAtualizarDadosQuitacaoOperacaoTransporte'.

CadastrarAtualizarDadosQuitacaoOperacaoTransporte

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
   <soapenv:Header/>
   <soapenv:Body>
      <tms:CadastrarAtualizarDadosQuitacaoOperacaoTransporte>
         <tms:auth>
            <tms:Usuario>?</tms:Usuario>
            <tms:Senha>?</tms:Senha>
            <tms:Token>?</tms:Token>
         </tms:auth>
         <tms:dadosQuitacaoRequest>
            <tms:IdOperacaoTransporte>?</tms:IdOperacaoTransporte>
            <tms:DadosQuitacao>
               <tms:ValorMercadoria>?</tms:ValorMercadoria>
               <tms:PesoCarregadoMercadoria>?</tms:PesoCarregadoMercadoria>
               <tms:QuantidadeCarregada>?</tms:QuantidadeCarregada>
               <tms:TipoCalculoAvaria>?</tms:TipoCalculoAvaria>
               <tms:EncerraNaANTT>?</tms:EncerraNaANTT>
               <tms:PorcentagemToleranciaPeso>?</tms:PorcentagemToleranciaPeso>
               <tms:TipoToleranciaPeso>?</tms:TipoToleranciaPeso>
               <tms:PorcetagemPesoAMaior>?</tms:PorcetagemPesoAMaior>
               <tms:DocumentosQuitacao>
                  <tms:DadosQuitacaoFreteDocumentosRequest>
                     <tms:NomeDocumento>?</tms:NomeDocumento>
                     <tms:NumeroIdentificadorDocumento>?</tms:NumeroIdentificadorDocumento>
                     <tms:Obrigatorio>?</tms:Obrigatorio>
                     <tms:DocumentoGeradoDestino>?</tms:DocumentoGeradoDestino>
                  </tms:DadosQuitacaoFreteDocumentosRequest>
               </tms:DocumentosQuitacao>
               <tms:IdsTerminaisCarregamento>
                  <arr:int>?</arr:int>
               </tms:IdsTerminaisCarregamento>
               <tms:QuitaEmTodosTerminais>?</tms:QuitaEmTodosTerminais>
            </tms:DadosQuitacao>
         </tms:dadosQuitacaoRequest>
      </tms:CadastrarAtualizarDadosQuitacaoOperacaoTransporte>
   </soapenv:Body>
</soapenv:Envelope>