TOTVS Varejo Franquias e Redes

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 3

changes.mady.by.user Ricardo Bortoti da Silva

Gravado em

comparado com

Nova versão 4

changes.mady.by.user Ricardo Bortoti da Silva

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Informações
iconfalse

O método Rest <Informe o nome do Método> Rest orders Operação "Post" disponível do TOTVS Customer Services tem a função de incluir um novo pedido gerado por sistemas externos dentro da solução do Customer Services.

...

</pAut>

<parametroCliente>

<DTNascimento>

</DTNascimento>

Informações
titleCampos de retorno
Pivot Table
id1581521954499_556941873


Abaixo sera apresentado os campos existentes no método e informações de uso.


DtoOrder<CriaClienteParametro>
<pAut>

Campo

Tipo

ObrigatórioInformaçõesExemplo de preenchimentoValor fixo
Canal
CompanyIdString
varchar(10)
Sim
Canal usado para efetuar a operação<tem:Canal>3</tem:Canal>Usuariovarchar(50)

Sim

Usuário de login para uso do método<tem:Usuario>user</tem:Usuario>senhanvarchar(200)SimSenha do usuário para uso do Método<tem:Senha>senhauser</tem:Senha>

Campo

Tipo

ObrigatórioInformaçõesExemplo de preenchimentoValor fixo
Cartaovarchar(36)SimInformação do Cartão do Cliente. Na integração deve ser enviado vazio<tem:Cartao></tem:Cartao>Cpfvarchar(20)

Sim

CPF do cliente<tem:Cpf>20960430261</tem:Cpf>Nomevarchar(50))SimPrimeiro Nome do Cliente<tem:Nome>Ana</tem:Nome>Sobrenomevarchar(50)ConfigurávelSobre nome do Cliente<tem:Sobrenome>Silva</tem:Sobrenome>Logradourovarchar(150)ConfigurávelEndereço: Logradouro

<tem:Logradouro>Rua</tem:Logradouro>

NumeroEnderecovarchar(10)ConfigurávelEndereço: Número do Endereço<tem:NumeroEndereco>1</tem:NumeroEndereco>Complementovarchar(3)ConfigurávelEndereço: Complemento<tem:Complemento></tem:Complemento>
Paisvarchar(50)ConfigurávelEndereço: País<tem:Pais>Brasil</tem:Pais>Brasil
Bairrovarchar(150)ConfigurávelEndereço: Bairro<tem:Bairro>Bairro</tem:Bairro>Cidadevarchar(50)ConfigurávelEndereço: Cidade<tem:Cidade>jundiai</tem:Cidade>Cepvarchar(8)ConfigurávelEndereço: CEP somente número<tem:Cep>11111111</tem:Cep>Ufvarchar(3)ConfigurávelEndereço: Sigla Estado<tem:Uf>SP</tem:Uf>

Campo

Tipo

ObrigatórioInformaçõesExemplo de preenchimentoValor fixo
DiaintSimdia do nascimento Cliente<tem:Dia>1</tem:Dia>Mesint

Sim

mês do nascimento cliente<tem:Mes>1</tem:Mes>AnointSimAno do nascimento cliente<tem:Ano>2000</tem:Ano>

Campo

Tipo

ObrigatórioInformaçõesExemplo de preenchimentoValor fixo
SexointSimValor 1 para Masculino
Valor 2 para Feminino		<tem:Sexo>1</tem:Sexo>DDDResvarchar(3)NãoDDD Residencial. Obrigatório 3 dígitos<tem:DDDRes>011</tem:DDDRes>TelefoneResvarchar(15)NãoTelefone Residencial<tem:TelefoneRes>454447638</tem:TelefoneRes>DDDComvarchar(3)NãoDDD Comercial. Obrigatório 3 dígitos<tem:DDDCom>011</tem:DDDCom>TelefoneComvarchar(15)NãoTelefone Comercial<tem:TelefoneCom>464447638</tem:TelefoneCom>DDDCelvarchar(3)ConfigurávelDDD Celular. Obrigatório 3 dígitos<tem:DDDCel>011</tem:DDDCel>TelefoneCelvarchar(15)ConfigurávelTelefone Celular<tem:TelefoneCel>941707030</tem:TelefoneCel>Emailvarchar(50)ConfigurávelEmail do Cliente<tem:Email>email@email.com.br</tem:Email>AtualizaintSimValor 1 = Atualiza dados caso o cliente exista
Valor 0 = Não atualiza cliente existente		<tem:Atualiza>1</tem:Atualiza>EnviarEmailintSimParâmetro para identificar se o cliente deseja receber e-mail de campanhas, promoções, novidades etc.<tem:EnviarEmail>1</tem:EnviarEmail>
Numero da Master do Live

"CompanyId": "220000002"


BranchId

StringSimNumero da Unidade de negócio(Loja) que está fazendo o Pedido

"BranchId": "9017986"


CustomerOrderIdStringSimNumero do pedido no sistema que está chamando

"CustomerOrderId":"v82908980bot-01"

revisar
RegisterDateDateTimeSimData de Inclusão do Pedido

"RegisterDate":"2019-05-27T00:00:00"


OrderIdStringSimNumero do Pedido

"OrderId":"v82908980bot-01"


RegisterHourStringSimHora de Inclusão do Pedido

"RegisterHour":"19:05:44"


SalesChannelStringSim

"SalesChannel":"2"

revisar
StatusIntegerSim

Status do Pedido :

EmAberto = 1,

Bloqueado = 2,

Liberado = 3,

LiberadoFinanceiro = 4,

LiberadoFinanceiroComercial = 5,

Suspenso = 6,

Cancelado = 7,

PedidoRecebido = 90,

ConfirmadoLoja = 91,

Faturado = 92,

EmFaturamento = 93,

EmSeparacao = 94,

PedidoDevolvido = 100

"Status":90


dhinideliveryDateTimeNãoData de Inicio de Entrega

"dhinidelivery": "2020-03-27T21:19:55.801Z"


dhfindeliveryDateTimeNãoData de Fim de Entrega

"dhfindelivery": "2020-03-27T21:19:55.801Z"


CustomerCodeStringSimCódigo do cliente

"CustomerCode":"20103464832"


OrderItemAmountDecimalNãoValor dos Itens do pedido

"OrderItemAmount":10.90


SalesOrderItensObjetoSimOs Itens do pedido

"SalesOrderItens":{
      "Item":[
         {
            "CompanyId":"220000002",
            "BranchId":"9017986",
            "OrderId":0,
            "OrderItem":"1",
            "typecodprod":0,
            "ItemCode":"72056",
            "Quantity":1.0,
            "typepacking":0,
            "UnityPrice":10.9,
            "netunitaryprice":10.9,
            "TotalPrice":10.9
         }
      ]
   }



SalesOrderItens : Item

CodigoLojavarchar(20)SimNúmero de Série da loja no Fidelidade<tem:CodigoLoja>12414</tem:CodigoLoja><Data>

Campo

Tipo

ObrigatórioInformaçõesExemplo de preenchimentoValor fixoDiaintSimdia de cadastro Cliente<tem:Dia>1</tem:Dia>Mesint

Sim

mês de cadastro cliente<tem:Mes>1</tem:Mes>AnointSimAno de cadastro cliente<tem:Ano>2000</tem:Ano>

</Data>

<Hora>

Campo

Tipo

ObrigatórioInformaçõesExemplo de preenchimentoValor fixo
Dia
CompanyId
int
StringSim
dia de cadastro Cliente<tem:Dia>1</tem:Dia>Mesint

Sim

mês de cadastro cliente<tem:Mes>1</tem:Mes>AnointSimAno de cadastro cliente<tem:Ano>2000</tem:Ano>HoraintSimHora de cadastro cliente<tem:Hora>12</tem:Hora>MinintSimMinuto de cadastro cliente<tem:Min>12</tem:Min>SegintSimSegundo de cadastro cliente<tem:Seg>12</tem:Seg>

</Hora>

Campo

Tipo

ObrigatórioInformaçõesExemplo de preenchimentoValor fixointencaointSimSe o cliente possui intenção de ser Fidelidade
Valor 1 para Sim
Valor 0 para Não<tem:Intencao>1</tem:Intencao>1

<DataIntencao>

Campo

Tipo

ObrigatórioInformaçõesExemplo de preenchimentoValor fixoDiaintSimdia de cadastro Cliente<tem:Dia>1</tem:Dia>Mesint

Sim

mês de cadastro cliente<tem:Mes>1</tem:Mes>AnointSimAno de cadastro cliente<tem:Ano>2000</tem:Ano>

</DataIntencao>

Campo

Tipo

ObrigatórioInformaçõesExemplo de preenchimentoValor fixoCodigoEscolaridadevarchar(10)SimInformação interna do sistema. Valor fixo -1<tem:CodigoEscolaridade>-1</tem:CodigoEscolaridade>-1CodigoProfissaovarchar(10)SimInformação interna do sistema. Valor fixo -1<tem:CodigoProfissao>-1</tem:CodigoProfissao>-1CanalTransacaovarchar(10)SimCanal onde ocorreu a transação. Cada ambiente na implantação possui seus próprios códigos. o código 1 é o padrão do sistema de Vendas (PDV) . Deve ser usado o mesmo valor da TAG <Canal><tem:CanalTransacao>1</tem:CanalTransacao>EnvComunicacaovarchar(3)NãoParâmetro para identificar se o cliente deseja receber e-mail, msg ou mala direta de campanhas, promoções, novidades etc.<tem:EnvComunicacao>1</tem:EnvComunicacao>CpfFuncionariovarchar(15)NãoCPF do Funcionário/Operador que efetuou o cadastros<tem:CpfFuncionario>36106284888</tem:CpfFuncionario>

</parametroCliente>
</CriaClienteParametro>

Numero da Master do Live

"CompanyId": "220000002"


BranchId

StringSimNumero da Unidade de negócio(Loja) que está fazendo o Pedido

"BranchId": "9017986"


OrderIdStringSimNumero do Pedido

"OrderId":"v82908980bot-01"


OrderItem StringSimNumero do Item

"OrderItem":"1"


ItemCode StringSimCodigo do Produto

"ItemCode":"72056"


Quantity DecimalSimQuantidade

"Quantity":1.0


UnityPrice DecimalSimPreço Unitário

"UnityPrice":10.9


TotalPriceDecimalSimValor Total do Item

"TotalPrice":10.9


Informações
titleExemplo de Chamada do Método
Bloco de código
languagejs
titleChamada: XMLJson
{
   "CompanyId":"220000002",<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/">
   <soapenv:Header/>"BranchId":"9017986",
   <soapenv:Body>"CustomerOrderId":"v82908980bot-01",
      <tem:CriaClienteParametro>
         <tem:pAut>
            <tem:Canal>3</tem:Canal>
            <tem:Usuario>user</tem:Usuario>
            <tem:Senha>senhauser</tem:Senha>
         </tem:pAut>
         <tem:parametroCliente>
            <tem:Cartao></tem:Cartao>
            <tem:Cpf>20960430261</tem:Cpf>
            <tem:Nome>Pedro</tem:Nome>
            <tem:Sobrenome>Costa</tem:Sobrenome>
            <tem:Logradouro>Rua miranda</tem:Logradouro>
            <tem:NumeroEndereco>1</tem:NumeroEndereco>
            <tem:Complemento></tem:Complemento>
            <tem:Pais>Brasil</tem:Pais>
            <tem:Bairro>Bairro</tem:Bairro>"RegisterDate":"2019-05-27T00:00:00",
   "OrderId":"v82908980bot-01",
   "RegisterHour":"19:05:44",
   "dhinidelivery":"0001-01-01T00:00:00",
   "dhfindelivery":"0001-01-01T00:00:00",
   "SalesChannel":"2",
   "Status":90,
   "CustomerCode":"20103464832",
   "OrderItemAmount":10.90,
   "SalesOrderItens":{
      "Item":[
            <tem:Cidade>jundiai</tem:Cidade>{
            <tem:Cep>13219240</tem:Cep>"CompanyId":"220000002",
            <tem:Uf>SP</tem:Uf>"BranchId":"9017986",
            <tem:DtNascimento>"OrderId":0,
               <tem:Dia>2</tem:Dia>"OrderItem":"1",
               <tem:Mes>3</tem:Mes>"typecodprod":0,
               <tem:Ano>1988</tem:Ano>"ItemCode":"72056",
            </tem:DtNascimento>"Quantity":1.0,
            <tem:Sexo>1</tem:Sexo>"typepacking":0,
            <tem:DDDCel>011</tem:DDDCel>"UnityPrice":10.9,
            <tem:TelefoneCel>941707232</tem:TelefoneCel>"netunitaryprice":10.9,
            <tem"TotalPrice":Email>[email protected]</tem:Email>10.9
            <tem:Atualiza>1</tem:Atualiza>}
            <tem:EnviarEmail>1</tem:EnviarEmail>]
            <tem:CodigoLoja>12414</tem:CodigoLoja>
            <tem:Data>
               <tem:Dia>18</tem:Dia>
               <tem:Mes>6</tem:Mes>
               <tem:Ano>2020</tem:Ano>
            </tem:Data>
            <tem:Hora>
               <tem:Dia>18</tem:Dia>
               <tem:Mes>6</tem:Mes>
               <tem:Ano>2020</tem:Ano>
               <tem:Hora>12</tem:Hora>
               <tem:Min>00</tem:Min>
               <tem:Seg>00</tem:Seg>
            </tem:Hora>
            <tem:Intencao>1</tem:Intencao>
            <tem:DataIntencao>
               <tem:Dia>18</tem:Dia>
               <tem:Mes>6</tem:Mes>
               <tem:Ano>2020</tem:Ano>
            </tem:DataIntencao>
            <tem:CodigoEscolaridade>-1</tem:CodigoEscolaridade>
            <tem:CodigoProfissao>-1</tem:CodigoProfissao>
            <tem:CanalTransacao>3</tem:CanalTransacao>
            <tem:EnvComunicacao>1</tem:EnvComunicacao>
            <tem:CpfFuncionario>36006284880</tem:CpfFuncionario>
         </tem:parametroCliente>
      </tem:CriaClienteParametro>
   </soapenv:Body>
</soapenv:Envelope>}
}
Bloco de código
titleRetorno:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <CriaClienteParametroResponse xmlns="http://tempuri.org/">
         <CriaClienteParametroResult>
            <Status>0</Status>
            <Descricao>OK</Descricao>
            <NumeroGerado/>
            <CodObjeto>cec98b7bfe0b4281ae526e2840959834</CodObjeto>
         </CriaClienteParametroResult>
      </CriaClienteParametroResponse>
   </soap:Body>
</soap:Envelope>