Árvore de páginas

Versões comparadas

Chave

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

POST  {urlbase}:{porta}/smpedidovenda/smpedidovendaapi/api/v1/pedidovendaPedidoVenda


Endpoint responsável por receber, validar e persistir pedidos de venda.


Índice


EXEMPLO DO CORPO DA REQUISIÇÃO

Bloco de código
languagejs
{
  "seqCanalVenda":121,
  "idPedidoCanalVenda": "12368",
  "dtaHorPedidoCanalVenda": "2022-1008-13T1309T09:3459:1506.149Z",
  "nroEmpresa": 1,
  "codGeralOper": 999518,
  "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"
      }
    }
  ]
}

EXEMPLO DA RESPOSTA RECEBIDA

Bloco de código
languagejs
{
  "seqCanalVenda":1,
  "idPedidoCanalVenda": "123",
  "dtaHorPedidoCanalVenda": "2022-10-13T13:34:15",
  "nroEmpresa": 1
}

PARÂMETROS DO CORPO

PARÂMETROS DO CORPO

Nome

seqCanalVenda Inteiro

Nome

seqCanalVenda Inteiro Obrigatório

Sequencial do Canal de Venda.

Manutenção de 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 DataHoraDataHora 

Data/Hora em que o Pedido de Venda receberá terá ao ser criado.

Formado 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

nroEmpresa Inteiro 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 InteiroNumérico

Número identificador do Segmento no ERP, identifica em qual segmento o pedido será integrado.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  999

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

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 pedido.

tipoEntrega Texto

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)

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.

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 Numérico

Identificador do Transportador, identifica qual Transportador estará responsável pelo pedido.

O valor máximo permitido para o Transportador é 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:

  • 'E' (Entrega)
  • '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 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:

  • 'V' (Valor)
  • 'P' (Peso Bruto)
  • 'O' (Volume)
  • 'T' (Conforme cálculo do frete do transportador no pedido de venda)

tipoFreteDocAuxiliar Inteiro

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)
  • 9 (Sem Ocorrência de Transporte)

indIntermediador Texto

Sigla de identificação do Intermediador.

O valor da propriedade IndIntermediador aceita apenas os valores:

  • 'S' (Sim)
  • 'N' (Não)

Object clienteDto Obrigatório

Dados do cliente do pedido de venda

Expandir
titleClique para expandir

Object clienteDto Obrigatório

Dados do cliente do pedido de venda

Expandir
titleClique 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ório

texto 

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

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

Sigla de identificação por receber o

Gênero

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

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

Campo responsável por receber o número 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

Formato esperado: "YYYY-MM-DDTHH:MM:SS".

email Texto

Campo responsável por receber o

E

e-mail do

cliente 

cliente.

O valor da propriedade Email possui o tamanho máximo de 50 caracteres.

emailNfe Texto

Campo responsável por receber

E

e-mail para entrega de Nota Fiscal.

O valor da propriedade EmailNfe possui o tamanho máximo de 50 caracteres.

estadoCivil Texto

Sigla de identificação do 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

Sigla de identificação da Contribuição de ICMS.

O valor da propriedade IndContribIcms aceita apenas os valores:

  • 'S' (Sim)
e
  • 'N' (Não)

fisicaJuridica Texto

Pessoa Física/Jurídica

Sigla de identificação se o cliente é Pessoa Física ou 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

indKit Inteiro

Identificador de Kit

O valor da propriedade IndKit aceita apenas os valores: 'S' (Sim) e
Expandir
titleClique para expandir...
Nomes

codAcesso Texto

O valor da propriedade CodAcesso possui o tamanho máximo de 14 caracteres.

qtdPedida Numérico

Quantidade Pedida

O valor da propriedade QtdPedida possui o valor máximo permitido de 99999999.999 

qtdEmbalagem Numérico

Quantidade da Embalagem

O valor da propriedade QtdEmbalagem possui o valor  máximo permitido de 99999.999999

vlrEmbTabPreco Numérico

Valor da Embalagem na Tabela de Preço

O valor da propriedade VlrEmbTabPreco possui o valor  máximo permitidode  9999999999.99

vlrEmbInformado Numérico

Valor da Embalagem Informado

O valor da propriedade VlrEmbInformado possui o valor  máximo permitido de 9999999999.999999

vlrEmbTabPromoc Numérico

Valor da Embalagem na Tabela Promocional

O valor da propriedade VlrEmbTabPromoc possui o valor  máximo permitido de 9999999999.99

vlrEmbDesconto Numérico

Valor de desconto da Embalagem

O valor da propriedade VlrEmbDesconto possui o valor  máximo permitido de  9999999999.99

observacaoItem Inteiro

Observação do item

O valor da propriedade ObservacaoItem possui o tamanho máximo de 250 caracteres

qtdVolume Numérico

Quantidade de Volume do Item

O valor da propriedade QtdVolume possui o valor  máximo permitido de 99999.999999

indSimilarEcommerce Inteiro

Identificação de Pedido Similar ao E-commerce

O valor da propriedade IndSimilarEcommerce aceita apenas os valores: 'S' (Sim) e 'N' (Não)

seqProduto  Inteiro Obrigatório

Sequencial identificador do Produto no ERP.

qtdPedida Decimal Obrigatório

Campo responsável por receber a Quantidade Pedida do produto.

O valor máximo permitido para a Quantidade Pedida é de 99999999.999.

O valor informado deve ser o da quantidade unitária total, pois o mesmo será dividido pela embalagem na importação.

Exemplo:

  • Está sendo integrado 1 fardo com 6 un de refrigerante. Deve-se mandar qtdPedida =e qtdEmbalagem = 6.
  • Está sendo integrado 6 unidades de refrigerante. Deve-se mandar qtdPedida =e qtdEmbalagem = 1.

qtdEmbalagem Decimal Obrigatório

Campo responsável por identificar a  Quantidade da Embalagem do produto.

O valor máximo permitido para a Quantidade da Embalagem é de 99999.999999.

vlrEmbTabPreco Decimal Obrigatório

Campo responsável por receber o Valor da Embalagem na Tabela de Preço.

O valor máximo permitido para o Valor da Embalagem na Tabela de Preço é de 9999999999.99.

vlrEmbInformado Decimal Obrigatório

Campo responsável por receber o Valor da Embalagem informada para o produto no pedido.

O valor máximo permitido para o Valor da Embalagem informada é de 9999999999.999999.

vlrEmbTabPromoc Decimal

Campo responsável por receber o Valor da Embalagem na Tabela Promocional.

O valor máximo permitido para a o Valor da Embalagem na Tabela Promocional é de 9999999999.99.

vlrEmbDesconto Decimal

Campo responsável por receber o Valor de Desconto da Embalagem.

O valor máximo permitido para o Valor de Desconto da Embalagem é de 9999999999.99.

observacaoItem Texto

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 Decimal

Campo responsável por receber a Quantidade de Volume do Item no pedido.

O valor máximo permitido para a Quantidade de Volume é de 99999.999999.

indSimilarEcommerce Texto

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)
  • 'N' (Não)

indKit Texto

Campo responsável por receber o Identificador de Kit no produto.

O valor da propriedade IndKit aceita apenas os valores:

  • 'S' (Sim)
  • 'N' (Não)

vlrTotComissao

Numérico

Decimal

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

Fator multiplicador

máximo permitido para o Valor Total da Comissão é de 9999999999.9999.

fatorMultiplicador Decimal

Campo responsável por receber o Fator Multiplicador do produto.

O valor máximo permitido para o Fator Multiplicador é

O valor da propriedade FatorMultiplicador possui o valor  máximo permitido

de 9999999999.9999.

seqItemCanalVenda

Inteiro

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

Expandirinfo
titleClique para expandir...IMPORTANTE!

Atualmente, nossa API de Pedidos permite a realização de pedidos de venda com múltiplos pagamentos, contanto que os DTOs de pagamento transmitam o mesmo número de formas de pagamento no ERP. Em outras palavras, um pedido pode ser dividido em dois ou mais pagamentos, como por exemplo, utilizando dois cartões de crédito com prazos e parcelamentos diferentes, desde que a forma de pagamento seja a mesma para ambos.

nroParcela Numérico

Número de Parcelas

O valor da propriedade NroParcela
Expandir
titleClique para expandir...
Nomes

nroFormaPagto Numérico Obrigatório

Número da Forma de Pagamento do pedido.

O valor da propriedade NroFormaPagto possui o valor máximo permitido de 99999.


nroCondPagto Numérico Obrigatório

Número da Condição de Pagamento do pedido.

O valor da propriedade NroCondPagto

Nomes

nroFormaPagto Inteiro

Número Forma de Pagamento do pedido

O valor da propriedade NroFormaPagto possui o valor  máximo permitido de 99999

nroCondPagto Inteiro

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

nroGiftCard Numérico

Número do Gift Card

O valor da propriedade NroGiftCard possui o valor  máximo permitido de 999999999999999

possui o valor máximo permitido de

999999999999999

cpfCnpjCartao Texto

CPF/CNPJ do Proprietário do Cartão

999.

valorPagto Decimal Obrigatório

Valor do Pagamento.

O valor da propriedade

CpfCnpjCartao possui o tamanho máximo de 14 caracteres

cnpjInstituicaoPagto Texto

CNPJ da Instituição de Pagamento

ValorPagto aceita apenas valores entre 0.01 e 9999999999.99.

nroGiftCard Numérico

Número do Gift Card.

O valor da propriedade

CnpjInstituicaoPagto

NroGiftCard possui o

tamanho

valor  máximo permitido de

15 caracteres

idCarteira Texto

Identificação da Carteira

999999999999999.

nroParcela Numérico

Número de Parcelas.

O valor da propriedade

IdCarteira

NroParcela possui o

tamanho

valor máximo permitido de

8 caracteres

999999999999999.

tipoCarteira

cpfCnpjCartao Texto

Tipo de carteira

CPF/CNPJ do Proprietário do Cartão.

O valor da propriedade

TipoCarteira

CpfCnpjCartao possui o tamanho máximo de

2

14 caracteres.

idPagtoCanalVenda

cnpjInstituicaoPagto Texto

Obrigatório

CNPJ da Instituição de Pagamento.

Identificação do Pagamento do canal de venda

O valor da propriedade

IdPagtoCanalVenda

CnpjInstituicaoPagto possui o tamanho máximo de

60

15 caracteres

Array de objeto nsuDto Obrigatório

Coleção de dados complementares de cartões do pedido de venda

Expandir
titleClique para expandir...
Nomes

nsu Texto Obrigatório

.

idCarteira Texto

Identificação da Carteira.

O valor da propriedade IdCarteira possui o tamanho máximo de 8 caracteres.

tipoCarteira Texto

Tipo de carteira

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

TipoCarteira possui o tamanho máximo de

50

2 caracteres.

nroCartao Texto Obrigatório

Número do cartão utilizado no pagamento

idPagtoCanalVenda Texto 

Identificação do Pagamento do canal de venda.

O valor da propriedade

NroCartao

IdPagtoCanalVenda possui o tamanho máximo de

20

60 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ório

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

CABEÇALHOS

RESPOSTA

Dica

200

ok

Aviso

400

Falha

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

...

.

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, se no momento da integração do pedido você não possua os dados de NSU. Nesse caso é necessário preencher um idPagtoCanalVenda de sua escolha referente ao pagamento, e esta mesma informação deverá ser utilizada posteriormente no endpoint específico para inclusão dos dados do NSU: POST - Nsu.

Objeto nsuDto 

Coleção de dados complementares de cartões do pedido de venda

Expandir
titleClique 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 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

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.

RESPOSTA


Dica
titleResposta Recebida
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"
}




Aviso
titleResposta de Erro
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