Páginas filhas
  • APIs Integrações - Pedido PDVSync - INTERNA

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Totvs custom tabs box
tabsDados integrados c/ Winthor, Gravação Pedido/Retorno
idspasso1,passo2

A integração consiste em receber e enviar dados do pedido que será incluído no winthor.

Totvs custom tabs box items
defaultyes
referenciapasso1

Os dados integrados são: 

APIDescriçãoColunaTipoObrigatório
situacaoPreVenda0 = CANCELADA

1 = RECEBIDO

2 = DISPONIVEL

3 = RESGATADA

intSIM
numeroIdentificação do pedido no PDV.PCPEDC.NUMPEDHUBEStringSIMobservacoesPCPEDC.OBSNÃO
idOperadorRetaguardaMatricula do funcionário. Caso não informado irá usar o RCA do parâmetro 4012.PCPEDC.CODUSURlongNÃO
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.FRETEDESPACHOintNÃO
observacoes
PCPEDC.OBS
NÃO
idOperadorRetaguardaMatricula do funcionário. Caso não informado irá usar o RCA do parâmetro 4012.PCPEDC.CODUSURlongNÃO
idLojaRetaguardaidLojaRetaguardaCódigo da filial.

SIM
preVendaItens.*.quantidadeDeve ser maior que zero. PCPEDI.QTintSIM
preVendaItens.*.precoDeve ser maior que zero. PCPEDI.PVENDA
SIM
preVendaItens.*.descontoValor de desconto. 

NÃO
preVendaItens.*.descontoPercentualPercentual de desconto. 

NÃO
preVendaItens.*.idProdutoRetaguardaCódigo auxiliar mais o código do produto. Ex: 123-1.PCPEDI.CODPROD
SIM
preVendaItens.*.idVendedorRetaguarda


NÃO
preVendaItens.*.entrega.idRetaguardaLojaEntregaCó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")

PCPEDI.TIPOENTREGA
SIM
preVendaItens.*.entrega.dataEntregaData da entrega do itemPCPEDI.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.bairroEste 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.telefoneCaso não preenchido será usado o campo celular

NÃO
cliente.celularCaso não preenchido será usado o campo telefone

NÃO
cliente.cepEste 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.cidadeEste 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.emailEste 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.estadoEste 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 cliente

NÃO
cliente.numero


NÃO
VendaPagamentos.valorLiquidoValor líquidoPCFORMAPGTOPEDIDO.VALOR
SIM
VendaPagamentos.pagamentoForma.idRetaguardaForma de pagamentoPCFORMAPGTOPEDIDO.CODCOB
SIM
VendaPagamentos.pagamentoForma.descricaoDescrição da forma de pagamento

NÃO
VendaPagamentos.vendaPagamentoItems.valorParcelaValor da parcelaPCFORMAPGTOPEDIDO.VALOR (Só utilizado caso cobrança cartão com parcelas)
NÃO
VendaPagamentos.vendaPagamentoItems.dataVencimentoData de vencimento da parcelaPCFORMAPGTOPEDIDO.DTVENC (Só utilizado caso cobrança cartão com parcelas)
NÃO

PreVendaPagamentos.vendaPagamentoTefs.nsuHost

NSUPCFORMAPGTOPEDIDO.NSU (Só utilizado caso cobrança cartão com parcelas)
NÃO
Totvs custom tabs box items
defaultno
referenciapasso2

Exemplo do envio da requisição:

Bloco de código
languagejs
titleURI
method: 'POST',
url: '/api/wholesale/v1/orders/pdvsync'
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
Bloco de código
languagejs
titleBody Request
{     "Numero": {{numPedHube}},
    "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",
    "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": "303-13",
            "idVendedorRetaguarda": "1",
            "entrega": {
                "idRetaguardaLojaEntrega": "1",
                "TipoEntrega": 1,
                "dataEntrega": "2022-04-25T17:08:56.18511"
            }
        }
    ],
    "vendaPagamentos": [
        {
            "valorLiquido": 1.0,
            "valorPago": 24.9,
            "valorTroco": 0.0,
    "IdMotivoDesconto": null,
           "idPagamentoCondicaoRetaguarda"DescricaoMotivoDescontoAcrescimo": null,
    "IdTransacaoMotorPromocaoTerceiro": 0.0null, 
			"pagamentoForma":
                {
                    "descricao": "CAR - CARTAO",
                    "idRetaguarda": "CAR"
                }, 
    "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",
            
			"idPagamentoOperadoraRetaguardaidVendedorRetaguarda": "1",
                        "vendaPagamentoTefsentrega": [
                {
                        "bandeira        "idLojaEntregaRetaguarda": "1",
                "TipoEntrega": 1,
                   "codigoRededataEntrega": "1",
                    "idTransacaoDigital": "1",
                    "nsuHost": "1",
                    "numeroAutorizacao": "1",
                    "numeroBin": "1"
                }
            ],
           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,
                               "numeroParcela": 1
                      }
            ]
        }
       }
            ]
        }
    ],
      "Cliente": {
            "Nome": "Cliente alterar",
            "Endereco": "RUA GIOTO",
            "Numero": "S/N",
            "Complemento": "",
            "Bairro": "SETOR GENTIL",
            "Cidade": "GOIANIA",
            "Estado": "GO",
            "Cep": "7400074916-000100",
            "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,
    "IdRetaguardaId": "100721720230612140631122023235",
      "Idnumero": {{numPedHube}}"20230612140631122023235",
      "DataCadastro": "2023-04-13T16:32:45.651279",
      "DataAtualizacao": "2023-04-13T16:33:30.123302",
      "_expandables": [] 
}



Bloco de código
languagejs
titleBody Response
{    
	"success": true,
    "hasNext": false,
    "message": "",
    "data": {
        "idRetaguardaPedido": "1007217",
        "cliente": {
            "idRetaguardaCliente": "770"
        },
        "message": "",
        "success": true
    } 
}