Árvore de páginas

Versões comparadas

Chave

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

O 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.
A chamada é feita na solução do Mozart, que é um enfileirador de mensagens e que tem como objetivo enviar/controlar os pedidos que serão integrados no Customer.

Nota
titlePré-requisitos
  •  Acesso ao método via API /CustomerService/api/orders
  •  Recebimento de autorizador para efetuar a chamada


         

Informações
iconfalse
titleExemplo de Utilização:

Uso Via sofwares SoapUI ou Postman

Exemplo de chamada via PostMan:


Image Added

Informações
titleCampos de retorno
Pivot Table
id1581521954499_556941873


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


DtoOrder

Campo

Tipo

ObrigatórioInformaçõesExemplo de preenchimentoValor fixo
CompanyIdStringSimNumero da companhia/grupo da
Master do Live
loja. 
No LIVE é o código da Master

"CompanyId""220000002"


BranchId

StringSimNumero da Unidade de negócio(Loja) que está fazendo o Pedido. No LIVE é o número de série da loja.

"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

No Processo tradicional o status deve ser enviado com valor "1". Mas caso o sistema externo fará também o processo de separação, poderá enviar ao LIVE com o Status "90".

Em Aberto = 1,
Bloqueado = 2,
Liberado = 3,

LiberadoFinanceiro

Liberado Financeiro = 4,

LiberadoFinanceiroComercial

Liberado Financeiro Comercial = 5,
Suspenso = 6,
Cancelado = 7,

PedidoRecebido

Pedido Recebido = 90,

ConfirmadoLoja

Confirmado Loja = 91,
Faturado = 92,

EmFaturamento

Em Faturamento = 93,

EmSeparacao

Em Separação = 94,

PedidoDevolvido

Pedido Devolvido = 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"


CustomerCodeStringSim
Código do cliente
Identificação do Cliente, usado para informar o CPF.

"CustomerCode":"20103464832"


OrderItemAmountDecimalNãoValor Totais dos Itens do pedido

"OrderItemAmount":10.90


SalesOrderItensObjetoSim
Os
A lista dos Itens do
pedido
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

Campo

Tipo

ObrigatórioInformaçõesExemplo de preenchimentoValor fixo
CompanyIdStringSimNumero 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 Código do Produto

"ItemCode":"72056"


Quantity DecimalSimQuantidade

"Quantity":1.0


UnityPrice DecimalSimPreço Unitário

"UnityPrice":10.9


TotalPriceDecimalSimValor Total do Item

"TotalPrice":10.9


...