Changes for page Nota Fiscal - Obter XML ou Danfe
Last modified by WBS Tecnologia on 2021/10/04 12:05
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 - Etiquetade Rastreio - Enviar1 +Pedidos - Enviar um Pedido - Content
-
... ... @@ -2,9 +2,9 @@ 2 2 ((( 3 3 (% class="container" %) 4 4 ((( 5 -= Enviar umaEtiquetade Rastreio na Plataforma =5 += Inserir um Pedido na Plataforma = 6 6 7 -Neste Método vamos descrever como enviaro PDF deumaetiquetade rastreioparaaPlataformaERP.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 -** Conteudodo PDF da Etiquetade Rastreio29 +** 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 - PermiteenviaroPDF da Etiquetade Rastreioparao Sistema ERPdaCatavento.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é oConteudodoPDF em FormatoRAW (Bytes),devesero um ARQUIVOPDFenão érecomendoquetenhamaisde5MB deTamanho.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**"}}