A integração consiste em receber e enviar dados do pedido que será incluído no winthor. Totvs custom tabs box items |
---|
default | yes |
---|
referencia | passo1 |
---|
| Os dados integrados são: API | Descrição | Coluna | Tipo | Obrigatório | situacaoPreVenda | 0 = CANCELADA 1 = RECEBIDO 2 = DISPONIVEL 3 = RESGATADAint | SIM | numero | Identificação do pedido no PDV. | PCPEDC.NUMPEDHUBE | String | SIM | modalidadeFrete | Utiliza despacho de frete (freteiros) Valores: "C" - CIF - Contratação do Frete por conta do Remetente ( modalidadeFrete= 0) "F" - FOB - Contratação do Frete por conta do Destinatário ( modalidadeFrete= 1) "T" - Contratação do Frete por conta de Terceiros ( modalidadeFrete= 2) "R" - Transporte Próprio por conta do Remetente ( modalidadeFrete= 3) "D" - Transporte Próprio por conta do Destinatário ( modalidadeFrete= 4) "G" - Gratuito - Sem Ocorrência de Transporte ( modalidadeFrete= 9) | PCPEDC.FRETEDESPACHO | int | NÃO | observacoes | PCPEDC.OBS | NÃO | idOperadorRetaguarda | Matricula do funcionário. Caso não informado irá usar o RCA do parâmetro 4012. | PCPEDC.CODUSUR | long | NÃO | idLojaRetaguarda | Código da filial. | SIM | preVendaItens.*.quantidade | Deve ser maior que zero. | PCPEDI.QT | int | SIM | preVendaItens.*.preco | Deve ser maior que zero. | PCPEDI.PVENDA | SIM | preVendaItens.*.desconto | Valor de desconto. | NÃO | preVendaItens.*.descontoPercentual | Percentual de desconto. | NÃO | preVendaItens.*.idProdutoRetaguarda | Código auxiliar mais o código do produto. Ex: 123-1. | PCPEDI.CODPROD | SIM | preVendaItens.*.idVendedorRetaguarda | NÃO | preVendaItens.*.entrega.idRetaguardaLojaEntrega | Código da filial retira. | PCPEDI.CODFILIAL | SIM | preVendaItens.*.entrega.tipoEntrega | 0 = RETIRA_IMEDIATA("RI", "Retira Imediata"), 1 = RETIRA_POSTERIOR("RP", "Retira Posterior"), 2 = ENTREGA_NORMAL("EN", "Entrega Normal") 3 = ENCOMENDA("EF", "Encomenda") | PCPEDI.TIPOENTREGA | SIM | preVendaItens.*.entrega.dataEntrega | Data da entrega do item | PCPEDI.DTENTREGA | cliente | Caso não seja informado o cliente será usado o cliente consumidor final. Caso o cliente esteja com o cadastro completo, ele já será gravado na base do winthor . | NÃO | cliente.bairro | Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque | NÃO | cliente.telefone | Caso não preenchido será usado o campo celular | NÃO | cliente.celular | Caso não preenchido será usado o campo telefone | NÃO | cliente.cep | Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque | NÃO | cliente.cidade | Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque | NÃO | cliente.complemento | NÃO | cliente.cpfCnpj | Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque Caso já exista um cliente com mesmo CGC e o idRetaguarda não seja informado será usado o cliente mais antigo que contém o mesmo CGC NÃO | cliente.email | Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque | NÃO | cliente.endereco | Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque | NÃO | cliente.estado | Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque | NÃO | cliente.idRetaguarda | Código cliente | NÃO | cliente.numero | NÃO | VendaPagamentos.valorLiquido | Valor líquido | PCFORMAPGTOPEDIDO.VALOR | SIM | VendaPagamentos.pagamentoForma.idRetaguarda | Forma de pagamento | PCFORMAPGTOPEDIDO.CODCOB | SIM | VendaPagamentos.pagamentoForma.descricao | Descrição da forma de pagamento | NÃO | VendaPagamentos.vendaPagamentoItems.valorParcela | Valor da parcela | PCFORMAPGTOPEDIDO.VALOR (Só utilizado caso cobrança cartão com parcelas) | NÃO | VendaPagamentos.vendaPagamentoItems.dataVencimento | Data de vencimento da parcelaVLFRETE | PCFORMAPGTOPEDIDO.DTVENC (Só utilizado caso cobrança cartão com parcelas) | NÃO | PreVendaPagamentos.vendaPagamentoTefs.nsuHost | NSU | PCFORMAPGTOPEDIDO.NSU (Só utilizado caso cobrança cartão com parcelas) | NÃO | Caso seja enviado o valor do frete maior que zero, o campo (PCPEDC.DTCALCFRETE) será preenchido. | PCPEDC.DTCALCFRETE | Data (DD/MM/YYY) | NÃO | Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo2 |
---|
| Exemplo do envio da requisição: Bloco de código |
---|
| method: 'POST',
url: '/api/wholesale/v1/orders/pdvsync'
|
Bloco de código |
---|
language | js |
---|
title | Body Request |
---|
| {
"NumeroVenda": null,
"TipoPreVenda": 1,
"Data": "2023-04-13T16:33:29.946503",
"CpfConsumidor": null,
"CpfCliente": "03425067141",
"DescontoTotal": 0.0,
"TotalLiquido": 6.130000,
"TotalBruto": 6.130000,
"IdLojaRetaguarda": 1,
"CodigoPromocional": null,
"situacaoPreVenda": "RECEBIDO",
"modalidadeFrete": "2",
"NomeConsumidor": null,
"EnderecoCliente": "RUA GIOTO",
"NomeCliente": "Cliente 0123",
"IdOperadorRetaguarda": 1,
"SistemaOrigem": 1,
"TerminalOrigem": null,
"TipoEntrega": 0,
"Sincronizado": 0,
"TipoDescontoAcrescimo": null,
"DescontoPercentualTotal": 0.0,
"IdMotivoDesconto": null,
"DescricaoMotivoDescontoAcrescimo": null,
"IdTransacaoMotorPromocaoTerceiro": null,
"SerieVenda": null,
"NumeroAutorizacao": null,
"TipoVenda": 1,
"TipoCancelamento": null,
"IdCanalVenda": null,
"DescontoMotorPromocaoAplicado": false,
"PreVendaItens": [
{
"quantidade": 1.0,
"preco": 24.9,
"desconto": 0.0,
"descontoPercentual": 0.0,
"idProdutoRetaguarda": "3-3",
"idVendedorRetaguarda": "1",
"entrega": {
"idLojaEntregaRetaguarda": "1",
"TipoEntrega": 1,
"dataEntrega": "2022-04-25T17:08:56.18511"
}
}
],
"vendaPagamentos": [
{
"valorLiquido": 1.0,
"valorPago": 24.9,
"valorTroco": 0.0,
"idPagamentoCondicaoRetaguarda": 0.0,
"pagamentoForma":
{
"descricao": "DINHEIRO EM TRANSITO",
"idRetaguarda": "DH"
},
"vendaPagamentoItems": [
{
"dataVencimento": "2022-05-10T17:08:56.18511",
"valorParcela": 24.9,
- Código da Filial **requerido**
cpfCliente "numeroParcela": 1
String - CPF ou CNPJ do }cliente
nomeCliente : ]
String }
- ],
"Cliente": {
"Nome": "Cliente alterar",
Nome do Cliente
idOperadorRetaguarda : String "Endereco": "RUA GIOTO",
"Numero": "S/N",
- Código do Vendedor no WinThor
dataInicio "Complemento": "",
"Bairro": "SETOR GENTIL",
Timestamp "Cidade": "GOIANIA",
- Data inicial da busca (Formato: 2023-07-25T11:43:45.086336)
dataFim "Estado": "GO",
"Cep": "74916-100",
Timestamp "Telefone": "",
- Data final da busca (Formato: 2023-07-25T11:43:45.086336)
idClienteRetaguarda "Celular": "62900000000",
: 0 "Email": "[email protected]",
"DataNascimento": "2001-04-01T00:00:00",
"PessoaFisica": 1,
"CpfCnpj": "40141279079",
"RgInscricao": "6346333",
"Sexo": 2,
"EstadoCivil": 2,
"AvatarUrl": "",
"Enviarpnet": 0,
"Atividade": null,
"Cracha": null,
"Situacao": 1,
"Id": 4,
"IdRetaguarda": "00000000-0000-0000-0000-000000000000",
"DataCadastro": "2023-03-29T13:51:38.556565",
"DataAtualizacao": "2023-03-29T13:51:38.55657",
"_expandables": []
},
"Situacao": 0,
"IdRetaguarda": 54382,
"Id": "20230612140631122023235",
"numero": "20230612140631122023235",
"DataCadastro": "2023-04-13T16:32:45.651279",
"DataAtualizacao": "2023-04-13T16:33:30.123302",
"_expandables": []
} Código do Cliente no WinThor
rescueTv1 : false - Resgata pedido TV1 |
Bloco de código |
---|
language | js |
---|
title | Body Response |
---|
| {
"success": true,
"hasNext": false,
"message": "",
"data": [
{
"offline": false,
"idRetaguarda": "10000908",
"cliente": {
"nome": "CONSUMIDOR FINAL",
"cpfCnpj": "970.175.080-25"
},
"situacaoPreVenda": "DISPONIVEL",
"idLojaRetaguarda": "2",
"idOperadorRetaguarda": "10",
"totalLiquido": 75.22,
"descontoPercentualTotal": 9.991624,
| Bloco de código |
---|
language | js |
---|
title | Body Response |
---|
| {
"success": true,
"hasNext": false,
"message": "",
"data": {
"idRetaguardaPedidoacrescimoPercentualTotal": "1007217"0,
"clientetotalBruto": {83.57,
"idRetaguardaClientemultiplosPedidos": "770"false,
},
"messagedataCadastro": "",2023-08-02T23:27:00"
"success": true}
} ]
} |
| Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo3 |
---|
| Exemplo do envio da requisição: Bloco de código |
---|
language | text |
---|
title | URI lista de pedidospedido detalhado |
---|
| method: 'POSTGET',
url: '/apiwinthor/varejo/wholesalematcon/v1/orders/pdvsync/consulta/{idRetaguarda}'
|
Bloco de código |
---|
| idRetaguarda : 0 - Número do Pedido no WinThor
idLojaRetaguarda : 2 - Código da Filial **requerido**
cpfCliente : String - CPF ou CNPJ do cliente
nomeCliente : String - Nome do Cliente
idOperadorRetaguarda : String - Código do Vendedor no WinThor
dataInicio : Timestamp - Data inicial da busca (Formato: 2023-07-25T11:43:45.086336)
dataFim : Timestamp - Data final da busca (Formato: 2023-07-25T11:43:45.086336)
idClienteRetaguarda : 0 - Código do Cliente no WinThor | | {
"success": true,
"hasNext": false,
"message": "",
"data": {
"offline": false,
"idRetaguarda": "1002232",
"cliente": {
"nome": "CONSUMIDOR FINAL",
"endereco": "RUA 1",
"bairro": "CENTRO",
"cidade": "GOIANIA",
"estado": "GO",
"cep": "74825110",
"telefone": "6298754444",
"celular": "6298754444",
"email": "[email protected]",
"cpfCnpj": "97017508025",
"clienteAlterado": false | Bloco de código |
---|
language | js |
---|
title | Body Request |
---|
| {
"success": true,
"hasNext": false,
"message": "",
"data": [
{},
"situacaoPreVenda": "DISPONIVEL",
"offlinepreVendaItens": false,[
{
"idRetaguarda": "10000908",
"situacaoPreVendaquantidade": "DISPONIVEL"2.5,
"idLojaRetaguardapreco": "2"13.652100,
"idOperadorRetaguardadescontoPercentual": "10"0,
"totalLiquidoacrescimoPercentual": 75.220,
"descontoPercentualTotalquantidadeEncomenda": 9.9916240,
"acrescimoPercentualTotalidPreVenda": 0,
"totalBrutoidProdutoRetaguarda": 83.57"1",
"multiplosPedidosidProdutoEmbalagemRetaguarda": false"7891132010387",
"dataCadastroentrega": "2023-08-02T23:27:00"
{
}
]
} | Bloco de código |
---|
language | text |
---|
title | URI pedido detalhado |
---|
| method: 'POST',
url: '/api/wholesale/v1/orders/pdvsync/consulta/{idRetaguarda}'
| Bloco de código |
---|
language | js |
---|
title | Body Response |
---|
| {
"successidLojaEntregaRetaguarda": true"2",
"hasNext": false,
"messagetipoEntrega": "0",
"data": {
}
"offline": false},
{
"idRetaguarda": "10000908",
"clientequantidade": {1,
"nomepreco": "COD252.48,
10 - CLI DA FILIAL 7",
"enderecodescontoPercentual": "END. ENT. CLI.: 10",
0,
"numeroacrescimoPercentual": ""0,
"complementoquantidadeEncomenda": ""0,
"bairroidPreVenda": "BAIRRO ENT. CLI.: 10",
0,
"cidadeidProdutoRetaguarda": "55555-4551",
"estadoidProdutoEmbalagemRetaguarda": "GO55555-4551",
"cepentrega": "74000000",
{
"telefoneidLojaEntregaRetaguarda": "TELENT.: 102",
"celular "tipoEntrega": "TELENT.: 101",
"email": "[email protected]",
},
"cpfCnpjitensKit": "79.621.574/0007-22",
[
"idRetaguarda": "10",
{
"clienteAlterado": false
},
"situacaoPreVendaidProdutoRetaguarda": "DISPONIVEL7891132019045-4",
"preVendaItens": [
{
"sequencial": 1,
"quantidade": 1,
"preco": 7561.21547188,
"descontoquantidade": 0,2
"descontoPercentual": 10 },
"acrescimoPercentual": 0,
{
"quantidadeEncomendaidProdutoRetaguarda": 0"7891132019021-3",
"idPreVenda": 0,
"sequencial": 2,
"idProdutoRetaguarda": "304-13",
"entregapreco": {
64.36,
"idLojaEntregaRetaguardaquantidade": "2",
"tipoEntrega": "2"}
}]
}
, ],
"preVendaPagamentos": [
{
"valorPago": 7534.2213,
"pagamentoForma": {
"idRetaguarda": "CARDD"
},
"pagamentoCondicao": {
"idRetaguarda": 1
},
"quantidadeParcelas": 10
}
],
"idLojaRetaguarda": "2",
"idOperadorRetaguarda": "101",
"totalLiquido": 7534.2213,
"descontoPercentualTotal": 9.9916240,
"descontoTotal": 0,
"acrescimoPercentualTotal": 0,
"acrescimoTotal": 0,
"freteTotal": 0,
"totalBruto": 8334.5713,
"multiplosPedidos": false,
"dataCadastro": "2023-0809-02T2308T10:2709:00"
}
} |
|
|