DOCUMENTAÇÃO CORPORATIVA

CadastrarAtualizarCentroDeCusto

Objetivo

Esse método tem como objetivo realizar o cadastro ou a atualização de um Centro de Custo.


Observações

  1. 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

CentroDeCustoRequest
CampoTipoObrigatórioDescriçãoObservação
1InstrucaointSimInstrução do que fazer com os dados.1= Inserir ou Atualizar
2= Inserir se não existe
4= Desativar/Anular
2IdCentroDeCustointNãoId do Centro de Custo na TARGET

Usado apenas para a atualização

de um centro de custo.

Informaremos o IdCentroDeCusto no

response do método -

'CadastrarAtualizarCentroDeCusto'.

3CodigostringSimCódigo personalizado para o centro de custo.O Cliente é quem deve informar.
4DescricaostringSimDescrição simplificada do Centro de CustoComo se fosse o Nome do Centro
de Custo
5ComentariostringSimComentário ou descrição detalhada do Centro de CustoN/A
6Ativobool(true || false)SimCadastro Ativo ou NãoN/A

Response

CentroDeCustoResponse
CampoTipoObrigatórioDescriçãoObservação
1ErroErroResponse - stringNãoMensagem de ErroNULO em caso de sucesso.
2IdCentroDeCustointSimId do Centro de Custo na TARGETN/A
3CodigostringSimCódigo personalizado para o centro de custo.N/A
4DescricaostringSimDescrição simplificada do Centro de CustoN/A
5ComentariostringSimComentário ou descrição detalhada do Centro de CustoN/A
6Ativobool(true || false)SimCadastro Ativo ou NãoN/A

Método

CentroDeCustoRequest
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br">
   <soapenv:Header/>
   <soapenv:Body>
      <tms:CadastrarAtualizarCentroDeCusto>
         <tms:auth>
            <tms:Usuario>?</tms:Usuario>
            <tms:Senha>?</tms:Senha>
            <tms:Token>?</tms:Token>
         </tms:auth>
         <tms:centro>
            <tms:Instrucao>?</tms:Instrucao>
            <tms:IdCentroDeCusto>?</tms:IdCentroDeCusto>
            <tms:Codigo>?</tms:Codigo>
            <tms:Descricao>?</tms:Descricao>
            <tms:Comentario>?</tms:Comentario>
            <tms:Ativo>?</tms:Ativo>
         </tms:centro>
      </tms:CadastrarAtualizarCentroDeCusto>
   </soapenv:Body>
</soapenv:Envelope>

Cadastro

Abaixo, segue exemplo do cadastro de um Centro de Custo.

Cadastrar - CentroDeCustoRequest
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:CadastrarAtualizarCentroDeCusto>
         <tms:auth>
            <tms:Usuario>tms.exemplo</tms:Usuario>
            <tms:Senha>v0hXPK4234bla2Bs=</tms:Senha>
            <tms:Token i:nil="true" />
         </tms:auth>
         <tms:centro>
            <tms:Instrucao>2</tms:Instrucao>
            <tms:IdCentroDeCusto i:nil="true" />
            <tms:Codigo>7095</tms:Codigo>
            <tms:Descricao>TimeDeIntegração</tms:Descricao>
            <tms:Comentario>Custos relacionados ao Time de Integração.</tms:Comentario>
            <tms:Ativo>true</tms:Ativo>
         </tms:centro>
      </tms:CadastrarAtualizarCentroDeCusto>
   </soapenv:Body>
</soapenv:Envelope>       


Response
            

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <CadastrarAtualizarCentroDeCustoResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
         <CadastrarAtualizarCentroDeCustoResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <Erro i:nil="true"/>
            <IdCentroDeCusto>149</IdCentroDeCusto>
            <Codigo>7095</Codigo>
            <Descricao>TimeDeIntegração</Descricao>
            <Comentario>Custos relacionados ao Time de Integração.</Comentario>
            <Ativo>true</Ativo>
         </CadastrarAtualizarCentroDeCustoResult>
      </CadastrarAtualizarCentroDeCustoResponse>
   </s:Body>
</s:Envelope>

Atualizar

Abaixo, segue exemplo de atualização do cadastro de um Centro de Custo.

Atualizar - CentroDeCustoRequest
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:CadastrarAtualizarCentroDeCusto>
         <tms:auth>
            <tms:Usuario>tms.exemplo</tms:Usuario>
            <tms:Senha>v0hXPK4234bla2Bs=</tms:Senha>
            <tms:Token i:nil="true" />
         </tms:auth>
         <tms:centro>
            <tms:Instrucao>1</tms:Instrucao>
            <tms:IdCentroDeCusto i:nil="true" />
            <tms:Codigo>7095</tms:Codigo>
            <tms:Descricao>TimeDeIntegração</tms:Descricao>
            <tms:Comentario>Custos relacionados ao Time de Integração, tais como: colaboradores; computadores.</tms:Comentario>
            <tms:Ativo>true</tms:Ativo>
         </tms:centro>
      </tms:CadastrarAtualizarCentroDeCusto>
   </soapenv:Body>
</soapenv:Envelope>       


Response
            

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <CadastrarAtualizarCentroDeCustoResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
         <CadastrarAtualizarCentroDeCustoResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <Erro i:nil="true"/>
            <IdCentroDeCusto>149</IdCentroDeCusto>
            <Codigo>7095</Codigo>
            <Descricao>TimeDeIntegração</Descricao>
            <tms:Comentario>Custos relacionados ao Time de Integração, tais como: colaboradores; computadores.</tms:Comentario>
            <Ativo>true</Ativo>
         </CadastrarAtualizarCentroDeCustoResult>
      </CadastrarAtualizarCentroDeCustoResponse>
   </s:Body>
</s:Envelope>

Anular

Abaixo, segue exemplo para anular o cadastro de um Centro de Custo.

Anular - CentroDeCustoRequest
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:CadastrarAtualizarCentroDeCusto>
         <tms:auth>
            <tms:Usuario>tms.exemplo</tms:Usuario>
            <tms:Senha>v0hXPK4234bla2Bs=</tms:Senha>
            <tms:Token i:nil="true" />
         </tms:auth>
         <tms:centro>
            <tms:Instrucao>4</tms:Instrucao>
            <IdCentroDeCusto>149</IdCentroDeCusto>
         </tms:centro>
      </tms:CadastrarAtualizarCentroDeCusto>
   </soapenv:Body>
</soapenv:Envelope>    


Response