<
From version < 15.1 >
edited by WBS Tecnologia
on 2021/06/02 16:28
To version < 14.1 >
edited by WBS Tecnologia
on 2021/05/21 19:56
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -Etiqueta de Rastreio - Enviar
1 +Pedidos - Enviar um Pedido
Content
... ... @@ -2,9 +2,9 @@
2 2  (((
3 3  (% class="container" %)
4 4  (((
5 -= Enviar uma Etiqueta de Rastreio na Plataforma =
5 += Inserir um Pedido na Plataforma =
6 6  
7 -Neste Método vamos descrever como enviar o PDF de uma etiqueta de rastreio para a Plataforma ERP.
7 +Neste Método vamos descrever como Inserir um Pedido na Plataforma.
8 8  )))
9 9  )))
10 10  
... ... @@ -16,17 +16,17 @@
16 16  
17 17  (% class="box infomessage" %)
18 18  (((
19 -Rota:/BDIApi/RastreioEtiqueta/Salvar/{CODIGO}
19 +Rota:/BDIApi/Pedido/Salvar
20 20  )))
21 21  
22 22  * Parâmetros:
23 23  * Requer Autenticação: **Sim **
24 24  * Método: **POST**
25 -* Tipo de Retorno**:  OK | Erro**
25 +* Tipo de Retorno**:  Void | Pedido**
26 26  * Headers:
27 27  ** API_TOKEN: Token de Autenticação
28 28  * Corpo/Payload
29 -** Conteudo do PDF da Etiqueta de Rastreio
29 +** JSON do Pedido
30 30  
31 31  == Códigos de Status ==
32 32  
... ... @@ -37,16 +37,8 @@
37 37  
38 38  = Detalhes da Ação =
39 39  
40 -Permite enviar o PDF da Etiqueta de Rastreio para o Sistema ERP da Catavento.
40 +Insere um Pedido na Plataforma
41 41  
42 -**Esta rota somente suporta o envios de PDFs**
43 -
44 -(% class="wikigeneratedid" %)
45 -=== Query String / Parametros ===
46 -
47 -|=Header|=Descrição / Validação|=Valor Padrão
48 -|{CODIGO}|Código do Rastreio|
49 -
50 50  === (% style="font-size:26px" %)Headers(%%) ===
51 51  
52 52  Abaixo segue os headers que devem ou podem ser passados para a ação:
... ... @@ -56,12 +56,119 @@
56 56  
57 57  == (% style="font-size:29px" %)Corpo(%%) ==
58 58  
59 -O Corpo da Requisição é o Conteudo do PDF em Formato RAW (Bytes), deve ser o um ARQUIVO PDF e não é recomendo que tenha mais de 5MB de Tamanho.
51 +Este é o Payload do corpo, este JSON representa o pedido a ser inserido na plataforma:
60 60  
61
53 +{{code language="json" layout="LINENUMBERS" title="Exemplo do Payload"}}
54 +{
55 + "Cabecalho": {
56 + "Codigo": 13555,
57 + "CriadoEm": "2020-12-19T13:25",
58 + "ValorDoFrete": 5.00,
59 + "TipoDeFrete": 1,
60 + "ValorTotal": 215.00,
61 + "Situacao": 0,
62 + "TipoDeConsumidor": 1,
63 + "TipoDeImportacao": 0,
64 + "Classificacao": "testes",
65 + "Observacoes": "Teste de Observação",
66 + "ValorDeDesconto": 0,
67 + "TipoDeEnvio": 100
68 + },
69 + "Itens": [
70 + {
71 + "Quantidade": 10,
72 + "ValorUnitario": 21.00,
73 + "Desconto": 0,
74 + "CodigoDeBarras": "9788522480432"
75 + }
76 + ],
77 + "Faturas": [
78 + {
79 + "NumeroDeParcelas": 1,
80 + "Valor": 215.00,
81 + "AprovadoEm": "2020-12-19T13:35",
82 + "NSU": "TESTE",
83 + "Autorizacao": "0983aisadafs90",
84 + "Resumo": "Teste de Fatura",
85 + "NumeroDoCartao": "XXXXXXXXXXXX5423",
86 + "FormaDePagamentoId": 17
87 + }
88 + ],
89 + "EnderecoDeCobranca": {
90 + "Nome": "Marcelo Junior",
91 + "Apelido": "Marcelo Junior",
92 + "Email": "teste@wbstecn.com.br",
93 + "CnpjCpf": "12345678900",
94 + "RgIE": "123456780",
95 + "Tipo": 1,
96 + "Bairro" : "Jd. Nova IP",
97 + "CEP" : "13000056",
98 + "Cidade" : "Minha Cidade",
99 + "Complemento" : "",
100 + "Destinatario" : "Marcelo Junior",
101 + "LinhaDeEndereco" : "Rua dos Opalas",
102 + "Pais" :"Brasil",
103 + "TelefoneFixo" : "19998885664",
104 + "UF" : "SP"
105 + },
106 + "EnderecoDeEntrega": {
107 + "Nome": "Marcelo Junior",
108 + "Apelido": "Marcelo Junior",
109 + "Email": "teste@wbstecn.com.br",
110 + "CnpjCpf": "12345678900",
111 + "RgIE": "123456780",
112 + "Tipo": 1,
113 + "Bairro" : "Jd. Nova IP",
114 + "CEP" : "13000056",
115 + "Cidade" : "Minha Cidade",
116 + "Complemento" : "",
117 + "Destinatario" : "Marcelo Junior",
118 + "LinhaDeEndereco" : "Rua dos Opalas",
119 + "Pais" :"Brasil",
120 + "TelefoneFixo" : "19998885664",
121 + "UF" : "SP"
122 + }
123 +}
124 +{{/code}}
125 +
126 +== Campos Obrigatórios e Validações: ==
127 +
128 +|**Nome**|**Descrição**
129 +|EnderecoDeCobranca|O Pedido deve ter pelo menos o endereço de Cobrança.
130 +|EnderecoDeCobranca.Complemento|Não deve conter mais de 80 caracteres.
131 +|EnderecoDeCobranca.LinhaDeEntrega|Não deve conter mais de 100 caracteres.
132 +|EnderecoDeCobranca.Nome|Não deve conter mais de 50 caracteres
133 +|EnderecoDeCobranca.Apelido|Não deve conter mais de 50 caracteres
134 +|EnderecoDeCobranca.Tipo|(((
135 +* 1 - Para pessoa física (PF);
136 +* 2- Para pessoa jurídica (PJ).
62 62  )))
138 +|EnderecoDeCobranca.RegTributario|(((
139 +* 1 - Simples Nacional;
140 +* 2 - Simples Nacional-excesso de sublimite da receita bruta;
141 +* 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)
142 +)))
143 +|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.
144 +| |
145 +|Itens[*].ProdutoId|Deve ser informado, caso o código de barras não for informado.
146 +|Itens[*].CodigoDeBarras|Deve ser informado, caso o Id do produto não for informado.
147 +|Itens[*].ValorUnitario|Deve ser maior que 0
148 +|Itens[*].Quantidade|Deve ser maior que 0
149 +|Itens[*].Desconto|Deve ser maior ou igual há 0
150 +| |
151 +|Cabecalho.Codigo|Não pode estar em branco
152 +|Cabecalho.CriadoEm|Obrigatório informar
153 +|Cabecalho.ValorDoFrete|Tem que ser 0 ou maior.
154 +|Cabecalho.ValorTotal|Tem que ser 0 ou maior
155 +|Cabecalho.TipoDeFrete|Tem que ser informado corretamente!
156 +|Cabecalho.TipoDeEnvio|Tem que ser informado o ID recuperado pela API de Tipos de Envio.
157 +|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).     
158 +|Para mais campos |[[Consulte>>doc:Web Rest API.BDI API.Pedidos.WebHome]]
63 63  
160 +
161 +)))
64 64  
163 +
65 65  (% class="col-xs-12 col-sm-4" %)
66 66  (((
67 67  {{box title="**Índice**"}}
WBS Tecnologia (C) 2024
1.2