POST {urlbase}:{porta}/smpedidovenda/smpedidovendaapi/api/v1/pedidovendaPedidoVenda
Endpoint responsável por receber, validar e persistir pedidos de venda.
Índice |
---|
Bloco de código | ||
---|---|---|
| ||
{ "seqCanalVenda":21, "idPedidoCanalVenda": "68", "dtaHorPedidoCanalVenda": "2022-08-09T09:59:06.149Z", "nroEmpresa": 1, "codGeralOper": 518, "nroRepresentante": 1, "nroTabVenda": "1", "seqTransportador": 0, "tipoEntrega": "E", "obsPedido": "TESTE POST PEDIDO", "obsNotaFiscal": "TESTE API PEDIDO", "vlrTotFrete": 5.00, "tipoRateioFretePedido": "V", "tipoFreteDocAuxiliar": 0, "indIntermediador": "N", "clienteDto": { "cpfCnpj": "2813221589399999999999", "inscEstadualRg": "155734544123456789", "nomeRazaoSocial": "Matheus Márcio da Luz", "nomeFantasia": "Matheus", "sexo": "M", "cidade": "Ribeirão Preto", "uf": "SP", "pais": "BRASIL", "bairro": "Jardim Prof Antônio Palocci", "logradouro": "Rotatória José Pessini", "nroLogradouro": "863999", "complementoLogradouro": "TEST 1", "cep": "14079077", "foneDdd1": "16", "foneNro1": "38800263", "dtaNascFund": "1987-06-13T13:34:15", "email": "matheusmarciodaluz@tanetxxxxxxxxxxx@net.com.br", "emailNfe": "matheusmarciodaluz@tanetxxxxxxxxxxxx@net.com.br", "estadoCivil": "S", "inscMunicipal": "", "inscProdutor": "", "indContribIcms": "N", "fisicaJuridica": "F" }, "itemDto": [ { "codAcesso": "17", "seqProduto": 21, "qtdPedida": 10, "qtdEmbalagem": 1, "vlrEmbTabPreco": 5.00, "vlrEmbInformado": 4.59, "vlrEmbTabPromoc": 0, "vlrEmbDesconto": 0.41, "observacaoItem": "PRODUTO TESTE", "qtdVolume": 0, "indSimilarEcommerce": "N", "indKit": "N", "vlrTotComissao": 0, "fatorMultiplicador": 0, "seqItemCanalVenda": 0 } ], "pagamentoDto": [ { "nroFormaPagto": 6, "nroCondPagto": 30, "valorPagto": 45.90, "nroGiftCard": 0, "nroParcela": 0, "cpfCnpjCartao": "2813221589399999999999", "cnpjInstituicaoPagto": "", "idCarteira": "1", "tipoCarteira": "01", "idPagtoCanalVenda": "1", "nsuDto": { "nsu": "123456789000", "nroCartao": "5180926354881155180#########8115", "codRede": "125", "codBandeira": "1", "codBin": "123", "nroAutorizacao": "123" } } ] } |
Bloco de código | ||
---|---|---|
| ||
{
"seqPedido": 422,
"seqCanalVenda": 21,
"idPedidoCanalVenda": "68",
"dtaHorPedidoCanalVenda": "2022-08-09T09:59:06.149Z",
"nroEmpresa": 1,
"nroSegmento": 1,
"codGeralOper": 518,
"nroRepresentante": 1,
"nroTabVenda": "1"
} |
Nome |
---|
seqCanalVenda Inteiro Obrigatório Sequencial do Canal de Venda. |
idPedidoCanalVenda Texto Obrigatório Identificação do Pedido no Canal de Venda. O IdPedidoCanalVenda possui um tamanho máximo de 60 caracteres. Essa numeração poderá ser utilizada no ERP como "Ped Cliente" na pesquisa do pedido de venda (F7) para buscas. |
dtaHorPedidoCanalVenda DataHora Data/Hora que o Pedido de Venda terá ao ser criado. Formato esperado: "YYYY-MM-DDTHH:MM:SS". Caso não seja informado, o sistema utilizará a data e hora atual para integração com o ERP. |
nroEmpresa Numérico Obrigatório Número identificador da empresa no ERP, identifica em qual empresa o pedido será integrado. O valor máximo permitido para a Empresa é de 999999. |
nroSegmento Numérico Número identificador do Segmento no ERP, identifica em qual segmento o pedido será integrado. O valor máximo permitido para o Segmento é de 999999. Caso não seja informado, o sistema utilizará como padrão o segmento informado no cadastro do Canal de Venda. |
codGeralOper Numérico Número identificador do Código Geral de Operação no ERP, identifica em qual CGO o pedido será integrado. O valor máximo permitido para o Código Geral Operação é de 999999. Caso não seja informado, o sistema utilizará como padrão o código geral de operação informado no cadastro do Canal de Venda. |
nroRepresentante Numérico Número identificador do representante no ERP, identifica qual Representante efetuou o pedido |
Nome
seqCanalVenda Inteiro Obrigatório
Sequencial do Canal de Venda
idPedidoCanalVenda Texto Obrigatório
Identificação do Pedido de Venda
O IdPedidoCanalVenda possui um tamanho máximo de 60 caracteres
Essa numeração poderá ser utilizada no ERP como "Ped Cliente" na pesquisa do pedido de venda (F7) para buscas.
dtaHorPedidoCanalVenda DataHora Obrigatório
Data/Hora em que o Pedido de Venda receberá ao ser criado.
Formado esperado: "YYYY-MM-DDTHH:MM:SS"
nroEmpresa Inteiro Obrigatório
Número identificador da empresa no ERP, identifica em qual empresa o pedido será integrado. O tamanho máximo permitido para |
o Representante é de |
nroSegmento Inteiro
99999. Caso não seja informado, o sistema utilizará como padrão o representante informado no cadastro do Canal de Venda. |
nroTabVenda Texto Número identificador da tabela de Venda do |
ERP, identifica em qual |
Tabela de Venda o pedido será integrado. O |
Número da Tabela de Venda possui um tamanho máximo de 3 caracteres. Caso não seja informado, o sistema utilizará como padrão |
a tabela de venda informada no cadastro do Canal de Venda. |
codGeralOper Inteiro
seqTransportador Numérico Identificador do Transportador, identifica qual Transportador estará responsável pelo pedido |
. O |
valor máximo permitido para o |
Caso não seja informado, o sistema utilizará como padrão o código geral de operação informado no cadastro do Canal de Venda
nroRepresentante Inteiro
Número identificador do representante no ERP, identifica qual Representante efetuou o pedido.
O tamanho máximo permitido para o Representante é de 99999
Caso não seja informado, o sistema utilizará como padrão o representante informado no cadastro do Canal de Venda
nroTabVenda Texto
Número identificador da tabela de Venda do ERP, identifica em qual Tabela de Venda o pedido será integrado.
O Número da Tabela de Venda possui um tamanho máximo de 3 caracteres
Caso não seja informado, o sistema utilizará como padrão a tabela de venda informada no cadastro do Canal de Venda
seqTransportador Inteiro
Identificador do Transportador, identifica qual Transportador estará responsável pelo pedido.
tipoEntrega Texto Obrigatório
Sigla que terá como identificação de Entrega ou Retirada do Pedido.
O valor da propriedade TipoEntrega aceita apenas os valores: 'E' (Entrega) e 'R' (Retira)
obsPedido Texto
Campo responsável por receber a Observação do Pedido
A ObsPedido possui um tamanho máximo de 240 caracteres
obsNotaFiscal Texto
Campo responsável por receber a Observação da Nota Fiscal
A ObsNotaFiscal possui um tamanho máximo de 500 caracteres
vlrTotFrete Numérico
Campo responsável por receber o Valor totalTransportador é de 999999999999999999. |
tipoEntrega Texto Obrigatório Sigla de identificação da Entrega ou Retirada do Pedido. O valor da propriedade TipoEntrega aceita apenas os valores:
|
obsPedido Texto Campo responsável por receber a Observação do Pedido. A ObsPedido possui um tamanho máximo de 240 caracteres. |
obsNotaFiscal Texto Campo responsável por receber a Observação da Nota Fiscal. A ObsNotaFiscal possui um tamanho máximo de 500 caracteres. |
vlrTotFrete Decimal Campo responsável por receber o Valor Total do Frete. O valor máximo permitido para o Valor Total do Frete é de 9999999999.9999. |
tipoRateioFretePedido Texto Sigla de identificação do Tipo de Rateio do Frete, seja ele 'V', 'P', 'O' ou 'T'. O valor da propriedade TipoRateioFretePedido aceita apenas os valores:
|
tipoFreteDocAuxiliar Inteiro Campo responsável por receber o Tipo de Documento Auxiliar do Frete. O valor da propriedade |
tipoRateioFretePedido Texto
Campo responsável por receber o Tipo de Rateio do Frete, seja ele 'V', 'P', 'O' ou 'T'.
O valor da propriedade TipoRateioFretePedido aceita apenas os valores: 'V' (Valor), 'P' (Peso Bruto), 'O' (Volume), e 'T' (Conforme cálculo do frete do transportador no pedido de venda)
tipoFreteDocAuxiliar Texto
Campo responsável por receber o Tipo de Documento Auxiliar do Frete.
O valor da propriedade TipoFreteDocAuxiliar aceita apenas os valores: 0 (Contratação do Frete por conta do Remetente (CIF)), 1TipoFreteDocAuxiliar aceita apenas os valores:
|
|
|
|
indIntermediador Texto |
Sigla de identificação do Intermediador. O valor da propriedade IndIntermediador aceita apenas os valores:
|
| |||||||||
Object clienteDto Obrigatório Dados do cliente do pedido de venda
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| ||||||||
Objeto itemDto Obrigatório Coleção de dados dos itens do pedido de venda
|
|
O valor da propriedade SeqProduto possui o máximo permitido de 999999
|
|
|
qtdEmbalagem Numérico Obrigatório
Campo responsável por identificar a Quantidade da Embalagem do produto
O valor da propriedade QtdEmbalagem possui o valor máximo permitido de 99999.999999
vlrEmbTabPreco Numérico Obrigatório
Campo responsável por receber o Valor da Embalagem na Tabela de Preço
O valor da propriedade VlrEmbTabPreco possui o valor máximo permitido de 9999999999.99
vlrEmbInformado Numérico
Campo responsável por receber Valor da Embalagem Informado do produto no pedido.
O valor da propriedade VlrEmbInformado possui o valor máximo permitido de 9999999999.999999
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |||
Objeto pagamentoDto Obrigatório Coleção de dados dos pagamentos do pedido de venda |
|
|
nroFormaPagto Inteiro Obrigatório
Número Forma de Pagamento do pedido
O valor da propriedade NroFormaPagto possui o valor máximo permitido de 99999
nroCondPagto Inteiro Obrigatório
Número Condição de Pagamento do Pedido
O valor da propriedade NroCondPagto possui o valor máximo permitido de 999
valorPagto Numérico
Valor do Pagamento
O valor da propriedade ValorPagto possui o valor máximo permitido de 9999999999.99
Validar com Danilo, se a forma de pagamento for do tipo na entrega ou retirada, não mandar valor da erro? e se mandar zero? não seria melhor obrigar e se não usar mandar 0.00?
nroGiftCard Numérico
Número do Gift Card
O valor da propriedade NroGiftCard possui o valor máximo permitido de 999999999999999
nroParcela Numérico
Número de Parcelas
O valor da propriedade NroParcela possui o valor máximo permitido de 999999999999999
cpfCnpjCartao Texto
CPF/CNPJ do Proprietário do Cartão
O valor da propriedade CpfCnpjCartao possui o tamanho máximo de 14 caracteres
cnpjInstituicaoPagto Texto
CNPJ da Instituição de Pagamento
O valor da propriedade CnpjInstituicaoPagto possui o tamanho máximo de 15 caracteres
idCarteira Texto
Identificação da Carteira
|
|
|
|
|
|
|
|
|
|
|
O valor da propriedade NroAutorizacao possui o tamanho máximo de 15 caracteres
Dica |
---|
200 ok |
|
Dica | ||
---|---|---|
| ||
|
Aviso | ||
---|---|---|
| ||
Aviso | ||
|
Para instalação do módulo de API Pedido de Venda deve ser feito via PublicaWeb > ConsincoWeb
...