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. | idRetaguardaCódigo clientetelefone | Caso não preenchido será usado o campo celular |
|
| NÃO | cliente. | numerocelular | Caso não preenchido será usado o campo telefone |
|
| NÃO | VendaPagamentos cliente. | valorLiquidoValor 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 | freteTotal | Campo preenchido no caso de teste unitário | int | 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 | 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 | freteTotal | Campo preenchido no caso de teste unitário |
| int | 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 | codigoCobranca | Caso seja enviado, será adicionado na tabela PCPEDC.CODCOB o valor. Caso valor esteja vazio na hora da reserva, assumira um valor default. | PCPEDC.CODCOB | String | NAO |
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo2 |
---|
| Exemplo do envio da requisição:
Bloco de código |
---|
| method: 'POST',
url: '/winthor/varejo/matcon/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": "111111111111",
"DescontoTotal": 0.0,
"TotalLiquido": 6.130000,
"TotalBruto": 6.130000,
"IdLojaRetaguarda": 1,
"freteTotal ": 0.0,
"CodigoPromocional": null,
"situacaoPreVenda": "RECEBIDO",
"modalidadeFrete": "2",
"NomeConsumidor": null,
"EnderecoCliente": "RUA GIOTO",
"NomeCliente": "Cliente 0123",
"IdOperadorRetaguarda": 1,
"idVendedorRetaguarda": "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,
"codigoCobranca",
"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"
}
},
{
"acrescimo": 0,
"acrescimoPercentual": 0,
"dataAtualizacao": "2024-02-08T16:24:55.668315",
"dataCadastro": "2024-02-08T16:24:55.668313",
"desconto": 0.0,
"descontoPercentual": 0.0,
"entrega": {
"dataEntrega": "2024-03-28T00:00:00",
"idLojaEntregaRetaguarda": "2",
"tipoEntrega": 2,
"frete": 0,
"fretePercentual": 0,
"situacao": 0,
"dataCadastro": "0001-01-01T00:00:00",
"dataAtualizacao": "0001-01-01T00:00:00",
"sequencial": 0,
"_expandables": []
},
"frete": 0,
"fretePercentual": 0,
"idPreVenda": "{{$randomInt}}",
"idProdutoRetaguarda": "55555-4551",
"idVendedorRetaguarda": "1",
"preco": 150.00,
"quantidade": 1,
"quantidadeEncomenda": 0,
"quantidadeFaturada": 0,
"sequencial": 0,
"situacao": 1,
"id": 8088,
"_expandables": [],
"itensKit": [
{
"idProdutoRetaguarda": "7891132019021-3",
"sequencial": 1,
"preco": 50,
"quantidade": 2
},
{
"idProdutoRetaguarda": "7891132019045-4",
"sequencial": 2,
"preco":50,
"quantidade": 2
}
]
} ],
"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,
"numeroParcela": 1
}
]
}
],
"Cliente": {
"Nome": "Cliente alterar",
"Endereco": "RUA GIOTO",
"Numero": "S/N",
"Complemento": "",
"Bairro": "SETOR GENTIL",
"Cidade": "GOIANIA",
"Estado": "GO",
"Cep": "74916-100",
"Telefone": "",
"Celular": "62900000000",
"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 |
| 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": "111111111111",
"DescontoTotal": 0.0,
"TotalLiquido": 6.130000,
"TotalBruto": 6.130000,
"IdLojaRetaguarda": 1,
"freteTotal ": 0.0,
"CodigoPromocional": null,
"situacaoPreVenda": "RECEBIDO",
"modalidadeFreteSituacao": "2"1,
"NomeConsumidor": null,
"EnderecoClienteId": "RUA GIOTO"4,
"NomeClienteIdRetaguarda": "Cliente 012300000000-0000-0000-0000-000000000000",
"IdOperadorRetaguardaDataCadastro": 1"2023-03-29T13:51:38.556565",
"SistemaOrigem": 1,
"TerminalOrigemDataAtualizacao": null"2023-03-29T13:51:38.55657",
"TipoEntrega": 0,
"SincronizadocodigoRede": 0"19",
"TipoDescontoAcrescimocodigoClientePrincipal": null"40",
"DescontoPercentualTotalcodigoProfissional": 0.066,
"IdMotivoDesconto": null,
"DescricaoMotivoDescontoAcrescimo_expandables": null,[]
"IdTransacaoMotorPromocaoTerceiro": null},
"SerieVendaSituacao": null0,
"NumeroAutorizacaoIdRetaguarda": null54382,
"TipoVendaId": 1"20230612140631122023235",
"TipoCancelamentonumero": null"20230612140631122023235",
"IdCanalVendaDataCadastro": null"2023-04-13T16:32:45.651279",
"DescontoMotorPromocaoAplicadoDataAtualizacao": false"2023-04-13T16:33:30.123302",
"PreVendaItens_expandables": [
]
} |
Bloco de código |
---|
language | js |
---|
title | Body Response |
---|
| { {
"quantidade
"success": 1.0true,
"precohasNext": 24.9false,
"descontomessage": 0.0"",
"descontoPercentualdata": 0.0,
"idProdutoRetaguarda{
"idRetaguardaPedido": "3-31007217",
"idVendedorRetaguardacliente": {
"idRetaguardaCliente": "770"
},
"message": "",
"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 pedidos |
---|
| method: 'GET',
url: '/winthor/varejo/matcon/v1/orders/pdvsync/consulta/'
|
Bloco de código |
---|
| idRetaguarda : 0 - Número do Pedido no WinThor
idLojaRetaguarda"1",
"entrega": {
"idLojaEntregaRetaguarda": "1",
"TipoEntrega": 1,
"dataEntrega": "2022-04-25T17:08:56.18511"
}
}
],
"vendaPagamentos": [
{
"valorLiquido": 1.0,
"valorPago": 24.9,
: 2 "valorTroco": 0.0,
"idPagamentoCondicaoRetaguarda": 0.0,
- Código da Filial **requerido**
cpfCliente "pagamentoForma":
: String - CPF {
ou CNPJ do cliente
nomeCliente "descricao": "DINHEIROString EM TRANSITO",
- "idRetaguarda": "DH"
Nome do Cliente
idOperadorRetaguarda : String - Código do Vendedor },no WinThor
dataInicio
: Timestamp "vendaPagamentoItems": [
- Data inicial da busca (Formato: 2023-07-25T11:43:45.086336)
dataFim : {
Timestamp - Data final da "dataVencimento"busca (Formato: "20222023-0507-10T1725T11:0843:56.18511",
45.086336)
idClienteRetaguarda : 0 - Código do "valorParcela": 24.9,
"numeroParcela": 1
}
]
}
],
"Cliente": {
"Nome": "Cliente alterar",
"Endereco": "RUA GIOTO",
"Numero": "S/N",
"Complemento": "",
"Bairro": "SETOR GENTIL",
"Cidade": "GOIANIA",
"Estado": "GO",
"Cep": "74916-100",
"Telefone": "",
"Celular": "62900000000",
"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": []
}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,
"acrescimoPercentualTotal": 0,
"totalBruto": 83.57,
"multiplosPedidos": false,
"dataCadastro": "2023-08-02T23:27:00"
}
]
} |
Bloco de código |
---|
language | text |
---|
title | URI pedido detalhado |
---|
| method: 'GET',
url: '/winthor/varejo/matcon/v1/orders/pdvsync/consulta/{idRetaguarda}'
|
Bloco de código |
---|
language | js |
---|
title | Body Response |
---|
| {
"success": true,
"hasNext": false,
"message": "",
"data": {
"dataoffline": {false,
"idRetaguardaPedidoidRetaguarda": "10072171002232",
"cliente": {
"idRetaguardaClientenome": "770CONSUMIDOR FINAL",
} "endereco": "RUA 1",
"messagebairro": "CENTRO",
"successcidade": true"GOIANIA",
}
} |
| 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 pedidos |
---|
| method: 'GET',
url: '/winthor/varejo/matcon/v1/orders/pdvsync/consulta/'
|
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 |
Bloco de código |
---|
language | js |
---|
title | Body Response |
---|
| {
"success": true,
"hasNext": false,
"message": "",
"data": [ "estado": "GO",
"cep": "74825110",
"telefone": "6298754444",
"celular": "6298754444",
"email": "[email protected]",
"cpfCnpj": "97017508025",
"clienteAlterado": false
},
"situacaoPreVenda": "DISPONIVEL",
"preVendaItens": [
{
"quantidade": 2.5,
"preco": 13.652100,
"descontoPercentual": 0,
"acrescimoPercentual": 0,
{
"offlinequantidadeEncomenda": false0,
"idRetaguardaidPreVenda": "10000908",
0,
"situacaoPreVendaidProdutoRetaguarda": "DISPONIVEL1",
"idLojaRetaguardaidProdutoEmbalagemRetaguarda": "27891132010387",
"idOperadorRetaguardaentrega": "10",
{
"totalLiquidoidLojaEntregaRetaguarda": 75.22"2",
"descontoPercentualTotal": 9.991624,
"acrescimoPercentualTotaltipoEntrega": "0,"
"totalBruto": 83.57,
}
"multiplosPedidos": false,
},
"dataCadastro": "2023-08-02T23:27:00"
{
}
]
} | Bloco de código |
---|
language | text |
---|
title | URI pedido detalhado |
---|
| method: 'GET',
url: '/winthor/varejo/matcon/v1/orders/pdvsync/consulta/{idRetaguarda}'
| Bloco de código |
---|
language | js |
---|
title | Body Response |
---|
| {
"successquantidade": true1,
"hasNext": false,
"messagepreco": ""252.48,
"data": {
"offlinedescontoPercentual": false0,
"idRetaguarda": "1002232",
"clienteacrescimoPercentual": {0,
"nomequantidadeEncomenda": "CONSUMIDOR FINAL"0,
"enderecoidPreVenda": 0,
"RUA 1",
"bairroidProdutoRetaguarda": "CENTRO55555-4551",
"cidadeidProdutoEmbalagemRetaguarda": "GOIANIA55555-4551",
"estadoentrega": "GO",
{
"cepidLojaEntregaRetaguarda": "748251102",
"telefonetipoEntrega": "62987544441",
"celular": "6298754444" },
"emailitensKit": "[email protected]",
[
"cpfCnpj": "97017508025",
{
"clienteAlterado": false
},
"situacaoPreVendaidProdutoRetaguarda": "DISPONIVEL7891132019045-4",
"preVendaItens": [
{
"sequencial": 1,
"quantidade": 2.5,
"preco": 1361.65210088,
"descontoPercentual "quantidade": 0,2
"acrescimoPercentual": 0,
},
"quantidadeEncomenda": 0,
{
"idPreVenda": 0,
"idProdutoRetaguarda": "17891132019021-3",
"idProdutoEmbalagemRetaguardasequencial": "7891132010387"2,
"entregapreco": {
64.36,
"idLojaEntregaRetaguardaquantidade": "2",
"tipoEntrega": "0"}
}]
}
, ],
"preVendaPagamentos": [
{
"valorPago": 34.13,
"pagamentoForma": {
"idRetaguarda": "D"
},
"pagamentoCondicao": {},
"quantidadeParcelas": 0
}
],
"idLojaRetaguarda": "2",
"idOperadorRetaguarda": "1",
"totalLiquido": 34.13,
"descontoPercentualTotal": 0,
"descontoTotal": 0,
"acrescimoPercentualTotal": 0,
"acrescimoTotal": 0,
"freteTotal": 0,
"totalBruto": 34.13,
"multiplosPedidos": false,
"dataCadastro": "2023-09-08T10:09:00"
}
} |
|
|