×
Entrar
Experimente grátis
Top

POST /produtofornecedor

  • Atualizado
Seguir

A API V3 JÁ ESTÁ DISPONÍVEL


A API v2 foi descontinuada e não receberá mais atualizações.

Acesse a documentação da API v3 link-externo.png

Info- icon-P.png As integrações API v2 que já estão configuradas, seguirão funcionando temporariamente.
Realize a migração para a nova versão o mais breve possível. Consulte o calendário link-externo.png

 

Insere um produto fornecedor

Insere dados específicos no produto para um determinado contato (fornecedor).

 

curl

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

PHP

 
$url = 'https://bling.com.br/Api/v2/produtofornecedor/json/';
$xml = '...';
$posts = array (
    "apikey" => "{apikey}",
    "xml" => rawurlencode($xml)
);
$data = executeSendProductProvider($url, $posts);
echo $data;
function executeSendProductProvider($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;
}

C#

 
public static void executeSendProductProvider() {
    HttpWebRequest request =
        (HttpWebRequest)WebRequest.Create("https://bling.com.br/Api/v2/produtofornecedor/");
    ASCIIEncoding encoding = new ASCIIEncoding();
    string postData = "apikey={apiKey}&xml={xml_do_produto_fornecedor}";
    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);
}

 

 

Parâmetro Descrição Tipo
apikey apikey gerada no sistema string
xml xml contendo os dados do produto fornecedor string

 

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

 

Tabela de campos do XML

Grupo Campo Informação Tipo Padrão Opcional Nota
raiz produtoFornecedor       Obrigatório  

produtoFornecedor

 idProduto

Identificador único do produto

 INTEGER(20)   Obrigatório

 

produtoFornecedor

 idFornecedor

Identificador único do contato (fornecedor)

 INTEGER(20)   Obrigatório

1

produtoFornecedor

 produtoDescricao

Descrição do produto no fornecedor

 STRING(120)   Opcional

 

produtoFornecedor

 produtoCodigo

Código do produto no fornecedor

 STRING(60)   Opcional

 

produtoFornecedor

 precoCompra

Preço de compra do produto no fornecedor

 DECIMAL(17,10) 0 Opcional

2

produtoFornecedor

 precoCusto

Preço de custo do produto no fornecedor

 DECIMAL(17,10) 0 Opcional

3

produtoFornecedor

 produtoGarantia

Garantia do produto no fornecedor

 INTEGER(3) 0 Opcional

 

produtoFornecedor

 padrao

Principal fornecedor do produto

 INTEGER(1) 0 ou 1 Opcional

4

 

 

Exemplo de XML

<produtoFornecedor>
   <idProduto>5885434412</idProduto>
   <idFornecedor>5885419561</idFornecedor>
   <produtoDescricao>Fralda Descartável 54P</produtoDescricao>
   <produtoCodigo>9994343</produtoCodigo>
   <precoCompra>10.6300000000</precoCompra>
   <precoCusto>13.5000000000</precoCusto>
   <produtoGarantia>36</produtoGarantia>
   <padrao>0</padrao>
</produtoFornecedor>

 

Retorno

Em caso de sucesso, retornará o identificador único do produto fornecedor inserido, no mesmo modelo do exemplo a seguir. Caso contrário, retornará um erro.

A resposta será no formato especificado na URL (XML ou JSON).

Exemplo de retorno

{
    "retorno": {
        "produtosfornecedores": [
            {
                "produtoFornecedor": {
                    "id": 65834
                }
            }
        ]
    }
}

 

Artigos relacionados