×
Entrar
Experimente grátis
Top

GET /ctes

  • 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

 

Através da API de CT-e, é possível integrar a sua aplicação ao Bling.
A API disponibiliza os métodos POST e GET.

 

Busca todos os CT-es

Recupera todos os CT-es cadastrados no sistema.

curl    

 
curl -X GET "https://www.bling.com.br/Api/v2/ctes/json/"
     -G
     -d "apikey={apikey}"

PHP

 
$apikey = "{apikey}";
$outputType = "json";
$url = 'https://www.bling.com.br/Api/v2/ctes/' . $outputType;
$retorno = executeGetFiscalDocuments($url, $apikey);
echo $retorno;
function executeGetFiscalDocuments($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 ExecuteGetFiscalDocuments() {
   var request = HttpWebRequest.Create(@"https://www.bling.com.br/Api/v2/ctes/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

 

Filtros

Pode-se utilizar filtros para restringir o retorno de dados. Observe a tabela de possíveis filtros abaixo.

Filtro Descrição Tipo Predicate
dataEmissao Filtra por data de emissão do CT-e no intervalo especificado. date (dd/mm/YYYY) TO

 

curl -X GET "https://www.bling.com.br/Api/v2/ctes/json/"
     -G
     -d "filters=dataEmissao[12/12/2013 TO 05/02/2014]; situacao[2]"
     -d "apikey={apikey}"

 

Retorno

Em caso de sucesso, retornará todos os CT-es registrados, 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