×
Entrar
Experimente grátis
Top

GET /cte/{numero}{serie}

  • 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

 

Busca um CT-e específico

Busca um CT-e a partir do seu número e série.

 

curl

 
curl -X GET "https://bling.com.br/Api/v2/cte/{numero}/{serie}/json/"
     -G
     -d "apikey={apikey}"
     -d "number={numero}"
     -d "serie={serie}"

PHP       

 
$apikey = "{apikey}";
$documentNumber = 12;
$documentSerie = 1;
$outputType = "json";
$url = 'https://bling.com.br/Api/v2/cte/' . $documentNumber . '/'. $documentSerie . '/' . $outputType;
$retorno = executeGetFiscalDocument($url, $apikey);
echo $retorno;
function executeGetFiscalDocument($url, $apikey){
   $curl_handle = curl_init();
   curl_setopt($curl_handle, CURLOPT_URL, $url . '&apikey=' . $apikey);
   curl_setopt($curl_handle, CURLOPT_RETURNTRANSFER, TRUE);
   $response = curl_exec($curl_handle);
   curl_close($curl_handle);
   return $response;
}

C#

 
public static void ExecuteGetFiscalDocument() {
    var request = HttpWebRequest.Create(@"https://bling.com.br/Api/v2/cte/{numero}/{serie}/json&apikey={apikey}");
    request.ContentType = "application/json";
    request.Method = "GET";
    using (HttpWebResponse response = request.GetResponse() as HttpWebResponse)
    {
        if (response.StatusCode != HttpStatusCode.OK)
            Console.Out.WriteLine("Error. Server returned status code: {0}", response.StatusCode);
        using (StreamReader reader = new StreamReader(response.GetResponseStream()))
        {
            var content = reader.ReadToEnd();
            if(string.IsNullOrWhiteSpace(content))
               Console.Out.WriteLine("Empty Response");
            else
               Console.Out.WriteLine("Response Body: \r\n {0}", content);
      }
 }

 

 

Parâmetro Descrição Tipo
apikey sua_api_key string
number Número do CT-e integer
serie Série do CT-e string

 

Retorno

Em caso de sucesso, retornará o CT-e solicitado 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"
                    }
                }
           }
       ]
    }
}

 

 

 

Artigos relacionados