Inserir um Pedido na Plataforma

Neste Método vamos descrever como Inserir um Pedido na Plataforma.

Detalhes da Rota

Rota:/BDIApi/Pedido/Salvar

  • Parâmetros: 
  • Requer Autenticação: Sim 
  • Método: POST
  • Tipo de Retorno:  Void | Pedido
  • Headers:
    • API_TOKEN: Token de Autenticação
  • Corpo/Payload
    • JSON do Pedido

Códigos de Status

  • 404 = Sem resultados
  • 500 = Erro Interno do Servidor
  • 200 = OK 
  • 403 = Acesso Negado, Token de Autenticação Inválido?

Detalhes da Ação

Insere um Pedido na Plataforma

Headers

Abaixo segue os headers que devem ou podem ser passados para a ação:

HeaderDescrição / ValidaçãoValor Padrão
API_TOKEN[Obrigatório] Token da Autenticação 

Corpo

Este é o Payload do corpo, este JSON representa o pedido a ser inserido na plataforma:

Exemplo do Payload
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
{
"Cabecalho": {
 "Codigo": 13555,
 "CriadoEm": "2020-12-19T13:25",
 "ValorDoFrete": 5.00,
 "TipoDeFrete": 1,
 "ValorTotal": 215.00,
 "Situacao": 0,
 "TipoDeConsumidor": 1,
 "Classificacao": "testes",
 "Observacoes": "Teste de Observação",
 "ValorDeDesconto": 0,
 "TipoDeEnvio": 100
 },
"Itens": [
  {
  "Quantidade": 10,
  "ValorUnitario": 21.00,
  "Desconto": 0,
  "CodigoDeBarras": "9788522480432"
  }
 ],
"Faturas": [
  {
  "NumeroDeParcelas": 1,
  "Valor": 215.00,
  "AprovadoEm": "2020-12-19T13:35",
  "NSU": "TESTE",
  "Autorizacao": "0983aisadafs90",
  "Resumo": "Teste de Fatura",
  "NumeroDoCartao": "XXXXXXXXXXXX5423",
  "FormaDePagamentoId": 17
  }
 ],
"EnderecoDeCobranca": {
 "Nome": "Marcelo Junior",
 "Apelido": "Marcelo Junior",
 "Email": "teste@wbstecn.com.br",
 "CnpjCpf": "12345678900",
 "RgIE": "123456780",
 "Tipo": 1,
 "Bairro" : "Jd. Nova IP",
 "CEP" : "13000056",
 "Cidade" : "Minha Cidade",
 "Complemento" : "",
 "Destinatario" : "Marcelo Junior",
 "LinhaDeEndereco" : "Rua dos Opalas",
 "Pais" :"Brasil",
 "TelefoneFixo" : "19998885664",
 "UF" : "SP"
 },
"EnderecoDeEntrega": {
 "Nome": "Marcelo Junior",
 "Apelido": "Marcelo Junior",
 "Email": "teste@wbstecn.com.br",
 "CnpjCpf": "12345678900",
 "RgIE": "123456780",
 "Tipo": 1,
 "Bairro" : "Jd. Nova IP",
 "CEP" : "13000056",
 "Cidade" : "Minha Cidade",
 "Complemento" : "",
 "Destinatario" : "Marcelo Junior",
 "LinhaDeEndereco" : "Rua dos Opalas",
 "Pais" :"Brasil",
 "TelefoneFixo" : "19998885664",
 "UF" : "SP"
 }
}

Campos Obrigatórios e Validações:

NomeDescrição
EnderecoDeCobrancaO Pedido deve ter pelo menos o endereço de Cobrança.
EnderecoDeCobranca.ComplementoNão deve conter mais de 80 caracteres.
EnderecoDeCobranca.LinhaDeEntregaNão deve conter mais de 100 caracteres.
EnderecoDeCobranca.NomeNão deve conter mais de 50 caracteres
EnderecoDeCobranca.ApelidoNão deve conter mais de 50 caracteres
EnderecoDeEntegraSe informado respeita as mesmas regras do Endereço de Cobrança, se não informado o Endereço de Cobrança será utilizado no lugar.
Itens[*].ProdutoIdDeve ser informado, caso o código de barras não for informado.
Itens[*].CodigoDeBarrasDeve ser informado, caso o Id do produto não for informado.
Itens[*].ValorUnitarioDeve ser maior que 0
Itens[*].QuantidadeDeve ser maior que 0
  
Cabecalho.CodigoNão pode estar em branco
Cabecalho.CriadoEmObrigatório informar
Cabecalho.ValorDoFreteTem que ser 0 ou maior.
Cabecalho.ValorTotalTem que ser 0 ou maior
Cabecalho.TipoDeFreteTem que ser informado corretamente!
Cabecalho.TipoDeEnvioTem que ser informado o ID recuperado pela API de Tipos de Envio.
  

 

Tags:
 
WBS Tecnologia (C) 2024
1.2