Last modified by WBS Tecnologia on 2022/12/06 12:02
Show last authors
1 (% class="jumbotron" %)
2 (((
3 (% class="container" %)
4 (((
5 = Inserir vários Pedidos na Plataforma =
6
7 Neste Método vamos descrever como inserir um ou mais Pedidos na Plataforma na mesma requisição.
8 )))
9 )))
10
11 (% class="row" %)
12 (((
13 (% class="col-xs-12 col-sm-8" %)
14 (((
15 = Detalhes da Rota =
16
17 (% class="box infomessage" %)
18 (((
19 Rota:/BDIApi/Pedido/SalvarVarios
20 )))
21
22 * Parâmetros:
23 * Requer Autenticação: **Sim **
24 * Método: **POST**
25 * Tipo de Retorno**:  Void | Pedido**
26 * Headers:
27 ** API_TOKEN: Token de Autenticação
28 * Corpo/Payload
29 ** JSON do Pedido
30
31 == Códigos de Status ==
32
33 * 404 = Sem resultados
34 * 500 = Erro Interno do Servidor
35 * 200 = OK
36 * 403 = Acesso Negado, Token de Autenticação Inválido?
37
38 = Detalhes da Ação =
39
40 Insere um Pedido na Plataforma
41
42 === (% style="font-size:26px" %)Headers(%%) ===
43
44 Abaixo segue os headers que devem ou podem ser passados para a ação:
45
46 |=Header|=Descrição / Validação|=Valor Padrão
47 |API_TOKEN|[Obrigatório] Token da Autenticação|
48
49 == (% style="font-size:29px" %)Corpo(%%) ==
50
51 Este é o Payload do corpo, este JSON representa o pedido a ser inserido na plataforma:
52
53 {{code language="json" layout="LINENUMBERS" title="Exemplo do Payload"}}
54 {
55 "Pedidos" : [{
56 "Cabecalho": {
57 "Codigo": 13555,
58 "CriadoEm": "2020-12-19T13:25",
59 "ValorDoFrete": 5.00,
60 "TipoDeFrete": 1,
61 "ValorTotal": 215.00,
62 "Situacao": 0,
63 "TipoDeConsumidor": 1,
64 "TipoDeImportacao": 0,
65 "Classificacao": "testes",
66 "Observacoes": "Teste de Observação",
67 "ValorDeDesconto": 0,
68 "TipoDeEnvio": 100
69 },
70 "Itens": [
71 {
72 "Quantidade": 10,
73 "ValorUnitario": 21.00,
74 "Desconto": 0,
75 "CodigoDeBarras": "9788522480432"
76 }
77 ],
78 "Faturas": [
79 {
80 "NumeroDeParcelas": 1,
81 "Valor": 215.00,
82 "AprovadoEm": "2020-12-19T13:35",
83 "NSU": "TESTE",
84 "Autorizacao": "0983aisadafs90",
85 "Resumo": "Teste de Fatura",
86 "NumeroDoCartao": "XXXXXXXXXXXX5423",
87 "FormaDePagamentoId": 17
88 }
89 ],
90 "EnderecoDeCobranca": {
91 "RegTributario" : 0,
92 "Nome": "Marcelo Junior",
93 "Apelido": "Marcelo Junior",
94 "Email": "teste@wbstecn.com.br",
95 "CnpjCpf": "12345678900",
96 "RgIE": "123456780",
97 "Tipo": 1,
98 "Bairro" : "Jd. Nova IP",
99 "CEP" : "13000056",
100 "Cidade" : "Minha Cidade",
101 "Complemento" : "",
102 "Destinatario" : "Marcelo Junior",
103 "LinhaDeEndereco" : "Rua dos Opalas",
104 "Pais" :"Brasil",
105 "TelefoneFixo" : "19998885664",
106 "UF" : "SP"
107 },
108 "EnderecoDeEntrega": {
109 "RegTributario" : 0,
110 "Nome": "Marcelo Junior",
111 "Apelido": "Marcelo Junior",
112 "Email": "teste@wbstecn.com.br",
113 "CnpjCpf": "12345678900",
114 "RgIE": "123456780",
115 "Tipo": 1,
116 "Bairro" : "Jd. Nova IP",
117 "CEP" : "13000056",
118 "Cidade" : "Minha Cidade",
119 "Complemento" : "",
120 "Destinatario" : "Marcelo Junior",
121 "LinhaDeEndereco" : "Rua dos Opalas",
122 "Pais" :"Brasil",
123 "TelefoneFixo" : "19998885664",
124 "UF" : "SP"
125 }
126 }]
127 }
128 {{/code}}
129
130 (% class="wikigeneratedid" %)
131 **TIP: **Veja que o conteudo do json é o mesmo da rota "**Salvar"**, porem nesta rota, ele é passado dentro de uma array que pode conter vários pedidos.
132
133 == Campos Obrigatórios e Validações: ==
134
135 |**Nome**|**Descrição**
136 |EnderecoDeCobranca|O Pedido deve ter pelo menos o endereço de Cobrança.
137 |EnderecoDeCobranca.Complemento|Não deve conter mais de 50 caracteres.
138 |EnderecoDeCobranca.LinhaDeEndereco|Não deve conter mais de 100 caracteres.
139 |EnderecoDeCobranca.Nome|Não deve conter mais de 50 caracteres
140 |EnderecoDeCobranca.Apelido|Não deve conter mais de 50 caracteres
141 |EnderecoDeCobranca.Tipo|(((
142 * 1 - Para pessoa física (PF);
143 * 2- Para pessoa jurídica (PJ).
144 )))
145 |EnderecoDeCobranca.RegTributario|(((
146 * 1 - Simples Nacional;
147 * 2 - Simples Nacional-excesso de sublimite da receita bruta;
148 * 3 - Regime Normal (Essa informação é para a emissão da Nota Fiscal. Para pessoa física gravar 0 e para pessoa jurídica informar, se possível, o regime tributário correto. Caso essa informação esteja indisponível, gravar 3)
149 )))
150 |EnderecoDeEntrega|Se 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.
151 | |
152 |Itens[*].ProdutoId|Deve ser informado, caso o código de barras não for informado.
153 |Itens[*].CodigoDeBarras|Deve ser informado, caso o Id do produto não for informado.
154 |Itens[*].ValorUnitario|Deve ser maior que 0
155 |Itens[*].Quantidade|Deve ser maior que 0
156 |Itens[*].Desconto|Deve ser maior ou igual há 0
157 | |
158 |Cabecalho.Codigo|Não pode estar em branco
159 |Cabecalho.CriadoEm|Obrigatório informar
160 |Cabecalho.ValorDoFrete|Tem que ser 0 ou maior.
161 |Cabecalho.ValorTotal|Tem que ser 0 ou maior
162 |Cabecalho.TipoDeFrete|Tem que ser informado corretamente!
163 |Cabecalho.TipoDeEnvio|Tem que ser informado o ID recuperado pela API de Tipos de Envio.
164 |Cabecalho.TipoDeImportacao|0 - Importar e Reservar (Todos os pedidos serão importados, independentemente da confirmação de pagamento do cliente por parte do EC. Nessa situação, os produtos ficarão como Reservados para atender esse pedido, aguardando o EC mudar o status para 1);  1 - Importar e/ou Liberar (Serão importados apenas os pedidos que estão com pagamento do cliente confirmado por parte do EC. Nessa situação, os produtos ficarão com a situação de Liberados para atender o pedido); 2 - Cancelar (Após o pedido ter sido importado, ele será cancelado se o EC colocar a situação como 2, desde que não tenha sido emitida nota fiscal).     
165 |Para mais campos |[[Consulte>>doc:Web Rest API.BDI API.Pedidos.WebHome]]
166
167
168 )))
169
170
171 (% class="col-xs-12 col-sm-4" %)
172 (((
173 {{box title="**Índice**"}}
174 {{toc/}}
175 {{/box}}
176
177 {{box}}
178 **Exemplos**
179
180 * Exemplo de Payload: BAIXAR
181 * Exemplo de Resultado: BAIXAR
182 {{/box}}
183 )))
184 )))
WBS Tecnologia (C) 2024
1.2