×
Entrar
Experimente grátis
Top

POST /notaservico/{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

 

Envio e consulta do RPS

Realiza o envio e a consulta do RPS a partir do seu numero e serie.

 

curl      
curl -X POST "https://www.bling.com.br/Api/v2/notaservico/"
     -d "apikey={apikey}"
     -d "number={numero}"
     -d "serie={serie}"
PHP 
$url = 'https://www.bling.com.br/Api/v2/notaservico/';
$posts = array(
   "apikey" => "{apikey}",
   "number" => "{numero}",
   "serie" => "{serie}"
);
$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://www.bling.com.br/Api/v2/notaservico/");
    ASCIIEncoding encoding = new ASCIIEncoding();
    string postData = "apikey={apikey}&number={numero}&serie={serie}";
    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 apikey gerada pelo sistema string
number número do RPS integer
serie série do RPS string
 
 

Condições necessárias

  1. É necessário que o cliente possua um certificado digital que esteja armazenado em nosso servidor.
  2. A nota de serviço já deve estar cadastrada no sistema.
  3. Somente é possível enviar notas de serviço que estejam na situação pendente.
 
Mensagens de erros específicos
Código Mensagem
52 O número do RPS não foi preenchido.
53 A série do RPS não foi preenchida.
54 O número do RPS informado deve estar em formato numérico.
56 A nota de serviço informada já foi enviada à Prefeitura.
57 A nota de serviço informada está com o status cancelada.
58 A nota de serviço informada já foi enviada e está disponível para consulta de recibo.
 
 

Retorno

Em caso de sucesso, retornarão informações no mesmo modelo do exemplo a seguir. Caso contrário, retornará um erro.

A resposta será no formato especificado na URL (XML ou JSON).

{
     "retorno": {
        "notasservico": [
            {
                "notaservico": {
                    "serie": "1",
                    "numero": "000275",
                    "numeronfse": "275",
                    "situacao": "Emitida",
                    "cliente": {
                         "nome": "Organisys Software Ltda.",
                         "cnpj": "00000000000000",
                         "email": "organisys@email.com"
            },
            "dataEmissao": "2017-06-25",
            "valorNota": "10.00",
            "linkNFSe": "https://linkexemplo.com.br/nfse",
            "codigoVerificacao": "XXX-XX-XXXX"
         }
      }
    ]
  }
}

 

Artigos relacionados