...
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"
} |
PARÂMETROS DO CORPO
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 |
valor tamanho máximo permitido para Empresa é de 999999 |
nroSegmento Inteiro Número identificador do Segmento no ERP, identifica em qual segmento o pedido será integrado. O tamanho máximo permitido para Segmento é de 999999 Caso não seja informado, o sistema utilizará como padrão o segmento informado no cadastro do Canal de Venda |
codGeralOper Inteiro Número identificador do Código Geral de Operação no ERP, identifica em qual CGO o pedido será integrado. O tamanho máximo permitido para o Código Geral Operação é de |
999999999 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 |
seqTransportador Inteiro
Identificador do Transportador, identifica qual Transportador estará responsável pelo 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 total do Frete. O valor da propriedade VlrTotFrete possui o máximo permitido de 9999999999.9999 |
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)), 1 (Contratação do Frete por conta do Destinatário (FOB)), 2 (Contratação do Frete por conta de Terceiros), 3 (Transporte Próprio por conta do Remetente), 4 (Transporte Próprio por conta do Destinatário), e 9 (Sem Ocorrência de Transporte) |
indIntermediador Texto Identificador do Intermediador O valor da propriedade IndIntermediador aceita apenas os valores: 'S' (Sim) e 'N' (Não) |
Object clienteDto Obrigatório Dados do cliente do pedido de venda Expandir |
---|
title | Clique para expandir |
---|
| Nome |
---|
cpfCnpj Texto Obrigatório Campo responsável por receber os dados de CPF/CNPJ do Cliente. O valor da propriedade CpfCnpj possui o tamanho máximo de 14 caracteres | inscEstadualRg |
|
|
texto Obrigatóriotexto Registro formal das empresas perante a Receita Estadual, sendo utilizada para a fiscalização e recolhimento do ICMS – Imposto de Circulação de Mercadorias e Serviços (Inscrição Estadual). O valor da propriedade InscEstadualRg possui o tamanho máximo de 60 caracteres | nomeRazaoSocial Texto Obrigatório campo responsável por receber a Razão Social O valor da propriedade NomeRazaoSocial possui o tamanho máximo de 100 caracteres | nomeFantasia Texto Campo responsável por receber o Nome Fantasia O valor da propriedade NomeFantasia possui o tamanho máximo de 30 caracteres | sexo Texto Campo responsável por receber o Gênero do Cliente. O valor da propriedade Sexo aceita apenas os valores: 'M' (Masculino), 'F' (Feminino), e 'O' (Outros) | cidade Texto Obrigatório Campo responsável por receber Nome da Cidade do Cliente O valor da propriedade Cidade possui o tamanho máximo de 30 caracteres | uf Texto Obrigatório campo responsável por receber o Estado do Cliente O valor da propriedade Uf possui o tamanho máximo de 2 caracteres | pais Texto Campo responsável por receber o País do Cliente O valor da propriedade Pais possui o tamanho máximo de 25 caracteres | bairro Texto Obrigatório Campo responsável por receber o |
|
|
Bairo Bairro do Cliente O valor da propriedade Bairro possui o tamanho máximo de 30 caracteres | logradouro Texto Campo responsável por receber o Logradouro do Cliente O valor da propriedade Logradouro possui o tamanho máximo de 35 caracteres | nroLogradouro Texto Número identificador do Logradouro do Cliente O valor da propriedade NroLogradouro possui o tamanho máximo de 10 caracteres | complementoLogradouro Texto Campo responsável por receber o Complemento do Logradouro do Cliente O valor da propriedade ComplementoLogradouro possui o tamanho máximo de 60 caracteres | cep Texto Campo responsável por receber o Código Postal (CEP) O valor da propriedade Cep possui o tamanho máximo de 12 caracteres | foneDdd1 Texto Número do DDD O valor da propriedade FoneDdd1 possui o tamanho máximo de 5 caracteres | foneNro1 Texto Campo responsável por receber o Número do Telefone do Cliente O valor da propriedade FoneNro1 possui o tamanho máximo de 12 caracteres | dtaNascFund DataHora Campo responsável por receber Data de Nascimento/Fundação do Cliente Formado esperado: "YYYY-MM-DDTHH:MM:SS" | email Texto Campo responsável por receber o E-mail do cliente O valor da propriedade Email possui o tamanho máximo de 50 caracteres | emailNfe Texto Campo responsável por receber E-mail para entrega de Nota Fiscal O valor da propriedade EmailNfe possui o tamanho máximo de 50 caracteres | estadoCivil Texto Campo responsável por receber o Estado Civil do Cliente O valor da propriedade EstadoCivil aceita apenas os valores: 'S' (Solteiro), 'C' (Casado), 'V' (Viúvo), 'Q' (Desquitado), 'D' (Divorciado), 'A' (Amasiado), 'P' (Separado), e 'O' (Outros) | inscMunicipal Texto Campo responsável por receber a Inscrição Municipal do Cliente O valor da propriedade InscMunicipal possui o tamanho máximo de 15 caracteres | inscProdutor Texto Campo responsável por receber a Inscrição de Produtor do Cliente O valor da propriedade InscProdutor possui o tamanho máximo de 15 caracteres | indContribIcms Texto Identificador de Contribuição de ICMS O valor da propriedade IndContribIcms aceita apenas os valores: 'S' (Sim) e 'N' (Não) | fisicaJuridica Texto Campo responsável por mostrar se o cliente é Pessoa Física/Jurídica O valor da propriedade FisicaJuridica aceita apenas os valores: 'F' (Pessoa Física) e 'J' (Pessoa Jurídica) |
|
|
Objeto itemDto Obrigatório Coleção de dados dos itens do pedido de venda Expandir |
---|
title | Clique para expandir... |
---|
| Nomes |
---|
codAcesso Texto O valor da propriedade CodAcesso possui o tamanho máximo de 14 caracteres | seqProduto |
|
|
Inteiro Inteiro Obrigatório Campo responsável por receber o código do Produto. O valor da propriedade SeqProduto possui o máximo permitido de 999999 | qtdPedida Numérico Obrigatório Campo responsável por receber a Quantidade Pedida do pedido O valor da propriedade QtdPedida possui o valor máximo permitido de 99999999.999 | 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 ObrigatórioNumé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 | vlrEmbTabPromoc Numérico Campo responsável por receber o Valor da Embalagem na Tabela Promocional O valor da propriedade VlrEmbTabPromoc possui o valor máximo permitido de 9999999999.99 | vlrEmbDesconto Numérico Campo responsável por receber o Valor de desconto da Embalagem O valor da propriedade VlrEmbDesconto possui o valor máximo permitido de 9999999999.99 | observacaoItem Inteiro Campo responsável por receber a Observação do item no pedido O valor da propriedade ObservacaoItem possui o tamanho máximo de 250 caracteres | qtdVolume Numérico Campo responsável por receber a Quantidade de Volume do Item no pedido O valor da propriedade QtdVolume possui o valor máximo permitido de 99999.999999 | indSimilarEcommerce Inteiro Campo responsável por receber a Identificação de Pedido Similar ao E-commerce O valor da propriedade IndSimilarEcommerce aceita apenas os valores: 'S' (Sim) e 'N' (Não) | indKit Inteiro Campo responsável por receber o Identificador de Kit no pedido O valor da propriedade IndKit aceita apenas os valores: 'S' (Sim) e 'N' (Não) | vlrTotComissao Numérico Campo responsável por receber o Valor Total da Comissão O valor da propriedade VlrTotComissao possui o valor máximo permitido de 9999999999.9999 | fatorMultiplicador Numérico Campo responsável por receber o Fator multiplicador do pedido O valor da propriedade FatorMultiplicador possui o valor máximo permitido de 9999999999.9999 | seqItemCanalVenda Inteiro Campo responsável por receber o Sequencial do Item no Canal de Venda |
|
|
Objeto pagamentoDto Obrigatório Coleção de dados dos pagamentos do pedido de venda Expandir |
---|
title | Clique para expandir... |
---|
| Nomes |
---|
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éricoNumérico Valor do Pagamento O valor da propriedade ValorPagto possui o valor máximo permitido de 9999999999.99 |
|
|
nroGiftCard Numérico
Número do Gift Card
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 IdCarteira possui o tamanho máximo de 8 caracteres | tipoCarteira Texto Tipo de carteira O valor da propriedade TipoCarteira possui o tamanho máximo de 2 caracteres | idPagtoCanalVenda |
|
|
Texto ObrigatórioTexto Identificação do Pagamento do canal de venda O valor da propriedade IdPagtoCanalVenda possui o tamanho máximo de 60 caracteres |
|
|
Array de objeto nsuDto Obrigatório
Coleção de dados complementares de cartões do pedido de venda
Expandir |
---|
title | Clique para expandir... |
---|
|
Nomes |
---|
nsu Texto Obrigatório NSU é a sigla para Número Sequencial Único. É um número único gerado para identificar uma transação ou uma nota fiscal. O valor da propriedade Nsu possui o tamanho máximo de 50 caracteres |
nroCartao Texto Obrigatório
Este campo deverá ser informado SE a forma de pagamento for do tipo Cartão de crédito e precise informar os dados complementares do cartão em um segundo momento. Por exemplo, no momento da integração do pedido você não possua os dados de NSU. Nesse caso é necessário preencher uma sequencia de sua escolha referente ao pagamento que será utilizado no endpoint especifico para inclusão dos dados do NSU posterior ao envio do pedido. | Array de objeto nsuDto Coleção de dados complementares de cartões do pedido de venda Expandir |
---|
title | Clique para expandir... |
---|
| Nomes |
---|
nsu Texto Obrigatório NSU é a sigla para Número Sequencial Único. É um número único gerado para identificar uma transação ou uma nota fiscal. O valor da propriedade Nsu possui o tamanho máximo de 50 caracteres | nroCartao Texto Obrigatório Número do cartão utilizado |
|
|
|
|
Número do cartão utilizado no pagamento O valor da propriedade NroCartao possui o tamanho máximo de 20 caracteres | codRede Texto Código da rede utilizada no pagamento O valor da propriedade CodRede possui o tamanho máximo de 12 caracteres | codBandeira Texto Código da bandeira utilizada no pagamento O valor da propriedade CodBandeira possui o tamanho máximo de 12 caracteres | codBin Texto Código BIN é o Número de Identificação Bancária (na sigla em inglês) e corresponde aos 6 primeiros dígitos de um cartão de crédito. O valor da propriedade CodBin possui o tamanho máximo de 12 caracteres | nroAutorizacao |
|
|
|
|
Texto ObrigatórioTexto Um código que é gerado a partir de cinco ou seis números por um banco emissor, o código usado para validar um cartão de crédito e aprová-lo quando uma compra ou venda é feita O valor da propriedade NroAutorizacao possui o tamanho máximo de 15 caracteres |
|
|
|
|
VALIDAÇÕES EXISTENTES
Validações efetuadas no momento da requisição
Erro: Campo TipoFreteDocAuxiliar Inválido.
O valor da propriedade TipoFreteDocAuxiliar aceita apenas os valores: 0 (Contratação do Frete por conta do Remetente (CIF)), 1 (Contratação do Frete por conta do Destinatário (FOB)), 2 (Contratação do Frete por conta de Terceiros), 3 (Transporte Próprio por conta do Remetente), 4 (Transporte Próprio por conta do Destinatário), e 9 (Sem Ocorrência de Transporte).
Validações pós processamento
Existem algumas validações que serão processadas após o recebimento do pedido
Erro: Pedido já integrado no sistema
...
Bloco de código |
---|
{
"code": "Zvpebfbsg.NfcArgPber.Zip.GasPbagebyyre+Reebe.2",
"message": "Erro ao salvar 'PedidoVenda'",
"detailedMessage": "AspNetCoreOnPostError",
"helpUrl": "",
"details": [
{
"guid": "be5f6a5c-1116-46fa-9d9f-d7f4b696ba27",
"code": "400",
"message": "Mensagem de erro.",
"detailedMessage": "Fetalhe"
}
]
} |
|
INSTALAÇÃO
Para instalação do módulo de API Pedido de Venda deve ser feito via PublicaWeb > ConsincoWeb
Pacote: Comercial Pedido de Venda API
Versão a partir de: 23.0701.999001