POST /notafiscal

Insere uma nota fiscal

Insere uma nota fiscal no sistema.

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

$url = 'https://bling.com.br/Api/v2/notafiscal/json/';
$xml = '...';
$posts = array (
    "apikey" => "{apikey}",
    "xml" => rawurlencode($xml)
);
$retorno = executeSendFiscalDocument($url, $posts);
echo $retorno;
function executeSendFiscalDocument($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 ExecuteSendFiscalDocument() {
    HttpWebRequest request =
        (HttpWebRequest)WebRequest.Create("https://bling.com.br/Api/v2/notafiscal/");
    ASCIIEncoding encoding = new ASCIIEncoding();
    string postData = "apikey={apikey}&xml={xml_da_nota}";
    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);

Observação: Os campos marcados em negrito, no exemplo de XML, estão depreciados e serão removidos em atualizações futuras. Para substituí-los, deve-se utilizar a estrutura de múltiplos volumes (tag volumes).

Exemplo de XML

<?xml version="1.0" encoding="UTF-8"?>
<pedido>
    <cliente>
        <nome>Organisys Software</nome>
        <tipoPessoa>J</tipoPessoa>
        <cpf_cnpj>00000000000000</cpf_cnpj>
        <ie_rg>3067663000</ie_rg>
        <endereco>Rua Visconde de São Gabriel</endereco>
        <numero>392</numero>
        <complemento>Sala 54</complemento>
        <bairro>Cidade Alta</bairro>
        <cep>95.700-000</cep>
        <cidade>Bento Gonçalves</cidade>
        <uf>RS</uf>
        <fone>54 8115-3376</fone>
        <email>teste@teste.com.br</email>
    </cliente>
    <transporte>
        <transportadora>Transportadora XYZ</transportadora>
        <cpf_cnpj>11122233345</cpf_cnpj>
        <ie_rg>1122334455</ie_rg>
        <endereco>Rua Silvio Orlandini, 435</endereco>
        <cidade>Roca Sales</cidade>
        <uf>RS</uf>
        <placa>ILM-1020</placa>
        <uf_veiculo>RS</uf_veiculo>
        <tipo_frete>R</tipo_frete>
        <qtde_volumes>10</qtde_volumes>
        <especie>Volumes</especie>
        <numero>425</numero>
        <peso_bruto>157</peso_bruto>
        <peso_liquido>142</peso_liquido>
        <servico_correios>SEDEX</servico_correios>
        <dados_etiqueta>
            <nome>Endereço de entrega</nome>
            <endereco>Rua Visconde de São Gabriel</endereco>
            <numero>392</numero>
            <complemento>Sala 59</complemento>
            <municipio>Bento Gonçalves</municipio>
            <uf>RS</uf>
            <cep>95.700-000</cep>
            <bairro>Cidade Alta</bairro>
        </dados_etiqueta>
        <volumes>
            <volume>
                <servico>SEDEX - CONTRATO</servico>
                <codigoRastreamento></codigoRastreamento>
            </volume>
            <volume>
                <servico>PAC - CONTRATO</servico>
                <codigoRastreamento></codigoRastreamento>
            </volume>
        </volumes>
     </transporte>
     <itens>
          <item>
              <codigo>001</codigo>
              <descricao>Caneta 001</descricao>
              <un>Pç</un>
              <qtde>10</qtde>
              <vlr_unit>1.68</vlr_unit>
              <tipo>P</tipo>
              <peso_bruto>0.2</peso_bruto>
              <peso_liq>0.18</peso_liq>
              <class_fiscal>1000.00.10</class_fiscal>
              <origem>0</origem>
          </item>
          <item>
              <codigo>002</codigo>
              <descricao>Caderno 002</descricao>
              <un>Un</un>
              <qtde>3</qtde>
              <vlr_unit>3.75</vlr_unit>
              <tipo>P</tipo>
              <peso_bruto>0.75</peso_bruto>
              <peso_liq>0.7</peso_liq>
              <class_fiscal>1000.00.10</class_fiscal>
              <origem>0</origem>
          </item>
          <item>
              <codigo>003</codigo>
              <descricao>Teclado 003</descricao>
              <un>Cx</un>
              <qtde>7</qtde>
              <vlr_unit>18.65</vlr_unit>
              <tipo>P</tipo>
              <peso_bruto>0.65</peso_bruto>
              <peso_liq>0.52</peso_liq>
              <class_fiscal>1000.00.10</class_fiscal>
              <origem>0</origem>
          </item>
     </itens>
     <parcelas>
         <parcela>
             <dias>10</dias>
             <data>01/09/2009</data>
             <vlr>100</vlr>
             <obs>Teste obs 1</obs>
         </parcela>
         <parcela>
             <dias>15</dias>
             <data>06/09/2009</data>
             <vlr>50</vlr>
             <obs></obs>
         </parcela>
         <parcela>
             <dias>20</dias>
             <data>11/09/2009</data>
             <vlr>50</vlr>
             <obs>Teste obs 3</obs>
         </parcela>
     </parcelas>
     <nf_produtor_rural_referenciada>
         <numero>001020</numero>
         <serie>0</serie>
         <ano_mes_emissao>1202</ano_mes_emissao>
     </nf_produtor_rural_referenciada>
     <vlr_frete>15</vlr_frete>
     <vlr_seguro>7</vlr_seguro>
     <vlr_despesas>2.5</vlr_despesas>
     <vlr_desconto>10</vlr_desconto>
     <obs>Testando o campo observações do pedido</obs>
</pedido>

{
    "retorno": {
        "notasfiscais": [
            {
                "notafiscal": {
                    "numero": "000003",
                    "serie": "2",
                    "codigos_rastreamento": {
                        "codigo_rastreamento": "SX000000014BR"
                    },
                    "volumes": [
                        {
                            "volume": {
                                "servico": "SEDEX - CONTRATO",
                                "codigoRastreamento": "SG016634880BR"
                            }
                        },
                        {
                            "volume": {
                                "servico": "PAC CONTRATO AGENCIA",
                                "codigoRastreamento": "EC314697823BR"
                            }
                        }
                    ]
                }
            }
        ]
    }
}