POST /cte – Bling!

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

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

Insere CT-e

Insere um CT-e no sistema.

curl

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

PHP

$url = 'https://bling.com.br/Api/v2/cte/';
$posts = array (
    "apikey" => "{apikey}",
    "xml" => "{xml}",
    "loja" => "{loja}",
);
$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($posts));
    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 ExecuteSendFiscalDocument() {
    HttpWebRequest request =
        (HttpWebRequest)WebRequest.Create("https://bling.com.br/Api/v2/cte/");
    ASCIIEncoding encoding = new ASCIIEncoding();
    string postData = "apikey={apikey}&xml={xml}&loja={loja}";
    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`	sua_api_key	string
`xml`	XML da nota compactado no padrão GZip e após convertido para Base64	string
`loja`	loja selecionada	integer

Observações

O parâmetro xml deve ser compactado no padrão GZip e o resultado deve ser convertido para Base64, semelhante ao processo de compactação da SEFAZ.

Exemplo de XML

<?xml version="1.0" encoding="UTF-8"?>
 <pedido> 
 <xml>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</xml>
 </pedido>

Retorno

Em caso de sucesso, retornará o número e a série do CT-e 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": {
         "ctes": [
             {
                 "cte": {
                     "id": "123456",
                     "serie": "0",
                     "numero": "0001",
                     "natureza": "NATUREZA",
                     "cfop": "6353",
                     "dataEmissao": "2019-07-11 16:26:26",
                     "situacao": "emitido",
                     "tipoCte": "CT-e normal",
                     "tipoServico": "Normal",
                     "modal": "Rodoviário",
                     "municipioInicio": "Bento Gonçalves",
                     "UFInicio": "RS",
                     "municipioFim": "Hortolândia",
                     "UFFim": "SP",
                     "cst": "40",
                     "baseCalculo": 0.00,
                     "aliquotaIcms": 0.00,
                     "valorIcms": 0.00,
                     "valorPis": "0.00",
                     "valorCofins": "0.00",
                     "valorIr": "0.00",
                     "valorInss": "0.00",
                     "valorCsll": "0.00",
                     "valorTotal": "738.00",
                     "rntrc": "00000000",
                     "emissor": {
                         "nome": "EMISSOR",
                         "cnpj": "00000000000000",
                         "ie": "000000000000",
                         "endereco": "ENDERECO",
                         "numero": "1234",
                         "complemento": "",
                         "bairro": "BAIRRO",
                         "cep": "00000000",
                         "municipio": "Bento Gonçalves",
                         "uf": "RS",
                         "fone": "00000000000"
                     },
                     "remetente": {
                         "nome": "REMETENTE",
                         "cnpj": "00000000000000",
                         "ie": "0000000000000",
                         "endereco": "ENDERECO",
                         "numero": "S/N",
                         "complemento": "",
                         "bairro": "BAIRRO",
                         "cep": "00000000",
                         "municipio": "Poços de Caldas",
                         "uf": "MG",
                         "fone": "",
                         "email": “”
                      },
                      "destinatario": {
                          "nome": "DESTINATARIO",
                          "cnpj": "00000000000000",
                          "ie": "ISENTO",
                          "endereco": "ENDERECO",
                          "numero": "SN",
                          "complemento": "",
                          "bairro": "BAIRRO",
                          "cep": "00000000",
                          "municipio": "Hortolândia",
                          "uf": "SP",
                          "fone": "",
                          "email": ""
                      },
                      "autorizacao": {
                          "chave": "00000000000000000000000000000000000000000000",
                          "dataRecebimento": "2019-03-11 16:31:35",
                          "numeroProtocolo": "000000000000000"
                      },
                      "nota": {
                              "chave": "00000000000000000000000000000000000000000000"
                      }
                  }
             }
         ]
     }
}

Mensagens de erros específicos

Na tabela abaixo, encontram-se erros que podem ser retornados ao enviar o XML.

Código	Mensagem
50	XML invalido.
51	Mais de uma loja vinculada a mesma filial. Para importar o CT-e, e necessario desabilitar uma temporariamente.
52	O CT-e nao foi importado pois ja existe um arquivo com este numero e serie em seu cadastro.

Abaixo um exemplo de retorno com erro.