Tabela 16 - Pedidos
- Este artigo apresenta os campos do layout de integração de pedido. Para entender melhor o conceito por trás dos pedidos, consulte o nosso artigo em Conceito de Pedido.
- Para realizar essa integração é preciso enviar as informações junto com a Tabela 17 - Item do Pedido
- Nesta tabela será enviado os itens de cada pedido.
| Ordem | Descrição do Campo | Formato e Tamanho | Obrigatório | Versão | Observação |
| 1 | Identificador da Tabela (IDENTIFICADOR) | FIXO=16 (2) | Sim | 1.0 | |
| 2 | Identificador do Pedido (ID) | Inteiro (10) | Não | 1.0 | Identificador único do pedido no Demander. |
| 3 | Número do Pedido (codigo) | Inteiro (10) | Sim | 1.0 | Igual ao Número do Pedido. |
| 4 | Código da Forma de Pagamento (codFormaPagamento) | Texto (20) | Não | 1.0 | |
| 5 | Código da Condição de Pagamento (codCondicaoPagamento) | Texto (20) | Não | 1.0 | |
| 6 | Código do Status do Pedido (codStatus) | Inteiro (10) | Não | 1.0 | Enviar o código do status. |
| 7 | Código da Filial (codFilial) | Texto (15) | Não | 1.0 | |
| 8 | Código do Cliente (codCliente) | Inteiro (10) | Sim | 1.0 | Clientes novos vem com código "0". |
| 9 | CPF ou CNPJ do Cliente (cpfCNPJCliente) | Texto (20) | Sim | 1.0 | Com máscara. |
| 10 | Código da Lista de Preço (codListaPreco) | Texto (20) | Sim | 1.0 | |
| 11 | Código do Vendedor (codVendedor) | Inteiro (10) | Sim | 1.0 | |
| 12 | Código do Portador (codPortador) | Inteiro (10) | Não | 1.0 | Reservado para uso futuro. |
| 13 | Número do Pedido (numPedido) | Inteiro (10) | Sim | 1.0 | |
| 14 | Sequencial do Vendedor (sequencialVendedor) | Inteiro (10) | Não | 1.0 | Reservado para uso futuro. |
| 15 | Número da Ordem de Compra (numOrdemCompra) | Texto (50) | Não | 1.0 | |
| 16 | Data e Hora de Emissão (dataEmissao) | DataHora | Sim | 1.0 | |
| 17 | Valor Produtos (com acréscimo ou desconto unitário) (valorProdutosComDescAcres) | Decimal (15,2) | Não | 1.0 | Valor de Venda dos Produtos, já com o valor de Acréscimo ou Desconto Concedido (Antigo campo valorTotal). |
| 18 | Valor Produtos (sem acréscimo ou desconto unitário) (valorProdutosSemDescAcres) | Decimal (15,2) | Não | 1.0 | Valor dos Produtos, sem o valor do acréscimo ou Desconto concedido. Antigo campo valorBruto. |
| 19 | Quantidade de Itens do Pedido (qtdeItens) | Inteiro (10) | Não | 1.1 | |
| 20 | Identificador do Aparelho (IMEI) | Texto (50) | Não | 1.0 | IMEI do aparelho no qual o pedido foi emitido. |
| 21 | Operação Fiscal Utilizada no Pedido (operacaoFiscal) | Inteiro (10) | Não | 1.0 | Reservado para uso futuro. |
| 22 | Observação Interna (observação) | Texto (1000) | Não | 1.0 | Observação Interna da Empresa, que não aparece para o Cliente (PDF do Pedido). |
| 23 | Campo Livre 1 (Campo Livre 1) | Texto (45) | Não | 1.0 | Reservado para uso futuro. |
| 24 | Campo Livre 2 (Campo Livre 2) | Texto (45) | Não | 1.0 | Reservado para uso futuro. |
| 25 | Campo Livre 3 (Campo Livre 3) | Texto (45) | Não | 1.0 | Reservado para uso futuro. |
| 26 | Código do Tipo de Pedido (codTipoPedido) | Inteiro (10) | Sim | 1.0 | Código dos registros cadastrados para a empresa no cadastro de 'Tipos de Pedido'. |
| 27 | Previsão de Entrega (previsaoEntrega) | DataHora | Não | 1.0 | |
| 28 | Código Vendedor Emissor (codVendedorEmissor) | Inteiro (10) | Não | 1.0 | Observação: Neste campo é exportado o código do vendedor que fez a emissão do pedido esse campo será diferente do campo codVendedor na seguinte situação: O Gerente de venda emite um pedido para um cliente vinculado a um vendedor, o codVendedorEmissor será o gerente de vendas, e o codVendedor será o código do vendedor vinculado ao cliente. Apenas será obrigatório casoa empresa NÃO Utilizar faixa de numeração dos pedidos por vendedor, que fica nas Configurações da Empresa > Aba Vendedores |
| 29 | Latitude (latitude) | Texto (50) | Não | 2.3 | |
| 30 | Longitude (longitude) | Texto (50) | Não | 2.3 | |
| 31 | Origem do Pedido (origemPedido) | Inteiro (4) | Não | 2.8 | 1 - Pedido Emitido no Demander (Android, iOS), 2 - Pedido Emitido no ERP, 3 – Loja B2B, 4 – Pedido web, 5 - Loja Integrada, 6 - Mercado livre, 7 - Tray |
| 32 | Valor do Frete (valorFrete) | Decimal (15,2) | Sim | 2.11 | |
| 33 | Valor Total do Pedido (valorTotalPedido) | Decimal (15,2) | Sim | 2.11 | Valor total do Pedido (Valor dos Produtos+Valor Frete+IPI+ICMS ST+Juros/Desconto pela Forma de Pagamento). |
| 34 | Tipo de Frete (tipoFrete) | Inteiro (2) | Não | 2.12.3 | Código do Tipo de Frete. |
| 35 | Valor Total de IPI (valorIPI) | Decimal (15,2) | Sim | 2.13 | Valor Total do IPI (Soma do IPI de cada Item) |
| 36 | Valor Total de ICMS ST (valorICMS_ST) | Decimal (15,2) | Sim | 2.13 | Valor Total de ICMS ST (Soma do Valor de ICMS ST) |
| 37 | Cancelado (cancelado) | Inteiro (1) | Sim | 2.17 | 1 - Pedido Cancelado; 0 - Pedido Não Cancelado; (Pedidos cancelados não são contabilizados nos Relatórios de Vendas/Metas/Comissões, porém continua aparecendo no Demander) |
| 38 | Observação p/ Cliente (observacaoCliente) | Texto (1000) | Sim | 2.20 | O que for digitado neste campo aparece no Emissão do PDF do Pedido que é enviado ao Cliente. |
| 39 | Tipo de Desconto (tipoDesconto) | Texto (2) | Sim | 2.21 | "R$" para Desconto informado em Valor. "%" para Desconto Informado em Percentual. |
| 40 | Percentual de Desconto a Nível de Pedido (percentualDescontoDoPedido) | Decimal (15,2) | Sim | 2.21 | Esse é o valor de Desconto concedido a nível de Pedido, e que foi rateado entre os Itens. Não está incluso o Desconto informado diretamente nos Itens. OBS: Em caso de Acréscimo esta informação é negativa. EX: -10 significa 10% de acréscimo. |
| 41 | Valor do Desconto a Nível de Pedido (valorDescontoDoPedido) | Decimal (15,2) | Sim | 2.21 | Esse é o valor de Desconto concedido a nível de Pedido, e que foi rateado entre os Itens. Não está incluso o Desconto informado diretamente nos Itens |
| 42 | Percentual de Desconto/Juros da Condição de Pagamento (percJurosCondPag) | Decimal (15,2) | Sim | 2.24 | Percentual de Desconto/Juros da Condição de Pagamento no momento do pedido. OBS: Em caso de Acréscimo esta informação é negativa. EX: -10 significa 10% de acréscimo. |
| 43 | Informação da captura de GPS (provider) | Texto (50) | Não | 2.28 | Campo que informa se a posição geográfica foi capturada pelo GPS ou pela Internet, o que vai ser enviado ou recebido é (network ou gps) |
| 44 | Valor da Comissão (valorTotalComissao) | Decimal (18,2) | Não | 2.35 | Valor total da comissão do pedido calculado pelo Demander. |
| 45 | Código da Transportadora (codTransportadora) | Texto (15) | Não | 2.38 | Código da trasportadora, registros da Tabela 29 |
| 46 | Código da Transportadora de Re-despacho (codRedespacho) | Texto (15) | Não | 2.41 | Código da trasportadora de re-despacho, registros da Tabela 29 |
| 47 | UniqueId enderecoEntrega (uniqueidEnderecoEntrega) | Inteiro (100) | Não | 3.0 | Código do Endereço de entrega do cliente, Registro da Tabela 115 |
| 48 | Segmento (codsegmento) | Inteiro (10) | Não | 3.0 | Código do segmento utilizado no pedido. |
| 49 | idERP (idERP EnderecoEntrega) | Não | |||
| 50 | Usou a tabela de desconto (usouTabelaDesconto) | Inteiro (1) | Não | 3.0 | Se o pedido usou a tabela de desconto na sua emissão |
| 51 | Código do tipo de desconto (codTipoDesconto) | Texto (255) | Não | 3.3 | Campo referente ao código do tipo de desconto usado no pedido. Tipo de desconto este enviado na Tabela 130 – Tipo de Desconto |
| 52 | Valor total da taxa Adicional (totalTaxaAdicional) | Decimal (15,2) | Não | 3.3 | Valor total da taxa adicional que será cobrada; Valor este que deve ser igual ao somatório do campo 31 dos itens do pedido. |
| 53 | Valor à abater da base de cálculo da comissão (valorAbaterBCComissao) | Decimal (15,2) | Não | 3.4 | Referente ao somatório do campo 32 - valorAbaterBCComissao da Tabela 17 – ItemPedido |
| 54 | Número do pedido principal (numPedidoOrigem) | Inteiro (10) | Não | 3.5 | Em caso de um pedido ser vinculado a outro, este campo serve para identificar o pedido principal que deu origem a este. |
| 55 | Descontinuado | Não | Este campo foi descontinuado na versão 4.46 | Enviar VAZIO | ||
| 56 | ID único do Cliente no Demander (IdCliente) | Inteiro | Não | 3.5 | |
| 57 | Peso Bruto (pesoBruto) | Decimal | Não | 3.10 | Peso bruto total do pedido |
| 58 | Peso Liquido (pesoLiquido) | Decimal | Não | 3.10 | Peso liquido total do pedido |
| 59 | Cubagem (cubagem) | Decimal | Não | 3.10 | Cubagem total do pedido |
| 60 | UniqueID endereço de faturamento (uniqueIdEnderecoFaturamento) | Texto (100) | Não | 3.22 | |
| 61 | UniqueID endereço de cobrança (uniqueIdEnderecoCobranca) | Texto (100) | Não | 3.22 | |
| 62 | Observações da integração (observacaoIntegracao) | Texto | Não | 3.24 | |
| 63 | Percentual da margem de contribuição (percMargemContribuicao) | Decimal (8,2) | Não | 3.38 | |
| 64 | Custo da reposição da venda (custoReposicaoNaVenda) | Decimal (8,2) | Não | 3.38 | |
| 65 | Código do status da liberação (codStatusLiberacao) | Inteiro (6) | Não | 3.38 | 0 - Bloqueado 1 - Liberado 2 - Rejeitado |
| 66 | Motivo pelo qual o pedido está bloqueado (motivoBloqueio) | Texto (255) | Não | 3.38 | |
| 67 | Identificador do usuário que liberou o pedido (idUsuarioAvaliou) | Inteiro (10) | Não | 3.38 | |
| 68 | Motivo da liberação do pedido (motivoAvaliacao) | Texto | Não | 3.38 | |
| 69 | Valor de desconto destacado (descontoDestacado) | Decimal (15,2) | Não | 3.46 | |
| 70 | Percentual de desconto destacado (percDescontoDestacado) | Decimal | Não | 3.54 | Campo utilizado somente para exportação. Atualmente o campo não é importado do ERP. O percentual de desconto destacado é dado pela proporção do valor de desconto destacado (campo 69) em cima do valor total do pedido (campo 33). OBS: Em caso de Acréscimo esta informação é negativa. EX: -10 significa 10% de acréscimo. |
| 71 | Percentual desconto sobre desconto (percDescontoSobreDesconto) | Decimal | Não | 3.54 | Campo utilizado para retornar o percentual de desconto sobre desconto digitado pelo usuário. OBS: Em caso de Acréscimo esta informação é negativa. EX: -10 significa 10% de acréscimo. |
| 72 | Json de desconto ou acréscimo (jsonDescontosAcrescimos) | Texto | Não | Veja aqui a estruturado json enviado neste campo | |
| 73 | Valor Despesas Acessórias (valorDespesasAcessorias) | Decimal (15,2) | Não | 4.37 | Campo utilizado para inclusão de valores relacionados a despesas extras. |
| 74 | Número do Pedido no ERP (numPedidoERP) | Varchar (50) | Não | 4.45 | Este campo refere-se ao identificador (Código) que o Pedido tem no ERP, para que possa ser identificado o pedido no Demander a partir do código que ele tem no ERP. |
| 75 | Código ISO da Moeda (codMoeda) | Varchar(3) | Não | 4.47 | Código ISO da Moeda deste pedido. Exemplo: BRL - REAL USD - DÓLAR |
| 76 | Valor Total do Redespacho (valorTotalRedespacho) | Decimal (15,2) | Não | 4.49 | |
| 77 | Usada somente para exportação (codRota) | Inteiro (10) | Não | 4.53 | Este campo somente é exportado para o ERP. Deve ser enviado vazio para o Demander |
| 78 | Divisão de Venda (codDivisaoVenda) | Varchar(30) | Não | 5.15 | |
| Observação: Os itens de cada pedido devem ser exportados logo após o pedido |
Exemplo de Registro:
16||00026147|2|28|7|1|127779|01.132.478/0030-72|26|89931||00026147|||2020-07-09 13:31:00|211.86|211.86|2|||EXC||||1||89931|||2|0|227.5|1|15.64|0|0| |R$|0|0|||0|0|124540|||1|0||0|0|0||0||