POST /propostacomercial

Insere uma proposta comercial

Insere uma proposta comercial no sistema.

curl -X POST "https://bling.com.br/Api/v2/propostacomercial/json/"
     -d "apikey={apikey}"
     -d "xml={xml_da_proposta}"

$url = 'https://bling.com.br/Api/v2/propostacomercial/json/';
$xml = '>...';
$posts = array (
    "apikey" => "{apikey}",
    "xml" => rawurlencode($xml)
);
$retorno = executeSendOrder($url, $posts);
echo $retorno;
function executeSendOrder($url, $data){
    $curl_handle = curl_init();
    curl_setopt($curl_handle, CURLOPT_URL, $url);
    curl_setopt($curl_handle, CURLOPT_POST, count($data));
    curl_setopt($curl_handle, CURLOPT_POSTFIELDS, $data);
    curl_setopt($curl_handle, CURLOPT_RETURNTRANSFER, TRUE);
    $response = curl_exec($curl_handle);
    curl_close($curl_handle);
    return $response;
}

public static void ExecuteSendOrder() {
    HttpWebRequest request =
        (HttpWebRequest)WebRequest.Create("https://bling.com.br/Api/v2/propostacomercial/");
    ASCIIEncoding encoding = new ASCIIEncoding();
    string postData = "apikey={apiKey}&xml={xml_do_pedido}";
    byte[] data = encoding.GetBytes(postData);
    request.Method = "POST";
    request.ContentType = "application/x-www-form-urlencoded";
    request.ContentLength = data.Length;
    using (Stream stream = request.GetRequestStream())
        stream.Write(data,0,data.Length);
    HttpWebResponse response = (HttpWebResponse)request.GetResponse();
    string responseString = new StreamReader(response.GetResponseStream()).ReadToEnd();
    Console.Out.WriteLine("Response Body: \r\n {0}", responseString);
}

Para o parâmetro xml, é necessário seguir um padrão.

Tabela de campos do XML

Notas

1. O campo data é opcional, caso não seja preenchido a data da inclusão será informada. Este campo é utilizado como base para cálculo do vencimento quando na parcela é informado o número de dias.
   
   
2. O critério de busca do contato é pelo id do contato ou pelo cpfCnpj.
   
   
3. Valores para tipo de pessoa:

1. Valores para contribuinte do contato:

1. O campo código do item é opcional somente quando a opção de vínculo seja pelo campo descrição.
   
   
2. No campo Tipo Frete, podemos salvar com os seguintes valores com letra maiúscula para os caracteres.
   
   

   Valor	Descrição
   R	Contratação do Frete por conta do Remetente (CIF)
   D	Contratação do Frete por conta do Destinatário (FOB)
   T	Contratação do Frete por conta de Terceiros
   3	Transporte Próprio por conta do Remetente
   4	Transporte Próprio por conta do Destinatário
   S	Sem Ocorrência de Transporte

Vínculo do produto com o cadastro do sistema

O produto será vinculado com um produto previamente cadastrado no sistema caso o campo descricao ou codigo sejam idênticos ao do cadastro.

A escolha de qual campo será utilizado para realizar a comparação é definida acessando Preferências > Parâmetros da empresa > Configurações de Lojas Virtuais e alterando a opção Na importação através da API, buscar produtos por código ou descrição.

Mensagens de erros específicos

Exemplo de XML

<?xml version="1.0" encoding="UTF-8"?>
<propostacomercial>
   <desconto>10</desconto>
   <obsInterna></obsInterna>
   <data>10/12/2018</data>
   <dataProximoContato>15/08/2019</dataProximoContato>
   <numeroProposta>5</numeroProposta>
   <vendedor></vendedor>
   <valorFrete>50</valorFrete>
   <loja>49708527</loja>
   <aosCuidadosDe></aosCuidadosDe>
   <garantia>9999</garantia>
   <validadeDaProposta>15</validadeDaProposta>
   <observacao>Teste</observacao>
   <prazoEntrega>5</prazoEntrega>
   <assinaturaSaudacao>Atenciosamente,</assinaturaSaudacao>
   <assinaturaResponsavel>Departamento de vendas</assinaturaResponsavel>
   <idContato>0000001</idContato>
   <cliente>
     <nome>Organisys Software</nome>
     <cpfCnpj>00.000.000/0000-1</cpfCnpj>
     <tipoPessoa>J</tipoPessoa>
     <ie></ie>
     <rg></rg>
     <endereco>Rua Visconde de São Gabriel</endereco>
     <numero>001</numero>
     <complemento>Sala 03</complemento>
     <cidade>Bento Gonçalves</cidade>
     <bairro>Cidade Alta</bairro>
     <cep>95.700-000</cep>
     <uf>RS</uf>
     <email>teste@organisys.com.br</email>
     <celular>(00) 00000-0000</celular>
     <fone>(00) 0000-0000</fone>
   </cliente>
   <itens>
     <item>
         <codigo>001</codigo>
         <descricao>teste</descricao>
         <qtde>5</qtde>
         <valorUnidade>1</valorUnidade>
         <un>un</un>
     </item>
     <item>
         <codigo>002</codigo>
         <descricao>teste2</descricao>
         <qtde>100</qtde>
         <valorUnidade>50</valorUnidade>
         <un></un>
      </item>
    </itens>
    <parcelas>
      <parcela>
          <valor>90</valor>
          <obs>Teste obs 1</obs>
          <nrDias>50</nrDias>
          <formaPagamento>
          <id>0001</id>
          </formaPagamento>
      </parcela>
      <parcela>
         <valor>5000</valor>
         <obs>Teste obs 2</obs>
         <nrDias>100</nrDias>
         <formaPagamento>
             <id>0002</id>
         </formaPagamento>
      </parcela>
   </parcelas>
   <transporte>
       <transportadora>Transportadora XYZ</transportadora>
       <tipoFrete>s</tipoFrete>
       <qtdVolumes>50</qtdVolumes>
       <pesoBruto>5</pesoBruto>
   </transporte>
</propostacomercial>

Retorno

{
    "retorno": {
        "propostascomerciais": [
            {
                "propostacomercial": {
                    "id": 00000001,
                    "numero": 01
                }
            }
        ]
    }
}