POST /notafiscal/{numero}/{serie}

Envio e consulta da nota

Realiza o envio e a consulta da nota a partir do seu numero e serie. Se o parâmetro sendEmail for definido, a nota será enviada para o cliente e o link da DANFE será gerado.

curl -X POST "https://bling.com.br/Api/v2/notafiscal/json/"
     -d "apikey={apikey}"
     -d "number={numero}"
     -d "serie={serie}"
     -d "sendEmail={sendEmail}"

$url = 'https://bling.com.br/Api/v2/notafiscal/json/';
$posts = array (
    "apikey"    => "{apikey}",
    "number"    => "{numero}",
    "serie"     => "{serie}",
"sendEmail" => "{sendEmail}"
);
$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/json/");
    ASCIIEncoding encoding = new ASCIIEncoding();
    string postData = "apikey={apikey}&number={numero}&serie={serie}&sendEmail={sendEmail}";
    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);
}

Condições necessárias

1. É necessário que o cliente possua um certificado em arquivo, que esteja armazenado em nosso servidor.
2. A nota fiscal já deve estar cadastrada no sistema.
3. Somente é possível enviar notas fiscais que estejam nas situações pendentes ou rejeitadas.

Possíveis situações de retorno

Mensagens de erros específicos

Na tabela abaixo, encontram-se erros estruturais ao enviar o XML.

Segue um exemplo de retorno de erro.

{
    "retorno": {
        "erros":[
            "erro":{
                "cod": 52,
                "msg": "Numero ou serie nao sao tipos numericos",
            }
        ]
    }
}

Retorno

Independente do envio ou não da nota, o retorno terá uma estrutura diferenciada.

Segue a relação de atributos retornados:

O exemplo abaixo demonstra um retorno aonde a nota foi enviada com sucesso. A resposta será no formato especificado na URL (XML ou JSON).

Exemplo de retorno

{
    "retorno": {
        "notafiscal": [
            {
                "situacao": 2,
                "mensagem": "Nota Fiscal Enviada - Autorizado o uso da NF-e",
                "erro": null,
                "chaveAcesso": "43120891184036000128550010000000391485045649",
                "linkDanfe": "https://bling.com.br/doc.view.php?id=7ab6ad08c866c1b656a82f9a43efb3f5",
            }
        ]
    }
}

Entretanto, caso a nota não pôde ser enviada ou foi negada pelo sefaz, a estrutura de erro diferencia-se do resto dos erros da API.

Segue exemplo de retorno:

Exemplo de retorno

{
    "retorno": {
        "erros":[
            "notafiscal":{
                "situacao": 0,
                "mensagem": "A nota fiscal nao foi enviada, pois contem erros",
                "erro": "O campo nro deve ter no minimo 1 caractere.",
                "chaveAcesso": "13120891184036000128550010000000391485045640",
                "linkDanfe": "",
            }
        ]
    }
}