2. Início
  4. Bloco de inserções
  6. Pedido de venda
  8. Versão 2.00

Versão 2.00

Estrutura de envio

NomeNívelObrigatórioTipo de dadoDescrição
pedidos0SimEstrutural
pedido1SimEstrural
id_externo1NãoAtributo de elemento (Texto)Utilizado para fazer referência a um documento externo
id2SimInteiroÉ possível manipular o ID do registro gerado pelo sistema. Enviar 0 para utilizar o ID gerado pelo sistema.
id_cliente2SimInteiroId do cliente do pedido de venda.
id_agenciador2Não InteiroId do agenciador aplicado ao pedido de venda. Enviar 0 quando não houver.
id_tabela_preco2SimInteiroId da tabela preço.
id_forma_entrega2SimInteiroId da forma de entrega.
id_status2SimInteiroId do status inicial do pedido de venda.
id_transportadora2SimInteiroId da transportadora do pedido de venda.
id_vendedor2SimInteiroId do vendedor. Enviar 0 para assumir o vendedor configurado no sistema.
id_condicao_pagamento2Sim InteiroId da condição de pagamento do pedido de venda
id_estoque2SimInteiroId do estoque do pedido de venda
data_entrega2SimDataData prevista para entrega dos produtos
data_cadastro2SimDataData da criação do pedido de venda
bonificacao2SimLógicoDetermina se o pedido será considerado como bonificação
reservado2SimLógicoDefine se pedido é criado com as mercadorias reservadas
observacao2SimTextoObservações gerais do pedido de venda
valor_itens2SimRealSoma total do valor dos itens
valor_frete2SimRealValor do frete
valor_total2SimRealValor total do pedido de venda (itens + frete)
endereco_entrega2SimEstrutural
cep3SimTexto(9)CEP do endereço de entrega
logradouro_com_numero3SimTexto(80)Logradouro com o número do endereço de entrega
ponto_referencia3SimTexto(40)Ponto de referência do endereço de entrega
estado3SimTexto(2)Estado do endereço de entrega
cidade3SimTexto(40)Cidade do endereço de entrega
bairro3SimTexto(40)Bairro do endereço de entrega
endereco_faturamento2SimEstrutural
cep3SimTexto(9)Cep do endereço de faturamento
logradouro_com_numero3SimTexto(80)Logradouro com o número do endereço de faturamento
ponto_referencia3SimTexto(40)Ponto de referência do endereço de faturamento
estado3SimTexto(2)Estado do endereço de faturamento
cidade3SimTexto(40)Cidade do endereço de faturamento
bairro3SimTexto(40)Bairro do endereço de cobrança
ecommerce2NãoLógicoCategoriza o pedido como origem e-commerce.
lancar_financeiro2NãoLógicoAutomatiza o lançamento no financeiro com base nas configurações padrões da condição de pagamento utilizada no pedido de venda.

Se enviado como verdadeiro, não se faz necessário o uso do serviço LancarPedidoFinanceiro
itens2SimEstrutural
item3SimEstrutural
id4Sim InteiroId do produto
unidade4SimTexto(3)Unidade de venda do produto
quantidade4SimRealQuantidade vendida
desconto_perc4SimReal Percentual de desconto aplicado no item
desconto_valor4SimRealValor do desconto aplicado no item
acrescimo_perc4SimReal
acrescimo_valor4SimReal
valor_unitario_bruto4SimReal
valor_unitario_liquido4SimReal
valor_total4SimRealSoma total do produto, incluindo os descontos
tabela_preco4SimTexto(20)Descrição da tabela de preço aplicada ao produto. Enviar em branco caso utilizar a mesma do pedido
observacoes4NãoTexto(250)Observações gerais por produto

Exemplo de envio

<pedidos versao="2.00" token="tkn-vinhasoft-001" id_empresa="1">
   <pedido id_externo="id_ext_8ff5">
      <id>0</id>
      <id_cliente>31</id_cliente>
      <id_agenciador>0</id_agenciador>
      <id_tabela_preco>1</id_tabela_preco>
      <id_forma_entrega>1</id_forma_entrega>
      <id_status>7</id_status>
      <id_transportadora>0</id_transportadora>
      <id_vendedor>0</id_vendedor>
      <id_condicao_pagamento>7</id_condicao_pagamento>
      <id_estoque>1</id_estoque>
      <data_entrega>2016-07-21T08:00:10.5</data_entrega>
      <data_cadastro>2016-07-21T08:00:10.5</data_cadastro>
      <bonificacao>false</bonificacao>
      <reservado>true</reservado>
      <observacao>Observacao</observacao>
      <valor_itens>570.00</valor_itens>
      <valor_frete>0.00</valor_frete>
      <valor_total>570.00</valor_total>
      <ecommerce>true</ecommerce>
      <endereco_entrega>
         <cep>13160000</cep>
         <logradouro_com_numero>Rua dos Relógios, Nº 123</logradouro_com_numero>
         <ponto_referencia>Ponto de referencia</ponto_referencia>
         <estado>SP</estado>
         <cidade>Campinas</cidade>
         <bairro>Centro</bairro>
      </endereco_entrega>
      <endereco_faturamento>
         <cep>13160000</cep>
         <logradouro_com_numero>Rua dos Relógios, Nº 123</logradouro_com_numero>
         <ponto_referencia>Ponto de referencia</ponto_referencia>
         <estado>SP</estado>
         <cidade>Campinas</cidade>
         <bairro>Centro</bairro>
      </endereco_faturamento>
      <itens>
         <item>
            <id>5094</id>
            <unidade>UN</unidade>
            <quantidade>1</quantidade>
            <desconto_perc>0</desconto_perc>
            <desconto_valor>0</desconto_valor>
            <acrescimo_perc>0</acrescimo_perc>
            <acrescimo_valor>0</acrescimo_valor>
            <valor_unitario_bruto>285.00</valor_unitario_bruto>
            <valor_unitario_liquido>285.00</valor_unitario_liquido>
            <valor_total>285</valor_total>
            <tabela_preco />
            <observacoes>Enviar apenas nas cores amarelas</observacoes>
         </item>
         <item>
            <id>3079</id>
            <unidade>UN</unidade>
            <quantidade>1</quantidade>
            <desconto_perc>0</desconto_perc>
            <desconto_valor>0</desconto_valor>
            <acrescimo_perc>0</acrescimo_perc>
            <acrescimo_valor>0</acrescimo_valor>
            <valor_unitario_bruto>285.00</valor_unitario_bruto>
            <valor_unitario_liquido>285.00</valor_unitario_liquido>
            <valor_total>285</valor_total>
            <tabela_preco />
         </item>
      </itens>
   </pedido>
</pedidos>

Exemplo de retorno

<retorno>
   <mensagens>
      <mensagem />
   </mensagens>
   <status>1</status>
   <registros>
      <registro>
         <id>id_ext_8ff5</id>
         <id_gerado>1241771</id_gerado>
         <status>1</status>
         <mensagens>
            <mensagem>
               <id>7</id>
               <descricao>Registro inserido com sucesso.</descricao>
            </mensagem>
         </mensagens>
      </registro>
   </registros>
</retorno>

Pedidos com a flag lancar_financeiro = true são retornados com os detalhes das parcelas geradas no lançamento financeiro

<?xml version="1.0" encoding="UTF-8"?>
<retorno>
   <registros>
      <registro>
         <id>id_ext_8ff5</id>
         <id_gerado>1243621</id_gerado>
         <status>1</status>
         <mensagens>
            <mensagem>
               <id>7</id>
               <descricao>Registro inserido com sucesso.</descricao>
            </mensagem>
         </mensagens>
         <extras>
            <ocorrencias>
               <detalhes>
                  <detalhe categoria="financeiro">
                     <id>1687541</id>
                     <descricao>Parcela lançada no financeiro</descricao>
                  </detalhe>
                  <detalhe categoria="financeiro">
                     <id>1687551</id>
                     <descricao>Parcela lançada no financeiro</descricao>
                  </detalhe>
               </detalhes>
            </ocorrencias>
         </extras>
      </registro>
   </registros>
   <status>1</status>
</retorno>

A informação retornada na tag extras->ocorrencias->detalhes->detalhe->id é o ID da parcela gerada para o financeiro do pedido de venda inserido.

Com o ID da parcela é possível realizar a sua quitação através do serviço de quitação financeira.

Este artigo foi útil para você? Sim Não